The `material.py` module#

Summary#

Classes

`CharacteristicWidthDataPoint`	Provides the container for a characteristic width data point.
`ThermalPropertiesDataPoint`	Provides the container for temperature-dependent properties.
`AdditiveMaterial`	Provides the container for material properties used during additive manufacturing simulations.

Description#

Provides a container for material parameters.

Module detail#

class material.CharacteristicWidthDataPoint(*, laser_power: float = 0, scan_speed: float = 0, characteristic_width: float = 0)#

Provides the container for a characteristic width data point.

Additive material definitions include a file containing a characteristic width lookup table, allowing a given laser speed and power to be correlated to a characteristic melt pool width. This class represents a single row in the lookup table.

Overview#

Properties

`characteristic_width`	Characteristic melt pool width for a given laser power and scan
`laser_power`	Laser power (W).
`scan_speed`	Laser scan speed (m/s).

Import detail#

from ansys.additive.core.material import CharacteristicWidthDataPoint

Property detail#

property CharacteristicWidthDataPoint.characteristic_width: float#: Characteristic melt pool width for a given laser power and scan speed (m).

property CharacteristicWidthDataPoint.laser_power: float#: Laser power (W).

property CharacteristicWidthDataPoint.scan_speed: float#: Laser scan speed (m/s).

class CharacteristicWidthDataPoint.ThermalPropertiesDataPoint(*, density: float = 0, density_ratio: float = 0, specific_heat: float = 0, specific_heat_ratio: float = 0, temperature: float = 0, thermal_conductivity: float = 0, thermal_conductivity_ratio: float = 0)#

Provides the container for temperature-dependent properties.

Additive material definitions include a file containing a lookup table describing the material’s thermal properties at different temperatures. This class represents a single row in the lookup table.

Units are SI (m, kg, s, K) unless otherwise noted.

Overview#

Properties

`density`	Density (kg/m^3).
`density_ratio`	Density ratio.
`specific_heat`	Specific heat (J/kg/K).
`specific_heat_ratio`	Specific heat ratio.
`temperature`	Temperature (K).
`thermal_conductivity`	Thermal conductivity (W/m/K).
`thermal_conductivity_ratio`	Thermal conductivity ratio.

Import detail#

from ansys.additive.core.material import ThermalPropertiesDataPoint

Property detail#

property ThermalPropertiesDataPoint.density: float#: Density (kg/m^3).

property ThermalPropertiesDataPoint.density_ratio: float#: Density ratio.

property ThermalPropertiesDataPoint.specific_heat: float#: Specific heat (J/kg/K).

property ThermalPropertiesDataPoint.specific_heat_ratio: float#: Specific heat ratio.

property ThermalPropertiesDataPoint.temperature: float#: Temperature (K).

property ThermalPropertiesDataPoint.thermal_conductivity: float#: Thermal conductivity (W/m/K).

property ThermalPropertiesDataPoint.thermal_conductivity_ratio: float#: Thermal conductivity ratio.

class ThermalPropertiesDataPoint.AdditiveMaterial(*, absorptivity_maximum: float = 0, absorptivity_minimum: float = 0, absorptivity_powder_coefficient_a: float = 0, absorptivity_powder_coefficient_b: float = 0, absorptivity_solid_coefficient_a: float = 0, absorptivity_solid_coefficient_b: float = 0, anisotropic_strain_coefficient_parallel: float = 0, anisotropic_strain_coefficient_perpendicular: float = 0, anisotropic_strain_coefficient_z: float = 0, elastic_modulus: float = 0, hardening_factor: float = 0, liquidus_temperature: float = 0, material_yield_strength: float = 0, name: str = '', nucleation_constant_bulk: float = 0, nucleation_constant_interface: float = 0, penetration_depth_maximum: float = 0, penetration_depth_minimum: float = 0, penetration_depth_powder_coefficient_a: float = 0, penetration_depth_powder_coefficient_b: float = 0, penetration_depth_solid_coefficient_a: float = 0, penetration_depth_solid_coefficient_b: float = 0, poisson_ratio: float = 0, powder_packing_density: float = 0, purging_gas_convection_coefficient: float = 0, solid_density_at_room_temperature: float = 0, solid_specific_heat_at_room_temperature: float = 0, solid_thermal_conductivity_at_room_temperature: float = 0, solidus_temperature: float = 0, strain_scaling_factor: float = 0, support_yield_strength_ratio: float = 0, thermal_expansion_coefficient: float = 0, vaporization_temperature: float = 0, characteristic_width_data: list[CharacteristicWidthDataPoint] = None, thermal_properties_data: list[ThermalPropertiesDataPoint] = None)#: Provides the container for material properties used during additive manufacturing simulations.

Overview#

Properties

`absorptivity_maximum`	Absorptivity maximum.
`absorptivity_minimum`	Absorptivity minimum.
`absorptivity_powder_coefficient_a`	Absorptivity powder coefficient a.
`absorptivity_powder_coefficient_b`	Absorptivity powder coefficient b.
`absorptivity_solid_coefficient_a`	Absorptivity solid coefficient a.
`absorptivity_solid_coefficient_b`	Absorptivity solid coefficient b.
`anisotropic_strain_coefficient_parallel`	Multiplier on the predicted strain in the direction that the laser is scanning for the major fill rasters.
`anisotropic_strain_coefficient_perpendicular`	Multiplier on the predicted strain orthogonal to the direction that the laser is scanning for the major fill rasters and in the plane of the surface of the build plate.
`anisotropic_strain_coefficient_z`	Multiplier on the predicted strain in the Z direction.
`elastic_modulus`	Elastic modulus (Pa).
`hardening_factor`	Factor relating the elastic modulus to the tangent modulus for plasticity simulations (tangent modulus = elastic modulus * hardening factor).
`liquidus_temperature`	Minimum temperature (K) at which the material is completely liquid.
`material_yield_strength`	Material yield strength (Pa).
`name`	Name of the material.
`nucleation_constant_bulk`	Controls the homogeneous nucleation rate (in bulk of the microstructure simulation domain) during solidification (1/m^2/K^2).
`nucleation_constant_interface`	Heterogeneous nucleation rate (on existing solid interfaces) during solidification (1/m/K^2).
`penetration_depth_maximum`	Penetration depth maximum.
`penetration_depth_minimum`	Penetration depth minimum.
`penetration_depth_powder_coefficient_a`	Penetration depth powder coefficient a.
`penetration_depth_powder_coefficient_b`	Penetration depth powder coefficient b.
`penetration_depth_solid_coefficient_a`	Penetration depth solid coefficient a.
`penetration_depth_solid_coefficient_b`	Penetration depth solid coefficient b.
`poisson_ratio`	Poisson ratio.
`powder_packing_density`	Density of powder material relative to the solid.
`purging_gas_convection_coefficient`	Convection coefficient between the solid and gas during build.
`solid_density_at_room_temperature`	Density of bulk material at room temperature, 298 K (kg/m^3).
`solid_specific_heat_at_room_temperature`	Specific heat of bulk material at room temperature, 298 K (J/kg/K).
`solid_thermal_conductivity_at_room_temperature`	Thermal conductivity of bulk material at room temperature, 298 K (W/m/K).
`solidus_temperature`	Maximum temperature (K) at which the material is completely solid.
`strain_scaling_factor`	Strain scaling factor.
`support_yield_strength_ratio`	Knockdown factor that is used to adjust the strength of the support material in comparison to the solid material.
`thermal_expansion_coefficient`	Coefficient of thermal expansion (1/K).
`vaporization_temperature`	Temperature (K) at which the material has completely changed from liquid to vapor.
`characteristic_width_data`	List of characteristic width data points.
`thermal_properties_data`	List of thermal properties data points.

Import detail#

from ansys.additive.core.material import AdditiveMaterial

Property detail#

property AdditiveMaterial.absorptivity_maximum: float#: Absorptivity maximum.

property AdditiveMaterial.absorptivity_minimum: float#: Absorptivity minimum.

property AdditiveMaterial.absorptivity_powder_coefficient_a: float#: Absorptivity powder coefficient a.

property AdditiveMaterial.absorptivity_powder_coefficient_b: float#: Absorptivity powder coefficient b.

property AdditiveMaterial.absorptivity_solid_coefficient_a: float#: Absorptivity solid coefficient a.

property AdditiveMaterial.absorptivity_solid_coefficient_b: float#: Absorptivity solid coefficient b.

property AdditiveMaterial.anisotropic_strain_coefficient_parallel: float#: Multiplier on the predicted strain in the direction that the laser is scanning for the major fill rasters.

property AdditiveMaterial.anisotropic_strain_coefficient_perpendicular: float#: Multiplier on the predicted strain orthogonal to the direction that the laser is scanning for the major fill rasters and in the plane of the surface of the build plate.

property AdditiveMaterial.anisotropic_strain_coefficient_z: float#: Multiplier on the predicted strain in the Z direction.

property AdditiveMaterial.elastic_modulus: float#: Elastic modulus (Pa).

property AdditiveMaterial.hardening_factor: float#: Factor relating the elastic modulus to the tangent modulus for plasticity simulations (tangent modulus = elastic modulus * hardening factor).

property AdditiveMaterial.liquidus_temperature: float#: Minimum temperature (K) at which the material is completely liquid.

property AdditiveMaterial.material_yield_strength: float#: Material yield strength (Pa).

property AdditiveMaterial.name: str#: Name of the material.

property AdditiveMaterial.nucleation_constant_bulk: float#: Controls the homogeneous nucleation rate (in bulk of the microstructure simulation domain) during solidification (1/m^2/K^2).

property AdditiveMaterial.nucleation_constant_interface: float#: Heterogeneous nucleation rate (on existing solid interfaces) during solidification (1/m/K^2).

property AdditiveMaterial.penetration_depth_maximum: float#: Penetration depth maximum.

property AdditiveMaterial.penetration_depth_minimum: float#: Penetration depth minimum.

property AdditiveMaterial.penetration_depth_powder_coefficient_a: float#: Penetration depth powder coefficient a.

property AdditiveMaterial.penetration_depth_powder_coefficient_b: float#: Penetration depth powder coefficient b.

property AdditiveMaterial.penetration_depth_solid_coefficient_a: float#: Penetration depth solid coefficient a.

property AdditiveMaterial.penetration_depth_solid_coefficient_b: float#: Penetration depth solid coefficient b.

property AdditiveMaterial.poisson_ratio: float#: Poisson ratio.

property AdditiveMaterial.powder_packing_density: float#: Density of powder material relative to the solid.

property AdditiveMaterial.purging_gas_convection_coefficient: float#: Convection coefficient between the solid and gas during build.

property AdditiveMaterial.solid_density_at_room_temperature: float#: Density of bulk material at room temperature, 298 K (kg/m^3).

property AdditiveMaterial.solid_specific_heat_at_room_temperature: float#: Specific heat of bulk material at room temperature, 298 K (J/kg/K).

property AdditiveMaterial.solid_thermal_conductivity_at_room_temperature: float#: Thermal conductivity of bulk material at room temperature, 298 K (W/m/K).

property AdditiveMaterial.solidus_temperature: float#: Maximum temperature (K) at which the material is completely solid.

property AdditiveMaterial.strain_scaling_factor: float#: Strain scaling factor.

property AdditiveMaterial.support_yield_strength_ratio: float#

Knockdown factor that is used to adjust the strength of the support material in comparison to the solid material.

The factor is multiplied by the support material’s yield strength and elastic modulus. A value of 1.0, for example, results in support strength equal to the solid material, whereas 0.5 is half the strength of the solid material.

property AdditiveMaterial.thermal_expansion_coefficient: float#: Coefficient of thermal expansion (1/K).

property AdditiveMaterial.vaporization_temperature: float#: Temperature (K) at which the material has completely changed from liquid to vapor.

property AdditiveMaterial.characteristic_width_data: list[CharacteristicWidthDataPoint]#: List of characteristic width data points.

property AdditiveMaterial.thermal_properties_data: list[ThermalPropertiesDataPoint]#: List of thermal properties data points.

The material.py module#

Summary#

Description#

Module detail#

Overview#

Import detail#

Property detail#

Overview#

Import detail#

Property detail#

Overview#

Import detail#

Property detail#

The `material.py` module#