GeometricStructuralICs Properties

(To be removed) Initial displacement and velocity over a region

GeometricStructuralICs will be removed. Use the CellIC, FaceIC, EdgeIC, and VertexIC properties of femodel instead. (since R2023a) For more information on updating your code, see Version History.

A GeometricStructuralICs object contains a description of the initial displacement and velocity over a geometric region for a transient structural model. A StructuralModel container has a vector of GeometricStructuralICs objects in its InitialConditions.StructuralICAssignments property.

To set initial conditions for your structural model, use the structuralIC function.

Properties

RegionType — Geometric region type

'Face' | 'Edge' | 'Vertex' | 'Cell' for a 3-D model

Geometric region type, specified as 'Face', 'Edge', or 'Vertex' for a 2-D model or 3-D model, or 'Cell' for a 3-D model.

Data Types: char | string

RegionID — Geometric region ID

vector of positive integers

Geometric region ID, specified as a vector of positive integers. Find the region IDs by using pdegplot.

Data Types: double

InitialDisplacement — Initial displacement

numeric vector | function handle

Initial displacement, specified as a numeric vector or function handle. For details, see structuralIC.

Data Types: double | function_handle

InitialVelocity — Initial velocity

numeric vector | function handle

Initial velocity, specified as a numeric vector or function handle. For details, see structuralIC.

Data Types: double | function_handle

Version History

Introduced in R2018a

R2025a: To be removed

GeometricStructuralICs will be removed. Use the CellIC, FaceIC, EdgeIC, and VertexIC properties of femodel instead.

For example, you can check the initial conditions for all faces as follows.

model = femodel(AnalysisType="structuralTransient", ...
                Geometry="Block.stl");
model.CellIC = cellIC(Displacement=[0;0;0],Velocity=[0;0;0]);
model.CellIC

The unified finite element model workflow defines the type of a problem and all of its parameters as the properties of an femodel object. This object enables you to specify physical parameters for structural, thermal, and electromagnetic types of analyses. The solver in the unified workflow uses only the parameters (properties) appropriate for the current analysis type while ignoring all other properties. If you switch the analysis type by setting the AnalysisType property of the model, the solver uses the appropriate set of properties corresponding to the new analysis type.

For more help migrating your existing code that uses StructuralModel to the unified finite element workflow, see Migration from Domain-Specific to Unified Workflow.