LoadCase

class pyccx.loadcase.LoadCase(name, loadCaseType=None, resultSets=None)

Bases: ModelObject

A unique Load case defines a set of simulation analysis conditions and a set of boundary conditions to apply to the domain. The default and initial timestep provide an estimate for the solver should be specified along with the total duration of the load case using setTimeStep(). The analysis type for the loadcase should be specified using setLoadCaseType(). Depending on the analysis type the steady-state solution may instead be calculated.

If the option automaticIncrements is set to False, the solver will use the initial timestep and the total time steps will be defined by the user when using the nonlinear option, which provides time-dependent behavior for the analysis.

Attributes Summary

automaticIncrements

True if the solver is using adaptive time-stepping increments

boundaryConditions

The list of boundary conditions to be applied during the load case

defaultTimestep

The default timestep to use throughout the load case

initialTimestep

The initial timestep to use for the increment during the load case if the solver is using an adaptive time-stepping scheme

loadCaseType

maxTimestep

The maximum timestep increment for the load case if the solver is using an adaptive time-stepping scheme which is used during a non-linear or incremental loading.

minTimestep

The minimum timestep increment for the load case if the solver is using an adaptive time-stepping scheme

nonlinear

True if the load case is a non-linear analysis

resultSet

The result outputs (ElementResult, NodeResult) to generate the set of results from this load case.

steadyState

True if the loadcase is a steady-state analysis

totalTime

The total duration time for the load case

Methods Summary

setLoadCaseType(loadCaseType)

Set the load case type based on the analysis types available in LoadCaseType.

setTimeStep([defaultTimestep, ...])

Set the time stepping values for the loadcase

writeBoundaryCondition()

Generates the string for Boundary Conditions in self.boundaryConditions containing all the attached boundary conditions.

writeInput()

Attributes Documentation

automaticIncrements

True if the solver is using adaptive time-stepping increments

boundaryConditions

The list of boundary conditions to be applied during the load case

defaultTimestep

The default timestep to use throughout the load case

initialTimestep

The initial timestep to use for the increment during the load case if the solver is using an adaptive time-stepping scheme

loadCaseType
maxTimestep

The maximum timestep increment for the load case if the solver is using an adaptive time-stepping scheme which is used during a non-linear or incremental loading.

minTimestep

The minimum timestep increment for the load case if the solver is using an adaptive time-stepping scheme

nonlinear

True if the load case is a non-linear analysis

resultSet

The result outputs (ElementResult, NodeResult) to generate the set of results from this load case.

steadyState

True if the loadcase is a steady-state analysis

totalTime

The total duration time for the load case

Methods Documentation

setLoadCaseType(loadCaseType)

Set the load case type based on the analysis types available in LoadCaseType.

Parameters:

loadCaseType (LoadCaseType) – Set the load case type using the enum LoadCaseType

Return type:

None

setTimeStep(defaultTimestep=1.0, initialTimestep=None, totalTime=None)

Set the time stepping values for the loadcase

Parameters:
  • defaultTimestep (float) – float: Default timestep to use throughout the load case

  • initialTimestep (Optional[float]) – float: The initial timestep to use for the increment

  • totalTime (Optional[float]) – float: The total time for the load case

Return type:

None

writeBoundaryCondition()

Generates the string for Boundary Conditions in self.boundaryConditions containing all the attached boundary conditions. Calculix cannot share existing boundary conditions and therefore has to be explicitly initialised and created per individual load case.

Return type:

str

Returns:

outStr

writeInput()
Return type:

str