poliastro2.core.frames.ecliptic

Functions

gcrs_to_geosolarecliptic(gcrs_coo, to_frame)

geosolarecliptic_to_gcrs(from_coo, gcrs_frame)

Classes

GeocentricSolarEcliptic(*args[, copy, ...])

This system has its X axis towards the Sun and its Z axis perpendicular to the plane of the Earth's orbit around the Sun (positive North).
class poliastro2.core.frames.ecliptic.GeocentricMeanEcliptic(*args, copy=True, representation_type=None, differential_type=None, **kwargs)

Geocentric mean ecliptic coordinates. These origin of the coordinates are the geocenter (Earth), with the x axis pointing to the mean (not true) equinox at the time specified by the equinox attribute, and the xy-plane in the plane of the ecliptic for that date.

Be aware that the definition of “geocentric” here means that this frame includes light deflection from the sun, aberration, etc when transforming to/from e.g. ICRS.

The frame attributes are listed under Other Parameters.

Parameters:

  • data (~astropy.coordinates.BaseRepresentation subclass instance) – A representation object or None to have no data (or use the coordinate component arguments, see below).

  • lon (~astropy.coordinates.Angle, optional, keyword-only) – The ecliptic longitude for this object (lat must also be given and representation must be None).

  • lat (~astropy.coordinates.Angle, optional, keyword-only) – The ecliptic latitude for this object (lon must also be given and representation must be None).

  • distance (~astropy.units.Quantity [‘length’], optional, keyword-only) – The distance for this object from the geocenter. (representation must be None).

  • pm_lon_coslat (~astropy.units.Quantity [‘angualar speed’], optional, keyword-only) – The proper motion in the ecliptic longitude (including the cos(lat) factor) for this object (pm_lat must also be given).

  • pm_lat (~astropy.units.Quantity [‘angular speed’], optional, keyword-only) – The proper motion in the ecliptic latitude for this object (pm_lon_coslat must also be given).

  • radial_velocity (~astropy.units.Quantity [‘speed’], optional, keyword-only) – The radial velocity of this object.

  • representation_type (~astropy.coordinates.BaseRepresentation subclass, str, optional) – A representation class or string name of a representation class. This sets the expected input representation class, thereby changing the expected keyword arguments for the data passed in. For example, passing representation_type='cartesian' will make the classes expect position data with cartesian names, i.e. x, y, z in most cases unless overridden via frame_specific_representation_info. To see this frame’s names, check out <this frame>().representation_info.

  • differential_type (~astropy.coordinates.BaseDifferential subclass, str, dict, optional) – A differential class or dictionary of differential classes (currently only a velocity differential with key ‘s’ is supported). This sets the expected input differential class, thereby changing the expected keyword arguments of the data passed in. For example, passing differential_type='cartesian' will make the classes expect velocity data with the argument names v_x, v_y, v_z unless overridden via frame_specific_representation_info. To see this frame’s names, check out <this frame>().representation_info.

  • copy (bool, optional) – If True (default), make copies of the input coordinate arrays. Can only be passed in as a keyword argument.

  • equinox (~astropy.time.Time, optional) – The date to assume for this frame. Determines the location of the x-axis and the location of the Earth (necessary for transformation to non-geocentric systems). Defaults to the ‘J2000’ equinox.

  • obstime (~astropy.time.Time, optional) – The time at which the observation is taken. Used for determining the position of the Earth. Defaults to J2000.

_abc_impl = <_abc._abc_data object>
_default_differential

alias of SphericalCosLatDifferential

_default_representation

alias of SphericalRepresentation

_frame_class_cache = {}
_frame_specific_representation_info = {<class 'astropy.coordinates.representation.CartesianDifferential'>: [('d_x', 'v_x', Unit("km / s")), ('d_y', 'v_y', Unit("km / s")), ('d_z', 'v_z', Unit("km / s"))], <class 'astropy.coordinates.representation.SphericalCosLatDifferential'>: [('d_lon_coslat', 'pm_lon_coslat', Unit("mas / yr")), ('d_lat', 'pm_lat', Unit("mas / yr")), ('d_distance', 'radial_velocity', Unit("km / s"))], <class 'astropy.coordinates.representation.SphericalDifferential'>: [('d_lon', 'pm_lon', Unit("mas / yr")), ('d_lat', 'pm_lat', Unit("mas / yr")), ('d_distance', 'radial_velocity', Unit("km / s"))], <class 'astropy.coordinates.representation.SphericalRepresentation'>: [('lon', 'lon', 'recommended'), ('lat', 'lat', 'recommended')], <class 'astropy.coordinates.representation.UnitSphericalCosLatDifferential'>: [('d_lon_coslat', 'pm_lon_coslat', Unit("mas / yr")), ('d_lat', 'pm_lat', Unit("mas / yr")), ('d_distance', 'radial_velocity', Unit("km / s"))], <class 'astropy.coordinates.representation.UnitSphericalDifferential'>: [('d_lon', 'pm_lon', Unit("mas / yr")), ('d_lat', 'pm_lat', Unit("mas / yr")), ('d_distance', 'radial_velocity', Unit("km / s"))], <class 'astropy.coordinates.representation.UnitSphericalRepresentation'>: [('lon', 'lon', 'recommended'), ('lat', 'lat', 'recommended')]}
property default_differential

Default representation for differential data (e.g., velocity)

property default_representation

Default representation for position data

equinox = <Time object: scale='tt' format='jyear_str' value=J2000.000>
frame_attributes = {'equinox': <astropy.coordinates.attributes.TimeAttribute object>, 'obstime': <astropy.coordinates.attributes.TimeAttribute object>}
property frame_specific_representation_info

Mapping for frame-specific component names

name = 'geocentricmeanecliptic'
obstime = <Time object: scale='tt' format='jyear_str' value=J2000.000>
class poliastro2.core.frames.ecliptic.GeocentricSolarEcliptic(*args, copy=True, representation_type=None, differential_type=None, **kwargs)

This system has its X axis towards the Sun and its Z axis perpendicular to the plane of the Earth’s orbit around the Sun (positive North).

This system is fixed with respect to the Earth-Sun line. It is convenient for specifying magnetospheric boundaries. It has also been widely adopted as the system for representing vector quantities in space physics databases.

_abc_impl = <_abc._abc_data object>
_default_differential

alias of SphericalCosLatDifferential

_default_representation

alias of SphericalRepresentation

_frame_class_cache = {}
_frame_specific_representation_info = {<class 'astropy.coordinates.representation.CartesianDifferential'>: [('d_x', 'v_x', Unit("km / s")), ('d_y', 'v_y', Unit("km / s")), ('d_z', 'v_z', Unit("km / s"))], <class 'astropy.coordinates.representation.SphericalCosLatDifferential'>: [('d_lon_coslat', 'pm_lon_coslat', Unit("mas / yr")), ('d_lat', 'pm_lat', Unit("mas / yr")), ('d_distance', 'radial_velocity', Unit("km / s"))], <class 'astropy.coordinates.representation.SphericalDifferential'>: [('d_lon', 'pm_lon', Unit("mas / yr")), ('d_lat', 'pm_lat', Unit("mas / yr")), ('d_distance', 'radial_velocity', Unit("km / s"))], <class 'astropy.coordinates.representation.SphericalRepresentation'>: [('lon', 'lon', 'recommended'), ('lat', 'lat', 'recommended')], <class 'astropy.coordinates.representation.UnitSphericalCosLatDifferential'>: [('d_lon_coslat', 'pm_lon_coslat', Unit("mas / yr")), ('d_lat', 'pm_lat', Unit("mas / yr")), ('d_distance', 'radial_velocity', Unit("km / s"))], <class 'astropy.coordinates.representation.UnitSphericalDifferential'>: [('d_lon', 'pm_lon', Unit("mas / yr")), ('d_lat', 'pm_lat', Unit("mas / yr")), ('d_distance', 'radial_velocity', Unit("km / s"))], <class 'astropy.coordinates.representation.UnitSphericalRepresentation'>: [('lon', 'lon', 'recommended'), ('lat', 'lat', 'recommended')]}
property default_differential

Default representation for differential data (e.g., velocity)

property default_representation

Default representation for position data

frame_attributes = {'obstime': <astropy.coordinates.attributes.TimeAttribute object>}
property frame_specific_representation_info

Mapping for frame-specific component names

name = 'geocentricsolarecliptic'
obstime = <Time object: scale='tt' format='jyear_str' value=J2000.000>
poliastro2.core.frames.ecliptic.HeliocentricEclipticJ2000

alias of HeliocentricEclipticIAU76