rotate_objects#

dlubal.api.rfem.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_lines_members=False, adjust_loading_nodal_loads=False, model_id=None)#

Rotate or copies the specified objects about defined axis.

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_lines_members (bool | False) – Specifies whether the objects’ local coordinate systems (LCS) should be rotated together with the lines, 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

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

Examples