Skip to main content

Provides astronomy ephemeris to plan telescope observations

Project description

Name:astroobs
Website:https://github.com/ceyzeriat/astroobs
Author: Guillaume Schworer
Version: 1.4.4

Check the astroobs.eu website for a friendly web-interface of that library! (soon)

Astroobs provides astronomy ephemeris (airmass, azimuth, altitude, moon separation, etc) of a night sky target as a function of the date-time and the longitude/latitude of the observer. A list of international observatories is provided as well as a SIMBAD-querier to easily import targets. This package is based on pyephem ephemeris calculations. The main difference with this latter package is that astroobs provides a very straight-forward library for the observer to get the critical information in order to plan an observation. It also provides convenient turn-key tools to convert epochs and plot diagrams. It is released under the GNU General Public License v3 or later (GPLv3+).

import astroobs as obs

o=obs.Observation('vlt', local_date=(2015, 1, 1), moonAvoidRadius=15, horizon_obs = 40)
o.add_target('aldebaran')
o.add_target('canopus')
o.plot()
https://raw.githubusercontent.com/ceyzeriat/astroobs/master/img/obs_ex.png
aldebaran = o.targets[0]
aldebaran.whenobs(o, (2015,1,1), (2015, 2, 1))
https://raw.githubusercontent.com/ceyzeriat/astroobs/master/img/aldebaran_when.png

Documentation

Refer to this page, http://pythonhosted.org/astroobs/astroobs.html

Requirements

astroobs requires the following Python packages:

  • NumPy: for basic numerical routines
  • Astropy: for angle units
  • Astroquery: for querying Simbad
  • pyephem: for the calculations of ephemeris
  • matplotlib: for plotting (optional)
  • pytz: for timezones management
  • re, os, sys, datetime, time: for basic stuff

astroobs is tested on Linux and Python 2.7 only, but should cross-plateform and python3 friendly without too many issues.

Installation

The easiest and fastest way for you to get the package and run is to install astroobs through pip:

$ pip install astroobs

You can also download astroobs source from GitHub and type:

$ python setup.py install

Dependencies will not be installed automatically. Refer to the requirements section. If you have an anaconda distribution, you will only need to install astroquery and pyephem.

Contributing

Code writing

Code contributions are welcome! Just send a pull request on GitHub and we will discuss it. In the issue tracker you may find pending tasks.

Bug reporting

If you think you’ve found one please refer to the issue tracker on GitHub.

Additional options

You can either send me an e-mail or add it to the issues/wishes list on GitHub.

Citing

If you use astroobs on your project, please drop me a line <mailto:{my first name}.{my family name}@obspm.fr>, you will get fixes and additional options earlier.

License

astroobs is released under the GNU General Public License v3 or later (GPLv3+). Please refer to the LICENSE file.

Changelog

1.4.4 (2016-08-06)

  • Changed license to GNU
  • Updated documentation
  • Added show_all_obs() to show all available observatories
  • Automated the version management
  • Added disclaimer at import
  • Set default legend parameter to True in plot() and polar()
  • Fixed deprecation warning at display of Target

1.0.0 (2016-05-03)

  • Initial release.

Project details


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
astroobs-1.4.5.tar.gz (28.4 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page