Astropy Core Package Documentation¶
Welcome to the Astropy documentation! Astropy is a community-driven package intended to contain much of the core functionality and some common tools needed for performing astronomy and astrophysics with Python.
Astropy at a glance
Core data structures and transformations
- Constants (
- Units and Quantities (
- N-dimensional datasets (
- Data Tables (
- Time and Dates (
- Astronomical Coordinate Systems (
- World Coordinate System (
- Models and Fitting (
- Analytic Functions (
Connecting up: Files and I/O
Astronomy computations and utilities
Nuts and bolts of Astropy
Astropy project details
If you want to get help or discuss issues with other Astropy users, you can sign up for the astropy mailing list. Alternatively, the astropy-dev mailing list is where you should go to discuss more technical aspects of Astropy with the developers. You can also email the astropy developers privately at email@example.com...but remember that questions you ask publicly serve as resources for other users!
If you have found a bug in Astropy please report it. The preferred way is to create a new issue on the Astropy GitHub issue page; that requires creating a free account on GitHub if you do not have one.
If you prefer not to create a GitHub account, please report the issue to either the astropy mailing list, the astropy-dev mailing list or sending a private email to the astropy core developers at firstname.lastname@example.org.
Please include an example that demonstrates the issue that will allow the developers to reproduce and fix the problem. You may be asked to also provide information about your operating system and a full Python stack trace; the Astropy developers will walk you through obtaining a stack trace if it is necessary.
As of Astropy v0.4, Astropy and many affiliated packages use a package of
utilities called astropy-helpers during building and installation. If you have
any build/installation issue–particularly if you’re getting a traceback
ah_bootstrap modules–please send a
report to the astropy-helpers issue tracker. If you’re not sure,
however, it’s fine to report via the main Astropy issue tracker or one of the
other avenues described above.
The Astropy project is made both by and for its users, so we highly encourage contributions at all levels. This spans the gamut from sending an email mentioning a typo in the documentation or requesting a new feature all the way to developing a major new package.
The full range of ways to be part of the Astropy project are described at Contribute to Astropy. To get started contributing code or documentation (no git or GitHub experience necessary):
The developer documentation contains instructions for how to contribute to Astropy or affiliated packages, as well as coding, documentation, and testing guidelines. For the guiding vision of this process and the project as a whole, see Vision for a Common Astronomy Python Package.
There are additional tools of use for developers in the astropy/astropy-tools repository.