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 ofpyfits
(use ofpyfits
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:
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.