Module “ferrite”

class tc_python.property_model_definitions.ferrite.Ferrite

Bases: object

Encapsulation class for the “Ferrite” property model Arguments, ArgumentOptions, and Results.

ArgumentOptions

alias of Ferrite_ArgumentOptions

Arguments

alias of Ferrite_Arguments

Results

alias of Ferrite_Results

classmethod get_aliases() → list[str]

List of aliases for “Ferrite” property model.

classmethod get_name() → str

String name of “Ferrite” property model.

class tc_python.property_model_definitions.ferrite.Ferrite_ArgumentOptions

Bases: object

Valid entries for Ferrite property model arguments which requires specific options to be entered.

AUSTENITE_COMPOSITION

alias of Ferrite_ArgumentOptions_AUSTENITE_COMPOSITION

GROWTH_MODE

alias of Ferrite_ArgumentOptions_GROWTH_MODE

class tc_python.property_model_definitions.ferrite.Ferrite_ArgumentOptions_AUSTENITE_COMPOSITION

Bases: ArgumentBase

Valid options for Ferrite_Arguments.AUSTENITE_COMPOSITION.

EQUILIBRIUM = 'Equilibrium composition'

  • Use equilibrium composition at the specified austenitizing temperature.

NOMINAL = 'Nominal composition'

  • Use nominal alloy composition as austenite composition.

class tc_python.property_model_definitions.ferrite.Ferrite_ArgumentOptions_GROWTH_MODE

Bases: ArgumentBase

Valid options for Ferrite_Arguments.GROWTH_MODE.

NPLE = 'Negligible-partitioning local equilibrium (NPLE)'

  • Negligible-partitioning local equilibrium (NPLE).

OE = 'Orthoequilibrium (OE)'

  • Orthoequilibrium (OE).

OP = 'Orthoprecipitate (OP)'

  • Orthoprecipitate (OP).

  • Austenite interfacial composition being the bulk composition, ferrite interfacial composition from the maximum driving force condition (parallel tangent construction in Gibbs energy-composition diagram).

PE = 'Paraequilibrium (PE)'

  • Paraequilibrium (PE).

PP = 'Paraprecipitate (PP)'

  • Paraprecipitate (PP).

  • Only carbon is allowed to partition, otherwise the same as OP.

class tc_python.property_model_definitions.ferrite.Ferrite_Arguments

Bases: ArgumentBase

Valid entries for Ferrite property model arguments.

AUSTENITE_COMPOSITION = 'Austenite composition from'

  • Choose the source for austenite composition.

Argument options:

Ferrite_ArgumentOptions_AUSTENITE_COMPOSITION

Default value:

Ferrite_ArgumentOptions_AUSTENITE_COMPOSITION.NOMINAL

AUSTENITIZING_TEMPERATURE = 'Annealing temperature'
Default value:

1000.0 [K]

CUSTOM_PARAMETERS = 'Custom parameters'

  • Option to apply custom parameters for nucleation rate model and interfacial mobility model.

Argument options:

True, False

Default value:

False

EDGE_ENERGY = 'Edge surface energy [J/m^2]'

  • Surface energy of pillbox edge (see reference for details).

Default value:

0.02 [J/m^2]

EPSILON = 'Epsilon [J/m^2]'

  • A term of surface energy change (see reference for details).

Default value:

0.007 [J/m^2]

EVALUATION_TEMPERATURE = 'Evaluation temperature'

  • Temperature at which the property evaluation occurs, corresponds to the measurement temperature.

  • This argument can also be set with:meth:PropertyModelCalculation.set_temperature(PropertyModelQuantity.evaluation_temperature()).

Default value:

1000.0 [K]

GRAIN_SIZE = 'GrainSize'

  • Grain size of the austenite phase in micrometers.

Default value:

100.0 [μm]

GROWTH_MODE = 'Growth mode'

  • This argument defines how ferrite and austenite compositions at the interface are solved.

Argument options:

Ferrite_ArgumentOptions_GROWTH_MODE

Default value:

Ferrite_ArgumentOptions_GROWTH_MODE.OE

MAX_DELTA_X_ABS = 'Maximum change of phase fraction (absolute)'

  • Absolute maximum change of phase fraction allowed per time step.

Default value:

5e-3

MAX_DELTA_X_REL = 'Maximum change of phase fraction (relative)'

  • Relative maximum change of phase fraction allowed per time step.

Default value:

5e-3

MOBILITY_ACTIVATION_ENERGY = 'Interfacial mobility activation energy [J/mol]'

  • Activation energy in an Arrhenius equation for interfacial mobility.

Default value:

0.0

MOBILITY_PREFACTOR = 'Interfacial mobility prefactor [m mol/(J s)]'

  • Pre-exponential factor in the Arrhenius equation for interfacial mobility.

Default value:

“Infinity”

PHASE_ADDITION = 'Phase addition'

  • Gibbs energy addition applied to ferrite phase [J/mol] (substitutional elements).

Default value:

0.0 [J/mol]

SITE_DENSITY = 'Site density [1/m^2]'

  • Number of ferrite nucleation sites per unit area of austenite grain boundary.

Default value:

1e6 [1/m^2]

SKIP_TIME_INTEGRATION = 'Skip time integration'

  • Option to skip time integration which is usually time-consuming.

  • If True, ferrite start/half/finish times will not be solved for.

Argument options:

True, False

Default value:

False

class tc_python.property_model_definitions.ferrite.Ferrite_Results

Bases: ArgumentBase

Valid entries for Ferrite property model results.

ALPHA = 'Parabolic growth rate constant [m/s^(1/2)]'

  • Parabolic growth rate constant [m/s^(1/2)].

DRIVING_FORCE = 'Driving force [J/mol]'

  • Driving force for ferrite transformation.

FINISH_TIME = 'Ferrite finish'

  • Time to reach 98% ferrite fraction (absolute).

FINISH_TIME_REL = 'Ferrite finish (relative)'

  • Time to reach 98% of final ferrite fraction (relative).

HALF_TIME = 'Ferrite half'

  • Time to reach 50% ferrite fraction (absolute).

HALF_TIME_REL = 'Ferrite half (relative)'

  • Time to reach 50% of final ferrite fraction (relative).

MOLE_FRACTION_FERRITE = 'Ferrite molar fraction (OE or PE)'

  • Ferrite mole fraction calculated using selected growth mode.

NUCLEATION_RATE = 'Nucleation rate [1/(m^2 s)]'

  • Nucleation rate on austenite grain boundaries.

START_TIME = 'Ferrite start'

  • Time to reach 2% ferrite fraction (absolute).

START_TIME_REL = 'Ferrite start (relative)'

  • Time to reach 2% of final ferrite fraction (relative).