Main modules

Loads

class actions.loads.BaseVectorLoad(name, loadVector)

Bases: object

Base class for loads introduced using a load as an xcVector

Variables:
  • name – name identifying the load
  • loadVector – load xc.Vector
class actions.loads.EarthPressLoad(name, xcSet, soilData, vDir)

Bases: actions.loads.BaseVectorLoad

Earth pressure applied on the elements (shell or beams) included in the set xcSet.

Variables:
  • name – name identifying the load
  • xcSet – set that contains the elements (shells and/or beams)
  • soilProp – instance of the class EarthPressureModel that defines the soil parameters required to calculate the earth pressure (K:coefficient of pressure, zGround: global Z coordinate of ground level,gammaSoil: weight density of soil, zWater: global Z coordinate of groundwater level, gammaWater: weight density of water) . soilProp==None if earth thrust is not considered.

:ivar vDir:unit xc vector defining pressures direction :ivar stripLoads: list of instances of the class

StripLoadOnBackfill to define (if any) strip surcharge loads on the backfill (defaults to [], no loads)
Variables:
  • lineLoads – list of instances of the class LineVerticalLoadOnBackfill to define (if any) line surcharge loads acting in vertical direction on the backfill (defaults to [], no loads)
  • horzLoads – list of instances of the class HorizontalLoadOnBackfill to define (if any) surcharge loads acting in horizontal direction on the backfill (defaults to [], no loads)
appendLoadToCurrentLoadPattern()

Append load to the current load pattern.

getMaxMagnitude()

Return the maximum magnitude of the vector loads

class actions.loads.InertialLoad(name, lstMeshSets, vAccel)

Bases: actions.loads.BaseVectorLoad

Inertial load (density*acceleration) applied to the elements in the list of mesh-sets

Variables:
  • name – name identifying the load
  • lstMeshSets – list of mesh-sets (of type LinSetToMesh or SurfSetToMesh)
  • vAccel – acceleration vector xc.Vector([ax,ay,az])
appendLoadToCurrentLoadPattern()
getMaxMagnitude()

Return the maximum magnitude of the vector loads

class actions.loads.NodalLoad(name, lstNod, loadVector)

Bases: actions.loads.BaseVectorLoad

Point load applied on a list of nodes

Variables:
  • name – name identifying the load
  • lstNod – list of nodes on which the load is applied.
  • loadVector – xc.Vector with the six components of the load: xc.Vector([Fx,Fy,Fz,Mx,My,Mz]).
appendLoadToCurrentLoadPattern()
getMaxMagnitude()

Return the maximum magnitude of the vector loads

class actions.loads.PointLoadOverShellElems(name, xcSet, loadVector, prismBase, prismAxis='Z', refSystem='Global')

Bases: actions.loads.BaseVectorLoad

Point load distributed over the shell elements in xcSet whose centroids are inside the prism defined by the 2D polygon prismBase and one global axis.

Variables:
  • name – name identifying the load
  • xcSet – set that contains the shell elements
  • loadVector – xc vector with the six components of the point load: xc.Vector([Fx,Fy,Fz,Mx,My,Mz]).
  • prismBase –

    2D polygon that defines the n-sided base of the prism. The vertices of the polygon are defined in global coordinates in the following way:

    • for X-axis-prism: (y,z)
    • for Y-axis-prism: (x,z)
    • for Z-axis-prism: (x,y)
  • prismAxis – axis of the prism (can be equal to ‘X’, ‘Y’, ‘Z’) (defaults to ‘Z’)
  • refSystem – reference system in which loadVector is defined: ‘Local’: element local coordinate system ‘Global’: global coordinate system (defaults to ‘Global’)
appendLoadToCurrentLoadPattern()

Append load to the current load pattern.

distrParam()

Return the set of elements over which to distribute the point load and the coefficient that must be applied to it

getMaxMagnitude()

Return the maximum magnitude of the vector loads

class actions.loads.StrainGradientLoadOnBeams(name, xcSet, strain)

Bases: object

Strain load applied on the beam elements generated from all the lines in the xcSet.

appendLoadToLoadPattern(loadPattern)

Append load to the load pattern passed as parameter.

class actions.loads.StrainLoadOnShells(name, xcSet, DOFstrain, strain)

Bases: object

Strain load applied on the shell elements in xcSet

Variables:
  • name – name identifying the load
  • xcSet – set that contains the elements
  • DOFstrain – degree of freedom to which apply the strain
  • strain – strain (e.g.: alpha x deltaT for thermal expansion)
appendLoadToCurrentLoadPattern()

Append load to the load pattern passed as parameter.

class actions.loads.UniformLoadOnBeams(name, xcSet, loadVector, refSystem='Global')

Bases: actions.loads.BaseVectorLoad

Uniform load applied on the beam elements generated from all the lines in the xcSet.

Variables:
  • name – name identifying the load
  • xcSet – set that contains the lines
  • loadVector – xc.Vector with the six components of the load: xc.Vector([Fx,Fy,Fz,Mx,My,Mz]).
  • refSystem – reference system in which loadVector is defined: ‘Local’: element local coordinate system ‘Global’: global coordinate system (defaults to ‘Global)
appendLoadToCurrentLoadPattern()

Append load to the current load pattern.

getMaxMagnitude()

Return the maximum magnitude of the vector loads

class actions.loads.UniformLoadOnLines(name, xcSet, loadVector)

Bases: actions.loads.BaseVectorLoad

Uniform load applied to all the lines (not necessarily defined as lines for latter generation of beam elements, they can be lines belonging to surfaces for example) found in the xcSet The uniform load is introduced as point loads in the nodes

Variables:
  • name – name identifying the load
  • xcSet – set that contains the lines
  • loadVector – xc.Vector with the six components of the load: xc.Vector([Fx,Fy,Fz,Mx,My,Mz]).
appendLoadToCurrentLoadPattern()
getMaxMagnitude()

Return the maximum magnitude of the vector loads

class actions.loads.UniformLoadOnSurfaces(name, xcSet, loadVector, refSystem='Global')

Bases: actions.loads.BaseVectorLoad

Uniform load applied on the shell elements generated from all the surfaces in the xcSet.

Variables:
  • name – name identifying the load
  • xcSet – set that contains the surfaces
  • loadVector – xc.Vector with the six components of the load: xc.Vector([Fx,Fy,Fz,Mx,My,Mz]).
  • refSystem – reference system in which loadVector is defined: ‘Local’: element local coordinate system ‘Global’: global coordinate system (defaults to ‘Global)
appendLoadToCurrentLoadPattern()

Append load to the current load pattern.

getMaxMagnitude()

Return the maximum magnitude of the vector loads

Load cases

class actions.load_cases.LoadCase(preprocessor, name, loadPType='default', timeSType='constant_ts')

Bases: object

Definition of a load case.

Variables:
  • name – name given to the load case
  • loadPType – type of load pattern. Available types: “default”, “uniform_excitation”, “multi_support_pattern”, “pbowl_loading”. Defaults to “default”
  • timeSType – type of Time Series. Available time series: “constant_ts”,”linear_ts”,”path_ts”,”pulse_ts”,”rectangular_ts”,”triangular_ts”,”trig_ts”. Defaults to “constant_ts”
  • timeSName – name of the Time Serie
  • lstOfLoadDef – list of load definitions added to the load case
addLstLoads(lstLoads)

list of loads to be added to the load case.

create()

Create the load case and set it as current

class actions.load_cases.LoadCaseManager(preprocessor)

Bases: object

Manager for XC load cases.

defineSimpleLoadCases(names)

Define load patterns with constant time series.

getCurrentLoadCase()

Returns current load case.

getLoadCase(name)
setCurrentLoadCase(name)

Sets current load case.

actions.load_cases.resetAccionesConstantTS(preprocessor, tipoTimeSeries, nmbTimeSeries, fct)

Clear all load patterns in the model and create a new TimeSeries

Parameters:
  • tipoTimeSeries – time series type
  • nmbTimeSeries – time series name.
  • fct – Factor

Combinations

combinations.py: manages the container for load combinations.

class actions.combinations.CombContainer

Bases: object

Container of load combinations :ivar SLS: serviceability limit state combination :ivar ULS: ultimate limit state combination

dumpCombinations(preprocessor)

Introduces the combinations into the XC combination handler.

getNames()

returns a list of the combination names.

getNeutralFormat(mapLoadCases)
getRecordLoadCaseDisp(combName, setsToDispLoads, setsToDispDspRot, setsToDispIntForc)

Returns a suitable RecordLoadCaseDisp for the combination.

Parameters:
  • setsToDispLoads – ordered list of sets of elements to display loads.
  • setsToDispDspRot – ordered list of sets of elements to display displacements.
  • setsToDispIntForc – ordered list of sets of elements to display internal forces.
class actions.combinations.CombinationRecord(name, expr)

Bases: object

Combination name and expression (i.e. ELS01= 1.0*G+1.0*Q)

createCombination(xcCombHandler)

Create combination and insert it into the XC combination handler.

getRecordLoadCaseDisp(setsToDispLoads, setsToDispDspRot, setsToDispIntForc, unitsScaleForc=0.001, unitsScaleMom=0.001, unitsScaleDisp=1000.0, unitsDispl='[mm]')

Return a suitable RecordLoadCaseDisp for the combination.

Parameters:
  • setsToDispLoads – ordered list of sets of elements to display loads.
  • setsToDispDspRot – ordered list of sets of elements to display displacements.
  • setsToDispIntForc – ordered list of sets of elements to display internal forces.
  • unitsScaleForc – factor to apply to internal forces if we want to change the units (defaults to 1e-3).
  • unitsScaleMom – factor to apply to internal moments if we want to change the units (defaults to 1e-3).
  • unitsScaleDispl – factor to apply to displacements if we want to change the units (defaults to 1e3).
  • unitsDispl – text to especify the units in which displacements are represented (defaults to ‘[mm]’
class actions.combinations.SLSCombinations

Bases: actions.combinations.SituationsSet

Combinations of actions for serviceability limit states

Variables:
  • name – name to identify the limit state (serviceability, ultimate,…)
  • rare – combination for a rare design situation
  • freq – combination for a frequent design situation
  • qp – combination for a quasi-permanent design situation
  • earthquake – combination for a earthquake design situation
getNeutralFormat(counter, mapLoadCases)
class actions.combinations.SituationCombs(desc)

Bases: dict

Combinations for a situation (frequent, rare, persistent,…).

add(name, expr)
dumpCombinations(xcCombHandler)

Introduces the combinations into the XC combination handler.

getNames()

returns a list of the combination names.

getNeutralFormat(counter, typ, mapLoadCases)
getRecordLoadCaseDisp(combName, setsToDispLoads, setsToDispDspRot, setsToDispIntForc)

Returns a suitable RecordLoadCaseDisp for the combination.

Parameters:
  • setsToDispLoads – ordered list of sets of elements to display loads.
  • setsToDispDspRot – ordered list of sets of elements to display displacements.
  • setsToDispIntForc – ordered list of sets of elements to display internal forces.
class actions.combinations.SituationsSet(name)

Bases: object

Set of situations as used in limit states

Variables:
  • name – name to identify the situation set
  • situations – set of situations
dumpCombinations(xcCombHandler)

Introduces the combinations into the XC combination handler.

getNames()

returns a list of the combination names.

getRecordLoadCaseDisp(combName, setsToDispLoads, setsToDispDspRot, setsToDispIntForc)

Returns a suitable RecordLoadCaseDisp for the combination.

Parameters:
  • setsToDispLoads – ordered list of sets of elements to display loads.
  • setsToDispDspRot – ordered list of sets of elements to display displacements.
  • setsToDispIntForc – ordered list of sets of elements to display internal forces.
class actions.combinations.ULSCombinations

Bases: actions.combinations.SituationsSet

Combinations of actions for ultimate limit states

Variables:
  • name – name to identify the limit state (ultimate,…)
  • perm – combination for a persistent or transient design situation
  • acc – combination for a accidental design situation
  • fatigue – combination for a fatigue design situation
  • earthquake – combination for a seismic design situation
getNeutralFormat(counter, mapLoadCases)