Example Gallery

The gallery contains examples of how to use sunpy. Each example is a short and self contained how-to guide for performing a specific task.

Sample data

Some of these examples require the SunPy sample data, which are downloaded as needed via the module sunpy.data.sample. If you want to download all of the sample data files in advance, call sunpy.data.sample.download_all().

Acquiring Data

Examples of downloading solar data located on remote servers

Available search attributes

Available search attributes

Getting data from CDAWeb

Getting data from CDAWeb

Querying Metadata clients

Querying Metadata clients

Querying and loading SHARP data

Querying and loading SHARP data

Querying the GOES flare event list

Querying the GOES flare event list

Quick overview of Searching the SOAR with Fido

Quick overview of Searching the SOAR with Fido

Requesting cutouts of AIA images from the JSOC

Requesting cutouts of AIA images from the JSOC

Searching for EPD/EPT data with the a.soar.Sensor attribute

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 Solar Distance attribute

Searching for Solar Orbiter data using Wavelength and Detector attributes

Searching for Solar Orbiter data using Wavelength and Detector attributes

Map

Examples using Map with solar data

Comparing Map Rotation Functions

Comparing Map Rotation Functions

Creating a Composite map

Creating a Composite map

Creating a mask for LASCO C2 data

Creating a mask for LASCO C2 data

Cropping a Map

Cropping a Map

Finding bright regions with ndimage

Finding bright regions with ndimage

Finding contours of a map

Finding contours of a map

Finding the brightest pixel

Finding the brightest pixel

Generating a map from data array

Generating a map from data array

Histograming map data

Histograming map data

Interactively Selecting Coordinates on a Plot

Interactively Selecting Coordinates on a Plot

Map metadata modification

Map metadata modification

Masking HMI based on the intensity of AIA

Masking HMI based on the intensity of AIA

Overplotting HMI Contours on an AIA Image

Overplotting HMI Contours on an AIA Image

Plotting a Map without any Axes

Plotting a Map without any Axes

Plotting a difference image

Plotting a difference image

Resampling Maps

Resampling Maps

Rotating a Map

Rotating a Map

Segmenting a Map based on transformation of coordinates

Segmenting a Map based on transformation of coordinates

Tracking an Active Region Across the Solar Disk

Tracking an Active Region Across the Solar Disk

Combining, Co-aligning, and Reprojecting Images

Examples of combining, aligning, and reprojecting sunpy maps

Aligning AIA and HMI Data with Reproject

Aligning AIA and HMI Data with Reproject

Auto-Aligning AIA and HMI Data During Plotting

Auto-Aligning AIA and HMI Data During Plotting

Creating Carrington Maps

Creating Carrington Maps

Creating a Full Sun Map with AIA and EUVI

Creating a Full Sun Map with AIA and EUVI

Reprojecting Images to Different Observers

Reprojecting Images to Different Observers

Reprojecting Using a Spherical Screen

Reprojecting Using a Spherical Screen

Reprojecting a Helioprojective Map to Helioprojective Radial

Reprojecting a Helioprojective Map to Helioprojective Radial

Reprojecting to a Map Projection with a Custom Origin

Reprojecting to a Map Projection with a Custom Origin

Reprojecting with Automatic Extent

Reprojecting with Automatic Extent

Rotating HMI maps so they’re not ‘upside-down’

Rotating HMI maps so they're not 'upside-down'

Time Series

Examples using TimeSeries

Creating a TimeSeries from GOES-XRS near real time data with flare times

Creating a TimeSeries from GOES-XRS near real time data with flare times

Find Peaks in sunpy TimeSeries

Find Peaks in sunpy TimeSeries

Flare times on a GOES XRS plot

Flare times on a GOES XRS plot

Making a power spectrum from a TimeSeries

Making a power spectrum from a TimeSeries

Retrieving and analyzing GOES X-Ray Sensor (XRS) data

Retrieving and analyzing GOES X-Ray Sensor (XRS) data

Smoothing of timeSeries data using convolution filters

Smoothing of timeSeries data using convolution filters

The TimeSeriesMetaData class

The TimeSeriesMetaData class

Using TimeSeries

Using TimeSeries

Coordinates, times, and units

Examples of working with coordinate information, times, and scientific units

AIA to STEREO coordinate conversion

AIA to STEREO coordinate conversion

Converting between Helioprojective and AltAz Coordinate

Converting between Helioprojective and AltAz Coordinate

Coordinates computations using SPICE kernels

Coordinates computations using SPICE kernels

Create a Helioprojective Map from observations in the RA-DEC coordinate system

Create a Helioprojective Map from observations in the RA-DEC coordinate system

Drawing the AIA limb on a STEREO EUVI image

Drawing the AIA limb on a STEREO EUVI image

Extracting intensity of a map along a line

Extracting intensity of a map along a line

Getting the location of the planets

Getting the location of the planets

Getting the observer location from a Map

Getting the observer location from a Map

Identifying stars in a STEREO/SECCHI COR2 coronagraph image

Identifying stars in a STEREO/SECCHI COR2 coronagraph image

Obtaining a spacecraft trajectory from JPL Horizons

Obtaining a spacecraft trajectory from JPL Horizons

Offsetting the north pole of a coordinate frame

Offsetting the north pole of a coordinate frame

Overplotting the position of the Venus transit

Overplotting the position of the Venus transit

Setting the correct position for SOHO in a LASCO C3 Map

Setting the correct position for SOHO in a LASCO C3 Map

Plotting

Examples of visualizing supported data types

Adding an Earth scale image

Adding an Earth scale image

Blending maps together

Blending maps together

Combining off-limb and disk maps

Combining off-limb and disk maps

Creating a Composite Plot with Three Maps

Creating a Composite Plot with Three Maps

Drawing a latitude-longitude quadrangle

Drawing a latitude-longitude quadrangle

Drawing a rotated rectangle on a map

Drawing a rotated rectangle on a map

Drawing and using a Great Arc

Drawing and using a Great Arc

Drawing heliographic longitude and latitude lines

Drawing heliographic longitude and latitude lines

Drawing the Extent of a WCS

Drawing the Extent of a WCS

Editing the colormap and normalization of a Map

Editing the colormap and normalization of a Map

Fading between two maps

Fading between two maps

Finding Local Peaks in Solar Data

Finding Local Peaks in Solar Data

Fine grained Plotting Features of Map

Fine grained Plotting Features of Map

Imshow and maps coordinates

Imshow and maps coordinates

Loading an HMI synoptic map

Loading an HMI synoptic map

Overlay an AIA image on a LASCO C2 coronagraph

Overlay an AIA image on a LASCO C2 coronagraph

Overlaying Two Maps

Overlaying Two Maps

Overlaying off-disk contours using a screen

Overlaying off-disk contours using a screen

Overplotting HEK feature/event polygons on a map

Overplotting HEK feature/event polygons on a map

Overplotting SRS active region locations on a magnetograms

Overplotting SRS active region locations on a magnetograms

Plot positions on a blank map

Plot positions on a blank map

Plotting Solar Orbiter PHI Data

Plotting Solar Orbiter PHI Data

Plotting a coordinate grid

Plotting a coordinate grid

Plotting a map

Plotting a map

Plotting a solar cycle index

Plotting a solar cycle index

Plotting points on a Map with WCSAxes

Plotting points on a Map with WCSAxes

Plotting the solar equator and prime meridian

Plotting the solar equator and prime meridian

Plotting the solar limb

Plotting the solar limb

Set Axis Range When Plotting a Map

Set Axis Range When Plotting a Map

Simple Differential Rotation

Simple Differential Rotation

Using the sunpy Colormaps with matplotlib

Using the sunpy Colormaps with matplotlib

Differential Rotation of the Sun

Examples of accounting for differential rotation (i.e., the latitude-dependent rotation rate of the Sun) in the coordinates framework

Comparing differential-rotation models

Comparing differential-rotation models

Differentially rotating a coordinate

Differentially rotating a coordinate

Differentially rotating a map

Differentially rotating a map

Overlaying differentially rotated gridlines

Overlaying differentially rotated gridlines

Saving and Loading Data

Examples of saving and loading data

Reading ADAPT FITS Files

Reading ADAPT FITS Files

Saving and loading coordinates with asdf

Saving and loading coordinates with asdf

Saving and loading sunpy Maps with ASDF

Saving and loading sunpy Maps with ASDF

Saving and loading sunpy Maps with FITS

Saving and loading sunpy Maps with FITS

Computer Vision Techniques

Examples of using computer vision techniques to analyze solar data

Edge Enhancing Coronal Loops

Edge Enhancing Coronal Loops

Enhancing off-disk emission

Enhancing off-disk emission

Finding and masking bright pixels

Finding and masking bright pixels

Masking out the solar disk

Masking out the solar disk

Showcase

Examples that use an advanced combination of capabilities in sunpy

Artemis II Solar Eclipse

Artemis II Solar Eclipse

Artemis II trajectory

Artemis II trajectory

Creating a time-distance plot from a sequence of maps

Creating a time-distance plot from a sequence of maps

HMI Showcase: Cutout

HMI Showcase: Cutout

Obtaining solar-eclipse information

Obtaining solar-eclipse information

Reproducing the “Where is STEREO Today?” plot

Reproducing the "Where is STEREO Today?" plot

Understanding Observer Orientation Relative to a Simulated Volume with astropy.coordinates

Understanding Observer Orientation Relative to a Simulated Volume with astropy.coordinates

Visualizing 3D stereoscopic images

Visualizing 3D stereoscopic images