HeliographicCarrington

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

Bases: sunpy.coordinates.frames.HeliographicStonyhurst

A coordinate or frame in the Carrington Heliographic system.

  • The origin is the centre of the Sun

  • The z-axis is aligned with the Sun’s north pole

  • The x and y axes rotate with a period of 25.38 days. The line of zero longitude passed through the disk centre as seen from Earth at 21:36 on 9th Nov 1853.

This frame differs from the Stonyhurst version in the definition of the longitude, which is defined using the time-dependant offset described above.

Parameters
  • representation (BaseRepresentation or None.) – A representation object. If specified, other parameters must be in keyword form.

  • lon (Angle object.) – The longitude for this object (lat must also be given and representation must be None).

  • lat (Angle object.) – The latitude for this object (lon must also be given and representation must be None).

  • radius (astropy.units.Quantity object, optional, must be keyword.) – This quantity holds the radial distance. Defaults to the solar radius.

  • obstime (SunPy 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, 2*u.deg, 3*u.km,
...               frame="heliographic_carrington",
...               obstime="2010/01/01T00:00:30")
>>> sc
<SkyCoord (HeliographicCarrington: obstime=2010-01-01T00:00:30.000): (lon, lat, radius) in (deg, deg, km)
    (1., 2., 3.)>
>>> sc = SkyCoord([1,2,3]*u.deg, [4,5,6]*u.deg, [5,6,7]*u.km,
...               obstime="2010/01/01T00:00:45", frame="heliographic_carrington")
>>> sc
<SkyCoord (HeliographicCarrington: obstime=2010-01-01T00:00:45.000): (lon, lat, radius) in (deg, deg, km)
    [(1., 4., 5.), (2., 5., 6.), (3., 6., 7.)]>

Attributes Summary

default_differential

default_representation

frame_attributes

frame_specific_representation_info

name

obstime

Attributes Documentation

default_differential
default_representation
frame_attributes = {'obstime': <sunpy.coordinates.frameattributes.TimeFrameAttributeSunPy object>}
frame_specific_representation_info
name = 'heliographic_carrington'
obstime = None