NodalStructuralICs Properties

(To be removed) Initial displacement and velocity at mesh nodes

NodalStructuralICs 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 NodalStructuralICs object contains a description of the initial displacement and velocity at mesh nodes. 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

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

NodalStructuralICs 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.