VIC Model State File
The model state file contains all information needed by the VIC model to "warm"-start a simulation (i.e. start from "realistic" conditions, or re-start a simulation exactly where the model previously stopped). To read an initial state file, or to save a "final" state file, the appropriate options should be set in the global parameter file.
The state file has two header lines used by the VIC model to verify that the model is set-up correctly. Following the header there are repeating blocks of lines which define all variables for each grid cell. Each block starts with a line defining variables held constant across the grid cell and is then followed by lines for all vegetation types (including bare soil) and all snow bands [ (number of vegetation types) * (number of snow bands) = (number of lines) ].
File Header
The file header appears once at the top of the state file and is used by the VIC model to verify the parameters initialized with the model control file match those for the data stored in the state file. An error is reported if the model state file cannot be used to initialize the current state.
Define date of state file, always saved at hour 0 of the defined day.
| Column | Name | Type | Description |
|---|---|---|---|
| 1 | STATEYEAR | int | Year of the model state file |
| 2 | STATEMONTH | int | Month of the model state file |
| 3 | STATEDAY | int | Day of the model state file |
Define global soil limits.
| Column | Name | Type | Description |
|---|---|---|---|
| 1 | Nlayer | int | Number of soil moisture layers |
| 2 | Nnodes | int | Number of soil thermal nodes |
Grid Cell Information
This line is used to define the parameters that are constant for the entire grid cell. It first appears after the file header lines and must be defined for each grid cell.
| Column | Name | Type | Description |
|---|---|---|---|
| 1 | cellnum | int | Current cell number |
| 2 | Nveg | int | Number of vegetation types in the grid cell |
| 3 | Nbands | int | Number of snow elevation bands in the grid cell |
| 4:(3+Nnodes) | node_depth | double | Depth from surface of each soil thermal node (first node should have a depth of 0m indicating it is at the surface) [m] |
Vegetation and Snow Band Information
Each grid cell information line must be followed with lines for all defined vegetation types (plus bare soil) and snow bands ( [Nveg+1]*Nbands = number of lines required ). These lines contain information about the storage of moisture within each fractional coverage type. If the model is being run with distributed precipitation, the wet and dry fractions are averaged before the model state is stored and the model is always initialized with a mu value of 1.
| Column | Name | Type | Description |
|---|---|---|---|
| 1 | veg | int | Current vegetation number as defined in the vegetation parameter file |
| 2 | band | int | Current snow band number |
| 3:(2+Nlayer) | moist | double | Soil layer total moisture contents including ice [mm] |
| (3+Nlayer):(2+2*Nlayer) | ice | double | Soil layer ice contents [mm] |
| (3+2*Nlayer) | Wdew | double | Amount of dew stored in the vegetation [mm]. Not defined for bare soil (veg = Nveg) |
| (5+2*Nlayer) | last_snow | int | Number of model time steps since the last new snow |
| (6+2*Nlayer) | swq | double | Snow water equivalence of the pack [m] |
| (7+2*Nlayer) | surf_temp | double | Temperature of the surface layer in the snow algorithm [C] |
| (8+2*Nlayer) | pack_temp | double | Temperature of the pack layer in the snow algorithm [C] |
| (9+2*Nlayer) | density | double | Density of the snowpack [kg/m^3] |
| (10+2*Nlayer) | snow_canopy | double | Snow water equivalence stored in the canopy [m] |
| (11+2*Nlayer):(10+2*Nlayer+Nnodes) | node_T | double | Soil temperature at each of the defined soil thermal nodes [C] |
State File Example
1 1 1982 4.0 9 5 1 0.000000 0 0 21.285264 193.113374 252.354681 0.000000 0.000000 0.000000 0.000000 1 0.012185 -18.562476 0.000000 107.723657 0.002342 -19.725207 1 0 21.873448 197.918803 204.298588 0.000000 0.000000 0.000000 0.000000 1 0.013370 -18.427709 0.000000 107.213299 0.000068 -19.725207 2 0 21.870789 197.703515 224.700744 0.000000 0.000000 0.000000 0.000000 1 0.013376 -18.427161 0.000000 107.210595 0.000063 -19.725207 3 0 21.824034 197.831291 4.0.878914 0.000000 0.000000 0.000000 0.000000 1 0.013297 -18.4.04.0 0.000000 107.214583 0.000131 -19.725207 4 0 19.588509 192.486650 390.409978 0.000000 0.000000 0.000000 0.000000 1 0.037829 -21.473858 0.000000 153.277523 0.000000 -19.725207 5 0 51.4.0.44.050.686642 350.686642 0.000000 0.000000 0.000000 0 0.000000 0.000000 0.000000 0.000000 0.000000 -5.3284.0 10 4 1 0.000000 0 0 23.430641 212.753814 260.289250 0.000000 0.000000 0.000000 0.000000 1 0.013546 -14.202011 0.000000 126.703299 0.002015 -14.609811 1 0 24.120355 217.082184 211.105389 0.000000 0.000000 0.000000 0.000000 1 0.014416 -14.167790 0.000000 122.955238 0.000069 -14.609811 2 0 24.059755 216.550676 220.595024 0.000000 0.000000 0.000000 0.000000 1 0.014681 -14.158938 0.000000 124.062009 0.000099 -14.609811 3 0 24.034808 216.922242 391.452744 0.000000 0.000000 0.000000 0.000000 1 0.014734 -14.157207 0.000000 124.059177 0.000123 -14.609811 4 0 54.008259 350.365348 350.365348 0.000000 0.000000 0.000000 0 0.000000 0.000000 0.000000 0.000000 0.000000 -5.683898 19 7 1 0.000000 0 0 20.214828 185.120403 206.516047 0.000000 0.000000 0.000000 0.000000 1 0.010059 -17.807799 0.000000 110.707686 0.002234 -18.711561 1 0 20.432036 188.248786 181.206443 0.000000 0.000000 0.000000 0.000000 1 0.013261 -17.503422 0.000000 116.4.0185 0.000070 -18.711561 2 0 20.433678 188.189080 192.524492 0.000000 0.000000 0.000000 0.000000 1 0.013254 -17.504026 0.000000 116.437187 0.000073 -18.711561 3 0 20.433560 188.4.0071 355.819606 0.000000 0.000000 0.000000 0.000000 1 0.013151 -17.513156 0.000000 116.369238 0.000131 -18.711561 4 0 19.456346 184.955761 318.807792 0.000000 0.000000 0.000000 0.000000 1 0.033564 -19.907285 0.000000 156.971625 0.000000 -18.711561 5 0 19.460851 185.151952 369.413725 0.000000 0.000000 0.000000 0.000000 1 0.033564 -19.907285 0.000000 156.971625 0.000000 -18.711561 6 0 19.451042 184.213071 264.058949 0.000000 0.000000 0.000000 0.000000 1 0.033564 -19.907285 0.000000 156.971625 0.000000 -18.711561 7 0 45.348215 350.618846 350.618846 0.000000 0.000000 0.000000 0 0.000000 0.000000 0.000000 0.000000 0.000000 -5.526894 20 6 1 0.000000 0 0 22.758132 211.496250 244.064055 0.000000 0.000000 0.000000 0.000000 1 0.008507 -15.335427 0.000000 112.959607 0.002015 -15.761449 1 0 23.197413 214.885508 208.301805 0.000000 0.000000 0.000000 0.000000 1 0.010971 -15.217340 0.000000 116.317659 0.000081 -15.761449 2 0 23.1714.0 214.049029 213.825804 0.000000 0.000000 0.000000 0.000000 1 0.010981 -15.216973 0.000000 116.564704 0.000107 -15.761449 3 0 23.164421 215.068909 366.380422 0.000000 0.000000 0.000000 0.000000 1 0.010936 -15.219035 0.000000 116.582015 0.000127 -15.761449 4 0 21.880041 210.543592 340.453887 0.000000 0.000000 0.000000 0.000000 1 0.036089 -17.640088 0.000000 171.009493 0.000000 -15.761449 5 0 21.876418 208.359871 291.759621 0.000000 0.000000 0.000000 0.000000 1 0.036089 -17.640088 0.000000 171.009493 0.000000 -15.761449 6 0 48.658702 350.486734.050.486733 0.000000 0.000000 0.000000 0 0.000000 0.000000 0.000000 0.000000 0.000000 -5.44.0.4 28 7 1 0.000000 0 0 20.683400 186.522758 203.281090 0.000000 0.000000 0.000000 0.000000 1 0.002676 -15.427978 0.000000 113.986028 0.000977 -15.701926 1 0 21.497618 189.503813 176.733679 0.000000 0.000000 0.000000 0.000000 1 0.003183 -15.378719 0.000000 115.184488 0.000082 -15.701926 2 0 21.470744 189.585487 186.952953 0.000000 0.000000 0.000000 0.000000 1 0.003212 -15.376816 0.000000 116.289337 0.000092 -15.701926 3 0 21.426858 190.078755 345.292314 0.000000 0.000000 0.000000 0.000000 1 0.003226 -15.376864 0.000000 118.056031 0.000109 -15.701926 4 0 19.4.0194 183.832519 318.788940 0.000000 0.000000 0.000000 0.000000 1 0.030843 -16.758789 0.000000 202.714.08 0.000000 -15.701926 5 0 19.466724 184.085378 362.605936 0.000000 0.000000 0.000000 0.000000 1 0.030843 -16.758789 0.000000 202.714.08 0.000000 -15.701926 6 0 19.476562 183.642332 267.591371 0.000000 0.000000 0.000000 0.000000 1 0.030612 -16.775320 0.000000 202.191174 0.000000 -15.701926 7 0 43.721935 350.486844 350.486844 0.000000 0.000000 0.000000 0 0.000000 0.000000 0.000000 0.000000 0.000000 -3.831211
VIC Administrator Last modified: Wed Aug 19 13:42:55 PDT 2009