IGLFEAResults
Module: cae
Container class for managing finite element analysis result steps.
This class stores multiple analysis result steps and provides fast lookup
access using a composite key consisting of:
- Analysis type
- Step ID
- Increment ID
It serves as the central result database for multi-step and multi-analysis
FEA simulations such as:
- Static structural analysis
- Modal analysis
- Buckling analysis
- Transient analysis
- Nonlinear incremental analysis
Notes
-----
Each stored step is expected to expose:
- analysis_type
- step_id
- increment_id
- get_value()
for unified field-based result access.
__init__
method
__init__(self)
Initialize an empty FEA result container.
add_step
method
add_step(self, step)
Add an analysis result step to the container.
The step is stored both sequentially and in an internal lookup table
for O(1) retrieval.
The step is stored both sequentially and in an internal lookup table
for O(1) retrieval.
Parameters
| Name | Type | Description |
|---|---|---|
| step | object | Analysis result step object containing analysis metadata and field result data. |
steps
property
steps(self)
Get all stored analysis steps.
Returns
-------
list
List of analysis result step objects.
num_steps
method
num_steps(self)
Get the total number of stored analysis steps.
Returns
-------
int
Number of result steps.
get_step
method
get_step(self, analysis_type, step_id: int)
Retrieve a result step using analysis and increment identifiers.
Parameters
| Name | Type | Description |
|---|---|---|
| step_id | int | Analysis step number. |
Returns
object | None
Matching analysis result step object if found, otherwise None.
get_value
method
get_value(self, analysis_type, step_id: int, increment: int, field_name: str, entity_id: int)
Retrieve a field value for a specific mesh entity from a result step.
This method provides unified access to simulation results across
different analysis types and increments.
This method provides unified access to simulation results across
different analysis types and increments.
Parameters
| Name | Type | Description |
|---|---|---|
| step_id | int | Analysis step number. |
| increment | int | Increment index. |
| field_name | str | Name of the requested result field. |
| entity_id | int | Mesh entity ID such as a node or element ID. |
Returns
object | None
Field value associated with the specified entity, or None if the
step or field does not exist.