Material

Material definitions (isotropic, 2D/3D orthotropic) — modulus, density, Poisson, thermal. Assigned to members, plates, and solids.

20 functions

Create

CreateIsotropicMaterialAluminum

Description

Creates the isotropic material aluminum.

Parameters

  • material_name (str): material name.
  • elasticity_mod (float): elasticity mod.
  • poisson (float): poisson.
  • shear_mod (float): shear mod.
  • density (float): density.
  • thermal_exp (float): thermal exp.
  • damping_ratio (float): damping ratio.
  • physical_flag (int): physical flag.

Returns

raw: The raw return value from the underlying OpenSTAAD COM call. Refer to the official Bentley OpenSTAAD API reference for this method's exact return semantics.

Example

from openstaad import ops

s = ops.connect()
result = s.CreateIsotropicMaterialAluminum("value", 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1)
print(result)

CreateIsotropicMaterialConcrete

Description

Creates the isotropic material concrete.

Parameters

  • name (str): name.
  • elasticity (float): elasticity.
  • poisson (float): poisson.
  • shear_modulus (float): shear modulus.
  • density (float): density.
  • alpha (float): alpha.
  • damping_ratio (float): damping ratio.
  • compressive_strength (float): compressive strength.
  • physical (int): physical.

Returns

raw: The raw return value from the underlying OpenSTAAD COM call. Refer to the official Bentley OpenSTAAD API reference for this method's exact return semantics.

Example

from openstaad import ops

s = ops.connect()
result = s.CreateIsotropicMaterialConcrete("value", 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1)
print(result)

CreateIsotropicMaterialProperties

Description

Creates the isotropic material properties.

Parameters

  • material_name (str): material name.
  • elasticity_mod (float): elasticity mod.
  • poisson (float): poisson.
  • shear_mod (float): shear mod.
  • density (float): density.
  • coef_thermal_exp (float): coef thermal exp.
  • damp_ratio (float): damp ratio.

Returns

raw: The raw return value from the underlying OpenSTAAD COM call. Refer to the official Bentley OpenSTAAD API reference for this method's exact return semantics.

Example

from openstaad import ops

s = ops.connect()
result = s.CreateIsotropicMaterialProperties("value", 1.0, 1.0, 1.0, 1.0, 1.0, 1.0)
print(result)

CreateIsotropicMaterialPropertiesEx

Description

Creates the isotropic material properties ex.

Parameters

  • material_name (str): material name.
  • elasiticity (float): elasiticity.
  • poisson (float): poisson.
  • shear_modulus (float): shear modulus.
  • density (float): density.
  • alpha (float): alpha.
  • damping_ratio (float): damping ratio.
  • fy (float): fy.
  • fu (float): fu.
  • ry (float): ry.
  • rt (float): rt.
  • fcu (float): fcu.

Returns

raw: The raw return value from the underlying OpenSTAAD COM call. Refer to the official Bentley OpenSTAAD API reference for this method's exact return semantics.

Example

from openstaad import ops

s = ops.connect()
result = s.CreateIsotropicMaterialPropertiesEx("value", 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0)
print(result)

CreateIsotropicMaterialSteel

Description

Creates the isotropic material steel.

Parameters

  • name (str): name.
  • elasticity_mod (float): elasticity mod.
  • poisson_ratio (float): poisson ratio.
  • shear_modulus (float): shear modulus.
  • density (float): density.
  • thermal_expansion (float): thermal expansion.
  • damping_ratio (float): damping ratio.
  • tensile_strength (float): tensile strength.
  • yield_strength (float): yield strength.
  • tensile_ratio (float): tensile ratio.
  • yield_ratio (float): yield ratio.
  • is_physical (int): is physical.

Returns

raw: The raw return value from the underlying OpenSTAAD COM call. Refer to the official Bentley OpenSTAAD API reference for this method's exact return semantics.

Example

from openstaad import ops

s = ops.connect()
result = s.CreateIsotropicMaterialSteel("value", 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1)
print(result)

CreateIsotropicMaterialTimber

Description

Creates the isotropic material timber.

Parameters

  • material_name (str): material name.
  • elasticity (float): elasticity.
  • poisson (float): poisson.
  • shear_modulus (float): shear modulus.
  • density (float): density.
  • thermal_expansion (float): thermal expansion.
  • damping_ratio (float): damping ratio.
  • physical_flag (int): physical flag.

Returns

raw: The raw return value from the underlying OpenSTAAD COM call. Refer to the official Bentley OpenSTAAD API reference for this method's exact return semantics.

Example

from openstaad import ops

s = ops.connect()
result = s.CreateIsotropicMaterialTimber("value", 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1)
print(result)

Get

GetIsotropicMaterialCount

Description

Returns the isotropic material count.

Parameters

None.

Returns

raw: The raw return value from the underlying OpenSTAAD COM call. Refer to the official Bentley OpenSTAAD API reference for this method's exact return semantics.

Example

from openstaad import ops

s = ops.connect()
result = s.GetIsotropicMaterialCount()
print(result)

GetIsotropicMaterialProperties

Description

Returns the isotropic material properties.

Parameters

  • material_number (int): material number.

Returns

tuple: A tuple of (raw, raw).

Example

from openstaad import ops

s = ops.connect()
result = s.GetIsotropicMaterialProperties(1)
print(result)

GetIsotropicMaterialPropertiesAssigned

Description

Returns the isotropic material properties assigned.

Parameters

  • material_no (int): material no.

Returns

tuple: A tuple of (raw, raw, int).

Example

from openstaad import ops

s = ops.connect()
result = s.GetIsotropicMaterialPropertiesAssigned(1)
print(result)

GetIsotropicMaterialPropertiesEx

Description

Returns the isotropic material properties ex.

Parameters

  • material_number (int): material number.

Returns

tuple: A tuple of (raw, raw).

Example

from openstaad import ops

s = ops.connect()
result = s.GetIsotropicMaterialPropertiesEx(1)
print(result)

GetMaterialProperty

Description

Returns the material property.

Parameters

  • MaterialName (str): material name.

Returns

tuple: A tuple of float values, one per output slot.

Example

from openstaad import ops

s = ops.connect()
result = s.GetMaterialProperty("value")
print(result)

GetMaterialPropertyEx

Description

Returns the material property ex.

Parameters

  • material_name (str): material name.

Returns

tuple: A tuple of float values, one per output slot.

Example

from openstaad import ops

s = ops.connect()
result = s.GetMaterialPropertyEx("value")
print(result)

GetOrthotropic2DMaterialCount

Description

Returns the orthotropic 2 d material count.

Parameters

None.

Returns

raw: The raw return value from the underlying OpenSTAAD COM call. Refer to the official Bentley OpenSTAAD API reference for this method's exact return semantics.

Example

from openstaad import ops

s = ops.connect()
result = s.GetOrthotropic2DMaterialCount()
print(result)

GetOrthotropic2DMaterialProperties

Description

Returns the orthotropic 2 d material properties.

Parameters

  • material_no (int): material no.

Returns

tuple: A tuple of float values, one per output slot.

Example

from openstaad import ops

s = ops.connect()
result = s.GetOrthotropic2DMaterialProperties(1)
print(result)

GetOrthotropic3DMaterialCount

Description

Returns the orthotropic 3 d material count.

Parameters

None.

Returns

raw: The raw return value from the underlying OpenSTAAD COM call. Refer to the official Bentley OpenSTAAD API reference for this method's exact return semantics.

Example

from openstaad import ops

s = ops.connect()
result = s.GetOrthotropic3DMaterialCount()
print(result)

GetOrthotropic3DMaterialProperties

Description

Returns the orthotropic 3 d material properties.

Parameters

  • material_no (int): material no.

Returns

tuple: A tuple of float values, one per output slot.

Example

from openstaad import ops

s = ops.connect()
result = s.GetOrthotropic3DMaterialProperties(1)
print(result)

GetTypeForIsotropicMaterial

Description

Returns the type for isotropic material.

Parameters

  • material_name (str): material name.

Returns

int: An integer value returned by STAAD.Pro for this call.

Example

from openstaad import ops

s = ops.connect()
result = s.GetTypeForIsotropicMaterial("value")
print(result)

Set/Assign

SetMaterialName

Description

Sets the material name.

Parameters

  • material_name (str): material name.

Returns

None: This function does not return a value.

Example

from openstaad import ops

s = ops.connect()
s.SetMaterialName("value")

SetTypeToIsotropicMaterial

Description

Sets the type to isotropic material.

Parameters

  • material_name (str): material name.
  • material_type (int): material type.

Returns

raw: The raw return value from the underlying OpenSTAAD COM call. Refer to the official Bentley OpenSTAAD API reference for this method's exact return semantics.

Example

from openstaad import ops

s = ops.connect()
result = s.SetTypeToIsotropicMaterial("value", 1)
print(result)

Delete

DeleteMaterial

Description

Deletes the material.

Parameters

  • material_name (str): material name.

Returns

raw: The raw return value from the underlying OpenSTAAD COM call. Refer to the official Bentley OpenSTAAD API reference for this method's exact return semantics.

Example

from openstaad import ops

s = ops.connect()
result = s.DeleteMaterial("value")
print(result)