get_object_table#

dlubal.api.rsection.Application.get_object_table(self, object_type, show_header_details=False, model_id=None, use_current_units=False, return_formulas=False, loading=None)#

Retrieves object data according to the object type wrapped in a DataFrame for more efficient analysis.

Parameters:
  • object_type (ObjectType) – Unique identifier for the object type.

  • show_header_details (bool, optional) – If True, the DataFrame will have a two-row header (first row: id, second row: name). If False, only the id will be used as the header (default).

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

  • use_current_units (bool, optional) – Identifier whether user defined or SI units are used to represent values.

  • return_formulas (bool, optional) – Identifier whether formulas are shown.

  • loading (ObjectId) – Reference to the loading (e.g., load case, combination, etc.).

Returns:

A Table table containing the object data for the specific object type as a DataFrame.

Method Type: Core


Usage

# Retrieves specified model object table wrapped in a DataFrame (.data)
object_table: common.Table = rsection_app.get_object_table(
   object_type=rsection.OBJECT_TYPE_POINT,
   show_header_details=True,
   use_current_units=True,
   return_formulas=True,
)
print(f"\nObject Table:\n{object_table.data}")

Output:

Object Table:
point_no       type reference_point coordinate_system_type coordinate_1 coordinate_2 global_coordinate_1 global_coordinate_2 comment
Point No. Point Type Reference Point        Coordinate Type       Y [mm]       Z [mm]              Y [mm]              Z [mm] Comment
      1   Standard               0              Cartesian    59.362896        -45.0           59.362896               -45.0
      2   Standard               0              Cartesian    59.362896        -65.0           59.362896               -65.0
      3   Standard               0              Cartesian    51.362896        -73.0           51.362896               -73.0
      4   Standard               0              Cartesian   -28.637104        -73.0          -28.637104               -73.0
      5   Standard               0              Cartesian   -36.637104        -65.0          -36.637104               -65.0
      6   Standard               0              Cartesian   -36.637104         65.0          -36.637104                65.0
      7   Standard               0              Cartesian   -28.637104         73.0          -28.637104                73.0
      8   Standard               0              Cartesian    51.362896         73.0           51.362896                73.0
      9   Standard               0              Cartesian    59.362896         65.0           59.362896                65.0