Rapid Outer Radiation Belt Flux Dropouts and Fast Acceleration during the March 2015 and 2013 Storms: The Role of ULF Wave Ttansport From a Dynamic Outer Boundary

Duplicate copy of the electron phase space density provided for the Geospace Environment Modeling (GEM) challenge event in  March 2013 selected by the Quantitative Assessment of Radiation Belt Modeling focus group. The original copy of the data is available from https://drive.google.com/drive/u/0/folders/0ByNhSbWkAgdfaGt6TnJMcElhUTg

Data Providers:
Michael G. Henderson (LANL; mghenderson@lanl.gov)
Steven K. Morley (LANL; smorley@lanl.gov)

This data product provides electron phase space density from the Van Allen Probes
ECT suite of instruments. The data are calculated similarly to the method described
in Morley et al. (2013), with some differences that are noted below.

The files are provided in HDF5 format, so the files are self-describing and contain
ISTP-style metadata. The files should be directly readable with:
 - SpacePy (http://sourceforge.net/p/spacepy)
    - import the spacepy.datamodel module, use the function fromHDF5 to read the data
 - Autoplot (http://autoplot.org)
 - MatLab and IDL provide convience routines for reading HDF5

Method
------
Starting with directional differential flux data from HOPE, MagEIS and REPT, we
calculate the PSD as a function of energy, pitch angle, position and time.
Following the same basic method given by Morley et al., we transform this to phase 
space density as a function of the three adiabatic invariants (M, K, L*); note that
where Morley et al. used a relativistic Maxwellian fit to the flux spectrum, these
data use a smoothing spline fit so that more complex spectral shapes can be
represented. Note also that Morley et al. only used REPT, where these files represent
the energy ranges of MagEIS and REPT, but also use HOPE to constrain the fit at low
energies.

While the pitch angles are determined using the EMFISIS data, all three adiabatic 
invariants are derived from a magnetic field model. These PSD data files use the
Tsyganenko and Sitnov (2005) model (aka TS04, T05 or TS05). The models were run using
the "definitive" Qin-Denton data files provided by the RBSP ECT-SOC. These files
should be made available through the QARBM google drive. 

Caveats
-------
These data should be considered preliminary. They have undergone a limited amount of
verification and prior to publication the data providers should be contacted. New
versions of these data may be generated at some point - we do not expect noticeable 
changes to the data present.
Some gaps may be present in the files that are due to calculation of the adiabatic 
invariants failing. The issues causing these gaps have been resolved in the underlying 
software, but the data have not yet been regenerated.

References
----------
Morley, S. K., M. G. Henderson, G. D. Reeves, R. H. W. Friedel, and D. N. Baker (2013), 
Phase Space Density matching of relativistic electrons using the Van Allen Probes: REPT results,
 Geophys. Res. Lett., 40, 4798-4802, doi:10.1002/grl.50909.

Tsyganenko, N. A., and M. I. Sitnov (2005), 
Modeling the dynamics of the inner magnetosphere during strong geomagnetic storms, 
J. Geophys. Res., 110, A03208, doi:10.1029/2004JA010798.

Also included is the copy of the LANLgeoMag software used in the paper provided on https://github.com/drsteve/LANLGeoMag 

Copyright (c) 2014, Los Alamos National Security, LLC All rights reserved. Copyright 2014. Los Alamos National Security, LLC. This software was produced under U.S. Government contract DE-AC52-06NA25396 for Los Alamos National Laboratory (LANL), which is operated by Los Alamos National Security, LLC for the U.S. Department of Energy. The U.S. Government has rights to use, reproduce, and distribute this software. NEITHER THE GOVERNMENT NOR LOS ALAMOS NATIONAL SECURITY, LLC MAKES ANY WARRANTY, EXPRESS OR IMPLIED, OR ASSUMES ANY LIABILITY FOR THE USE OF THIS SOFTWARE. If software is modified to produce derivative works, such modified software should be clearly marked, so as not to confuse it with the version available from LANL.

Additionally, redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. Neither the name of Los Alamos National Security, LLC, Los Alamos National Laboratory, LANL, the U.S. Government, nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY LOS ALAMOS NATIONAL SECURITY, LLC AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL LOS ALAMOS NATIONAL SECURITY, LLC OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.