Objects reference¶

This reference provides a specification for the objects in the tree.

Answers¶

The Answers object customizes the solution properties and contains all result-level objects. The Properties View of the Answers object is shown in Figure below.

Tree dependencies¶

• Valid Parent Tree Object: FEM Project.
• Valid Child Tree Objects: Results.

Insertion options¶

Appears by default when you create a new FEM project.

Object properties¶

The Properties View for this object include the following:

Body conditions¶

Body condition type objects enable you to impose the body condition onto the geometry bodies.

Application objects¶

Body Force, Acceleration, Earth Gravity, Rotational Velocity

Tree dependencies¶

• Valid Parent Tree Object: Study.
• Valid Child Tree Objects: None.

Insertion options¶

You can use any of the following methods to insert body conditions:

• Click the item from the standard Toolbar.
• Click the item from the Menu.
• Right click on the Study level objects, and choose the target object from the pop-up context menu.

Object properties¶

The properties may vary for different body conditions. See the Setting Up Boundary Conditions section for more information about body conditions.

Boundary conditions¶

Boundary condition type objects enable you to impose the boundary condition onto the geometry entities, such as faces, edges, and vertices.

Application objects¶

Displacement, Fixed Support, Fixed Rotation, Pressure, Force, Velocity, Acceleration, Temperature, Heat Flux, Convection, Radiation, Voltage, Ground, Symmetry, Zero Charge, Surface Charge Density, Electric Displacement, Insulating, Magnetic Potential, Magnetic Flux Density

Tree dependencies¶

• Valid Parent Tree Object: Study.
• Valid Child Tree Objects: None.

Insertion options¶

You can use any of the following methods to insert boundary condition:

• Click the item from the standard Toolbar.
• Click the item from the Menu.
• Right click on the Study level objects, and choose the target object from the pop-up context menu.

Object properties¶

The properties may vary for different body conditions. See the Setting up Boundary Conditions section for more information about Boundary Conditions.

Box¶

The Box object defines a shape that is generated by the built-in modeler. An example of Box object and properties are illustrated in Figure below.

Tree dependencies¶

• Valid Parent Tree Object: Geometry Group.
• Valid Child Tree Objects: None.

Insertion options¶

Appears when you create a box shape. You can use any of the following methods to insert a Box:

• Click the Add Box item from the standard Toolbar.
• Click the Add Box item from the Geometry Menu.
• Right click on the Geometry level objects, and choose the Add Box from the pop-up context menu.

Object properties¶

The Properties View for this object include the following:

Connections¶

The Connections object is a group-type object that may contain the connection objects between two or more parts. The currently supported children object types are Contact Pair.

Tree dependencies¶

• Valid Parent Tree Object: FEM Project.
• Valid Child Tree Objects: Contact Pair.

Insertion options¶

Connections object is automatically inserted as you add a contact pair object to the tree.

Object properties¶

The Properties View for this object include the following:

Contact pair¶

This object defines a contact pair between parts.

Tree dependencies¶

• Valid Parent Tree Object: Connections.
• Valid Child Tree Objects: None.

Insertion options¶

You can use any of the following methods to insert contact pairs:

• Click the item from the standard Toolbar.
• Click the item from the FEM Menu.
• Right click on the Connections level objects, and select Add Contact command from the pop-up context menu.

Object properties¶

The Properties View for this object include the following:

Cylinder¶

The Cylinder object defines a shape that is generated by the built-in modeler. An example of Cylinder object and properties are illustrated in Figure below.

Tree dependencies¶

• Valid Parent Tree Object: Geometry Group.
• Valid Child Tree Objects: None.

Insertion options¶

Appears when you create a Cylinder shape. You can use any of the following methods to insert a Cylinder:

• Click the Add Cylinder item from the standard Toolbar.
• Click the Add Cylinder item from the Geometry Menu.
• Right click on the Geometry level objects, and choose the Add Cylinder from the pop-up context menu.

Object properties¶

The Properties View for this object include the following:

FEM project¶

The FEM Project object represents an independent analysis, which contains Geometry, Mesh, Study, and Answers objects. The Connections object is not created until you add a contact pair object. An example of FEM Project and properties are illustrated in Figure [fig:ch3_guide_obj_fem_proj].

Tree dependencies¶

• Valid Parent Tree Object: Solution.
• Valid Child Tree Objects: Geometry Group, Mesh Group, Connections, Study, Answers.

Insertion options¶

Appears by default when you create a new FEM project.

Object properties¶

The Properties View for this object include the following:

Geometry group¶

Geometry Group object contains the geometries in the form of a part or assembly. All imported and created geometries are included in this group-level object as shown in Figure below.

Tree dependencies¶

• Valid Parent Tree Object: FEM Project.
• Valid Child Tree Objects: Part, Box, Cylinder, Plane, Line.

Insertion options¶

Appears by default when you create a new FEM project.

Object properties¶

The Properties View for this object include the following:

Initial temperature¶

Initial Temperature defines the temperature status at the beginning of the simulation for transient thermal analysis. An example of Initial Temperature and its properties are shown in Figure below.

Tree dependencies¶

• Valid Parent Tree Object: Study.
• Valid Child Tree Objects: None.

Insertion options¶

You can use any of the following methods to insert initial temperature:

• Click the item from the standard Toolbar.
• Click the item from the FEM Menu.
• Right click on the Study level objects, and choose Insert Conditions... > Initial Temperature command from the pop-up context menu.

Object properties¶

The Properties View for this object include the following:

Line¶

The Line object defines a shape that is generated by the built-in modeler. An example of Line object and properties are illustrated in Figure below.

Tree dependencies¶

• Valid Parent Tree Object: Geometry Group.
• Valid Child Tree Objects: None.

Insertion options¶

Appears when you create a line shape. You can use any of the following methods to insert a Line:

• Click the Add Line item from the standard Toolbar.
• Click the Add Line item from the Geometry Menu.
• Right click on the Geometry level objects, and choose the Add Line from the pop-up context menu.

Object properties¶

The Properties View for this object include the following:

Material¶

A Material object defines a material data using the associated properties and spreadsheet data. You can define multiple material objects in the WELSIM application. An example of a Material object and its properties and spreadsheet are shown in Figure below.

Tree dependencies¶

• Valid Parent Tree Object: Material Project.
• Valid Child Tree Objects: None.

Insertion options¶

You can use any of the following methods to insert material:

• Click the Add Material item from the standard Toolbar.
• Click the Add Material item from the Material Menu.
• Right click on the Material level objects, and choose Add Material command from the pop-up context menu.

Object properties¶

The Properties View for this object include the following:

Spreadsheet¶

The Material object is able to display the Spreadsheet window, which provides a friendly user interface for defining all material properties as shown in Figure below. You can double click or right click on the Material object and select the Edit command to display the spreadsheet window.

Material project¶

The Material Project object holds all material definition objects.

Tree dependencies¶

• Valid Parent Tree Object: Solution.
• Valid Child Tree Objects: Material.

Insertion options¶

Appears by default when you create a new FEM project.

Object properties¶

The Properties View for this object include the following:

Mesh group¶

Mesh Group manages all meshing features and tools for the project. An example of mesh object and properties is shown in Figure below.

Tree dependencies¶

• Valid Parent Tree Object: FEM Project.
• Valid Child Tree Objects: Mesh Settings, Mesh Method.

Insertion options¶

Appears by default when you create a new FEM project.

Object properties¶

The Properties View for this object include the following:

Mesh method¶

In the multi-body analysis, different parts may need different mesh density due to the various sizes of geometries. Mesh Method object helps you fine tuning the mesh for the specifically scoped geometries. An example of Mesh Method object is shown in Figure below.

Tree dependencies¶

• Valid Parent Tree Object: Mesh Group.
• Valid Child Tree Objects: None.

Insertion options¶

You can use any of the following methods to insert Mesh Method:

• Click the item from the standard Toolbar.
• Click the item from the FEM Menu.
• Right click on the Mesh level objects, and choose Add Mesh Method command from the pop-up context menu.

Object properties¶

The Properties View for this object include the following:

Mesh settings¶

The Mesh Settings object is a global setting for the meshing operations. You change the global mesh settings by tuning the properties of this object. An example of Mesh Settings object is shown in Figure [fig:ch3_guide_obj_mesh_settings].

Tree dependencies¶

• Valid Parent Tree Object: Mesh Group.
• Valid Child Tree Objects: None.

Insertion options¶

Appears by default when you create a new FEM project.

Object properties¶

The Properties View for this object include the following:

Part¶

The Part object defines a component of the geometry that is imported from an external CAD file. An example of Part object and properties are illustrated in Figure [fig:ch3_guide_obj_part].

Tree dependencies¶

• Valid Parent Tree Object: Geometry Group.
• Valid Child Tree Objects: None.

Insertion options¶

Appears when you import geometry from external files. You can use any of the following methods to insert Part:

• Click the item from the standard Toolbar.
• Click the Import item from the Menu.
• Right click on the Geometry level objects, and choose the Insert... from the pop-up context menu.

Object properties¶

The Properties View for this object include the following:

Plate¶

The Plate object defines a shape that is generated by the built-in modeler. An example of Plate object and properties are illustrated in Figure [fig:ch3_guide_obj_part].

Tree dependencies¶

• Valid Parent Tree Object: Geometry Group.
• Valid Child Tree Objects: None.

Insertion options¶

Appears when you create a plate shape. You can use any of the following methods to insert a Plate:

• Click the Add Plate item from the standard Toolbar.
• Click the Add Plate item from the Geometry Menu.
• Right click on on the Geometry level objects, and choose the Add Plate from the pop-up context menu.

Object properties¶

The Properties View for this object include the following:

Results¶

The Result objects define the simulation output for displaying and analyzing the results from a solution.

Application objects¶

Deformation, Stress, Strain, Acceleration, Velocity, Rotation, Reaction Force, Reaction Moment, Temperature, Voltage, Electric Field, Electric Displacement, Electromagnetic Energy Density, Magnetic Potential, Magnetic Flux Density, Magnetic Field, User-Defined Result.

Tree dependencies¶

• Valid Parent Tree Object: Answers.
• Valid Child Tree Objects: None.

Insertion options¶

Appears by default when you start the WELSIM application.

Object properties¶

The properties may vary for different result types. The following lists the properties that may be shown for the most of Result objects. See the Using results section for more information.

Solution¶

The Solution object acts as a root object in the WELSIM application. Only one Solution can exist per simulation session, and one solution can contain multiple FEM projects.

Tree dependencies¶

• Valid Parent Tree Object: None - highest level in the tree.
• Valid Child Tree Objects: FEM Project.

Insertion options¶

Appears by default when you create a new FEM project.

Study¶

The Study object holds all analysis related objects such as Study Settings, Boundary Conditions, Body Conditions, and Initial Conditions. An example of Study object is shown in Figure [fig:ch3_guide_obj_study].

Tree dependencies¶

• Valid Parent Tree Object: FEM Project.
• Valid Child Tree Objects: Boundary Conditions, Body Conditions, Initial Temperature.

Insertion options¶

Appears by default when you create a new FEM project.

Object properties¶

The Properties View for this object include the following:

Study Settings¶

The Study Settings object allows you to define analysis and solving settings to customize a specific simulation model. An example of Study Settings object is shown in Figure [fig:ch3_guide_obj_study_settings].

Tree dependencies¶

• Valid Parent Tree Object: Study.
• Valid Child Tree Objects: None.

Insertion options¶

Appears by default when you create a new FEM project.

Object properties¶

The properties of Study Settings vary for different Physics and Analysis types. The following lists the available properties according to Analysis Type:

• Static Structural and Thermal: Current Step (Read-Only), Number of SubSteps, Relative Tolerance, Absolute Tolerance, Maximum Iterations.
• Transient Structural and Thermal: Current Step (Read-Only), Auto-Timing, Number of SubSteps, Time Incremental (Shown as Auto Timing is False), Relative Tolerance, Absolute Tolerance, Maximum Iterations.
• Modal Structural: Number of Modes, Lancos Tolerance, Lancos Iterations.
• ElectroStatic and MagnetoStatic: Current Step (Read-Only), Relative Tolerance, Absolute Tolerance, Maximum Iterations.

Spreadsheet¶

The Study Settings object can display the Spreadsheet window, which provides a friendly user interface to review properties at all steps as shown in Figure [fig:ch3_guide_obj_study_settings]. You can double click or right click on the Study Settings object and select the Edit command to display the Spreadsheet window.