Filter analysis results by load case
Every result endpoint accepts a Cases query parameter to restrict
the response to a subset of analysed cases. The format is SG's list
syntax — comma-separated Ids and dash ranges in a single string:
| Filter | Meaning |
|---|---|
"1" | Just case 1 |
"1,3,7" | Cases 1, 3, and 7 |
"1,3-7,10" | Case 1, 3 through 7 inclusive, and 10 |
"" or omit | All analysed cases |
The same format applies to Nodes, Members, Modes, and any other
list filter.
The snippet below opens the Portal Frame.SG sample, runs a linear
static analysis, then reads node reactions filtered to load case 1.
Adjust the case Id to match a case that exists in your model.
try / finally closes the job at the end even if a step in the middle
throws.
Always check Warnings.CasesNotAnalyzed
If you ask for a case that hasn't been analysed (or, for a combination,
any of its primary cases), it appears in Warnings.CasesNotAnalyzed
and silently returns no rows for that case. Check the warning before
reading Results so a missing run doesn't look like clean data.