Metadata-Version: 1.1
Name: astroobs
Version: 1.4.5
Summary: Provides astronomy ephemeris to plan telescope observations
Home-page: https://github.com/ceyzeriat/astroobs/
Author: Guillaume Schworer
Author-email: guillaume.schworer@obspm.fr
License: GNU General Public License v3 or later (GPLv3+)
Download-URL: https://github.com/ceyzeriat/astroobs/tree/master/dist
Description: .. astroobs
        
        :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.eu`: http://astroobs.eu/
        
        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+).
        
        .. code-block:: python
        
            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()
        
        .. image:: https://raw.githubusercontent.com/ceyzeriat/astroobs/master/img/obs_ex.png
           :align: center
        
        .. code-block:: python
        
            aldebaran = o.targets[0]
            aldebaran.whenobs(o, (2015,1,1), (2015, 2, 1))
        
        .. image:: https://raw.githubusercontent.com/ceyzeriat/astroobs/master/img/aldebaran_when.png
           :align: center
        
        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.
        
        .. _`issue tracker`: https://github.com/ceyzeriat/astroobs/issues
        
        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.
        
Keywords: astronomy,ephemeris,pyephem,iobserve,observatory,telescope,observer,target,airmass
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Documentation :: Sphinx
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Topic :: Scientific/Engineering :: Astronomy
