HeliographicStonyhurst

class sunpy.coordinates.frames.HeliographicStonyhurst(*args, **kwargs)[source] [edit on github]

Bases: astropy.coordinates.BaseCoordinateFrame

A coordinate or frame in the Stonyhurst Heliographic system.

In a cartesian representation this is also known as the Heliocentric Earth Equatorial (HEEQ) system. This frame has its origin at the solar centre and the north pole above the solar north pole, and the zero line on longitude pointing towards the Earth.

A new instance can be created using the following signatures (note that all the arguments must be supplied as keywords):

HeliographicStonyhurst(lon, lat, obstime)
HeliographicStonyhurst(lon, lat, radius, obstime)
HeliographicStonyhurst(x, y, z, obstime, representation='cartesian')
Parameters:
  • representation (BaseRepresentation or None) – A representation object or None to have no data.
  • lon (Angle, optional) – The longitude for this object (lat must also be given and representation must be None).
  • lat (Angle, optional) – The latitude for this object (lon must also be given and representation must be None).
  • radius (Quantity, optional) – This quantity holds the radial distance. If not specified, it is, by default, the radius of the photosphere.
  • x (Quantity, optional) – x coordinate.
  • y (Quantity, optional) – y coordinate.
  • z (Quantity, optional) – z coordinate.
  • obstime (Time) – The date and time of the observation, used to convert to heliographic carrington coordinates.

Examples

>>> from astropy.coordinates import SkyCoord
>>> import sunpy.coordinates
>>> import astropy.units as u
>>> sc = SkyCoord(1*u.deg, 1*u.deg, 2*u.km,
...               frame="heliographic_stonyhurst",
...               obstime="2010/01/01T00:00:45")
>>> sc
<SkyCoord (HeliographicStonyhurst: obstime=2010-01-01 00:00:45): (lon, lat, radius) in (deg, deg, km)
    (1., 1., 2.)>
>>> sc.frame
<HeliographicStonyhurst Coordinate (obstime=2010-01-01 00:00:45): (lon, lat, radius) in (deg, deg, km)
    (1., 1., 2.)>
>>> sc = SkyCoord(HeliographicStonyhurst(-10*u.deg, 2*u.deg))
>>> sc
<SkyCoord (HeliographicStonyhurst: obstime=None): (lon, lat, radius) in (deg, deg, km)
    (-10., 2., 695508.)>

Notes

This frame will always be converted a 3D frame where the radius defaults to rsun.

Attributes Summary

default_differential
default_representation
frame_attributes
frame_specific_representation_info
name
obstime

Attributes Documentation

default_differential
default_representation
frame_attributes = OrderedDict([('obstime', <sunpy.coordinates.frameattributes.TimeFrameAttributeSunPy object>)])
frame_specific_representation_info
name = 'heliographic_stonyhurst'
obstime = None