Skip to main content

A Python wrapper around the NRLMSIS model.

Project description

https://swxtrec.github.io/pymsis/_static/pymsis-logo.png

pymsis: A python wrapper of the NRLMSIS model

Zenodo PyPi Downloads GitHubActions

Pymsis is meant to be a minimal and fast Python wrapper of the NRLMSIS models. Documentation to get started quickly can be found on the home page. It includes some examples that demonstrate how to access and plot the data.

NRL Mass Spectrometer, Incoherent Scatter Radar Extended Model (MSIS)

The MSIS model is developed by the Naval Research Laboratory.

Note that the MSIS2 code is not available for commercial use without contacting NRL. See the MSIS2 license file for explicit details. We do not repackage any of the MSIS source code in this repository for that reason. However, we do provide utilities to easily download and extract the original source code. By using that code you agree to their terms and conditions.

References

Please acknowledge the University of Colorado Space Weather Technology, Research and Education Center (SWx TREC) and cite the original papers if you make use of this model in a publication.

Emmert, J. T., Drob, D. P., Picone, J. M., Siskind, D. E., Jones, M., Mlynczak, M. G., et al. (2020). NRLMSIS 2.0: A whole‐atmosphere empirical model of temperature and neutral species densities. Earth and Space Science, 7, e2020EA001321. https://doi.org/10.1029/2020EA001321

The Original NRLMSISE-00 paper

Picone, J. M., Hedin, A. E., Drob, D. P., and Aikin, A. C., NRLMSISE‐00 empirical model of the atmosphere: Statistical comparisons and scientific issues, J. Geophys. Res., 107( A12), 1468, doi:10.1029/2002JA009430, 2002.

Installation

The easiest way to install pymsis is to install from PyPI.

pip install pymsis

For the most up-to-date pymsis, you can install directly from the git repository

pip install git+https://github.com/SWxTREC/pymsis.git

or to work on it locally, you can clone the repository and use an editable install

git clone https://github.com/SWxTREC/pymsis.git
cd pymsis
pip install -e .

Remote installation

The installation is dependent on access to the NRL source code. If the download fails, of you have no internet access you can manually install the Fortran source code as follows.

  1. Download the source code

    The source code is hosted on the NRL’s website: https://map.nrl.navy.mil/map/pub/nrl/NRLMSIS/NRLMSIS2.0/ Download the NRLMSIS2.0.tar.gz file to your local system.

  2. Extract the source files

    The tar file needs to be extracted to a new msis2 directory in the base of the pymsis package.

    mkdir msis2
    tar -xvzf NRLMSIS2.0.tar.gz -C msis2/
  3. Install the Python package

    pip install .

Project details


Download files

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

Source Distribution

pymsis-0.4.0.tar.gz (89.4 kB view hashes)

Uploaded Source

Built Distributions

pymsis-0.4.0-cp310-cp310-win_amd64.whl (684.1 kB view hashes)

Uploaded CPython 3.10 Windows x86-64

pymsis-0.4.0-cp310-cp310-win32.whl (677.0 kB view hashes)

Uploaded CPython 3.10 Windows x86

pymsis-0.4.0-cp310-cp310-musllinux_1_1_x86_64.whl (1.0 MB view hashes)

Uploaded CPython 3.10 musllinux: musl 1.1+ x86-64

pymsis-0.4.0-cp310-cp310-musllinux_1_1_i686.whl (1.1 MB view hashes)

Uploaded CPython 3.10 musllinux: musl 1.1+ i686

pymsis-0.4.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.3 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ x86-64

pymsis-0.4.0-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl (1.3 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ i686

pymsis-0.4.0-cp310-cp310-macosx_10_9_x86_64.whl (1.3 MB view hashes)

Uploaded CPython 3.10 macOS 10.9+ x86-64

pymsis-0.4.0-cp39-cp39-win_amd64.whl (684.1 kB view hashes)

Uploaded CPython 3.9 Windows x86-64

pymsis-0.4.0-cp39-cp39-win32.whl (677.1 kB view hashes)

Uploaded CPython 3.9 Windows x86

pymsis-0.4.0-cp39-cp39-musllinux_1_1_x86_64.whl (1.0 MB view hashes)

Uploaded CPython 3.9 musllinux: musl 1.1+ x86-64

pymsis-0.4.0-cp39-cp39-musllinux_1_1_i686.whl (1.1 MB view hashes)

Uploaded CPython 3.9 musllinux: musl 1.1+ i686

pymsis-0.4.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.3 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ x86-64

pymsis-0.4.0-cp39-cp39-manylinux_2_17_i686.manylinux2014_i686.whl (1.3 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ i686

pymsis-0.4.0-cp39-cp39-macosx_10_9_x86_64.whl (1.3 MB view hashes)

Uploaded CPython 3.9 macOS 10.9+ x86-64

pymsis-0.4.0-cp38-cp38-win_amd64.whl (684.1 kB view hashes)

Uploaded CPython 3.8 Windows x86-64

pymsis-0.4.0-cp38-cp38-win32.whl (677.0 kB view hashes)

Uploaded CPython 3.8 Windows x86

pymsis-0.4.0-cp38-cp38-musllinux_1_1_x86_64.whl (1.0 MB view hashes)

Uploaded CPython 3.8 musllinux: musl 1.1+ x86-64

pymsis-0.4.0-cp38-cp38-musllinux_1_1_i686.whl (1.1 MB view hashes)

Uploaded CPython 3.8 musllinux: musl 1.1+ i686

pymsis-0.4.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.3 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ x86-64

pymsis-0.4.0-cp38-cp38-manylinux_2_17_i686.manylinux2014_i686.whl (1.3 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ i686

pymsis-0.4.0-cp38-cp38-macosx_10_9_x86_64.whl (1.3 MB view hashes)

Uploaded CPython 3.8 macOS 10.9+ x86-64

pymsis-0.4.0-cp37-cp37m-win_amd64.whl (683.9 kB view hashes)

Uploaded CPython 3.7m Windows x86-64

pymsis-0.4.0-cp37-cp37m-win32.whl (677.1 kB view hashes)

Uploaded CPython 3.7m Windows x86

pymsis-0.4.0-cp37-cp37m-musllinux_1_1_x86_64.whl (1.0 MB view hashes)

Uploaded CPython 3.7m musllinux: musl 1.1+ x86-64

pymsis-0.4.0-cp37-cp37m-musllinux_1_1_i686.whl (1.1 MB view hashes)

Uploaded CPython 3.7m musllinux: musl 1.1+ i686

pymsis-0.4.0-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.3 MB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.17+ x86-64

pymsis-0.4.0-cp37-cp37m-manylinux_2_17_i686.manylinux2014_i686.whl (1.3 MB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.17+ i686

pymsis-0.4.0-cp37-cp37m-macosx_10_9_x86_64.whl (1.3 MB view hashes)

Uploaded CPython 3.7m macOS 10.9+ x86-64

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page