19. Motion Definition#

Defines motion. The motion definitions consist of three types: translational motion, rotational motion, and deformation motion.

Settings#

19_Motoin(19) JSON key: motion-definition object

type(19) JSON key: indicates the motion-definition type; for reference in JSON format

motion_data(19) JSON key: object that defines motion data

MOTION_ID(19) Motion-data identifier.

X_TIME_ID(19) Time-variation identifier for translational motion in the X direction.

Y_TIME_ID(19) Time-variation identifier for translational motion in the Y direction.

Z_TIME_ID(19) Time-variation identifier for translational motion in the Z direction.

PHI_TIME_ID(19) Time-variation identifier for the rotation angle of rotational motion.

COORD_ID(19) Coordinate-system identifier for translational and rotational motion.

COIL_MOTION(19.1) JSON key: defines the motion of a COIL source or the motion of the pre_geom(2D) mesh

MESH_MOTION_for_COIL(19.1) JSON key: defines the motion of a COIL source or the motion of the pre_geom(2D) mesh

GLOBAL_MOTION_ID(19.1) Motion-data identifier representing the motion of the pre_geom(2D) mesh.

SLIDE_MOTION(19.2) JSON key: defines the translational and rotational motion of the moving rotor_mesh(2D)

ROTOR_MOTION_IDS(19.2) Motion-data identifiers for the moving parts.

SUBERI(19.2) Slip coefficient for the sliding method.

DEFORM_MOTION(19.3) JSON key: defines deformation motion of the moving parts

DEFORM_MOTION_ID(19.3) Motion-data identifier for the deforming part.

POSITION0(19.3) Text: relative position of the non-deforming region from the reference position.

POSITION1(19.3) Text: relative position of the deforming region from the reference position.

POSITIONS(19.3) JSON key: specify as an array containing the relative positions of the non-deforming and deforming regions from their reference positions.

NO_RIGID_MAT_IDS(19.3) Text: number of element-material IDs in the moving region.

NO_DEFORM_MAT_IDS(19.3) Text: number of element-material IDs in the deforming region.

CONTROL_VOLUME_ID(19.3) Material ID of the control elements.

RIGID_MAT_IDS(19.3) Text: element-material IDs of the moving region.

DEFORM_MAT_IDS(19.3) Text: element-material IDs of the deforming region.

Input format#

Text-format section

Type:

Fixed parameter set 1

Number of rows:

2

Number of parameters:

2, 6

Text format#

* MOTION * NO_MOTION_DATA *
MOTION    I
* MOTION_ID * X_TIME_ID * Y_TIME_ID * Z_TIME_ID * PHI_TIME_ID * COORD_ID
    I           I          I           I           I           I

JSON format#

JSON format from 2024.11#

"19_Motion": [
    {
        "motion_data": {
            "MOTION_ID": I,
            "X_TIME_ID": I,
            "Y_TIME_ID": I,
            "Z_TIME_ID": I,
            "PHI_TIME_ID": I,
            "COORD_ID": I
        },
        "type": "explain what type of Motion is defined here",
    }
]

Detailed description#

19_Motoin(19)#

Motion definition

type(19)#

Indicates the motion-definition type. For reference in JSON format.

COIL_MOTION(19)#

MESH_MOTION_for_COIL(19)#

Motion of the pre_geom(2D) mesh or a COIL(17.1) source when MOTION(2) =1.

SLIDE_MOTION(19)#

Translational and rotational motion of the moving rotor_mesh(2D) when MOTION(2) =2.

DEFORM_MOTION(19)#

Deformation motion of the moving parts when MOTION(2) =3.

Text-format section

MOTION(19)#

MOTION

Fixed parameter set 1#

[row, col] = [1, 1]
Type=S

Title indicating the motion-definition input.

NO_MOTION_DATA(19)#

NO_DATA (text)

Fixed parameter set 1#

[row, col] = [1, 1]
Type=I

Number of motion data items. Enter this number of data sets on row 2 as NO_MOTION_DAT.

motion_data#

motion_data(19)#

JSON key:: Object that defines motion data.

MOTION_ID#

MOTION_ID(19)#

Text-format section

Fixed parameter set 1#

[row, col] = [1, 1]

Type:: Integer (I)
Description:: Motion-data identifier.

X_TIME_ID#

X_TIME_ID(19)#

Text-format section

Fixed parameter set 1#

[row, col] = [1, 1]

Type:: Integer (I)
Description:: Time-variation identifier for translational motion in the X direction, TIME_ID(18).

Y_TIME_ID#

Y_TIME_ID(19)#

Text-format section

Fixed parameter set 1#

[row, col] = [1, 1]

Type:: Integer (I)
Description:: Time-variation identifier for translational motion in the Y direction, TIME_ID(18).

Z_TIME_ID#

Z_TIME_ID(19)#

Text-format section

Fixed parameter set 1#

[row, col] = [1, 1]

Type:: Integer (I)
Description:: Time-variation identifier for translational motion in the Z direction, TIME_ID(18).

PHI_TIME_ID#

PHI_TIME_ID(19)#

Text-format section

Fixed parameter set 1#

[row, col] = [1, 1]

Type:: Integer (I)
Description:: Time-variation identifier for the rotation angle of rotational motion, TIME_ID(18).

COORD_ID#

COORD_ID(19)#

Text-format section

Fixed parameter set 1#

[row, col] = [1, 1]

Type:: Integer (I)
Description:: Coordinate-system identifier for translational motion. For the coordinate-system identifier for translational motion, see COORD_ID(12). Rotational motion applies only to the global coordinate system, rotates about the z-axis, and uses the right-hand direction from the x-axis at zero angle as the positive direction (unit: deg).

Note

The <MOTION module> is required to use MOTION(2) =1 or 2. The <DEFORM module> is required to use MOTION(2) =3.

When MOTION(2) =1, the motion of the COIL(17.1) source, the motion-data identifier of the COIL(17.1) source ( MOTION_ID(17.1) ), and the motion-data identifier specified above ( MOTION_ID(19) ) must match. Translational and rotational motion may be defined in combination.

When MOTION(2) =2 or 3, translational, rotational, and deformation motion cannot be defined in combination.

For rotational sliding motion with MOTION(2) =2, the motion is rotation about the z-axis.

19.1. COIL_MOTION or motion of the pre_geom(2D) mesh#

When MOTION(2) =1

Defines the motion of a COIL(17.1) source or the motion of the pre_geom(2D) mesh.

MESH_MOTION_for_COIL (JSON comment)#

MESH_MOTION_for_COIL(19.1)#

JSON comment:: Represents motion of the entire mesh. Mesh Motion

COIL_MOTION (JSON comment)#

COIL_MOTION(19.1)#

JSON comment:: Represents motion of the COIL source. COIL Motion

Text-format section

GLOBAL_MOTION_ID(19.1)#

GLOBAL_MOTION_ID

Fixed parameter set 1#

[row, col] = [1, 1]
Type=I

Motion-data identifier (MOTION_ID(19)) representing motion of the pre_geom(2D) mesh. Set it to 0 when the mesh is stationary and the COIL source moves.

Hint

To translate the COIL(17.1) source in the X direction and additionally rotate it about the Z axis, set it as follows.

Text-format section

Text format#

* MOTION * NO_MOTION_DATA *
MOTION 1
* MOTION_ID * X_TIME_ID * Y_TIME_ID * Z_TIME_ID * PHI_TIME_ID * COORD_ID
1 1 0 0 2 0
* GLOBAL_MOTION_ID *
0

JSON format from 2024.11#

"19_Motion": [
    {
        "motion_data": {
            "MOTION_ID": 1,
            "X_TIME_ID": 1,
            "Y_TIME_ID": 0,
            "Z_TIME_ID": 0,
            "PHI_TIME_ID": 2,
            "COORD_ID": 0
        },
        "type": "COIL_MOTION",
        "comment": "GLOBAL_MOTION_ID == 0 means COIL_MOTION"
    }
]

To rotate the COIL(17.1) source about a position away from the Z axis (revolution) and rotate the pre_geom(2D) mesh about the Z axis (spin), set it as follows.

Text-format section

Text format#

* MOTION * NO_MOTION_DATA *
MOTION 1
* MOTION_ID * X_TIME_ID * Y_TIME_ID * Z_TIME_ID * PHI_TIME_ID * COORD_ID
1 0 0 0 2 1
* MOTION_ID * X_TIME_ID * Y_TIME_ID * Z_TIME_ID * PHI_TIME_ID * COORD_ID
2 0 0 0 3 0
* GLOBAL_MOTION_ID *
2

JSON format from 2024.11#

"19_Motion": [
    {
        "motion_data": {
            "MOTION_ID": 1,
            "X_TIME_ID": 1,
            "Y_TIME_ID": 0,
            "Z_TIME_ID": 0,
            "PHI_TIME_ID": 2,
            "COORD_ID": 1
        },
        "type": "COIL_MOTION",
        "comment": "GLOBAL_MOTION_ID == 2 means COIL_MOTION"
    },
    {
        "motion_data": {
            "MOTION_ID": 2,
            "X_TIME_ID": 0,
            "Y_TIME_ID": 0,
            "Z_TIME_ID": 0,
            "PHI_TIME_ID": 3,
            "COORD_ID": 0
        },
        "type": "MESH_MOTION_for_COIL",
        "comment": "GLOBAL_MOTION_ID == 2 means MESH_MOTION_for_COIL"
    }
]

19.2. Motion of the moving rotor_mesh(2D) mesh#

When MOTION(2) =2

Defines translational and rotational motion of the moving parts.

The motion requires NO_MESHES(10.1) -1 sets of moving-part mesh data (excluding pre_geom(2D)). The data are associated as follows:

First data: rotor_mesh(2D).xxx

N-th data: rotor_mesh(2D)N.xxx

Associate the data in this order. When multiple moving parts are used, motion for 運動方程式入力(18.6) cannot be specified.

Here, “***” represents the extension of the file format specified by INPUT_MESH_FILE(10.1).

SLIDE_MOTION (JSON comment)#

SLIDE_MOTION(19.2)#

Text-format section

ROTOR_MOTION_IDS(19.2)#

ROTOR_MOTION_IDS(19.2)

Fixed parameter set 1#

[row, col] = [1, 1]
Type=I

Motion-data identifiers for the moving parts ( MOTION_ID(19) ).

SUBERI#

SUBERI(19.2)#

Text-format section

Fixed parameter set 1#

[row, col] = [2, 1]

Type:

Real number (E)

Description:

Slip coefficient for the sliding method.

When the sliding method is used for AC steady-state analysis, enter the slip coefficient SUBERI. Use 0.0 when the rotor is synchronized with the stator field and 1.0 when it is stationary. Values greater than or equal to 1.0 are also allowed for reverse rotation. This setting does not apply to multiple moving parts.

Hint

When multiple moving-part mesh data have the same motion, assign the same motion-data identifier ( MOTION_ID(19) ) to the corresponding ROTOR_MOTION_IDS entries. When they have different motions, assign their respective motion-data identifiers.

Only rotational sliding motion about the Z axis can be considered; specify it with PHI_TIME_ID(19).

Define the rotational motion of an induction motor using AC steady-state analysis with AC(2) as follows.

Text-format section

Text format#

* MOTION * NO_MOTION_DATA *
MOTION 2
* MOTION_ID * X_TIME_ID * Y_TIME_ID * Z_TIME_ID * PHI_TIME_ID * COORD_ID
1 0 0 0 2 0
* ROTOR_MOTION_IDS * SUBERI *
1      0.01

JSON format from 2024.11#

"19_Motion": [
    {
        "motion_data": {
            "MOTION_ID": 1,
            "X_TIME_ID": 0,
            "Y_TIME_ID": 0,
            "Z_TIME_ID": 0,
            "PHI_TIME_ID": 2,
            "COORD_ID": 0
        },
        "type": "SLIDE_MOTION",
        "comment" : "ROTOR_MOTION_ID equal to MOTION_ID",
        "SUBERI": 0.01
    }
]

19.3. Motion of the deforming deform_mesh(2D) mesh#

When MOTION(2) =3

Runs an analysis with a deformed mesh.

Motion-data identifier for the deforming part ( MOTION_ID(19) ). Either deforming-part mesh data deform_mesh(2D) or CONTROL_VOLUME_ID(19.3) must be specified.

DEFORM_MOTION (JSON comment)#

DEFORM_MOTION(19.3)#

Text-format section

DEFORM_MOTION_ID(19.3)#

DEFORM_MOTION_ID

Fixed parameter set 1#

[row, col] = [1, 1]
Type=I

POSITION0(19.3)#

POSITION0

Text-format section

Fixed parameter set 1#

[row, col] = [2, 1]
Type=E

POSITION1(19.3)#

POSITION1

Text-format section

Fixed parameter set 1#

[row, col] = [2, 2]
Type=E

POSITIONS (JSON)#

POSITIONS(19.3)#

Type:

Real number (E)

Description:

Defines the motion range of the deforming-part mesh deform_mesh(2D). Specify it as an array.

The first value ( POSITION0 ) is the relative position from the reference position of the region in the model mesh data pre_geom(2D) that moves without deforming.

The next value ( POSITION1 ) is the relative position from the reference position of the moving region in the deforming-part mesh data deform_mesh(2D).

The unit is (m) for translational motion and (deg) for rotational motion. The motion range must lie between pre_geom(2D) and deform_mesh(2D).

Text-format section

NO_RIGID_MAT_IDS(19.3)#

NO_RIGID_MAT_IDS(19.3)

Fixed parameter set 1#

[row, col] = [2, 3]
Type=I

Number of element-material IDs in the region where the mesh moves.

NO_DEFORM_MAT_IDS(19.3)#

NO_DEFORM_MAT_IDS(19.3)

Fixed parameter set 1#

[row, col] = [2, 3]
Type=I

Number of element-material IDs in the region where the mesh deforms.

CONTROL_VOLUME_ID#

CONTROL_VOLUME_ID(19.3)#

Text-format section

Fixed parameter set 1#

[row, col] = [2, 4]

Type:

Integer (I)

Description:

Material ID of the control elements. The control elements must use the material ID of the region where the mesh deforms.

When 0, input for deform_mesh is required.

When ≠0, input for deform_mesh is not required; the mesh at the POSITION1 position is generated automatically using control elements with CONTROL_VOLUME_ID. The pre_geom data must contain control elements whose material ID is CONTROL_VOLUME_ID. The control elements must contain multiple elements, and their nodes must be shared by the surface nodes of the fixed and moving regions. The nodes that move during deformation, that is, the elements with DEFORM_MAT_IDS, must be included in one of the control elements. For two-dimensional analysis, the control elements must be surface elements included in pre_geom2D. No material definition is required for the control elements.

Text-format section

RIGID_MAT_IDS(19.3)#

RIGID_MAT_IDS

Fixed parameter set 1#

[row, col] = [3, 1]
Type=I

Element-material IDs of the region where the mesh moves. They must be within the total-potential region.

DEFORM_MAT_IDS(19.3)#

DEFORM_MAT_IDS

Fixed parameter set 1#

[row, col] = [4, 1]
Type=I

Element-material IDs of the region where the mesh deforms. The region must be an air region within the total-potential region.

Hint

Define the motion of the deforming-part mesh deform_mesh(2D) as follows.

When CONTROL_VOLUME_ID =0, input for deform_mesh(2D) is required.

Text-format section

Text format#

* MOTION * NO_MOTION_DATA *
MOTION 3
* MOTION_ID * X_TIME_ID * Y_TIME_ID * Z_TIME_ID * PHI_TIME_ID * COORD_ID
1 0 0 0 2 0
* DEFORM_MOTION_ID *
1
* POSITION0 * POSITION1 * NO_RIGID_MAT_IDS *  NO_DEFORM_MAT_IDS * CONTROL_VOLUME_ID *
0.0002         0.012      1        1       0
* RIGID_MAT_IDS *
    2
* DEFORM_MAT_IDS *
    5

JSON format from 2024.11#

"19_Motion": [
    {
        "motion_data": {
            "MOTION_ID": 1,
            "X_TIME_ID": 0,
            "Y_TIME_ID": 0,
            "Z_TIME_ID": 0,
            "PHI_TIME_ID": 2,
            "COORD_ID": 0
        },
        "type": "DEFORM_MOTION",
        "comment" : "DEFORM_MOTION_ID equal to MOTION_ID",
        "note" : "RIGID_IDs and DEFORM_IDs are defined in 16_Material_Properties",
        "POSITIONS": [0.0002, 0.012],
        "CONTROL_VOLUME_ID": 0
    }
]

19. Motion Definition

Contents

19. Motion Definition#

Settings#

Input format#

JSON format#

Detailed description#

motion_data#

MOTION_ID#

X_TIME_ID#

Y_TIME_ID#

Z_TIME_ID#

PHI_TIME_ID#

COORD_ID#

19.1. COIL_MOTION or motion of the pre_geom(2D) mesh#

MESH_MOTION_for_COIL (JSON comment)#

COIL_MOTION (JSON comment)#

19.2. Motion of the moving rotor_mesh(2D) mesh#

SLIDE_MOTION (JSON comment)#

SUBERI#

19.3. Motion of the deforming deform_mesh(2D) mesh#

DEFORM_MOTION (JSON comment)#

POSITIONS (JSON)#

CONTROL_VOLUME_ID#