Table of Contents

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
CutterMaterial
Implements
Derived
Inherited Members
Extension Methods

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

FractureStrength_MPa

Fracture strength in MPa, in the loading of the cutter beam – bending at the outer fibre. For a carbide it is the transverse rupture strength (three-point bending, ISO 3327); the shipped carbide files hold the median catalogue value of current rod grades of their class, a small test bar's static median, the stress at which half the bars break. It is the line of no ratio HiNC presents (a ratio a user watches means “below 100 % is safe”, which a median break is not); it is data for a breakage probability, the Weibull form on the section stress over this value. NaN (the default) when not known.

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

NotDuctile

Whether the material has no yield point by nature – a carbide, a ceramic, a CBN, a coating: elastic to fracture – so that its missing YieldStrength_MPa is a property and not a gap. The XML carries such a material's YieldStrength_MPa element with the text NotDuctile on purpose (StrengthXml.NotDuctileText); a material whose yield strength is merely not known has no element, and reads false. Three states, then: a number, the mark, nothing. A yield strength given as a number takes the line and is written as the number whatever this says.

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

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 highest stress of the tensile test, which for a carbide is also the stress it breaks at in tension. The shipped carbide files hold tensile-strength listings (a carbide toolmaker publishes no tensile test of its own; the value is a vendor's listing or conversion, see each file's Note). It is the stress line (StressLimit_MPa) of a material that gives no YieldStrength_MPa – every shipped cutter material, which has no yield point (NotDuctile) – as it was in every HiNC release through 3.2.55.

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 in MPa reads ΔT·α·E/(1000·(1 − ν)) with this α and ElasticModulus_GPa E in GPa (GetThermalStress_MPa(MillingCutter, double)).

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, 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 material is overloaded once it yields. NaN (the default) when not given: either not known, or absent by nature for the brittle cutter materials that have no yield point (a carbide, a ceramic, a CBN: elastic to fracture), which NotDuctile marks and whose line is their TensileStrength_MPa. A compressive yield or proof stress, which some vendors publish, is another loading and does not belong here.

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

Returns

XElement

XElement to represent the object.