Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Determine which small solar system bodies are observable from a given location at a given time

Project Description

WhatsObservable is used for determining which minor planets (and comets)
are observable at a given time from a given location on Earth.

WhatsObservable determines the locations of objects using the routines
of [PyEphem]( and the
[Minor Planet Center's Orbit Database](
*Note that at least for the time being the user must download this file
separately and WhatsObservable will find it on disk.*

The intent is to replicate the functionality available at the [JPL Solar System
Dynamics Small Body Whats Observable web page](
The motivation for writing WhatsObservable was to provide this capability when
offline and in an easily scriptable manner.

NOTE: The precision of PyEphem with the MPC Orbit Database is good, especially for
dates near the orbital epoch, but is not nearly as good as what is available
directly from the [JPL Horizons System]( Even
near the orbital epoch errors of a few arcseconds are not uncommon. Use this
tool at your own risk and if precision matters, refer back directly to the
[JPL Horizons System](

A typical usage is:

import datetime
from whatsobservable import minorplanets

objects = minorplanets(datetime.datetime(2013, 9, 1, 10, 0),
568, # 568 is the observatory code for Mauna Kea
max_objects=5, max_magnitude=12., max_zenithdistance_deg=60.0)
print objects

Note that the return is a pandas.DataFrame


Originally written 2013-09-07 by Henry Roe (
Release History

Release History

This version
History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
WhatsObservable-0.1.2-py2-none-any.whl (8.9 kB) Copy SHA256 Checksum SHA256 py2 Wheel Jul 28, 2016
WhatsObservable-0.1.2.tar.gz (7.9 kB) Copy SHA256 Checksum SHA256 Source Jul 28, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting