Using Astropy

Note

Changes to this document must be approved by the System Architect (RFC-24). To request changes to these policies, please file an RFC.

Integration of Astropy core into the LSST software stack is an ongoing process that will evolve over time as we work on enhancing interoperability of the current codebase with Astropy. This document is not discussing Astropy affiliated packages, use of which must go through the standard RFC process. Not all Astropy core packages can be used by default.

The following packages should be used from Astropy in preference to other Python packages:

• astropy.io.fits instead of pyfits (use of pyfits is now deprecated).

The following packages can be used internally in packages if they do not leak into public APIs:

• astropy.coordinates
• astropy.time
• astropy.table
• astropy.units
• astropy.units.quantity
• astropy.constants
• astropy.cosmology
• astropy.visualization

The interaction of Astropy with LSST C++ classes providing related functionality should be carefully monitored. If the code is already using afw it is strongly preferred that afw equivalents be used until such time as specific afw interfaces are deprecated. astropy.table views into afw.table tables can be used if required.

Changing public APIs to use the above Astropy packages requires prior permission and possibly an RFC.

These items have functionality that is similar to that provided in LSST packages:

• astropy.modeling
• astropy.convolution
• astropy.wcs
• astropy.stats
• astropy.nddata

They are not allowed to be used in LSST code without special permission, such as submitting an RFC.

This advice will evolve as interoperability with Astropy develops.