General topics

callback_controls

postprocess.callback_controls.controTensRecElastico2d()

Code to execute in every commit to check stress criterion (bars in plane problems).

postprocess.callback_controls.controTensRecElastico3d()

Code to execute in every commit to check stress criterion (bars in 3D problems).

postprocess.callback_controls.controlMovModulusUV()
postprocess.callback_controls.controlMovModulusUVW()
postprocess.callback_controls.controlMovU()
postprocess.callback_controls.controlMovUV()
postprocess.callback_controls.controlMovUVW()
postprocess.callback_controls.controlMovV()
postprocess.callback_controls.controlMovW()
postprocess.callback_controls.controlMovs()
postprocess.callback_controls.fnControlMovComponent(recorder, obj, codeComponent, value)
postprocess.callback_controls.fnControlMovUVW(recorder, obj)
postprocess.callback_controls.fnControlMovs(recorder, obj)

control_vars

class postprocess.control_vars.BiaxialBendingControlVars(idSection='nil', combName='nil', CF=-1.0, N=0.0, My=0.0, Mz=0.0)

Bases: postprocess.control_vars.UniaxialBendingControlVars

Biaxial bending. Normal stresses limit state variables. [CF,N,My,Mz].

:ivar idSection:section identifier :ivar combName: name of the load combinations to deal with :ivar CF: capacity factor (efficiency) (defaults to -1) :ivar N: axial force (defaults to 0.0) :ivar My: bending moment about Y axis (defaults to 0.0) :ivar Mz: bending moment about Z axis (defaults to 0.0)

getAnsysStrings(eTag, axis, factor=0.001)

Returns a string to represent fields in ANSYS (R).

Parameters:
  • eTag – element identifier.
  • axis – section 1 or 2
  • factor – factor for units (default 1e-3 -> kN)
getLaTeXFields(factor=0.001)

Returns a string with the intermediate fields of the LaTeX string.

Parameters:factor – factor for units (default 1e-3 -> kN)
getStrArguments(factor)

Returns a string for a ‘copy’ (kind of) constructor.

class postprocess.control_vars.CFNMy(combName='nil', CF=-1.0, N=0.0, My=0.0)

Bases: postprocess.control_vars.NMy

Uniaxial bending. Normal stresses limit state variables.

Variables:
  • combName – name of the load combinations to deal with
  • CF – capacity factor (efficiency) (defaults to -1.0; CF<1.0 -> Ok; CF>1.0 -> KO)
  • N – axial force (defaults to 0.0)
  • My – bending moment about Y axis (defaults to 0.0)
  • Mz – bending moment about Z axis (defaults to 0.0)
getCF()
class postprocess.control_vars.CFNMyMz(combName='nil', CF=-1.0, N=0.0, My=0.0, Mz=0.0)

Bases: postprocess.control_vars.CFNMy

Biaxial bending. Normal stresses limit state variables. [CF,N,My,Mz].

Variables:
  • combName – name of the load combinations to deal with
  • CF – capacity factor (efficiency) (defaults to -1)
  • N – axial force (defaults to 0.0)
  • My – bending moment about Y axis (defaults to 0.0)
  • Mz – bending moment about Y axis (defaults to 0.0)
getAnsysStrings(eTag, axis, factor=0.001)

Returns a string to represent fields in ANSYS (R).

Parameters:
  • eTag – element identifier.
  • axis – section 1 or 2
  • factor – factor for units (default 1e-3 -> kN)
getLaTeXFields(factor=0.001)

Returns a string with the intermediate fields of the LaTeX string.

Parameters:factor – factor for units (default 1e-3 -> kN)
getStrArguments(factor)

Returns a string for a ‘copy’ (kind of) constructor.

class postprocess.control_vars.CFVy(combName='nil', CF=-1.0, Vy=0.0)

Bases: postprocess.control_vars.ShVy

Uniaxial bending. Normal stresses limit state variables.

Variables:
  • combName – name of the load combinations to deal with
  • CF – capacity factor (efficiency) (defaults to -1.0; CF<1.0 -> Ok; CF>1.0 -> KO)
  • Vy – shear along Y axis (defaults to 0.0)
getCF()
class postprocess.control_vars.ControlVarsBase(combName='nil')

Bases: object

Base class for the control of variables (internal forces,
strains, stresses,…) calculated in the analysis.
Variables:combName – name of the load combination to deal with
getAnsysStrings(eTag, axis, factor=0.001)

Returns a string to represent fields in ANSYS (R).

Parameters:
  • eTag – element identifier.
  • axis – section 1 or 2
  • factor – factor for units (default 1e-3 -> kN)
getCF()
getFieldNames(parent='')
getLaTeXFields(factor=0.001)

Returns a string with the intermediate fields of the LaTeX string.

Parameters:factor – factor for units (default 1e-3 -> kN)
getLaTeXString(eTag, factor=0.001)

Returns a string that we can insert in a LaTeX table.

Parameters:
  • eTag – element identifier.
  • factor – factor for units (default 1e-3 -> kN)
getStrArguments(factor)

Returns a string for a ‘copy’ (kind of) constructor.

Parameters:factor – factor for units (default 1e-3 -> kN)
getStrConstructor(factor=0.001)
strElementProp(eTag, nmbProp, factor=0.001)

Writes a string that will serve to read the element property from a file.

Parameters:
  • eTag – element identifier.
  • nmbProp – name of the element property
  • factor – factor for units (default 1e-3 -> kN)
class postprocess.control_vars.CrackControlBaseVars(combName='nil', CF=-1.0, N=0.0, My=0.0, Mz=0.0, steelStress=0.0)

Bases: postprocess.control_vars.CFNMyMz

Biaxial bending. Cracking serviceability limit state variables.

Variables:
  • combName – name of the load combinations to deal with
  • CF – capacity factor (efficiency)
  • N – axial force
  • My – bending moment about Y axis
  • Mz – bending moment about Z axis
  • steelStress – maximum stress in the reinforcement bars
getAnsysStrings(eTag, axis, factor=0.001)

Returns a string to represent fields in ANSYS (R).

Parameters:
  • eTag – element identifier.
  • axis – section 1 or 2
  • factor – factor for units (default 1e-3 -> kN)
getLaTeXFields(factor=0.001)

Returns a string with the intermediate fields of the LaTeX string.

Parameters:factor – factor for units (default 1e-3 -> kN)
getStrArguments(factor)

Returns a string for a ‘copy’ (kind of) constructor.

class postprocess.control_vars.CrackControlVars(idSection='nil', crackControlBaseVarsPos=None, crackControlBaseVarsNeg=None)

Bases: postprocess.control_vars.ControlVarsBase

Cracking serviceability limit state control variables.

:ivar idSection:section identifier :ivar crackControlVarsPos: Crack control in + face. :ivar crackControlVarsNeg: Crack control in - face.

getCF()
getLaTeXFields(factor=0.001)

Returns a string with the intermediate fields of the LaTeX string. factor: factor for units (default 1e-3 -> kN)

getMaxN()

Maximum internal axial force.

getMaxSteelStress()

Maximum value for rebar stresses.

getStrArguments(factor)

Returns a string for a ‘copy’ (kind of) constructor.

class postprocess.control_vars.FatigueControlBaseVars(combName='nil', CF=-1.0, N=0.0, My=0.0, Mz=0.0, Vy=0.0, posSteelStress=0.0, negSteelStress=0.0, concreteStress=0.0)

Bases: postprocess.control_vars.NMyMz

Biaxial bending. Fatigue limit state variables.

Variables:
  • combName – name of the load combinations to deal with
  • N – axial force (defaults to 0.0)
  • My – bending moment about Y axis (defaults to 0.0)
  • Mz – bending moment about Z axis (defaults to 0.0)
  • Vy – shear force parallel to Y axis.
  • posSteelStress – traction stress in rebars.
  • negSteelStress – compression stress in rebars.
  • concreteStress – compression stress in concrete.
getAnsysStrings(eTag, axis, factor=0.001)

Returns a string to represent fields in ANSYS (R).

Parameters:
  • eTag – element identifier.
  • axis – section 1 or 2
  • factor – factor for units (default 1e-3 -> kN)
getLaTeXFields(factor=0.001)

Returns a string with the intermediate fields of the LaTeX string.

Parameters:factor – factor for units (default 1e-3 -> kN)
getStrArguments(factor)

Returns a string for a ‘copy’ (kind of) constructor.

class postprocess.control_vars.FatigueControlVars(idSection='nil', controlBaseVars0=None, controlBaseVars1=None, concreteLimitStress=0.0, concreteBendingCF=-1.0, shearLimit=0.0, concreteShearCF=-1.0, Mu=0.0, Vu=0.0)

Bases: postprocess.control_vars.ControlVarsBase

Fatigue limit state control variables.

Variables:
  • idSection – section identifier
  • combName – name of the load combinations to deal with
  • state0 – Fatigue values (FatigueControlBaseVars) under permanent load.
  • state1 – Fatigue values (FatigueControlBaseVars) under fatigue load.
  • concreteLimitStress – limit for the concrete stress as specified in SIA 262(2013) 4.3.8.3.1
  • concreteBendingCF – concrete capacity factor under fatigue due to normal stresses.
  • shearLimit – limit for the shear force as sepecified in SIA 262(2013) 4.3.8.3.2
  • concreteShearCF – concrete capacity factor under fatigue due to shear forces.
  • Mu – ultimate bending moment
  • Vu – ultimate shear force
getAbsSteelStressIncrement()

Returns maximun stress increment in rebars (absolute value).

getConcreteMaxMinStresses()

Used in FatigueController.concreteLimitStress.

getConcreteMinStress()

Returns minimum (max. compressive) concrete stress between loaded and unloaded states.

getConcreteStressIncrement()

Returns stress increment in concrete.

getLaTeXFields(factor=0.001)

Returns a string with the intermediate fields of the LaTeX string.

Parameters:factor – factor for units (default 1e-3 -> kN)
getSteelNegStressIncrement()

Returns negative stress increment in rebars.

getSteelPosStressIncrement()

Returns positive stress increment in rebars.

getStrArguments(factor)

Returns a string for a ‘copy’ (kind of) constructor.

class postprocess.control_vars.NMy(combName='nil', N=0.0, My=0.0)

Bases: postprocess.control_vars.ControlVarsBase

Uniaxial bending. Internal forces [N,My] for a combination.

Variables:
  • combName – name of the load combinations to deal with
  • N – axial force (defaults to 0.0)
  • My – bending moment about Y axis (defaults to 0.0)
getAnsysStrings(eTag, axis, factor=0.001)

Returns a string to represent fields in ANSYS (R).

Parameters:
  • eTag – element identifier.
  • axis – section 1 or 2
  • factor – factor for units (default 1e-3 -> kN)
getLaTeXFields(factor=0.001)

Returns a string with the intermediate fields of the LaTeX string.

Parameters:factor – factor for units (default 1e-3 -> kN)
getStrArguments(factor)

Returns a string for a ‘copy’ (kind of) constructor.

class postprocess.control_vars.NMyMz(combName='nil', N=0.0, My=0.0, Mz=0.0)

Bases: postprocess.control_vars.NMy

Biaxial bending. Internal forces [N,My,Mz] for a combination.

Variables:
  • combName – name of the load combinations to deal with
  • N – axial force (defaults to 0.0)
  • My – bending moment about Y axis (defaults to 0.0)
  • Mz – bending moment about Z axis (defaults to 0.0)
getAnsysStrings(eTag, axis, factor=0.001)

Returns a string to represent fields in ANSYS (R).

Parameters:
  • eTag – element identifier.
  • axis – section 1 or 2
  • factor – factor for units (default 1e-3 -> kN)
getLaTeXFields(factor=0.001)

Returns a string with the intermediate fields of the LaTeX string.

Parameters:factor – factor for units (default 1e-3 -> kN)
getStrArguments(factor)

Returns a string for a ‘copy’ (kind of) constructor.

class postprocess.control_vars.RCCrackStraightControlVars(idSection=-1, combName='nil', CF=-1, N=0.0, My=0.0, Mz=0.0, s_rmax=0.0, eps_sm=0.0, wk=0.0)

Bases: postprocess.control_vars.NMyMz

Control variables for cracking serviacebility limit state verification when when considering a concrete stress-strain diagram that takes account of the effects of tension stiffening.

:ivar idSection:section identifier :ivar combName: name of the load combinations to deal with :ivar N: axial force :ivar My: bending moment about Y axis :ivar Mz: bending moment about Z axis :ivar s_rmax: maximum distance between cracks (otherwise a new crack

could occur in-between
Variables:
  • eps_sm – mean strain in the reinforcement when taking into account the effects of tension stiffening
  • wk – crack width
getLaTeXFields(factor=0.001)

Returns a string with the intermediate fields of the LaTeX string.

Parameters:factor – factor for units (default 1e-3 -> kN)
getStrArguments(factor)

Returns a string for a ‘copy’ (kind of) constructor.

class postprocess.control_vars.RCShearControlVars(idSection=-1, combName='nil', CF=-1.0, N=0.0, My=0.0, Mz=0.0, Mu=0.0, Vy=0.0, Vz=0.0, theta=0.0, Vcu=0.0, Vsu=0.0, Vu=0.0)

Bases: postprocess.control_vars.BiaxialBendingControlVars

Control variables for shear limit state verification in reinforced concrete elements.

:ivar idSection:section identifier :ivar combName: name of the load combinations to deal with :ivar CF: capacity factor (efficiency) :ivar N: axial force :ivar My: bending moment about Y axis :ivar Mz: bending moment about Z axis :ivar Mu: ultimate bending moment :ivar Vy: shear force parallel to the y axis :ivar Vz: shear force parallel to the z axis :ivar theta: angle between the concrete compression struts and the beam axis :ivar Vcu: Vcu component of the shear resistance (defined in the codes) :ivar Vsu: Vsu component of the shear resistance (defined in the codes) :ivar Vu: shear resistance

getAnsysStrings(eTag, axis, factor=0.001)

Returns a string to represent fields in ANSYS (R).

Parameters:
  • eTag – element identifier.
  • axis – section 1 or 2
  • factor – factor for units (default 1e-3 -> kN)
getLaTeXFields(factor=0.001)

Returns a string with the intermediate fields of the LaTeX string.

Parameters:factor – factor for units (default 1e-3 -> kN)
getStrArguments(factor)

Returns a string for a ‘copy’ (kind of) constructor.

class postprocess.control_vars.SSBiaxialBendingControlVars(idSection='nil', combName='nil', CF=-1.0, N=0.0, My=0.0, Mz=0.0, Ncrd=0.0, McRdy=0.0, McRdz=0.0, MvRdz=0.0, MbRdz=0.0, chiLT=1.0)

Bases: postprocess.control_vars.BiaxialBendingControlVars

Control variables for biaxial bending normal stresses LS verification en steel-shape elements.

:ivar idSection:section identifier :ivar combName: name of the load combinations to deal with :ivar CF: capacity factor (efficiency) (defaults to -1) :ivar N: axial force (defaults to 0.0) :ivar My: bending moment about Y (weak) axis (defaults to 0.0) :ivar Mz: bending moment about Z (strong) axis (defaults to 0.0) :ivar Ncrd: design resistance to axial compression :ivar McRdy: design moment resistance about Y (weak) axis :ivar McRdz: design moment resistance about Z (strong) axis :ivar MvRdz: reduced design moment resistance about Z (strong) axis

for shear interaction
Variables:
  • MbRdz – reduced design moment resistance about Z (strong) axis for lateral-torsional bucking
  • chiLT – reduction factor for lateral-torsional buckling (defaults to 1)
getLaTeXFields(factor=0.001)

Returns a string with the intermediate fields of the LaTeX string.

Parameters:factor – factor for units (default 1e-3 -> kN)
getStrArguments(factor)

Returns a string for a ‘copy’ (kind of) constructor.

class postprocess.control_vars.ShVy(combName='nil', Vy=0.0)

Bases: postprocess.control_vars.ControlVarsBase

Shear along Y axis. Internal forces [Vy] for a combination.

Variables:
  • combName – name of the load combinations to deal with
  • Vy – bending moment about Y axis (defaults to 0.0)
getAnsysStrings(eTag, axis, factor=0.001)

Returns a string to represent fields in ANSYS (R).

Parameters:
  • eTag – element identifier.
  • axis – section 1 or 2
  • factor – factor for units (default 1e-3 -> kN)
getLaTeXFields(factor=0.001)

Returns a string with the intermediate fields of the LaTeX string.

Parameters:factor – factor for units (default 1e-3 -> kN)
getStrArguments(factor)

Returns a string for a ‘copy’ (kind of) constructor.

class postprocess.control_vars.ShearYControlVars(idSection='nil', combName='nil', CF=-1.0, Vy=0.0)

Bases: postprocess.control_vars.CFVy

Shear along Y axis. Limit state variables [CF,Vy].

:ivar idSection:section identifier :ivar combName: name of the load combinations to deal with :ivar CF: capacity factor (efficiency) (defaults to -1; CF<1.0 -> Ok; CF>1.0 -> KO) :ivar Vy: shear along Y axis (defaults to 0.0)

getLaTeXFields(factor=0.001)

Returns a string with the intermediate fields of the LaTeX string.

Parameters:factor – factor for units (default 1e-3 -> kN)
getStrArguments(factor)

Returns a string for a ‘copy’ (kind of) constructor.

Parameters:factor – factor for units (default 1e-3 -> kN)
class postprocess.control_vars.UniaxialBendingControlVars(idSection='nil', combName='nil', CF=-1.0, N=0.0, My=0.0)

Bases: postprocess.control_vars.CFNMy

Uniaxial bending. Normal stresses limit state variables [CF,N,My].

:ivar idSection:section identifier :ivar combName: name of the load combinations to deal with :ivar CF: capacity factor (efficiency) (defaults to -1; CF<1.0 -> Ok; CF>1.0 -> KO) :ivar N: axial force (defaults to 0.0) :ivar My: bending moment about Y axis (defaults to 0.0)

getLaTeXFields(factor=0.001)

Returns a string with the intermediate fields of the LaTeX string.

Parameters:factor – factor for units (default 1e-3 -> kN)
getStrArguments(factor)

Returns a string for a ‘copy’ (kind of) constructor.

Parameters:factor – factor for units (default 1e-3 -> kN)
postprocess.control_vars.extrapolate_control_var(elemSet, propName, argument, initialValue=0.0)

Extrapolates element’s function values to the nodes.

Parameters:
  • elemSet – set of elements.
  • propName – name of the property that contains the control variables.
  • function – name of the function to call for each element.
  • argument – name of the control variable to extrapolate.
  • initialValue – initial value for the prop defined at the nodes.
postprocess.control_vars.writeControlVarsFromElements(controlVarName, preprocessor, outputFileName, outputCfg)

Writes in file ‘outputFileName’ the control-variable values calculated for elements in set ‘setCalc’.

Parameters:
  • controlVarName – name of the control var (e.g. ‘ULS_normalStressesResistance’ )
  • preprocessor – preprocessor from FEA model.
  • outputFileName – name of the files to write (.py and .tex)
  • outputCfg – instance of class ‘verifOutVars’ which defines the variables that control the output of the checking (set of elements to be analyzed [defaults to ‘total’], append or not the results to the result file [defatults to ‘N’], generation or not of list file [defatults to ‘N’, …)
postprocess.control_vars.writeControlVarsFromElementsForAnsys(controlVarName, preprocessor, outputFileName, sectionName1, sectionName2)
Parameters:
  • preprocessor – preprocessor name
  • outputFileName – name of the output file containing tue results of the verification
postprocess.control_vars.writeControlVarsFromPhantomElements(controlVarName, preprocessor, outputFileName, outputCfg)
Writes in file ‘outputFileName’ the control-variable values calculated for
the RC elements in the phantom model.
Parameters:
  • controlVarName – name of the control var.
  • preprocessor – preprocessor from FEA model.
  • outputFileName – name to the files (.py and .tex)
  • outputCfg – instance of class ‘verifOutVars’ which defines the variables that control the output of the checking (append or not the results to a file, generation or not of lists, …)

def_params_control

postprocess.def_params_control.defSteelShapeElasticRangeElementParameters(e, shape)
postprocess.def_params_control.defSteelShapeElasticRangeParametersForSet(elems, shape)

def_vars_control

THIS PROPERTIES MUST BE REPLACED BY THE CLASSES DEFINED IN control_vars.py THIS FILE MUST DISSAPEAR.

postprocess.def_vars_control.defVarControlMov(obj, code)
postprocess.def_vars_control.defVarsControlMovModulus(nodes)
postprocess.def_vars_control.defVarsControlMovs(nodes, flags)
postprocess.def_vars_control.defVarsControlTensRegElastico2d(elems)
postprocess.def_vars_control.defVarsControlTensRegElastico3d(elems)
postprocess.def_vars_control.defVarsEnvelopeInternalForcesBeamElems(elems)

Defines properties to store extreme values of internal forces.

postprocess.def_vars_control.updateEnvelopeInternalForcesBeamElem(beamElem)

Update values for extreme values of internal forces.

postprocess.def_vars_control.updateEnvelopeInternalForcesBeamElem2D(beamElem2D)

Update values for extreme values of internal forces in 2D elements.

element_section_map

class postprocess.element_section_map.ElementSectionMap

Bases: dict

dictionary that stores a section name(s) for each element number. This way it defines a spatial distribution of the sections over the structure.

assign(elemSet, setRCSects)

Assigns the sections names: setRCSectsName+‘1’, setRCSectsName+‘2’, … to the elements of the set.

Parameters:
  • elemSet – set of elements that receive the section name property.
  • setRCSects – RC section definition, name, concrete type, rebar positions,…
propName = 'sectionName'
postprocess.element_section_map.loadElementSectionMap()

extrapolate_elem_attr

postprocess.extrapolate_elem_attr.create_attribute_at_nodes(xcSet, attributeName, initialValue)

Create an attribute on the nodes of the set passed as parameter. return tags of the affected nodes.

Parameters:
  • xcSet – nodes that will receive the attribute.
  • attributeName – name of the attribute to define.
  • initialValue – initial value to assign to the attribute.
postprocess.extrapolate_elem_attr.extrapolate_elem_function_attr(elemSet, attributeName, function, argument, initialValue=0.0)

Extrapolate element’s function values to the nodes.

Parameters:
  • elemSet – set of elements.
  • attributeName – name of the property which will be defined at the nodes.
  • function – name of the function to call for each element.
  • argument – name of the argument to send to the function (optional).
  • initialValue – initial value for the attribute defined at the nodes.
postprocess.extrapolate_elem_attr.flatten_attribute(elemSet, attributeName, treshold, limit)

Reduce higher values which hide attribute variation over the model.

Parameters:
  • elemSet – set of elements to deal with.
  • attributeName – attribute to be flattened.
  • treshold – starting value to apply flatten.
  • limit – limit

figure_collection

class postprocess.figure_collection.FigsCollectionPlotter

Bases: object

fUnits = '[kN/m]'
fieldFilesPath = 'armatures/results/'
graphicOutputPath = 'post_process/results/figures/'
latexOutputPath = 'post_process/results/'
mUnits = '[kN m/m]'
plotFatigue(preprocessor, partName, elemSetName)
plotFissurationFreq(preprocessor, partName, elemSetName)
plotFissurationQP(preprocessor, partName, elemSetName)
plotNormalStresses(preprocessor, partName, elemSetName)
plotShear(preprocessor, partName, elemSetName)
sUnits = '[MPa]'
txtArmature1 = 'Armature en dir. long.'
txtArmature2 = 'Armature en dir. trsv.'

get_reactions

Reactions on nodes.

class postprocess.get_reactions.Reactions(preprocessor, supportNodes)

Bases: object

getReactionForces()

Returns a dictionary with the reactions forces at the nodes. The key of the map is the node tag.

getReactionMoments()

Returns a dictionary with the reactions moments at the nodes. The key of the map is the node tag.

getResultant()

limit_state_data

class postprocess.limit_state_data.FatigueResistanceRCLimitStateData

Bases: postprocess.limit_state_data.LimitStateData

Reinforced concrete shear resistance limit state data.

check(reinfConcreteSections, outputCfg=<postprocess.config.output_config.verifOutVars object>)

Checking of fatigue under fatigue combinations loads in ultimate limit states (see self.dumpCombinations).

Parameters:
  • reinfConcreteSections – Reinforced concrete sections on each element.
  • outputCfg – instance of class ‘verifOutVars’ which defines the variables that control the output of the checking (set of elements to be analyzed, append or not the results to a file, generation or not of lists, …)
dumpCombinations(combContainer, loadCombinations)

Load into the solver the combinations needed for this limit state.

Parameters:
  • combContainer – container with the definition of the different combination families (ULS, fatigue, SLS,…) see actions/combinations module.
  • loadCombinations – load combination handler inside the XC solver.
class postprocess.limit_state_data.FreqLoadsCrackControlRCLimitStateData

Bases: postprocess.limit_state_data.LimitStateData

Reinforced concrete crack control under frequent loads limit state data.

check(reinfConcreteSections, outputCfg=<postprocess.config.output_config.verifOutVars object>)
Checking of crack width under frequent loads in serviceability limit states
(see self.dumpCombinations).
Parameters:
  • reinfConcreteSections – Reinforced concrete sections on each element.
  • outputCfg – instance of class verifOutVars which defines the variables that control the output of the checking (set of elements to be analyzed, append or not the results to file, generation or not of lists, …)
dumpCombinations(combContainer, loadCombinations)

Load into the solver the combinations needed for this limit state.

Parameters:
  • combContainer – container with the definition of the different combination families (ULS, fatigue, SLS,…) see actions/combinations module.
  • loadCombinations – load combination handler inside the XC solver.
class postprocess.limit_state_data.FreqLoadsDisplacementControlLimitStateData

Bases: postprocess.limit_state_data.LimitStateData

Displacement control under frequent loads limit state data.

check(reinfConcreteSections)

Checking of displacements under frequent loads in serviceability limit states (see self.dumpCombinations).

Parameters:reinfConcreteSections – Reinforced concrete sections on each element.
dumpCombinations(combContainer, loadCombinations)

Load into the solver the combinations needed for this limit state.

Parameters:
  • combContainer – container with the definition of the different combination families (ULS, fatigue, SLS,…) see actions/combinations module.
  • loadCombinations – load combination handler inside the XC solver.
class postprocess.limit_state_data.LimitStateData(limitStateLabel, outputDataBaseFileName)

Bases: object

check_results_directory = './'
getDisplacementsFileName()

Return the file name to read: combination name, node number and displacements (ux,uy,uz,rotX,rotY,rotZ).

getInternalForcesFileName()

Return the file name to read: combination name, element number and internal forces.

getOutputDataBaseFileName()

Return the output file name without extension.

getOutputDataFileName()

Return the Python executable file name.

internal_forces_results_directory = './'
loadPickleObject(objName)

Read a Python object from a pickle file.

runChecking(outputCfg)

This method reads, for the elements in setCalc, the internal forces previously calculated and saved in the corresponding file. Using the ‘initControlVars’ and ‘checkSetFromIntForcFile’ methods of the controller, the appropiate attributes are assigned to the elements and the associated limit state verification is run. The results are written to a file in order to be displayed or listed.

Parameters:
  • outputCfg – instance of class ‘verifOutVars’ which defines the variables that control the output of the checking (set of elements to be analyzed, append or not the results to the result file [defatults to ‘N’], generation or not of list file [defatults to ‘N’, …)
  • setCalc – set that contains elements to be checked
  • appendToResFile – ‘Yes’,’Y’,’y’,.., if results are appended to existing file of results (defaults to ‘N’)
  • listFile – ‘Yes’,’Y’,’y’,.., if latex listing file of results is desired to be generated (defaults to ‘N’)
saveAll(feProblem, combContainer, setCalc, fConvIntForc=1.0, analysisToPerform=<function defaultAnalysis>, lstSteelBeams=None)

Write internal forces, displacements, .., for each combination

Parameters:
  • feProblem – XC finite element problem to deal with.
  • setCalc – set of entities for which the verification is going to be performed
  • fConvIntForc

    conversion factor between the unit of force in which the calculation is performed and that one desired for the displaying of internal forces (The use of this factor won’t be allowed in

    future versions)
  • lstSteelBeams – list of steel beams to analyze (defaults to None)
class postprocess.limit_state_data.NormalStressesRCLimitStateData

Bases: postprocess.limit_state_data.LimitStateData

Reinforced concrete normal stresses data for limit state checking.

check(reinfConcreteSections, outputCfg=<postprocess.config.output_config.verifOutVars object>)

Checking of normal stresses in ultimate limit states (see self.dumpCombinations).

Parameters:
  • reinfConcreteSections – Reinforced concrete sections on each element.
  • outputCfg – instance of class ‘verifOutVars’ which defines the variables that control the output of the checking (set of elements to be analyzed, append or not the results to a file, generation or not of lists, …)
dumpCombinations(combContainer, loadCombinations)

Load into the solver the combinations needed for this limit state.

Parameters:
  • combContainer – container with the definition of the different combination families (ULS, fatigue, SLS,…) see actions/combinations module.
  • loadCombinations – load combination handler inside the XC solver.
class postprocess.limit_state_data.QPLoadsCrackControlRCLimitStateData

Bases: postprocess.limit_state_data.LimitStateData

Reinforced concrete crack control under quasi-permanent loads limit state data.

check(reinfConcreteSections, outputCfg=<postprocess.config.output_config.verifOutVars object>)

Checking of crack width under quasi-permanent loads in serviceability limit states (see self.dumpCombinations).

Parameters:
  • reinfConcreteSections – Reinforced concrete sections on each element.
  • outputCfg – instance of class verifOutVars which defines the variables that control the output of the checking (set of elements to be analyzed, append or not the results to file, generation or not of lists, …)
dumpCombinations(combContainer, loadCombinations)

Load into the solver the combinations needed for this limit state.

Parameters:
  • combContainer – container with the definition of the different combination families (ULS, fatigue, SLS,…) see actions/combinations module.
  • loadCombinations – load combination handler inside the XC solver.
class postprocess.limit_state_data.ShearResistanceRCLimitStateData

Bases: postprocess.limit_state_data.LimitStateData

Reinforced concrete shear resistance limit state data.

check(reinfConcreteSections, outputCfg=<postprocess.config.output_config.verifOutVars object>)

Checking of shear resistance in ultimate limit states (see self.dumpCombinations).

Parameters:
  • reinfConcreteSections – Reinforced concrete sections on each element.
  • outputCfg – instance of class ‘verifOutVars’ which defines the variables that control the output of the checking (set of elements to be analyzed, append or not the results to a file, generation or not of lists, …)
dumpCombinations(combContainer, loadCombinations)

Load into the solver the combinations needed for this limit state.

Parameters:
  • combContainer – container with the definition of the different combination families (ULS, fatigue, SLS,…) see actions/combinations module.
  • loadCombinations – load combination handler inside the XC solver.
postprocess.limit_state_data.defaultAnalysis(feProb, steps=1)

Default analysis procedure for saveAll method.

postprocess.limit_state_data.readIntForcesFile(intForcCombFileName, setCalc=None)

Extracts element and combination identifiers from the internal forces listing file. Return elementTags, idCombs and internal-forces values

Parameters:
  • intForcCombFileName – name of the file containing the internal forces obtained for each element for the combinations analyzed
  • setCalc – set of elements to be analyzed (defaults to None which means that all the elements in the file of internal forces results are analyzed)

med_xc_vars

phantom_model

class postprocess.phantom_model.PhantomModel(preprocessor, sectionDistribution)

Bases: object

build(intForcCombFileName, controller, setCalc=None)

Builds the phantom model from the data read from the file.

Parameters:
  • intForcCombFileName – name of the file containing the forces and bending moments obtained for each element for all the combinations analyzed
  • controller – object that takes the internal forces and the section definition and checks the limit state.
  • setCalc – set of elements to be analyzed (defaults to None which means that all the elements in the file of internal forces results are analyzed)
check(controller)

Runs the analysis (linear) and checking of combinations passed as parameters

Parameters:
  • elements – elements to check
  • analysis – type of analysis
  • controller – object that controls limit state in elements.
createElements(intForcCombFileName, controller, setCalc=None)

Creates the phantom model elements from the data read on the file.

Parameters:
  • intForcCombFileName – name of the file containing the internal forces obtained for each element for the combinations analyzed
  • controller – object that takes the internal forces and the section definition and checks the limit state.
  • setCalc – set of elements to be analyzed (defaults to None which means that all the elements in the file of internal forces results are analyzed)
createLoads(intForcCombFileName, controller)

Creates the loads from the data read from the file.

Parameters:
  • intForcCombFileName – name of the file containing the forces and bending moments obtained for each element for all the combinations analyzed
  • controller – object that takes the internal forces and the section definition and checks the limit state.
createPhantomElement(idElem, sectionName, sectionDefinition, sectionIndex, interactionDiagram, fakeSection)

Creates a phantom element (that represents a section to check)

Parameters:
  • idElem – identifier of the element in the “true” model associated with the phantom element to be created.
  • sectionName – name of the 3D fiber section to create the zero-length phantom element (default material)
  • idSection – name of the section assigned to the phantom element (the section to check) -sectionName-.
  • sectionIndex – index of the section in the “true” model element -sectionIndex-. To be renamed as sectionIndex.
  • interactionDiagram – interaction diagram that corresponds to the section to check.
  • fakeSection – if True (default value) generates a fake section of type ‘xc.ElasticShearSection3d’, if False, generates a true fiber model of the section (xc.FiberSectionShear3d)
runChecking(limitStateData, outputCfg)

Run the analysis, check the results and write them into a file

Parameters:
  • limitStateData – object that contains the name of the file containing the internal forces obtained for each element for the combinations analyzed and the controller to use for the checking.
  • outputCfg – instance of class ‘verifOutVars’ which defines the variables that control the output of the checking (set of elements to be analyzed, append or not the results to a file, generation or not of lists, …)
setupForElementsAndCombinations(intForcCombFileName, setCalc=None)
Extracts element and combination identifiers from the internal
forces listing file.
Parameters:
  • intForcCombFileName – name of the file containing the internal forces obtained for each element for the combinations analyzed
  • setCalc – set of elements to be analyzed (defaults to None which means that all the elements in the file of internal forces results are analyzed)
write(controller, outputFileName, outputCfg)

Writes results into the output file

Parameters:
  • controller – object that controls limit state in elements
  • outputFileName – base name of output file (extensions .py and .tex)
  • outputCfg – instance of class ‘verifOutVars’ which defines the variables that control the output of the checking (append or not the results to a file, generation or not of lists, …)

prop_statistics

postprocess.prop_statistics.getItemWithMaxProp(iterable, attrName, argv='')

Return item wich maximizes property named as indicated in attrName

postprocess.prop_statistics.getItemWithMinProp(iterable, attrName)

Return item wich minimizes property named as indicated in attrName

postprocess.prop_statistics.rec_getattr(obj, attr, argv='')

Get object’s attribute. May use dot notation.

>>> class C(object): pass
>>> a = C()
>>> a.b = C()
>>> a.b.c = 4
>>> rec_getattr(a, 'b.c')
4
postprocess.prop_statistics.rec_setattr(obj, attr, value)

Set object’s attribute. May use dot notation.

>>> class C(object): pass
>>> a = C()
>>> a.b = C()
>>> a.b.c = 4
>>> rec_setattr(a, 'b.c', 2)
>>> a.b.c
2

RC_material_distribution

class postprocess.RC_material_distribution.RCMaterialDistribution

Bases: object

Spatial distribution of reinforced concrete material
(RC sections distribution over the elements).

It refers to the reinforced concrete sections associated with the element (i.e. for shell elements we typically define two RC sections, one for each main direction; in the case of beam elements the most common way is to define RC sections in the front and back ends of the elements)

assign(elemSet, setRCSects)

Assigns the sections names: setRCSectsName+‘1’, setRCSectsName+‘2’, … to the elements of the set.

Parameters:
  • elemSet – set of elements that receive the section name property.
  • setRCSects – RC section definition, name, concrete type, rebar positions,…
dump()

Writes this object in a pickle file.

getElementSet(preprocessor)

Returns an XC set that contains all the elements with an assigned section.

getSectionDefinition(sectionName)

Returns the section definition which has the name being passed as a parameter.

getSectionDefinitionsForElement(tagElem)

Returns the section names for the element which tag is being passed as a parameter.

getSectionNamesForElement(tagElem)

Returns the section names for the element which tag is being passed as a parameter.

internalForcesVerification2D(limitStateData, matDiagType, setCalc=None)

Limit state verification based on internal force (Fx,Fy,Mz) values.

Parameters:
  • limitStateData – object that contains the name of the file containing the internal forces obtained for each element for the combinations analyzed and the controller to use for the checking.
  • matDiagType – type of the material diagram (d: design, k: characteristic).
  • setCalc – set of elements to be analyzed (defaults to None which means that all the elements in the file of internal forces results are analyzed)
internalForcesVerification3D(limitStateData, matDiagType, outputCfg)

Limit state verification based on internal force (Fx,Fy,Fz,Mx,My,Mz) values.

Parameters:
  • limitStateData – object that contains the name of the file containing the internal forces obtained for each element for the combinations analyzed and the controller to use for the checking.
  • matDiagType – type of the material diagram (d: design, k: characteristic).
  • outputCfg – instance of class ‘verifOutVars’ which defines the variables that control the output of the checking (set of elements to be analyzed, append or not the results to a file, generation or not of lists, …)
load()

Reads this object from a pickle file.

mapSectionsFileName = './mapSectionsReinforcement.pkl'
runChecking(limitStateData, matDiagType, threeDim=True, outputCfg=<postprocess.config.output_config.verifOutVars object>)

Creates the phantom model and runs the verification on it.

Parameters:
  • limitStateData – object that contains the name of the file containing the internal forces obtained for each element for the combinations analyzed and the controller to use for the checking.
  • matDiagType – type of the material diagram (d: design, k: characteristic).
  • threeDim – true if it’s 3D (Fx,Fy,Fz,Mx,My,Mz) false if it’s 2D (Fx,Fy,Mz).
  • outputCfg – instance of class ‘verifOutVars’ which defines the variables that control the output of the checking (set of elements to be analyzed, append or not the results to a file, generation or not of lists, …)
postprocess.RC_material_distribution.loadRCMaterialDistribution()

Load the reinforced concrete sections on each element from file.

recorders

postprocess.recorders.installNodeDisplacementRecorder(recorderName, nodeSet)

utils_display

class postprocess.utils_display.FigureBase(pLabel, limitStateLabel, figDescr, reinfDescr=None, units=None, sz='90mm')

Bases: object

getCaption()
getFileName()
insertIntoLatex(fichLatexFigs, fichLatexList, fichFig, labelText)
Parameters:
  • fichLatexFigs – latex file to insert graphic into
  • fichFig – name of the file that contains the graphic (complete path without extension).
class postprocess.utils_display.FigureDefinition(pLabel, limitStateLabel, attrName, argument, figDescr, reinfDescr=None, units=None, sz='90mm')

Bases: postprocess.utils_display.SlideDefinition

defField(xcSet)
diagrams = None
genGraphicFile(defDisplay, xcSet, nmbFichGraf)
class postprocess.utils_display.PartToDisplay(partName, surfaceList, reinforcementLabels)

Bases: object

display(preprocessor, tp, resultsToDisplay)

Generate an image for every result to display resultToDisplay: collection of results to be displayed.

getElementSet(preprocessor)
getElements()

Returns a list of the elements of this part.

getShortName()
class postprocess.utils_display.PartToDisplayContainer(lst)

Bases: dict

Parts to display in figures…

add(part)
display(preprocessor, tp, resultsToDisplay)

Display results for each part. resultToDisplay: collection of results to be displayed.

class postprocess.utils_display.SlideDefinition(pLabel, limitStateLabel, figDescr, reinfDescr=None, units=None, sz='90mm')

Bases: postprocess.utils_display.FigureBase

genGraphicFile(preprocessor, defDisplay, xcSet, nmbFichGraf)
setupDiagrams()
class postprocess.utils_display.TakePhotos(xcSet)

Bases: object

Generation of bitmaps with analysis and design results.

displayFigures(figDefinitionList, LatexFigsFilename, LatexListFilename)

Creates graphics files from figure definition list.

Parameters:
  • nmbLstIss – name of the lists that contains the results to display.
  • LatexFilename – name of the LaTeX file to write the graphics on.
insertFigureLatex(figDef, conta, fichFig, labelText)
Parameters:
  • fichLatexFigs – latex file to insert graphic into
  • fichFig – name of the file that contains the graphic (complete path without extension).
plotFigures(preprocessor, figDefinitionList, LatexFigsFilename, LatexListFilename)
postprocess.utils_display.plotStressStrainFibSet(fiberSet, title, fileName=None, nContours=100, pointSize=50)

Represents graphically the cross-section current stresses and strains. The graphics are generated by a triangulation from the x,y coordinates of the fibers.

Parameters:
  • fiberSet – set of fibers to be represented
  • title – general title for the graphic
  • fileName – name of the graphic file (defaults to None: no file generated)
  • nContours – number of contours to be generated (defaults to 100). If nContours=0 or nContours=None, then each fiber is represented by a colored circle.
  • pointSize – size of the circles to represent each of the fibers in the set in the case that nContours=0 or nContours=None (defaults to 50)
class postprocess.utils_display.setToDisplay(elSet, genDescr='', sectDescr=[])

Bases: object

Defines the description of a set of elements to be used in the graphics and reports associated with the calculation

Variables:
  • elSet – set of elements
  • genDescr – general description
:ivar sectDescr:ordered list with the descriptions that apply to each of the
sections that configures the element.