Metadata-Version: 2.1
Name: maser4py
Version: 0.7.1
Summary: Python 3 module for the MASER portal
Home-page: https://github.com/maserlib/maser4py
Author: MASER team
Author-email: UNKNOWN
License: GPL
Platform: UNKNOWN
Requires-Dist: openpyxl
Requires-Dist: pytz
Requires-Dist: astropy
Requires-Dist: numpy
Requires-Dist: python-dateutil
Requires-Dist: Sphinx
Requires-Dist: sphinx-rtd-theme

maser4py: The Python 3 package for the MASER portal
###################################################
X.Bonnin (LESIA, Obs. Paris, CNRS), 19-DEC-2018

About maser4py
==============

maser4py python package contains modules to
deal with services, data and tools provided in the framework
of the MASER portal (see section below).


Installation
============

Prerequisites
-------------

Python 3.4, 3.5 or 3.6 must be available.

The maser4py also requires the NASA CDF software to be run (visit http://cdf.gsfc.nasa.gov/ for more details). Especially the CDFLeapSeconds.txt file
should be on the local disk and reachable from the $CDF_LEAPSECONDSTABLE env. variable. If it is not the case, maser4py offers tools to read and/or download
this file from the NASA Web site (see user manual for more details).

Using pip
---------

From a terminal, enter:

   pip install maser4py

Using Source
------------

From a terminal, enter:

    git clone https://github.com/maserlib/maser4py

Then, from the maser4py directory, enter:

    pip install -r requirements.txt

Then,

    python3 setup.py install


Usage
=====

From Python, enter "import maser".
The module also offers specific command line interfaces.

For more details, see the maser4py user manual available in the pdf format (in doc/build/latex/maser4py.pdf) or from https://pypi.python.org/pypi/maser4py (see in "Package Documentation").

Tree
====

The maser4py directory contains the following items:

::

    doc/  stores the maser4py documentation (source and build)

    maser/ stores the maser4py source files

    scripts/ store scripts to run/test/manage maser4py

    __main__.py python script to run maser.main program

    CHANGELOG.rst software change history log

    MANIFEST.in files to be included to the package installation (used by   tup.py)

    README.rst current file

    requirements.txt list of python package dependencies and versions

    setup.cfg file used by sphinx to build the maser4py doc.

    setup.py maser4py package setup file

About MASER
===========

The MASER (Measuring, Analyzing & Simulating Emissions in the Radio range) portal is offering access to a series of tools and databases linked to low frequency radioastronomy (a few kilohertz to a few tens of megahertz). Radio measurements in this spectral range are done with ground based observatories (for frequencies above the terrestrial ionosphere cutoff at 10 MHz) or from space based platforms (at low frequencies).

In this frequency range, the main radio sources are the Sun and the magnetized planets. Measurements of the low frequency electric and magnetic field fluctuations can also provide local plasma diagnostics and in-situ observations of plasma waves phenomena in the Solar Wind or in planetary environments.

* For more information about the MASER project: http://maser.lesia.obspm.fr/
* For more information about MASER4PY: https://github.com/maserlib/maser4py


