Skip to main content

Tools for working with Astrolabe data.

Project description

Powered by Astropy Badge
Author:Tom Hicks <>
This is a Python 3 library for curating image and data files for the Astrolabe project
  • Astrolabe_py contains scripts and modules to:
    • Check FITS file metadata for validity,
    • Show FITS file HDU information,
    • Upload FITS files to iRods, optionally extracting FITS metadata and attaching it to the uploaded files in iRods.


Install via PyPi

pip install astrolabe-py

Python Build using Conda

Building this software requires Python 3.6+. Assuming you have Conda installed, you can use it to build this project within a virtual environment:

git clone
source activate
conda create -n alpy python=3.6
conda activate alpy
cd astrolabe_py
pip install -r requirements.txt

Running Tests

The tests can be run manually from the test subdirectory, as follows:

cd test

Running the Uploader Script

Uploader Script Options:

usage: uploader [-h] [-v] [-u] [--version] [--keyfile [metadata-keyfile]] images_path

FITS file metadata extraction and upload of a file or directory of files.

positional arguments:
   images_path           path to a FITS file or a directory of FITS files to be processed

optional arguments:
   -h, --help            show this help message and exit
   -v, --verbose         provide more information during execution
   -u, --upload-only     upload files to iRods only: do not process file metadata
   --version             show program's version number and exit
   --keyfile [metadata-keyfile]
                         a file specifying which metadata keys which should be processed


uploader -v myDataDirectory
uploader --upload-only myImages/someImage.fits
uploader --keyfile just-these-keys.txt astrofiles

Running the Checker Script

Checker Script Options:

usage: checker [-h] [-a {check,info}] [-v] [--version] images_path

Perform verification actions on a FITS file or a directory of FITS files OR
Show HDU info for the specified FITS file or directory of FITS files

positional arguments:
  images_path           path to a FITS file or a directory of FITS files to be processed

optional arguments:
  -h, --help            show this help message and exit
  -a {check,info}, --action {check,info}
                        action to perform on FITS file(s): validate or show HDU info
  --version             show program's version number and exit


checker myDataDirectory
checker -a check myDataDirectory

checker myImages/someImage.fits
checker -a check myImages/someImage.fits

checker -a info myDataDirectory
checker -a info myImages/someImage.fits


Licensed under Apache License Version 2.0.

Copyright 2018 by Astrolabe Project: American Astronomical Society and the University of Arizona.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for astrolabe-py, version 1.1.0
Filename, size File type Python version Upload date Hashes
Filename, size astrolabe_py-1.1.0.tar.gz (12.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page