The material.py
module#
Summary#
Provides the container for a characteristic width data point. |
|
|
Provides the container for temperature-dependent properties. |
|
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#
Characteristic melt pool width for a given laser power and scan |
|
Laser power (W). |
|
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).
- 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#
Density (kg/m^3). |
|
Density ratio. |
|
Specific heat (J/kg/K). |
|
Specific heat ratio. |
|
Temperature (K). |
|
Thermal conductivity (W/m/K). |
|
Thermal conductivity ratio. |
Import detail#
from ansys.additive.core.material import ThermalPropertiesDataPoint
Property detail#
- 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#
Absorptivity maximum. |
|
Absorptivity minimum. |
|
Absorptivity powder coefficient a. |
|
Absorptivity powder coefficient b. |
|
Absorptivity solid coefficient a. |
|
Absorptivity solid coefficient b. |
|
Multiplier on the predicted strain in the direction that the laser is scanning for the major fill rasters. |
|
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. |
|
Multiplier on the predicted strain in the Z direction. |
|
Elastic modulus (Pa). |
|
Factor relating the elastic modulus to the tangent modulus for plasticity simulations (tangent modulus = elastic modulus * hardening factor). |
|
Minimum temperature (K) at which the material is completely liquid. |
|
Material yield strength (Pa). |
|
Name of the material. |
|
Controls the homogeneous nucleation rate (in bulk of the microstructure simulation domain) during solidification (1/m^2/K^2). |
|
Heterogeneous nucleation rate (on existing solid interfaces) during solidification (1/m/K^2). |
|
Penetration depth maximum. |
|
Penetration depth minimum. |
|
Penetration depth powder coefficient a. |
|
Penetration depth powder coefficient b. |
|
Penetration depth solid coefficient a. |
|
Penetration depth solid coefficient b. |
|
Poisson ratio. |
|
Density of powder material relative to the solid. |
|
Convection coefficient between the solid and gas during build. |
|
Density of bulk material at room temperature, 298 K (kg/m^3). |
|
Specific heat of bulk material at room temperature, 298 K (J/kg/K). |
|
Thermal conductivity of bulk material at room temperature, 298 K (W/m/K). |
|
Maximum temperature (K) at which the material is completely solid. |
|
Strain scaling factor. |
|
Knockdown factor that is used to adjust the strength of the support material in comparison to the solid material. |
|
Coefficient of thermal expansion (1/K). |
|
Temperature (K) at which the material has completely changed from liquid to vapor. |
|
List of characteristic width data points. |
|
List of thermal properties data points. |
Import detail#
from ansys.additive.core.material import AdditiveMaterial
Property detail#
- 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.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.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_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.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.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.