Main Content

# findStructuralProperties

Find structural material properties assigned to geometric region

## Syntax

``smpa = findStructuralProperties(structuralmodel.MaterialProperties,RegionType,RegionID)``

## Description

example

````smpa = findStructuralProperties(structuralmodel.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.```

## 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)```

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