PGD Importer (Addin)

The PGD Importer addin is a tool for SimulationX that allows you to integrate parametric solutions from the results of a three-dimensional FEM or CFD simulation into your SimulationX model. The addin makes use of ESI's proprietary PGD (Proper Generalized Decomposition) technology with the accompanying file format EPGD2. Importing PGDs as SimulationX blocks enriches your system model with the results of detailed 3D simulations of flexible bodies or complex flow structures. When you import the PGD as a SimulationX block, it is necessary to know some key information about the original 3D model, such as interface mesh node IDs, to generate the correct interface connectors. If this information is not known beforehand, ESI's Visual-Viewer or the ESI-Player visualization tools can be used to explore the 3D model in detail.

In order to use the PGD importer addin, you need to install and activate the SXADDIN file through the Maintenance and Add-Ins section in the program options. You can download the addin from the myESI customer portal.

Figure 1: PGD Importer pane

Worflow

Before you start the import process, first ensure the PGD Importer addin is visible in SimulationX. If it is not, click on Add-Ins in the Panels section on the View tab of the ribbon menu and select PGD Importer. Once the addin is up and running, you can import a PGD block into your SimulationX model as follows:

  1. In the PGD Importer pane, click on the Browse button and select a PGD file. Once the file is loaded, the Inputs and Outputs panels show the input and output quantities stored in the PGD file.

  2. The Inputs panel displays the name of each parameter as well as its minimum, maximum and nominal values. The Outputs pane includes a column where you can enter a list of 3D mesh node IDs for each output connector you want to generate.

  3. Choose the parameters for which you would like to generate input connectors by selecting the checkbox to the left of the parameter name.

  4. Choose the outputs for which you would like to generate output connectors by selecting the checkbox to the left of the parameter name and enter a (comma-separated) list of valid mesh node IDs for each selected entry.

  5. If the connectors should be generated as Modelica connectors rather than SimulationX signal connectors, also select the checkbox Use Modelica connectors.

  6. Enter a valid Modelica block identifier for the new PGD type in the Block ident textbox.

  7. Click on the Generate PGD block button.

Once the import is complete, a new block type with the specified block identifier and an instance of this type are added to the current user model. This block contains an input connector for each chosen PGD parameter and an output connector for each combination of PGD outputs and node IDs. Input connector names match the corresponding PGD parameters. Output connector names are shown in the form Result_nodeID. If, for example, the Coordinate result was chosen for the node IDs 100, 101 and 203, the three corresponding output connectors are Coordinate_100, Coordinate_101" and Coordinate_203. The resulting PGD blocks can be used in the current SimulationX model. Make sure that input values for the PGD input connectors stay within the corresponding minimum/maximum listed in the Inputs pane. If during a transient simulation any of the inputs exceed the corresponding PGD input maximum or drop below the corresponding PGD input minimum, an assertion will be triggered and the simulation will terminate with an error message.

Limitations:

  • You need to have the desired interface mesh node IDs of the 3D model. It is not possible currently to obtain a list of node IDs stored in the model.
  • SimulationX models with PGD blocks exported as FMUs can only run on machines without the PGD Importer addin installed.
  • During a simulation, the PGD Importer uses the final simulation state of a PGD solution. Therefore, only steady-state simulation results are currently supported.

Example

  1. ESI's Visual-Viewer shows a 3D visualization of a PGD solution represening a bending beam. The z-displacement field of the beam is shown for a given value of the applied force vector (x-, y- and z-components). The two highlighted nodes (455 and 100003) will be used as interface nodes for the import into the SimulationX model.

  2. Now load the same model in the PGD Importer.

  3. The PGD Importer shows the inputs fx, fy and fz and outputs Coordinate and Displacement.

  4. All three inputs and the Displacement output for nodes 455 and 100003 are selected.

  5. A PGD block bendingBeam_S002 is generated in the SimulationX model to which different time-varying inputs are connected.

  6. A simulation from t=0s to t=1s yields a linear response in the displacement of the interface nodes with higher values observed for the node on the free end of the bending beam (node 100003).