move_objects

dlubal.api.rstab.Application.move_objects(self, objects, direction_through, coordinate_system=1, displacement_vector=None, axis=None, create_copy=False, number_of_steps=None, spacing=None, copy_including_loading=False, copy_including_imperfections=False, connect_lines_members_surfaces=False, model_id=None)

Moves or copies the specified objects in a defined direction.

Parameters:

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

• direction_through (DirectionThrough) – Specifies the type of direction through which the objects will be moved.

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

• displacement_vector (Vector3d | None) – Specifies the displacement vector for vector-based movement.

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

• 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.

• spacing (double | None) – Specifies the spacing between copies for parallel movement.

• 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.

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

Returns:

None

---

Usage

PythonC#

objs = [
    rstab.structure_core.Node(
        no=1
    )
]
rstab_app.move_objects(
    objects=objs,
    direction_through=rstab.manipulation.DIRECTION_THROUGH_DISPLACEMENT_VECTOR,
    displacement_vector=common.Vector3d(x=0.0, y=5.0, z=0.0),
    create_copy=True,
    number_of_steps=2,
)