Changelog#

0.7.1.dev20+gcd8ad5908 (2026-07-10)#

Breaking Changes#

Simplified irispy.utils.red_blue.calculate_red_blue_asymmetry by removing low-level tuning arguments that are now handled internally. The function now always centers profiles on the line peak, uses uncertainty from the input cube when available, and derives its interpolation window from velocity_range. The function now takes degree instead of interpolation_kind, and removes mask_negative (now always applied), uncertainty, center_on_peak, velocity_window, and fit_window. The output now contains only the red-blue asymmetry map, quality map, optional uncertainty map, and optional profile cubes. (#144)

New Features#

Add spectral_dispersion and solid_angle properties to SpectrogramCube. (#141)
Exposed much more FITS metadata to the user via the meta. (#142)

Documentation#

Revamped both cosmic ray removal examples to split focus between SG and SJI data. (#139)
Correct and expand the SJI and spectrograph slit-coordinate comparison to show NUV and FUV detector offsets. (#156)

0.7.0 (2026-05-07)#

New Features#

Added irispy.utils.dust.remove_dust and irispy.sji.SJICube.remove_dust to repair dust-darkened pixels in IRIS slit-jaw images. (#111)
Added remove_cosmic_rays methods both for SJI and raster cubes, with two possible backends: rsliding and astroscrappy. (#113)
Added a way to calculate the moments for a SpectrumCube with an example: Calculate Spectral Line Moments. (#124)
Added utilities and examples to calculate moments and red-blue asymmetry maps for SpectrogramCube. (#125)
Added utilities to compute IRIS density diagnostics from line ratios, including density_diagnostic and map_ratio_to_quantity. (#126)

Bug Fixes#

Fixed a few places with incorrect timestamp handling for the gWCS. (#105)
Fixed irispy.sji.SJICube slicing so basic_wcs is preserved for common slicing operations, allowing sliced cubes to continue working with irispy.sji.SJICube.to_maps and other WCS-based workflows. (#111, #112)
Fixed irispy.utils.spectrograph.radiometric_calibration so sliced raster irispy.spectrograph.SpectrogramCube objects continue to calibrate correctly when slicing changes the WCS wrapper or reduces the data to two dimensions. (#114)
Removed preserve_units=True WCS construction paths due to an upstream bug in Astropy. (#117)
Fixed raster file-list reading so plain spectrograph FITS lists load the full observation sequence. (#117)
Fixed several edge cases in SJI and spectrograph coordinate preservation, bad-pixel masking, density diagnostics, spectral moments, dust masking, and red-blue asymmetry memory usage. (#129)

Documentation#

Added a tutorial mirroring how ITN26 is written. (#106)
Added an example of using astroscrappy to remove cosmic rays from IRIS data: Remove Cosmic Rays from IRIS SG data. (#106)
Added a how-to example showing how to remove dust from IRIS slit-jaw images with irispy.sji.SJICube.remove_dust: Remove Dust from IRIS Slit-Jaw Imager. (#111)
Added a double Gaussian Mg II k spectral fitting example: Fit Spectral Models to Spectra - Double Gaussian Fitting. (#130)

0.6.0 (2026-01-26)#

Breaking Changes#

Moved internal code to move to use “DATE_OBS” instead of “STARTDATE”. (#96)
Removed support for Python 3.11. (#97)
Made the standard WCS lazy created on access now to speed up loading (#103)

Documentation#

Added an example to demonstrate co-alignment of IRIS SJI and SDO/AIA images using sunkit-image’s match_template method. (#65)
Added an offset example, attempting to track down a WCS offset between the IRIS SJI and IRIS SG WCS. (#96)

0.5.0 (2025-10-06)#

Breaking Changes#

irispy.utils.spectrograph.radiometric_calibration function was added, replacing convert_between_dn_and_photons. (#77)
fitsinfo now renamed to irispy.io.fits_info. The output has been updated to be nicer. (#78)
Renamed “wobble_movie” to “generate_wobble_movie”. (#88)

Bug Fixes#

Improved radiometric calibration calculations and fixed unit conversion errors. It still does not match the IDL code, it can over estimate the radiance by a small margin. (#77)

Internal Changes#

Retemplated package using the sunpy template. (#88)

0.4.0 (2025-08-28)#

Breaking Changes#

Renamed “get_iris_response” to irispy.utils.response.get_latest_response. (#74)
Removed versions from the response, it now only supports the latest version which is currently at V9. (#74)
Renamed Collection to RasterCollection. Moved metadata into a separate file. Removed convert_to method. (#81)
Increased minimum version of Python to 3.11, sunpy to 7.0.0 and dkist to 1.15.0 (#81)
All references to irispy-lmsal have been removed and now the package is simply referred to as irispy. The package name on PyPI and conda-forge is still the same due to conflicts with existing packages. (#85)

Internal Changes#

Added more test data. (#86)

0.3.1 (2025-07-30)#

New Features#

Added fits_header property to the .meta. (#69)
Added observer location to the Spectrograph cubes. This now matches the SJI cubes. (#70)

Bug Fixes#

Fixed handling of raster tarfiles to not just use the first file. (#69)
Improved how OBSID v34 is checked by using STEPS_AV in the FITS header. (#69)
Improved how read_files handles tarfiles and mixed files. (#69)

0.3.0 (2025-06-16)#

Breaking Changes#

Now read_files will return a NDCollection which you can access individual cubes based on keys like a dictionary. If one item was passed into read_files, that return type has been unchanged. (#63)
Increased minimum version of dkist to 1.11.0. (#63)
Increased minimum version of sunraster to 0.6.0. (#65)

New Features#

Added explicit support for the IRIS aligned AIA cubes provided by LMSAL for each IRIS observation. (#63)
Added to_maps to SJICubes to allow a user to output a sunpy Map or MapSequence based on how many slices they need. (#64)

0.2.5 (2025-06-02)#

Documentation#

Added raster v34 example

Internal Changes#

Updated slider names on plots

0.2.4 (2025-05-08)#

Documentation#

Simplified the spectral fitting example by making it single threaded.

0.2.3 (2025-05-07)#

Internal Changes#

Reduced sunpy minimum version to 6.0 from 6.1

0.2.2 (2025-05-07)#

Documentation#

Rewrote existing examples to be more consistent.
Added an example for single Gaussian fitting using new functionality from astropy 7.0

Internal Changes#

Rewrite of unit tests.
Fixed warning from DKIST modelling.

0.2.1 (2024-06-09)#

Internal Changes#

Add COC, add more links to docs and IO section

0.2.0 (2023-12-25)#

Features#

Add support for V34 files.

Breaking Changes#

SJI data is now stored using a gWCS.
All keywords have to passed by name into to all functions now.
Dropped Python 3.8 support.

Internal Changes#

Templated to remove setup.py and setup.cfg
Tweaks to documentation.

0.1.5 (2022-10-12)#

Bug Fixes#

Fixed Windows path issue for wobble movie

0.1.4 (2022-09-26)#

Features#

Added a timestamp to each frame of the wobble movie. You will need to set the timestamp keyword to be True.
Added a wobble_cadence keyword to override the default wobble cadence of 180 seconds.

0.1.3 (2022-05-22)#

Features#

Added V5 and V6 support for get_iris_response. It also does not download the files anymore.

Breaking Changes#

API of get_iris_response has changed: pre_launch has gone, use response_version=2 instead. response_file keyword has been removed, it will use files provided by the package instead. force_download was removed as the function now does not download any files.

0.1.2 (2022-05-02)#

Features#

Tweaked irispy.utils.wobble_movie to remove limits on the metadata.
Pin sunraster version due to Python version incompatibilities.

0.1.1 (2022-02-17)#

Features#

Added a irispy.utils.wobble_movie to create a wobble movie. It does need FFMPEG to be installed.

0.1.0 (2022-01-14)#

First formal release of irispy.

Please note there are parts of this library that are still under going development and will be updated as time goes on. There is also a lot of work to be done on the documentation and some of the functions in the utils module do not function.