get_results#

dlubal.api.rfem.Application.get_results(self, results_type, filters=None, member_axes_system=None, support_coordinate_system=None, model_id=None, **keyword_filters)#

Retrieves complete, unprocessed results from the database wrapped in a DataFrame for more efficient analysis.

Parameters:

  • results_type (ResultsType) – Unique identifier for the result category type.

  • filters (ResultsFilter | None) – One or more filters to return only relevant results.

  • member_axes_system (MemberAxesSystem | None) – The axes system to use for member results. If not provided, it defaults to MEMBER_AXES_SYSTEM_MEMBER_AXES_X_Y_Z.

  • support_coordinate_system (CoordinateSystem | None) – The coordinate system to use for support results. If not provided, it defaults to COORDINATE_SYSTEM_LOCAL.

  • model_id (ModelId | None) – Unique identifier of the model. If None, the active model is used.

Returns:

A Table object containing the results as a DataFrame.

Usage

# Retrieves complete, unprocessed results from the RFEM database.
# Filters can be applied to limit the data retrieved (currently by 'object_no' or 'loading').
# The results are then wrapped in a DataFrame (.data) for efficient analysis and manipulation.
results: common.Table = rfem_app.get_results(
    results_type=rfem.results.STATIC_ANALYSIS_MEMBERS_INTERNAL_FORCES,
    filters=[
        rfem.results.ResultsFilter(column_id='member_no', filter_expression='1,3,6'),
        rfem.results.ResultsFilter(column_id='loading', filter_expression='LC1,CO1'),
    ]
)
print(f"\nResults:\n{results.data}")

Output

Results:
    loading increment  member_no  node_no  location_x   tag             n         v_y          v_z       m_t           m_y          m_z    v
0       LC1      <NA>          1        6         0.0  <NA> -30287.789062 -842.034424  -1436.05603  214.9944   5744.222168 -3368.137939  0.0
1       LC1      <NA>          1     <NA>         0.2  <NA> -30737.789062 -842.034424  -1436.05603  214.9944    5457.01123 -3199.730957  0.0
2       LC1      <NA>          1     <NA>         0.2  <NA> -30737.789062 -842.034424  -1436.05603  214.9944    5457.01123 -3199.730957  0.0
3       LC1      <NA>          1     <NA>         0.4  <NA> -31187.789062 -842.034424  -1436.05603  214.9944   5169.799805 -3031.323975  0.0
4       LC1      <NA>          1     <NA>         0.4  <NA> -31187.789062 -842.034424  -1436.05603  214.9944   5169.799805 -3031.323975  0.0
..      ...       ...        ...      ...         ...   ...           ...         ...          ...       ...           ...          ...  ...
141     CO1      <NA>          6     <NA>    4.666667  <NA>  -2930.493896    39.96838 -7986.358887  -2.01162  11373.830078    53.470551  0.0
142     CO1      <NA>          6     <NA>    4.666667  <NA>  -2930.493896   39.968391 -7986.358887  -2.01162  11373.830078    53.470551  0.0
143     CO1      <NA>          6     <NA>    5.333333  <NA>  -2926.729004   40.402191 -8530.266602   -1.8577   5868.112793    26.981911  0.0
144     CO1      <NA>          6     <NA>    5.333333  <NA>  -2926.729004   40.402191 -8530.267578   -1.8577   5868.112793    26.981911  0.0
145     CO1      <NA>          6        6         6.0  <NA>  -2924.690918    40.86512 -9073.494141  -1.72952      -0.00002      -0.0032  0.0

Examples

Results Access
Results Filtering
Results Axes System
Results in Location
Results Multiple Models
On this page