rotate_objects

dlubal.api.rstab.Application.rotate_objects(self, objs, rotation_angle, rotation_axis, coordinate_system=1, point_1=None, point_2=None, axis=None, create_copy=False, number_of_steps=None, copy_including_loading=False, copy_including_imperfections=False, connect_lines_members_surfaces=False, rotate_local_coordinate_systems_of_members=False, adjust_loading_nodal_loads=False, model_id=None)

Moves or copies the specified objects in a defined direction.

Parameters:

• objs (list) – The list of specified model objects.

• rotation_angle (float) – Specifies the angle for rotation.

• rotation_axis (RotationAxisSpecificationType) – Specifies the type of rotation axis type for the objects rotation.

• coordinate_system (int | 1) – Specifies the coordination system to use.

• point_1 (Vector3d | None) – Specifies the point 1 for vector-based rotation.

• point_2 (Vector3d | None) – Specifies the point 2 for vector-based rotation.

• axis (CoordinateAxis | None) – Specifies the axis for parallel rotation.

• create_copy (bool | False) – Specifies whether copies of the specified objects should be created.

• number_of_steps (int | None) – Specifies the number of copies to create.

• copy_including_loading (bool | False) – Specifies whether to include the loading when copying the objects.

• copy_including_imperfections (bool | False) – Specifies whether to include imperfections when copying the objects.

• connect_lines_members_surfaces (bool | False) – Specifies whether to connect lines, members, or surfaces when they overlap in the copy.

• rotate_local_coordinate_systems_of_members (bool | False) – Specifies whether the objects’ local coordinate systems (LCS) should be rotated together with the members.

• adjust_loading_nodal_loads (bool | False) – Specifies whether to also update nodal loads so their force and moment vectors remain correct in world coordinates after the transform.

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

Returns:

None

---

Usage

PythonC#

rstab_app.rotate_objects(
   objs=rstab_app.get_object_list(
         objs=[rstab.structure_core.Node()]
   ),
   rotation_angle=math.pi,
   point_1=common.Vector3d(x=0,y=0,z=0),
   axis=rstab.manipulation.COORDINATE_AXIS_Y,
   rotation_axis=rstab.manipulation.ROTATION_AXIS_SPECIFICATION_TYPE_POINT_AND_PARALLEL_AXIS,
   create_copy=True,
   number_of_steps=1
)

---

Examples

Steel Hall