Skip to content

convert_point_3d_spher_to_cartConvertPoint3dSpherToCartConvertPoint3dSpherToCartconvert_point_3d_spher_to_cartconvert_point_3d_spher_to_cart🔗

Short description🔗

convert_point_3d_spher_to_cartConvertPoint3dSpherToCartConvertPoint3dSpherToCartconvert_point_3d_spher_to_cartconvert_point_3d_spher_to_cart — Convert spherical coordinates of a 3D point to Cartesian coordinates.

Signature🔗

convert_point_3d_spher_to_cart( angle.rad Longitude, angle.rad Latitude, real Radius, string EquatPlaneNormal, string ZeroMeridian, out real X, out real Y, out real Z )void ConvertPoint3dSpherToCart( const HTuple& Longitude, const HTuple& Latitude, const HTuple& Radius, const HTuple& EquatPlaneNormal, const HTuple& ZeroMeridian, HTuple* X, HTuple* Y, HTuple* Z )static void HOperatorSet.ConvertPoint3dSpherToCart( HTuple longitude, HTuple latitude, HTuple radius, HTuple equatPlaneNormal, HTuple zeroMeridian, out HTuple x, out HTuple y, out HTuple z )def convert_point_3d_spher_to_cart( longitude: MaybeSequence[float], latitude: MaybeSequence[float], radius: MaybeSequence[float], equat_plane_normal: str, zero_meridian: str ) -> Tuple[Sequence[float], Sequence[float], Sequence[float]]

def convert_point_3d_spher_to_cart_s( longitude: MaybeSequence[float], latitude: MaybeSequence[float], radius: MaybeSequence[float], equat_plane_normal: str, zero_meridian: str ) -> Tuple[float, float, float]Herror convert_point_3d_spher_to_cart( double Longitude, double Latitude, double Radius, const char* EquatPlaneNormal, const char* ZeroMeridian, double* X, double* Y, double* Z )

Herror T_convert_point_3d_spher_to_cart( const Htuple Longitude, const Htuple Latitude, const Htuple Radius, const Htuple EquatPlaneNormal, const Htuple ZeroMeridian, Htuple* X, Htuple* Y, Htuple* Z )

static void HMisc::ConvertPoint3dSpherToCart( const HTuple& Longitude, const HTuple& Latitude, const HTuple& Radius, const HString& EquatPlaneNormal, const HString& ZeroMeridian, HTuple* X, HTuple* Y, HTuple* Z )

static void HMisc::ConvertPoint3dSpherToCart( double Longitude, double Latitude, double Radius, const HString& EquatPlaneNormal, const HString& ZeroMeridian, double* X, double* Y, double* Z )

static void HMisc::ConvertPoint3dSpherToCart( double Longitude, double Latitude, double Radius, const char* EquatPlaneNormal, const char* ZeroMeridian, double* X, double* Y, double* Z )

static void HMisc::ConvertPoint3dSpherToCart( double Longitude, double Latitude, double Radius, const wchar_t* EquatPlaneNormal, const wchar_t* ZeroMeridian, double* X, double* Y, double* Z ) (Windows only)

static void HMisc.ConvertPoint3dSpherToCart( HTuple longitude, HTuple latitude, HTuple radius, string equatPlaneNormal, string zeroMeridian, out HTuple x, out HTuple y, out HTuple z )

static void HMisc.ConvertPoint3dSpherToCart( double longitude, double latitude, double radius, string equatPlaneNormal, string zeroMeridian, out double x, out double y, out double z )

Description🔗

The operator convert_point_3d_spher_to_cartConvertPoint3dSpherToCart converts the spherical coordinates of a 3D point, which are given in Longitudelongitudelongitude, Latitudelatitudelatitude, and Radiusradiusradius, into the Cartesian coordinates Xxx, Yyy, and Zzz. The spherical coordinates Longitudelongitudelongitude and Latitudelatitudelatitude must be specified in radians. Furthermore, the Latitudelatitudelatitude must be within the range \([-\pi/2,+\pi/2]\), where the latitude of the north pole is \(\pi/2\), and hence, the latitude of the south pole is \(-\pi/2\).

The orientation of the spherical coordinate system with respect to the Cartesian coordinate system can be specified with the parameters EquatPlaneNormalequatPlaneNormalequat_plane_normal and ZeroMeridianzeroMeridianzero_meridian.

EquatPlaneNormalequatPlaneNormalequat_plane_normal determines the normal of the equatorial plane (longitude == 0) pointing to the north pole (positive latitude) and may take the following values:

  • 'x'"x": The equatorial plane is the yz plane. The positive x axis points to the north pole.

  • '-x'"-x": The equatorial plane is the yz plane. The positive x axis points to the south pole.

  • 'y'"y": The equatorial plane is the xz plane. The positive y axis points to the north pole.

  • '-y'"-y": The equatorial plane is the xz plane. The positive y axis points to the south pole.

  • 'z'"z": The equatorial plane is the xy plane. The positive z axis points to the north pole.

  • '-z'"-z": The equatorial plane is the xy plane. The positive z axis points to the south pole.

The position of the zero meridian can be specified with the parameter ZeroMeridianzeroMeridianzero_meridian. For this, the coordinate axis (lying in the equatorial plane) that points to the zero meridian must be passed. The following values for ZeroMeridianzeroMeridianzero_meridian are valid:

  • 'x'"x": The positive x axis points in the direction of the zero meridian.

  • '-x'"-x": The negative x axis points in the direction of the zero meridian.

  • 'y'"y": The positive y axis points in the direction of the zero meridian.

  • '-y'"-y": The negative y axis points in the direction of the zero meridian.

  • 'z'"z": The positive z axis points in the direction of the zero meridian.

  • '-z'"-z": The negative z axis points in the direction of the zero meridian.

Only reasonable combinations of EquatPlaneNormalequatPlaneNormalequat_plane_normal and ZeroMeridianzeroMeridianzero_meridian are permitted, i.e., the normal of the equatorial plane must not be parallel to the direction of the zero meridian. For example, the combination EquatPlaneNormalequatPlaneNormalequat_plane_normal='y'"y" and ZeroMeridianzeroMeridianzero_meridian='-y'"-y" is not permitted.

Note that in order to guarantee a consistent conversion back from Cartesian to spherical coordinates by using convert_point_3d_cart_to_spherConvertPoint3dCartToSpher, the same values must be passed for EquatPlaneNormalequatPlaneNormalequat_plane_normal and ZeroMeridianzeroMeridianzero_meridian as were passed to convert_point_3d_spher_to_cartConvertPoint3dSpherToCart.

The operator convert_point_3d_spher_to_cartConvertPoint3dSpherToCart can be used, for example, to convert a camera position that is given in spherical coordinates into Cartesian coordinates. The result can then be utilized to create a complete camera pose by passing the Cartesian coordinates to create_cam_pose_look_at_pointCreateCamPoseLookAtPoint.

Execution information🔗

Execution information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Processed without parallelization.

Parameters🔗

Longitudelongitudelongitude (input_control) angle.rad(-array) → (real)HTuple (double)HTuple (double)MaybeSequence[float]Htuple (double)

Longitude of the 3D point.

Latitudelatitudelatitude (input_control) angle.rad(-array) → (real)HTuple (double)HTuple (double)MaybeSequence[float]Htuple (double)

Latitude of the 3D point.

Restriction: -pi/2 <= Latitude && Latitude <= pi/2

Radiusradiusradius (input_control) real(-array) → (real)HTuple (double)HTuple (double)MaybeSequence[float]Htuple (double)

Radius of the 3D point.

EquatPlaneNormalequatPlaneNormalequat_plane_normal (input_control) string → (string)HTuple (HString)HTuple (string)strHtuple (char*)

Normal vector of the equatorial plane (points to the north pole).

Default: '-y'"-y"
List of values: '-x', '-y', '-z', 'x', 'y', 'z'"-x", "-y", "-z", "x", "y", "z"

ZeroMeridianzeroMeridianzero_meridian (input_control) string → (string)HTuple (HString)HTuple (string)strHtuple (char*)

Coordinate axis in the equatorial plane that points to the zero meridian.

Default: '-z'"-z"
List of values: '-x', '-y', '-z', 'x', 'y', 'z'"-x", "-y", "-z", "x", "y", "z"

Xxx (output_control) real(-array) → (real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

X coordinate of the 3D point.

Yyy (output_control) real(-array) → (real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Y coordinate of the 3D point.

Zzz (output_control) real(-array) → (real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Z coordinate of the 3D point.

Result🔗

If the parameters are valid, the operator convert_point_3d_spher_to_cartConvertPoint3dSpherToCart returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

get_shape_model_3d_paramsGetShapeModel3dParams

See also

convert_point_3d_cart_to_spherConvertPoint3dCartToSpher

Module🔗

3D Metrology