Skip to content

BH.oM.Structure.MaterialFragments.Timber

Structural timber material to be used on structural elements and properties or as a fragment of the physical material.

Class structure

Implemented interfaces and base types

The Timber is inheriting from the following base type(s) and implements the following interfaces:

Properties

Defining properties

The following properties are defined on the class

Name Type Description Quantity
Name string Name. A unique name is required for some structural packages to create and identify the object. -
DensityCharacteristic double Characteristic Density. Used to calculate other mechanical properties (not mass). Called G (specific gravity) in American codes, p_k in Eurocode. Density [kg/m³]
Density double Mean Density. Used to calculate mass. Called p_mean in Eurocode. Density [kg/m³]
DampingRatio double Dynamic Damping Ratio. Ratio between actual damping and critical damping. Ratio [-]
YoungsModulus Vector Characteristic Modulus Of Elasticity of the material. Ratio between stress and strain in all directions. Vector components made up of: X - Parallel, E_0,k in Eurocode; Y - Perpendicular, E_90,k in Eurocode; Z - Perpendicular, E_90,k in Eurocode. YoungsModulus [Pa]
YoungsModulusMean Vector Mean Modulus Of Elasticity of the material. Ratio between stress and strain in all directions. Vector components made up of: X - Parallel, E_0,mean in Eurocode; Y - Perpendicular, E_90,mean in Eurocode; Z - Perpendicular, E_90,mean in Eurocode. YoungsModulus [Pa]
PoissonsRatio Vector Poisson's Ratio. Ratio between axial and transverse strain. Typically take as 0.4 in all directions, though value varies depending on timber species. Vector components made up of: X - Parallel; Y - Perpendicular; Z - Perpendicular. Ratio [-]
ThermalExpansionCoeff Vector Thermal Expansion Coefficeint. Strain induced in the material per unit change of temperature. Typically take as 5x10^-6 in all directions, though value varies depending on timber species. Vector components made up of: X - Parallel; Y - Perpendicular; Z - Perpendicular. ThermalExpansionCoefficient [1/K]
ShearModulus Vector Characterstic Shear Modulus or Modulus of Rigidity. Ratio between shear stress and shear strain. Vector components made up of: X - Parallel, G_k in Eurocode; Y - Parallel, G_k in Eurocode; Z - Perpendicular, G_r,05 in Eurocode. ShearModulus [Pa]
ShearModulusMean Vector Mean Shear Modulus or Modulus of Rigidity. Ratio between shear stress and shear strain. Vector components made up of: X - Parallel, G_mean in Eurocode; Y - Parallel, G_mean in Eurocode; Z - Perpendicular, G_r,mean in Eurocode. ShearModulus [Pa]
BendingStrength double Bending Strength. Tension stress parallel to the grain at failure in bending as calculated from beam equations. Called F_b in American codes, f_mk in Eurocode. Stress [Pa]
TensionParallelStrength double Tension Parallel Strength. Tension stress parallel to the grain at failure in net tension. Called F_t∥ in American codes, f_t0k in Eurocode. Stress [Pa]
TensionPerpendicularStrength double Tension Perpendicular Strength. Tension stress perpendicular to the grain at failure in net tension. Called F_t⟂ in American codes, f_t90k in Eurocode. Stress [Pa]
CompressionParallelStrength double Compression Parallel Strength. Compression stress parallel to the grain at failure in net compression. Called F_c∥ in American codes, f_c0k in Eurocode. Stress [Pa]
CompressionPerpendicularStrength double Compression Perpendicular Strength. Compression stress perpendicular to the grain at failure in net compression. Called F_c⟂ in American codes, f_c90k in Eurocode. Stress [Pa]
ShearStrength double Shear Strength. Shear stress parallel to the grain at failure in net shear, i.e. shear relevant to beam bending. Called F_v in American codes, f_vk in Eurocode. Stress [Pa]
RollingShearStrength double Rolling Shear Strength. Shear stress perpendicular to the grain at failure in net shear. Called F_s in American codes, F_rk in Eurocode. Stress [Pa]

Inherited properties

The following properties are inherited from the base class of the object

Name Type Description Quantity
BHoM_Guid Guid - -
Fragments FragmentSet - -
Tags HashSet<string> - -
CustomData Dictionary<string, object> - -

Derived properties

The following properties are defined as extension methods in one of the BHoM_Engines

Name Type Description Quantity Engine
Description string Generates a default description for the material based on its properties. - Structure_Engine
Description string Generates a default description for the material based on its properties. - Structure_Engine
DescriptionOrName string Gets the name from a IProperty. If null or empty, a default description name is provided instead. - Structure_Engine
IDescription string Generates a default description for the IProperty, based on its properties. - Structure_Engine
IMaterialType MaterialType Gets the material type from the MaterialFragment. - Structure_Engine
IsNull bool Checks if a MaterialFragment is null and outputs relevant error message. - Structure_Engine
MaterialType MaterialType Gets the material type from the MaterialFragment. For a Timber material this will always return type Timber. - Structure_Engine

Code and Schema

C# implementation

C#
public class Timber : BH.oM.Base.BHoMObject,
BH.oM.Base.IBHoMObject,
BH.oM.Base.IObject,
BH.oM.Structure.MaterialFragments.ITimber,
BH.oM.Structure.MaterialFragments.IOrthotropic,
BH.oM.Structure.MaterialFragments.IMaterialFragment,
BH.oM.Base.IFragment,
BH.oM.Physical.Materials.IMaterialProperties,
BH.oM.Structure.IProperty,
BH.oM.Physical.Materials.IDensityProvider

Assembly: Structure_oM.dll

The C# class definition is available on github:

All history and changes of the class can be found by inspection the history.

JSON Schema implementation

The object is defined as a JSON schema. You can validate a JSON instance against this schema by reference. To do this, use the schema reference below in a validator like this one.

JSON Schema
{
 "$ref" : "https://raw.githubusercontent.com/BHoM/BHoM_JSONSchema/develop/Structure_oM/MaterialFragments/Timber.json"
}

The JSON Schema is available on github here: