Layout state data references

Layout state data references

Every layout state contains a list of references that point to the data objects in the layout. The references are called data references. The software uses the data references to determine from where to retrieve the viewport data. An ID identifies each data reference. The viewport description uses these IDs to indicate which data reference is being used. The data references are not shared between layout states. When you save a new layout state, a new data reference is added, which means that you can use the same data as a reference several times with different IDs.

For example, the data reference format for a plot in a post view is:

<DataReferenceList>      <Datareference DatareferenceId="1" DatareferenceType="Reference Result">      <!--Solution | Result reference neutral name-->      <![CDATA[VibroAcousticResponse:IBEM vibro-acoustics|VibroAcoustic]]>

In this example, the data reference is for the user selection of the iterations to animate.

 <Datareference DatareferenceId="1" DatareferenceType="User Selection" DatareferenceVersion="0"><!--Selection--> <![CDATA[selectionVariable(Frequency)=1.0000000000000000e+02;selectionVariable(RPM)=1.0000000000000000e+03;selectionVariable(Subcase)=Subcase 1;selectionVariable(*Dependent\:Data*)=Displacement;selectionVariable(Component)=Magnitude;iterationVariable(Frequency)=1.0000000000000000e+02:2.0000000000000000e+02:3.0000000000000000e+02;iterationVariable(RPM)=1.0000000000000000e+03:3.0000000000000000e+03]]> </Datareference>

A data reference uses a combination of strings and pointers to indicate the data. For example, if an XY plot is shown with data from a field, pointers refer to the field and the variables, and strings describe the constant values. The information leads to a set of (X,Y) points.

Each type has its own set of attributes:

• String String value

• Object Reference to the object stored in a partReferencing object type informationIdentification information (necessary to resolve the references when the reference to the object stored in a part is missing.)

When you import a layout state from an external file, either a layout (.lsx) or session (.rsfx) file, the data references are created from the labels in the file. If all the objects referenced in the data reference list are present in the destination document, the data references are created automatically; otherwise, you are prompted to select the missing objects. The imported results are persisted with the file path and not as a reference to the object.

A string is used for the following data references:

• Imported Result file

• Associated AFU file

• User AFU file

• Sort 2 OP2 file

An object is used for the following data references:

• Solution

• Data source

• Field Independent variable

• Dependent variable

• Boundary conditions

• Coordinate System

• Result Probe

• Pre-processing Mesh collector

• Pre-processing Node

• Pre-processing Element

• Pre-processing Element face

Post-processing scenarios and layout states

Overlay support

Layout states store a stack of scenarios per viewport. Each scenario in the stack has its own set of data sources and parameters. A layout contains only one display, which can contain viewports within viewports.

Layout states also store:

• Index of each scenario in the stack of scenarios.

• Whether the selection lock is enabled or disabled.

Z-axis labeling

Layout states store the extended Z-axis labeling information for the color bars, including:

• The name for each plot

• The user's option:DefaultWhich chunks were selected and free text

How do I

Edit layout state data references

Look up more details

Data references in the Edit and Apply Layout State dialog box

Data references in the LSX file

Quick links

Command reference

Pre/Post video examples

Bulk Entry Descriptions

Simcenter 3D tutorials

Browse Simcenter 3D help by product area

Layout state data references, Simcenter 3D 2021.1 Series

© 2020 Siemens

window.mainLanguage="en_US"

window.delivId=""

window.projectId=""

MathJax.Hub.Config({ TeX: { extensions: ["autoload-all.js"] }, tex2jax: { displayMath: [ ] }, "SVG": { scale: 125 } });