Skip to main content

Running Analysis

You can analyze a single load case, a single load combination, or all scenarios.

Single load case​

RunAnalysis(...) throws for invalid/unstable models (for example failed validation, mechanisms, matrix issues), so handle exceptions around the call:

try
{
    var result = model.RunAnalysis(deadCase);
    // use result
}
catch (Exception ex)
{
    Console.WriteLine($"Analysis failed: {ex.Message}");
}

Single load combination​

try
{
    var result = model.RunAnalysis(ulsCombination);
}
catch (Exception ex)
{
    Console.WriteLine($"Combination analysis failed: {ex.Message}");
}

All scenarios​

var scenarioResults = model.RunAllScenarios();

If model-defined combinations exist, they are used. Otherwise, combinations can be generated ephemerally from project.ActiveDesignCode.

Partial-failure aggregation alternative​

If you want one API call that keeps successful cases and records failed ones, use:

var resultSet = model.BuildResultSet();
Console.WriteLine(resultSet.Status);       // Success or PartialFailure
Console.WriteLine(resultSet.ErrorMessage); // aggregated failure details (if any)

End-to-end analysis + evaluation​

var evaluation = model.AnalyseAndEvaluateAll();

This runs scenario analyses and returns a governing design-check envelope.