The aim of the AstroPhotography python package is to provides python classes and command line applications for amateur astronomy, specifically:
- quick inspection and conversion of RAW digital camera format to common graphical image formats (e.g. PNG) and astronomical FITS format.
- reduction and combination of multiple FITS images, including calibration, artifact removal, star detection, and astrometry.
FITS images can then be viewed with the powerful features SAO ds9
provides, and/or within python using astropy.
Current status: This is still very much a work in progress. RAW to image/FITS conversion is partially implemented, but development stalled when I became dissatified with the clunky nature of the unit tests. I've been putting more effort into the FITS data reduction side of the project, but still have a long way to go.
See RELEASE_NOTES.md for a summary of what has changed recently.
The command line python program dksraw will provide a simple method of
quickly converting RAW files into useful images or FITS files without
the user having to mess around with dcraw, gimp, photoshop or
the equivalent.
A series of python scripts, all beginning with the prefix ap_, will
perform separate stages of traditional astronomical image data reduction
given FITS files generated either by dksraw or obtained directly
from some other sources (e.g. iTelescope, an archive, etc).
Note Some are partially implemented at this stage.
The command line dksraw application will provide the following subcommands:
- grey: Convert a RAW file into a single channel (greyscale) 16-bit PNG/JPG/TIFF or FITS file. Working implementation with limited number of options.
- rgb: Convert a RAW file into an RGB PNG/JPG/TIFF image or FITS file. Working implementation with limited number of options.
- split: Splits the input RAW file into separate 16-bit PNG/JPG/TIFF/FITS files for each of the R, G, B and G channel in the Bayer mask. Implemented.
- whitebalance: Perform whitebalance calculations on the input RAW file in one
of several ways. Partially implemented as part of
grey. - info: Print metadata about the input RAW file to stdout. Not yet implemented.
A series of python classes for FITS data processing (with names beginning with Ap) can be used from the unix command line using scripts (names beginning with ap_).
(To be described, but see doc/iTelescope_processing.md for a very high level summary of what is currently implemented.)
See requirements.txt for full dependency list. This is a Python 3
project, with no intention to support Python 2.
Note: As of version 0.5 of this package the required version of astropy
is version 6.0, to catch up to the latest astropy API changes.
pytesthttp://pytest.org (for running the test suite)Sphinxhttp://sphinx-doc.org (for generating documentation)
Install:
# Install for user (if not using a virtual environment).
$ python3 -m pip install . -r requirements.txt --user
# or install for the system (as root, or as a user in a virtual environment).
$ pip3 install . -r requirements.txtTo install in developer mode replace the last line with
pip3 install -e . -r requirements.txt.
If you use conda or miniconda you may want to set up a new
environment prior to running the pip install using the supplied
YaML file, e.g.
conda env create -f ap-env.yml
conda activate ap-env Get general command line application help:
$ dksraw --help
# Or for a specific subcommand, e.g. split
$ dksraw split --helpBuild documentation:
cd doc
make html
# view doc/_build/html/index.html in a browserRun the test suite. For reasons I haven't resolved running pytest as a stand-alone runs into the path issues related to https://docs.pytest.org/en/latest/pythonpath.html
# Run tests capturing stdout
$ python3 -m pytest -rfsP test/
# Runs tests with a short summary of each test run
$ python3 -m pytest -rfsp test/To generate test coverage:
# Generates html files in the directory ./htmlcov
python3 -m pytest --cov-report html --cov=AstroPhotography test/
# Open htmlcov/index.html with a browser...