## On this page # result:compute invariant terms motion Last update: 31.07.2026 **Version: 0.0.0** ## Description Set the required data for the invariant terms computation (reduced matrices, lumped mass matrix, modes ...) ## Inputs This table lists the input pins for this operator. Input pins define the data that the operator requires to perform its operation. Some inputs are required, while others are optional and provide additional configuration. Each parameter is detailed in the sections that follow the table. Pin numberNameStatusExpected type(s)0[rom\_matrices](#input_0)Required[`fields_container`](../../core-concepts/dpf-types.md#fields-container)**1**[mode\_shapes](#input_1)Required[`fields_container`](../../core-concepts/dpf-types.md#fields-container)**2**[lumped\_mass](#input_2)Required[`fields_container`](../../core-concepts/dpf-types.md#fields-container)**3**[model\_data](#input_3)Required[`fields_container`](../../core-concepts/dpf-types.md#fields-container)**4**[field\_coordinates](#input_4)Required[`field`](../../core-concepts/dpf-types.md#field)**5**[nod](#input_5)Required[`vector`](../../core-concepts/dpf-types.md#standard-types)**6**[phi\_ortho](#input_6)[`fields_container`](../../core-concepts/dpf-types.md#fields-container) ### rom\_matrices (Pin 0) - **Required:** Yes - **Expected type(s):** [`fields_container`](../../core-concepts/dpf-types.md#fields-container) FieldsContainers containing the reduced matrices ### mode\_shapes (Pin 1) - **Required:** Yes - **Expected type(s):** [`fields_container`](../../core-concepts/dpf-types.md#fields-container) FieldsContainers containing the mode shapes, which are CST and NOR for the cms method ### lumped\_mass (Pin 2) - **Required:** Yes - **Expected type(s):** [`fields_container`](../../core-concepts/dpf-types.md#fields-container) FieldsContainers containing the lumped mass ### model\_data (Pin 3) - **Required:** Yes - **Expected type(s):** [`fields_container`](../../core-concepts/dpf-types.md#fields-container) data describing the finite element model ### field\_coordinates (Pin 4) - **Required:** Yes - **Expected type(s):** [`field`](../../core-concepts/dpf-types.md#field) coordinates of all nodes ### nod (Pin 5) - **Required:** Yes - **Expected type(s):** [`vector`](../../core-concepts/dpf-types.md#standard-types) ### phi\_ortho (Pin 6) - **Required:** No - **Expected type(s):** [`fields_container`](../../core-concepts/dpf-types.md#fields-container) Orthonormalizated modes transformation ## Outputs This table lists the output pins for this operator. Output pins provide the results of the operator's computation and can be connected to inputs of other operators or retrieved for further processing. Each output is detailed in the sections that follow the table. Pin numberNameExpected type(s)0[model\_data](#output_0)[`property_field`](../../core-concepts/dpf-types.md#property-field)**1**[mode\_shapes](#output_1)[`fields_container`](../../core-concepts/dpf-types.md#fields-container)**2**[lumped\_mass](#output_2)[`fields_container`](../../core-concepts/dpf-types.md#fields-container)**3**[field\_coordinates\_and\_euler\_angles](#output_3)[`fields_container`](../../core-concepts/dpf-types.md#fields-container)**4**[nod](#output_4)[`vector`](../../core-concepts/dpf-types.md#standard-types)**5**[used\_node\_index](#output_5)[`vector`](../../core-concepts/dpf-types.md#standard-types)**6**[eigenvalue](#output_6)[`vector`](../../core-concepts/dpf-types.md#standard-types)**7**[translational\_mode\_shape](#output_7)[`vector`](../../core-concepts/dpf-types.md#standard-types)**8**[rotational\_mode\_shape](#output_8)[`vector`](../../core-concepts/dpf-types.md#standard-types)**9**[invrt\_1](#output_9)[`double`](../../core-concepts/dpf-types.md#standard-types)**10**[invrt\_2](#output_10)[`vector`](../../core-concepts/dpf-types.md#standard-types)**11**[invrt\_3](#output_11)[`vector`](../../core-concepts/dpf-types.md#standard-types)**12**[invrt\_4](#output_12)[`vector`](../../core-concepts/dpf-types.md#standard-types)**13**[invrt\_5](#output_13)[`vector`](../../core-concepts/dpf-types.md#standard-types)**14**[invrt\_6](#output_14)[`vector`](../../core-concepts/dpf-types.md#standard-types)**15**[invrt\_7](#output_15)[`vector`](../../core-concepts/dpf-types.md#standard-types)**16**[invrt\_8](#output_16)[`vector`](../../core-concepts/dpf-types.md#standard-types) ### model\_data (Pin 0) - **Expected type(s):** [`property_field`](../../core-concepts/dpf-types.md#property-field) data describing the finite element model ### mode\_shapes (Pin 1) - **Expected type(s):** [`fields_container`](../../core-concepts/dpf-types.md#fields-container) FieldsContainers containing the mode shapes, which are CST and NOR for the cms method ### lumped\_mass (Pin 2) - **Expected type(s):** [`fields_container`](../../core-concepts/dpf-types.md#fields-container) FieldsContainers containing the lumped mass ### field\_coordinates\_and\_euler\_angles (Pin 3) - **Expected type(s):** [`fields_container`](../../core-concepts/dpf-types.md#fields-container) coordinates and euler angles of all nodes ### nod (Pin 4) - **Expected type(s):** [`vector`](../../core-concepts/dpf-types.md#standard-types) ### used\_node\_index (Pin 5) - **Expected type(s):** [`vector`](../../core-concepts/dpf-types.md#standard-types) ### eigenvalue (Pin 6) - **Expected type(s):** [`vector`](../../core-concepts/dpf-types.md#standard-types) ### translational\_mode\_shape (Pin 7) - **Expected type(s):** [`vector`](../../core-concepts/dpf-types.md#standard-types) ### rotational\_mode\_shape (Pin 8) - **Expected type(s):** [`vector`](../../core-concepts/dpf-types.md#standard-types) ### invrt\_1 (Pin 9) - **Expected type(s):** [`double`](../../core-concepts/dpf-types.md#standard-types) ### invrt\_2 (Pin 10) - **Expected type(s):** [`vector`](../../core-concepts/dpf-types.md#standard-types) ### invrt\_3 (Pin 11) - **Expected type(s):** [`vector`](../../core-concepts/dpf-types.md#standard-types) ### invrt\_4 (Pin 12) - **Expected type(s):** [`vector`](../../core-concepts/dpf-types.md#standard-types) ### invrt\_5 (Pin 13) - **Expected type(s):** [`vector`](../../core-concepts/dpf-types.md#standard-types) ### invrt\_6 (Pin 14) - **Expected type(s):** [`vector`](../../core-concepts/dpf-types.md#standard-types) ### invrt\_7 (Pin 15) - **Expected type(s):** [`vector`](../../core-concepts/dpf-types.md#standard-types) ### invrt\_8 (Pin 16) - **Expected type(s):** [`vector`](../../core-concepts/dpf-types.md#standard-types) ## Configurations This operator supports [configuration options](../../core-concepts/operator-configurations.md) that modify its behavior. ### [mutex](../../core-concepts/operator-configurations.md#mutex) - **Expected type(s):** [`bool`](../../core-concepts/dpf-types.md#standard-types) - **Default value:** false If this option is set to true, the shared memory is prevented from being simultaneously accessed by multiple threads. ## Scripting This operator can be accessed through scripting interfaces using these identifiers. **Category**: result **Plugin**: core **Scripting name**: compute\_invariant\_terms\_motion **Full name**: result.compute\_invariant\_terms\_motion **Internal name**: compute\_invariant\_terms\_motion **License**: None ## Examples These examples demonstrate how to use this operator in different programming environments. Each example shows how to instantiate the operator, connect the required inputs, and retrieve the output. C++```cpp #include "dpf_api.h" ansys::dpf::Operator op("compute_invariant_terms_motion"); // operator instantiation op.connect(0, my_rom_matrices); op.connect(1, my_mode_shapes); op.connect(2, my_lumped_mass); op.connect(3, my_model_data); op.connect(4, my_field_coordinates); op.connect(5, my_nod); op.connect(6, my_phi_ortho); ansys::dpf::PropertyField my_model_data = op.getOutput(0); ansys::dpf::FieldsContainer my_mode_shapes = op.getOutput(1); ansys::dpf::FieldsContainer my_lumped_mass = op.getOutput(2); ansys::dpf::FieldsContainer my_field_coordinates_and_euler_angles = op.getOutput(3); std::vector my_nod = op.getOutput>(4); std::vector my_used_node_index = op.getOutput>(5); std::vector my_eigenvalue = op.getOutput>(6); std::vector my_translational_mode_shape = op.getOutput>(7); std::vector my_rotational_mode_shape = op.getOutput>(8); double my_invrt_1 = op.getOutput(9); std::vector my_invrt_2 = op.getOutput>(10); std::vector my_invrt_3 = op.getOutput>(11); std::vector my_invrt_4 = op.getOutput>(12); std::vector my_invrt_5 = op.getOutput>(13); std::vector my_invrt_6 = op.getOutput>(14); std::vector my_invrt_7 = op.getOutput>(15); std::vector my_invrt_8 = op.getOutput>(16); ``` CPython```python import ansys.dpf.core as dpf op = dpf.operators.result.compute_invariant_terms_motion() # operator instantiation op.inputs.rom_matrices.connect(my_rom_matrices) op.inputs.mode_shapes.connect(my_mode_shapes) op.inputs.lumped_mass.connect(my_lumped_mass) op.inputs.model_data.connect(my_model_data) op.inputs.field_coordinates.connect(my_field_coordinates) op.inputs.nod.connect(my_nod) op.inputs.phi_ortho.connect(my_phi_ortho) my_model_data = op.outputs.model_data() my_mode_shapes = op.outputs.mode_shapes() my_lumped_mass = op.outputs.lumped_mass() my_field_coordinates_and_euler_angles = op.outputs.field_coordinates_and_euler_angles() my_nod = op.outputs.nod() my_used_node_index = op.outputs.used_node_index() my_eigenvalue = op.outputs.eigenvalue() my_translational_mode_shape = op.outputs.translational_mode_shape() my_rotational_mode_shape = op.outputs.rotational_mode_shape() my_invrt_1 = op.outputs.invrt_1() my_invrt_2 = op.outputs.invrt_2() my_invrt_3 = op.outputs.invrt_3() my_invrt_4 = op.outputs.invrt_4() my_invrt_5 = op.outputs.invrt_5() my_invrt_6 = op.outputs.invrt_6() my_invrt_7 = op.outputs.invrt_7() my_invrt_8 = op.outputs.invrt_8() ``` IPython```python import mech_dpf import Ans.DataProcessing as dpf op = dpf.operators.result.compute_invariant_terms_motion() # operator instantiation op.inputs.rom_matrices.Connect(my_rom_matrices) op.inputs.mode_shapes.Connect(my_mode_shapes) op.inputs.lumped_mass.Connect(my_lumped_mass) op.inputs.model_data.Connect(my_model_data) op.inputs.field_coordinates.Connect(my_field_coordinates) op.inputs.nod.Connect(my_nod) op.inputs.phi_ortho.Connect(my_phi_ortho) my_model_data = op.outputs.model_data.GetData() my_mode_shapes = op.outputs.mode_shapes.GetData() my_lumped_mass = op.outputs.lumped_mass.GetData() my_field_coordinates_and_euler_angles = op.outputs.field_coordinates_and_euler_angles.GetData() my_nod = op.outputs.nod.GetData() my_used_node_index = op.outputs.used_node_index.GetData() my_eigenvalue = op.outputs.eigenvalue.GetData() my_translational_mode_shape = op.outputs.translational_mode_shape.GetData() my_rotational_mode_shape = op.outputs.rotational_mode_shape.GetData() my_invrt_1 = op.outputs.invrt_1.GetData() my_invrt_2 = op.outputs.invrt_2.GetData() my_invrt_3 = op.outputs.invrt_3.GetData() my_invrt_4 = op.outputs.invrt_4.GetData() my_invrt_5 = op.outputs.invrt_5.GetData() my_invrt_6 = op.outputs.invrt_6.GetData() my_invrt_7 = op.outputs.invrt_7.GetData() my_invrt_8 = op.outputs.invrt_8.GetData() ``` ## Changelog - Version 0.0.0: Initial release.