--- title: Protocol Documentation slug: api docTags: createdAt: 2026-03-26T09:33:12.813Z --- ## fizyr.calibration.v2.proto ### AngleAxis A rotation of a specific angle around a specific axis. | Field | Type | Label | Description | | ----- | --------------------------------------- | ----- | --------------------------------- | | angle | [float](docId\:Ffr-304MrUMsADpzosp7h) | | The angle of rotation in radians. | | axis | [Vector3](docId\:Ffr-304MrUMsADpzosp7h) | | The axis of rotation. | ### Calibration An extrinsic camera calibration. | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | \| calibration\_id | [string](docId\:Ffr-304MrUMsADpzosp7h) | optional | The ID of the calibration. This field is only set if the calibration has already been saved. If left unset when adding a calibration, a new unique ID will automatically be generated for it. | \| timestamp | [uint64](docId\:Ffr-304MrUMsADpzosp7h) | | The timestamp when the calibration was recorded. Specified as number of milliseconds since January 1 1970 00:00 UTC (the Unix epoch). | \| num\_samples | [uint32](docId\:Ffr-304MrUMsADpzosp7h) | | The number of valid samples used to compute this calibration. | \| camera\_moving | [bool](docId\:Ffr-304MrUMsADpzosp7h) | | Specifies if the camera is attached to the moving frame (the robot) or the fixed frame. | \| camera\_pose | [Pose3](docId\:Ffr-304MrUMsADpzosp7h) | | The pose of the camera with respect to the parent frame. If `camera_moving` is true, the parent frame is the moving frame. Otherwise, the parent frame is the fixed frame. | \| pattern\_pose | [Pose3](docId\:Ffr-304MrUMsADpzosp7h) | | The pose of the calibration pattern with respect to the parent frame. If `camera_moving` is true, the parent frame is the fixed frame. Otherwise, the parent frame is the moving frame. | \| root\_mean\_square\_error | [float](docId\:Ffr-304MrUMsADpzosp7h) | optional | The root mean square error of the pattern pose for all calibration samples. NOTE: The exact meaning of this field depends on the camera. Vendor specific camera algorithms may compute the RMSE slightly different, but a lower error is always better. NOTE: This field may not be provided by all cameras, and it may not be set in manually uploaded calibrations. | \| mean\_translation\_error | [float](docId\:Ffr-304MrUMsADpzosp7h) | optional | The mean translation error in meters, computed over all calibration samples. NOTE: This field may not be provided by all cameras, and it may not be set in manually uploaded calibrations. | \| mean\_rotation\_error | [float](docId\:Ffr-304MrUMsADpzosp7h) | optional | The mean rotation error in radians, computed over all calibration samples. NOTE: This field may not be provided by all cameras, and it may not be set in manually uploaded calibrations. | ### CloseCalibrationCycleRequest Request body for the `close_calibration()` service. | Field | Type | Label | Description | | --------- | -------------------------------------- | ----- | -------------------------------- | | cycle\_id | [uint32](docId\:Ffr-304MrUMsADpzosp7h) | | The ID of the calibration cycle. | ### CloseCalibrationCycleResponse Response body for the `close_calibration()` service. ### ComputeCalibrationRequest Request body for the `compute_calibration` service. | Field | Type | Label | Description | | --------- | -------------------------------------- | ----- | -------------------------------- | | cycle\_id | [uint32](docId\:Ffr-304MrUMsADpzosp7h) | | The ID of the calibration cycle. | \| no\_save | [bool](docId\:Ffr-304MrUMsADpzosp7h) | | Do not automatically close the computed calibration. You can save it later if desired using the \[`save_calibration`] service. | \| no\_close | [bool](docId\:Ffr-304MrUMsADpzosp7h) | | Do not automatically close the calibration cycle. You should close it later using the \[`close_calibration_cycle`] service. | \| moving\_camera | [bool](docId\:Ffr-304MrUMsADpzosp7h) | | Indicates if the camera is mounted attached to the moving frame (the robot). | \| skip\_pattern\_pose\_computation | [bool](docId\:Ffr-304MrUMsADpzosp7h) | | Skip computation of the calibration pattern pose. If this is `true`, the `pattern_pose` field is used directly as the pattern pose. This is significantly faster than computing the pattern pose and it requires less samples: only 1 sample is enough, but using more samples can still improve the accuracy of the calibration. However, if you skip the computation of the pattern pose, the calibration will not account for manufacturing tolerances, mounting inaccuracies or measurement errors. If you enable this option, you *must* set `pattern_pose` correctly too. | \| camera\_pose | [Pose3](docId\:Ffr-304MrUMsADpzosp7h) | optional | An initial guess for pose of the camera. The pose must be with respect to the fixed frame (if `moving_camera` is `false`) or the moving frame (if `moving_camera` is `true`). This may be used to speed up the calibration routine, but providing a bad guess may actually slow down the calibration routine, or even lead to inaccurate results. | \| pattern\_pose | [Pose3](docId\:Ffr-304MrUMsADpzosp7h) | optional | The known pose of the calibration plate, or an initial guess for its pose. The pose must be with respect to the moving frame (if `moving_camera` is `false`) or the fixed frame (if `moving_camera` is `true`). This may be used to speed up the calibration routine, but providing a bad guess may actually slow down the calibration routine, or even lead to inaccurate results. If `skip_pattern_pose_computation` is set, this pose must be the actual pose of the calibration pattern, and not just an initial guess. | \| rotation\_format | [RotationFormat](docId\:Ffr-304MrUMsADpzosp7h) | optional | Specify the rotation format to use for the response. This does not change the way the calibration is stored internally. It is only used for the response message to the request. | ### ComputeCalibrationResponse Response body for the `compute_calibration` service. | Field | Type | Label | Description | | ----------- | ------------------------------------------- | ----- | ------------------------- | | calibration | [Calibration](docId\:Ffr-304MrUMsADpzosp7h) | | The computed calibration. | ### DeleteCalibrationRequest Request body for the `delete_calibration` request. | Field | Type | Label | Description | | --------------- | -------------------------------------- | ----- | ------------------------------------------ | | calibration\_id | [string](docId\:Ffr-304MrUMsADpzosp7h) | | The ID of the saved calibration to delete. | ### DeleteCalibrationResponse Response body for the `delete_calibration` request. ### Empty An empty message ### EulerRotation Euler rotation representation | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | \| format | [EulerRotationFormat](docId\:Ffr-304MrUMsADpzosp7h) | | The format of the Euler angles. This determines the order in which the rotations are applied. | \| angles | [float](docId\:Ffr-304MrUMsADpzosp7h) | repeated | An array containing the angles of rotation for each axis. The order of the angles is the order as per the variant of the `format` field. This field needs exactly 3 values | ### GetApiVersionRequest Request body for the `get_api_version` request. ### GetApiVersionResponse Response body for the `get_api_version` request. | Field | Type | Label | Description | | ------- | --------------------------------------- | ----- | --------------------------- | | version | [Version](docId\:Ffr-304MrUMsADpzosp7h) | | The pick interface version. | ### GetCalibrationRequest Request body for the `get_calibration()` service. | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | \| calibration\_id | [string](docId\:Ffr-304MrUMsADpzosp7h) | optional | The ID of the calibration to retrieve. If not set (or set to an empty string), the active calibration is returned. | \| rotation\_format | [RotationFormat](docId\:Ffr-304MrUMsADpzosp7h) | optional | Specify the rotation format to use for the response. | ### GetCalibrationResponse Response body for the `get_calibration()` service. | Field | Type | Label | Description | | ----------- | ------------------------------------------- | ----- | -------------------------- | | calibration | [Calibration](docId\:Ffr-304MrUMsADpzosp7h) | | The requested calibration. | ### GetServerInfoRequest Request body for the `get_server_info` request. ### GetServerInfoResponse Response body for the `get_server_info` request. | Field | Type | Label | Description | | ----- | ------------------------------------------------- | ----- | -------------------------------- | | info | [ServerInformation](docId\:Ffr-304MrUMsADpzosp7h) | | The information about the serde. | ### ListCalibrationCyclesRequest List open calibration cycles. ### ListCalibrationCyclesResponse Response body for the `list_calibration_cycles` service. | Field | Type | Label | Description | | ---------- | -------------------------------------- | -------- | --------------------------------------- | | cycle\_ids | [uint32](docId\:Ffr-304MrUMsADpzosp7h) | repeated | The IDs of all open calibration cycles. | ### ListCalibrationsRequest Request body for the `list_calibrations` service. ### ListCalibrationsResponse Response body for the `list_calibrations` service. | Field | Type | Label | Description | | ---------------- | -------------------------------------- | -------- | ---------------------------------- | | calibration\_ids | [string](docId\:Ffr-304MrUMsADpzosp7h) | repeated | The IDs of the saved calibrations. | ### Point2U A two dimensional point in space. | Field | Type | Label | Description | | ----- | -------------------------------------- | ----- | ----------------------------- | | x | [uint32](docId\:Ffr-304MrUMsADpzosp7h) | | The X component of the point. | | y | [uint32](docId\:Ffr-304MrUMsADpzosp7h) | | The Y component of the point. | ### Point3 A three dimensional point in space. | Field | Type | Label | Description | | ----- | ------------------------------------- | ----- | ----------------------------- | | x | [float](docId\:Ffr-304MrUMsADpzosp7h) | | The X component of the point. | | y | [float](docId\:Ffr-304MrUMsADpzosp7h) | | The Y component of the point. | | z | [float](docId\:Ffr-304MrUMsADpzosp7h) | | The Z component of the point. | ### Pose3 A pose in three dimensional space. A pose combines a position and an orientation. | Field | Type | Label | Description | | ----------- | ----------------------------------------- | ----- | ---------------------------- | | position | [Point3](docId\:Ffr-304MrUMsADpzosp7h) | | The position in 3D space. | | orientation | [Rotation3](docId\:Ffr-304MrUMsADpzosp7h) | | The orientation in 3D space. | ### Quaternion This struct represents a quaternion. The quaternion w+xi+yj+zk is a convenient representation of orientations and rotations of objects in three dimensions. Operations interpreting the quaternion as rotation have undefined behavior if the quaternion is not normalized. | Field | Type | Label | Description | | ----- | ------------------------------------- | ----- | ------------------------------ | | x | [float](docId\:Ffr-304MrUMsADpzosp7h) | | X component of the quaternion. | | y | [float](docId\:Ffr-304MrUMsADpzosp7h) | | Y component of the quaternion. | | z | [float](docId\:Ffr-304MrUMsADpzosp7h) | | Z component of the quaternion. | | w | [float](docId\:Ffr-304MrUMsADpzosp7h) | | W component of the quaternion. | ### RecordSampleRequest Request body for the `record_sample()` service. | Field | Type | Label | Description | | -------------------- | --------------------------------------- | -------- | ---------------------------------------------------------------------------------- | | cycle\_id | [uint32](docId\:Ffr-304MrUMsADpzosp7h) | | The ID of the calibration cycle. | | robot\_pose | [Pose3](docId\:Ffr-304MrUMsADpzosp7h) | | The pose of the robot (or moving frame). | | region\_of\_interest | [Point2U](docId\:Ffr-304MrUMsADpzosp7h) | repeated | Region of interest in pixels to limit the search space of the calibration pattern. | \| rotation\_format | [RotationFormat](docId\:Ffr-304MrUMsADpzosp7h) | optional | Specify the rotation format to use for the response. This does not have to match with the format of the `robot_pose` field. It is only used to choose the rotation format in the response. | ### RecordSampleResponse Response body for the `record_sample()` service. | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | \| sample\_id | [uint32](docId\:Ffr-304MrUMsADpzosp7h) | | The ID of the recorded sample. Sample ids are specific to the calibration cycle in which they were recorded. | \| pattern\_found | [bool](docId\:Ffr-304MrUMsADpzosp7h) | | Indicates if the pattern was found in the recorded image. If no pattern was found, the sample can not be used for calibration. | \| pattern\_pose | [Pose3](docId\:Ffr-304MrUMsADpzosp7h) | optional | The detected pose of the calibration pattern in the uncalibrated camera frame. NOTE: The call may be forwarded to a camera-vendor-specific calibration algorithm. Such algorithms may not report the pose of the detected pattern. In that case, this field may be empty / omitted even though `pattern_found` is `true`. | ### Rotation3 A rotation in one of several possible formats. | Field | Type | Label | Description | | ---------- | --------------------------------------------- | ----- | ------------------------------------------------------------------------- | | AngleAxis | [AngleAxis](docId\:Ffr-304MrUMsADpzosp7h) | | An angle-axis rotation. | | Quaternion | [Quaternion](docId\:Ffr-304MrUMsADpzosp7h) | | A rotation represented as quaternion. | | Euler | [EulerRotation](docId\:Ffr-304MrUMsADpzosp7h) | | A rotation represented as three separate rotations around the major axes. | ### SaveComputedCalibrationRequest Request body for the `save_calibration` service. | Field | Type | Label | Description | | --------- | -------------------------------------- | ----- | -------------------------------- | | cycle\_id | [uint32](docId\:Ffr-304MrUMsADpzosp7h) | | The ID of the calibration cycle. | \| calibration\_id | [string](docId\:Ffr-304MrUMsADpzosp7h) | optional | Save the calibration under the given ID. If you leave this unset, a new ID is generated automatically. | \| overwrite\_existing | [bool](docId\:Ffr-304MrUMsADpzosp7h) | | Overwrite a calibration with the same ID, if it already exists. | ### SaveComputedCalibrationResponse Response body for the `save_computed_calibration` service. | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | \| calibration\_id | [string](docId\:Ffr-304MrUMsADpzosp7h) | | The ID of the saved calibration. Useful if you left the \[`SaveComputedCalibrationRequest::calibration_id`] field unset. | ### ServerInformation Information about a server, including software and API versions. | Field | Type | Label | Description | | ------------------ | --------------------------------------- | ----- | -------------------------------------- | | interface\_name | [string](docId\:Ffr-304MrUMsADpzosp7h) | | The name of the interface. | | interface\_version | [Version](docId\:Ffr-304MrUMsADpzosp7h) | | The version of the server's interface. | \| application\_name | [string](docId\:Ffr-304MrUMsADpzosp7h) | | The name of the application. This is important for interfaces that are implemented by multiple applications, (eg: cameras). | \| application\_version | [Version](docId\:Ffr-304MrUMsADpzosp7h) | | The version of the application. This can be useful for logging purposes. However, for checking compatibility with an interface you should always look at the interface name and version, not at the application name or version. | \| service\_name | [string](docId\:Ffr-304MrUMsADpzosp7h) | | The name of this particular instance of the application. This can be used to distinguish between different instances of a service if there is more than one instance of the same application running on the system. | ### SetActiveCalibrationRequest Request body for the `set_active_calibration` service. | Field | Type | Label | Description | | --------------- | -------------------------------------- | ----- | ------------------------------------------------------------- | | calibration\_id | [string](docId\:Ffr-304MrUMsADpzosp7h) | | The ID of the saved calibration to set as active calibration. | ### SetActiveCalibrationResponse Response body for the `set_active_calibration` service. ### StartCalibrationCycleRequest Request body for the `start_calibration_cycle()` service. ### StartCalibrationCycleResponse Response body for the `start_calibration_cycle()` service. | Field | Type | Label | Description | | --------- | -------------------------------------- | ----- | ---------------------------------- | | cycle\_id | [uint32](docId\:Ffr-304MrUMsADpzosp7h) | | The ID of the newly started cycle. | ### UploadCalibrationRequest Request body for the `upload_calibration` request. | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | \| calibration | [Calibration](docId\:Ffr-304MrUMsADpzosp7h) | | The calibration to upload. You can choose the ID of the calibration by setting the \[`Calibration::calibration_id`] field. If you leave it unset, then a new unique ID is generated automatically. | \| overwrite\_existing | [bool](docId\:Ffr-304MrUMsADpzosp7h) | | Overwrite the calibration with the given ID if it already exists. If this is set to `false` or not specified, an error is returned if a saved calibration with the same ID already exists. | \| make\_active | [bool](docId\:Ffr-304MrUMsADpzosp7h) | | If set to true, make the uploaded calibration the active calibration. | ### UploadCalibrationResponse Response body for the `upload_calibration` request. | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | \| calibration\_id | [string](docId\:Ffr-304MrUMsADpzosp7h) | | The ID of the saved calibration. Mostly useful if you left the \[`Calibration::calibration_id`] field unset during the upload. Otherwise, it is just copy of that value. | ### Vector3 A three dimensional vector. | Field | Type | Label | Description | | ----- | ------------------------------------- | ----- | ------------------------------ | | x | [float](docId\:Ffr-304MrUMsADpzosp7h) | | The X component of the vector. | | y | [float](docId\:Ffr-304MrUMsADpzosp7h) | | The Y component of the vector. | | z | [float](docId\:Ffr-304MrUMsADpzosp7h) | | The Z component of the vector. | ### Version A version with major, minor and patch number. | Field | Type | Label | Description | | ----- | ---- | ----- | ----------- | \| major | [uint32](docId\:Ffr-304MrUMsADpzosp7h) | | The major version. A change to this value indicates a backwards-incompatible change to the public interface. | \| minor | [uint32](docId\:Ffr-304MrUMsADpzosp7h) | | The minor version. A change to this value indicates a backwards-compatible change to the public interface. | \| patch | [uint32](docId\:Ffr-304MrUMsADpzosp7h) | | The patch version. A change to this value indicates an internal change with no impact on the public interface. | ### EulerRotationFormat The type of Euler (Tait-Bryan) angles and the sequence of the rotation. | Name | Number | Description | | ---- | ------ | ----------- | \| EULER\_ROTATION\_FORMAT\_UNSPECIFIED | 0 | Unspecified value. If used, the server will act as if no value has been specified. | \| EULER\_ROTATION\_FORMAT\_INTRINSIC\_XYZ | 1 | The angles represent intrinsic rotations in XYZ order. See \[`RotationFormat::EulerIntrinsicXyz`] for more information. | \| EULER\_ROTATION\_FORMAT\_INTRINSIC\_XZY | 2 | The angles represent intrinsic rotations in XZY order. See \[`RotationFormat::EulerIntrinsicXzy`] for more information. | \| EULER\_ROTATION\_FORMAT\_INTRINSIC\_YXZ | 3 | The angles represent intrinsic rotations in YXZ order. See \[`RotationFormat::EulerIntrinsicYxz`] for more information. | \| EULER\_ROTATION\_FORMAT\_INTRINSIC\_YZX | 4 | The angles represent intrinsic rotations in YZX order. See \[`RotationFormat::EulerIntrinsicYzx`] for more information. | \| EULER\_ROTATION\_FORMAT\_INTRINSIC\_ZXY | 5 | The angles represent intrinsic rotations in ZXY order. See \[`RotationFormat::EulerIntrinsicZxy`] for more information. | \| EULER\_ROTATION\_FORMAT\_INTRINSIC\_ZYX | 6 | The angles represent intrinsic rotations in ZYX order. See \[`RotationFormat::EulerIntrinsicZyx`] for more information. | \| EULER\_ROTATION\_FORMAT\_EXTRINSIC\_XYZ | 7 | The angles represent extrinsic rotations in XYZ order. See \[`RotationFormat::EulerExtrinsicXyz`] for more information. | \| EULER\_ROTATION\_FORMAT\_EXTRINSIC\_XZY | 8 | The angles represent extrinsic rotations in XZY order. See \[`RotationFormat::EulerExtrinsicXzy`] for more information. | \| EULER\_ROTATION\_FORMAT\_EXTRINSIC\_YXZ | 9 | The angles represent extrinsic rotations in YXZ order. See \[`RotationFormat::EulerExtrinsicYxz`] for more information. | \| EULER\_ROTATION\_FORMAT\_EXTRINSIC\_YZX | 10 | The angles represent extrinsic rotations in YZX order. See \[`RotationFormat::EulerExtrinsicYzx`] for more information. | \| EULER\_ROTATION\_FORMAT\_EXTRINSIC\_ZXY | 11 | The angles represent extrinsic rotations in ZXY order. See \[`RotationFormat::EulerExtrinsicZxy`] for more information. | \| EULER\_ROTATION\_FORMAT\_EXTRINSIC\_ZYX | 12 | The angles represent extrinsic rotations in ZYX order. See \[`RotationFormat::EulerExtrinsicZyx`] for more information. | ### RotationFormat The format of a 3D rotation. | Name | Number | Description | | ---- | ------ | ----------- | \| ROTATION\_FORMAT\_UNSPECIFIED | 0 | Unspecified value. If used, the server will act as if no value has been specified. | \| ROTATION\_FORMAT\_ANGLE\_AXIS | 1 | The rotation is represented as an axis and an angle of rotation. | \| ROTATION\_FORMAT\_QUATERNION | 2 | The rotation is represented as a quaternion. | \| ROTATION\_FORMAT\_EULER\_INTRINSIC\_XYZ | 3 | The rotation is represented as three intrinsic rotations: around the X axis, then the Y axis and then the Z axis. The rotations are intrinsic: this means that the second rotation is applied in the *rotated* reference frame of the first rotation, and the third rotation is applied in the *rotated* reference frame of the second rotation. This representation is also known as (improper) Euler angles or Tait-Bryan angles. Known robots manufacturers that use this representation: - Staubli (NOTE: uses degrees rather than radians) | \| ROTATION\_FORMAT\_EULER\_INTRINSIC\_XZY | 4 | The rotation is represented as three intrinsic rotations: around the X axis, then the Z axis and then the Y axis. The rotations are intrinsic: this means that the second rotation is applied in the *rotated* reference frame of the first rotation, and the third rotation is applied in the *rotated* reference frame of the second rotation. This representation is also known as (improper) Euler angles or Tait-Bryan angles. | \| ROTATION\_FORMAT\_EULER\_INTRINSIC\_YXZ | 5 | The rotation is represented as three intrinsic rotations: around the Y axis, then the X axis and then the Z axis. The rotations are intrinsic: this means that the second rotation is applied in the *rotated* reference frame of the first rotation, and the third rotation is applied in the *rotated* reference frame of the second rotation. This representation is also known as (improper) Euler angles or Tait-Bryan angles. | \| ROTATION\_FORMAT\_EULER\_INTRINSIC\_YZX | 6 | The rotation is represented as three intrinsic rotations: around the Y axis, then the Z axis and then the X axis. The rotations are intrinsic: this means that the second rotation is applied in the *rotated* reference frame of the first rotation, and the third rotation is applied in the *rotated* reference frame of the second rotation. This representation is also known as (improper) Euler angles or Tait-Bryan angles. | \| ROTATION\_FORMAT\_EULER\_INTRINSIC\_ZXY | 7 | The rotation is represented as three intrinsic rotations: around the Z axis, then the X axis and then the Y axis. The rotations are intrinsic: this means that the second rotation is applied in the *rotated* reference frame of the first rotation, and the third rotation is applied in the *rotated* reference frame of the second rotation. This representation is also known as (improper) Euler angles or Tait-Bryan angles. | \| ROTATION\_FORMAT\_EULER\_INTRINSIC\_ZYX | 8 | The rotation is represented as three intrinsic rotations: around the Z axis, then the Y axis and then the X axis. The rotations are intrinsic: this means that the second rotation is applied in the *rotated* reference frame of the first rotation, and the third rotation is applied in the *rotated* reference frame of the second rotation. This representation is also known as (improper) Euler angles or Tait-Bryan angles. Known robots models that use intrinsic Euler ZYX: - Mitsubishi Industrial Robot CR750/CR751 Series - Kawasaki (NOTE: uses degrees rather than radians) - Kuka (NOTE: uses degrees rather than radians) - Yaskawa (NOTE: uses degrees rather than radians) | \| ROTATION\_FORMAT\_EULER\_EXTRINSIC\_XYZ | 9 | The rotation is represented as three extrinsic rotations: around the X axis, then the Y axis and then the Z axis. The rotations are extrinsic: this means that the second rotation is applied in the *unrotated* base or world frame, and the third rotation is again applied in the *unrotated* base or world frame. This representation is also known as (improper) Euler angles or Tait-Bryan angles. Known robots models that use intrinsic Euler ZYX: - Fanuc (NOTE: Fanuc calls them `W`, `P`, and `R` instead of `X`, `Y` and `Z`, and they use degrees rather than radians). | \| ROTATION\_FORMAT\_EULER\_EXTRINSIC\_XZY | 10 | The rotation is represented as three extrinsic rotations: around the X axis, then the Z axis and then the Y axis. The rotations are extrinsic: this means that the second rotation is applied in the *unrotated* base or world frame, and the third rotation is again applied in the *unrotated* base or world frame. This representation is also known as (improper) Euler angles or Tait-Bryan angles. | \| ROTATION\_FORMAT\_EULER\_EXTRINSIC\_YXZ | 11 | The rotation is represented as three extrinsic rotations: around the Y axis, then the X axis and then the Z axis. The rotations are extrinsic: this means that the second rotation is applied in the *unrotated* base or world frame, and the third rotation is again applied in the *unrotated* base or world frame. This representation is also known as (improper) Euler angles or Tait-Bryan angles. | \| ROTATION\_FORMAT\_EULER\_EXTRINSIC\_YZX | 12 | The rotation is represented as three extrinsic rotations: around the Y axis, then the Z axis and then the X axis. The rotations are extrinsic: this means that the second rotation is applied in the *unrotated* base or world frame, and the third rotation is again applied in the *unrotated* base or world frame. This representation is also known as (improper) Euler angles or Tait-Bryan angles. | \| ROTATION\_FORMAT\_EULER\_EXTRINSIC\_ZXY | 13 | The rotation is represented as three extrinsic rotations: around the Z axis, then the X axis and then the Y axis. The rotations are extrinsic: this means that the second rotation is applied in the *unrotated* base or world frame, and the third rotation is again applied in the *unrotated* base or world frame. This representation is also known as (improper) Euler angles or Tait-Bryan angles. | \| ROTATION\_FORMAT\_EULER\_EXTRINSIC\_ZYX | 14 | The rotation is represented as three extrinsic rotations: around the Z axis, then the Y axis and then the X axis. The rotations are extrinsic: this means that the second rotation is applied in the *unrotated* base or world frame, and the third rotation is again applied in the *unrotated* base or world frame. This representation is also known as (improper) Euler angles or Tait-Bryan angles. | ### CalibrationService | Method Name | Request Type | Response Type | Description | | ---------------- | ------------------------------------------------------- | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | | Ping | [Empty](docId\:Ffr-304MrUMsADpzosp7h) | [Empty](docId\:Ffr-304MrUMsADpzosp7h) | Ping the server to see if communication is working properly. | | GetApiVersion | [GetApiVersionRequest](docId\:Ffr-304MrUMsADpzosp7h) | [GetApiVersionResponse](docId\:Ffr-304MrUMsADpzosp7h) | Get the version of the calibration interface being used by this server. | | GetServerInfo | [GetServerInfoRequest](docId\:Ffr-304MrUMsADpzosp7h) | [GetServerInfoResponse](docId\:Ffr-304MrUMsADpzosp7h) | Get more detailed information about the interface and software (including the version numbers). | | ListCalibrations | [ListCalibrationsRequest](docId\:Ffr-304MrUMsADpzosp7h) | [ListCalibrationsResponse](docId\:Ffr-304MrUMsADpzosp7h) | Get a list of saved calibrations. | \| GetCalibration | [GetCalibrationRequest](docId\:Ffr-304MrUMsADpzosp7h) | [GetCalibrationResponse](docId\:Ffr-304MrUMsADpzosp7h) | Get the data of a saved calibration. Can also be used to get the data of the currently active calibration. | \| SetActiveCalibration | [SetActiveCalibrationRequest](docId\:Ffr-304MrUMsADpzosp7h) | [SetActiveCalibrationResponse](docId\:Ffr-304MrUMsADpzosp7h) | Set the active calibration to any of the saved calibrations. | \| DeleteCalibration | [DeleteCalibrationRequest](docId\:Ffr-304MrUMsADpzosp7h) | [DeleteCalibrationResponse](docId\:Ffr-304MrUMsADpzosp7h) | Delete a saved calibration. | \| UploadCalibration | [UploadCalibrationRequest](docId\:Ffr-304MrUMsADpzosp7h) | [UploadCalibrationResponse](docId\:Ffr-304MrUMsADpzosp7h) | Upload a calibration to the server. This service can be used to upload calibration data managed by some other system. You can set `make_active` to true to directly make it the active calibration. | \| StartCalibrationCycle | [StartCalibrationCycleRequest](docId\:Ffr-304MrUMsADpzosp7h) | [StartCalibrationCycleResponse](docId\:Ffr-304MrUMsADpzosp7h) | Start a new calibration cycle. Note that not all cameras support starting multiple calibration cycles at once. In that case, you must close any open calibration cycle before starting a new one. A calibration cycle will calibrate the camera with respect to either a fixed frame or a moving frame. A common choice for fixed frame is the base frame of the robot. It is important that this frame does not move (or the robot moves along with it). The moving frame is usually the flange of the robot, or some other tool or end-effector configured on the robot. If the camera is attached to the moving frame then the calibration plate must be attached to the fixed frame. And the other way around: if the camera is attached to the fixed frame then the calibration plate must be attached to the moving frame. A normal calibration cycle could consist of the following service calls: \* One call to \[`start_calibration_cycle`] to start the cycle. \* One or more calls to \[`record_sample`] to add samples. \* One call to \[`compute_calibration`] (which by defalt also saves the calibration and closes the calibration cycle). \* One call to \[`set_active_calibration`] to make the newly computed calibration the active one (if desired). | \| CloseCalibrationCycle | [CloseCalibrationCycleRequest](docId\:Ffr-304MrUMsADpzosp7h) | [CloseCalibrationCycleResponse](docId\:Ffr-304MrUMsADpzosp7h) | Close an open calibration cycle. If the calibration has not been computed or saved yet, it is lost. This service gives an error if there is no calibration cycle currently open. | \| ListCalibrationCycles | [ListCalibrationCyclesRequest](docId\:Ffr-304MrUMsADpzosp7h) | [ListCalibrationCyclesResponse](docId\:Ffr-304MrUMsADpzosp7h) | List all open calibration cycles. | \| RecordSample | [RecordSampleRequest](docId\:Ffr-304MrUMsADpzosp7h) | [RecordSampleResponse](docId\:Ffr-304MrUMsADpzosp7h) | Record a new sample for a calibration cycle. The robot (or moving frame) must be standing still at the pose indicated in the request. This will record an image and (try to) detect the calibration pattern in it. This service gives an error if there is no calibration cycle currently open. | \| ComputeCalibration | [ComputeCalibrationRequest](docId\:Ffr-304MrUMsADpzosp7h) | [ComputeCalibrationResponse](docId\:Ffr-304MrUMsADpzosp7h) | Compute the calibration for a calibration cycle. The amount of samples required depends on whether or not \[`skip_pattern_pose_computation`] is enabled. If it is, only 1 sample is needed, but you can still add more samples to increase the accuracy of the calibration. If \[`skip_pattern_pose_computation`] is disabled, then the absolute minimum number of samples is 3. However, it is recommended to record at least 10 samples with different robot positions and orientations. By default, the calibration will be saved using an auto-generated name, and the calibration cycle will be closed. However, both of these actions can be disabled by setting \[`no_save`] and \[`no_close`] respectively. This service gives an error if there is no calibration cycle currently open. | \| SaveComputedCalibration | [SaveComputedCalibrationRequest](docId\:Ffr-304MrUMsADpzosp7h) | [SaveComputedCalibrationResponse](docId\:Ffr-304MrUMsADpzosp7h) | Save the calibration computed in a calibration cycle. By default, this service will also close the calibration cycle, but this can be disabled by setting \[`no_close`] to true. Note that the \[`compute_calibration`] service already saves the calibration by default. This service gives an error if there is no calibration cycle currently open, or if no calibration has been computed yet. | ## Scalar Value Types | .proto Type | Notes | C++ | Java | Python | Go | C# | PHP | Ruby | | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------- | ----------- | ------- | ---------- | -------------- | ------------------------------ | | double | | double | double | float | float64 | double | float | Float | | float | | float | float | float | float32 | float | float | Float | | int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) | | int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int64 | long | int/long | int64 | long | integer/string | Bignum | | uint32 | Uses variable-length encoding. | uint32 | int | int/long | uint32 | uint | integer | Bignum or Fixnum (as required) | | uint64 | Uses variable-length encoding. | uint64 | long | int/long | uint64 | ulong | integer/string | Bignum or Fixnum (as required) | | sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) | | sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int64 | long | int/long | int64 | long | integer/string | Bignum | | fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | uint32 | int | int | uint32 | uint | integer | Bignum or Fixnum (as required) | | fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | uint64 | long | int/long | uint64 | ulong | integer/string | Bignum | | sfixed32 | Always four bytes. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) | | sfixed64 | Always eight bytes. | int64 | long | int/long | int64 | long | integer/string | Bignum | | bool | | bool | boolean | boolean | bool | bool | boolean | TrueClass/FalseClass | | string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode | string | string | string | String (UTF-8) | | bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str | \[]byte | ByteString | string | String (ASCII-8BIT) |