Metadata-Version: 2.1
Name: msise00
Version: 1.3.0.1
Summary: Python API for Fortran MSISE-00 neutral atmosphere model.
Home-page: https://github.com/scivision/msise00
Author: Michael Hirsch, Ph.D.
Author-email: scivision@users.noreply.github.com
License: UNKNOWN
Description: [![Zenodo DOI](https://zenodo.org/badge/32971905.svg)](https://zenodo.org/badge/latestdoi/32971905)
        [![Travis-CI](https://travis-ci.org/scivision/msise00.svg)](https://travis-ci.org/scivision/msise00)
        [![Coverage](https://coveralls.io/repos/scivision/msise00/badge.svg?branch=master&service=github)](https://coveralls.io/github/scivision/msise00?branch=master)
        [![Build status](https://ci.appveyor.com/api/projects/status/g58w79defiiiu6j6?svg=true)](https://ci.appveyor.com/project/scivision/msise00)
        [![Maintainability](https://api.codeclimate.com/v1/badges/f6f206d6f6605bcf435d/maintainability)](https://codeclimate.com/github/scivision/msise00/maintainability)
        [![Python versions (PyPI)](https://img.shields.io/pypi/pyversions/msise00.svg)](https://pypi.python.org/pypi/msise00)
        [![PyPi Download stats](http://pepy.tech/badge/msise00)](http://pepy.tech/project/msise00)
        
        # MSISE-00 in Python and Matlab
        
        NRL MSISE-00 atmospheric model for Python &ge; 3.6, 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](./tests/msise00_demo.gif)
        
        This plot is from [Matlab](./tests/test_msise00_matlab.m) calling MSISE00:
        
        ![MSISE00 Matlab](./tests/msis_matlab.png)
        
        ## Install
        
        This process is used for the Python and [Matlab](#matlab) access to MSIS.
        
        -   Mac: `brew install gcc`
        -   Linux: `apt install gfortran`
        -   [Windows](https://www.scivision.co/windows-gcc-gfortran-cmake-make-install/)
        
        And then:
        ```sh
        pip install -e .
        ```
        
        ## Examples
        
        MSISE00 can be used from the command line, as an imported module, and even from Matlab.
        
        ### import module
        
        ```python
        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](http://xarray.pydata.org/en/stable/generated/xarray.Dataset.html) 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 include:
        
        * AltitudeProfile.py
        * TimeProfile.py
        * Worldgrid.py
        
        
        * Altitude Profile at a single time:
          ```sh
          msis00 -t 2017-08-21T20:48 -c 40 -90
          ```
        * Alt. profile time-range with hourly time step:
          ```sh
          msis00 -t 2017-08-21 2017-08-22 -c 40 -90
          ```
        * Grid: time,lat,lon: generates the plots in the README:
          ```sh
          msis00 -t 2016-09-20 2016-09-21
          ```
        * single time lat/lon can be plotted:
          ```sh
          msise00 -t 2017-01-02T12
          ```
          
        ### Matlab
        
        Matlab and GNU Octave users can seamlessly access Python modules, as demonstrated in 
        [AltitudeProfile.m](./matlab/AlitudeProfile.m) and 
        [msise00.m](./matlab/msise00.m).
        
        1. Install MSISe00 by running [setup_msise00.m](./matlab/setup_msise00.m)
        2. From Matlab, verify everything is working by from the `msise00/` directory:
           ```matlab
           runtests('tests')
           ```
           
        ## Fortran source
        
        The MSISE00 Fortran source code may also be used directly.
        We have provided for easy code reuse in
        [CMake](./src/CMakeLists.txt)
        and
        [Meson](./src/meson.build)
        projects.
           
        ## Reference
        
        * Original fortran [code](https://ccmc.gsfc.nasa.gov/pub/modelweb/atmospheric/msis/)
        * 1200+ citations 2002 [paper](http://onlinelibrary.wiley.com/doi/10.1029/2002JA009430/pdf)
        
Keywords: atmosphere,geospace
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Fortran
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
Requires-Python: >= 3.6
Description-Content-Type: text/markdown
Provides-Extra: cov
Provides-Extra: plot
Provides-Extra: tests
