Skip to main content

Python API for Fortran MSISE-00 neutral atmosphere model.

Project description

MSISE-00 in Python and Matlab

Zenodo DOI python matlab PyPi Download stats

NRL MSISE-00 atmospheric model for Python. Also accessible via Matlab. Valid from altitude z = 0..1000 km.

The plot immediately below shows a slice at 200km on a world-wide grid. The yellow ball represents the sun footprint on Earth.

MSIS global time animation

This plot is from Matlab calling MSISE00:

MSISE00 Matlab

Units

  • Temperature: degrees Kelvin [K]
  • Density: particles per cubic meter [m^-3]
  • Mass density: kilograms per cubic meter [kg m^-3]

Install

This process is used for the Python and Matlab access to MSIS. Any Fortran compiler should work. Fortran compiler may be installed by

  • MacOS / Homebrew: brew install gcc
  • Linux: apt install gfortran
  • Windows

Get MSISE00 and install Python package:

pip install msise00

or for the latest development code

git clone https://github.com/space-physics/msise00

pip install -e msise00

optionally check that MSIS is working via:

pytest msise00

This Python module uses our build-on-run technique. The first time you use this Python module, you will see messages from the Meson build system.

Examples

MSISE00 can be used from the command line, as an imported module, and even from Matlab.

import module

import msise00
from datetime import datetime

atmos = msise00.run(time=datetime(2013, 3, 31, 12), altkm=150., glat=65., glon=-148.)

atmos is an xarray.Dataset containing all the simulation output values. atmos is 4-D: (time, altitude, lat, lon), and indexed like atmos['N2']

Command Line

Write NetCDF4 output (HDF5 compatible) with command line argument -w filename.nc.

Simple examples under Examples/

  • Altitude Profile at a single time:

    msise00 -t 2017-08-21T20:48 -c 40 -90
    
  • Alt. profile time-range with hourly time step:

    msise00 -t 2017-08-21 2017-08-22 -c 40 -90
    
  • Grid: time,lat,lon: generates the plots in the README:

    msise00 -t 2016-09-20 2016-09-21
    
  • single time lat/lon can be plotted:

    msise00 -t 2017-01-02T12
    

Matlab

Matlab use of MSISE00 is demonstrated in Examples

MSISE00 will automatically compile "build on run" on first run from Matlab as with Python.

Optionally, verify Matlab is working by from the top msise00/ directory in Terminal

buildtool test

Fortran

Those wishing to use MSIS from a plain Fortran program can do from the top-level msise00/ directory:

cmake -B build
cmake --build build

optionally:

ctest --test-dir build

Reference

  • Original fortran code
  • 1200+ citations 2002 paper

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

msise00-1.11.1.tar.gz (37.7 kB view details)

Uploaded Source

Built Distribution

msise00-1.11.1-py3-none-any.whl (38.7 kB view details)

Uploaded Python 3

File details

Details for the file msise00-1.11.1.tar.gz.

File metadata

  • Download URL: msise00-1.11.1.tar.gz
  • Upload date:
  • Size: 37.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for msise00-1.11.1.tar.gz
Algorithm Hash digest
SHA256 e6e8d357d7f2a56ffbd6eb3fc3b3f870d37c05e46aeb661e8d8eee063c7cbe99
MD5 608650d2ba34198a9f3b852cc29fa5ba
BLAKE2b-256 adda65a51dd71f68f64fdcb895a8ca3d6948c1ff98f1554d73e95fa4cc4790be

See more details on using hashes here.

Provenance

The following attestation bundles were made for msise00-1.11.1.tar.gz:

Publisher: publish-python-package.yml on space-physics/msise00

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file msise00-1.11.1-py3-none-any.whl.

File metadata

  • Download URL: msise00-1.11.1-py3-none-any.whl
  • Upload date:
  • Size: 38.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for msise00-1.11.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2825255554b0992b71477d05cf032e41a41864d13ed835ee61476f5bcf25beca
MD5 c49fdb1adb4fd3e378d5723182f7dad4
BLAKE2b-256 4d9df17efcf3a7854c108708df132db88285e387a6feb469bb21444b88661359

See more details on using hashes here.

Provenance

The following attestation bundles were made for msise00-1.11.1-py3-none-any.whl:

Publisher: publish-python-package.yml on space-physics/msise00

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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