staad-analysis

STAAD.Pro Analysis

Instructions

Linear Static Analysis (two steps)

1. cmd.PerformAnalysis(printOption) — adds the PERFORM ANALYSIS command. Call ONCE only.
2. staad.SaveModel(True) + staad.AnalyzeEx(1, 0, 1) — saves the file, then runs the solver.

Both steps are required. PerformAnalysis alone does NOT run the solver.

Running the Solver — prefer AnalyzeEx

AnalyzeEx is the preferred solver function — it returns a status code and runs both analysis and design. AnalyzeModel is a simpler alternative with no return value (analysis only, no design).

cmd = staad.Command
staad.SetSilentMode(True)
staad.SaveModel(True)
status = staad.AnalyzeEx(1, 0, 1)  # silent, visible, waitTillComplete
staad.SetSilentMode(False)
# status: 2=OK, 3=warnings, 4=errors, -1=terminated

Analysis Messages (Requires STAAD.Pro v26+)

After a run, retrieve the solver's error/warning text. These COM functions exist only on STAAD.Pro v26+ — confirm the connected instance's version from list_instances / get_status before calling (see staad-core → Version Compatibility). On older STAAD they raise an "update STAAD.Pro" error.

These methods live on the root staad object.

errors = staad.GetAnalysisErrorMessages()     # solver error messages
warnings = staad.GetAnalysisWarningMessages()  # solver warning messages

GetAnalysisStatus() raises an exception when the run returned an error (negative) status code — execute_code reports it; no try/except needed unless you want to continue after a failure.

Print Options

Value	Output
0	No print
1	Load data
2	Statics check
3	Statics load
4	Mode shapes
5	Both
6	All

P-Delta Analysis

cmd = staad.Command
cmd.PerformPDeltaAnalysisNoConverge(NoOfIterations=5, PrintOption=0)

cmd.PerformPDeltaAnalysisEx(
    NoOfIterations=20, PrintOption=0,
    bSmallDelta=1,            # 1=P-small-delta, 0=P-large-delta
    AddGeometricStiffness=1   # 1=include geometric stiffness
)