Data Ice Model

Modes

The default science mode of the data model is the COPYALL mode. COPYALL mode will examine the fields found in all input data streams, if any input field names match the field names used internally, they are copied into the export array and passed directly to the coupler without any special user code. There are several other scientific modes supported by the model, they are listed below. The mode is selected by a character string set in the strdata namelist variable dataMode.

dataMode = "NULL"

NULL mode turns off the data model as a provider of data to the coupler. The ice_present flag will be set to false and the coupler will assume no exchange of data to or from the data model.

dataMode = "COPYALL"

COPYALL mode copies all fields directly from the input data streams Any required fields not found on an input stream will be set to zero.

dataMode = "SSTDATA"

SSTDATA is a prognostic mode. It requires data be sent to the ice model. Ice fraction (extent) data is read from an input stream, atmosphere state variables are received from the coupler, and then an atmosphere-ice surface flux is computed and sent to the coupler. It is called "SSTDATA" mode because normally the ice fraction data is found in the same data files that provide SST data to the data ocean model. They are normally found in the same file because the SST and ice fraction data are derived from the same observational data sets and are consistent with each other.

Namelist

The data ice specific namelist input is as follows. The namelist input filename is hardwired in the data model code to "dice_in". The namelist group is called "dice_nml". The variable formats are character string (char), integer (int), double precision real (r8), or logical (log) or one dimensional arrays of any of those things (array of ...).

ice_in (char)

sets the filename for the data ice strdata namelist. this must be set. default='unset'.

decomp (char)

set the decomposition option for the data model. valid options are placing the global array on the root task or a simple stride-one load balanced one-dimensional decomposition. other decompositions may be added in the future. valid values are ['root','1d']. default='1d'.

flux_swpf (r8)

this is the shortwave penetration factor as a fraction where 1.0 is 100% penetration. used only in SSTDATA mode. default=0.0

flux_Qmin (r8)

this is the minimum bound on the melt rate in kg/s/m2. used only in SSTDATA mode. default=-300.0

flux_Qacc (log)

this logical activates the water accumulation associated with the ocean potential to melt ice. used only in SSTDATA mode. default=false.

flux_Qacc0 (r8)

this is the initial water accumulation value on a startup. used only in SSTDATA mode. default=0.0

restfilm (char)

restart filename for the data ice model data. this is optional. if this is unset, the restart filename will be read from the rpointer.ice file. default='unset'.

restfils (char)

restart filename for the data ice stream data. this is optional. if this is unset, the restart filename will be read from the rpointer.ice file. default='unset'.

The pre-defined internal field names in the data ice model are as follows. In general, the stream input file should translate the input variable names into these names for use within the data ice model.

Fields


     (/"to              ","s               ","uo              ","vo              ", &
       "dhdx            ","dhdy            ","q               ","z               ", &
       "ua              ","va              ","ptem            ","tbot            ", &
       "shum            ","dens            ","swndr           ","swvdr           ", &
       "swndf           ","swvdf           ","lwdn            ","rain            ", &
       "snow            ","t               ","tref            ","qref            ", &
       "ifrac           ","avsdr           ","anidr           ","avsdf           ", &
       "anidf           ","tauxa           ","tauya           ","lat             ", &
       "sen             ","lwup            ","evap            ","swnet           ", &
       "swpen           ","melth           ","meltw           ","salt            ", &
       "tauxo           ","tauyo           " /)