STAAD.Pro Analysis Results

Instructions

• Define shorthands once per script: out = staad.Output, load = staad.Load

Always Check First

• out.AreResultsAvailable() → True if results exist; False if analysis has not run
• If False, run analysis before querying any results (see staad-analysis skill)

Load Cases

• load.GetPrimaryLoadCaseNumbers() → returns a tuple — always wrap in list() before indexing
• Never hardcode load case numbers — always fetch dynamically

Output Units

out.GetOutputUnitForForce()         # e.g. "KIP"
out.GetOutputUnitForMoment()        # e.g. "KIP-IN"
out.GetOutputUnitForDisplacement()  # e.g. "in"
out.GetOutputUnitForStress()        # e.g. "KSI"
out.GetOutputUnitForDimension()
out.GetOutputUnitForRotation()

The GetOutputUnitFor* methods raise on error (e.g. if the model has no output units established yet) — execute_code reports any such error.

Analysis Messages

For the solver's error/warning text after a run (GetAnalysisErrorMessages / GetAnalysisWarningMessages), see the staad-analysis skill.

Node Results

Member Forces

Intermediate Forces

out.GetIntermediateMemberForcesAtDistance(bid, distance, lc)
out.GetIntermediateMemberTransDisplacements(bid, distance, lc)
out.GetIntermediateDeflectionAtDistance(bid, distance, lc)

Plate Results

# Center stresses [SQX, SQY, MX, MY, MXY, SX, SY, SXY]
out.GetAllPlateCenterStressesAndMoments(plateNo, lc)
out.GetAllPlateCenterForces(plateNo, lc)
out.GetAllPlateCenterMoments(plateNo, lc)
out.GetPlateCenterNormalPrincipalStresses(plateNo, lc)
out.GetAllPlateCenterPrincipalStressesAndAngles(plateNo, lc)
out.GetPlateCenterVonMisesStresses(plateNo, lc)

# Corner forces
out.GetPlateCornerForces(plateNo, cornerCode, lc)  # cornerCode = node number

# Stress at arbitrary point
out.GetPlateStressAtPoint(plateNo, lc, stressPoint, facingPoint)  # [x,y,z] lists

Solid Results

out.GetAllSolidNormalStresses(solidNo, corner, lc)    # corner 1-8
out.GetAllSolidShearStresses(solidNo, corner, lc)
out.GetAllSolidPrincipalStresses(solidNo, corner, lc)
out.GetAllSolidVonMisesStresses(solidNo, corner, lc)

Modal Analysis Results

n_modes = out.GetNoOfModesExtracted()
freq    = out.GetModeFrequency(modeNo)               # Hz
disp    = out.GetModalDisplacementAtNode(modeNo, nid) # [X,Y,Z,rX,rY,rZ]
factors = out.GetModalMassParticipationFactors(modeNo)

Buckling Results

if out.IsBucklingAnalysisResultsAvailable():
    n = out.GetNoOfBucklingFactors()
    factor = out.GetBucklingFactor(modeNo)
    disp = out.GetBucklingModeDisplacementAtNode(modeNo, nid)  # [X,Y,Z,rX,rY,rZ]

Time-History Results

delta, n_steps = out.GetTimeHistoryIntegrationStepInfo()
# DOF: 1-3=trans, 4-6=rot; response_type: 0=disp, 1=vel, 2=accel
responses = out.GetTimeHistoryResponse(lc, nid, dof, response_type)
resp_at_t = out.GetTimeHistoryResponseAtTime(lc, nid, dof, response_type, time)
resp_min, resp_max = out.GetTimeHistoryResponseMinMax(lc, nid, dof, response_type)

Nonlinear Results

n_steps = out.GetNLLoadStep(lc)
load_level, displacements = out.GetNLNodeDisplacements(nid, lc, loadStep)

Steel Design Results

# Single-block (all codes)
(code, status, ratio, allow, lc, loc, clause, section, forces, klr) = out.GetMemberSteelDesignResults(bid)
# status: 'PASS' or 'FAIL'; ratio > 1.0 = failure

ratio = out.GetMemberSteelDesignRatio(bid)       # -999=not designed, -1=no analysis
max_r = out.GetMemberSteelDesignMaxFailureRatio() # model-wide max
min_r = out.GetMemberSteelDesignMinFailureRatio() # model-wide min

# Multi-block (AISC 360 etc.)
if out.IsMultipleMemberSteelDesignResultsAvailable():
    n_blocks = out.GetSteelDesignParameterBlockCount()
    blk_name = out.GetSteelDesignParameterBlockNameByIndex(i)
    ratio = out.GetMultipleMemberSteelDesignRatio(blk_name, bid)
    max_ratio = out.GetMultipleMemberSteelDesignMaxRatio(bid)

Physical Member Forces

out.GetPMemberEndForces(memberNo, end, lc, localOrGlobal)
out.GetPMemberIntermediateForcesAtDistance(memberNo, distance, lc)

Foundation Results

out.GetStaticCheckResult(lc)
out.GetMatInfluenceAreas(nodeList)
out.GetBasePressures(lc, nodeList)

Example

See fetch-forces.py for a complete working example.

Gotchas

• GetMinMaxShearForce and GetMinMaxBendingMoment dir argument is a string ('FY', 'MZ'), not an integer
• GetMemberEndForces at end 0 (StartA) and end 1 (EndB) have opposite sign conventions
• GetPrimaryLoadCaseNumbers() returns a tuple — convert with list() before indexing
• GetMemberSteelDesignResults raises an error for members not in the design brief
• Always call AreResultsAvailable() before any output query