CMR Header

CCMC Metadata Registry (CMR)

Menu Page

Go to:

CMR: View Simulation Run Info

RAM-SCB/2.2/ROR/BIBEK_RAI_012925_IM_2

Run Description

CCMC ROR run for RAM-SCB 2.2 with RORID BIBEK_RAI_012925_IM_2

Simulation Time:

Simulation Start Time: 2024-01-05T00:20:00Z
Simulation End Time: 2024-01-05T00:20:00Z
Time Step in second: 300.0
Simulation Time Description:
Simulation Time Caveats:

Temporal Dependence (whether the outputs of the simulation code are time-dependent?): true

Regions:

Earth.Magnetosphere
Earth.Magnetosphere.RadiationBelt
Earth.NearSurface.Plasmasphere
Earth.Magnetosphere.RingCurrent

Simulation Domain :

Contacts :

BIBEK.RAI, ModelUser

List of Run Input Parameter Grouping and their associated properties :

Name Description Caveats Properties
REQUIRED BLOCK
Simulation Settings for the REQUIRED BLOCK
Name Label Description Caveats Units Default Value or Actual Value Valid Min Valid Max
ReplStartYYYY ReplStartYYYY
iYear for the starting time
ReplStartMM ReplStartMM
iMonth for the start time
1 12
ReplStartDD ReplStartDD
iDay of the start time
ReplStarthh ReplStarthh
iHour of the start time
ReplStartmm ReplStartmm
iMinute of the start time
ReplEndYYYY ReplEndYYYY
iYear of the stop time
ReplEndMM ReplEndMM
iMonth of the stop time
ReplEndDD ReplEndDD
iDay of the stop time
ReplEndhh ReplEndhh
iHour of the stop time
ReplEndmm ReplEndmm
iMinute of the stop time
TIMING BLOCK
Simulation Settings for the TIMING BLOCK 
Name Label Description Caveats Units Default Value or Actual Value Valid Min Valid Max
MaxHalfStep MaxHalfStep
The maximum half time step (in seconds) that RAM will take, regardless of other factors
100.0
MinHalfStep MinHalfStep
The minimum half time step (in seconds) that RAM will take, regardless of other factors
0.2
DoVarDt DoVarDt
#VARIABLEDT.   

If set to T RAM will adjust its time step based on the current fluxes using the Courant condition

Choices: T or F 
True
SCBTimeStep SCBTimeStep
Amount of time (in seconds) between calls to SCB. If set to 1.0 it will call SCB on every RAM time step
300.0
BCTimeStep BCTimeStep
Amount of time (in seconds) between reading boundary flux files (or from SWMF). If set to 1.0 will update on every RAM time step
300.0
EFTimeStep EFTimeStep
Amount of time (in seconds) between updating electric fields. If set to 1.0 it will update every RAM time step
300.0
COMPONENT BLOCK
Simulation Settings for the COMPONENT BLOCK 
Name Label Description Caveats Units Default Value or Actual Value Valid Min Valid Max
NameBoundPlasma NameBoundPlasma
Determines the boundary flux source
Statistical model of flux boundary following Denton et al., 2015" (https://doi.org/10.1002/2015SW001168) LANL
NameBoundMag NameBoundMag
Determines the magnetic field source and boundary conditions (DIPL, DIPS, T89D, T89I, T89L)

DIPL - Centered dipole field, no SCB calculation; 

T89L - Tsyganenko 1989 + centered dipole magnetic field, no SCB calculation.

DIPS - SCB calculation + Centered dipole field at SCB boundary;

T89D - SCB calculation + Tsyganenko 1989 at SCB boundary; 
DIPL
NameDistribution NameDistribution
Determines the distribution of the flux at the boundary (MAXW)

MAXW: Maxwellian
MAXW
NameEfield NameEfield
Determines the method for calculation of the electric field (VOLS, WESC, W5SC, or RSCE):  
    VOLS: Kp-dependent Volland-Stern model; 
    WESC: Weimer 2000 model mapped along SCB field lines; 
    W5SC: Weimer 2005 model mapped along SCB field lines; 
    RSCE: RAM self-consistent electric field; 
the electric field model is set to 'VOLS' for now. VOLS
UseEfInd UseEfInd
Whether or not to use an inductive electric field

with 'F' as default. 
False
RAM BLOCK
Simulation Settings for the RAM (the ring current model) BLOCK
Name Label Description Caveats Units Default Value or Actual Value Valid Min Valid Max
nR nR
Number of radial grid points used in RAM
20
nT nT
Number of toroidal/local time grid points (25 default; 49 preferred)
49
nE nE
Number of energy bins used
35
nPa nPa
Number of pitch angle bins used
72
PlasmasphereModel PlasmasphereModel
Transport model name: Carpenter, Transport
Carpenter
RefillingTau RefillingTau
Refilling model name: Fixed, Analytic, Rasmussen
Analytic
UseCoulomb UseCoulomb
If True, use Coulomb collisions
False
UsePlasmasphere UsePlasmasphere
Whether the ring current model is running with the plasmasphere model or not
False
SCB BLOCK
Simulation Settings related to the SCB (self-consistent magnetic field model) BLOCK 
Name Label Description Caveats Units Default Value or Actual Value Valid Min Valid Max
ConvergenceDistance ConvergenceDistance
Minimum accuracy that needs to be reached regardless of other factors (between 0 and 1)
0.9 0 1
PressureMode PressureMode
Options are SKD, ROE, EXT, FLT, and BAT. BAT is for use with the SWMF.

Note: These are all methods for extrapolating or extending the pressure beyond the RAM grid (for SCB).
SKD - Spence-Kivelson empirical model
ROE - Roederer empirical model
EXT - Linear extrapolation
FLT - Constant (flat) extrapolation
BAT - Use pressure from BATS-R-US (only when coupled to SWMF)
SKD
MinSCBIterations MinSCBIterations
Minimum number of outer SOR Iterations performed by SCB
1
SCBMethod SCBMethod
Which inner SCB method to use (1 = Direct Matrix Inversion, 2 = SOR Iterations, 3 = No SCB)
2
OuterMethod OuterMethod
Which outer SCB method to use (1 = Picard Iteration, 2 = Newton Method)
1
InnerConvergenceAlpha InnerConvergenceAlpha
Convergence criteria for the Alpha residual
1E-10
InnerConvergencePsi InnerConvergencePsi
Convergence Criteria for the Psi residual
1E-8
nTheta nTheta
Number of theta (polar) grid points used in SCB
71
nPsi nPsi
Number of psi (radial) surfaces used in SCB
45
nZeta nZeta
Number of zeta (azimuthal) surfaces used in SCB 
73
Isotropic Isotropic
Whether to use isotropic pressure mappings in SCB (does not affect RAM)
False
ReduceAnisotropy ReduceAnisotropy
Whether to change the anisotropy to a marginally mirror-stable
False
BetaExtrapolation BetaExtrapolation
Whether to extrapolate Beta Euler potential values to the outside boundary or use the previous point (Currently unused)
True
AzimuthalOffset AzimuthalOffset
Whether to set equidistance at most problematic time (if T) or keep it at midnight (if F)
False
EmptyLossCone EmptyLossCone
Whether to use a filled loss cone (if F) or a more realistic empty loss cone using M. Liemohn's 2004
False
AdaptiveMesh AdaptiveMesh
Whether to use Mesh refinement in magnetic flux, so that one has equidistant magnetic flux surfaces
True
SORDetail SORDetail
Whether to compute extra Successive Over Relaxation information
False
EnergyDetail EnergyDetail
Whether to compute DPS Dst and other energy information
True
ForceBalanceDetail ForceBalanceDetail
Whether to compute global force balance before and after SCB runs, this will cause additional output
False
PressureDetail PressureDetail
Whether to compute the full 3D pressure profile before an SCB run, this will cause additional output
False
INPUT BLOCK
Simulation Settings for the INPUT BLOCK 
Name Label Description Caveats Units Default Value or Actual Value Valid Min Valid Max
NameOmniFile NameOmniFile
Name of the omni input file (needed if using the WESC, W5SC, or RSCE electric fields)
omni.txt
UseSWMFFormat UseSWMFFormat
Whether the omni file is in the SWMF format or the older RAM format
False
NameIndicesFile NameIndicesFile
Name of the KP and F10.7 indices file needed for RAM (included in default installation)
RamIndices.txt
BoundaryPath BoundaryPath
Location where the flux boundary files can be found (needed by RAM)
IM/input_ram/
QinDentonPath QinDentonPath
Location where the QinDenton files can be found (Used for the recent Tsyganenko magnetic field models)
IM/input_scb/
InitializationPath InitializationPath
Location where the RAM Initialization.nc file can be found (included in default installation)
IM/input_ram/
OUTPUT BLOCK
Simulation Settings related to model output specifics
Name Label Description Caveats Units Default Value or Actual Value Valid Min Valid Max
DtSaveRestart DtSaveRestart
How often a restart file should be written (in seconds), -1.0 will disable restart files
3600.0
DoSaveFinalRestart DoSaveFinalRestart
Whether a restart file should be written on RAM finishing
True
TimedRestartFiles TimedRestartFiles
Whether to time stamp the restart files. If F only one restart file will be made and it will be overwritten
False
DtLogFileWrite DtLogFileWrite
How often the log file should be appended (in seconds)
60.0
DtPressureFileWrite DtPressureFileWrite
How often RAM equatorial pressures should be written (in seconds)
300.0
DthIFileWrite DthIFileWrite
How often SCB hI files should be written (in seconds)
3600.0
DtEFieldFileWrite DtEFieldFileWrite
How often electric field files should be written
3600.0
DtMAGxyzFileWrite DtMAGxyzFileWrite
How often x, y, and z from SCB should be written
3600.0
DoSaveFlux DoSaveFlux
Output frequency [s] for writing RAM flux files (-1 turns output off)
300.0
DoDump3DFlux DoDump3DFlux
Whether SCB 3D flux files should be written or not (currently outputs 3D flux every hour)
False

Run Access Information :

Keyword(s) :

electron precipitation

Linked to Parent Spase Resource(s) (example: SimulationModel) :

spase://CCMC/SimulationModel/RAM-SCB/v.2.2

List of Publications Referencing this Run :

CMR Footer

Curator: Chiu Wiegand | NASA Official: Dr. Masha Kuznetsova | Privacy and Security Notices | Accessibility | CCMC Data Collection Consent Agreement