Metadata-Version: 1.1
Name: eph
Version: 0.3
Summary: Retrieve, represent and manipulate JPL Horizons ephemerides.
Home-page: https://github.com/bluephlavio/eph
Author: Flavio Grandin
Author-email: flavio.grandin@gmail.com
License: MIT
Description: .. image:: https://travis-ci.org/bluephlavio/eph.svg?branch=master
           :target: https://travis-ci.org/bluephlavio/eph
        
        .. image:: https://coveralls.io/repos/github/bluephlavio/eph/badge.svg?branch=master
           :target: https://coveralls.io/github/bluephlavio/eph?branch=master
        
        Readme
        ======
        
        The ``eph`` package provides some useful functions, classes and tools
        to *retrieve*, *parse* and *manipulate* ephemerides in an `astropy <http://www.astropy.org/>`_-compatible way.
        
        Basic Usage
        -----------
        
        .. code-block:: python
        
            import eph
        
            req = eph.JplReq() # create the request
            req.read('.ephrc', 'jplparams') # read parameters from 'jplparams' section in '.ephrc' file
            req.set({
                'COMMAND': 'earth',
                'START_TIME': '2007-11-17',
                'STOP_TIME': '2017-4-22'
                }) # set parameters from dictionary
            res = req.query() # perform the request obtaining a response from Jpl Horizons service
            ephemeris = res.parse() # extract and parse the ephemeris contained in the http response
        
            print(ephemeris) # print data
        
        
        The content of ``.ephrc`` can be something like this
        (see ftp://ssd.jpl_process.nasa.gov/pub/ssd/horizons_batch_example.long for a complete description of JPL parameters)
        
        .. code-block:: ini
        
            [jplparams]
            CENTER='@0'
            OBJ_DATA=NO
            MAKE_EPHEM=YES
            TABLE_TYPE=VECTORS
            VEC_TABLE=1
            REFERENCE_PLANE=ECLIPTIC
            REF_SYSTEM=J2000
            OUT_UNITS=AU-D
            CSV_FORMAT=YES
            VEC_LABEL=NO
            STEP_SIZE=1d
        
        
        Command line tool
        -----------------
        
        ``eph`` package also provides a command line tool to retrive ephemerides from services like JPL Horizons.
        To use it, open the terminal and type
        
        .. code-block:: bash
        
            $ eph 2007-11-17 2017-4-22 venus
        
        and you get ephemeris table of Venus starting from 2007-11-17 to 2017-4-22. You can also change the reference frame,
        time-step, output etc.. through the options provided. Check available options typing
        
        .. code-block:: bash
        
            $ eph --help
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
