From db4050e854e6c189c36a84a0d7460eeff68c45e2 Mon Sep 17 00:00:00 2001 From: Seth Alter Date: Wed, 24 Jan 2024 14:35:21 -0500 Subject: [PATCH] Improved the documentation for all output data positions and rotations --- Documentation/Changelog.md | 1 + Documentation/api/output_data.md | 30 +++++++++++++++--------------- 2 files changed, 16 insertions(+), 15 deletions(-) diff --git a/Documentation/Changelog.md b/Documentation/Changelog.md index 43ae38b0..97dc2907 100644 --- a/Documentation/Changelog.md +++ b/Documentation/Changelog.md @@ -34,6 +34,7 @@ To upgrade from TDW v1.11 to v1.12, read [this guide](upgrade_guides/v1.11_to_v1 | Document | Description | | --- | --- | | `lessons/visual_perception/occlusion.md` | Updated document to describe the new `Occlusion` data. | +| `api/output_data.md` | Improved the documentation for all positions and rotations. | ## v1.12.22 diff --git a/Documentation/api/output_data.md b/Documentation/api/output_data.md index f71874df..644674d6 100644 --- a/Documentation/api/output_data.md +++ b/Documentation/api/output_data.md @@ -384,10 +384,10 @@ Dynamic robot output data. | Function | Description | Return type | | --- | --- | --- | | `get_immovable(index)` | An array indicating whether the root object of each robot is immovable. | `bool` | -| `get_robot_position(index)` | The position of the robot. | `np.ndarray` | -| `get_robot_rotation(index)` | The rotation of the robot. | `np.ndarray` | +| `get_robot_position(index)` | The position of the robot in the order of (x, y, z). | `np.ndarray` | +| `get_robot_rotation(index)` | The rotation of the robot in the order (x, y, z, w). | `np.ndarray` | | `get_robot_forward(index)` | The forward of the robot. | `np.ndarray` | -| `get_joint_position(index)` | The position of the joint. | `np.ndarray` | +| `get_joint_position(index)` | The position of the joint in the order of (x, y, z). | `np.ndarray` | | `get_joint_angles(index)` | The angles of the joint. | `np.ndarray` | | `get_joint_sleeping(index)` | The sleeping of the joint. | `bool` | @@ -541,7 +541,7 @@ The names of each ImageSensor component attached to an avatar, and whether they | `get_num_sensors()` | The number of sensors. | `int` | | `get_sensor_name(index)` | The name of the sensor. | `str` | | `get_sensor_on(index)` | The on of the sensor. | `bool` | -| `get_sensor_rotation(index)` | The rotation of the sensor. | `Tuple[float, float, float, float]` | +| `get_sensor_rotation(index)` | The rotation of the sensor in the order (x, y, z, w). | `Tuple[float, float, float, float]` | | `get_sensor_forward(index)` | The forward of the sensor. | `Tuple[float, float, float]` | | `get_sensor_field_of_view(index)` | The view of the sensor field of. | `float` | @@ -608,11 +608,11 @@ Data for all lights in the scene. | `get_num_directional_lights()` | The number of directional lights. | `int` | | `get_directional_light_intensity(index)` | The intensity of the directional light. | `float` | | `get_directional_light_color(index)` | The color of the directional light. | `Tuple[float, float, float]` | -| `get_directional_light_rotation(index)` | The rotation of the directional light. | `Tuple[float, float, float, float]` | +| `get_directional_light_rotation(index)` | The rotation of the directional light in the order (x, y, z, w). | `Tuple[float, float, float, float]` | | `get_num_point_lights()` | The number of point lights. | `int` | | `get_point_light_intensity(index)` | The intensity of the point light. | `float` | | `get_point_light_color(index)` | The color of the point light. | `Tuple[float, float, float]` | -| `get_point_light_position(index)` | The position of the point light. | `Tuple[float, float, float]` | +| `get_point_light_position(index)` | The position of the point light in the order of (x, y, z). | `Tuple[float, float, float]` | | `get_point_light_range(index)` | The range of the point light. | `float` | ## LocalTransforms @@ -862,8 +862,8 @@ Data about each Replicant in the scene. | `get_forward(index)` | The forward. | `np.ndarray` | | `get_rotation(index)` | The rotation. | `np.ndarray` | | `get_body_part_id(index, body_part_index)` | The ID of the body part. | `int` | -| `get_body_part_position(index, body_part_index)` | The position of the body part. | `np.ndarray` | -| `get_body_part_rotation(index, body_part_index)` | The rotation of the body part. | `np.ndarray` | +| `get_body_part_position(index, body_part_index)` | The position of the body part in the order of (x, y, z). | `np.ndarray` | +| `get_body_part_rotation(index, body_part_index)` | The rotation of the body part in the order (x, y, z, w). | `np.ndarray` | | `get_body_part_forward(index, body_part_index)` | The forward of the body part. | `np.ndarray` | | `get_is_holding_left(index)` | The left of the is holding. | `bool` | | `get_held_left(index)` | The left of the held. | `int` | @@ -1133,7 +1133,7 @@ Data about the Transform component of objects (position and rotation). | --- | --- | --- | | `get_num()` | The number of objects. | `int` | | `get_id(index)` | The id. | `int` | -| `get_position(index)` | The position. | `np.ndarray` | +| `get_position(index)` | The position of the object's pivot point, in the order (x, y, z). | `np.ndarray` | | `get_forward(index)` | The forward. | `np.ndarray` | | `get_rotation(index)` | The rotation. | `np.ndarray` | @@ -1193,14 +1193,14 @@ Data about the VR rig currently in the scene. | `get_position()` | The rig's position. | `Tuple[float, float, float]` | | `get_rotation()` | The rig's rotation. | `Tuple[float, float, float, float]` | | `get_forward()` | The rig's forward directional vector. | `Tuple[float, float, float]` | -| `get_left_hand_position()` | The position of the left hand. | `Tuple[float, float, float]` | -| `get_left_hand_rotation()` | The rotation of the left hand. | `Tuple[float, float, float, float]` | +| `get_left_hand_position()` | The position of the left hand in the order of (x, y, z). | `Tuple[float, float, float]` | +| `get_left_hand_rotation()` | The rotation of the left hand in the order (x, y, z, w). | `Tuple[float, float, float, float]` | | `get_left_hand_forward()` | The forward of the left hand. | `Tuple[float, float, float]` | -| `get_right_hand_position()` | The position of the right hand. | `Tuple[float, float, float]` | -| `get_right_hand_rotation()` | The rotation of the right hand. | `Tuple[float, float, float, float]` | +| `get_right_hand_position()` | The position of the right hand in the order of (x, y, z). | `Tuple[float, float, float]` | +| `get_right_hand_rotation()` | The rotation of the right hand in the order (x, y, z, w). | `Tuple[float, float, float, float]` | | `get_right_hand_forward()` | The forward of the right hand. | `Tuple[float, float, float]` | -| `get_head_position()` | The position of the head. | `Tuple[float, float, float]` | -| `get_head_rotation()` | The rotation of the head. | `Tuple[float, float, float, float]` | +| `get_head_position()` | The position of the head in the order of (x, y, z). | `Tuple[float, float, float]` | +| `get_head_rotation()` | The rotation of the head in the order (x, y, z, w). | `Tuple[float, float, float, float]` | | `get_head_forward()` | The forward of the head. | `Tuple[float, float, float]` | | `get_held_left()` | The IDs of the objects held by the left hand. | `np.ndarray` | | `get_held_right()` | The IDs of the objects held by the right hand. | `np.ndarray` |