Property extraction

You can use the property extractor to define calculation parameters with values extracted from a variety of sources. When you use the property extractor to define a calculation parameter, the software creates an expression that associates the calculation parameter with the source of the extracted values. Thus, if you change the source from which you extracted the values, the software automatically updates the corresponding value for the calculation parameter in the margin of safety calculation.

• The calculation parameters can be lengths, thicknesses, material properties, and cross section properties.

• The extracted values can come from geometric entities, FE entities, materials, or beam cross sections.

You define the property extraction in the Property Extractor dialog box, which you can access from the following locations:

• Calculation Creation dialog box

• Calculation Editor dialog box

• Calculation Copy Editor dialog box

In the Property Extractor dialog box, you have the following options for extracting lengths:

• Total Length extracts the length of a polygon edge, 1D element, or 1D mesh. When the source contains multiple entities, the software sums the lengths of the polygon edges, 1D elements, or 1D meshes.

• Projected Length extracts a length from polygon faces, 2D elements, 2D meshes, or 2D collectors.

• Minimum Thickness extracts the minimum thickness from polygon faces, nodes, 2D elements, 2D meshes, or laminate physical properties.

• Maximum Thickness extracts the maximum thickness from polygon faces, nodes, 2D elements, 2D meshes, or laminate physical properties.

• Average Thickness extracts the average thickness from polygon faces, nodes, 2D elements, 2D meshes, or laminate physical properties.

You also have the following options for extracting additional properties to define a calculation:

• Material Property extracts the material properties from polygon edges, polygon faces, 1D elements, 2D elements, 1D meshes, 2D meshes, or materials.

• Beam Cross Section Property extracts cross sectional properties from polygon edges, 1D elements, 1D meshes, or beam cross sections.

The value that the software uses for the calculation parameter is displayed in the Extraction group of the Property Extractor dialog box.

If you use the property extractor to define a calculation parameter whose dimensionality does not match the dimensionality of that calculation, the software issues a dimension error warning message.

Averaging of thicknesses

When the source contains multiple polygon faces or 2D elements, the software computes the value for the calculation parameter as the arithmetic average of the thicknesses for each polygon face, 2D element, 2D mesh, or node in the selection. Thus, the average is not a weighted average.

Projecting lengths

When you select the Projected Length option, the software creates a default rectangular bounding box around the geometric extents of the source. You can extract the value for the length from the bounding box edge lengths. You can also reorient the bounding box. Because the reoriented bounding box must still enclose the extents of the source, the size of the bounding box changes. You can then extract the value for the length from the edge lengths of the reoriented bounding box.

For more information, see Extract a projected length.

Associativity between calculation parameters and the model

The software creates an expression that associates the calculation parameter and the geometric entities, FE entities, materials, or beam cross sections in the source. The formula for the expression has the following form:

ExtractProperty("Argument1","Argument2",{"Argument3","Argument4"})

where ExtractProperty is an expression lookup function that is only valid in a margin of safety solution process, Argument1 is the source name for the property extraction, and Argument2 is an argument that depends on the Extraction list setting. Argument3 and Argument4 are arguments that are only present when the Extraction list is set to Projected Length, Material Property, or Beam Cross Section Property.

The software supplies a default name for the source, which you can change.

For example, in the Property Extractor dialog box, when the Extraction list is set to Total Length and you type Edge Length in the Name box, the formula for the expression is as follows:

ExtractProperty("Edge Length","TOTAL_LENGTH",{})

The formula for the expression appears in the calculation dialog box for the parameter that you are defining with the property extractor. It also appears in the Expression dialog box.

Note:

After you add a source to the Sources table, the name of the source cannot be changed.

Where do I find it?

Application	Pre/Post
Prerequisite	An active margin of safety solutionCalculation Creation, Calculation Editor, or Calculation Copy Editor dialog box openA method that requires you to specify a length, thickness, material property, or cross sectional property
Location in dialog box	Inputs group→Inputs tab→ in the box of a valid parameter→Property Extractor

How do I

Create a margin of safety calculation

Import values from a spreadsheet

Extract the area from a beam cross section

Extract a projected length

Create a margin of safety calculation using an allowable method

Bolt shear method example

Column Euler method example

Nodal force report extraction example

Learn more

Margin of safety calculations

Parent/child behavior in margin of safety calculations

Extracting a single value from the set of results (margin of safety)

Manual load extraction

Nodal force report extraction

Extracting shell element plane stress components relative to a common CSYS

Beam cross section property extraction

Laminate extraction

Laminate property extraction

Sources manager (margin of safety)

Displaying result sources for margin of safety calculations

Look up more details

Methods for buckling of orthotropic laminates

Quick links

Command reference

Pre/Post video examples

Bulk Entry Descriptions

Simcenter 3D tutorials

Browse Simcenter 3D help by product area

Margin of Safety methods documentation

Property extraction, 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 } });