lanl/RAM-SCB

Name: RAM-SCB

Owner: Los Alamos National Laboratory

Description: null

Created: 2017-01-23 18:38:12.0

Updated: 2018-04-04 10:20:24.0

Pushed: 2018-03-27 21:11:11.0

Homepage: null

Size: 133498

Language: Fortran

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

RAM-SCB

Build Status

The Ring current Atmosphere interactions Model with Self Consistent magnetic field (B) is a unique code that combines a kinetic model of ring current plasma with a three dimensional force-balanced model of the terrestrial magnetic field. The kinetic portion, RAM, solves the kinetic equation to yield the bounce-averaged distribution function as a function of azimuth, radial distance, energy and pitch angle for three ion species (H+, He+, and O+) and, optionally, electrons. The 3-D force balanced magnetic field model, SCB, balances the J × B force with the divergence of the general pressure tensor to calculate the magnetic field configuration within its domain. The two codes work in tandem, with RAM providing anisotropic pressure to SCB and SCB returning the self-consistent magnetic field through which RAM plasma is advected. RAM-SCB has grown from a research-grade code with limited options and static magnetic field (RAM) to a rich, highly configurable research and operations tool with a multitude of new physics and output products. The RAM-SCB manual provides a guide to users who want to learn how to install, configure, and execute RAM-SCB simulations. While the code is designed to make these steps as straight-forward as possible, it is strongly recommended that users review the publications listed in the Bibliography to ensure a thorough understanding of the physics included in the model.

Documentation

The RAM-SCB manual with extended installation and usage information can be found at RAM-SCB/doc/RAM_SCB.pdf.

Attribution

Researchers who use the RAM-SCB code for scientific research are asked to cite the papers listed below.

  1. Jordanova, V. K. et al. (2006), Kinetic simulations of ring current evolution during the Geospace Environment Modeling challenge events, J. Geophys. Res., 111, A11S10, doi:10.1029/2006JA011644.

  2. Zaharia, S. et al. (2006), Self-consistent modeling of magnetic fields and plasmas in the inner magnetosphere: Application to the geomagnetic storm, J. Geophys. Res., 111, A11S14, doi:10.1029/2006JA011619.

  3. Jordanova, V. K., S. Zaharia, and D. T. Welling (2010), Comparative study of ring current development using empirical, dipolar, and self-consistent magnetic field simulations, J. Geophys. Res., 115(A14):A00J11, doi:10.1029/2010JA015671.

  4. Welling, D. T., V. K. Jordanova, S. G. Zaharia, A. Glocer, and G. Toth (2011), The effects of dynamic ionospheric outflow on the ring current, J. Geophys. Res., 116, doi:10.1029/2010JA015642.

Installation
ig.pl -install -compiler=pgf90 -mpi=mpich2

Usage
 rundir RUNDIR=~/desired_run_directory
m_scb.exe
Release

This software has been approved for open source release and has been assigned LA-CC-16-077.

License

The RAM-SCB License can be found at RAM-SCB/LICENSE.txt.

Contact

For questions about using RAM-SCB please contact Vania Jordanova.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.