CMR Header

CCMC Metadata Registry (CMR)

Menu Page

Go to:

CMR: View Simulation Run Info

RAM-SCB/2.2/ROR/Taras_Sumaruk_061024_IM_2

Run Description

CCMC ROR run for RAM-SCB 2.2 with RORID Taras_Sumaruk_061024_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 :

Taras.Sumaruk, ModelUser

List of Run Input Parameter Grouping and their associated properties :

Name Description Caveats Properties
REQUIRED BLOCK
Simulation Settings for the REQUIRED BLOCK
Name Description Caveats Units Default Value or Actual Value Valid Min Valid Max
ReplStartYYYY
iYear for the starting time
ReplStartMM
iMonth for the start time
1 12
ReplStartDD
iDay of the start time
ReplStarthh
iHour of the start time
ReplStartmm
iMinute of the start time
ReplEndYYYY
iYear of the stop time
ReplEndMM
iMonth of the stop time
ReplEndDD
iDay of the stop time
ReplEndhh
iHour of the stop time
ReplEndmm
iMinute of the stop time
TIMING BLOCK
Simulation Settings for the TIMING BLOCK 
Name Description Caveats Units Default Value or Actual Value Valid Min Valid Max
MaxHalfStep
The maximum half time step (in seconds) that RAM will take, regardless of other factors
100.0
MinHalfStep
The minimum half time step (in seconds) that RAM will take, regardless of other factors
0.2
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
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
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
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 Description Caveats Units Default Value or Actual Value Valid Min Valid Max
NameBoundPlasma
Determines the boundary flux source
Statistical model of flux boundary following Denton et al., 2015" (https://doi.org/10.1002/2015SW001168) LANL
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
Determines the distribution of the flux at the boundary (MAXW)

MAXW: Maxwellian
MAXW
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
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 Description Caveats Units Default Value or Actual Value Valid Min Valid Max
nR
Number of radial grid points used in RAM
20
nT
Number of toroidal/local time grid points (25 default; 49 preferred)
49
nE
Number of energy bins used
35
nPa
Number of pitch angle bins used
72
PlasmasphereModel
Transport model name: Carpenter, Transport
Carpenter
RefillingTau
Refilling model name: Fixed, Analytic, Rasmussen
Analytic
UseCoulomb
If True, use Coulomb collisions
False
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 Description Caveats Units Default Value or Actual Value Valid Min Valid Max
ConvergenceDistance
Minimum accuracy that needs to be reached regardless of other factors (between 0 and 1)
0.9 0 1
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
Minimum number of outer SOR Iterations performed by SCB
1
SCBMethod
Which inner SCB method to use (1 = Direct Matrix Inversion, 2 = SOR Iterations, 3 = No SCB)
2
OuterMethod
Which outer SCB method to use (1 = Picard Iteration, 2 = Newton Method)
1
InnerConvergenceAlpha
Convergence criteria for the Alpha residual
1E-10
InnerConvergencePsi
Convergence Criteria for the Psi residual
1E-8
nTheta
Number of theta (polar) grid points used in SCB
71
nPsi
Number of psi (radial) surfaces used in SCB
45
nZeta
Number of zeta (azimuthal) surfaces used in SCB 
73
Isotropic
Whether to use isotropic pressure mappings in SCB (does not affect RAM)
False
ReduceAnisotropy
Whether to change the anisotropy to a marginally mirror-stable
False
BetaExtrapolation
Whether to extrapolate Beta Euler potential values to the outside boundary or use the previous point (Currently unused)
True
AzimuthalOffset
Whether to set equidistance at most problematic time (if T) or keep it at midnight (if F)
False
EmptyLossCone
Whether to use a filled loss cone (if F) or a more realistic empty loss cone using M. Liemohn's 2004
False
AdaptiveMesh
Whether to use Mesh refinement in magnetic flux, so that one has equidistant magnetic flux surfaces
True
SORDetail
Whether to compute extra Successive Over Relaxation information
False
EnergyDetail
Whether to compute DPS Dst and other energy information
True
ForceBalanceDetail
Whether to compute global force balance before and after SCB runs, this will cause additional output
False
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 Description Caveats Units Default Value or Actual Value Valid Min Valid Max
NameOmniFile
Name of the omni input file (needed if using the WESC, W5SC, or RSCE electric fields)
omni.txt
UseSWMFFormat
Whether the omni file is in the SWMF format or the older RAM format
False
NameIndicesFile
Name of the KP and F10.7 indices file needed for RAM (included in default installation)
RamIndices.txt
BoundaryPath
Location where the flux boundary files can be found (needed by RAM)
IM/input_ram/
QinDentonPath
Location where the QinDenton files can be found (Used for the recent Tsyganenko magnetic field models)
IM/input_scb/
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 Description Caveats Units Default Value or Actual Value Valid Min Valid Max
DtSaveRestart
How often a restart file should be written (in seconds), -1.0 will disable restart files
3600.0
DoSaveFinalRestart
Whether a restart file should be written on RAM finishing
True
TimedRestartFiles
Whether to time stamp the restart files. If F only one restart file will be made and it will be overwritten
False
DtLogFileWrite
How often the log file should be appended (in seconds)
60.0
DtPressureFileWrite
How often RAM equatorial pressures should be written (in seconds)
300.0
DthIFileWrite
How often SCB hI files should be written (in seconds)
3600.0
DtEFieldFileWrite
How often electric field files should be written
3600.0
DtMAGxyzFileWrite
How often x, y, and z from SCB should be written
3600.0
DoSaveFlux
Output frequency [s] for writing RAM flux files (-1 turns output off)
300.0
DoDump3DFlux
Whether SCB 3D flux files should be written or not (currently outputs 3D flux every hour)
False

Run Access Information :

Keyword(s) :

geomagmetic storms

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