diff --git a/doc/source/_static/dpf_operators.html b/doc/source/_static/dpf_operators.html index 4fb8bd0d476..194cd2ec9c5 100644 --- a/doc/source/_static/dpf_operators.html +++ b/doc/source/_static/dpf_operators.html @@ -5262,7 +5262,10 @@

Configurating operators

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

Outputs

Configurations

Scripting

math: unit convert (fields container)

Description

Converts an input fields container of a given unit to another unit.

Inputs

unit as a string, ex 'm' for meter, 'Pa' for pascal,...

-

Outputs

Configurations

Scripting

result: element orientations X

Description

Read/compute element euler angles X component of the vector (1st component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

utility: property field get attribute

Description

A PropertyField in pin 0 and a property name (string) in pin 1 are expected in input.

+

Inputs

Accepted inputs are: 'time_freq_support', 'scoping' and 'header'.

+

Outputs

Property value.

+

Configurations

Scripting

result: element orientations X

Description

Read/compute element euler angles X component of the vector (1st component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -5275,10 +5278,7 @@

Configurating operators

elemental nodal beam results are read if this pin is set to true (default is false)

Outputs

Configurations

Scripting

math: norm (fields container)

Description

Computes the element-wise L2 norm of the field elementary data. This process is applied on each field of the input fields container.

Inputs

Lp normalisation type, p = 1, 2, ...n - Default Lp=2

-

Outputs

Configurations

Scripting

utility: property field get attribute

Description

A PropertyField in pin 0 and a property name (string) in pin 1 are expected in input.

-

Inputs

Accepted inputs are: 'time_freq_support', 'scoping' and 'header'.

-

Outputs

Property value.

-

Configurations

Scripting

mapping: prepare mapping workflow

Description

Generates a workflow that can map results from a support to another one.

+

Outputs

Configurations

Scripting

mapping: prepare mapping workflow

Description

Generates a workflow that can map results from a support to another one.

Inputs

Radius size for the RBF filter

Outputs

Configurations

Scripting

math: sqrt (fields container)

Description

Computes element-wise sqrt(field1).

Inputs

field or fields container with only one field is expected

@@ -5317,7 +5317,9 @@

Configurating operators

Inputs

Used as a base label (extracted from Fields/Scoping Container, or directly from Label Space) that is concatenated with provided values.

Outputs

Configurations

Scripting

math: sqrt (field)

Description

Computes element-wise sqrt(field1).

Inputs

field or fields container with only one field is expected

-

Outputs

Configurations

Scripting

result: y plus (y+)

Description

Read Y Plus (y+) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

math: accumulate min over label

Description

Compute the component-wise sum over all the fields that have the same ID as the label set as input in the fields container and take its opposite. This computation can be incremental. If the input fields container is connected and the operator is run multiple times, the output field will be on all the connected inputs.

+

Inputs

Label of the fields container where it should operate.

+

Outputs

Configurations

Scripting

result: y plus (y+)

Description

Read Y Plus (y+) by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

result file container allowed to be kept open to cache data

@@ -5325,9 +5327,7 @@

Configurating operators

prevents from reading the mesh in the result files

region id (integer) or vector of region ids (vector) or region scoping (scoping) of the model (region corresponds to zone for Fluid results or part for LSDyna results).

(for Fluid results only) LabelSpace with combination of zone, phases or species ids

-

Outputs

Configurations

Scripting

math: accumulate min over label

Description

Compute the component-wise sum over all the fields that have the same ID as the label set as input in the fields container and take its opposite. This computation can be incremental. If the input fields container is connected and the operator is run multiple times, the output field will be on all the connected inputs.

-

Inputs

Label of the fields container where it should operate.

-

Outputs

Configurations

Scripting

math: +

Description

Computes the sum of two fields. If one field's scoping has 'overall' location, then these field's values are applied on the entire other field. If one of the input field is empty, the remaining is forwarded to the output. When using a constant or 'work_by_index', it's possible to use 'inplace' to reuse one of the fields.

+

Outputs

Configurations

Scripting

math: +

Description

Computes the sum of two fields. If one field's scoping has 'overall' location, then these field's values are applied on the entire other field. If one of the input field is empty, the remaining is forwarded to the output. When using a constant or 'work_by_index', it's possible to use 'inplace' to reuse one of the fields.

Inputs

field or fields container with only one field is expected

field or fields container with only one field is expected

Outputs

Configurations

Scripting

server: grpc shutdown server

Description

Shutdowns dpf's grpc server

@@ -5386,7 +5386,10 @@

Configurating operators

Ids of the elements where each set of reduced coordinates is found

Configurations

Scripting

scoping: rescope property field

Description

Rescopes a property field on the given scoping. If an ID does not exist in the original property field, the default value (in 2) is used when defined.

Inputs

If pin 2 is used, the IDs not found in the property field are added with this default value.

-

Outputs

Configurations

Scripting

result: plastic strain principal 1

Description

Read/compute element nodal component plastic strains 1st principal component by calling the readers defined by the datasources and computing its eigen values. The off-diagonal strains are first converted from Voigt notation to the standard strain values.

+

Outputs

Configurations

Scripting

math: -

Description

Computes the difference of two fields. If one field's scoping has an 'overall' location, then this field's values are applied on the other field entirely. When using a constant or 'work_by_index', you can use 'inplace' to reuse one of the fields.

+

Inputs

field or fields container with only one field is expected

+

field or fields container with only one field is expected

+

Outputs

Configurations

Scripting

result: plastic strain principal 1

Description

Read/compute element nodal component plastic strains 1st principal component by calling the readers defined by the datasources and computing its eigen values. The off-diagonal strains are first converted from Voigt notation to the standard strain values.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -5396,10 +5399,7 @@

Configurating operators

prevents from reading the mesh in the result files

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

elemental nodal beam results are read if this pin is set to true (default is false)

-

Outputs

Configurations

Scripting

math: -

Description

Computes the difference of two fields. If one field's scoping has an 'overall' location, then this field's values are applied on the other field entirely. When using a constant or 'work_by_index', you can use 'inplace' to reuse one of the fields.

-

Inputs

field or fields container with only one field is expected

-

field or fields container with only one field is expected

-

Outputs

Configurations

Scripting

math: total sum

Description

Sums all the elementary data of a field to produce one elementary data point.

+

Outputs

Configurations

Scripting

math: total sum

Description

Sums all the elementary data of a field to produce one elementary data point.

Inputs

field or fields container with only one field is expected

Field containing weights, one weight per entity

time_scoping

@@ -5407,9 +5407,9 @@

Configurating operators

Configurations

Scripting

math: - (fields container)

Description

Computes the difference of two fields. If one field's scoping has an 'overall' location, then this field's values are applied on the other field entirely. When using a constant or 'work_by_index', you can use 'inplace' to reuse one of the fields.

Inputs

field or fields container with only one field is expected

field or fields container with only one field is expected

-

Outputs

Configurations

Scripting

scoping: intersect scopings

Description

Intersect 2 scopings and return the intersection and the difference between the intersection and the first scoping.

-

Inputs

Outputs

Configurations

Scripting

math: ^ (field)

Description

Computes element-wise field[i]^p.

-

Inputs

Outputs

Configurations

Scripting

scoping: elements in mesh

Description

Retrieves the elemental scoping of a given input mesh, which contains the element IDs.

+

Outputs

Configurations

Scripting

math: ^ (field)

Description

Computes element-wise field[i]^p.

+

Inputs

Outputs

Configurations

Scripting

scoping: intersect scopings

Description

Intersect 2 scopings and return the intersection and the difference between the intersection and the first scoping.

+

Inputs

Outputs

Configurations

Scripting

scoping: elements in mesh

Description

Retrieves the elemental scoping of a given input mesh, which contains the element IDs.

Inputs

Outputs

Configurations

Scripting

math: scale (field)

Description

Scales a field by a constant factor. This factor can be a scalar or a vector, where each value of the vector represents a scaler per component. Number of the components are corresponding to the input field dimensionality

Inputs

field or fields container with only one field is expected

Double/Field/Vector of doubles. When scoped on overall, same value(s) applied on all the data, when scoped elsewhere, corresponding values will be multiplied due to the scoping

@@ -5443,15 +5443,15 @@

Configurating operators

field or fields container with only one field is expected

Scalar

Outputs

Configurations

Scripting

math: centroid (fields container)

Description

Computes the centroid of all the matching fields of a fields container at a given time or frequency, using fieldOut = field1*(1.-fact)+field2*(fact).

-

Inputs

Outputs

Configurations

Scripting

math: sweeping phase (fields container)

Description

Shifts the phase of all the corresponding real and imaginary fields of a fields container for a given angle (in 2) of a unit (in 4).

-

Inputs

String Unit. Supported values: "deg" or "rad". Default: "rad".

-

Outputs

Configurations

Scripting

filter: signed high pass (field)

Description

The high pass filter returns all the values above, or equal, in absolute value to the threshold value in input.

+

Inputs

Outputs

Configurations

Scripting

filter: signed high pass (field)

Description

The high pass filter returns all the values above, or equal, in absolute value to the threshold value in input.

Inputs

field or fields container with only one field is expected

A threshold scalar or a field containing one value is expected.

The default is false. If set to true, the complement of the filtered fields container is returned on output pin 1.

-

Outputs

Configurations

Scripting

math: ^2 (field)

Description

Computes element-wise field[i]^2.

+

Outputs

Configurations

Scripting

math: sweeping phase (fields container)

Description

Shifts the phase of all the corresponding real and imaginary fields of a fields container for a given angle (in 2) of a unit (in 4).

+

Inputs

String Unit. Supported values: "deg" or "rad". Default: "rad".

+

Outputs

Configurations

Scripting

math: ^2 (field)

Description

Computes element-wise field[i]^2.

Inputs

field or fields container with only one field is expected

-

Outputs

Configurations

Scripting

result: velocity Z

Description

Read/compute nodal velocities Z component of the vector (3rd component) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

result: reaction force Z

Description

Read/compute nodal reaction forces Z component of the vector (3rd component) by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -5460,7 +5460,7 @@

Configurating operators

if true the field is rotated to global coordinate system (default true)

prevents from reading the mesh in the result files

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

-

Outputs

Configurations

Scripting

result: reaction force Z

Description

Read/compute nodal reaction forces Z component of the vector (3rd component) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

result: velocity Z

Description

Read/compute nodal velocities Z component of the vector (3rd component) by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -5469,20 +5469,20 @@

Configurating operators

if true the field is rotated to global coordinate system (default true)

prevents from reading the mesh in the result files

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

-

Outputs

Configurations

Scripting

utility: remove unnecessary labels

Description

Removes the selected label from a fields container.

+

Outputs

Configurations

Scripting

utility: remove unnecessary labels

Description

Removes the selected label from a fields container.

Inputs

If true, the operator does not throw an error if the label to be removed has more than one entry.

Fields Container with the label to be removed.

Label to be removed from the fields container.

Outputs

Configurations

Scripting

math: sin (field)

Description

Computes element-wise sin(field[i]).

Inputs

Outputs

Configurations

Scripting

math: cos (field)

Description

Computes element-wise cos(field[i]).

Inputs

field or fields container with only one field is expected

-

Outputs

Configurations

Scripting

math: cos (fields container)

Description

Computes element-wise cos(field[i]).

-

Inputs

field or fields container with only one field is expected

-

Outputs

Configurations

Scripting

logic: ascending sort

Description

Sort a field (in 0) in ascending order with an optional component priority table, or a boolean, to enable sort by scoping (in 1). This operator does not support multiple elementary data per entity.

+

Outputs

Configurations

Scripting

logic: ascending sort

Description

Sort a field (in 0) in ascending order with an optional component priority table, or a boolean, to enable sort by scoping (in 1). This operator does not support multiple elementary data per entity.

Inputs

field or fields container with only one field is expected

component priority table (vector of int)

if true, uses scoping to sort the field (default is false)

-

Outputs

Configurations

Scripting

result: initial coordinates (LSDyna)

Description

Read/compute Initial Coordinates (LSDyna) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

math: cos (fields container)

Description

Computes element-wise cos(field[i]).

+

Inputs

field or fields container with only one field is expected

+

Outputs

Configurations

Scripting

result: initial coordinates (LSDyna)

Description

Read/compute Initial Coordinates (LSDyna) by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

Fields container already allocated modified inplace

@@ -5523,18 +5523,18 @@

Configurating operators

prevents from reading the mesh in the result files

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

elemental nodal beam results are read if this pin is set to true (default is false)

-

Outputs

Configurations

Scripting

result: euler nodes

Description

Reads a field made of 3 coordinates and 3 Euler angles (6 dofs) by node from the result file.

-

Inputs

if true, then the field will only contain the scoping if any rotation is not zero. (default is false).

-

if true, then the field has ncomp=6 with 3 coordinates and 3 Euler angles, else there is only the Euler angles (default is true).

-

Outputs

Configurations

Scripting

math: * (component-wise field) (fields container)

Description

Computes component-wise product between two fields of same dimensionality. If one field's scoping has an 'overall' location, then this field's values are applied on the other field entirely. When using a constant or 'work_by_index', you can use 'inplace' to reuse one of the fields.

-

Inputs

field or fields container with only one field is expected

-

field or fields container with only one field is expected

-

Outputs

Configurations

Scripting

logic: same meshes container?

Description

Checks if two meshes_container are identical.

+

Outputs

Configurations

Scripting

logic: same meshes container?

Description

Checks if two meshes_container are identical.

Inputs

Double positive small value. Smallest value which will be considered during the comparison step. All the abs(values) in the field less than this value are considered as null, (default value:1.0e-14).

Double relative tolerance. Maximum tolerance gap between two compared values. Values within relative tolerance are considered identical (v1-v2)/v2 < relativeTol (default is 0.001).

compare auxiliary data (i.e property fields, scopings...). Default value is 'false'.

Outputs

bool (true if identical...)

-

Configurations

Scripting

result: beam TR shear stress (LSDyna)

Description

Read Beam TR Shear Stress (LSDyna) by calling the readers defined by the datasources.

+

Configurations

Scripting

math: * (component-wise field) (fields container)

Description

Computes component-wise product between two fields of same dimensionality. If one field's scoping has an 'overall' location, then this field's values are applied on the other field entirely. When using a constant or 'work_by_index', you can use 'inplace' to reuse one of the fields.

+

Inputs

field or fields container with only one field is expected

+

field or fields container with only one field is expected

+

Outputs

Configurations

Scripting

result: euler nodes

Description

Reads a field made of 3 coordinates and 3 Euler angles (6 dofs) by node from the result file.

+

Inputs

if true, then the field will only contain the scoping if any rotation is not zero. (default is false).

+

if true, then the field has ncomp=6 with 3 coordinates and 3 Euler angles, else there is only the Euler angles (default is true).

+

Outputs

Configurations

Scripting

result: beam TR shear stress (LSDyna)

Description

Read Beam TR Shear Stress (LSDyna) by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

elements scoping required in output.

result file container allowed to be kept open to cache data

@@ -5569,30 +5569,31 @@

Configurating operators

Cell connectivity int vector

Cell types property int vector

If vtk_updated=false, offsets int vector

-

Configurations

Scripting

math: ln (fields container)

Description

Computes element-wise ln(field[i]).

-

Inputs

field or fields container with only one field is expected

-

Outputs

Configurations

Scripting

invariant: scalar invariants (field)

Description

Computes the element-wise invariants of a tensor field.

+

Configurations

Scripting

invariant: scalar invariants (field)

Description

Computes the element-wise invariants of a tensor field.

Inputs

Outputs

stress intensity field

stress equivalent intensity

max shear stress field

-

Configurations

Scripting

math: cross product

Description

Computes the cross product of two vector fields. Fields can have the same location or Elemental Nodal and Nodal locations.

+

Configurations

Scripting

math: ln (fields container)

Description

Computes element-wise ln(field[i]).

+

Inputs

field or fields container with only one field is expected

+

Outputs

Configurations

Scripting

math: cross product

Description

Computes the cross product of two vector fields. Fields can have the same location or Elemental Nodal and Nodal locations.

Inputs

field or fields container with only one field is expected

field or fields container with only one field is expected

Outputs

Configurations

Scripting

filter: high pass (timefreq)

Description

The high pass filter returns all the values above (but not equal to) the threshold value in input.

Inputs

A threshold scalar or a field containing one value is expected.

The default is false. If set to true, the complement of the filtered fields container is returned on output pin 1.

Outputs

Configurations

Scripting

math: / (component-wise fields container)

Description

For every two fields with the same label space (from the two input fields containers), computes component-wise fraction between two fields of same dimensionality. If one field's scoping has an 'overall' location, then this field's values are applied on the other field entirely.

-

Inputs

Outputs

Configurations

Scripting

result: global sliding interface energy (LSDyna)

Description

Read Global Sliding Interface Energy (LSDyna) by calling the readers defined by the datasources.

+

Inputs

Outputs

Configurations

Scripting

math: kronecker product

Description

Computes element-wise Kronecker product between two tensor fields.

+

Inputs

field or fields container with only one field is expected

+

field or fields container with only one field is expected

+

Outputs

Configurations

Scripting

result: global sliding interface energy (LSDyna)

Description

Read Global Sliding Interface Energy (LSDyna) by calling the readers defined by the datasources.

Inputs

result file container allowed to be kept open to cache data

result file path container, used if no streams are set

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

-

Outputs

Configurations

Scripting

math: kronecker product

Description

Computes element-wise Kronecker product between two tensor fields.

-

Inputs

field or fields container with only one field is expected

-

field or fields container with only one field is expected

-

Outputs

Configurations

Scripting

math: modulus (fields container)

Description

Computes amplitude of a real and an imaginary field.

+

Outputs

Configurations

Scripting

math: modulus (fields container)

Description

Computes amplitude of a real and an imaginary field.

Inputs

field or fields container with only one field is expected

field or fields container with only one field is expected

-

Outputs

Configurations

Scripting

result: joint relative angular velocity

Description

Read/compute joint relative angular velocity by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

math: dot (complex fields)

Description

Computes product between two field containers containing complex fields.

+

Inputs

Outputs

Configurations

Scripting

result: joint relative angular velocity

Description

Read/compute joint relative angular velocity by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

Fields container already allocated modified inplace

@@ -5600,8 +5601,7 @@

Configurating operators

result file path container, used if no streams are set

if true the field is rotated to global coordinate system (default true). Please check your results carefully if 'false' is used for Elemental or ElementalNodal results averaged to the Nodes when adjacent elements do not share the same coordinate system, as results may be incorrect.

prevents from reading the mesh in the result files

-

Outputs

Configurations

Scripting

math: dot (complex fields)

Description

Computes product between two field containers containing complex fields.

-

Inputs

Outputs

Configurations

Scripting

result: gasket stress XZ

Description

Read/compute elemental gasket stress XZ shear component (02 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

result: gasket stress XZ

Description

Read/compute elemental gasket stress XZ shear component (02 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -5650,7 +5650,12 @@

Configurating operators

result file path container, used if no streams are set

if true the field is rotated to global coordinate system (default true). Please check your results carefully if 'false' is used for Elemental or ElementalNodal results averaged to the Nodes when adjacent elements do not share the same coordinate system, as results may be incorrect.

prevents from reading the mesh in the result files

-

Outputs

Configurations

Scripting

result: heat flux

Description

Read/compute heat flux by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

math: total sum (fields container)

Description

Sums all the elementary data of a field to produce one elementary data point.

+

Inputs

field or fields container with only one field is expected

+

Field containing weights, one weight per entity

+

time_scoping

+

Outputs

Field containing the (weighted) sum for each component in an elementary data

+

Configurations

Scripting

result: heat flux

Description

Read/compute heat flux by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

Fields container already allocated modified inplace

@@ -5666,12 +5671,7 @@

Configurating operators

elemental nodal beam results are read if this pin is set to true (default is false)

This pin forces elemental nodal shell and solid results to be split if this pin is set to true. If set to false (default), a specific shell layer is still needed to merge the fields. Merge is possible only if a shell layer is provided.

If the requested_location pin is not connected, and if split_shells pin is set to true, we choose one of the shell layer for shell element. If split_shells pin is set to false (default value) and a specific shell layer is provided, results will be merged on this specific shell layer.

-

Outputs

Configurations

Scripting

math: total sum (fields container)

Description

Sums all the elementary data of a field to produce one elementary data point.

-

Inputs

field or fields container with only one field is expected

-

Field containing weights, one weight per entity

-

time_scoping

-

Outputs

Field containing the (weighted) sum for each component in an elementary data

-

Configurations

Scripting

result: co-energy

Description

Read/compute co-energy (magnetics) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

result: co-energy

Description

Read/compute co-energy (magnetics) by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

Fields container already allocated modified inplace

@@ -5692,7 +5692,7 @@

Configurating operators

field or fields container with only one field is expected

Outputs

Ids of entities where reference value is zero.

Ids of entities where there are no reference value.

-

Configurations

Scripting

result: velocity Y

Description

Read/compute nodal velocities Y component of the vector (2nd component) by calling the readers defined by the datasources.

+

Configurations

Scripting

result: reaction force Y

Description

Read/compute nodal reaction forces Y component of the vector (2nd component) by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -5701,7 +5701,7 @@

Configurating operators

if true the field is rotated to global coordinate system (default true)

prevents from reading the mesh in the result files

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

-

Outputs

Configurations

Scripting

result: reaction force Y

Description

Read/compute nodal reaction forces Y component of the vector (2nd component) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

result: velocity Y

Description

Read/compute nodal velocities Y component of the vector (2nd component) by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -5710,7 +5710,7 @@

Configurating operators

if true the field is rotated to global coordinate system (default true)

prevents from reading the mesh in the result files

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

-

Outputs

Configurations

Scripting

result: global velocity (LSDyna)

Description

Read Global Velocity (LSDyna) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

result: global velocity (LSDyna)

Description

Read Global Velocity (LSDyna) by calling the readers defined by the datasources.

Inputs

result file container allowed to be kept open to cache data

result file path container, used if no streams are set

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

@@ -5724,7 +5724,7 @@

Configurating operators

(for Fluid results only) LabelSpace with combination of zone, phases or species ids

Outputs

Configurations

Scripting

math: absolute value by component (field)

Description

Compute the absolute value of each data value of the input field, no norm performed.

Inputs

field or fields container with only one field is expected

-

Outputs

Configurations

Scripting

result: incremental energy

Description

Read/compute incremental energy (magnetics) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

result: thermal strain

Description

Read/compute element nodal component thermal strains by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

Fields container already allocated modified inplace

@@ -5732,7 +5732,11 @@

Configurating operators

result file path container, used if no streams are set

if true the field is rotated to global coordinate system (default true). Please check your results carefully if 'false' is used for Elemental or ElementalNodal results averaged to the Nodes when adjacent elements do not share the same coordinate system, as results may be incorrect.

prevents from reading the mesh in the result files

-

Outputs

Configurations

Scripting

result: thermal strain

Description

Read/compute element nodal component thermal strains by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

requested location Nodal, Elemental or ElementalNodal

+

elemental nodal beam results are read if this pin is set to true (default is false)

+

This pin forces elemental nodal shell and solid results to be split if this pin is set to true. If set to false (default), a specific shell layer is still needed to merge the fields. Merge is possible only if a shell layer is provided.

+

If the requested_location pin is not connected, and if split_shells pin is set to true, we choose one of the shell layer for shell element. If split_shells pin is set to false (default value) and a specific shell layer is provided, results will be merged on this specific shell layer.

+

Outputs

Configurations

Scripting

result: incremental energy

Description

Read/compute incremental energy (magnetics) by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

Fields container already allocated modified inplace

@@ -5740,11 +5744,9 @@

Configurating operators

result file path container, used if no streams are set

if true the field is rotated to global coordinate system (default true). Please check your results carefully if 'false' is used for Elemental or ElementalNodal results averaged to the Nodes when adjacent elements do not share the same coordinate system, as results may be incorrect.

prevents from reading the mesh in the result files

-

requested location Nodal, Elemental or ElementalNodal

-

elemental nodal beam results are read if this pin is set to true (default is false)

-

This pin forces elemental nodal shell and solid results to be split if this pin is set to true. If set to false (default), a specific shell layer is still needed to merge the fields. Merge is possible only if a shell layer is provided.

-

If the requested_location pin is not connected, and if split_shells pin is set to true, we choose one of the shell layer for shell element. If split_shells pin is set to false (default value) and a specific shell layer is provided, results will be merged on this specific shell layer.

-

Outputs

Configurations

Scripting

result: stiffness matrix energy

Description

Read/compute element energy associated with the stiffness matrix by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

math: absolute value by component (fields container)

Description

Compute the absolute value of each data value of the input field, no norm performed.

+

Inputs

field or fields container with only one field is expected

+

Outputs

Configurations

Scripting

result: stiffness matrix energy

Description

Read/compute element energy associated with the stiffness matrix by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

Fields container already allocated modified inplace

@@ -5756,14 +5758,7 @@

Configurating operators

mesh expanded, use if cyclic expansion is to be done.

sectors to expand (start at 0), for multistage: use scopings container with 'stage' label, use if cyclic expansion is to be done.

angle phi in degrees (default value 0.0), use if cyclic expansion is to be done.

-

Outputs

Configurations

Scripting

math: absolute value by component (fields container)

Description

Compute the absolute value of each data value of the input field, no norm performed.

-

Inputs

field or fields container with only one field is expected

-

Outputs

Configurations

Scripting

metadata: element types provider

Description

Reads element types data from the result files contained in the streams or data sources.

-

Inputs

Element Type ids to recover used by the solver. If not set, all available element types to be recovered.

-

Result file container allowed to be kept open to cache data.

-

Result file path container, used if no streams are set.

-

Outputs

The generic_data_container has a class_name: ElementTypesProperties. It contains the following property fields: element_routine_number: Element routine number. E.g 186 for SOLID186, keyopts: Element type option keys, kdofs: DOF/node for this element type.This is a bit mapping, nodelm: Number of nodes for this element type, nodfor: Number of nodes per element having nodal forces, nodstr: Number of nodes per element having nodal stresses, new_gen_element: Element of new generation.

-

Configurations

Scripting

result: total temperature

Description

Read Total Temperature by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

result: total temperature

Description

Read Total Temperature by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

result file container allowed to be kept open to cache data

@@ -5771,7 +5766,14 @@

Configurating operators

prevents from reading the mesh in the result files

region id (integer) or vector of region ids (vector) or region scoping (scoping) of the model (region corresponds to zone for Fluid results or part for LSDyna results).

(for Fluid results only) LabelSpace with combination of zone, phases or species ids

-

Outputs

Configurations

Scripting

result: acceleration Y

Description

Read/compute nodal accelerations Y component of the vector (2nd component) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

metadata: element types provider

Description

Reads element types data from the result files contained in the streams or data sources.

+

Inputs

Element Type ids to recover used by the solver. If not set, all available element types to be recovered.

+

Result file container allowed to be kept open to cache data.

+

Result file path container, used if no streams are set.

+

Outputs

The generic_data_container has a class_name: ElementTypesProperties. It contains the following property fields: element_routine_number: Element routine number. E.g 186 for SOLID186, keyopts: Element type option keys, kdofs: DOF/node for this element type.This is a bit mapping, nodelm: Number of nodes for this element type, nodfor: Number of nodes per element having nodal forces, nodstr: Number of nodes per element having nodal stresses, new_gen_element: Element of new generation.

+

Configurations

Scripting

utility: delegate to operator

Description

Delegate the run to an Operator instantiated by the name in input (forwards all the input of this Operator to the sub Operator).

+

Inputs

Outputs

inputs

+

Configurations

Scripting

result: acceleration Y

Description

Read/compute nodal accelerations Y component of the vector (2nd component) by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -5780,9 +5782,7 @@

Configurating operators

if true the field is rotated to global coordinate system (default true)

prevents from reading the mesh in the result files

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

-

Outputs

Configurations

Scripting

utility: delegate to operator

Description

Delegate the run to an Operator instantiated by the name in input (forwards all the input of this Operator to the sub Operator).

-

Inputs

Outputs

inputs

-

Configurations

Scripting

logic: component selector (fields container)

Description

Creates a scalar fields container based on the selected component for each field.

+

Outputs

Configurations

Scripting

logic: component selector (fields container)

Description

Creates a scalar fields container based on the selected component for each field.

Inputs

one or several component index that will be extracted from the initial field.

Outputs

Configurations

Scripting

logic: component selector (field)

Description

Creates a scalar/vector field based on the selected component.

Inputs

One or several component index that will be extracted from the initial field.

@@ -5832,13 +5832,7 @@

Configurating operators

Outputs

Configurations

Scripting

utility: convert to meshes container

Description

Creates a meshes container containing the mesh provided on pin 0.

Inputs

If a meshes container is set in input, it is passed on as an output with the additional label space (if any).

Sets a label space.

-

Outputs

Configurations

Scripting

result: beam torsional moment (LSDyna)

Description

Read Beam Torsional Moment (LSDyna) by calling the readers defined by the datasources.

-

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

-

elements scoping required in output.

-

result file container allowed to be kept open to cache data

-

result file path container, used if no streams are set

-

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

-

Outputs

Configurations

Scripting

result: equivalent stress parameter

Description

Read/compute element nodal equivalent stress parameter by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

result: equivalent stress parameter

Description

Read/compute element nodal equivalent stress parameter by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

Fields container already allocated modified inplace

@@ -5850,7 +5844,13 @@

Configurating operators

elemental nodal beam results are read if this pin is set to true (default is false)

This pin forces elemental nodal shell and solid results to be split if this pin is set to true. If set to false (default), a specific shell layer is still needed to merge the fields. Merge is possible only if a shell layer is provided.

If the requested_location pin is not connected, and if split_shells pin is set to true, we choose one of the shell layer for shell element. If split_shells pin is set to false (default value) and a specific shell layer is provided, results will be merged on this specific shell layer.

-

Outputs

Configurations

Scripting

utility: convert to field

Description

Create scalar or vector Field.

+

Outputs

Configurations

Scripting

result: beam torsional moment (LSDyna)

Description

Read Beam Torsional Moment (LSDyna) by calling the readers defined by the datasources.

+

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

+

elements scoping required in output.

+

result file container allowed to be kept open to cache data

+

result file path container, used if no streams are set

+

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

+

Outputs

Configurations

Scripting

utility: convert to field

Description

Create scalar or vector Field.

Inputs

Data of the field, default is 0-field. Specify a double to have a field of same value or specify directly the data vector.

Unit symbol (m, Hz, kg, ...)

Location of the field ex 'Nodal', 'ElementalNodal', 'Elemental'... Default is 'numeric'.

@@ -5908,7 +5908,10 @@

Configurating operators

Outputs

Configurations

Scripting

geo: integrate over elements

Description

Integration of an input field over mesh.

Inputs

Integrate the input field over a specific scoping.

Mesh to integrate on. If not provided, the one from input field is employed.

-

Outputs

Configurations

Scripting

result: compute total strain X

Description

Computes the strain from a displacement field. +

Outputs

Configurations

Scripting

utility: forward

Description

Return all the inputs as outputs.

+

Inputs

any type of input

+

Outputs

same types as inputs

+

Configurations

Scripting

result: compute total strain X

Description

Computes the strain from a displacement field. Only SOLID185 (B-Bar, Simplified Enhanced Strain, Enhanced Strain formulations), SOLID186 (Full Integration) & SOLID187 elements are supported. Layered elements are not supported. Thermal strains are not supported. @@ -5927,10 +5930,7 @@

Configurating operators

Average the Elemental Nodal result to the requested location.

Field/or fields container containing only the displacement field (nodal). If none specified, read displacements from result file using the data_sources.

Outputs

The computed result fields container (elemental nodal).

-

Configurations

Scripting

utility: forward

Description

Return all the inputs as outputs.

-

Inputs

any type of input

-

Outputs

same types as inputs

-

Configurations

Scripting

result: plastic strain eqv

Description

Read/compute element nodal equivalent plastic strain by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Configurations

Scripting

result: plastic strain eqv

Description

Read/compute element nodal equivalent plastic strain by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

Fields container already allocated modified inplace

@@ -5988,13 +5988,13 @@

Configurating operators

result file path container, used if no streams are set

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

Outputs

Configurations

Scripting

utility: assemble scalars to vector fc

Description

Takes three scalar fields container and assembles them as a 3D vector fields container.

-

Inputs

Outputs

Configurations

Scripting

utility: assemble scalars to matrix

Description

Take nine scalar fields and assemble them as a 3x3 matrix field. If the 'symmetrical' input is set to true, only six scalar fields are required (xx, yy, zz, xy, xz and yz).

-

Inputs

Outputs

Configurations

Scripting

math: make one on component

Description

Takes the input field's scoping and creates a field full of zeros, except for the indexes from pin 1 that will hold 1.0.

-

Inputs

Outputs

Configurations

Scripting

mesh: from scopings

Description

Extracts multiple meshed region base on a scoping and saved in a MeshesContainer

+

Inputs

Outputs

Configurations

Scripting

mesh: from scopings

Description

Extracts multiple meshed region base on a scoping and saved in a MeshesContainer

Inputs

if nodal scoping, then the scoping is transposed respecting the inclusive pin

if inclusive == 1 then all the elements/faces adjacent to the nodes/faces ids in input are added, if inclusive == 0, only the elements/faces which have all their nodes/faces in the scoping are included

returns mesh with nodes only (without any elements). Default is false.

-

Outputs

Configurations

Scripting

utility: assemble scalars to matrix fc

Description

Take nine scalar fields container and assemble them as a 3x3 matrix fields. If the 'symmetrical' input is set to true, only six field containers are required (xx, yy, zz, xy, xz and yz).

+

Outputs

Configurations

Scripting

math: make one on component

Description

Takes the input field's scoping and creates a field full of zeros, except for the indexes from pin 1 that will hold 1.0.

+

Inputs

Outputs

Configurations

Scripting

utility: assemble scalars to matrix

Description

Take nine scalar fields and assemble them as a 3x3 matrix field. If the 'symmetrical' input is set to true, only six scalar fields are required (xx, yy, zz, xy, xz and yz).

+

Inputs

Outputs

Configurations

Scripting

utility: assemble scalars to matrix fc

Description

Take nine scalar fields container and assemble them as a 3x3 matrix fields. If the 'symmetrical' input is set to true, only six field containers are required (xx, yy, zz, xy, xz and yz).

Inputs

Outputs

Configurations

Scripting

result: interface contact area (LSDyna)

Description

Read Interface Contact Area (LSDyna) by calling the readers defined by the datasources.

Inputs

result file container allowed to be kept open to cache data

result file path container, used if no streams are set

@@ -6054,16 +6054,16 @@

Configurating operators

Label space, or scoping defining the label space (scoping location), values to keep (scoping IDs)

If set to true (default) the input label space (scoping location) is suppressed from the output meshes container, otherwise, label space is kept.

Outputs

meshes

-

Configurations

Scripting

utility: extract sub scopings container

Description

Creates a new scopings container with all the scopings corresponding to the label space in input 1. If pin 1 is not defined, pin 0 input will be copied to the output.

+

Configurations

Scripting

averaging: elemental difference (fields container)

Description

Transforms an Elemental Nodal or Nodal field into an Elemental field. Each elemental value is the maximum difference between the unaveraged or averaged (depending on the input fields) computed result for all nodes in this element. The result is computed on a given element scoping. If the input fields are mixed shell/solid, and the shell's layers are not specified as collapsed, then the fields are split by element shape and the output fields container has an elshape label.

+

Inputs

The mesh region in this pin is used to perform the averaging, used if there is no fields support.

+

Average only on these elements. If it is scoping container, the label must correspond to the one of the fields container.

+

If true, the data across different shell layers is averaged as well (default is false).

+

Outputs

Configurations

Scripting

utility: extract sub scopings container

Description

Creates a new scopings container with all the scopings corresponding to the label space in input 1. If pin 1 is not defined, pin 0 input will be copied to the output.

Inputs

scopings_container

Label space, or scoping defining the label space (scoping location), values to keep (scoping IDs)

If set to true (default) the input label space (scoping location) is suppressed from the output scopings container, otherwise, label space is kept.

Outputs

scopings_container

-

Configurations

Scripting

averaging: elemental difference (fields container)

Description

Transforms an Elemental Nodal or Nodal field into an Elemental field. Each elemental value is the maximum difference between the unaveraged or averaged (depending on the input fields) computed result for all nodes in this element. The result is computed on a given element scoping. If the input fields are mixed shell/solid, and the shell's layers are not specified as collapsed, then the fields are split by element shape and the output fields container has an elshape label.

-

Inputs

The mesh region in this pin is used to perform the averaging, used if there is no fields support.

-

Average only on these elements. If it is scoping container, the label must correspond to the one of the fields container.

-

If true, the data across different shell layers is averaged as well (default is false).

-

Outputs

Configurations

Scripting

utility: compute time scoping

Description

Computes the time frequency scoping (made of set IDs) necessary to interpolate on a list of time or frequencies.

+

Configurations

Scripting

utility: compute time scoping

Description

Computes the time frequency scoping (made of set IDs) necessary to interpolate on a list of time or frequencies.

Inputs

List of frequencies or times needed. To specify load steps, put a field (and not a list) in input with a scoping located on "TimeFreq_steps".

1:ramped' or 2:stepped', default is ramped

Outputs

time_scoping

@@ -6092,8 +6092,7 @@

Configurating operators

elemental nodal beam results are read if this pin is set to true (default is false)

This pin forces elemental nodal shell and solid results to be split if this pin is set to true. If set to false (default), a specific shell layer is still needed to merge the fields. Merge is possible only if a shell layer is provided.

If the requested_location pin is not connected, and if split_shells pin is set to true, we choose one of the shell layer for shell element. If split_shells pin is set to false (default value) and a specific shell layer is provided, results will be merged on this specific shell layer.

-

Outputs

Configurations

Scripting

math: window bartlett (fields container)

Description

Apply bartlett windowing on a given FieldsContainer having time label or a Field located on time. Assume that time sampling is evenly spaced (use time_freq_interpolation before otherwise).

-

Inputs

Outputs

Configurations

Scripting

result: turbulent viscosity

Description

Read Turbulent Viscosity by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

result: turbulent viscosity

Description

Read Turbulent Viscosity by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

result file container allowed to be kept open to cache data

@@ -6101,24 +6100,17 @@

Configurating operators

prevents from reading the mesh in the result files

region id (integer) or vector of region ids (vector) or region scoping (scoping) of the model (region corresponds to zone for Fluid results or part for LSDyna results).

(for Fluid results only) LabelSpace with combination of zone, phases or species ids

-

Outputs

Configurations

Scripting

result: part hourglass energy (LSDyna)

Description

Read Part Hourglass Energy (LSDyna) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

math: window bartlett (fields container)

Description

Apply bartlett windowing on a given FieldsContainer having time label or a Field located on time. Assume that time sampling is evenly spaced (use time_freq_interpolation before otherwise).

+

Inputs

Outputs

Configurations

Scripting

result: part hourglass energy (LSDyna)

Description

Read Part Hourglass Energy (LSDyna) by calling the readers defined by the datasources.

Inputs

result file container allowed to be kept open to cache data

result file path container, used if no streams are set

entity (part for matsum, interface for rcforc) where the result will be scoped

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

Outputs

Configurations

Scripting

utility: python generator

Description

Generates .py file with specifications for loaded plugin(s).

-

Inputs

Outputs

Configurations

Scripting

utility: make overall

Description

Extracts a value from a field and makes a new field containing only this value, with the associated scoping's location set as 'overall'.

-

Inputs

Outputs

Configurations

Scripting

geo: elements volume

Description

Compute the measure of the Elements (volume for 3D elements, surface for 2D elements or length for 1D elements) using default shape functions, except for polyhedrons.

+

Inputs

Outputs

Configurations

Scripting

geo: elements volume

Description

Compute the measure of the Elements (volume for 3D elements, surface for 2D elements or length for 1D elements) using default shape functions, except for polyhedrons.

Inputs

If not provided, the measure of all elements for the mesh is computed. If provided, the Scoping needs to have "Elemental" location.

-

Outputs

Configurations

Scripting

result: pressure

Description

Read/compute Pressure by calling the readers defined by the datasources.

-

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

-

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

-

Fields container already allocated modified inplace

-

result file container allowed to be kept open to cache data

-

result file path container, used if no streams are set

-

if true the field is rotated to global coordinate system (default true). Please check your results carefully if 'false' is used for Elemental or ElementalNodal results averaged to the Nodes when adjacent elements do not share the same coordinate system, as results may be incorrect.

-

prevents from reading the mesh in the result files

-

Outputs

Configurations

Scripting

result: stress

Description

Read/compute element nodal component stresses by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

utility: make overall

Description

Extracts a value from a field and makes a new field containing only this value, with the associated scoping's location set as 'overall'.

+

Inputs

Outputs

Configurations

Scripting

result: stress

Description

Read/compute element nodal component stresses by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

Fields container already allocated modified inplace

@@ -6134,7 +6126,15 @@

Configurating operators

elemental nodal beam results are read if this pin is set to true (default is false)

This pin forces elemental nodal shell and solid results to be split if this pin is set to true. If set to false (default), a specific shell layer is still needed to merge the fields. Merge is possible only if a shell layer is provided.

If the requested_location pin is not connected, and if split_shells pin is set to true, we choose one of the shell layer for shell element. If split_shells pin is set to false (default value) and a specific shell layer is provided, results will be merged on this specific shell layer.

-

Outputs

Configurations

Scripting

result: stress X

Description

Read/compute element nodal component stresses XX normal component (00 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

result: pressure

Description

Read/compute Pressure by calling the readers defined by the datasources.

+

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

+

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

+

Fields container already allocated modified inplace

+

result file container allowed to be kept open to cache data

+

result file path container, used if no streams are set

+

if true the field is rotated to global coordinate system (default true). Please check your results carefully if 'false' is used for Elemental or ElementalNodal results averaged to the Nodes when adjacent elements do not share the same coordinate system, as results may be incorrect.

+

prevents from reading the mesh in the result files

+

Outputs

Configurations

Scripting

result: stress X

Description

Read/compute element nodal component stresses XX normal component (00 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -6211,15 +6211,7 @@

Configurating operators

requested location, default is Nodal

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

elemental nodal beam results are read if this pin is set to true (default is false)

-

Outputs

Configurations

Scripting

result: stress XZ

Description

Read/compute element nodal component stresses XZ shear component (02 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

result: stress XZ

Description

Read/compute element nodal component stresses XZ shear component (02 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -6230,7 +6222,15 @@

Configurating operators

requested location, default is Nodal

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

elemental nodal beam results are read if this pin is set to true (default is false)

-

Outputs

Configurations

Scripting

utility: merge string fields

Description

Assembles a set of string fields into a unique one.

+

Outputs

Configurations

Scripting

utility: merge string fields

Description

Assembles a set of string fields into a unique one.

Inputs

Either a a vector of string fields to merge or string fields from pin 0 to ...

Outputs

Configurations

Scripting

result: stress principal 1

Description

Read/compute element nodal component stresses 1st principal component by calling the readers defined by the datasources and computing its eigen values.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

@@ -6262,10 +6262,7 @@

Configurating operators

prevents from reading the mesh in the result files

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

elemental nodal beam results are read if this pin is set to true (default is false)

-

Outputs

Configurations

Scripting

invariant: convertnum bcs to nod

Description

Converts a fields container from BCS to NOD ordering.

-

Inputs

fields_container

-

Data_sources (must contain the full file).

-

Outputs

Configurations

Scripting

result: tangential contact moment

Description

Read/compute tangential contact moment by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

result: tangential contact moment

Description

Read/compute tangential contact moment by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

Fields container already allocated modified inplace

@@ -6273,7 +6270,10 @@

Configurating operators

result file path container, used if no streams are set

if true the field is rotated to global coordinate system (default true). Please check your results carefully if 'false' is used for Elemental or ElementalNodal results averaged to the Nodes when adjacent elements do not share the same coordinate system, as results may be incorrect.

prevents from reading the mesh in the result files

-

Outputs

Configurations

Scripting

result: stress von mises

Description

Reads/computes element nodal component stresses, average it on nodes (by default) and computes its invariants.

+

Outputs

Configurations

Scripting

invariant: convertnum bcs to nod

Description

Converts a fields container from BCS to NOD ordering.

+

Inputs

fields_container

+

Data_sources (must contain the full file).

+

Outputs

Configurations

Scripting

result: stress von mises

Description

Reads/computes element nodal component stresses, average it on nodes (by default) and computes its invariants.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -6372,13 +6372,7 @@

Configurating operators

requested location, default is Nodal

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

elemental nodal beam results are read if this pin is set to true (default is false)

-

Outputs

Configurations

Scripting

metadata: property field provider by property name

Description

Provides the property values for a set of elements for a defined property name.

-

Inputs

scoping that defines the set of elements to fetch the property values for. If not specified, applied on all the elements of the mesh.

-

optional if using a dataSources

-

optional if using a streamsContainer

-

property to read, that can be the following: elements_connectivity, nodes_connectivity, material, element_type, apdl_section_id, apdl_real_id, apdl_esys_id, mapdl_element_type, mapdl_element_type_id, harmonic_index, step, substep, keyopt_i (i = 1 -> 18).

-

Outputs

property field

-

Configurations

Scripting

result: gasket deformation XZ

Description

Read/compute elemental gasket deformation XZ shear component (02 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

result: gasket deformation XZ

Description

Read/compute elemental gasket deformation XZ shear component (02 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -6389,7 +6383,13 @@

Configurating operators

requested location, default is Nodal

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

elemental nodal beam results are read if this pin is set to true (default is false)

-

Outputs

Configurations

Scripting

mesh: mesh provider

Description

Reads a mesh from result files.

+

Outputs

Configurations

Scripting

metadata: property field provider by property name

Description

Provides the property values for a set of elements for a defined property name.

+

Inputs

scoping that defines the set of elements to fetch the property values for. If not specified, applied on all the elements of the mesh.

+

optional if using a dataSources

+

optional if using a streamsContainer

+

property to read, that can be the following: elements_connectivity, nodes_connectivity, material, element_type, apdl_section_id, apdl_real_id, apdl_esys_id, mapdl_element_type, mapdl_element_type_id, harmonic_index, step, substep, keyopt_i (i = 1 -> 18).

+

Outputs

property field

+

Configurations

Scripting

mesh: mesh provider

Description

Reads a mesh from result files.

Inputs

Optional time/frequency set ID of the mesh, supported for adaptative meshes.

result file container allowed to be kept open to cache data

result file path container, used if no streams are set

@@ -6527,17 +6527,17 @@

Configurating operators

Weights to apply to each field from pin 1000 to ...

Outputs

Configurations

Scripting

math: min/max over time

Description

Evaluates minimum/maximum over time/frequency.

Inputs

Define min or max.

-

Outputs

Configurations

Scripting

result: global energy ratio without eroded energy (LSDyna)

Description

Read Global Energy ratio without Eroded Energy (LSDyna) by calling the readers defined by the datasources.

-

Inputs

result file container allowed to be kept open to cache data

-

result file path container, used if no streams are set

-

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

-

Outputs

Configurations

Scripting

utility: merge fields containers

Description

Assembles a set of fields containers into a unique one.

+

Outputs

Configurations

Scripting

utility: merge fields containers

Description

Assembles a set of fields containers into a unique one.

Inputs

For some result files (such as RST), the scoping on names selection is duplicated through all the distributed files.If this pin is false, the merging process is skipped. If it is true, this scoping is merged. Default is true.

Default is false. If true, redundant quantities are summed instead of being ignored.

Already merged field support.

Already merged fields containers support.

A vector of fields containers to merge or fields containers from pin 0 to ...

-

Outputs

Configurations

Scripting

result: elastic strain XY

Description

Read/compute element nodal component elastic strains XY shear component (01 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

result: global energy ratio without eroded energy (LSDyna)

Description

Read Global Energy ratio without Eroded Energy (LSDyna) by calling the readers defined by the datasources.

+

Inputs

result file container allowed to be kept open to cache data

+

result file path container, used if no streams are set

+

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

+

Outputs

Configurations

Scripting

result: elastic strain XY

Description

Read/compute element nodal component elastic strains XY shear component (01 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -6696,15 +6696,7 @@

Configurating operators

if inclusive == 1 then all the elements/faces adjacent to the nodes/faces ids in input are added, if inclusive == 0, only the elements/faces which have all their nodes/faces in the scoping are included

Output scoping location for meshes with nodes, faces and elements. By default, elemental and faces scopings transpose to nodal, and nodal scopings transpose to elemental.

Outputs

Scoping or scopings container (the input type is the output type)

-

Configurations

Scripting

result: mass fraction

Description

Read Mass Fraction by calling the readers defined by the datasources.

-

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

-

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

-

result file container allowed to be kept open to cache data

-

result file path container, used if no streams are set

-

prevents from reading the mesh in the result files

-

region id (integer) or vector of region ids (vector) or region scoping (scoping) of the model (region corresponds to zone for Fluid results or part for LSDyna results).

-

(for Fluid results only) LabelSpace with combination of zone, phases or species ids

-

Outputs

Configurations

Scripting

result: plastic strain X

Description

Read/compute element nodal component plastic strains XX normal component (00 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Configurations

Scripting

result: plastic strain X

Description

Read/compute element nodal component plastic strains XX normal component (00 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -6715,15 +6707,15 @@

Configurating operators

requested location, default is Nodal

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

elemental nodal beam results are read if this pin is set to true (default is false)

-

Outputs

Configurations

Scripting

result: coordinates (LSDyna)

Description

Read/compute Coordinates (LSDyna) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

result: mass fraction

Description

Read Mass Fraction by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

-

Fields container already allocated modified inplace

result file container allowed to be kept open to cache data

result file path container, used if no streams are set

-

if true the field is rotated to global coordinate system (default true). Please check your results carefully if 'false' is used for Elemental or ElementalNodal results averaged to the Nodes when adjacent elements do not share the same coordinate system, as results may be incorrect.

prevents from reading the mesh in the result files

-

Outputs

Configurations

Scripting

result: plastic strain Y

Description

Read/compute element nodal component plastic strains YY normal component (11 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

region id (integer) or vector of region ids (vector) or region scoping (scoping) of the model (region corresponds to zone for Fluid results or part for LSDyna results).

+

(for Fluid results only) LabelSpace with combination of zone, phases or species ids

+

Outputs

Configurations

Scripting

result: plastic strain Y

Description

Read/compute element nodal component plastic strains YY normal component (11 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -6734,14 +6726,22 @@

Configurating operators

requested location, default is Nodal

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

elemental nodal beam results are read if this pin is set to true (default is false)

-

Outputs

Configurations

Scripting

filter: band pass (fields container)

Description

The band pass filter returns all the values above (but not equal to) the minimum threshold value and below (but not equal to) the maximum threshold value in input.

+

Outputs

Configurations

Scripting

result: coordinates (LSDyna)

Description

Read/compute Coordinates (LSDyna) by calling the readers defined by the datasources.

+

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

+

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

+

Fields container already allocated modified inplace

+

result file container allowed to be kept open to cache data

+

result file path container, used if no streams are set

+

if true the field is rotated to global coordinate system (default true). Please check your results carefully if 'false' is used for Elemental or ElementalNodal results averaged to the Nodes when adjacent elements do not share the same coordinate system, as results may be incorrect.

+

prevents from reading the mesh in the result files

+

Outputs

Configurations

Scripting

geo: to polar coordinates

Description

Finds r, theta (rad), and z coordinates of a coordinates (nodal) field in a cartesian coordinates system where the input coordinate system defines the rotation axis and the origin.

+

Inputs

field or fields container with only one field is expected

+

3-3 rotation matrix and origin coordinates must be set here to define a coordinate system. By default, the rotation axis is the z axis and the origin is [0,0,0].

+

Outputs

Configurations

Scripting

filter: band pass (fields container)

Description

The band pass filter returns all the values above (but not equal to) the minimum threshold value and below (but not equal to) the maximum threshold value in input.

Inputs

field or fields container with only one field is expected

A minimum threshold scalar or a field containing one value is expected.

A maximum threshold scalar or a field containing one value is expected.

-

Outputs

Configurations

Scripting

geo: to polar coordinates

Description

Finds r, theta (rad), and z coordinates of a coordinates (nodal) field in a cartesian coordinates system where the input coordinate system defines the rotation axis and the origin.

-

Inputs

field or fields container with only one field is expected

-

3-3 rotation matrix and origin coordinates must be set here to define a coordinate system. By default, the rotation axis is the z axis and the origin is [0,0,0].

-

Outputs

Configurations

Scripting

math: fft evaluation

Description

Evaluate the fast fourier transforms at a given set of fields.

+

Outputs

Configurations

Scripting

math: fft evaluation

Description

Evaluate the fast fourier transforms at a given set of fields.

Inputs

field of values to evaluate

if specified only the results at these set ids are used

Outputs

Configurations

Scripting

result: global total energy (LSDyna)

Description

Read Global Total Energy (LSDyna) by calling the readers defined by the datasources.

@@ -6761,12 +6761,7 @@

Configurating operators

elemental nodal beam results are read if this pin is set to true (default is false)

Outputs

Configurations

Scripting

utility: merge materials

Description

Assembles a set of materials into a unique one.

Inputs

A vector of materials to merge or materials from pin 0 to ...

-

Outputs

Configurations

Scripting

serialization: vtk export

Description

Write the input field and fields container into a given vtk path

-

Inputs

Either export volume elements in the mesh with their fields with value 0 or faces elements in the mesh with their fields with value 1 (default is 0)

-

path with vtk extension were the export occurs

-

necessary if the first field or fields container don't have a mesh in their support

-

fields exported

-

Outputs

Configurations

Scripting

result: dynamic viscosity

Description

Read Dynamic Viscosity by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

result: dynamic viscosity

Description

Read Dynamic Viscosity by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

result file container allowed to be kept open to cache data

@@ -6774,7 +6769,12 @@

Configurating operators

prevents from reading the mesh in the result files

region id (integer) or vector of region ids (vector) or region scoping (scoping) of the model (region corresponds to zone for Fluid results or part for LSDyna results).

(for Fluid results only) LabelSpace with combination of zone, phases or species ids

-

Outputs

Configurations

Scripting

result: plastic strain XY

Description

Read/compute element nodal component plastic strains XY shear component (01 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

serialization: vtk export

Description

Write the input field and fields container into a given vtk path

+

Inputs

Either export volume elements in the mesh with their fields with value 0 or faces elements in the mesh with their fields with value 1 (default is 0)

+

path with vtk extension were the export occurs

+

necessary if the first field or fields container don't have a mesh in their support

+

fields exported

+

Outputs

Configurations

Scripting

result: plastic strain XY

Description

Read/compute element nodal component plastic strains XY shear component (01 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -6808,13 +6808,7 @@

Configurating operators

Inputs

field or fields container with only one field is expected

a threshold scalar or a field containing one value is expected

The default is false. If set to true, the complement of the filtered fields container is returned on output pin 1.

-

Outputs

Configurations

Scripting

mesh: iso surfaces

Description

Extract multiple iso-contours from mesh_cut operator and set it into a meshes container. If pin 1 is provided, "num_surfaces" iso-contours will be computed, ranging from "min_value" to "max_value" linearly. If pin 4 is provided, the iso-values are the one set by the user. The iso-values are stored into a FieldsContainer.

-

Inputs

Field containing the values for the iso-surface computation. The mesh can be retrieved from this field's support or through pin 2.

-

If provided, iso_values are linearly computed between the min and the max of the field of results. If not, iso_values must be provided by the user through pin 4

-

Mesh to compute the iso-surface from. Used when not given through the support of the field in pin 0.

-

True: slicing will also take into account shell and skin elements. False: slicing will ignore shell and skin elements. The default is true.

-

If provided, user defined iso_values to compute. If not provided, iso_values are linearly compute between the min and the max of the field of results.

-

Outputs

Configurations

Scripting

result: plastic strain YZ

Description

Read/compute element nodal component plastic strains YZ shear component (12 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

result: plastic strain YZ

Description

Read/compute element nodal component plastic strains YZ shear component (12 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -6825,7 +6819,13 @@

Configurating operators

requested location, default is Nodal

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

elemental nodal beam results are read if this pin is set to true (default is false)

-

Outputs

Configurations

Scripting

result: plastic strain XZ

Description

Read/compute element nodal component plastic strains XZ shear component (02 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

mesh: iso surfaces

Description

Extract multiple iso-contours from mesh_cut operator and set it into a meshes container. If pin 1 is provided, "num_surfaces" iso-contours will be computed, ranging from "min_value" to "max_value" linearly. If pin 4 is provided, the iso-values are the one set by the user. The iso-values are stored into a FieldsContainer.

+

Inputs

Field containing the values for the iso-surface computation. The mesh can be retrieved from this field's support or through pin 2.

+

If provided, iso_values are linearly computed between the min and the max of the field of results. If not, iso_values must be provided by the user through pin 4

+

Mesh to compute the iso-surface from. Used when not given through the support of the field in pin 0.

+

True: slicing will also take into account shell and skin elements. False: slicing will ignore shell and skin elements. The default is true.

+

If provided, user defined iso_values to compute. If not provided, iso_values are linearly compute between the min and the max of the field of results.

+

Outputs

Configurations

Scripting

result: plastic strain XZ

Description

Read/compute element nodal component plastic strains XZ shear component (02 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -6859,7 +6859,14 @@

Configurating operators

prevents from reading the mesh in the result files

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

elemental nodal beam results are read if this pin is set to true (default is false)

-

Outputs

Configurations

Scripting

result: plastic strain max_shear

Description

Reads/computes element nodal component plastic strains, average it on nodes (by default) and computes its invariants.

+

Outputs

Configurations

Scripting

filter: band pass (field)

Description

The band pass filter returns all the values above (but not equal to) the minimum threshold value and below (but not equal to) the maximum threshold value in input.

+

Inputs

field or fields container with only one field is expected

+

A minimum threshold scalar or a field containing one value is expected.

+

A maximum threshold scalar or a field containing one value is expected.

+

Outputs

Configurations

Scripting

filter: low pass (timefreq)

Description

The low pass filter returns all the values below (but not equal to) the threshold value in input.

+

Inputs

a threshold scalar or a field containing one value is expected

+

The default is false. If set to true, the complement of the filtered fields container is returned on output pin 1.

+

Outputs

Configurations

Scripting

result: plastic strain max_shear

Description

Reads/computes element nodal component plastic strains, average it on nodes (by default) and computes its invariants.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -6869,14 +6876,7 @@

Configurating operators

prevents from reading the mesh in the result files

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

elemental nodal beam results are read if this pin is set to true (default is false)

-

Outputs

Configurations

Scripting

filter: low pass (timefreq)

Description

The low pass filter returns all the values below (but not equal to) the threshold value in input.

-

Inputs

a threshold scalar or a field containing one value is expected

-

The default is false. If set to true, the complement of the filtered fields container is returned on output pin 1.

-

Outputs

Configurations

Scripting

filter: band pass (field)

Description

The band pass filter returns all the values above (but not equal to) the minimum threshold value and below (but not equal to) the maximum threshold value in input.

-

Inputs

field or fields container with only one field is expected

-

A minimum threshold scalar or a field containing one value is expected.

-

A maximum threshold scalar or a field containing one value is expected.

-

Outputs

Configurations

Scripting

Outputs

Configurations

Scripting

utility: merge scopings containers

Description

Assembles a set of scopings containers into a unique one.

-

Inputs

A vector of scopings containers to merge or scopings containers from pin 0 to ...

-

Outputs

Configurations

Scripting

math: accumulate over label

Description

Compute the component-wise sum over all the fields that have the same ID as the label set as input in the fields container. This computation can be incremental. If the input fields container is connected and the operator is run multiple times, the output field will be on all the connected inputs.

+

Outputs

Configurations

Scripting

math: accumulate over label

Description

Compute the component-wise sum over all the fields that have the same ID as the label set as input in the fields container. This computation can be incremental. If the input fields container is connected and the operator is run multiple times, the output field will be on all the connected inputs.

Inputs

Label of the fields container where it should operate.

-

Outputs

Configurations

Scripting

result: thermal strain XY

Description

Read/compute element nodal component thermal strains XY shear component (01 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

utility: merge scopings containers

Description

Assembles a set of scopings containers into a unique one.

+

Inputs

A vector of scopings containers to merge or scopings containers from pin 0 to ...

+

Outputs

Configurations

Scripting

result: thermal strain XY

Description

Read/compute element nodal component thermal strains XY shear component (01 component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -6997,7 +6997,15 @@

Configurating operators

prevents from reading the mesh in the result files

region id (integer) or vector of region ids (vector) or region scoping (scoping) of the model (region corresponds to zone for Fluid results or part for LSDyna results).

(for Fluid results only) LabelSpace with combination of zone, phases or species ids

-

Outputs

Configurations

Scripting

result: velocity

Description

Read/compute nodal velocities by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

result: reaction force

Description

Read/compute nodal reaction forces by calling the readers defined by the datasources.

+

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

+

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

+

Fields container already allocated modified inplace

+

result file container allowed to be kept open to cache data

+

result file path container, used if no streams are set

+

if true the field is rotated to global coordinate system (default true). Please check your results carefully if 'false' is used for Elemental or ElementalNodal results averaged to the Nodes when adjacent elements do not share the same coordinate system, as results may be incorrect.

+

prevents from reading the mesh in the result files

+

Outputs

Configurations

Scripting

result: velocity

Description

Read/compute nodal velocities by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

Fields container already allocated modified inplace

@@ -7011,15 +7019,7 @@

Configurating operators

angle phi in degrees (default value 0.0), use if cyclic expansion is to be done.

region id (integer) or vector of region ids (vector) or region scoping (scoping) of the model (region corresponds to zone for Fluid results or part for LSDyna results).

(for Fluid results only) LabelSpace with combination of zone, phases or species ids

-

Outputs

Configurations

Scripting

result: reaction force

Description

Read/compute nodal reaction forces by calling the readers defined by the datasources.

-

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

-

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

-

Fields container already allocated modified inplace

-

result file container allowed to be kept open to cache data

-

result file path container, used if no streams are set

-

if true the field is rotated to global coordinate system (default true). Please check your results carefully if 'false' is used for Elemental or ElementalNodal results averaged to the Nodes when adjacent elements do not share the same coordinate system, as results may be incorrect.

-

prevents from reading the mesh in the result files

-

Outputs

Configurations

Scripting

result: velocity X

Description

Read/compute nodal velocities X component of the vector (1st component) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

result: reaction force X

Description

Read/compute nodal reaction forces X component of the vector (1st component) by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -7028,7 +7028,7 @@

Configurating operators

if true the field is rotated to global coordinate system (default true)

prevents from reading the mesh in the result files

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

-

Outputs

Configurations

Scripting

result: reaction force X

Description

Read/compute nodal reaction forces X component of the vector (1st component) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

result: velocity X

Description

Read/compute nodal velocities X component of the vector (1st component) by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -7037,7 +7037,7 @@

Configurating operators

if true the field is rotated to global coordinate system (default true)

prevents from reading the mesh in the result files

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

-

Outputs

Configurations

Scripting

geo: cartesian to spherical coordinates (fields container)

Description

Converts 3D field from cartesian coordinates to spherical coordinates.

+

Outputs

Configurations

Scripting

geo: cartesian to spherical coordinates (fields container)

Description

Converts 3D field from cartesian coordinates to spherical coordinates.

Inputs

Outputs

Configurations

Scripting

result: global external work (LSDyna)

Description

Read Global External Work (LSDyna) by calling the readers defined by the datasources.

Inputs

result file container allowed to be kept open to cache data

result file path container, used if no streams are set

@@ -7177,15 +7177,7 @@

Configurating operators

elemental nodal beam results are read if this pin is set to true (default is false)

This pin forces elemental nodal shell and solid results to be split if this pin is set to true. If set to false (default), a specific shell layer is still needed to merge the fields. Merge is possible only if a shell layer is provided.

If the requested_location pin is not connected, and if split_shells pin is set to true, we choose one of the shell layer for shell element. If split_shells pin is set to false (default value) and a specific shell layer is provided, results will be merged on this specific shell layer.

-

Outputs

Configurations

Scripting

result: total contact moment

Description

Read/compute total contact moment by calling the readers defined by the datasources.

-

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

-

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

-

Fields container already allocated modified inplace

-

result file container allowed to be kept open to cache data

-

result file path container, used if no streams are set

-

if true the field is rotated to global coordinate system (default true). Please check your results carefully if 'false' is used for Elemental or ElementalNodal results averaged to the Nodes when adjacent elements do not share the same coordinate system, as results may be incorrect.

-

prevents from reading the mesh in the result files

-

Outputs

Configurations

Scripting

result: heat flux Z

Description

Read/compute heat flux Z component of the vector (3rd component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

result: heat flux Z

Description

Read/compute heat flux Z component of the vector (3rd component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -7196,12 +7188,15 @@

Configurating operators

requested location, default is Nodal

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

elemental nodal beam results are read if this pin is set to true (default is false)

-

Outputs

Configurations

Scripting

serialization: serialize to hdf5

Description

This operator is deprecated: use 'hdf5::h5dpf::make_result_file' instead. Serialize the inputs in an hdf5 format.

-

Inputs

output file path with .h5 extension

-

converts double to float to reduce file size (default is true)

-

if true, vectors and matrices data are exported flat (x1,y1,z1,x2,y2,z2..) (default is false)

-

only the data set explicitly to export is exported

-

Outputs

Configurations

Scripting

result: element orientations

Description

Read/compute element euler angles by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

result: total contact moment

Description

Read/compute total contact moment by calling the readers defined by the datasources.

+

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

+

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

+

Fields container already allocated modified inplace

+

result file container allowed to be kept open to cache data

+

result file path container, used if no streams are set

+

if true the field is rotated to global coordinate system (default true). Please check your results carefully if 'false' is used for Elemental or ElementalNodal results averaged to the Nodes when adjacent elements do not share the same coordinate system, as results may be incorrect.

+

prevents from reading the mesh in the result files

+

Outputs

Configurations

Scripting

result: element orientations

Description

Read/compute element euler angles by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

Fields container already allocated modified inplace

@@ -7213,7 +7208,12 @@

Configurating operators

elemental nodal beam results are read if this pin is set to true (default is false)

This pin forces elemental nodal shell and solid results to be split if this pin is set to true. If set to false (default), a specific shell layer is still needed to merge the fields. Merge is possible only if a shell layer is provided.

If the requested_location pin is not connected, and if split_shells pin is set to true, we choose one of the shell layer for shell element. If split_shells pin is set to false (default value) and a specific shell layer is provided, results will be merged on this specific shell layer.

-

Outputs

Configurations

Scripting

result: element orientations Y

Description

Read/compute element euler angles Y component of the vector (2nd component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

serialization: serialize to hdf5

Description

This operator is deprecated: use 'hdf5::h5dpf::make_result_file' instead. Serialize the inputs in an hdf5 format.

+

Inputs

output file path with .h5 extension

+

converts double to float to reduce file size (default is true)

+

if true, vectors and matrices data are exported flat (x1,y1,z1,x2,y2,z2..) (default is false)

+

only the data set explicitly to export is exported

+

Outputs

Configurations

Scripting

result: element orientations Y

Description

Read/compute element euler angles Y component of the vector (2nd component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -7373,7 +7373,10 @@

Configurating operators

result file path container, used if no streams are set

entity (part for matsum, interface for rcforc) where the result will be scoped

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

-

Outputs

Configurations

Scripting

result: magnetic field X

Description

Read/compute Magnetic Field X component of the vector (1st component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

serialization: string deserializer

Description

Takes a string generated by the serializer and deserializes it into DPF's entities.

+

Inputs

0 for string (default), and 1 for binary

+

Outputs

number and types of outputs corresponding of the inputs used in the serialization

+

Configurations

Scripting

result: magnetic field X

Description

Read/compute Magnetic Field X component of the vector (1st component) by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

FieldsContainer already allocated modified inplace

@@ -7384,10 +7387,7 @@

Configurating operators

requested location, default is Nodal

if 0 cyclic symmetry is ignored, if 1 cyclic sector is read, if 2 cyclic expansion is done, if 3 cyclic expansion is done and stages are merged (default is 1)

elemental nodal beam results are read if this pin is set to true (default is false)

-

Outputs

Configurations

Scripting

serialization: string deserializer

Description

Takes a string generated by the serializer and deserializes it into DPF's entities.

-

Inputs

0 for string (default), and 1 for binary

-

Outputs

number and types of outputs corresponding of the inputs used in the serialization

-

Configurations

Scripting

result: magnetic flux density

Description

Read/compute Magnetic Flux Density by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

result: magnetic flux density

Description

Read/compute Magnetic Flux Density by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

Fields container already allocated modified inplace

@@ -7513,10 +7513,10 @@

Configurating operators

Outputs

Configurations

Scripting

metadata: result info provider

Description

Reads the result information, such as available results or unit systems from the results files contained in the streams or data sources.

Inputs

streams (result file container) (optional)

If the stream is null, retrieves the file path from the data sources.

-

Outputs

Configurations

Scripting

mesh: skin (tri mesh)

Description

Extracts a skin of the mesh in triangles in a new meshed region.

-

Inputs

True: meshing will also take into account shell and skin elements. False: meshing will ignore shell and skin elements. The default is false.

-

Nodal scoping to restrict the skin extraction to a set of nodes. If provided, a skin element is added to the skin mesh if all its nodes are in the scoping.

-

Outputs

Configurations

Scripting

result: stress ratio

Description

Read/compute element nodal stress ratio by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

filter: band pass (timescoping)

Description

The band pass filter returns all the values above (but not equal to) the minimum threshold value and below (but not equal to) the maximum threshold value in input.

+

Inputs

A minimum threshold scalar or a field containing one value is expected.

+

A maximum threshold scalar or a field containing one value is expected.

+

Outputs

Configurations

Scripting

result: stress ratio

Description

Read/compute element nodal stress ratio by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

Fields container already allocated modified inplace

@@ -7528,10 +7528,10 @@

Configurating operators

elemental nodal beam results are read if this pin is set to true (default is false)

This pin forces elemental nodal shell and solid results to be split if this pin is set to true. If set to false (default), a specific shell layer is still needed to merge the fields. Merge is possible only if a shell layer is provided.

If the requested_location pin is not connected, and if split_shells pin is set to true, we choose one of the shell layer for shell element. If split_shells pin is set to false (default value) and a specific shell layer is provided, results will be merged on this specific shell layer.

-

Outputs

Configurations

Scripting

filter: band pass (timescoping)

Description

The band pass filter returns all the values above (but not equal to) the minimum threshold value and below (but not equal to) the maximum threshold value in input.

-

Inputs

A minimum threshold scalar or a field containing one value is expected.

-

A maximum threshold scalar or a field containing one value is expected.

-

Outputs

Configurations

Scripting

result: accu eqv plastic strain

Description

Read/compute element nodal accumulated equivalent plastic strain by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

mesh: skin (tri mesh)

Description

Extracts a skin of the mesh in triangles in a new meshed region.

+

Inputs

True: meshing will also take into account shell and skin elements. False: meshing will ignore shell and skin elements. The default is false.

+

Nodal scoping to restrict the skin extraction to a set of nodes. If provided, a skin element is added to the skin mesh if all its nodes are in the scoping.

+

Outputs

Configurations

Scripting

result: accu eqv plastic strain

Description

Read/compute element nodal accumulated equivalent plastic strain by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

Fields container already allocated modified inplace

@@ -7611,7 +7611,10 @@

Configurating operators

elemental nodal beam results are read if this pin is set to true (default is false)

This pin forces elemental nodal shell and solid results to be split if this pin is set to true. If set to false (default), a specific shell layer is still needed to merge the fields. Merge is possible only if a shell layer is provided.

If the requested_location pin is not connected, and if split_shells pin is set to true, we choose one of the shell layer for shell element. If split_shells pin is set to false (default value) and a specific shell layer is provided, results will be merged on this specific shell layer.

-

Outputs

Configurations

Scripting

result: contact status

Description

Read/compute element contact status by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

serialization: field to csv

Description

Exports a field or a fields container into a csv file

+

Inputs

field_or_fields_container

+

storage type : if matrices (without any particularity) are included in the fields container, the storage format can be chosen. 0 : flat/line format, 1 : ranked format. If 1 is chosen, the csv can not be read by "csv to field" operator anymore. Default : 0.

+

Outputs

Configurations

Scripting

result: contact status

Description

Read/compute element contact status by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

Fields container already allocated modified inplace

@@ -7627,10 +7630,7 @@

Configurating operators

elemental nodal beam results are read if this pin is set to true (default is false)

This pin forces elemental nodal shell and solid results to be split if this pin is set to true. If set to false (default), a specific shell layer is still needed to merge the fields. Merge is possible only if a shell layer is provided.

If the requested_location pin is not connected, and if split_shells pin is set to true, we choose one of the shell layer for shell element. If split_shells pin is set to false (default value) and a specific shell layer is provided, results will be merged on this specific shell layer.

-

Outputs

Configurations

Scripting

serialization: field to csv

Description

Exports a field or a fields container into a csv file

-

Inputs

field_or_fields_container

-

storage type : if matrices (without any particularity) are included in the fields container, the storage format can be chosen. 0 : flat/line format, 1 : ranked format. If 1 is chosen, the csv can not be read by "csv to field" operator anymore. Default : 0.

-

Outputs

Configurations

Scripting

result: contact penetration

Description

Read/compute element contact penetration by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

+

Outputs

Configurations

Scripting

result: contact penetration

Description

Read/compute element contact penetration by calling the readers defined by the datasources. Regarding the requested location and the input mesh scoping, the result location can be Nodal/ElementalNodal/Elemental.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

Fields container already allocated modified inplace

@@ -8034,39 +8034,39 @@

Configurating operators

elemental nodal beam results are read if this pin is set to true (default is false)

This pin forces elemental nodal shell and solid results to be split if this pin is set to true. If set to false (default), a specific shell layer is still needed to merge the fields. Merge is possible only if a shell layer is provided.

If the requested_location pin is not connected, and if split_shells pin is set to true, we choose one of the shell layer for shell element. If split_shells pin is set to false (default value) and a specific shell layer is provided, results will be merged on this specific shell layer.

-

Outputs

Configurations

Scripting

result: global kinetic energy (LSDyna)

Description

Read Global Kinetic Energy (LSDyna) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

utility: merge supports

Description

Assembles a set of supports into a unique one.

+

Inputs

For some result files (such as RST), the scoping on names selection is duplicated through all the distributed files.If this pin is false, the merging process is skipped. If it is true, this scoping is merged. Default is true.

+

A vector of supports to merge or supports from pin 0 to ...

+

Outputs

Configurations

Scripting

result: global kinetic energy (LSDyna)

Description

Read Global Kinetic Energy (LSDyna) by calling the readers defined by the datasources.

Inputs

result file container allowed to be kept open to cache data

result file path container, used if no streams are set

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

-

Outputs

Configurations

Scripting

utility: merge supports

Description

Assembles a set of supports into a unique one.

-

Inputs

For some result files (such as RST), the scoping on names selection is duplicated through all the distributed files.If this pin is false, the merging process is skipped. If it is true, this scoping is merged. Default is true.

-

A vector of supports to merge or supports from pin 0 to ...

-

Outputs

Configurations

Scripting

math: matrix inverse

Description

Computes the complex matrix inverse for each field in the given fields container.

+

Outputs

Configurations

Scripting

result: global time step (LSDyna)

Description

Read Global Time Step (LSDyna) by calling the readers defined by the datasources.

+

Inputs

result file container allowed to be kept open to cache data

+

result file path container, used if no streams are set

+

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

+

Outputs

Configurations

Scripting

math: matrix inverse

Description

Computes the complex matrix inverse for each field in the given fields container.

Inputs

fields_container

-

Outputs

Configurations

Scripting

result: global time step (LSDyna)

Description

Read Global Time Step (LSDyna) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

geo: cartesian to spherical coordinates

Description

Converts 3D field from cartesian coordinates to spherical coordinates.

+

Inputs

Outputs

Configurations

Scripting

result: global rigid body stopper energy (LSDyna)

Description

Read Global Rigid Body Stopper Energy (LSDyna) by calling the readers defined by the datasources.

Inputs

result file container allowed to be kept open to cache data

result file path container, used if no streams are set

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

-

Outputs

Configurations

Scripting

result: global rigid body stopper energy (LSDyna)

Description

Read Global Rigid Body Stopper Energy (LSDyna) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

result: global spring and damper energy (LSDyna)

Description

Read Global Spring and Damper Energy (LSDyna) by calling the readers defined by the datasources.

Inputs

result file container allowed to be kept open to cache data

result file path container, used if no streams are set

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

-

Outputs

Configurations

Scripting

geo: cartesian to spherical coordinates

Description

Converts 3D field from cartesian coordinates to spherical coordinates.

-

Inputs

Outputs

Configurations

Scripting

result: global spring and damper energy (LSDyna)

Description

Read Global Spring and Damper Energy (LSDyna) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

result: global hourglass energy (LSDyna)

Description

Read Global Hourglass Energy (LSDyna) by calling the readers defined by the datasources.

Inputs

result file container allowed to be kept open to cache data

result file path container, used if no streams are set

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

-

Outputs

Configurations

Scripting

result: beam T bending moment (LSDyna)

Description

Read Beam T Bending Moment (LSDyna) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

result: beam T bending moment (LSDyna)

Description

Read Beam T Bending Moment (LSDyna) by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

elements scoping required in output.

result file container allowed to be kept open to cache data

result file path container, used if no streams are set

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

-

Outputs

Configurations

Scripting

result: global hourglass energy (LSDyna)

Description

Read Global Hourglass Energy (LSDyna) by calling the readers defined by the datasources.

-

Inputs

result file container allowed to be kept open to cache data

-

result file path container, used if no streams are set

-

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

-

Outputs

Configurations

Scripting

result: global system damping energy (LSDyna)

Description

Read Global System Damping Energy (LSDyna) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

result: global system damping energy (LSDyna)

Description

Read Global System Damping Energy (LSDyna) by calling the readers defined by the datasources.

Inputs

result file container allowed to be kept open to cache data

result file path container, used if no streams are set

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

@@ -8078,16 +8078,16 @@

Configurating operators

Inputs

result file container allowed to be kept open to cache data

result file path container, used if no streams are set

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

-

Outputs

Configurations

Scripting

result: global added mass (LSDyna)

Description

Read Global Added Mass (LSDyna) by calling the readers defined by the datasources.

-

Inputs

result file container allowed to be kept open to cache data

-

result file path container, used if no streams are set

-

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

-

Outputs

Configurations

Scripting

mapping: on reduced coordinates

Description

Evaluates a result on specified reduced coordinates of given elements (interpolates results inside elements with shape functions).

+

Outputs

Configurations

Scripting

mapping: on reduced coordinates

Description

Evaluates a result on specified reduced coordinates of given elements (interpolates results inside elements with shape functions).

Inputs

coordinates in the reference elements to find (found with the operator "find_reduced_coordinates")

Ids of the elements where each set of reduced coordinates is found (found with the operator "find_reduced_coordinates")

if the first field in input has no mesh in support, then the mesh in this pin is expected (default is false), if a meshes container with several meshes is set, it should be on the same label spaces as the coordinates fields container

If this pin is set to true, the interpolation is computed on the quadratic element if the element is quadratic (more precise but less performant). Default is false. To use only when results have mid side nodes values.

-

Outputs

Configurations

Scripting

invariant: principal invariants (fields container)

Description

Computes the element-wise Eigen values of all the tensor fields of a fields container.

+

Outputs

Configurations

Scripting

result: global added mass (LSDyna)

Description

Read Global Added Mass (LSDyna) by calling the readers defined by the datasources.

+

Inputs

result file container allowed to be kept open to cache data

+

result file path container, used if no streams are set

+

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

+

Outputs

Configurations

Scripting

invariant: principal invariants (fields container)

Description

Computes the element-wise Eigen values of all the tensor fields of a fields container.

Inputs

Outputs

first eigen value fields

second eigen value fields

third eigen value fields

@@ -8121,19 +8121,19 @@

Configurating operators

result file path container, used if no streams are set

integration point where the result will be read from. Default value: 0 (first integration point).

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

-

Outputs

Configurations

Scripting

result: beam axial plastic strain (LSDyna)

Description

Read Beam Axial Plastic strain (LSDyna) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

invariant: von mises eqv (field)

Description

Computes the element-wise Von-Mises criteria on a tensor field.

+

Inputs

field or fields container with only one field is expected

+

Poisson ratio to be used in equivalent strain calculation.

+

Outputs

Configurations

Scripting

utility: merge fields into field matrix

Description

Assembles a set of fields into a field matrix.

+

Inputs

Either a fields container, a vector of fields to merge, or fields from pin 0 to ...

+

Outputs

Configurations

Scripting

result: beam axial plastic strain (LSDyna)

Description

Read Beam Axial Plastic strain (LSDyna) by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

elements scoping required in output.

result file container allowed to be kept open to cache data

result file path container, used if no streams are set

integration point where the result will be read from. Default value: 0 (first integration point).

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

-

Outputs

Configurations

Scripting

utility: merge fields into field matrix

Description

Assembles a set of fields into a field matrix.

-

Inputs

Either a fields container, a vector of fields to merge, or fields from pin 0 to ...

-

Outputs

Configurations

Scripting

invariant: von mises eqv (field)

Description

Computes the element-wise Von-Mises criteria on a tensor field.

-

Inputs

field or fields container with only one field is expected

-

Poisson ratio to be used in equivalent strain calculation.

-

Outputs

Configurations

Scripting

invariant: segalman von mises eqv (field)

Description

Computes the element-wise Segalman Von-Mises criteria on a tensor field.

+

Outputs

Configurations

Scripting

invariant: segalman von mises eqv (field)

Description

Computes the element-wise Segalman Von-Mises criteria on a tensor field.

Inputs

field or fields container with only one field is expected

Outputs

Configurations

Scripting

result: part eroded internal energy (LSDyna)

Description

Read Part Eroded Internal Energy (LSDyna) by calling the readers defined by the datasources.

Inputs

result file container allowed to be kept open to cache data

@@ -8162,15 +8162,15 @@

Configurating operators

result file path container, used if no streams are set

entity (part for matsum, interface for rcforc) where the result will be scoped

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

-

Outputs

Configurations

Scripting

result: interface contact force (LSDyna)

Description

Read Interface Contact Force (LSDyna) by calling the readers defined by the datasources.

+

Outputs

Configurations

Scripting

min_max: time of max

Description

Evaluates time/frequency of maximum.

+

Inputs

Should use absolute value.

+

Do calculate amplitude.

+

Outputs

Configurations

Scripting

result: interface contact force (LSDyna)

Description

Read Interface Contact Force (LSDyna) by calling the readers defined by the datasources.

Inputs

result file container allowed to be kept open to cache data

result file path container, used if no streams are set

entity (part for matsum, interface for rcforc) where the result will be scoped

Unit System ID (int), semicolon-separated list of base unit strings (str) or UnitSystem instance

-

Outputs

Configurations

Scripting

min_max: time of max

Description

Evaluates time/frequency of maximum.

-

Inputs

Should use absolute value.

-

Do calculate amplitude.

-

Outputs

Configurations

Scripting

scoping: nodes in mesh

Description

Retrieves the nodal scoping of a given input mesh, which contains the node IDs.

+

Outputs

Configurations

Scripting

scoping: nodes in mesh

Description

Retrieves the nodal scoping of a given input mesh, which contains the node IDs.

Inputs

Outputs

Configurations

Scripting

result: interface resultant contact force (LSDyna)

Description

Read Interface Resultant Contact Force (LSDyna) by calling the readers defined by the datasources.

Inputs

result file container allowed to be kept open to cache data

result file path container, used if no streams are set

@@ -8247,16 +8247,16 @@

Configurating operators

prevents from reading the mesh in the result files

region id (integer) or vector of region ids (vector) or region scoping (scoping) of the model (region corresponds to zone for Fluid results or part for LSDyna results).

(for Fluid results only) LabelSpace with combination of zone, phases or species ids

-

Outputs

Configurations

Scripting

result: read cms_rbd file

Description

Read the invariant terms and the model data from a cms_rbd file

+

Outputs

Configurations

Scripting

scoping: scoping get attribute

Description

Uses the Scoping APIs to return a given attribute of the scoping in input.

+

Inputs

Supported property names are: "ids", "location".

+

Outputs

Returns a vector of int for property: "ids" and a string for property: "location".

+

Configurations

Scripting

result: read cms_rbd file

Description

Read the invariant terms and the model data from a cms_rbd file

Inputs

file name with cms_rbd extension where to read the input cms_rbd file.

Outputs

data describing the finite element model

center of mass of the body

inertia matrix

translational and rotational shape functions

-

Configurations

Scripting

scoping: scoping get attribute

Description

Uses the Scoping APIs to return a given attribute of the scoping in input.

-

Inputs

Supported property names are: "ids", "location".

-

Outputs

Returns a vector of int for property: "ids" and a string for property: "location".

-

Configurations

Scripting

result: mean temperature

Description

Read Mean Temperature by calling the readers defined by the datasources.

+

Configurations

Scripting

result: mean temperature

Description

Read Mean Temperature by calling the readers defined by the datasources.

Inputs

time/freq values (use doubles or field), time/freq set ids (use ints or scoping) or time/freq step ids (use scoping with TimeFreq_steps location) required in output. To specify time/freq values at specific load steps, put a Field (and not a list) in input with a scoping located on "TimeFreq_steps". Linear time freq intrapolation is performed if the values are not in the result files and the data at the max time or freq is taken when time/freqs are higher than available time/freqs in result files. To get all data for all time/freq sets, connect an int with value -1.

nodes or elements scoping required in output. The output fields will be scoped on these node or element IDs. To figure out the ordering of the fields data, look at their scoping IDs as they might not be ordered as the input scoping was. The scoping's location indicates whether nodes or elements are asked for. Using scopings container allows you to split the result fields container into domains

result file container allowed to be kept open to cache data

@@ -8311,12 +8311,12 @@

Configurating operators

Inputs

the mesh region in this pin have to be boundary or skin mesh

load step number, if it's specified, the Poynting Vector is computed only on the substeps of this step

Outputs

Configurations

Scripting

metadata: datasources provider

Description

Creates a DataSources by expanding another.

-

Inputs

Outputs

Configurations

Scripting

scoping: rescope

Description

Rescopes a field on the given scoping. If an ID does not exist in the original field, the default value (in 2) is used when defined.

-

Inputs

If pin 2 is used, the IDs not found in the field are added with this default value.

-

Outputs

Configurations

Scripting

filter: low pass (timescoping)

Description

The low pass filter returns all the values below (but not equal to) the threshold value in input.

+

Inputs

Outputs

Configurations

Scripting

filter: low pass (timescoping)

Description

The low pass filter returns all the values below (but not equal to) the threshold value in input.

Inputs

a threshold scalar or a field containing one value is expected

The default is false. If set to true, the complement of the filtered fields container is returned on output pin 1.

-

Outputs

Configurations

Scripting

utility: data sources get attribute

Description

A DataSources in pin 0 and a property name (string) in pin 1 are expected in input. An index refering to the property can also be provided.

+

Outputs

Configurations

Scripting

scoping: rescope

Description

Rescopes a field on the given scoping. If an ID does not exist in the original field, the default value (in 2) is used when defined.

+

Inputs

If pin 2 is used, the IDs not found in the field are added with this default value.

+

Outputs

Configurations

Scripting

utility: data sources get attribute

Description

A DataSources in pin 0 and a property name (string) in pin 1 are expected in input. An index refering to the property can also be provided.

Inputs

Accepted inputs are: 'file_path' (returns string), 'result_file_name' (returns string), 'domain_file_path' (returns string), 'domain_result_file_name' (returns string), 'num_keys' (returns int), num_result_key (returns int), num_file_path (returns int), 'num_result_file_path' (returns int), 'key_by_index' (returns string), 'result_key_by_index' (returns string), 'path_by_index' (returns string), 'path_key_by_index' (returns string).

Index for the property. Must be set for 'domain_file_path', 'domain_result_file_name' 'key_by_index', 'result_key_by_index', 'path_by_index' and 'path_key_by_index' properties.

Key to look for. Must be set for 'file_path' and 'domain_file_path' properties.

@@ -8335,17 +8335,17 @@

Configurating operators

Inputs

Either the result of the make_iterable_info operator, or the operator that must be incremented.

Outputs

Configurations

Scripting

metadata: boundary condition provider

Description

Reads boundary conditions from the results files contained in the streams or data sources.

Inputs

Outputs

results info

-

Configurations

Scripting

utility: merge property fields

Description

Assembles a set of property fields into a unique one.

-

Inputs

If true, merge the input property fields assuming that there is no repetition in their scoping ids. Default is false.

-

Either a property fields container, a vector of property fields to merge or property fields from pin 0 to ...

-

Outputs

Configurations

Scripting

metadata: cyclic analysis?

Description

Reads if the model is cyclic from the result file.

+

Configurations

Scripting

utility: custom type field get attribute

Description

A CustomTypeField in pin 0 and a property name (string) in pin 1 are expected in input.

+

Inputs

Accepted inputs are: 'time_freq_support', 'scoping' and 'header'.

+

Outputs

Property value.

+

Configurations

Scripting

metadata: cyclic analysis?

Description

Reads if the model is cyclic from the result file.

Inputs

streams (result file container) (optional)

If the stream is null, retrieves the file path from the data sources.

Outputs

returns 'single_stage' or 'multi_stage' or an empty string for non cyclic model

-

Configurations

Scripting

utility: custom type field get attribute

Description

A CustomTypeField in pin 0 and a property name (string) in pin 1 are expected in input.

-

Inputs

Accepted inputs are: 'time_freq_support', 'scoping' and 'header'.

-

Outputs

Property value.

-

Configurations

Scripting

metadata: material support provider

Description

Reads the material support.

+

Configurations

Scripting

utility: merge property fields

Description

Assembles a set of property fields into a unique one.

+

Inputs

If true, merge the input property fields assuming that there is no repetition in their scoping ids. Default is false.

+

Either a property fields container, a vector of property fields to merge or property fields from pin 0 to ...

+

Outputs

Configurations

Scripting

metadata: material support provider

Description

Reads the material support.

Inputs

Streams result file container (optional).

if the stream is null, get the file path from the data sources.

Outputs

Configurations

Scripting

scoping: on named selection

Description

provides a scoping at a given location based on a given named selection

@@ -8364,14 +8364,14 @@

Configurating operators

Inputs

Coorfinate System ids to recover used by the solver. If not set, all available materials to be recovered.

Result file container allowed to be kept open to cache data.

Result file path container, used if no streams are set.

-

Outputs

Configurations

Scripting

result: coordinate system

Description

Extracts the Rotation Matrix and Origin of a specific coordinate system.

-

Inputs

Outputs

the first 9 double are the rotation (3x3 matrix) and the last 3 is the translation vector

-

Configurations

Scripting

logic: splitter::streams

Description

Splits a Streams into multiple coherent streams, actual number of outputs is always less or equal to the given desired number of ouputs.

+

Outputs

Configurations

Scripting

logic: splitter::streams

Description

Splits a Streams into multiple coherent streams, actual number of outputs is always less or equal to the given desired number of ouputs.

Inputs

Streams to split.

Number of desired outputs.

Outputs

Actual number of outputs.

Streams outputs.

-

Configurations

Scripting

serialization: hdf5dpf custom read

Description

Extract a custom result from an hdf5dpf file. This operator is deprecated, please use the 'custom' operator instead.

+

Configurations

Scripting

result: coordinate system

Description

Extracts the Rotation Matrix and Origin of a specific coordinate system.

+

Inputs

Outputs

the first 9 double are the rotation (3x3 matrix) and the last 3 is the translation vector

+

Configurations

Scripting

serialization: hdf5dpf custom read

Description

Extract a custom result from an hdf5dpf file. This operator is deprecated, please use the 'custom' operator instead.

Inputs

Hdf5df file stream.

Hdf5df file data source.

meta_data that may be used to evaluate results or extract workflows.

@@ -8397,23 +8397,23 @@

Configurating operators

Configurations

Scripting

min_max: max over time

Description

Evaluates maximum over time/frequency.

Inputs

Should use absolute value.

Do calculate amplitude.

-

Outputs

Configurations

Scripting

mesh: skin

Description

Extracts a skin of the mesh in a new meshed region. The material ID of initial elements are propagated to their facets.

+

Outputs

Configurations

Scripting

utility: split in for each range

Description

Split a scoping into several pieces so you can iterate it with a for_each loop.

+

Inputs

Iterable that can be combined with the one currently generated.

+

Operator that must be reconnected with the range values.

+

Outputs

Configurations

Scripting

metadata: cyclic support provider

Description

Read the cyclic support (DPF entity containing necessary information for expansions) and expands the mesh.

+

Inputs

Streams containing the result file.

+

data sources containing the result file.

+

mesh of the first sector.

+

if this pin is set, expanding the mesh is not necessary.

+

sectors to expand (start at 0), for multistage: use scopings container with 'stage' label.

+

Outputs

Configurations

Scripting

mesh: skin

Description

Extracts a skin of the mesh in a new meshed region. The material ID of initial elements are propagated to their facets.

Inputs

Nodal scoping to restrict the skin extraction to a set of nodes. If provided, a skin element is added to the skin mesh if all its nodes are in the scoping.

If input mesh contains shell elements, output mesh shell elements (boolean = 1) are duplicated, one per each orientation, or (boolean = 0) remain unchanged.

If input mesh contains beam or point elements, output mesh beam point elements (boolean = 1) are added or (boolean = 0) are ignored. Default: False

Outputs

Skin meshed region with facets and facets_to_ele property fields.

This property field provides, for each new face element ID (in the scoping), the corresponding 3D volume element index (in the data) it has been extracted from. The 3D volume element ID can be found with the element scoping of the input mesh.

This property field gives, for each new face element ID (in the scoping), the corresponding face index on the source 3D volume element. The 3D volume element can be extracted from the previous output.

-

Configurations

Scripting

metadata: cyclic support provider

Description

Read the cyclic support (DPF entity containing necessary information for expansions) and expands the mesh.

-

Inputs

Streams containing the result file.

-

data sources containing the result file.

-

mesh of the first sector.

-

if this pin is set, expanding the mesh is not necessary.

-

sectors to expand (start at 0), for multistage: use scopings container with 'stage' label.

-

Outputs

Configurations

Scripting

utility: split in for each range

Description

Split a scoping into several pieces so you can iterate it with a for_each loop.

-

Inputs

Iterable that can be combined with the one currently generated.

-

Operator that must be reconnected with the range values.

-

Outputs

Configurations

Scripting

utility: change shell layers

Description

Extract the requested shell layers from the input fields. If the fields contain only one layer and the permissive configuration input is set to true then it returns the input fields. If permissive configuration input is set to false, any change which should not be permitted won't be achieved and the corresponding field in the output will be empty. If permissive configuration input is set to true (default), carefully check the result.

+

Configurations

Scripting

utility: change shell layers

Description

Extract the requested shell layers from the input fields. If the fields contain only one layer and the permissive configuration input is set to true then it returns the input fields. If permissive configuration input is set to false, any change which should not be permitted won't be achieved and the corresponding field in the output will be empty. If permissive configuration input is set to true (default), carefully check the result.

Inputs

0: Top, 1: Bottom, 2: BottomTop, 3: Mid, 4: BottomTopMid.

Mesh support of the input fields_container, in case it does not have one defined. If the fields_container contains mixed shell/solid results, the mesh is required (either by connecting this pin or in the support).

For fields with mixed shell layers (solid/shell elements with heterogeneous shell layers), group all of them in the same field (false by default).

@@ -8426,10 +8426,7 @@

Configurating operators

0: keep duplicate elements (default), 1: remove duplicate elements

Outputs

Configurations

Scripting

result: add rigid body motion (fields container)

Description

Adds a given rigid translation, center and rotation from a displacement field. The rotation is given in terms of rotations angles. Note that the displacement field has to be in the global coordinate system

Inputs

default is the mesh in the support

-

Outputs

Configurations

Scripting

invariant: convertnum nod to bcs

Description

Converts a fields container from NOD to BCS ordering.

-

Inputs

fields_container

-

Data_sources (must contain the full file).

-

Outputs

Configurations

Scripting

result: members in linear compression bending not certified

Description

This operator is a non-certified example of buckling resistance verification for the compression and bending members for Class I, 2 and 3 cross-sections. It is only provided as an example if you want to develop your own compute norm operator. This norm is linear summation of the utilization ratios of compression members and bending members. The results computed by this beta operator have not been certified by ANSYS. ANSYS declines all responsibility for the use of this operator.

+

Outputs

Configurations

Scripting

result: members in linear compression bending not certified

Description

This operator is a non-certified example of buckling resistance verification for the compression and bending members for Class I, 2 and 3 cross-sections. It is only provided as an example if you want to develop your own compute norm operator. This norm is linear summation of the utilization ratios of compression members and bending members. The results computed by this beta operator have not been certified by ANSYS. ANSYS declines all responsibility for the use of this operator.

Inputs

This pin contains field of beam's Yield Strength defined by the user.

This pin contains file csv or field of beam's end condition defined by the user. If no input at this pin found, it would take end conditions value of all beams as 1

result file container allowed to be kept open to cache data.

@@ -8443,7 +8440,10 @@

Configurating operators

Selection for a cross-section. True: Class 1 or 2 cross-sections. False: Class 3 cross section. If the user defines the cross section as class 1 or 2, the section modulus would be plastic section modulus. If it's class 3- cross section,the section modulus would be elastic section modulus

Selection of fabrication's type if there are beams I in the structure. TRUE: Rolled Section, False: Welded Section. Default: Rolled Section.

Outputs

Linear summation of the utilization ratios in all members submitted under a combination of both bending and compression. These factors should be less than 1 and positive.

-

Configurations

Scripting

geo: gauss to node (field)

Description

Extrapolating results available at Gauss or quadrature points to nodal points for one field. The available elements are: Linear quadrangle, parabolic quadrangle, linear hexagonal, quadratic hexagonal, linear tetrahedral, and quadratic tetrahedral

+

Configurations

Scripting

invariant: convertnum nod to bcs

Description

Converts a fields container from NOD to BCS ordering.

+

Inputs

fields_container

+

Data_sources (must contain the full file).

+

Outputs

Configurations

Scripting

geo: gauss to node (field)

Description

Extrapolating results available at Gauss or quadrature points to nodal points for one field. The available elements are: Linear quadrangle, parabolic quadrangle, linear hexagonal, quadratic hexagonal, linear tetrahedral, and quadratic tetrahedral

Inputs

Scoping to integrate on, if not provided, the one from input field is provided.

Mesh to integrate on.

Outputs

Configurations

Scripting

filter: band pass (timefreq)

Description

The band pass filter returns all the values above (but not equal to) the minimum threshold value and below (but not equal to) the maximum threshold value in input.

@@ -8508,24 +8508,24 @@

Configurating operators

Inputs

Default is false. If true, redundant quantities are summed instead of being ignored.

Already merged field support.

Either a fields container, a vector of fields to merge, or fields from pin 0 to ...

-

Outputs

Configurations

Scripting

utility: merge fc to fc field matrices

Description

Merge fields of fields container into field matrices. The output is a fields container of field matrices.

+

Outputs

Configurations

Scripting

filter: high pass (field)

Description

The high pass filter returns all the values above (but not equal to) the threshold value in input.

+

Inputs

field or fields container with only one field is expected

+

A threshold scalar or a field containing one value is expected.

+

The default is false. If set to true, the complement of the filtered fields container is returned on output pin 1.

+

Outputs

Configurations

Scripting

utility: merge fc to fc field matrices

Description

Merge fields of fields container into field matrices. The output is a fields container of field matrices.

Inputs

fields container to be merged

Label where the merge is required

if it's specified, fields container of field matrices is constructed only on the specified time scoping

Outputs

fields container of field matrices obtained after merging.

-

Configurations

Scripting

filter: high pass (field)

Description

The high pass filter returns all the values above (but not equal to) the threshold value in input.

-

Inputs

field or fields container with only one field is expected

-

A threshold scalar or a field containing one value is expected.

-

The default is false. If set to true, the complement of the filtered fields container is returned on output pin 1.

-

Outputs

Configurations

Scripting

utility: weighted merge fields by label

Description

Performs a weighted merge on fields of a fields container that share the same label value.

+

Configurations

Scripting

min_max: max by component

Description

Give the maximum for each element rank by comparing several fields.

+

Inputs

use_absolute_value

+

field or fields container with only one field is expected

+

Outputs

Configurations

Scripting

utility: weighted merge fields by label

Description

Performs a weighted merge on fields of a fields container that share the same label value.

Inputs

Label identifier that should be merged.

The FieldsContainer's support that has already been merged.

Default is false. If true, redundant quantities are summed instead of being ignored.

Weights to apply to each field from pin 1000 to ...

-

Outputs

Configurations

Scripting

min_max: max by component

Description

Give the maximum for each element rank by comparing several fields.

-

Inputs

use_absolute_value

-

field or fields container with only one field is expected

-

Outputs

Configurations

Scripting

utility: merge fields by label

Description

Merges the fields of a fields container that share the same label value.

+

Outputs

Configurations

Scripting

utility: merge fields by label

Description

Merges the fields of a fields container that share the same label value.

Inputs

Label identifier that should be merged.

The FieldsContainer's support that has already been merged.

Default is false. If true, redundant quantities are summed instead of being ignored.

@@ -8562,15 +8562,13 @@

Configurating operators

data source of dsub file.

Outputs

Configurations

Scripting

min_max: min max over time

Description

Evaluates minimum, maximum by time or frequency over all the entities of each field

Inputs

Calculate the absolute value of field entities before computing the min/max.

-

Outputs

Configurations

Scripting

min_max: min over time

Description

Evaluates minimum over time/frequency.

-

Inputs

Should use absolute value.

-

Do calculate amplitude.

-

Outputs

Configurations

Scripting

geo: element nodal contribution

Description

Compute the fraction of the element measure attributed to each node of each element (fraction of the volume for 3D elements, fraction of the area for 2D elements or fraction of the length for 1D elements). It is computed by taking the integral of the shape function associated to each node within each element.

+

Outputs

Configurations

Scripting

geo: element nodal contribution

Description

Compute the fraction of the element measure attributed to each node of each element (fraction of the volume for 3D elements, fraction of the area for 2D elements or fraction of the length for 1D elements). It is computed by taking the integral of the shape function associated to each node within each element.

Inputs

Integrate the input field over a specific scoping.

If true, returns influence volume, area or length. If false, the values are normalized with the element volume, area or length. Default: true.

-

Outputs

Configurations

Scripting

min_max: over field

Description

Compute the component-wise minimum (out 0) and maximum (out 1) over a field.

-

Inputs

field or fields container with only one field is expected

-

Outputs

Configurations

Scripting

result: transient rayleigh integration

Description

Computes the transient Rayleigh integral

+

Outputs

Configurations

Scripting

min_max: min over time

Description

Evaluates minimum over time/frequency.

+

Inputs

Should use absolute value.

+

Do calculate amplitude.

+

Outputs

Configurations

Scripting

result: transient rayleigh integration

Description

Computes the transient Rayleigh integral

Inputs

the input field container expects acceleration fields

The meshes region in this pin has to be boundary or skin mesh. This is the source meshes.

Load step number (if it's specified, the Transient rayleigh integration is computed only on the substeps of this step) or time scoping

@@ -8578,7 +8576,9 @@

Configurating operators

This is the observation mesh region

Mass density (if it's not specified, default value of the air is applied).

Speed of sound (if it's not specified, default value of the speed of sound in the air is applied).

-

Outputs

Configurations

Scripting

min_max: over label

Description

Create two fields (0 min 1 max) by looping over the fields container in input and taking the min/max value by component through all the fields having the same id for the label set in input (in pin 1). If no label is specified or if the specified label doesn't exist, the operation is done over all the fields. The fields out are located on the label set in input, so their scoping are the labels ids.For each min max value, the label id for one other fields container labels is kept and returned in a scoping in pin 2 (min) and 3 (max).The field's scoping ids of the value kept in min max are also returned in the scopings in pin 4 (min) and 5 (max).

+

Outputs

Configurations

Scripting

min_max: over field

Description

Compute the component-wise minimum (out 0) and maximum (out 1) over a field.

+

Inputs

field or fields container with only one field is expected

+

Outputs

Configurations

Scripting

min_max: over label

Description

Create two fields (0 min 1 max) by looping over the fields container in input and taking the min/max value by component through all the fields having the same id for the label set in input (in pin 1). If no label is specified or if the specified label doesn't exist, the operation is done over all the fields. The fields out are located on the label set in input, so their scoping are the labels ids.For each min max value, the label id for one other fields container labels is kept and returned in a scoping in pin 2 (min) and 3 (max).The field's scoping ids of the value kept in min max are also returned in the scopings in pin 4 (min) and 5 (max).

Inputs

label name from the fields container

Outputs

Configurations

Scripting

min_max: min by component

Description

Give the minimum for each element rank by comparing several fields.

Inputs

use_absolute_value

@@ -8600,9 +8600,9 @@

Configurating operators

Inputs

Outputs

Configurations

Scripting

geo: rotate (fields container)

Description

Apply a transformation (rotation) matrix on all the fields of a fields container.

Inputs

3-3 rotation matrix

Outputs

Configurations

Scripting

utility: incremental property field

Description

Incrementaly merge the input.

-

Inputs

Outputs

Configurations

Scripting

utility: incremental mesh

Description

Incrementaly merge the input.

-

Inputs

Outputs

Configurations

Scripting

mesh: points from coordinates

Description

Extract a mesh made of points elements. This mesh is made from input meshes coordinates on the input scopings.

-

Inputs

Outputs

Configurations

Scripting

utility: incremental concantenate as fields container.

Description

Assemble fields in a fields container.

+

Inputs

Outputs

Configurations

Scripting

mesh: points from coordinates

Description

Extract a mesh made of points elements. This mesh is made from input meshes coordinates on the input scopings.

+

Inputs

Outputs

Configurations

Scripting

utility: incremental mesh

Description

Incrementaly merge the input.

+

Inputs

Outputs

Configurations

Scripting

utility: incremental concantenate as fields container.

Description

Assemble fields in a fields container.

Inputs

Label space value that must be applied to the added field.

Outputs

Configurations

Scripting

utility: make producer consumer for each iterator

Description

Generates an iterator that can be consumed by the for_each operator.The chain of Operators are split into a first part : the producers and a second part : the consumers.Asynchronous buffers are indeed to connect the producers and the consumers.

Inputs

if true, already iterable values connected in pin 3 like vectors, Scoping, TimefreqSupport, Containers and DataSources are split to iterate on it (default is true)

@@ -8738,11 +8738,11 @@

Configurating operators

3-3 rotation matrix

Outputs

Configurations

Scripting

serialization: data tree to json

Description

Writes a json file or string from a DataTree

Inputs

Outputs

Configurations

Scripting

serialization: data tree to txt

Description

Writes a txt file or string from a DataTree

-

Inputs

Outputs

Configurations

Scripting

serialization: json to data tree

Description

Reads a json file or string to a DataTree

-

Inputs

Outputs

Configurations

Scripting

averaging: nodal difference (fields container)

Description

Transforms Elemental Nodal fields into Nodal fields. Each nodal value is the maximum difference between the unaveraged computed result for all elements that share this particular node. The result is computed on a given node scoping. If the input fields are mixed shell/solid, then the fields are split by element shape and the output fields container has an elshape label.

+

Inputs

Outputs

Configurations

Scripting

averaging: nodal difference (fields container)

Description

Transforms Elemental Nodal fields into Nodal fields. Each nodal value is the maximum difference between the unaveraged computed result for all elements that share this particular node. The result is computed on a given node scoping. If the input fields are mixed shell/solid, then the fields are split by element shape and the output fields container has an elshape label.

Inputs

The mesh region in this pin is used to perform the averaging. It is used if there is no fields support.

Average only on these nodes. If it is a scoping container, the label must correspond to the one of the fields containers.

-

Outputs

Configurations

Scripting

logic: descending sort

Description

Sort a field (in 0) in descending order, with an optional component priority table or a boolean to enable sort by scoping (in 1). This operator doesn't support multiple elementary data per entity.

+

Outputs

Configurations

Scripting

serialization: json to data tree

Description

Reads a json file or string to a DataTree

+

Inputs

Outputs

Configurations

Scripting

logic: descending sort

Description

Sort a field (in 0) in descending order, with an optional component priority table or a boolean to enable sort by scoping (in 1). This operator doesn't support multiple elementary data per entity.

Inputs

field or fields container with only one field is expected

component priority table (vector of int)

if true, uses scoping to sort the field (default is false)

@@ -8782,7 +8782,14 @@

Configurating operators

Outputs

Actual number of outputs.

Data sources outputs.

Configurations

Scripting

averaging: to elemental nodal (fields container)

Description

Transforms fields into Elemental Nodal fields using an averaging process. The result is computed on a given element's scoping.

-

Inputs

Outputs

Configurations

Scripting

server: grpc start server

Description

Starts a dpf's grpc server (if local) or connect to one and keep it waiting for requests in a streams.

+

Inputs

Outputs

Configurations

Scripting

result: compute stress XY

Description

Computes the stress from an elastic strain field. compute_total_strain limitations are applicable for stress computation Get the XY shear component (01 component).

+

Inputs

The element scoping on which the result is computed.

+

Needed to get mesh and material ids. Optional if a data_sources have been connected.

+

Needed to get mesh and material ids. Optional if a streams_container have been connected.

+

Average the Elemental Nodal result to the requested location.

+

Field/or fields container containing only the elastic strain field (element nodal).

+

Outputs

The computed result fields container (elemental nodal).

+

Configurations

Scripting

server: grpc start server

Description

Starts a dpf's grpc server (if local) or connect to one and keep it waiting for requests in a streams.

Inputs

If no ip address is put, the local ip address is taken

If no port is put, port 50052 is taken

default is 1 that starts server in new thread. With 0, this thread will be waiting for grpc calls and will not be usable for anything else. With 2, it the server will be started in a new process.

@@ -8790,14 +8797,7 @@

Configurating operators

A data source with result key 'grpc' and file path 'port:ip' can be used instead of the input port and IP.

This pin is associated with pin(2) = 2 (server started in a new process). User can enter the integer associated with a DPF context (1: Standalone Context - DpfCoreStandalone.xml, 3: Custom - DpfCustomDefined.xml) or a string with the path of the XML specifying the context.

Outputs

dpf streams handling the server, if the server is started in this thread, then nothing is added in output

-

Configurations

Scripting

result: compute stress XY

Description

Computes the stress from an elastic strain field. compute_total_strain limitations are applicable for stress computation Get the XY shear component (01 component).

-

Inputs

The element scoping on which the result is computed.

-

Needed to get mesh and material ids. Optional if a data_sources have been connected.

-

Needed to get mesh and material ids. Optional if a streams_container have been connected.

-

Average the Elemental Nodal result to the requested location.

-

Field/or fields container containing only the elastic strain field (element nodal).

-

Outputs

The computed result fields container (elemental nodal).

-

Configurations

Scripting

utility: operator id

Description

Return the id of an Operator.

+

Configurations

Scripting

utility: operator id

Description

Return the id of an Operator.

Inputs

Outputs

Configurations

Scripting

averaging: elemental nodal to nodal (field)

Description

Transforms an Elemental Nodal field into a Nodal field using an averaging process. The result is computed on a given node's scoping.

Inputs

field or fields container with only one field is expected

average only on these entities

@@ -8899,18 +8899,18 @@

Configurating operators

Outputs

Global rigid translation vector

Global rigid rotation angles

Center of the rigid rotation

-

Configurations

Scripting

result: cyclic expansion

Description

Expand cyclic results from a fieldsContainer for given sets, sectors and scoping (optionals).

+

Configurations

Scripting

averaging: nodal fraction (fields container)

Description

Transforms Elemental Nodal fields into Nodal fields. Each nodal value is the fraction between the nodal difference and the nodal average. The result is computed on a given node's scoping.

+

Inputs

The mesh region in this pin is used to perform the averaging. It is used if there is no fields support.

+

Average only on these nodes. If it is a scoping container, the label must correspond to the one of the fields containers.

+

If a fields container is set in this pin, it is used as the denominator of the fraction instead of elemental_nodal_To_nodal_fc.

+

Outputs

Configurations

Scripting

result: cyclic expansion

Description

Expand cyclic results from a fieldsContainer for given sets, sectors and scoping (optionals).

Inputs

field container with the base and duplicate sectors

default is true

map provider by scoping adapter

sectors to expand (start at 0), for multistage: use scopings container with 'stage' label.

angle phi in degrees (default value 0.0)

Outputs

FieldsContainer filled in

-

Configurations

Scripting

averaging: nodal fraction (fields container)

Description

Transforms Elemental Nodal fields into Nodal fields. Each nodal value is the fraction between the nodal difference and the nodal average. The result is computed on a given node's scoping.

-

Inputs

The mesh region in this pin is used to perform the averaging. It is used if there is no fields support.

-

Average only on these nodes. If it is a scoping container, the label must correspond to the one of the fields containers.

-

If a fields container is set in this pin, it is used as the denominator of the fraction instead of elemental_nodal_To_nodal_fc.

-

Outputs

Configurations

Scripting

result: recombine cyclic harmonic indices

Description

Add the fields corresponding to different load steps with the same frequencies to compute the response.

+

Configurations

Scripting

result: recombine cyclic harmonic indices

Description

Add the fields corresponding to different load steps with the same frequencies to compute the response.

Inputs

Outputs

Configurations

Scripting

mapping: on coordinates

Description

Evaluates a result on specified coordinates (interpolates results inside elements with shape functions).

Inputs

if this pin is set to true, then, a support associated to the fields consisting of points is created

if this pin is set to true, then the mapping between the coordinates and the fields is created only on the first field scoping

@@ -8998,17 +8998,17 @@

Configurating operators

Average the Elemental Nodal result to the requested location.

Field/or fields container containing only the elastic strain field (element nodal).

Outputs

The computed result fields container (elemental nodal).

-

Configurations

Scripting

averaging: gauss to node (fields container)

Description

Extrapolates results available at Gauss or quadrature points to nodal points for a field container. The available elements are: Linear quadrangle, parabolic quadrangle, linear hexagonal, quadratic hexagonal, linear tetrahedral, and quadratic tetrahedral.

-

Inputs

The mesh region in this pin is used for extrapolating results available at Gauss or quadrature points to nodal points.

-

Extrapolating results on the selected scoping. If it is a scoping container, the label must correspond to the one of the fields containers.

-

Outputs

Configurations

Scripting

math: correlation

Description

Takes two fields and a weighting and computes their correlation: aMb/(||aMa||.||bMb||). If several b fields are provided (via a fields container), correlation is computed for each of them.

+

Configurations

Scripting

math: correlation

Description

Takes two fields and a weighting and computes their correlation: aMb/(||aMa||.||bMb||). If several b fields are provided (via a fields container), correlation is computed for each of them.

Inputs

Field a. The reference field.

Field b. If a fields container is provided, correlation is computed for each field.

Field M, optional weighting for correlation computation.

If true, correlation factor is ||aMb||/(||aMa||.||bMb||)

Outputs

Correlation factor for each input field b.

If several b are provided, this output contains the index of the highest correlation factor.

-

Configurations

Scripting

math: mac

Description

Computes MAC Matrix between two fields container, both for real and complex cases. For mixed cases (real-complex and complex) only the real part is considered. Providing inputs with the same component scoping is an user responsability.

+

Configurations

Scripting

averaging: gauss to node (fields container)

Description

Extrapolates results available at Gauss or quadrature points to nodal points for a field container. The available elements are: Linear quadrangle, parabolic quadrangle, linear hexagonal, quadratic hexagonal, linear tetrahedral, and quadratic tetrahedral.

+

Inputs

The mesh region in this pin is used for extrapolating results available at Gauss or quadrature points to nodal points.

+

Extrapolating results on the selected scoping. If it is a scoping container, the label must correspond to the one of the fields containers.

+

Outputs

Configurations

Scripting

math: mac

Description

Computes MAC Matrix between two fields container, both for real and complex cases. For mixed cases (real-complex and complex) only the real part is considered. Providing inputs with the same component scoping is an user responsability.

Inputs

Fields Container A.

Fields Container B.

Field M, optional weighting for MAC Matrix computation.

@@ -9274,9 +9274,10 @@

Configurating operators

Inputs

Outputs

Configurations

Scripting

math: window hamming (fields container)

Description

Apply hamming windowing on a given FieldsContainer having time label or a Field located on time. Assume that time sampling is evenly spaced (use time_freq_interpolation before otherwise).

Inputs

Outputs

Configurations

Scripting

math: window welch (fields container)

Description

Apply welch windowing on a given FieldsContainer having time label or a Field located on time. Assume that time sampling is evenly spaced (use time_freq_interpolation before otherwise).

Inputs

Outputs

Configurations

Scripting

math: window blackman (fields container)

Description

Apply blackman windowing on a given FieldsContainer having time label or a Field located on time. Assume that time sampling is evenly spaced (use time_freq_interpolation before otherwise).

-

Inputs

Outputs

Configurations

Scripting

math: expansion psd

Description

Computes the PSD response for one-sigma solution.

@@ -9494,7 +9495,14 @@

Configurating operators

Average the Elemental Nodal result to the requested location.

Field/or fields container containing only the elastic strain field (element nodal).

Outputs

The computed result fields container (elemental nodal).

-

Configurations

Scripting

compression: apply zfp

Description

Compressing input data using one of zfp compression algorithm modes.

+

Configurations

Scripting

result: compute stress Y

Description

Computes the stress from an elastic strain field. compute_total_strain limitations are applicable for stress computation Get the YY normal component (11 component).

+

Inputs

The element scoping on which the result is computed.

+

Needed to get mesh and material ids. Optional if a data_sources have been connected.

+

Needed to get mesh and material ids. Optional if a streams_container have been connected.

+

Average the Elemental Nodal result to the requested location.

+

Field/or fields container containing only the elastic strain field (element nodal).

+

Outputs

The computed result fields container (elemental nodal).

+

Configurations

Scripting

compression: apply zfp

Description

Compressing input data using one of zfp compression algorithm modes.

Inputs

field or fields container to be compressed

zfp mode: fixed-rate ('r'), fixed-precision ('p'), fixed-accuracy ('a')

mode-corresponding parameter: rate (double) / precision (int) / accuracy (double)

@@ -9505,14 +9513,7 @@

Configurating operators

Outputs

the output entity is a double, containing compression speed of the input data: for ElementalNodal location - [elements/sec], for Nodal location - [nodes/sec]

the output entity is a double, containing compression rate = initial/compressed

the output entity is a 'custom type field container'; each output field containing compressed results corresponding to one component data (ie. input vector field/fc contains 3 components will give 3 output fields), this is not the case when input pin3 is set to 3, all components will be compressed into one field.

-

Configurations

Scripting

result: compute stress Y

Description

Computes the stress from an elastic strain field. compute_total_strain limitations are applicable for stress computation Get the YY normal component (11 component).

-

Inputs

The element scoping on which the result is computed.

-

Needed to get mesh and material ids. Optional if a data_sources have been connected.

-

Needed to get mesh and material ids. Optional if a streams_container have been connected.

-

Average the Elemental Nodal result to the requested location.

-

Field/or fields container containing only the elastic strain field (element nodal).

-

Outputs

The computed result fields container (elemental nodal).

-

Configurations

Scripting

result: compute stress XZ

Description

Computes the stress from an elastic strain field. compute_total_strain limitations are applicable for stress computation Get the XZ shear component (02 component).

+

Configurations

Scripting

result: compute stress XZ

Description

Computes the stress from an elastic strain field. compute_total_strain limitations are applicable for stress computation Get the XZ shear component (02 component).

Inputs

The element scoping on which the result is computed.

Needed to get mesh and material ids. Optional if a data_sources have been connected.

Needed to get mesh and material ids. Optional if a streams_container have been connected.

diff --git a/src/ansys/dpf/core/operators/math/modal_superposition.py b/src/ansys/dpf/core/operators/math/modal_superposition.py index bc24c9565bb..b12ac713771 100644 --- a/src/ansys/dpf/core/operators/math/modal_superposition.py +++ b/src/ansys/dpf/core/operators/math/modal_superposition.py @@ -17,7 +17,7 @@ class modal_superposition(Operator): r"""Computes the solution in the time/frequency space from a modal solution - by multiplying a modal basis (in 0) by the solution in this modal space + by multiplying a modal basis (in 0)by the solution in this modal space (coefficients for each mode for each time/frequency) (in 1). @@ -27,6 +27,8 @@ class modal_superposition(Operator): One field by mode with each field representing a mode shape on nodes or elements. solution_in_modal_space: FieldsContainer One field by time/frequency with each field having a ponderating coefficient for each mode of the modal_basis pin. + incremental_fc: FieldsContainer, optional + If a non-empty fields container is introduced, it is modified, and sent to the output, to add the contribution of the requested expansion. The label spaces produced from the multiplication must be the same as the incremental ones. time_scoping: Scoping, optional Compute the result on a subset of the time frequency domain defined in the solution_in_modal_space fields container. mesh_scoping: Scoping or ScopingsContainer, optional @@ -48,6 +50,8 @@ class modal_superposition(Operator): >>> op.inputs.modal_basis.connect(my_modal_basis) >>> my_solution_in_modal_space = dpf.FieldsContainer() >>> op.inputs.solution_in_modal_space.connect(my_solution_in_modal_space) + >>> my_incremental_fc = dpf.FieldsContainer() + >>> op.inputs.incremental_fc.connect(my_incremental_fc) >>> my_time_scoping = dpf.Scoping() >>> op.inputs.time_scoping.connect(my_time_scoping) >>> my_mesh_scoping = dpf.Scoping() @@ -57,6 +61,7 @@ class modal_superposition(Operator): >>> op = dpf.operators.math.modal_superposition( ... modal_basis=my_modal_basis, ... solution_in_modal_space=my_solution_in_modal_space, + ... incremental_fc=my_incremental_fc, ... time_scoping=my_time_scoping, ... mesh_scoping=my_mesh_scoping, ... ) @@ -69,6 +74,7 @@ def __init__( self, modal_basis=None, solution_in_modal_space=None, + incremental_fc=None, time_scoping=None, mesh_scoping=None, config=None, @@ -83,6 +89,8 @@ def __init__( self.inputs.modal_basis.connect(modal_basis) if solution_in_modal_space is not None: self.inputs.solution_in_modal_space.connect(solution_in_modal_space) + if incremental_fc is not None: + self.inputs.incremental_fc.connect(incremental_fc) if time_scoping is not None: self.inputs.time_scoping.connect(time_scoping) if mesh_scoping is not None: @@ -91,7 +99,7 @@ def __init__( @staticmethod def _spec() -> Specification: description = r"""Computes the solution in the time/frequency space from a modal solution -by multiplying a modal basis (in 0) by the solution in this modal space +by multiplying a modal basis (in 0)by the solution in this modal space (coefficients for each mode for each time/frequency) (in 1). """ spec = Specification( @@ -109,6 +117,12 @@ def _spec() -> Specification: optional=False, document=r"""One field by time/frequency with each field having a ponderating coefficient for each mode of the modal_basis pin.""", ), + 2: PinSpecification( + name="incremental_fc", + type_names=["fields_container"], + optional=True, + document=r"""If a non-empty fields container is introduced, it is modified, and sent to the output, to add the contribution of the requested expansion. The label spaces produced from the multiplication must be the same as the incremental ones.""", + ), 3: PinSpecification( name="time_scoping", type_names=["scoping", "vector"], @@ -191,6 +205,8 @@ class InputsModalSuperposition(_Inputs): >>> op.inputs.modal_basis.connect(my_modal_basis) >>> my_solution_in_modal_space = dpf.FieldsContainer() >>> op.inputs.solution_in_modal_space.connect(my_solution_in_modal_space) + >>> my_incremental_fc = dpf.FieldsContainer() + >>> op.inputs.incremental_fc.connect(my_incremental_fc) >>> my_time_scoping = dpf.Scoping() >>> op.inputs.time_scoping.connect(my_time_scoping) >>> my_mesh_scoping = dpf.Scoping() @@ -205,6 +221,10 @@ def __init__(self, op: Operator): modal_superposition._spec().input_pin(1), 1, op, -1 ) self._inputs.append(self._solution_in_modal_space) + self._incremental_fc = Input( + modal_superposition._spec().input_pin(2), 2, op, -1 + ) + self._inputs.append(self._incremental_fc) self._time_scoping = Input(modal_superposition._spec().input_pin(3), 3, op, -1) self._inputs.append(self._time_scoping) self._mesh_scoping = Input(modal_superposition._spec().input_pin(4), 4, op, -1) @@ -252,6 +272,27 @@ def solution_in_modal_space(self) -> Input: """ return self._solution_in_modal_space + @property + def incremental_fc(self) -> Input: + r"""Allows to connect incremental_fc input to the operator. + + If a non-empty fields container is introduced, it is modified, and sent to the output, to add the contribution of the requested expansion. The label spaces produced from the multiplication must be the same as the incremental ones. + + Returns + ------- + input: + An Input instance for this pin. + + Examples + -------- + >>> from ansys.dpf import core as dpf + >>> op = dpf.operators.math.modal_superposition() + >>> op.inputs.incremental_fc.connect(my_incremental_fc) + >>> # or + >>> op.inputs.incremental_fc(my_incremental_fc) + """ + return self._incremental_fc + @property def time_scoping(self) -> Input: r"""Allows to connect time_scoping input to the operator. diff --git a/src/ansys/dpf/gatebin/Ans.Dpf.GrpcClient.dll b/src/ansys/dpf/gatebin/Ans.Dpf.GrpcClient.dll index 0946d81a643..c5253396dad 100644 Binary files a/src/ansys/dpf/gatebin/Ans.Dpf.GrpcClient.dll and b/src/ansys/dpf/gatebin/Ans.Dpf.GrpcClient.dll differ diff --git a/src/ansys/dpf/gatebin/DPFClientAPI.dll b/src/ansys/dpf/gatebin/DPFClientAPI.dll index 75343603726..94b25b96214 100644 Binary files a/src/ansys/dpf/gatebin/DPFClientAPI.dll and b/src/ansys/dpf/gatebin/DPFClientAPI.dll differ diff --git a/src/ansys/dpf/gatebin/libAns.Dpf.GrpcClient.so b/src/ansys/dpf/gatebin/libAns.Dpf.GrpcClient.so index 381c3cefc45..c514d248db7 100644 Binary files a/src/ansys/dpf/gatebin/libAns.Dpf.GrpcClient.so and b/src/ansys/dpf/gatebin/libAns.Dpf.GrpcClient.so differ diff --git a/src/ansys/dpf/gatebin/libDPFClientAPI.so b/src/ansys/dpf/gatebin/libDPFClientAPI.so index 5fa5a11641c..a4605e84680 100644 Binary files a/src/ansys/dpf/gatebin/libDPFClientAPI.so and b/src/ansys/dpf/gatebin/libDPFClientAPI.so differ