Nastran Extraction

Note: Users must procure and maintain valid licenses to integrate this commercial DE tool with the Istari Digital platform. Please contact your local IT administrator for assistance.

Supported Functions:

extract

The following table lists the extract functions currently supported by the Nastran:

Function Name	Description	Required Parameters	Optional Model Inputs	Optional Parameters	Example Input
extract_input	Extract model summary information from a Nastran input file. Supported file extensions include bdf and dat.	model_id	None	None	"input_arguments": {}
extract_results	Extract results summary information from Nastran output. op2 format files are supported	model_id	bdf input model for generating model views with color contours representing analysis results.	node-set element-set	"input_arguments": {model_id}

Getting Started

The Nastran extraction integration provides functions for extracting data from Nastran input models and results.

Methods to Link to Istari Digital Platform

Upload: Yes

Link: No

Files Supported

The istari Digital Platform can extract from the following file types:

• .bdf
• .op2
• .dat

All other Nastran file types not supported at this time. Please submit a feature request if an important file type is not supported.

Example Files

• Download for extract_input Example: annular_plate.bdf

• Download for extract_results Example: annular_plate.op2

• Download to verify generation of a tecplot data file: tecplot_examples.dat

Setup for Administrators

All required Python modules are packaged with the Istari Digital module binary. This project has been tested using python 3.12 and 3.10.

Environment

Supported OS: Linux The module requires OpenGL support for generating model images. The Windows OS generally provides this support. However, AWS Windows workspaces and EC2s do not. An environment variable named PARAVIEW_HOME must be set to direct the module to the folder containing the ParaView binaries, presumed to be located at $PARAVIEW_HOME/bin.

Paraview Python Setup

The module uses ParaView's local Python interpreter ($PARAVIEW_HOME/bin/pvpython) to generate model images.

Version Compatibility

These functions extracts information from Nastran input bulk data format (bdfs) and results (op2) files generated by a variety of pre/post processors and solvers, respectively. Additionally, the module produces rendered images of the model and color contours of op2 results.

Function Coverage and Outputs

The Nastran module software can produce a number of artifacts extracted from the Nastran model. The table below describes each output artifact and its type.

Route	Coverage	Artifact Content Example
Extract model summary info	Yes
Extract material properties	Yes
Extract max/min values for results data	Yes
Extract f04 detailed system information and computational and hardware metrics	Planned
Extract f06 messages	Planned
Extract log information	No
Render model mesh	Yes
Render color contours of results	Yes
Render deformed model with translations	Planned

Detailed SDK Reference

Prerequisite: Install Istari Digital SDK and initialize Istari Digital Client per instructions here

Step 1: Upload and Extract the File(s)

Upload the file as a model

model = client.add_model(
    path="example.bdf",
    description="Nastran example model",
    display_name="Nastran Model Name",
)
print(f"Uploaded base model with ID {model.id}")

Extract model summary information from a Nastran input file once you have the model ID

extraction_job = client.add_job(
    model_id  = model.id,
    function  = "@istari:extract_input",
    tool_name = "nastran_extract",
    tool_version = "1.0.0",
    operating_system = "Ubuntu 22.04",
)
print(f"Extraction started for model ID {model.id}, job ID: {extraction_job.id}")

Please choose appropriate function, tool_name, tool_version, and operating_system for your installation of this software.
Above is an example of how to call the function

Extract results summary information from Nastran output.

Coming Soon!

Step 2: Check the Job Status

extraction_job.poll_job()

Step 3: Retrieve Results

Example

for artifact in model.artifacts:
    output_file_path = f"c:\\extracts\\{artifact.name}"
    with open(output_file_path, "wb") as f:
        f.write(artifact.read_bytes())

Troubleshooting

1. For general Agent and Software Troubleshooting Click Here

FAQ