advanced

[Back to the Index]

Setting up the Run Script

The GSI run script dtc/run/run_gsi_regional.ksh, which is provided with the source code, must be customized to the local environment. These changes include things such as the analysis time and date, the path to files, and MPI specific information, which are necessary for running all of the basic tutorial cases.

For this tutorial, start by copying the original run script to a working copy
cd ${PATH}/comGSIv3.6_EnKFv1.2/dtc/run/
cp run_gsi_regional.ksh run_gsi_regional.ksh_basic
This will be used as the template for all the later scripts used in the regional practice.

Make the following modifications to the script run_gsi_regional.ksh_basic

• Set the variable GSIPROC to 4
• Set the variable ARCH to LINUX_LSF, as an example value appropriate for Linux with LSF.
• In the case set up section of the script, set the environment variables to values appropriate for your environment on your machine. For example:
• ANAL_TIME=2017051312
• HH=`echo $ANAL_TIME | cut -c9-10`
• WORK_ROOT=${PATH}/comGSIv3.6_EnKFv1.2/run/arw_${ANAL_TIME}
• OBS_ROOT=${DATA_ROOT}/data/${ANAL_TIME}/obs
• PREPBUFR=${OBS_ROOT}/nam.t${HH}z.prepbufr.tm00.nr
• BK_ROOT=${DATA_ROOT}/data/${ANAL_TIME}/arw_45km
• BK_FILE=/${BK_ROOT}/wrfinput_d01.2017051312
• CRTM_ROOT=${PATH_CRTM}/CRTM_2.2.3
• GSI_ROOT=${PATH}/comGSIv3.6_EnKFv1.2
• FIX_ROOT=${GSI_ROOT}/fix
• GSI_EXE=${GSI_ROOT}/dtc/run/gsi.exe
• GSI_NAMELIST=${GSI_ROOT}/dtc/run/comgsi_namelist.sh
This example is only for ARW core background files.


• On top of the scripts, add an appropriate batch script. For example on Yellowstone:

#BSUB -P PXXXXXXXX           # project code
#BSUB -W 00:15                 # wall-clock time (hrs:mins)
#BSUB -n 4                   # number of tasks in job         
#BSUB -R "span[ptile=16]"      # run 16 MPI tasks per node
#BSUB -J gsi                   # job name
#BSUB -o gsi.%J.out          # output file name 
#BSUB -e gsi.%J.err          # error file name 
#BSUB -q regular             # queue



• Still in case set up setion, leave the following settings as default:

  if_hybrid=No     # Yes, or, No -- case sensitive !
  if_4DEnVar=No    # Yes, or, No -- case sensitive (if_hybrid must be Yes)!
  if_observer=No   # Yes, or, No -- case sensitive !

  bk_core=ARW
  bkcv_option=NAM
  if_clean=clean



• Search Section # Link to the radiance data, look for the list of observations and comment the links to the BUFR file under this section:
# ln -s ${srcobsfile[$ii]} ${gsiobsfile[$ii]}