AdditiveMaterial#

class ansys.additive.core.material.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, description: str = '', 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 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.

description

Description of the material.

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.description: str#

Description of the material.

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.

Method detail#

AdditiveMaterial.__repr__() str#
AdditiveMaterial.__eq__(__o: object) bool#