astro py:docs

- Index
- Modules

### Navigation

- next »
- Astropy v1.1.1 »

# 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.

## User Documentation

### What’s New in Astropy 1.1?

Astropy at a glance

- Overview
- Installation
- Getting Started with Astropy

Core data structures and transformations

- Constants (`astropy.constants`)
- Units and Quantities (`astropy.units`)
- N-dimensional datasets (`astropy.nddata`)
- Data Tables (`astropy.table`)
- Time and Dates (`astropy.time`)
- Astronomical Coordinate Systems (`astropy.coordinates`)
- World Coordinate System (`astropy.wcs`)
- Models and Fitting (`astropy.modeling`)
- Analytic Functions (`astropy.analytic_functions`)

Connecting up: Files and I/O

- Unified file read/write interface
- FITS File handling (`astropy.io.fits`)
- ASCII Tables (`astropy.io.ascii`)
- VOTable XML handling (`astropy.io.votable`)
- Miscellaneous Input/Output (`astropy.io.misc`)

Astronomy computations and utilities

- Convolution and filtering (`astropy.convolution`)
- Data Visualization (`astropy.visualization`)
- Cosmological Calculations (`astropy.cosmology`)
- Astrostatistics Tools (`astropy.stats`)
- Virtual Observatory Access (`astropy.vo`)

Nuts and bolts of Astropy

- Configuration system (`astropy.config`)
- I/O Registry (`astropy.io.registry`)
- Logging system
- Python warnings system
- Astropy Core Package Utilities (`astropy.utils`)
- Astropy Testing helpers (`astropy.tests.helper`)

Astropy project details

- Current status of sub-packages
- Major Release History
- Known Issues
- Authors and Credits
- Licenses

## Getting help

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 astropy-feedback@googlegroups.com...but remember that questions you ask publicly serve as resources for other users!

## Reporting Issues

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 astropy-feedback@googlegroups.com.

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.

### For astropy-helpers

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 mentioning the `astropy_helpers` or `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.

## Contributing

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):

- Try the development version
- How to make a code contribution

## Developer Documentation

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.

- How to make a code contribution
- Coding Guidelines
- Writing Documentation
- Testing Guidelines
- Writing Command-Line Scripts
- Building Astropy and its Subpackages
- C or Cython Extensions
- Release Procedures
- Workflow for Maintainers
- How to create and maintain an Astropy affiliated package
- Full Changelog

## Indices and Tables

- Index
- Module Index
- Search Page