Main Content

findStructuralProperties

Find structural material properties assigned to geometric region

Domain-specific structural workflow is not recommended. New features might not be compatible with this workflow. For help migrating your existing code to the unified finite element workflow, see Migration from Domain-Specific to Unified Workflow.

Description

smpa = findStructuralProperties(materialProperties,RegionType,RegionID) returns the structural material properties assigned to the specified region. Structural properties include Young's modulus, Poisson's ratio, the mass density, the coefficient of thermal expansion, and the hysteretic damping parameter of the material.

example

Examples

collapse all

Find Young's modulus and Poisson's ratio for cells of a 3-D geometry.

Create a structural model.

structuralmodel = createpde("structural","static-solid");

Create the geometry consisting of three stacked cylinders and include it in the model. Plot the geometry.

gm = multicylinder(10,[1 2 3],"ZOffset",[0 1 3]);
structuralmodel.Geometry = gm;
pdegplot(structuralmodel,"CellLabels","on","FaceAlpha",0.5)

Figure contains an axes object. The axes object contains 6 objects of type quiver, text, patch, line.

Assign different values of Young's modulus and Poisson's ratio to each cell.

structuralProperties(structuralmodel,"Cell",1,"YoungsModulus",200E9, ...
                                              "PoissonsRatio",0.3);
structuralProperties(structuralmodel,"Cell",2,"YoungsModulus",210E9, ...
                                              "PoissonsRatio",0.3);
structuralProperties(structuralmodel,"Cell",3,"YoungsModulus",110E9, ...
                                              "PoissonsRatio",0.35);

Check the structural properties specification for cell 1.

mC1 = findStructuralProperties(structuralmodel.MaterialProperties, ...
                                                         "Cell",1)
mC1 = 
  StructuralMaterialAssignment with properties:

           RegionType: 'Cell'
             RegionID: 1
        YoungsModulus: 2.0000e+11
        PoissonsRatio: 0.3000
          MassDensity: []
                  CTE: []
    HystereticDamping: []

Check the structural properties specification for cells 2 and 3.

mC23 = findStructuralProperties(structuralmodel.MaterialProperties, ...
                                                     "Cell",[2,3]);
mC2 = mC23(1)
mC2 = 
  StructuralMaterialAssignment with properties:

           RegionType: 'Cell'
             RegionID: 2
        YoungsModulus: 2.1000e+11
        PoissonsRatio: 0.3000
          MassDensity: []
                  CTE: []
    HystereticDamping: []

mC3 = mC23(2)
mC3 = 
  StructuralMaterialAssignment with properties:

           RegionType: 'Cell'
             RegionID: 3
        YoungsModulus: 1.1000e+11
        PoissonsRatio: 0.3500
          MassDensity: []
                  CTE: []
    HystereticDamping: []

Input Arguments

collapse all

Material properties of the model, specified as the MaterialProperties property of a StructuralModel object.

Example: structuralmodel.MaterialProperties

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

Example: findStructuralProperties(structuralmodel.MaterialProperties,"Cell",1)

Data Types: char | string

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

Example: findStructuralProperties(structuralmodel.MaterialProperties,"Face",1:3)

Data Types: double

Output Arguments

collapse all

Material properties assignment, returned as a StructuralMaterialAssignment object. For details, see StructuralMaterialAssignment Properties.

Version History

Introduced in R2017b