Skip to content

Steps

Module: xfea.problem.steps

Analysis steps: static, dynamic and heat transfer steps, perturbations (modal, buckling), and contact controls.

ContactControls(
    step_growth_threshold: int = 20,
    max_divergences: int = 25,
    target_iterations: int = 9,
    soft_cutback_limit: int = 40,
    step_growth_bound: int = 16,
    fast_growth_trigger: int = 6,
    cutback_factor: int = 5,
    residual_tolerance: float = 0.02,
    correction_tolerance: float = 0.05,
    zero_load_tolerance: float = 0.1,
    stabilize: bool | float | None = None,
)

The solver’s convergence settings for a step with contact, written as its *CONTROLS.

Pass them as a step’s contact_controls. They apply only when the model has a contact interface; a step with contact and none given gets ContactControls(). Each setting fills one position of the solver’s *CONTROLS lines (see Notes); some names are older than that mapping and say less than the position does.

Parameters

Name Type Description
step_growth_threshold int, optional I0 (default 20): the iteration after which an increment whose residual grows twice running is cut back.
max_divergences int, optional IR (default 25): the iteration from which the solver checks the convergence rate and cuts back a slow increment.
target_iterations int, optional IP (default 9): the iteration after which the looser residual criterion Rp replaces Rn.
soft_cutback_limit int, optional IC (default 40): the most iterations an increment may take.
step_growth_bound int, optional IL (default 16): above this many iterations, the next increment is made smaller.
fast_growth_trigger int, optional IG (default 6): at most this many iterations in two increments running, and the next is made larger.
cutback_factor int, optional IA (default 5): the most cutbacks one increment may have (a count, not a factor).
residual_tolerance float, optional Rn (default 0.02): converged when the largest residual force is below this fraction of the average force.
correction_tolerance float, optional Cn (default 0.05): converged when the largest displacement correction is below this fraction of the increment’s largest displacement.
zero_load_tolerance float, optional epsilon (default 0.10): forces below this fraction of the average force count as zero.
stabilize bool or float, optional Contact stabilisation, for solvers that have it: not written by the solver plugin.
Properties
field_displacement_linestrread-only

The data line of *CONTROLS, PARAMETERS=FIELD, FIELD=DISPLACEMENT: Rn, Cn, (blank), (blank), (blank), epsilon.

time_incrementation_linestrread-only

The data line of *CONTROLS, PARAMETERS=TIME INCREMENTATION: I0, IR, IP, IC, IL, IG, (IS blank), IA.

StaticStep(
    max_increments=100,
    initial_inc_size=1.0,
    min_inc_size=1e-05,
    max_inc_size=1,
    time=1,
    nlgeom=False,
    modify=True,
    contact_controls=None,
    **kwargs,
)

A static step: loads applied slowly enough that inertia plays no part, solved for equilibrium.

Linear unless the model makes it nonlinear (contact, one-sided springs, plasticity) or nlgeom is set; a nonlinear step is solved in increments of step time, the solver cutting them back when one does not converge. Add it with add_step(), then its loads.

Parameters

Name Type Description
max_increments int, optional The most increments the solver may take (default 100); the step fails if it needs more.
initial_inc_size float, optional The first increment, in step time (default 1.0): the whole load at once.
min_inc_size float, optional The smallest increment, in step time (default 1e-5); the step fails if the solver must cut below it.
max_inc_size float, optional The largest increment, in step time (default 1).
time float, optional The step’s length in step time (default 1), a load factor here, not seconds.
nlgeom bool, optional If True, solve with geometric nonlinearity (large displacements and rotations).
modify bool, optional Whether this step’s loads replace (True, default) or add to those of the step before; kept, not used by the solver plugin.
contact_controls ContactControls, optional The solver’s convergence settings for a step with contact: None uses the defaults.
name str, optional The step’s name, unique in its problem; one is generated if not given.

Guidance (steps)

  • With contact, a small model converges fastest in one increment (the default). A large one (tens of thousands of elements) can converge faster from initial_inc_size=0.1.
  • Cutbacks repeating at the same increment point to a physical issue (a mechanism, a missing support), not a numerical one. Unsupported bodies need ContactControls(max_divergences=...) above 10.
Properties
amplitudesread-only

The amplitudes of the step’s loads, a set, or None if it has no fields.

combinationread-only

The step’s load combination, or None (see add_combination()).

combined_fieldsdict | Noneread-only

The effective fields summed by kind: {field type: one ForceField}; raises ValueError if there are none.

contact_controlsContactControls | Noneread-only

The step’s convergence settings for contact, or None for the defaults (ContactControls()).

The solver plugin writes them as *CONTROLS only when the model has a contact interface; without contact they have no effect.

displacementsread-only

The step’s imposed displacement fields, a list, or None if it has no fields.

effective_fieldsLoadsFieldGroup | Noneread-only

The fields the solver gets: the step’s fields, factored by its load combination if it has one: None if none.

field_outputsread-only

The field results asked for in this step, a set.

fieldsread-only

The step’s load, displacement and temperature fields, a LoadsFieldGroup, or None.

history_outputsread-only

The history results asked for in this step, a set.

initial_inc_sizeread-only

The first increment, in step time.

keyAny | Noneread-only

The object’s key (its number) in what it is registered to; None until it is given one.

load_casesset[str] | Noneread-only

The names of the load cases the step’s fields belong to, or None if it has no fields.

loadsread-only

The step’s force and gravity fields, a list, or None if it has no fields.

max_inc_sizeread-only

The largest increment, in step time.

max_incrementsread-only

The most increments the solver may take.

min_inc_sizeread-only

The smallest increment, in step time.

modelModel | Noneread-only

The model of the step’s problem.

modifyread-only

Whether this step’s loads replace those of the step before (kept, not used by the solver plugin).

namestr

The object’s name.

nlgeomread-only

Whether the step is solved with geometric nonlinearity.

problemProblemread-only

The problem the step is in; raises AttributeError if it is in none.

registrationAny | None

The object this one is registered to (a part, a model, a step, …), or None.

restart

Every how many increments restart data is written: False for none.

timeread-only

The step’s length, in step time.

uidUUID | Noneread-only

The object’s unique id, a UUID.

StaticRiksStep(
    max_increments=100,
    initial_inc_size=1,
    min_inc_size=1e-05,
    time=1,
    nlgeom=False,
    modify=True,
    **kwargs,
)

A static step solved by the Riks (arc-length) method, to follow a load path past a peak load.

Parameters

Name Type Description
max_increments, initial_inc_size, min_inc_size, time, nlgeom, modify As for StaticStep.
Properties
amplitudesread-only

The amplitudes of the step’s loads, a set, or None if it has no fields.

combinationread-only

The step’s load combination, or None (see add_combination()).

combined_fieldsdict | Noneread-only

The effective fields summed by kind: {field type: one ForceField}; raises ValueError if there are none.

contact_controlsContactControls | Noneread-only

The step’s convergence settings for contact, or None for the defaults (ContactControls()).

The solver plugin writes them as *CONTROLS only when the model has a contact interface; without contact they have no effect.

displacementsread-only

The step’s imposed displacement fields, a list, or None if it has no fields.

effective_fieldsLoadsFieldGroup | Noneread-only

The fields the solver gets: the step’s fields, factored by its load combination if it has one: None if none.

field_outputsread-only

The field results asked for in this step, a set.

fieldsread-only

The step’s load, displacement and temperature fields, a LoadsFieldGroup, or None.

history_outputsread-only

The history results asked for in this step, a set.

initial_inc_sizeread-only

The first increment, in step time.

keyAny | Noneread-only

The object’s key (its number) in what it is registered to; None until it is given one.

load_casesset[str] | Noneread-only

The names of the load cases the step’s fields belong to, or None if it has no fields.

loadsread-only

The step’s force and gravity fields, a list, or None if it has no fields.

max_inc_sizeread-only

The largest increment, in step time.

max_incrementsread-only

The most increments the solver may take.

min_inc_sizeread-only

The smallest increment, in step time.

modelModel | Noneread-only

The model of the step’s problem.

modifyread-only

Whether this step’s loads replace those of the step before (kept, not used by the solver plugin).

namestr

The object’s name.

nlgeomread-only

Whether the step is solved with geometric nonlinearity.

problemProblemread-only

The problem the step is in; raises AttributeError if it is in none.

registrationAny | None

The object this one is registered to (a part, a model, a step, …), or None.

restart

Every how many increments restart data is written: False for none.

timeread-only

The step’s length, in step time.

uidUUID | Noneread-only

The object’s unique id, a UUID.

DynamicStep(**kwargs)

A dynamic step: loads that vary in time, with the model’s inertia; time is real time.

Takes the settings of GeneralStep, all as keywords (max_increments, initial_inc_size, min_inc_size, max_inc_size, time, …), none of them with a default here.

Properties
amplitudesread-only

The amplitudes of the step’s loads, a set, or None if it has no fields.

combinationread-only

The step’s load combination, or None (see add_combination()).

combined_fieldsdict | Noneread-only

The effective fields summed by kind: {field type: one ForceField}; raises ValueError if there are none.

contact_controlsContactControls | Noneread-only

The step’s convergence settings for contact, or None for the defaults (ContactControls()).

The solver plugin writes them as *CONTROLS only when the model has a contact interface; without contact they have no effect.

displacementsread-only

The step’s imposed displacement fields, a list, or None if it has no fields.

effective_fieldsLoadsFieldGroup | Noneread-only

The fields the solver gets: the step’s fields, factored by its load combination if it has one: None if none.

field_outputsread-only

The field results asked for in this step, a set.

fieldsread-only

The step’s load, displacement and temperature fields, a LoadsFieldGroup, or None.

history_outputsread-only

The history results asked for in this step, a set.

initial_inc_sizeread-only

The first increment, in step time.

keyAny | Noneread-only

The object’s key (its number) in what it is registered to; None until it is given one.

load_casesset[str] | Noneread-only

The names of the load cases the step’s fields belong to, or None if it has no fields.

loadsread-only

The step’s force and gravity fields, a list, or None if it has no fields.

max_inc_sizeread-only

The largest increment, in step time.

max_incrementsread-only

The most increments the solver may take.

min_inc_sizeread-only

The smallest increment, in step time.

modelModel | Noneread-only

The model of the step’s problem.

modifyread-only

Whether this step’s loads replace those of the step before (kept, not used by the solver plugin).

namestr

The object’s name.

nlgeomread-only

Whether the step is solved with geometric nonlinearity.

problemProblemread-only

The problem the step is in; raises AttributeError if it is in none.

registrationAny | None

The object this one is registered to (a part, a model, a step, …), or None.

restart

Every how many increments restart data is written: False for none.

timeread-only

The step’s length, in step time.

uidUUID | Noneread-only

The object’s unique id, a UUID.

QuasiStaticStep(**kwargs)

A quasi-static step: loads applied slowly, inertia neglected; the solver plugin writes it as a static step.

Takes the settings of GeneralStep, all as keywords.

Properties
amplitudesread-only

The amplitudes of the step’s loads, a set, or None if it has no fields.

combinationread-only

The step’s load combination, or None (see add_combination()).

combined_fieldsdict | Noneread-only

The effective fields summed by kind: {field type: one ForceField}; raises ValueError if there are none.

contact_controlsContactControls | Noneread-only

The step’s convergence settings for contact, or None for the defaults (ContactControls()).

The solver plugin writes them as *CONTROLS only when the model has a contact interface; without contact they have no effect.

displacementsread-only

The step’s imposed displacement fields, a list, or None if it has no fields.

effective_fieldsLoadsFieldGroup | Noneread-only

The fields the solver gets: the step’s fields, factored by its load combination if it has one: None if none.

field_outputsread-only

The field results asked for in this step, a set.

fieldsread-only

The step’s load, displacement and temperature fields, a LoadsFieldGroup, or None.

history_outputsread-only

The history results asked for in this step, a set.

initial_inc_sizeread-only

The first increment, in step time.

keyAny | Noneread-only

The object’s key (its number) in what it is registered to; None until it is given one.

load_casesset[str] | Noneread-only

The names of the load cases the step’s fields belong to, or None if it has no fields.

loadsread-only

The step’s force and gravity fields, a list, or None if it has no fields.

max_inc_sizeread-only

The largest increment, in step time.

max_incrementsread-only

The most increments the solver may take.

min_inc_sizeread-only

The smallest increment, in step time.

modelModel | Noneread-only

The model of the step’s problem.

modifyread-only

Whether this step’s loads replace those of the step before (kept, not used by the solver plugin).

namestr

The object’s name.

nlgeomread-only

Whether the step is solved with geometric nonlinearity.

problemProblemread-only

The problem the step is in; raises AttributeError if it is in none.

registrationAny | None

The object this one is registered to (a part, a model, a step, …), or None.

restart

Every how many increments restart data is written: False for none.

timeread-only

The step’s length, in step time.

uidUUID | Noneread-only

The object’s unique id, a UUID.

DirectCyclicStep(**kwargs)

A direct cyclic step: the stabilised response of a structure under a repeated load cycle.

Takes the settings of GeneralStep, all as keywords.

Properties
amplitudesread-only

The amplitudes of the step’s loads, a set, or None if it has no fields.

combinationread-only

The step’s load combination, or None (see add_combination()).

combined_fieldsdict | Noneread-only

The effective fields summed by kind: {field type: one ForceField}; raises ValueError if there are none.

contact_controlsContactControls | Noneread-only

The step’s convergence settings for contact, or None for the defaults (ContactControls()).

The solver plugin writes them as *CONTROLS only when the model has a contact interface; without contact they have no effect.

displacementsread-only

The step’s imposed displacement fields, a list, or None if it has no fields.

effective_fieldsLoadsFieldGroup | Noneread-only

The fields the solver gets: the step’s fields, factored by its load combination if it has one: None if none.

field_outputsread-only

The field results asked for in this step, a set.

fieldsread-only

The step’s load, displacement and temperature fields, a LoadsFieldGroup, or None.

history_outputsread-only

The history results asked for in this step, a set.

initial_inc_sizeread-only

The first increment, in step time.

keyAny | Noneread-only

The object’s key (its number) in what it is registered to; None until it is given one.

load_casesset[str] | Noneread-only

The names of the load cases the step’s fields belong to, or None if it has no fields.

loadsread-only

The step’s force and gravity fields, a list, or None if it has no fields.

max_inc_sizeread-only

The largest increment, in step time.

max_incrementsread-only

The most increments the solver may take.

min_inc_sizeread-only

The smallest increment, in step time.

modelModel | Noneread-only

The model of the step’s problem.

modifyread-only

Whether this step’s loads replace those of the step before (kept, not used by the solver plugin).

namestr

The object’s name.

nlgeomread-only

Whether the step is solved with geometric nonlinearity.

problemProblemread-only

The problem the step is in; raises AttributeError if it is in none.

registrationAny | None

The object this one is registered to (a part, a model, a step, …), or None.

restart

Every how many increments restart data is written: False for none.

timeread-only

The step’s length, in step time.

uidUUID | Noneread-only

The object’s unique id, a UUID.

HeatTransferStep(
    max_increments=100,
    initial_inc_size=1,
    min_inc_size=1e-05,
    max_inc_size=1,
    time=1,
    max_temp_delta=10,
    max_emiss_change=0.1,
    nlgeom=False,
    modify=True,
    restart=False,
    steady_state=False,
    **kwargs,
)

A heat transfer step: temperatures in the model from prescribed temperatures and exchanges, transient or steady.

Transient by default: time is real time (s in the usual units), and the solver chooses increments so the temperature changes by at most max_temp_delta in one. Only temperature fields can be added to it; convection and radiation come from the model’s boundary interfaces.

Parameters

Name Type Description
max_increments int, optional The most increments the solver may take (default 100).
initial_inc_size float, optional The first increment, in the step’s time unit (default 1).
min_inc_size float, optional The smallest increment (default 1e-5); the step fails if the solver must cut below it.
max_inc_size float, optional The largest increment (default 1).
time float, optional The step’s length, in the model’s time unit (default 1).
max_temp_delta float, optional The largest temperature change allowed in one increment (default 10).
max_emiss_change float, optional The largest emissivity change allowed in one increment (default 0.1); kept, not used by the solver plugin.
nlgeom bool, optional Kept for the step’s interface; it has no meaning in heat transfer.
modify bool, optional Whether this step’s temperatures replace (True, default) those of the step before; kept, not used by the solver plugin.
restart int or bool, optional Write restart data every this many increments: False (default) writes none.
steady_state bool, optional If True, solve for the steady state: time is then only a load factor.
Properties
amplitudesread-only

The amplitudes of the step’s loads, a set, or None if it has no fields.

combinationread-only

The step’s load combination, or None (see add_combination()).

combined_fieldsdict | Noneread-only

The effective fields summed by kind: {field type: one ForceField}; raises ValueError if there are none.

contact_controlsContactControls | Noneread-only

The step’s convergence settings for contact, or None for the defaults (ContactControls()).

The solver plugin writes them as *CONTROLS only when the model has a contact interface; without contact they have no effect.

displacementsread-only

The step’s imposed displacement fields, a list, or None if it has no fields.

effective_fieldsLoadsFieldGroup | Noneread-only

The fields the solver gets: the step’s fields, factored by its load combination if it has one: None if none.

field_outputsread-only

The field results asked for in this step, a set.

fieldsread-only

The step’s load, displacement and temperature fields, a LoadsFieldGroup, or None.

history_outputsread-only

The history results asked for in this step, a set.

initial_inc_sizeread-only

The first increment, in step time.

keyAny | Noneread-only

The object’s key (its number) in what it is registered to; None until it is given one.

load_casesset[str] | Noneread-only

The names of the load cases the step’s fields belong to, or None if it has no fields.

loadsread-only

The step’s force and gravity fields, a list, or None if it has no fields.

max_emiss_changeread-only

The largest emissivity change allowed in one increment.

max_inc_sizeread-only

The largest increment, in step time.

max_incrementsread-only

The most increments the solver may take.

max_temp_deltaread-only

The largest temperature change allowed in one increment.

min_inc_sizeread-only

The smallest increment, in step time.

modelModel | Noneread-only

The model of the step’s problem.

modifyread-only

Whether this step’s loads replace those of the step before (kept, not used by the solver plugin).

namestr

The object’s name.

nlgeomread-only

Whether the step is solved with geometric nonlinearity.

problemProblemread-only

The problem the step is in; raises AttributeError if it is in none.

registrationAny | None

The object this one is registered to (a part, a model, a step, …), or None.

restart

Every how many increments restart data is written: False for none.

timeread-only

The step’s length, in step time.

uidUUID | Noneread-only

The object’s unique id, a UUID.

Methods
add_field(field)

Add a temperature field (TemperatureField); other fields raise ValueError.

add_load_field(field)

Alias for add_field() to keep compatibility.

ModalAnalysis(modes=1, **kwargs)

The structure’s natural frequencies and mode shapes, in the state the step before it left (unloaded if none).

The masses come from the material densities: set them in the model’s units (t/mm3 for N and mm), or the frequencies are wrong.

Parameters

Name Type Description
modes int, optional The number of modes to compute, lowest first (default 1).

Guidance (analyses)

  • After the solve, modal.frequencies lists the frequencies and modal.mode_shape(n) gives mode n’s shape.
Properties
field_outputsread-only

The field results asked for in this step, a set.

frequenciesread-only

The natural frequencies, modes 1 to modes in order, as a generator (Hz with time in seconds).

history_outputsread-only

The history results asked for in this step, a set.

keyAny | Noneread-only

The object’s key (its number) in what it is registered to; None until it is given one.

modelModel | Noneread-only

The model of the step’s problem.

namestr

The object’s name.

problemProblemread-only

The problem the step is in; raises AttributeError if it is in none.

rdbread-only

The results database of the step’s problem (see rdb).

registrationAny | None

The object this one is registered to (a part, a model, a step, …), or None.

resultsread-only

Each mode’s result, modes 1 to modes in order, as a generator.

shapesread-only

Each mode’s shape, modes 1 to modes in order, as a generator (see mode_shape()).

uidUUID | Noneread-only

The object’s unique id, a UUID.

Methods
available_modes()

The modes the results hold, a sorted list of mode numbers (empty before the solve).

mode_frequency(mode)

Mode mode’s natural frequency (counted from 1), in Hz with time in seconds.

mode_result(mode)

Mode mode’s result (counted from 1): eigenvalue, frequency, shape, participation factors and effective mass.

Parameters

Name Type Description
mode int The mode, from 1.

Returns

Name Type Description
class:xfea.results.ModalResult The mode’s result.
ComplexEigenValue(**kwargs)

A complex frequency step: natural frequencies with damping or gyroscopic effects.

Properties
field_outputsread-only

The field results asked for in this step, a set.

history_outputsread-only

The history results asked for in this step, a set.

keyAny | Noneread-only

The object’s key (its number) in what it is registered to; None until it is given one.

modelModel | Noneread-only

The model of the step’s problem.

namestr

The object’s name.

problemProblemread-only

The problem the step is in; raises AttributeError if it is in none.

rdbread-only

The results database of the step’s problem (see rdb).

registrationAny | None

The object this one is registered to (a part, a model, a step, …), or None.

uidUUID | Noneread-only

The object’s unique id, a UUID.

BucklingAnalysis(modes, vectors=None, iterations=30, algorithm=None, **kwargs)

Linear buckling: the factors by which the loads of the steps before it must be multiplied for the structure to buckle.

Add it after a static step that applies a reference load; after the solve, mode_factor(1) times that load is the lowest buckling load.

Parameters

Name Type Description
modes int The number of buckling modes to compute, lowest factor first.
vectors int, optional The number of trial vectors the eigensolver uses: None takes twice modes (three times above 9 modes).
iterations int, optional The most eigensolver iterations (default 30).
algorithm str, optional The eigensolver, "SUBSPACE" or "Lanczos", or None for the solver plugin’s default.
Properties
field_outputsread-only

The field results asked for in this step, a set.

history_outputsread-only

The history results asked for in this step, a set.

keyAny | Noneread-only

The object’s key (its number) in what it is registered to; None until it is given one.

modelModel | Noneread-only

The model of the step’s problem.

namestr

The object’s name.

problemProblemread-only

The problem the step is in; raises AttributeError if it is in none.

rdbread-only

The results database of the step’s problem (see rdb).

registrationAny | None

The object this one is registered to (a part, a model, a step, …), or None.

resultsread-only

Each mode’s result, modes 1 to modes in order, as a generator.

shapesread-only

Each mode’s shape, modes 1 to modes in order, as a generator (see mode_shape()).

uidUUID | Noneread-only

The object’s unique id, a UUID.

Methods
Lanczos(modes)

A buckling analysis of modes modes with the Lanczos eigensolver.

Subspace(modes, iterations, vectors=None)

A buckling analysis of modes modes with the subspace eigensolver, at most iterations iterations.

available_modes()

The modes the results hold, a sorted list of mode numbers (empty before the solve).

mode_factor(mode)

Mode mode’s buckling factor (counted from 1): the multiple of the load at which it buckles.

mode_result(mode)

Mode mode’s result (counted from 1): its buckling factor and shape.

Parameters

Name Type Description
mode int The mode, from 1.

Returns

Name Type Description
class:xfea.results.BucklingResult The mode’s result.
LinearStaticPerturbation(**kwargs)

A linear static response to a small load about the state the step before it left, not carried over.

Properties
field_outputsread-only

The field results asked for in this step, a set.

history_outputsread-only

The history results asked for in this step, a set.

keyAny | Noneread-only

The object’s key (its number) in what it is registered to; None until it is given one.

modelModel | Noneread-only

The model of the step’s problem.

namestr

The object’s name.

problemProblemread-only

The problem the step is in; raises AttributeError if it is in none.

rdbread-only

The results database of the step’s problem (see rdb).

registrationAny | None

The object this one is registered to (a part, a model, a step, …), or None.

uidUUID | Noneread-only

The object’s unique id, a UUID.

SteadyStateDynamic(**kwargs)

A steady-state response to harmonic loading over a range of frequencies.

Properties
field_outputsread-only

The field results asked for in this step, a set.

history_outputsread-only

The history results asked for in this step, a set.

keyAny | Noneread-only

The object’s key (its number) in what it is registered to; None until it is given one.

modelModel | Noneread-only

The model of the step’s problem.

namestr

The object’s name.

problemProblemread-only

The problem the step is in; raises AttributeError if it is in none.

rdbread-only

The results database of the step’s problem (see rdb).

registrationAny | None

The object this one is registered to (a part, a model, a step, …), or None.

uidUUID | Noneread-only

The object’s unique id, a UUID.

SubstructureGeneration(**kwargs)

The generation of a substructure (superelement) from part of the model.

Properties
field_outputsread-only

The field results asked for in this step, a set.

history_outputsread-only

The history results asked for in this step, a set.

keyAny | Noneread-only

The object’s key (its number) in what it is registered to; None until it is given one.

modelModel | Noneread-only

The model of the step’s problem.

namestr

The object’s name.

problemProblemread-only

The problem the step is in; raises AttributeError if it is in none.

rdbread-only

The results database of the step’s problem (see rdb).

registrationAny | None

The object this one is registered to (a part, a model, a step, …), or None.

uidUUID | Noneread-only

The object’s unique id, a UUID.

© 2026 Francesco Ranaudo · Text and pictures CC BY 4.0 · Code Elastic License 2.0 · how to reuse them