Skip to main content
Ctrl+K
SunPy
  • About
    • Our Mission
    • SunPy Project
    • Presentations
    • Meetings
    • Code of Conduct
  • Documentation
    • sunpy
    • aiapy
    • dkist
    • drms
    • irispy
    • ndcube
    • roentgen
    • scope
    • solarmach
    • sunkit-image
    • sunkit-instruments
    • sunkit-magex
    • sunkit-pyvista
    • sunpy-soar
    • sunraster
    • xrtpy
      • pyflct
      • radiospectra
      • ablog
      • mpl-animators
      • streamtracer
  • Packages
  • Get Help
  • Contribute
  • Blog
  • Cite SunPy
  • About ▾
    • Our Mission
    • SunPy Project
    • Presentations
    • Meetings
    • Code of Conduct
  • Documentation ▾
    • sunpy
    • aiapy
    • dkist
    • drms
    • irispy
    • ndcube
    • roentgen
    • scope
    • solarmach
    • sunkit-image
    • sunkit-instruments
    • sunkit-magex
    • sunkit-pyvista
    • sunpy-soar
    • sunraster
    • xrtpy
      • pyflct
      • radiospectra
      • ablog
      • mpl-animators
      • streamtracer
  • Packages
  • Get Help
  • Contribute
  • Blog
  • Cite SunPy
Logo image

sunpy 8.1.dev108 documentation

  • The sunpy tutorial
    • Installation
    • Units
    • Times
    • Coordinates
    • Acquiring Data
      • Finding and Downloading Data from JSOC
      • Searching the Heliophysics Event Knowledgebase
    • Maps
    • Timeseries
  • Example Gallery
    • Acquiring Data
      • Available search attributes for the SOAR
      • Downloading EUI Data with VSO and SOAR
      • Getting data from CDAWeb
      • Querying Metadata clients
      • Querying and loading SHARP data
      • Querying the GOES flare event list
      • Quick overview of Searching the SOAR with Fido
      • Requesting cutouts of AIA images from the JSOC
      • Searching for EPD/EPT data with the a.soar.Sensor attribute
      • Searching for Solar Orbiter data using Solar Distance attribute
      • Searching for Solar Orbiter data using Wavelength and Detector attributes
    • Map
      • Comparing Map Rotation Functions
      • Creating a Composite map
      • Creating a mask for LASCO C2 data
      • Cropping a Map
      • Downloading and plotting Metis coronagraph data
      • Finding bright regions with ndimage
      • Finding contours of a map
      • Finding the brightest pixel
      • Generating a map from data array
      • Histograming map data
      • Interactively Selecting Coordinates on a Plot
      • Map metadata modification
      • Masking HMI based on the intensity of AIA
      • Overplotting HMI Contours on an AIA Image
      • Plotting a Map without any Axes
      • Plotting a difference image
      • Resampling Maps
      • Rotating a Map
      • Segmenting a Map based on transformation of coordinates
      • Tracking an Active Region Across the Solar Disk
    • Combining, Co-aligning, and Reprojecting Images
      • Aligning AIA and HMI Data with Reproject
      • Auto-Aligning AIA and HMI Data During Plotting
      • Creating Carrington Maps
      • Creating a Full Sun Map with AIA and EUVI
      • Downloading and Reprojecting a Solar Orbiter PHI/HRT Magnetogram
      • Reprojecting Images to Different Observers
      • Reprojecting Using a Spherical Screen
      • Reprojecting a Helioprojective Map to Helioprojective Radial
      • Reprojecting to a Map Projection with a Custom Origin
      • Reprojecting with Automatic Extent
      • Rotating HMI maps so they’re not ‘upside-down’
    • Time Series
      • Creating a TimeSeries from GOES-XRS near real time data with flare times
      • Find Peaks in sunpy TimeSeries
      • Flare times on a GOES XRS plot
      • Making a power spectrum from a TimeSeries
      • Retrieving and analyzing GOES X-Ray Sensor (XRS) data
      • Smoothing of timeSeries data using convolution filters
      • The TimeSeriesMetaData class
      • Using TimeSeries
    • Coordinates, times, and units
      • AIA to STEREO coordinate conversion
      • Converting between Helioprojective and AltAz Coordinate
      • Coordinates computations using SPICE kernels
      • Create a Helioprojective Map from observations in the RA-DEC coordinate system
      • Drawing the AIA limb on a STEREO EUVI image
      • Extracting intensity of a map along a line
      • Getting the location of the planets
      • Getting the observer location from a Map
      • Identifying stars in a STEREO/SECCHI COR2 coronagraph image
      • Obtaining a spacecraft trajectory from JPL Horizons
      • Offsetting the north pole of a coordinate frame
      • Overplotting the position of the Venus transit
      • Plotting Fields of View of Solar Orbiter and DKIST
      • Setting the correct position for SOHO in a LASCO C3 Map
    • Plotting
      • Adding an Earth scale image
      • Blending maps together
      • Combining off-limb and disk maps
      • Creating a Composite Plot with Three Maps
      • Drawing a latitude-longitude quadrangle
      • Drawing a rotated rectangle on a map
      • Drawing and using a Great Arc
      • Drawing heliographic longitude and latitude lines
      • Drawing the Extent of a WCS
      • Editing the colormap and normalization of a Map
      • Fading between two maps
      • Finding Local Peaks in Solar Data
      • Fine grained Plotting Features of Map
      • Imshow and maps coordinates
      • Loading an HMI synoptic map
      • Overlay an AIA image on a LASCO C2 coronagraph
      • Overlaying Two Maps
      • Overlaying off-disk contours using a screen
      • Overplotting HEK feature/event polygons on a map
      • Overplotting SRS active region locations on a magnetograms
      • Plot positions on a blank map
      • Plotting Solar Orbiter PHI Data
      • Plotting a coordinate grid
      • Plotting a map
      • Plotting a solar cycle index
      • Plotting points on a Map with WCSAxes
      • Plotting the solar equator and prime meridian
      • Plotting the solar limb
      • Set Axis Range When Plotting a Map
      • Simple Differential Rotation
      • Using the sunpy Colormaps with matplotlib
    • Differential Rotation of the Sun
      • Comparing differential-rotation models
      • Differentially rotating a coordinate
      • Differentially rotating a map
      • Overlaying differentially rotated gridlines
    • Saving and Loading Data
      • Reading ADAPT FITS Files
      • Saving and loading coordinates with asdf
      • Saving and loading sunpy Maps with ASDF
      • Saving and loading sunpy Maps with FITS
    • Computer Vision Techniques
      • Edge Enhancing Coronal Loops
      • Enhancing off-disk emission
      • Finding and masking bright pixels
      • Masking out the solar disk
    • Showcase
      • Artemis II Solar Eclipse
      • Artemis II trajectory
      • Creating a time-distance plot from a sequence of maps
      • HMI Showcase: Cutout
      • Obtaining solar-eclipse information
      • Parallel Spectral Fitting with Astropy Modeling
      • Reproducing the “Where is STEREO Today?” plot
      • Understanding Observer Orientation Relative to a Simulated Volume with astropy.coordinates
      • Visualizing 3D stereoscopic images
  • How-To Guides
    • Access coordinate components
    • Create a Map
    • Create coordinate objects
    • Create a custom Map
    • Create a custom TimeSeries
    • Draw a rectangle on a Map
    • Fix incorrect metadata
    • Manipulate grids lines when plotting a Map
    • Specify an observer by coordinate
    • Parse times with parse_time
    • Read an ASDF file into a Map
    • Use the remote data manager
    • Search for multiple wavelengths with Fido
    • Search the Virtual Solar Observatory (VSO)
    • Transform between coordinate frames
    • Query for Solar Orbiter data using the Wavelength attribute
  • Topic Guides
    • Coordinates
      • Calculating Carrington longitude
      • Differential rotation using coordinate frames
      • Coordinates with velocity information
      • Coordinates and WCS
      • The role of rsun in coordinate transformations
    • Data and Metadata
      • The role of “rsun” in sunpy
      • A Detailed Look at the TimeSeries Metadata
      • How “HISTORY” and “COMMENT” FITS Keys are Handled in sunpy
    • Configuration and Installation
      • Advanced Installation
      • Logging system
  • Reference
    • sunpy (sunpy)
      • self_test
      • system_info
      • print_config
    • Coordinates (sunpy.coordinates)
      • get_body_heliographic_stonyhurst
      • get_earth
      • get_horizons_coord
      • propagate_with_solar_surface
      • solar_frame_to_wcs_mapping
      • solar_wcs_frame_mapping
      • transform_with_sun_center
      • BaseHeliographic
      • BaseMagnetic
      • GeocentricEarthEquatorial
      • GeocentricSolarEcliptic
      • GeocentricSolarMagnetospheric
      • Geomagnetic
      • Heliocentric
      • HeliocentricEarthEcliptic
      • HeliocentricInertial
      • HeliographicCarrington
      • HeliographicStonyhurst
      • Helioprojective
      • HelioprojectiveRadial
      • NorthOffsetFrame
      • PlanarScreen
      • RotatedSunFrame
      • SolarMagnetic
      • SphericalScreen
      • SunPyBaseCoordinateFrame
      • get_body_heliographic_stonyhurst
      • get_earth
      • get_horizons_coord
      • get_body
      • get_fov
      • initialize
      • install_frame
      • get_rotation_matrix
      • SpiceBaseCoordinateFrame
      • angular_radius
      • sky_position
      • carrington_rotation_number
      • carrington_rotation_time
      • true_longitude
      • apparent_longitude
      • true_latitude
      • apparent_latitude
      • mean_obliquity_of_ecliptic
      • true_rightascension
      • true_declination
      • true_obliquity_of_ecliptic
      • apparent_rightascension
      • apparent_declination
      • print_params
      • B0
      • L0
      • P
      • earth_distance
      • orientation
      • eclipse_amount
      • get_rectangle_coordinates
      • solar_angle_equivalency
      • get_limb_coordinates
      • get_heliocentric_angle
      • GreatArc
      • SunPyBaseCoordinateFrame
      • BaseHeliographic
      • BaseMagnetic
      • HeliographicStonyhurst
      • HeliographicCarrington
      • Heliocentric
      • Helioprojective
      • HelioprojectiveRadial
      • HeliocentricEarthEcliptic
      • GeocentricSolarEcliptic
      • HeliocentricInertial
      • GeocentricEarthEquatorial
      • Geomagnetic
      • SolarMagnetic
      • GeocentricSolarMagnetospheric
      • BaseScreen
      • SphericalScreen
      • PlanarScreen
      • NorthOffsetFrame
      • RotatedSunFrame
      • solar_wcs_frame_mapping
      • solar_frame_to_wcs_mapping
    • Data (sunpy.data)
      • EARTH_IMAGE
      • manager
      • cache
      • download_all
      • get_test_filepath
      • get_test_data_filenames
      • get_dummy_map_from_header
      • write_header_file_from_image_file
      • Cache
      • DataManager
      • ParfiveDownloader
      • SqliteStorage
      • DownloaderBase
      • DownloaderError
      • ParfiveDownloader
      • StorageProviderBase
      • SqliteStorage
      • InMemStorage
    • Image processing (sunpy.image)
      • resample
      • reshape_image_to_4d_superpixel
      • add_rotation_function
      • affine_transform
    • Input/output (sunpy.io)
      • read_genx
      • read
      • get_header
      • write
      • read_srs
    • Maps (sunpy.map)
      • all_coordinates_from_map
      • all_corner_coords_from_map
      • all_pixel_indices_from_map
      • contains_coordinate
      • contains_full_disk
      • contains_limb
      • contains_solar_center
      • coordinate_is_on_solar_disk
      • is_all_off_disk
      • is_all_on_disk
      • make_hpr_header
      • map_edges
      • on_disk_bounding_coordinates
      • pixelate_coord_path
      • sample_at_coords
      • solar_angular_radius
      • CompositeMap
      • GenericMap
      • MapMetaValidationError
      • MapSequence
      • PixelPair
      • Map
      • make_fitswcs_header
      • get_observer_meta
      • make_heliographic_header
      • make_hpr_header
      • from_helioviewer_project
      • source_stretch
      • ADAPTMap
      • AIAMap
      • CORMap
      • EITL1Map
      • EITMap
      • EUIMap
      • EUVIMap
      • GONGHalphaMap
      • GONGMagnetogramMap
      • GONGSynopticMap
      • HIMap
      • HMIMap
      • HMISynopticMap
      • HXIMap
      • KCorMap
      • LASCOMap
      • MDIMap
      • MDISynopticMap
      • METISMap
      • PHIMap
      • PUNCHMap
      • RHESSIMap
      • SJIMap
      • SOTMap
      • SUITMap
      • SUVIMap
      • SWAPMap
      • SXTMap
      • TRACEMap
      • WISPRMap
      • XRTMap
    • Remote data (sunpy.net)
      • Scraper
      • Fido
      • Time
      • Instrument
      • Wavelength
      • Level
      • ExtentType
      • Sample
      • Detector
      • Resolution
      • Physobs
      • Source
      • Provider
      • AttrAnd
      • AttrOr
      • UnifiedResponse
      • UnifiedDownloaderFactory
      • VSOClient
      • VSOQueryResponseTable
      • Extent
      • Field
      • Pixels
      • Filter
      • Quicklook
      • PScale
      • ADAPTClient
      • AIASynopsisClient
      • EVEClient
      • GBMClient
      • GONGClient
      • GenericClient
      • LYRAClient
      • NOAAIndicesClient
      • NOAAPredictClient
      • NoRHClient
      • QueryResponse
      • RHESSIClient
      • SRSClient
      • SUVIClient
      • XRSClient
      • SatelliteNumber
      • ADAPTFileType
      • ADAPTLonType
      • ADAPTInputSource
      • ADAPTDataAssimilation
      • ADAPTResolution
      • ADAPTVersionYear
      • ADAPTVersionMonth
      • ADAPTEvolutionMode
      • ADAPTHelioData
      • ADAPTRealizations
      • ADAPTMagData
      • Cutout
      • JSOCClient
      • JSOCResponse
      • Keyword
      • Notify
      • PrimeKey
      • Protocol
      • Segment
      • Series
      • Series
      • Protocol
      • Notify
      • Segment
      • PrimeKey
      • Cutout
      • Keyword
      • HEKClient
      • HEKRow
      • HEKTable
      • Contains
      • EventType
      • HEKAttr
      • HEKComparisonParamAttrWrapper
      • SpatialRegion
      • translate_results_to_query
      • vso_attribute_parse
      • H2VClient
      • get_datasets
      • get_observatory_groups
      • CDAWEBClient
      • Dataset
      • HECClient
      • HECResponse
      • Chaincode
      • MaxRecords
      • TableName
      • Dataset
      • Limit
      • SOLARNETClient
      • Tags
      • Target
      • Dataset
      • Limit
      • Target
      • Tags
      • SOARClient
      • SOOP
      • Distance
      • Product
      • Sensor
      • convert_row_to_table
      • QueryResponseColumn
      • BaseQueryResponse
      • QueryResponseRow
      • QueryResponseTable
      • BaseClient
      • QueryResponse
      • GenericClient
      • and
      • or
      • AttrMeta
      • Attr
      • DataAttr
      • DummyAttr
      • SimpleAttr
      • Range
      • AttrAnd
      • AttrOr
      • ValueAttr
      • AttrWalker
      • AttrComparison
      • ComparisonParamAttrWrapper
      • Scraper
      • extract_timestep
      • date_floor
      • get_timerange_from_exdict
    • Physics (sunpy.physics)
      • solar_rotate_coordinate
      • differential_rotate
    • Solar properties (sunpy.sun)
      • get
      • find
      • print_all
      • spectral_classification
      • au
      • mass
      • equatorial_radius
      • volume
      • surface_area
      • average_density
      • equatorial_surface_gravity
      • effective_temperature
      • luminosity
      • mass_conversion_rate
      • escape_velocity
      • sfu
      • average_angular_size
      • sidereal_rotation_rate
      • first_carrington_rotation
      • mean_synodic_period
      • differential_rotation
      • interior
      • evolution
    • Time (sunpy.time)
      • find_time
      • is_time
      • is_time_equal
      • is_time_in_given_format
      • julian_centuries
      • parse_time
      • TimeRange
      • TimeTaiSeconds
      • TimeUTime
    • Timeseries (sunpy.timeseries)
      • TimeSeriesMetaData
      • GenericTimeSeries
      • TimeSeries
      • ESPTimeSeries
      • EVESpWxTimeSeries
      • GBMSummaryTimeSeries
      • XRSTimeSeries
      • LYRATimeSeries
      • NOAAIndicesTimeSeries
      • NOAAPredictIndicesTimeSeries
      • NoRHTimeSeries
      • RHESSISummaryTimeSeries
    • Utilities (sunpy.util)
      • cached_property_based_on
      • check_arithmetic_compatibility
      • deprecated
      • deprecated_renamed_argument
      • dict_keys_same
      • expand_list
      • expand_list_generator
      • extent_in_other_wcs
      • find_dependencies
      • fix_duplicate_notes
      • get_keywords
      • get_set_methods
      • get_width
      • grid_perimeter
      • hash_file
      • missing_dependencies_by_extra
      • replacement_filename
      • sunpycontextmanager
      • system_info
      • unique
      • warn_connection
      • warn_deprecated
      • warn_metadata
      • warn_user
      • MetaDict
      • NoMapsInFileError
      • SunpyConnectionWarning
      • SunpyDeprecationWarning
      • SunpyMetadataWarning
      • SunpyPendingDeprecationWarning
      • SunpyUserWarning
      • SunpyWarning
      • add_common_docstring
      • load_config
      • copy_default_config
      • print_config
      • BasicRegistrationFactory
      • NoMatchError
      • MultipleMatchError
      • ValidationFunctionError
      • parse_header
      • slugify
      • get_content_disposition
      • get_filename
      • get_system_filename
      • download_file
      • download_fileobj
      • xml_to_dict
      • node_to_dict
      • get_node_text
      • NotTextNodeError
      • Generate
      • seconddispatch
    • Visualization (sunpy.visualization)
      • axis_labels_from_ctype
      • peek_show
      • show_hpr_impact_angle
      • show_colormaps
      • aia_color_table
      • sswidl_lasco_color_table
      • eit_color_table
      • sxt_color_table
      • xrt_color_table
      • trace_color_table
      • sot_color_table
      • hmi_mag_color_table
      • suvi_color_table
      • rhessi_color_table
      • std_gamma_2
      • euvi_color_table
      • solohri_lya1216_color_table
      • suit_color_table
      • punch_color_table
      • metis_color_table
      • MapSequenceAnimator
      • is_wcsaxes
      • gca_wcs
      • get_world_transform
      • default_wcs_grid
      • wcsaxes_heliographic_overlay
      • limb
      • equator
      • prime_meridian
      • extent
    • Customizing sunpy
    • Troubleshooting and Bugs
    • SSWIDL/sunpy Cheat Sheet
    • Internal API Documentation
      • read_file
      • read_file_header
      • write_file
      • detect_filetype
      • FileHeader
      • header_to_fits
      • read
      • get_header
      • write
      • extract_waveunit
      • format_comments_and_history
      • read
      • get_header
      • write
  • Release History
    • Full Changelog
    • What’s New in sunpy 8.1?
    • What’s New in sunpy 8.0?
    • What’s New in sunpy 7.1?
    • What’s New in sunpy 7.0?
    • What’s New in sunpy 6.1?
    • What’s New in sunpy 6.0?
    • What’s New in sunpy 5.1?
    • What’s New in sunpy 5.0?
    • What’s New in sunpy 4.1?
    • What’s New in SunPy 4.0?
    • What’s New in SunPy 3.1?
    • What’s New in SunPy 3.0?
    • What’s New in SunPy 2.1?
    • What’s New in SunPy 2.0?
    • What’s New in SunPy 1.1?
    • What’s New in SunPy 1.0?
    • What’s New in SunPy 0.9?
    • What’s New in SunPy 0.8?
  • Acknowledging or Citing SunPy
  • Known Issues
  • Bibliography
  • Current status of sub-packages
  • Developer’s Guide
    • Getting started
      • Newcomers’ Guide
      • Pull Request Check List
      • Using conda for Development Dependencies
    • Conventions
      • AI Usage
      • Coding Standards
      • Testing Guidelines
      • Documentation
      • Example Gallery
      • Pull Requests and GitHub Teams
      • Use of quantities and units
    • Repo management
      • Workflow for Maintainers
      • Extra Packages and Groups
      • What runs on our Continuous Integration
      • Making Changes to Released Versions
      • Deprecation, Versioning and Release Practices
      • Submodule and funding
    • Extending sunpy
      • sunpy’s Public API
      • Logging, Warnings, and Exceptions
      • Tests using the Remote Data Manager
      • Adding new data sources to Fido
      • Writing a new instrument Map class
      • Add a new rotation method to Map
      • Migrating to the new Scraper pattern system in sunpy 6.1
      • SOAR Client Developer Guide
        • How data is retrieved from the SOAR
        • Tables supported in SOARClient
        • Request methods SOARClient supports
  • Topic Guides
  • Data and Metadata

Data and Metadata#

These guides explain how SunPy represents observational data and the metadata associated with it.

  • The role of “rsun” in sunpy
  • A Detailed Look at the TimeSeries Metadata
  • How “HISTORY” and “COMMENT” FITS Keys are Handled in sunpy

previous

The role of rsun in coordinate transformations

next

The role of “rsun” in sunpy

© Copyright 2026, The SunPy Community.

Code • Forum • Chat

Built with Sphinx 9.1.0.