Module “equilibrium”

class tc_python.process_metallurgy.equilibrium.AbstractEquilibriumAddition

Bases: tc_python.process_metallurgy.base.AbstractAddition

The base class for representing an addition to an equilibrium calculation.

set_amount(amount: float)

Change the amount of the addition.

Parameters

amount – The new amount [in the amount unit of this addition]

Returns

This AbstractEquilibriumAddition object

set_component_composition(component: str, content: float)

Change the composition of a component of the addition.

Parameters
  • component – The component to be changed

  • content – The new content of the component [in the composition unit defined for this addition]

Returns

This AbstractEquilibriumAddition object

class tc_python.process_metallurgy.equilibrium.AdiabaticEquilibriumCalculation(calculator)

Bases: tc_python.process_metallurgy.equilibrium.EquilibriumCalculation

An adiabatic Process Metallurgy equilibrium calculation. Such calculations can for example be used to determine the global equilibrium state of a process.

add_addition(addition: tc_python.process_metallurgy.equilibrium.AbstractEquilibriumAddition)

Adds an addition to the calculation.

Parameters

addition – A EquilibriumAddition or EquilibriumGasAddition

Returns

This AdiabaticEquilibriumCalculation object

add_poly_command(command: str)

Adds a Thermo-Calc Console syntax POLY module command which will be executed when performing the calculation using the calculate() method.

If multiple commands are added, they will be executed in the order of addition. Each command will only be executed one.

Note

It should not be necessary for most users to use this method, try to use the corresponding method implemented in the API instead.

Warning

As this method runs raw Thermo-Calc commands directly in the engine, it may hang the program in case of spelling mistakes (e.g. forgotten equals sign).

Parameters

command – The POLY module command in Thermo-Calc console syntax

Returns

This AdiabaticEquilibriumCalculation object

calculate(timeout_in_minutes: float = 0.0)tc_python.process_metallurgy.equilibrium.EquilibriumResult

Runs the Process Metallurgy equilibrium calculation.

Parameters

timeout_in_minutes – The calculation will be aborted after that time, default: no timeout

Returns

A new EquilibriumResult object

remove_addition(addition: tc_python.process_metallurgy.equilibrium.AbstractEquilibriumAddition)

Removes an addition from the calculation.

Parameters

addition – The addition to be removed

Returns

This AdiabaticEquilibriumCalculation object

remove_all_additions()

Removes all additions from the calculation.

Returns

This AdiabaticEquilibriumCalculation object

set_pressure(pressure: float = 100000.0)

Sets the pressure.

Parameters

pressure – The pressure [Pa]

Returns

This AdiabaticEquilibriumCalculation object

with_options(options: tc_python.process_metallurgy.base.ProcessMetallurgyOptions)

Sets the options for the calculation.

Parameters

options – The options

Returns

This AdiabaticEquilibriumCalculation object

class tc_python.process_metallurgy.equilibrium.EquilibriumAddition(composition: Dict[str, float], amount: float, temperature: float = 293.15, composition_unit: tc_python.utils.CompositionUnit = <CompositionUnit.MASS_PERCENT: 0>, do_scale: bool = False)

Bases: tc_python.process_metallurgy.equilibrium.AbstractEquilibriumAddition

An addition to an equilibrium calculation.

Tip

By setting do_scale=True, the composition will be scaled to 100% / fraction of 1. This is useful if the composition provided is not summing to 100% / 1. An example could be a slag addition which is provided like this: 90 wt-% CaO - 5 wt-% Al2O3 - 4 wt-% SiO2.

Parameters
  • composition – The composition

  • amount – The amount [kg]

  • temperature – The initial addition temperature (default: 20 °C) [K]

  • composition_unit – The composition unit

  • do_scale – If the composition is scaled to 100% / fraction of 1

get_amount() → float

Returns the amount of this addition.

Returns

The amount [kg]

get_composition_unit()tc_python.utils.CompositionUnit

Returns the composition unit used in this addition.

Returns

The composition unit

class tc_python.process_metallurgy.equilibrium.EquilibriumCalculation(metallurgical_reaction)

Bases: object

A Process Metallurgy equilibrium calculation. Such calculations can for example be used to determine the global equilibrium state of a process.

abstract add_addition(addition: tc_python.process_metallurgy.equilibrium.AbstractEquilibriumAddition)

Adds an addition to the calculation.

Parameters

addition – The addition

Returns

This EquilibriumCalculation object

abstract add_poly_command(command: str)

Adds a Thermo-Calc Console syntax POLY module command which will be executed when performing the calculation using the calculate() method.

If multiple commands are added, they will be executed in the order of addition. Each command will only be executed one.

Note

It should not be necessary for most users to use this method, try to use the corresponding method implemented in the API instead.

Warning

As this method runs raw Thermo-Calc commands directly in the engine, it may hang the program in case of spelling mistakes (e.g. forgotten equals sign).

Parameters

command – The POLY module command in Thermo-Calc console syntax

Returns

This EquilibriumCalculation object

abstract calculate(timeout_in_minutes: float = 0.0)tc_python.process_metallurgy.equilibrium.EquilibriumResult

Runs the Process Metallurgy equilibrium calculation.

Parameters

timeout_in_minutes – The calculation will be aborted after that time, default: no timeout

Returns

A new EquilibriumResult object

abstract remove_addition(addition: tc_python.process_metallurgy.equilibrium.AbstractEquilibriumAddition)

Removes an addition from the calculation.

Parameters

addition – The addition to be removed

Returns

This EquilibriumCalculation object

abstract remove_all_additions()

Removes all additions from the calculation.

Returns

This EquilibriumCalculation object

abstract set_pressure(pressure: float = 100000.0)

Sets the pressure.

Parameters

pressure – The pressure [Pa]

Returns

This EquilibriumCalculation object

update_addition(addition: tc_python.process_metallurgy.equilibrium.AbstractEquilibriumAddition)

Replaces an already added addition with an updated one. This is usually used to change the composition or amount of an addition while iterating over them. Typically, this is done for stepping or mapping calculations.

Note

The calculation must already contain the addition object to be updated.

Parameters

addition – The new addition containing updated values

Returns

This IsoThermalMetallurgyCalculation object

abstract with_options(options: tc_python.process_metallurgy.base.ProcessMetallurgyOptions)

Sets the options for the calculation.

Parameters

options – The options

Returns

This EquilibriumCalculation object

class tc_python.process_metallurgy.equilibrium.EquilibriumGasAddition(composition: Dict[str, float], amount: float, temperature: float = 293.15, amount_unit: tc_python.utils.GasAmountUnit = <GasAmountUnit.NORM_CUBIC_METER: 0>, composition_unit: tc_python.utils.GasCompositionUnit = <GasCompositionUnit.VOLUME_PERCENT: 4>, do_scale: bool = False)

Bases: tc_python.process_metallurgy.equilibrium.AbstractEquilibriumAddition

A gas addition to an equilibrium calculation.

Tip

By setting do_scale=True, the composition will be scaled to 100% / fraction of 1. This is useful if the composition provided is not summing to 100% / 1. An example could be a gas addition which is provided like this: 90 vol–% Ar - 10 vol-% O2.

get_amount() → float

Returns the amount of this addition.

Note

The amount unit can be obtained using get_amount_unit().

Returns

The amount [in the amount unit]

get_amount_unit()tc_python.utils.GasAmountUnit

Returns the amount unit used in this addition.

Returns

The amount unit

get_composition_unit()tc_python.utils.GasCompositionUnit

Returns the composition unit used in this addition.

Returns

The composition unit

class tc_python.process_metallurgy.equilibrium.EquilibriumResult(result)

Bases: tc_python.abstract_base.AbstractResult

The result of a Process Metallurgy equilibrium calculation.

get_activity_of_slag(component: str, reference: tc_python.process_metallurgy.base.ActivityReference = <ActivityReference.LIQUID: 1>) → float

Returns the activity of a component in the slag.

Parameters
  • component – The component

  • reference – The reference for the activity, can be liquid or solid slag, default: liquid slag

Returns

The activity of the component [-]

get_amount() → float

Returns the total amount.

Returns

The total amount [kg]

get_amount_of_elements() → Dict[str, float]

Returns the amount of each element.

Returns

The amount of the elements [kg]

get_amount_of_phase_groups() → Dict[tc_python.process_metallurgy.base.PhaseGroup, float]

Returns the amount of each phase group (e.g., for example all liquid slag).

Returns

The amount of the phase groups [kg]

get_amount_of_phases() → Dict[str, float]

Returns the amount of each phase.

Returns

The amount of the phases [kg]

get_components() → Set[str]

Returns all components defined for the elements present in this result.

Returns

The components present in this result

get_composition(composition_unit: tc_python.utils.CompositionUnit = <CompositionUnit.MASS_PERCENT: 0>) → Dict[str, float]

Returns the composition of the result.

Parameters

composition_unit – The composition unit, default: mass percent

Returns

The composition

get_composition_of_phase(phase: str, composition_unit: tc_python.utils.CompositionUnit = <CompositionUnit.MASS_PERCENT: 0>, composition_type: tc_python.utils.CompositionType = <CompositionType.COMPONENT: 1>) → Dict[str, float]

Returns the composition of a phase in the result.

Parameters
  • phase – The phase name

  • composition_unit – The composition unit, default: mass percent

  • composition_type – Defines if the composition is given by element (e.g., 75 wt-% Fe - 25 wt-% Cr) or by component (e.g. 65 wt-% Al2O3 - 35 wt-% CaO). In case of a metallic phase, the composition is given by element even if component is selected. Default: by component.

Returns

The composition

get_composition_of_phase_group(phase_group: tc_python.process_metallurgy.base.PhaseGroup, composition_unit: tc_python.utils.CompositionUnit = <CompositionUnit.MASS_PERCENT: 0>, composition_type: tc_python.utils.CompositionType = <CompositionType.COMPONENT: 1>) → Dict[str, float]

Returns the composition of a phase group (e.g., all liquid slag) in the result.

Parameters
  • phase_group – The phase group

  • composition_unit – The composition unit, default: mass percent

  • composition_type – Defines if the composition is given by element (e.g., 75 wt-% Fe - 25 wt-% Cr) or by component (e.g. 65 wt-% Al2O3 - 35 wt-% CaO). In case of a metallic phase, the composition is given by element even if component is selected. Default: by component.

Returns

The composition

get_elements() → Set[str]

Returns all elements defined for the result.

Returns

All elements present in this result

get_formula_for_activity_of_slag(component: str, reference: tc_python.process_metallurgy.base.ActivityReference = <ActivityReference.LIQUID: 1>) → str

Returns the Thermo-Calc Console syntax formula used for calculating the activity of a component in the slag (e.g. AC(AL2O3, IONIC_LIQ). The actual activity can be obtained using get_activity_of_slag().

Parameters
  • component – The component

  • reference – The reference for the activity, can be liquid or solid slag, default: liquid slag

Returns

The formula for calculating the activity

get_formula_for_slag_property(slag_property: tc_python.process_metallurgy.base.SlagProperty, slag_type: tc_python.process_metallurgy.base.SlagType = <SlagType.ALL: 2>) → str

Returns the Thermo-Calc Console syntax formula used for calculating a property of the slag (e.g. B(CAO)/B(SIO2). The actual slag property can be obtained using get_slag_property().

Parameters
  • slag_property – The slag property

  • slag_type – The part of the slag for which the property will be calculated. Can be all slag, the liquid or the solid slag. Default: all slag

Returns

The formula for calculating the slag property

get_fraction_of_phase_groups(unit: tc_python.utils.PhaseUnit = <PhaseUnit.MASS_FRACTION: 1>) → Dict[tc_python.process_metallurgy.base.PhaseGroup, float]

Returns the fraction of the phase groups (e.g., all liquid slag) in the result.

Parameters

unit – The unit of the fraction, default: volume fraction

Returns

The phase fractions

get_fraction_of_phases(unit: tc_python.utils.PhaseUnit = <PhaseUnit.MASS_FRACTION: 1>) → Dict[str, float]

Returns the fraction of the stable phases in the result.

Parameters

unit – The unit of the fraction, default: volume fraction

Returns

The phase fractions

get_gas_components() → Set[str]

Returns all components of the gas phase defined for the elements present in this result.

Returns

The components of the gas phase present in this result

get_oxygen_partial_pressure() → float

Returns the partial pressure of oxygen in the result.

Returns

The partial pressure [Pa]

get_pressure() → float

Returns the pressure in the result.

Returns

The pressure [Pa]

get_slag_property(slag_property: tc_python.process_metallurgy.base.SlagProperty, slag_type: tc_python.process_metallurgy.base.SlagType = <SlagType.ALL: 2>) → float

Returns a property of the slag. These properties are mostly used to describe the property of a slag to pick up sulfur.

Parameters
  • slag_property – The slag property

  • slag_type – The part of the slag for which the property will be calculated. Can be all slag, the liquid or the solid slag. Default: all slag

Returns

The slag property [unit depending on the property]

get_stable_phases() → Set[str]

Returns the stable phases in the result.

Returns

The stable phases

get_stable_phases_in_phase_group(phase_group: tc_python.process_metallurgy.base.PhaseGroup) → Set[str]

Returns the stable phases of a phase group (e.g., all liquid slag) in the result.

Parameters

phase_group – The phase group

Returns

The stable phases

get_temperature() → float

Returns the temperature in the result.

Returns

The temperature [K]

get_value_of(classic_expression: str) → float

Returns a value for a thermodynamic quantity.

Warning

It should normally not be required to use this method, use the appropriate method available in the API instead.

Parameters

classic_expression – The thermodynamic quantity to get the value of in Thermo-Calc Console Mode syntax (for example “NPM(FCC_A1)”)

Returns

The requested value

get_viscosity_dynamic_of_phase(phase: str) → float

Returns the dynamic viscosity of a phase in the result.

Parameters

phase – The phase name

Returns

The dynamic viscosity [Pa*s]

get_viscosity_kinematic_of_phase(phase: str) → float

Returns the kinematic viscosity of a phase in the result.

Parameters

phase – The phase name

Returns

The kinematic viscosity [m**2/s]

class tc_python.process_metallurgy.equilibrium.IsoThermalEquilibriumCalculation(calculation)

Bases: tc_python.process_metallurgy.equilibrium.EquilibriumCalculation

An isothermal Process Metallurgy equilibrium calculation. Such calculations can for example be used to determine the global equilibrium state of a process.

add_addition(addition: tc_python.process_metallurgy.equilibrium.AbstractEquilibriumAddition)

Adds an addition to the calculation.

Parameters

addition – A EquilibriumAddition or EquilibriumGasAddition

Returns

This IsoThermalEquilibriumCalculation object

add_poly_command(command: str)

Adds a Thermo-Calc Console syntax POLY module command which will be executed when performing the calculation using the calculate() method.

If multiple commands are added, they will be executed in the order of addition. Each command will only be executed one.

Note

It should not be necessary for most users to use this method, try to use the corresponding method implemented in the API instead.

Warning

As this method runs raw Thermo-Calc commands directly in the engine, it may hang the program in case of spelling mistakes (e.g. forgotten equals sign).

Parameters

command – The POLY module command in Thermo-Calc console syntax

Returns

This IsoThermalEquilibriumCalculation object

calculate(timeout_in_minutes: float = 0.0)tc_python.process_metallurgy.equilibrium.EquilibriumResult

Runs the Process Metallurgy equilibrium calculation.

Parameters

timeout_in_minutes – The calculation will be aborted after that time, default: no timeout

Returns

A new EquilibriumResult object

remove_addition(addition: tc_python.process_metallurgy.equilibrium.AbstractEquilibriumAddition)

Removes an addition from the calculation.

Parameters

addition – The addition to be removed

Returns

This IsoThermalEquilibriumCalculation object

remove_all_additions()

Removes all additions from the calculation.

Returns

This IsoThermalEquilibriumCalculation object

set_pressure(pressure: float = 100000.0)

Sets the pressure.

Parameters

pressure – The pressure [Pa]

Returns

This IsoThermalEquilibriumCalculation object

set_temperature(temperature: float)

Sets the temperature.

Parameters

temperature – The temperature [K]

Returns

This IsoThermalEquilibriumCalculation object

update_addition(addition: tc_python.process_metallurgy.equilibrium.AbstractEquilibriumAddition)

Replaces an already added addition with an updated one.

Tip

This is usually used to change the composition or amount of an addition while iterating over multiple values. Typically, this is done for stepping or mapping calculations.

Note

The calculation must already contain the addition object to be updated.

Parameters

addition – A previously added addition object with the updated values

Returns

This IsoThermalEquilibriumCalculation object

with_options(options: tc_python.process_metallurgy.base.ProcessMetallurgyOptions)

Sets the options for the calculation.

Parameters

options – The options

Returns

This IsoThermalEquilibriumCalculation object