Results Axes System#

In this example we will demonstrate how to:

Retrieve support forces in local or global coordinate systems.
Retrieve member forces in local or principal axes.
Get warning message when input of results settings is wrong.

from dlubal.api import rstab, common

with rstab.Application() as rstab_app:

    # --- Support Forces ---
    # The direction of support forces can be defined in either the Local (default) or Global
    # Coordinate System (CS). This choice affects how the support reactions are
    # recalculated and aligned with the selected coordinate system for correct results.

    # Get results
    support_forces: common.Table = rstab_app.get_results(
        results_type=rstab.results.ResultsType.STATIC_ANALYSIS_NODES_SUPPORT_FORCES,
        support_coordinate_system=rstab.results.settings.CoordinateSystem.COORDINATE_SYSTEM_GLOBAL
    )
    print(f"\nSupport Forces:\n{support_forces.data}")

    # Get result table
    support_forces_table: common.Table = rstab_app.get_result_table(
        table=rstab.results.ResultTable.STATIC_ANALYSIS_NODES_SUPPORT_FORCES_TABLE,
        loading= rstab.ObjectId(
            no=1,
            object_type=rstab.OBJECT_TYPE_LOAD_CASE
        ),
        support_coordinate_system=rstab.results.settings.CoordinateSystem.COORDINATE_SYSTEM_GLOBAL
    )
    print(f"\nSupport Forces Table:\n{support_forces_table.data}")


    # --- Member Forces ---
    # Member forces can be defined in either the Member Local XYZ (default)
    # or the Principal Axes XUV coordinate system. This choice determines how
    # the forces are calculated and aligned according to the respective axes
    # system of the member's geometry.

    # Get results
    member_forces: common.Table = rstab_app.get_results(
        results_type=rstab.results.ResultsType.STATIC_ANALYSIS_MEMBERS_INTERNAL_FORCES,
        member_axes_system=rstab.results.settings.MEMBER_AXES_SYSTEM_PRINCIPAL_AXES_X_U_V,
    )
    print(f"\nMember Forces:\n{member_forces.data}")

    # Get result table
    member_forces_table: common.Table = rstab_app.get_result_table(
        table=rstab.results.ResultTable.STATIC_ANALYSIS_MEMBERS_INTERNAL_FORCES_TABLE,
        loading= rstab.ObjectId(
            no=1,
            object_type=rstab.OBJECT_TYPE_LOAD_CASE
        ),
        member_axes_system=rstab.results.settings.MEMBER_AXES_SYSTEM_PRINCIPAL_AXES_X_U_V,
    )
    print(f"\nMember Forces Table:\n{member_forces_table.data}")

using Rstab = Dlubal.Api.Rstab;
using Common = Dlubal.Api.Common;

ApplicationRstab? RstabApp = null;

try
{
    RstabApp = new ApplicationRstab();

    // --- Support Forces ---
    // The direction of support forces can be defined in either the Local (default) or Global
    // Coordinate System (CS). This choice affects how the support reactions are
    // recalculated and aligned with the selected coordinate system for correct results.

    // Get results
    Common.Table supportForces = await RstabApp.get_results(
        resultsType: Rstab.Results.ResultsType.StaticAnalysisNodesSupportForces,
        supportCoordinateSystem: Rstab.Results.Settings.CoordinateSystem.Global
    );
    Console.WriteLine($"\nSupport Forces:\n{supportForces.Data}");

    // Get result table
    Common.Table supportForcesTable = await RstabApp.get_result_table(
        table: Rstab.Results.ResultTable.StaticAnalysisNodesSupportForcesTable,
        loading: new Rstab.ObjectId
        {
            No = 1,
            ObjectType = Rstab.ObjectType.LoadCase
        },
        supportCoordinateSystem: Rstab.Results.Settings.CoordinateSystem.Global
    );
    Console.WriteLine($"\nSupport Forces Table:\n{supportForcesTable.Data}");


    // --- Member Forces ---
    // Member forces can be defined in either the Member Local XYZ (default)
    // or the Principal Axes XUV coordinate system. This choice determines how
    // the forces are calculated and aligned according to the respective axes
    // system of the member's geometry.

    // Get results
    Common.Table memberForces = await RstabApp.get_results(
        resultsType: Rstab.Results.ResultsType.StaticAnalysisMembersInternalForces,
        memberAxesSystem: Rstab.Results.Settings.MemberAxesSystem.PrincipalAxesXUV
    );
    Console.WriteLine($"\nMember Forces:\n{memberForces.Data}");

    // Get result table
    Common.Table memberForcesTable = await RstabApp.get_result_table(
        table: Rstab.Results.ResultTable.StaticAnalysisMembersInternalForcesTable,
        loading: new Rstab.ObjectId
        {
            No = 1,
            ObjectType = Rstab.ObjectType.LoadCase
        },
        memberAxesSystem: Rstab.Results.Settings.MemberAxesSystem.PrincipalAxesXUV
    );
    Console.WriteLine($"\nMember Forces Table:\n{memberForces.Data}")

}
catch (Exception ex)
{
    Console.WriteLine($"Error: {ex.Message}");
}
finally
{
    if (RstabApp != null) await RstabApp.close_connection();
}