Metadata-Version: 2.1
Name: wmm2020-cext
Version: 1.1.3
Summary: WMM2020 geomagnetic model with simple object-oriented Python interface
Home-page: https://github.com/justengel/wmm2020
Author: Michael Hirsch, Ph.D.
License: UNKNOWN
Keywords: geomagnetic
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Provides-Extra: tests
Provides-Extra: lint
License-File: LICENSE.txt

# WMM2020_CEXT

This library was modified to make a Python C Extension. This makes the library easy to install if you have the 
proper compilers installed. Additionally, I published Windows .whl binaries to pypi.org.

## Install

wmm2020_cext has prebuilt Windows binaries (.whl files), so the library can easily be installed with pip.


```sh
python -m pip install wmm2020_cext
```

Use with ``wmm2020``
```python
import wmm2020
import numpy as np

wmm2020.wmm(np.array([0]), np.array([0]), 0, 0)
```

## Manually Install

Install Visual Studio C Compilers https://wiki.python.org/moin/WindowsCompilers to compile the C extension. 
If this is done correctly you can simply ``pip install ./path/to/library`` or build your binaries
``python setup.py bdist_wheel`` (or ``pip wheel --no-deps ./path/to/library``). The wheel library is required.


# WMM2020

![Actions Status](https://github.com/space-physics/wmm2020/workflows/ci/badge.svg)
[![Language grade: Python](https://img.shields.io/lgtm/grade/python/g/space-physics/wmm2020.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/space-physics/wmm2020/context:python)
[![Python versions (PyPI)](https://img.shields.io/pypi/pyversions/wmm2020.svg)](https://pypi.python.org/pypi/wmm2020)
[![Downloads](http://pepy.tech/badge/wmm2020)](http://pepy.tech/project/wmm2020)


WMM2020 World Magnetic Model...in simple, object-oriented Python.
[WMM2015](https://github.com/space-physics/wmm2015) is also available.
Tested on Linux, Mac and Windows.
Most C compilers work.
At this time Visual Studio is not supported since MSVC doesn't export function symbols without additional headers,
which is typically done with something like SWIG.

![image](./src/wmm2020/tests/incldecl.png)

## Install

for the latest release from PyPi:

```sh
python -m pip install wmm2020
```

Optionally, to get the cutting-edge development version:

```sh
git clone https://github.com/space-physics/wmm2020

python -m pip install -e wmm2020
```

This Python wrapper of WMM2020 uses our build-on-run technique.
The first time you use WMM2020, you will see messages from the Meson build system and your C compiler.


## Usage

an example script

```sh
python RunWMM2020.py
```

or as a Python module:

```python
import wmm2020

mag = wmm2020.wmm(glat, glon, alt_km, yeardec)
```

## Reference

* WMM2020 [inclination map](https://www.ngdc.noaa.gov/geomag/WMM/data/WMM2020/WMM2020_I_MERC.pdf)
* WMM2020 [declination map](https://www.ngdc.noaa.gov/geomag/WMM/data/WMM2020/WMM2020_D_MERC.pdf)


