Remarks

The internal geocentric coordinate reference system is a Cartesian system in meters with origin in the center of the earth. The coordinates of such a system are traditionally written with uppercase X, Y and Z. The positive X-axis goes through 0°E, 0°N, the positive Y-axis goes through 90°E, 0°N, and the positive Z-axis goes through the north pole.

The method assumes that the earth is a sphere with radius 6 371 000 meters, which is the earth model used by a GlobeView. So this method is appropriate when your application needs to interact with the Cartesian coordinates in a GlobeView, for example if you are developing your own 3D tools.

There is a similar CRS method, Crs.ProjectFromGeocentricXYZ, which will use the reference ellipsoid of the CRS instead of a sphere.

Remarks

The geocentric Cartesian coordinate system is meter-based and has its origin in the center of the earth. The coordinates of such a system are traditionally written with uppercase X, Y and Z. The positive X-axis goes through 0°E, 0°N, the positive Y-axis goes through 90°E, 0°N, and the positive Z-axis goes through the north pole.

The method assumes that the earth is a sphere with radius 6 371 000 meters, which is the earth model used by a GlobeView. So this method is appropriate when your application needs to interact with the Cartesian coordinates in a GlobeView, for example if you are developing your own 3D tools.

The given geocentric forward vector and up vector do not have to be of unit length. But if one or both are of zero length, or if they are not perpendicular, the calculated bearing, pitch and roll will not be well-defined.

Uniqueness

There are several possible values for bearing, pitch and roll that would represent the same overall orientation. Obviously, you could add a multiple of 360° to any of them without changing the orientation. Also, a pitch greater than 90° can be replaced by a pitch less than 90°, since a triple (bearing = b, pitch = p, roll = r) with p > 90° is equivalent to the triple (bearing = b + 180°, pitch = 180° − p, roll = r + 180°). Finally, if the pitch is vertical, both bearing and roll will express rotations about the vertical axis ("gimbal lock"), so if the pitch is 90°, all combinations of bearing and roll with the same difference are equivalent, and if the pitch is −90°, all combinations of bearing and roll with the same sum are equivalent.

So in order to get unique results, the returned values of bearing, pitch and roll have restricted ranges: the bearing will be in the range 0° to 360°, the pitch will be in the range −90° to 90°, and the roll will be in the range −180° to 180°. And if the absolute value of the pitch is 90° or within 2 picodegrees from 90°, the returned roll will be zero.

Remarks

The internal geocentric coordinate reference system is a Cartesian system in meters with origin in the center of the earth. The coordinates of such a system are traditionally written with uppercase X, Y and Z. The positive X-axis goes through 0°E, 0°N, the positive Y-axis goes through 90°E, 0°N, and the positive Z-axis goes through the north pole.

The method assumes that the earth is a sphere with radius 6 371 000 meters, which is the earth model used by a GlobeView. So this method is appropriate when your application needs to interact with the Cartesian coordinates in a GlobeView, for example if you are developing your own 3D tools.

There is a similar CRS method, Crs::projectFromGeocentricXYZ, which will use the reference ellipsoid of the CRS instead of a sphere.

Remarks

The geocentric Cartesian coordinate system is meter-based and has its origin in the center of the earth. The coordinates of such a system are traditionally written with uppercase X, Y and Z. The positive X-axis goes through 0°E, 0°N, the positive Y-axis goes through 90°E, 0°N, and the positive Z-axis goes through the north pole.

The method assumes that the earth is a sphere with radius 6 371 000 meters, which is the earth model used by a GlobeView. So this method is appropriate when your application needs to interact with the Cartesian coordinates in a GlobeView, for example if you are developing your own 3D tools.

The given geocentric forward vector and up vector do not have to be of unit length. But if one or both are of zero length, or if they are not perpendicular, the calculated bearing, pitch and roll will not be well-defined.

Uniqueness

There are several possible values for bearing, pitch and roll that would represent the same overall orientation. Obviously, you could add a multiple of 360° to any of them without changing the orientation. Also, a pitch greater than 90° can be replaced by a pitch less than 90°, since a triple (bearing = b, pitch = p, roll = r) with p > 90° is equivalent to the triple (bearing = b + 180°, pitch = 180° − p, roll = r + 180°). Finally, if the pitch is vertical, both bearing and roll will express rotations about the vertical axis ("gimbal lock"), so if the pitch is 90°, all combinations of bearing and roll with the same difference are equivalent, and if the pitch is −90°, all combinations of bearing and roll with the same sum are equivalent.

So in order to get unique results, the returned values of bearing, pitch and roll have restricted ranges: the bearing will be in the range 0° to 360°, the pitch will be in the range −90° to 90°, and the roll will be in the range −180° to 180°. And if the absolute value of the pitch is 90° or within 2 picodegrees from 90°, the returned roll will be zero.

Remarks

The internal geocentric coordinate reference system is a Cartesian system in meters with origin in the center of the earth. The coordinates of such a system are traditionally written with uppercase X, Y and Z. The positive X-axis goes through 0°E, 0°N, the positive Y-axis goes through 90°E, 0°N, and the positive Z-axis goes through the north pole.

The method assumes that the earth is a sphere with radius 6 371 000 meters, which is the earth model used by a GlobeView. So this method is appropriate when your application needs to interact with the Cartesian coordinates in a GlobeView, for example if you are developing your own 3D tools.

There is a similar CRS method, Crs.projectFromGeocentricXYZ, which will use the reference ellipsoid of the CRS instead of a sphere.

Remarks

The geocentric Cartesian coordinate system is meter-based and has its origin in the center of the earth. The coordinates of such a system are traditionally written with uppercase X, Y and Z. The positive X-axis goes through 0°E, 0°N, the positive Y-axis goes through 90°E, 0°N, and the positive Z-axis goes through the north pole.

The method assumes that the earth is a sphere with radius 6 371 000 meters, which is the earth model used by a GlobeView. So this method is appropriate when your application needs to interact with the Cartesian coordinates in a GlobeView, for example if you are developing your own 3D tools.

The given geocentric forward vector and up vector do not have to be of unit length. But if one or both are of zero length, or if they are not perpendicular, the calculated bearing, pitch and roll will not be well-defined.

Uniqueness

There are several possible values for bearing, pitch and roll that would represent the same overall orientation. Obviously, you could add a multiple of 360° to any of them without changing the orientation. Also, a pitch greater than 90° can be replaced by a pitch less than 90°, since a triple (bearing = b, pitch = p, roll = r) with p > 90° is equivalent to the triple (bearing = b + 180°, pitch = 180° − p, roll = r + 180°). Finally, if the pitch is vertical, both bearing and roll will express rotations about the vertical axis ("gimbal lock"), so if the pitch is 90°, all combinations of bearing and roll with the same difference are equivalent, and if the pitch is −90°, all combinations of bearing and roll with the same sum are equivalent.

So in order to get unique results, the returned values of bearing, pitch and roll have restricted ranges: the bearing will be in the range 0° to 360°, the pitch will be in the range −90° to 90°, and the roll will be in the range −180° to 180°. And if the absolute value of the pitch is 90° or within 2 picodegrees from 90°, the returned roll will be zero.

Remarks

The internal geocentric coordinate reference system is a Cartesian system in meters with origin in the center of the earth. The coordinates of such a system are traditionally written with uppercase X, Y and Z. The positive X-axis goes through 0°E, 0°N, the positive Y-axis goes through 90°E, 0°N, and the positive Z-axis goes through the north pole.

The method assumes that the earth is a sphere with radius 6 371 000 meters, which is the earth model used by a GlobeView. So this method is appropriate when your application needs to interact with the Cartesian coordinates in a GlobeView, for example if you are developing your own 3D tools.

There is a similar CRS method, Crs.projectFromGeocentricXYZ, which will use the reference ellipsoid of the CRS instead of a sphere.

Remarks

The geocentric Cartesian coordinate system is meter-based and has its origin in the center of the earth. The coordinates of such a system are traditionally written with uppercase X, Y and Z. The positive X-axis goes through 0°E, 0°N, the positive Y-axis goes through 90°E, 0°N, and the positive Z-axis goes through the north pole.

The method assumes that the earth is a sphere with radius 6 371 000 meters, which is the earth model used by a GlobeView. So this method is appropriate when your application needs to interact with the Cartesian coordinates in a GlobeView, for example if you are developing your own 3D tools.

The given geocentric forward vector and up vector do not have to be of unit length. But if one or both are of zero length, or if they are not perpendicular, the calculated bearing, pitch and roll will not be well-defined.

Uniqueness

There are several possible values for bearing, pitch and roll that would represent the same overall orientation. Obviously, you could add a multiple of 360° to any of them without changing the orientation. Also, a pitch greater than 90° can be replaced by a pitch less than 90°, since a triple (bearing = b, pitch = p, roll = r) with p > 90° is equivalent to the triple (bearing = b + 180°, pitch = 180° − p, roll = r + 180°). Finally, if the pitch is vertical, both bearing and roll will express rotations about the vertical axis ("gimbal lock"), so if the pitch is 90°, all combinations of bearing and roll with the same difference are equivalent, and if the pitch is −90°, all combinations of bearing and roll with the same sum are equivalent.

So in order to get unique results, the returned values of bearing, pitch and roll have restricted ranges: the bearing will be in the range 0° to 360°, the pitch will be in the range −90° to 90°, and the roll will be in the range −180° to 180°. And if the absolute value of the pitch is 90° or within 2 picodegrees from 90°, the returned roll will be zero.