1.5.5. Spinup of CLM5.0-BGC-Crop¶

To get the CLM5.0-BGC model to a steady state, you first run it from arbitrary initial conditions using the “accelerated decomposition spinup” (-bgc_spinup on in CLM configure, see example below) mode for about 200 simulation years. Figure 1.5.3 shows spinup behavior for an 1850 BGC accelerated decomposition (AD) case using GSWP3 atmospheric forcing. Generally, the criteria that less than 3% of the land surface be in total ecosystem carbon disequilibrium takes the longest to satisfy due to slow soil carbon (TOTSOMC) turnover times in the Arctic.

Figure 1.5.3 BGC AD spinup plot for a year 1850 case with GSWP3 atmospheric forcing. Variables examined are TOTECOSYSC (total ecosystem carbon), TOTSOMC (total soil organic matter carbon), TOTVEGC (total vegetation carbon), TLAI (total leaf area index), GPP (gross primary production) and TWS (total water storage). Generated using …/tools/contrib/SpinupStability.ncl.¶

After this you branch from this mode in the “final spinup” (-bgc_spinup off in CLM configure, see example below), and run for several hundred simulation years. Figure 1.5.4 shows spinup behavior for an 1850 BGC post accelerated decomposition (pAD) case using GSWP3 atmospheric forcing. As before, the criteria that less than 3% of the land surface be in total ecosystem carbon disequilibrium takes the longest to satisfy. It can be difficult to meet this strict criteria in less than 1000 years and users may want to relax this criteria depending on their application.

Figure 1.5.4 BGC pAD spinup plot for a year 1850 case with GSWP3 atmospheric forcing and initialization from the end of the BGC AD spinup case. Variables examined are TOTECOSYSC (total ecosystem carbon), TOTSOMC (total soil organic matter carbon), TOTVEGC (total vegetation carbon), TLAI (total leaf area index), GPP (gross primary production) and TWS (total water storage). Generated using …/tools/contrib/SpinupStability.ncl.¶

You can also start from a default initial file that is setup as part of the selected compset. Figure 1.5.5 shows spinup behavior for an 1850 pAD BGC case that loops over one year of coupler history output for atmospheric forcing (generated from the fully coupled model), initialized with a BGC initial file generated from a GSWP3 atmospheric forcing case. Note that it takes about 10 years for variables such as TLAI (total leaf area index), GPP (gross primary production), and TWS (total water storage) to reach a specified equilibrium state (denoted by the dotted lines) due to the different atmospheric forcing.

Figure 1.5.5 BGC initialized spinup plot for year 1850. Variables examined are TOTECOSYSC (total ecosystem carbon), TOTSOMC (total soil organic matter carbon), TOTVEGC (total vegetation carbon), TLAI (total leaf area index), GPP (gross primary production) and TWS (total water storage). Generated using …/tools/contrib/SpinupStability.ncl.¶

Figure 1.5.6 shows spinup behavior for the same case but also changes CO2 to present-day conditions (379ppmv). Again, it takes about 10 years to reach equilibrium for TLAI, GPP, and TWS.

Figure 1.5.6 BGC initialized spinup plot for year 2000 CO2. Variables examined are TOTECOSYSC (total ecosystem carbon), TOTSOMC (total soil organic matter carbon), TOTVEGC (total vegetation carbon), TLAI (total leaf area index), GPP (gross primary production) and TWS (total water storage). Generated using …/tools/contrib/SpinupStability.ncl.¶

If you use the default initial file and you signficantly change model behavior or atmospheric forcing, and you are concerned about the carbon equilibrium (e.g., TOTECOSYSC, TOTSOMC, TOTVEGC), particularly at high latitudes, then we recommend you put the model back into AD mode to reach a new equilibrium. In this configuration, this will also automatically reseed “dead” plant functional types in the initial file with a bit of leaf carbon to give those plant functional types another chance to grow under the new atmospheric forcing or model conditions.

1. 50_AD_SPINUP: For the first step of running 200+ years in “-bgc_spinup on” mode, you will setup a case, and then edit the values in env_build.xml and env_run.xml so that the right configuration is turned on and the simulation is setup to run for the required length of simulation time. So do the following:

1.5.5.1. Example:: AD_SPINUP Simulation for CLM5.0-BGC¶

> cd scripts
> ./create_newcase -case BGC_spinup -res f19_g17_gl4 -compset I1850Clm50BgcCropCru
> cd BGC_spinup
# Change accelerated spinup mode
> ./xmlchange CLM_ACCELERATED_SPINUP="on"
# Now setup
> ./case.setup -case
# Now build
> ./case.build
# The following sets RESUBMIT to 3 times in env_run.xml (you could also use an editor)
# The following sets STOP_DATE,STOP_N and STOP_OPTION to Jan/1/0201, 20, "nyears" in env_run.xml (you could also use an       editor)
> ./xmlchange RESUBMIT=3,STOP_N=50,STOP_OPTION=nyears,STOP_DATE=02010101
# Now run normally
> ./case.submit

Note

This same procedure works for CLM5.0-CN as well.

Afterwards save the last restart file from this simulation to use in the next step.

2. Final spinup for |version|-BGC: Next save the last restart file from this step and use it as the “finidat” file to use for one more spinup for at least 400+ years in normal mode. So do the following:

1.5.5.2. Example: Final CLMBGC Spinup Simulation for CLM5.0-BGC¶

> cd scripts
> ./create_newcase -case BGC_finalspinup -res f19_g17_gl4 -compset I1850Clm50BgcCropCru
> cd BGC_finalspinup
# Now, Copy the last CLM restart file from the earlier case into your run directory
> cp /ptmp/$LOGIN/archive/BGC_spinup/rest/BGC_spinup.clm*.r*.0201-01-01-00000.nc \
/glade/scratch/$LOGIN/CN_finalspinup
# Set the runtype to startup
> ./xmlchange RUN_TYPE=startup
# And copy the rpointer files for datm and drv from the earlier case
> cp /glade/scratch/$LOGIN/archive/BGC_spinup/rest/rpointer.atm /ptmp/$LOGIN/CN_finalspinup
> cp /glade/scratch/$LOGIN/archive/BGC_spinup/rest/rpointer.drv /ptmp/$LOGIN/CN_finalspinup
# Set the finidat file to the last restart file saved in previous step
> echo ' finidat = "BGC_spinup.clm2.r.0201-01-01-00000.nc"' > user_nl_clm
# Now setup
> ./case.setup
> Now build
> ./case.build
# The following sets RESUBMIT to 7 times in env_run.xml (you could also use an editor)
# The following sets STOP_N and STOP_OPTION to 50 and "nyears" in env_run.xml (you could also use an editor)
> ./xmlchange RESUBMIT=7,STOP_OPTION=nyears,STOP_N=50
> Now run as normal
> ./case.submit

To assess if the model is spunup, plot trends for CLMBGC variables of interest using …/tools/contrib/SpinupStability.ncl. If you don’t meet the equilibrium criteria, you may need to run the simulation longer. Finally save the restart file from the end of this simulation to use as an “finidat” file for future simulations.

Note

This same final spinup procedure works for CLM5.0-CN as well.