Main Content

vertexLoad

Load on geometry vertex

Since R2023a

Description

A vertexLoad object contains a description of a load on a vertex of a geometry. An femodel object contains an array of vertexLoad objects in its VertexLoad property.

Creation

Description

model.VertexLoad(VertexID) = vertexLoad(Force=Value) creates a vertexLoad object and sets its Force property using a name-value argument. This syntax assigns the specified concentrated force to the specified vertices of the geometry stored in the femodel object model. For example, model.VertexLoad([1 2]) = vertexLoad(Force=[0 1000 0]) specifies the concentrated force on vertices 1 and 2.

You can specify force for a static, transient, or frequency response structural analysis. A structural modal analysis cannot have concentrated force.

example

Input Arguments

expand all

Vertex IDs, specified as a vector of positive integers. Find the vertex IDs using pdegplot with the VertexLabels value set to "on".

Data Types: double

Properties

expand all

Concentrated force at a vertex, specified as a vector or function handle. Use a function handle to specify concentrated force that depends on time or frequency. For details, see Nonconstant Parameters of Finite Element Model.

Data Types: double | function_handle

Examples

collapse all

Specify a force value at a vertex for an femodel object representing a static structural problem.

Create and plot a rectangular geometry.

gm = decsg([3 4 0.05 0.2 0.2 0.05 -0.025 -0.025 0.025 0.025]');
pdegplot(gm,VertexLabels="on");
xlim([0.04 0.21])
ylim([-0.03 0.03])

Figure contains an axes object. The axes object contains 5 objects of type line, text.

Create an femodel object for solving a static structural problem, and assign the geometry to the model.

model = femodel(AnalysisType="structuralStatic", ...
                Geometry=gm);

Specify the concentrated force at vertex 1.

model.VertexLoad(1) = vertexLoad(Force=[0 10^4]);
model.VertexLoad
ans = 
  1x4 vertexLoad array

Properties for analysis type: structuralStatic

Index      Force  
  1      [0 10000]
  2         []    
  3         []    
  4         []    

  Show all properties

Version History

Introduced in R2023a