# CartesianDifferential¶

class astropy.coordinates.CartesianDifferential(d_x, d_y=None, d_z=None, unit=None, xyz_axis=None, copy=True)[source]

Differentials in of points in 3D cartesian coordinates.

Parameters: d_x, d_y, d_z : Quantity or array The x, y, and z coordinates of the differentials. If d_x, d_y, and d_z have different shapes, they should be broadcastable. If not quantities, unit should be set. If only d_x is given, it is assumed that it contains an array with the 3 coordinates stored along xyz_axis. unit : Unit or str If given, the differentials will be converted to this unit (or taken to be in this unit if not given. xyz_axis : int, optional The axis along which the coordinates are stored when a single array is provided instead of distinct d_x, d_y, and d_z (default: 0). copy : bool, optional If True (default), arrays will be copied rather than referenced.

Attributes Summary

 attr_classes d_x Component ‘d_x’ of the Differential. d_xyz Return a vector array of the x, y, and z coordinates. d_y Component ‘d_y’ of the Differential. d_z Component ‘d_z’ of the Differential.

Methods Summary

 from_cartesian(other[, base]) Convert the differential from 3D rectangular cartesian coordinates to the desired class. get_d_xyz(self[, xyz_axis]) Return a vector array of the x, y, and z coordinates. to_cartesian(self[, base]) Convert the differential to 3D rectangular cartesian coordinates.

Attributes Documentation

attr_classes = {'d_x': <class 'astropy.units.quantity.Quantity'>, 'd_y': <class 'astropy.units.quantity.Quantity'>, 'd_z': <class 'astropy.units.quantity.Quantity'>}
d_x

Component ‘d_x’ of the Differential.

d_xyz

Return a vector array of the x, y, and z coordinates.

Parameters: xyz_axis : int, optional The axis in the final array along which the x, y, z components should be stored (default: 0). d_xyz : Quantity With dimension 3 along xyz_axis. Note that, if possible, this will be a view.
d_y

Component ‘d_y’ of the Differential.

d_z

Component ‘d_z’ of the Differential.

Methods Documentation

classmethod from_cartesian(other, base=None)[source]

Convert the differential from 3D rectangular cartesian coordinates to the desired class.

Parameters: other : The object to convert into this differential. base : instance of self.base_representation The points for which the differentials are to be converted: each of the components is multiplied by its unit vectors and scale factors. A new differential object that is this class’ type.
get_d_xyz(self, xyz_axis=0)[source]

Return a vector array of the x, y, and z coordinates.

Parameters: xyz_axis : int, optional The axis in the final array along which the x, y, z components should be stored (default: 0). d_xyz : Quantity With dimension 3 along xyz_axis. Note that, if possible, this will be a view.
to_cartesian(self, base=None)[source]

Convert the differential to 3D rectangular cartesian coordinates.

Parameters: base : instance of self.base_representation The points for which the differentials are to be converted: each of the components is multiplied by its unit vectors and scale factors. This object as a CartesianDifferential