Table of Contents

Class StructureMaterial

Namespace
Hi.Physics
Assembly
HiMech.dll

Represents a material with physical and thermal properties used in structural analysis.

public class StructureMaterial : IStructureMaterial, IMakeXmlSource, IDuplicate, INameNote, IToXElement
Inheritance
StructureMaterial
Implements
Inherited Members
Extension Methods

Constructors

StructureMaterial()

Default constructor.

public StructureMaterial()

StructureMaterial(StructureMaterial)

Creates a new cutter material as a copy of an existing one.

public StructureMaterial(StructureMaterial src)

Parameters

src StructureMaterial

The source material to copy from.

StructureMaterial(XElement)

Ctor.

public StructureMaterial(XElement src)

Parameters

src XElement

XML

Properties

AlloySteel42CrMo

Gets a predefined 42CrMo alloy steel material commonly used for milling cutter bodies. The strengths are the quenched-and-tempered minimums of GB/T 3077 (42CrMo: Rm ≥ 1080 MPa, ReL ≥ 930 MPa).

public static StructureMaterial AlloySteel42CrMo { get; }

Property Value

StructureMaterial

Density_gdcm3

Gets or sets the density in grams per cubic centimeter. NaN when the file the material was read from has no such element (not given); see HasThermalConstants.

public double Density_gdcm3 { get; set; }

Property Value

double

Density_gdm3

Density in g/m³.

public double Density_gdm3 { get; set; }

Property Value

double

Density_gdmm3

Density in g/mm³.

public double Density_gdmm3 { get; set; }

Property Value

double

ElasticModulus_GPa

Gets or sets the elastic modulus in gigapascals.

public double ElasticModulus_GPa { get; set; }

Property Value

double

FractureStrength_MPa

Fracture strength in MPa, in the loading of the beam – bending at the outer fibre: the line of no ratio HiNC presents, data for a breakage probability (see FractureStrength_MPa). NaN (the default) when not known; a ductile steel needs none.

public double FractureStrength_MPa { get; set; }

Property Value

double

HasThermalConstants

Whether the three thermal constants the thermal model reads are given: none of HeatConductivity_WdmK, Density_gdcm3 and HeatCapacity_JdgK is NaN. A material file without one of the elements reads it as NaN (not given) and no default stands in; the thermal model then skips the material as it skips one that is missing, and MaterialThermalConstantCheck names it (Material-ThermalConstants–NotGiven). A constant that is given but not usable (0, negative, infinite) counts as given: the model runs with it as it is, and the check names it apart. The three material classes implement it as well: a default interface member is reachable through the interface type alone, and a cutter's flute material and a workpiece's material are held by their class types.

public bool HasThermalConstants { get; }

Property Value

bool

HeatCapacity_JdgK

Gets or sets the heat capacity in Joules per gram-Kelvin. NaN when the file the material was read from has no such element (not given); see HasThermalConstants.

public double HeatCapacity_JdgK { get; set; }

Property Value

double

HeatConductivity_WdmK

Gets or sets the heat transfer coefficient in Watts per meter-Kelvin. NaN when the file the material was read from has no such element (not given); see HasThermalConstants.

public double HeatConductivity_WdmK { get; set; }

Property Value

double

HeatConductivity_WdmmK

Heat transfer coefficient in W/(mm·K).

public double HeatConductivity_WdmmK { get; set; }

Property Value

double

Name

Gets or sets the name of the object.

public string Name { get; set; }

Property Value

string

NotDuctile

Whether the material has no yield point by nature, so that its missing YieldStrength_MPa is a property and not a gap; the XML carries the element with the text NotDuctile on purpose (StrengthXml.NotDuctileText), and a material whose yield strength is merely not known has no element and reads false. See NotDuctile.

public bool NotDuctile { get; set; }

Property Value

bool

Note

Gets or sets the descriptive note for the object.

public string Note { get; set; }

Property Value

string

PoissonRatio 

public double PoissonRatio { get; set; }

Property Value

double

StressLimit_MPa

The stress line, in MPa: the stress a beam section of this material is rated against in the stress ratio (section stress ÷ this), at or above which the machining is bad. It is the yield strength where the material gives one – a ductile steel such as a 42CrMo insert body deforms permanently there yet holds for a while – and the tensile strength where it gives none: a carbide, a ceramic or a CBN has no yield point (NotDuctile), and its tensile-strength listing stands in as the line; the yield strength is the more conservative of the two, so it takes precedence where both are given. The fracture strength (FractureStrength_MPa, a carbide's transverse rupture strength) is the line of no ratio: it is data for a breakage probability. NaN where the material does not know its strength, so the ratio reads NaN instead of a fake-safe 0. This default answers NaN; StructureMaterial and CutterMaterial answer from their strength members.

public double StressLimit_MPa { get; }

Property Value

double

TensileStrength_MPa

Ultimate tensile strength in MPa: the highest stress of the tensile test, the stress a ductile steel breaks at. It is the stress line (StressLimit_MPa) of a material that gives no YieldStrength_MPa.

public double TensileStrength_MPa { get; set; }

Property Value

double

ThermalExpansionCoefficient_dMK

Linear thermal expansion coefficient in 1e-6/K (µm/(m·K)). The thermal stress reads the flute material's, ThermalExpansionCoefficient_dMK, not this one.

public double ThermalExpansionCoefficient_dMK { get; set; }

Property Value

double

XName

Name for XML IO.

public static string XName { get; }

Property Value

string

YieldStrength_MPa

Yield strength in MPa, in tension: the stress at which the material starts to deform permanently – the stress line of the stress ratio where it is given, since it is the more conservative strength and a ductile body is overloaded once it yields (a 42CrMo body yields at 930 MPa, below its 1080 MPa tensile strength). NaN (the default) when not given: not known, or absent by nature for a material without a yield point (a carbon-fibre composite), which NotDuctile marks and whose line is then its TensileStrength_MPa.

public double YieldStrength_MPa { get; set; }

Property Value

double

Methods

Duplicate(params object[])

Creates a deep copy of the object, excluding any source file references.

public object Duplicate(params object[] res)

Parameters

res object[]

Optional parameters that may be needed during the duplication process

Returns

object

A new instance that is a deep copy of the original object

MakeXmlSource(string, string, bool)

Creates an XML representation of the object. This method may also generate additional resources such as related files.

public virtual XElement MakeXmlSource(string baseDirectory, string relFile, bool exhibitionOnly)

Parameters

baseDirectory string

The base directory for resolving relative paths

relFile string

The relative file path for the XML source

exhibitionOnly bool

if true, the extended file creation is suppressed.

Returns

XElement

An XML element representing the object's state

Remarks

For the demand of easy moving source folder (especially project folder) without configuration file path corruption, the relative file path is applied. The baseDirectory is typically the folder at the nearest configuration file folder. Since the folder can be moving with the configuration file.

Reg(XFactory)

Registers this type's deserializer with the given XFactory and chains Reg(factory) on dependents. Idempotent.

public static void Reg(XFactory factory = null)

Parameters

factory XFactory

ToXElement()

Get the XElement to represent the object.

public XElement ToXElement()

Returns

XElement

XElement to represent the object.