Metadata-Version: 2.4
Name: facer-model
Version: 1.0.3
Summary: The Birkeland current model presented by Coxon et al. (2016).
Author-email: John C Coxon <work@johncoxon.co.uk>, Stephen E Milan <steve.milan@leicester.ac.uk>
Maintainer-email: John C Coxon <work@johncoxon.co.uk>
License-Expression: AGPL-3.0-or-later
Project-URL: DOI, https://doi.org/10.5281/zenodo.15731338
Project-URL: Repository, https://github.com/johncoxon/facer-model
Keywords: Birkeland currents,field-aligned currents,magnetic reconnection
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENCE.txt
Requires-Dist: matplotlib
Requires-Dist: numpy
Requires-Dist: pandas
Dynamic: license-file

# FACER

[![DOI](https://zenodo.org/badge/665918230.svg)](https://doi.org/10.5281/zenodo.15731338)
[![Python package](https://github.com/johncoxon/birkeland-model/actions/workflows/test.yml/badge.svg)](https://github.com/johncoxon/birkeland-model/actions/workflows/test.yml)

Field-Aligned Currents Estimated from Reconnection (FACER) is a Python implementation of the Birkeland current model presented in the following two papers:
- [Stephen E Milan (2013), Modeling Birkeland currents in the expanding/contracting polar cap paradigm, _Journal of Geophysical Research: Space Physics_, 118, 5532–5542.](https://doi.org/10.1002/jgra.50)
- [John C Coxon, Stephen E Milan, Jennifer A Carter, Lasse BN Clausen, Brian J Anderson & Haje Korth (2016). Seasonal and diurnal variations in AMPERE observations of the Birkeland currents compared to modeled results, _Journal of Geophysical Research: Space Physics_, 121, 4027–4040.](https://doi.org/10.1002/2015JA022050)

FACER is a simple mathematical model of the region 1 and 2 Birkeland current system intensities for differing dayside and nightside magnetic reconnection rates, consistent with the expanding/contracting polar cap paradigm of solar wind-magnetosphere-ionosphere coupling.

## Tests

```
pytest tests/test.py
```

## Usage

```
from facer import Model

dayside_reconnection_rate = 50       # in kV
nightside_reconnection_rate = 50     # in kV
solar_radio_flux = 80                # in SFU
time = datetime.datetime(2010, 1, 1)
hemisphere = "north"
polar_cap_flux = 0.5                 # in GWb

model = Model(dayside_reconnection_rate,
              nightside_reconnection_rate,
              solar_radio_flux,
              time,
              hemisphere,
              polar_cap_flux)
```
