Class CutterMaterial

Namespace

Hi.Physics

Assembly

HiMech.dll

Represents a cutter material with physical and thermal properties.

public class CutterMaterial : ISurfaceMaterial, IStructureMaterial, IMakeXmlSource, IDuplicate, INameNote, IToXElement

Inheritance

object

CutterMaterial

Implements

ISurfaceMaterial

IStructureMaterial

IMakeXmlSource

IDuplicate

INameNote

IToXElement

Derived

CoatingMaterial

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Extension Methods

DuplicateUtil.TryDuplicate<TSelf>(TSelf, params object[])

InvokeUtil.SelfInvoke<TSrc>(TSrc, Action<TSrc>)

InvokeUtil.SelfInvoke<TSrc, TDst>(TSrc, Func<TSrc, TDst>)

ColorUtil.GetGloomyColor(object, double, double)

KindNameUtil.KindName(object)

NameUtil.GetSelectionName(object)

StringUtil.GetPropertyStringIfToStringNotOverloaded(object, bool, bool)

LockUtil.Lock(object)

Constructors

CutterMaterial()

Default constructor.

public CutterMaterial()

CutterMaterial(CutterMaterial)

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

public CutterMaterial(CutterMaterial src)

Parameters

src CutterMaterial

The source material to copy from.

CutterMaterial(XElement)

Ctor.

public CutterMaterial(XElement src)

Parameters

src XElement

XML

Properties

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

FrictionCoefficient

Gets or sets the friction coefficient of the surface material.

public double FrictionCoefficient { get; set; }

Property Value

double

FusionLatentHeat_Jdg

Latent Heat of Fusion.

public double FusionLatentHeat_Jdg { 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

HasWearCurves

Whether the two wear curves the thermal model reads are given: TemperatureVsHardnessCurve and TemperatureVsWearCoefficientCurve each non-null with at least one entry. A material file without the element reads it as null, an empty element as an empty list — not given either way, and no default stands in. The native thermal session does not model a cutter whose flute or coating-layer material lacks one (it refuses the cutter at its creation: ThermalStepOutcome.ModelUnavailable, said once per tool as Physics-Thermal–ModelUnavailable; the managed reference kernel refuses it as well), and ReportWearCurvesNotGiven(CutterMaterial, string, IProgress<IMessage>, object) names the material at the tool change, the session begin, the start of a play, the step-physics recompute and the web API's material loads (Material-WearCurves–NotGiven). The copy constructor and the writer keep a null curve null and write no element for it, so a file of a material without one does not change.

public bool HasWearCurves { 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

MeltingTemperature_K

public double MeltingTemperature_K { get; set; }

Property Value

double

Name

Gets or sets the name of the object.

public string Name { get; set; }

Property Value

string

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

TemperatureVsHardnessCurve

Temperature versus hardness curve data. Null when the file the material was read from has no such element (not given), an empty list when the element is empty; see HasWearCurves.

public List<TemperatureVsHardness> TemperatureVsHardnessCurve { get; set; }

Property Value

List<TemperatureVsHardness>

TemperatureVsWearCoefficientCurve

Temperature(K) vs WearCoefficient. Unit of WearCoefficient: 1e-6 (non-unit). Null when the file the material was read from has no such element (not given), an empty list when the element is empty; see HasWearCurves.

public List<vec2d_t> TemperatureVsWearCoefficientCurve { get; set; }

Property Value

List<vec2d_t>

TensileStrength_MPa

Ultimate tensile strength in MPa — the stress at rupture (for a carbide, its transverse rupture strength stands in).

public double TensileStrength_MPa { get; set; }

Property Value

double

ThermalExpansionCoefficient_dMK

public double ThermalExpansionCoefficient_dMK { get; set; }

Property Value

double

WC

General condition of WC (Tungsten Carbide).

public static CutterMaterial WC { get; }

Property Value

CutterMaterial

WC_Co6_800nm

WC-Co6 with 800nm grain size properties.

public static CutterMaterial WC_Co6_800nm { get; }

Property Value

CutterMaterial

XName

Name for XML IO.

public static string XName { get; }

Property Value

string

YieldStrength_MPa

Yield strength in MPa. NaN (the default) when not known, and for the brittle cutter materials that have no yield point; the yielding stress ratio then rates the beam against TensileStrength_MPa.

public double YieldStrength_MPa { get; set; }

Property Value

double

YieldingStressLimit_MPa

The stress, in MPa, a beam section of this material is rated against in the yielding stress ratio (section stress ÷ this): the yield strength where the material yields, the rupture (tensile) strength where it does not — carbides and ceramics have no yield point — and 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 YieldingStressLimit_MPa { get; }

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 virtual XElement ToXElement()

Returns

XElement

XElement to represent the object.