get_results#
- dlubal.api.rfem.Application.get_results(self, results_type, filters=None, member_axes_system=None, nodal_support_coordinate_system=None, **keyword_filters)#
Returns Table, which is just a convenience wrapper around a Pandas Dataframe. The Dataframe can be directly accessed as .data
- Parameters:
results_type (ResultsType | None) – Unique identifier of the result category type.
filters (ResultsFilter, optional) – Filter(s) to return only relevant results.
member_axes_system (MemberAxesSystem, optional) – Axes system to use for member results.
nodal_support_coordinate_system (CoordinateSystem, optional) – Axes system to use for nodal support results.
- Returns:
The requested results wrapped as a table.
- Return type:
table_data (TableData)
Example - Analysis results
# Optional filter to limit the amount of data retrieved
member_filter = rfem.results.ResultsFilter(
column_id='member_no',
filter_expression='2' # Filter results for member number 2
)
# Retrieve all internal forces results filtered by the specified member,
# returned as a pandas DataFrame
results_df = rfem_app.get_results(
results_type=rfem.results.STATIC_ANALYSIS_MEMBERS_INTERNAL_FORCES,
filters=[member_filter],
).data
print("\nAll Results:")
print(results_df)
// Get all internal forces results as a pandas DataFrame
var member_filter = new rfem.Results.ResultsFilter
{
ColumnId = "MemberNo",
FilterExpression = "2"
};
var results = await rfem_app.get_results(
resultsType: rfem.Results.ResultsType.StaticAnalysisMembersInternalForces,
filters: new List<ResultsFilter> { member_filter }
);
Output:
Internal Forces:
loading member_no min_max tag node_no x n v_y v_z m_t m_y m_z m_omega m_t_pri m_t_sec p v
0 LC1 1 0 0 1 0.0 0.0 5000.0 15322.299805 0.0 -75966.898438 30000.0 0.0 0.0 0.0 0.0 0.0
1 LC1 1 0 0 0 0.6 0.0 5000.0 14790.070312 0.0 -66933.187500 27000.0 0.0 0.0 0.0 0.0 0.0
2 LC1 1 0 0 0 1.2 0.0 5000.0 14257.839844 0.0 -58218.820312 24000.0 0.0 0.0 0.0 0.0 0.0
3 LC1 1 0 0 0 1.8 0.0 5000.0 13725.610352 0.0 -49823.781250 21000.0 0.0 0.0 0.0 0.0 0.0
4 LC1 1 0 0 0 2.4 0.0 5000.0 13193.379883 0.0 -41748.078125 18000.0 0.0 0.0 0.0 0.0 0.0
.. ... ... ... .. ... ... ... ... ... ... ... ... ... ... ... ... ...
270 CO1 1 0 0 0 3.6 0.0 6750.0 52374.050781 0.0 -79048.851562 16200.0 0.0 0.0 0.0 0.0 0.0
271 CO1 1 0 0 0 4.2 0.0 6750.0 42655.539062 0.0 -50539.980469 12150.0 0.0 0.0 0.0 0.0 0.0
272 CO1 1 0 0 0 4.8 0.0 6750.0 32937.019531 0.0 -27862.210938 8100.0 0.0 0.0 0.0 0.0 0.0
273 CO1 1 0 0 0 5.4 0.0 6750.0 23218.509766 0.0 -11015.549805 4050.0 0.0 0.0 0.0 0.0 0.0
274 CO1 1 0 0 2 6.0 0.0 6750.0 13500.000000 0.0 0.000000 0.0 0.0 0.0 0.0 0.0 0.0
[275 rows x 17 columns]
Example - Design Add-on results including details
# Retrieve design check results, returned as a pandas DataFrame
steel_design_check = rfem_app.get_results(
results_type=rfem.results.STEEL_DESIGN_MEMBERS_DESIGN_RATIOS_BY_LOCATION
).data
print(f"\nSteel Design Ratios by Location:")
print(steel_design_check)
# Retrieve design check details (for the maximum ratio)
max_design_ratio_row = steel_design_check.loc[steel_design_check['design_ratio'].idxmax()]
design_check_details_id = max_design_ratio_row['design_check_details_id']
steel_design_details = rfem_app.get_results(
results_type=rfem.results.STEEL_DESIGN_DESIGN_CHECK_DETAILS,
filters=[rfem.results.ResultsFilter(
column_id="design_check_details_id",
filter_expression=str(design_check_details_id))],
).data
print(f"\nSteel Design Check Details:")
print(steel_design_details)
// Retrieve design check results, returned as a pandas DataFrame
var steelDesignCheck = await rfemApp.get_results(
rfem.Results.ResultsType.SteelDesignMembersDesignRatiosByLocation
);
Console.WriteLine("Steel Design Ratios by Location:");
Console.WriteLine(steelDesignCheck);
// Retrieve design check details (for the maximum ratio)
var maxDesignRatioRow = steelDesignCheck.Rows
.OrderByDescending(row =>
{
// Try to parse the design_ratio string to double
double result = 0.0;
double.TryParse(row["design_ratio"].ToString(), out result); // Parsing the value safely
return result;
})
.FirstOrDefault(); // Get the first row with the maximum design ratio
var designCheckDetailsId = maxDesignRatioRow["design_check_details_id"];
var steelDesignCheckDetails = await rfemApp.get_results(
resultsType: rfem.Results.ResultsType.SteelDesignDesignCheckDetails,
filters: new List<rfem.Results.ResultsFilter>
{
new rfem.Results.ResultsFilter {
ColumnId = "design_check_details_id",
FilterExpression = designCheckDetailsId.ToString(),
},
}
);
Console.WriteLine("Steel Design Check Details:");
Console.WriteLine(steelDesignCheckDetails);
Output:
Steel Design Ratios by Location:
member_no member_set_no design_situation_no location_x material_no section_no loading design_check_type design_ratio design_check_description design_check_details_id is_valid
0 1 <NA> 1 1.0 1 1 CO1 SP1200.00 0.2854 Compression acc. to EN 1993-1-1, 6.2.4 1 True
1 1 <NA> 1 0.0 1 1 CO1 ST1300.00 0.718232 Flexural buckling about principal z-axis acc. ... 2 True
2 1 <NA> 1 0.0 1 1 CO1 SP1200.00 0.2854 Compression acc. to EN 1993-1-1, 6.2.4 3 True
3 1 <NA> 1 5.0 1 1 CO1 SP1200.00 0.2854 Compression acc. to EN 1993-1-1, 6.2.4 4 True
4 1 <NA> 1 0.0 1 1 CO1 ST1100.00 0.418843 Flexural buckling about principal y-axis acc. ... 5 True
5 1 <NA> 1 6.0 1 1 CO1 ST1100.00 0.418843 Flexural buckling about principal y-axis acc. ... 6 True
6 1 <NA> 1 0.0 1 1 CO1 ST1500.00 0.416781 Torsional buckling acc. to EN 1993-1-1, 6.3.1 7 True
7 1 <NA> 1 2.0 1 1 CO1 ST1100.00 0.418843 Flexural buckling about principal y-axis acc. ... 8 True
8 1 <NA> 1 1.0 1 1 CO1 ST1100.00 0.418843 Flexural buckling about principal y-axis acc. ... 9 True
9 1 <NA> 1 1.0 1 1 CO1 ST1500.00 0.416781 Torsional buckling acc. to EN 1993-1-1, 6.3.1 10 True
10 1 <NA> 1 4.0 1 1 CO1 ST1300.00 0.718232 Flexural buckling about principal z-axis acc. ... 11 True
Steel Design Check Details:
description symbol value value_si unit notice equation
0 Material Properties | S235 | CYS EN 1993-1-1:2... <NA> -- -- <NA> <NA> <NA>
1 Basic properties <NA> -- -- <NA> <NA> <NA>
1 Basic properties <NA> -- -- <NA> <NA> <NA>
1 Basic properties <NA> -- -- <NA> <NA> <NA>
2 Modulus of elasticity E 210000.0 210000000000.0 N/mm<sup>2</sup> <NA> <NA>
3 Shear modulus G 80769.2 80769230769.23077 N/mm<sup>2</sup> <NA> <NA>
4 Poisson's ratio ν 0.300 0.3 -- <NA> <NA>
.. ... ... ... ... ... ... ...
237 Value to determine reduction factor χ Φ<sub>z</sub> 1.455 1.4549744129180908 -- <NA> 6.3.1.2(1)
238 Reduction factor χ<sub>z</sub> 0.44 0.43710169196128845 -- <NA> 6.3.1.2(1), Eq. 6.49
239 Design buckling resistance of a compression me... N<sub>b,z,Rd</sub> 1392.31 1392307.875 kN <NA> 6.3.1.1(3)
240 <NA> <NA> -- -- <NA> <NA> <NA>
241 Design check ratio η <b>0.718</b> 0.7182319164276123 -- <b>≤ 1</b> EN 1993-1-1, 6.3.1