SunPy instr

The instr submodule contains instrument specific routines, generally this submodule is focused on routines that process calibrated data.

sunpy.instr Package

sunpy.instr.fermi Module

This module provides processing routines for Fermi Gamma-ray Space Telescope (FGST), formerly called the Gamma-ray Large Area Space Telescope (GLAST).

Functions

download_weekly_pointing_file(date)

Downloads the FERMI/LAT weekly pointing file corresponding to the specified date.

get_detector_sun_angles_for_time(time, file)

Get the GBM detector angles vs the Sun for a single time.

get_detector_sun_angles_for_date(date, file)

Get the GBM detector angles vs the Sun as a function of time for a given date.

plot_detector_sun_angles(angles)

Plots the Fermi/GBM detector angles as a function of time.

met_to_utc(timeinsec)

Converts Fermi Mission Elapsed Time (MET) in seconds to a Time object.

sunpy.instr.goes Module

Contains functions useful for analysing GOES/XRS data.

Each of the Geostationary Operational Environmental Satellite (GOES) series since the mid-1970s has carried an X-Ray Sensor (XRS) which observes full-disk-integrated solar flux in two broadband channels: 1–8 angstrom (long); and 0.5–4 angstrom (short). For more information on the GOES/XRS instrument, see [Ref1]. GOES/XRS has become the “standard candle” for solar coronal observations due its longevity and consistency. The GOES event list, based on GOES/XRS observations, has become the standard solar flare catalogue. See https://www.ngdc.noaa.gov/stp/solar/solarflares.html for information on the GOES event list definitions and data.

The functions in this module provide useful software to analyse GOES/XRS observations. First they allow the GOES event list to be imported into a Python session (get_goes_event_list).

They also allow the thermodynamic properties of the emitting solar plasma to be determined. Temperature and emission measure are obtained using calculate_temperature_em, this function currently relies on lookup tables relating the GOES fluxes to the isothermal temperature and volume emission measure. These tables were calculated by functions in SolarSoftWare (SSW) using the CHIANTI atomic physics database ([Ref2]). For more detail, see the docstring of calculate_temperature_em` and references therein.

The radiative loss rate of the soft X-ray-emitting plasma across all wavelengths can be found with calculate_radiative_loss_rate, which makes use of a look up table calculated by functions in SSW using CHIANTI. This table relates the temperature and emission measure of the emitting solar plasma to the thermal energy radiated over all wavelengths. For more information on how this is done, see the docstring of _calc_rad_loss and reference therein.

Meanwhile, the X-ray luminosity in the two GOES passbands can be obtained by calculate_xray_luminosity. To do so, this function calls _goes_lx and calc_xraylum.

References

Ref1

Hanser, F.A., & Sellers, F.B. 1996, Proc. SPIE, 2812, 344

Ref2

Dere, K.P., et al. 2009 A&A, 498, 915 DOI: 10.1051/0004-6361/200911712

Functions

get_goes_event_list(timerange[, …])

Retrieve list of flares detected by GOES within a given time range.

calculate_temperature_em(goests[, …])

Calculates temperature and emission measure from a XRSTimeSeries.

calculate_radiative_loss_rate(goests[, …])

Calculates radiative loss rate from GOES observations.

calculate_xray_luminosity(goests)

Calculates GOES solar X-ray luminosity.

flux_to_flareclass(goesflux)

Converts X-ray flux into the corresponding GOES flare class.

flareclass_to_flux(flareclass)

Converts a GOES flare class into the corresponding X-ray flux.

sunpy.instr.iris Module

This package provides Interface Region Imaging Spectrometer (IRIS) instrument routines.

Note

More comprehensive IRIS tools are now being developed in the IRISPy affiliated package.

Functions

SJI_to_sequence(filename[, start, stop, hdu])

Read a SJI file and return a sunpy.map.MapSequence.

sunpy.instr.lyra Module

This module provides processing routines for data captured with the LYRA (Lyman Alpha Radiometer) instrument on Proba-2.

Functions

remove_lytaf_events_from_timeseries(ts[, …])

Removes periods of LYRA artifacts defined in LYTAF from a TimeSeries.

get_lytaf_events(start_time, end_time[, …])

Extracts combined lytaf file for given time range.

get_lytaf_event_types([print_event_types])

Prints the different event types in the each of the LYTAF databases.

split_series_using_lytaf(timearray, data, lytaf)

Splits LYRA timeseries around locations where “LARs” (and other data events) are observed.

sunpy.instr.rhessi Module

This module provides processing routines programs to process and analyze RHESSI data.

Functions

parse_observing_summary_hdulist(hdulist)

Parse a RHESSI observation summary file.

backprojection(calibrated_event_list[, …])

Given a stacked calibrated event list fits file create a back projection image.

parse_observing_summary_dbase_file(filename)

Parse the RHESSI observing summary database file.