maser4py: The Python 3 package for the MASER portal
X.Bonnin (LESIA, Obs. Paris, CNRS), 20-MAR-2017
maser4py python package contains modules to deal with services, data and tools provided in the framework of the MASER portal (see section below).
Make sure that Python 3.4 (or higher) as well as pip and setuptools are already installed on your system.
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).
From a terminal, enter:
pip install maser4py
From a terminal, enter:
git clone https://github.com/maserlib/maser4py
Then, from the maser4py directory, enter:
pip install -r requirements.txt
python3 setup.py install
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").
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
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.