[Dart-dev] DART/branches Revision: 13032

[dart at ucar.edu]

raeder at ucar.edu
2019-03-19 17:14:18 -0600 (Tue, 19 Mar 2019)
150
This version was created by merging ../cesm2_0/setup_hybrid and ./setup_advanced.
It hasn't been reviewed or tested, but should be close to working.




Added: DART/branches/recam/models/cam-fv/shell_scripts/cesm2_1/setup_hybrid
===================================================================
--- DART/branches/recam/models/cam-fv/shell_scripts/cesm2_1/setup_hybrid	                        (rev 0)
+++ DART/branches/recam/models/cam-fv/shell_scripts/cesm2_1/setup_hybrid	2019-03-19 23:14:18 UTC (rev 13032)
@@ -0,0 +1,1215 @@
+#!/bin/csh -f
+#
+# DART software - Copyright UCAR. This open source software is provided
+# by UCAR, "as is", without charge, subject to all terms of use at
+# http://www.image.ucar.edu/DAReS/DART/DART_download
+#
+# DART $Id: setup_advanced 13024 2019-03-19 20:34:38Z raeder at ucar.edu $
+#
+# This script can be run interactively, but on some systems (e.g. cheyenne)
+# it takes longer than is allowed for an interactive job.
+# In that case, it can be run as a batch job using the directives below,
+# or using "qcmd -q share -l select=1 -- <thisfilename>".
+# The job name should be the name of this script(file), 
+# or this file may not be archived in $caseroot causing DART_config to fail.
+#--------------------------------------------
+#BSUB  -J setup_hybrid
+#BSUB  -n 1 
+#BSUB  -R "span[ptile=1]"
+#BSUB  -q shared_node_queue_for_this_setup_script
+#BSUB  -P your_account_there
+#BSUB  -W 2:00
+#BSUB  -u you at email.org
+#BSUB  -N  
+#BSUB  -a poe 
+#BSUB  -o Test0.bld1
+#BSUB  -e Test0.bld1
+#--------------------------------------------
+#PBS  -N setup_hybrid
+#PBS  -A your_account_there
+#PBS  -q shared_node_queue_for_this_setup_script
+#
+# Resources I want:
+#    select=#nodes
+#    ncpus=#CPUs/node
+#    mpiprocs=#MPI_tasks/node
+#PBS  -l select=1:ncpus=4:mpiprocs=4
+#PBS  -l walltime=01:00:00
+#PBS  -m ae
+#PBS  -M you at email.org
+# Send standard output and error to this file.
+# It's helpful to use the $casename here.
+#PBS  -o Test_0.bld1
+#PBS  -j oe 
+#
+# ---------------------
+# Purpose
+# ---------------------
+#
+# This script is designed to set up, stage, and build a multi-instance, 
+# multi-driver, CESM using an F compset, where CAM-FV, CLM and CICE are active. 
+# It sets up the environment for doing a CAM assimilation, but does not tell
+# CESM to setup or run the assimilation.  That is done by DART_config.
+# You are STRONGLY encouraged to run the multi-instance CESM a few times and
+# experiment with different settings BEFORE you try to assimilate observations.
+# The data volume is quite large and you should become comfortable using
+# CESM's restart capability to re-stage files in your RUN directory.
+#
+# Because the atmosphere assimilations typically occur every 6 hours,
+# the methodology here reflects that. All of CESM stops every 6 hours
+# so that a CAM output file will be available for assimilation.
+#
+# ${caseroot}/DART_config must be run as a step that's separate from this script.
+# It will augment the CESM case with the required setup and configuration 
+# to use DART to perform an assimilation. 
+#
+# ---------------------
+# How to use this script.
+# ---------------------
+#
+# -- You will have to read and understand the script in its entirety.
+#    You will have to modify things outside this script.
+#    Instructions for what to change to use the CAM-Chem or WACCM are
+#    outlined in the models/cam-fv/model_mod.html documentation.
+#
+# -- Examine the whole script to identify things to change for your experiments.
+#
+# -- Edit this script in the $DART/models/cam-fv/shell_scripts directory
+#    or copy it and its dependent scripts to somewhere where it will be preserved.
+#    It archives itself to the $caseroot directory during its execution.
+#
+# -- Locate or create the initial ensemble files that CESM will need.
+#    The initial ensemble can come from a single- or multi-instance reference case.
+#
+# -- DOCN: The compsets required by this script use a single data ocean.
+#
+# -- Run this script. When it is executed, it will create:
+#    1) a CESM 'CASE' ($caseroot) directory, where the model will be built,
+#    2) a run directory, where each forecast + assimilation cycle will take place,
+#    3) a bld directory for the executables.
+#    4) CESM's short term archiver (st_archive) will use a fourth directory for
+#    storage of model output until it can be moved to long term storage (HPSS)
+#
+# -- Confirm the variable values in $caseroot/env_{build,run,batch,...}.xml.
+#
+# -- (if running DART) Edit the DART input.nml that appears in the ${caseroot}
+#    directory to replace default values with your preferred values.