diff --git a/_sources/users_guide/building-a-case.txt b/_sources/users_guide/building-a-case.txt index e302fd96157..005390453b6 100644 --- a/_sources/users_guide/building-a-case.txt +++ b/_sources/users_guide/building-a-case.txt @@ -4,7 +4,7 @@ Building a Case ****************** -The following summarizes details of building the model executable. +The following describes the process of building the model executable. .. _building-the-model: @@ -17,14 +17,12 @@ After calling **case.setup**, run **case.build** to build the model executable. 1. Create the component namelists in ``$RUNDIR`` and ``$CASEROOT/CaseDocs``. 2. Create the necessary compiled libraries ``mct``, ``pio``, ``gptl`` and ``csm_share``. The libraries will be placed in a path below ``$SHAREDLIBROOT``. -3. Create the necessary component compiled libraries. - These will be placed in ``$EXEROOT/bld/lib``. -4. Create the model executable (``$MODEL.exe``), which will be placed in ``$EXEROOT``. +3. Create the necessary compiled libraries. These are be placed in ``$EXEROOT/bld/lib``. +4. Create the model executable (``$MODEL.exe``), which is placed in ``$EXEROOT``. You do not need to change the default build settings to create the executable, but it is useful to become familiar with them in order to make optimal use of the system. The CIME scripts provide you with a great deal of flexibility in customizing the build process. -The **env_build.xml** variables control various aspects of building the model executable. -Most of the variables should not be modified, but users can modify these: +The **env_build.xml** variables control various aspects of building the executable. Most of the variables should not be modified, but users can modify these: - ``$BUILD_THREADED`` @@ -32,10 +30,10 @@ Most of the variables should not be modified, but users can modify these: - ``$GMAKE_J`` -The best way to determine what xml variables are in your ``$CASEROOT`` directory is to use the ``xmlquery`` command. For usage information, run: +The best way to see what xml variables are in your ``$CASEROOT`` directory is to use the **xmlquery** command. For usage information, run: :: - ./xmlquery --help + > ./xmlquery --help To build the model, change to your ``$CASEROOT`` directory and execute **case.build**. :: @@ -43,25 +41,23 @@ To build the model, change to your ``$CASEROOT`` directory and execute **case.bu > cd $CASEROOT > ./case.build -Diagnostic comments will appear as the build proceeds. +Diagnostic comments appear as the build proceeds. -The **case.build** command generates the utility and component libraries and the model executable, and it generates build logs for each component. Each build log file is date stamped, and a pointer to the build log file for that library or component is shown. - -The build log files have names in this form: **$component.bldlog.$datestamp**. They are located in ``$BLDDIR``. If they are compressed (as indicated by a .gz file extension), then the build ran successfully. +The **case.build** command generates the utility and component libraries and the model executable, and it generates build logs for each component. Each log file is named form: **$component.bldlog.$datestamp**. They are located in ``$BLDDIR``. If they are compressed (as indicated by a .gz file extension), the build ran successfully. Invoking **case.build** creates the following directory structure in ``$EXEROOT`` if the Intel compiler is used: :: atm/, cpl/, esp/, glc/, ice/, intel/, lib/, lnd/, ocn/, rof/, wav/ -Except for **intel/** and **lib/**, each of those directories contains an **obj/** directory for the compiled object files for the target model component. +Except for **intel/** and **lib/**, each directory contains an **obj/** subdirectory for the target model component's compiled object files. -The ``mct``, ``pio``, ``gptl`` and ``csm_share`` libraries are placed in a directory tree that reflects their dependencies. See the **bldlog** for a given component to locate the library. +The *mct*, *pio*, *gptl* and *csm_share* libraries are placed in a directory tree that reflects their dependencies. See the **bldlog** for a given component to locate the library. -Special **include** modules are also placed in **lib/include**. The model executable (for example, **cesm.exe** or **acme.exe**) is placed directly in ``$EXEROOT``. +Special **include** modules are placed in **lib/include**. The model executable (**cesm.exe** or **acme.exe**, for example) is placed directly in ``$EXEROOT``. -Component namelists, component logs, output datasets, and restart files are placed in ``$RUNDIR``. -It is important to note that ``$RUNDIR`` and ``$EXEROOT`` are independent variables that are set as ``$CASEROOT/env_run.xml``. +Component namelists, component logs, output data sets, and restart files are placed in ``$RUNDIR``. +It is important to note that ``$RUNDIR`` and ``$EXEROOT`` are independent variables that are set in the **$CASEROOT/env_run.xml** file. .. _rebuilding-the-model: @@ -71,7 +67,7 @@ Rebuilding the model Rebuild the model under the following circumstances: -If either **env_build.xml** or **Macros.make** has been modified, and/or if code is added to ``SourceMods/src.*``, then it's safest to clean the build and rebuild from scratch as shown here: +If either **env_build.xml** or **Macros.make** has been modified, and/or if code is added to **SourceMods/src.**, it's safest to clean the build and rebuild from scratch as shown here: :: > cd $CASEROOT @@ -83,29 +79,41 @@ If you have ONLY modified the PE layout in **env_mach_pes.xml**, a clean may not > cd $CASEROOT > ./case.build -If the threading has been turned on or off in any component relative to the previous build, the build script should fail with the following error and suggestion that the model be rebuilt from scratch: +If the threading has been changed (turned on or off) in any component since the previous build, the build script should fail with the following error and suggestion that the model be rebuilt from scratch: :: ERROR SMP STATUS HAS CHANGED SMP_BUILD = a0l0i0o0g0c0 SMP_VALUE = a1l0i0o0g0c0 - A manual clean of your obj directories is strongly recommended + A manual clean of your obj directories is strongly recommended. You should execute the following: ./case.build --clean ./case.build ---- OR ---- - You can override this error message at your own risk by executing + You can override this error message at your own risk by executing: ./xmlchange SMP_BUILD=0 - Then rerun the build script interactively + Then rerun the build script interactively. If there is any doubt, rebuild. -The **case.build --clean** command will clean all of the model components but not support libraries such as ``mct`` and ``gptl``. -Use **case.build --clean-all** to clean everything associated with the build. +Run this to clean all of the model components (except for support libraries such as *mct* and *gptl*): + :: + + > case.build --clean + +Run this to clean everything associated with the build: + :: + + > case.build --clean-all -You can also clean an individual component using **case.build --clean compname**, where "compname" is the name of the component you want to clean (for example, atm, clm, pio and so on). Run **case.build --help** for details. +You can also clean an individual component as shown here, where "compname" is the name of the component you want to clean (for example, atm, clm, pio and so on). + :: + + > case.build --clean compname + +Review the **help** text for more information. .. _inputdata: @@ -115,19 +123,22 @@ Input data All active components and data components use input data sets. In order to run CIME and the CIME-compliant active components, a local disk needs the directory tree that is specified by the xml variable ``$DIN_LOC_ROOT`` to be populated with input data. -Input data is provided as part of the CIME release via data from a subversion input data server. It is downloaded from the server on an as-needed basis determined by the case. Data may already exist in the default local file system's input data area as specified by ``$DIN_LOC_ROOT``. (See below.) +Input data is provided as part of the CIME release via data from a subversion input data server. It is downloaded from the server on an as-needed basis determined by the case. Data may already exist in the default local file system's input data area as specified by ``$DIN_LOC_ROOT``. Input data can occupy significant space on a system, so users should share a common ``$DIN_LOC_ROOT`` directory on each system if possible. The build process handles input data as follows: -- The ``buildnml`` scripts in the various component ``cime_config`` directories create listings of required component input data sets in the ``Buildconf/$component.input_data_list`` files. +- The **buildnml** scripts in the various component **cime_config** directories create listings of required component input data sets in the **Buildconf/$component.input_data_list** files. - **check_input_data**, which is called by **case.build**, checks for the presence of the required input data files in the root directory ``$DIN_LOC_ROOT``. - If all required data sets are found on the local disk, the build can proceed. -- If any of the required input data sets are not found locally, the files that are missing will be listed. At this point, you must obtain the required data from the input data server using **check_input_data** with the **-export** option. +- If any of the required input data sets are not found locally, the files that are missing are listed. At this point, you must obtain the required data from the input data server with **check_input_data** as shown here: + :: + + check_input_data --export The **env_run.xml** variables ``$DIN_LOC_ROOT`` and ``$DIN_LOC_ROOT_CLMFORC`` determine where you should expect input data to reside on a local disk. diff --git a/_sources/users_guide/case-basics.txt b/_sources/users_guide/case-basics.txt index befb0a11e8d..0f831a446c1 100644 --- a/_sources/users_guide/case-basics.txt +++ b/_sources/users_guide/case-basics.txt @@ -8,13 +8,13 @@ Two concepts to understand before working with CIME are component sets and model - *Component sets*, which are usually referred to as "compsets," define both individual model components and any component-specific namelist or configuration settings that are used in a case. -- *Model grids* specify the grid or resolution for each component making up the model. +- *Model grids* specify the grid or resolution for each component of the model. Creating a CIME experiment or *case* requires, at a minimum, specifying a compset and a model grid. -Out-of-the-box compsets and models grids are associated with two names: a longname and an alias name. Examples of both follow. +Out-of-the-box compsets and models grids each have two names: a *longname* and an *alias* name. Examples of both follow. -The CIME regression test system requires aliases, but aliases can also be used for convenience. Compset aliases are unique; each compset alias is associated with one and only one compset. Grid aliases, on the other hand, are overloaded; the same grid alias may result in a different grid depending on the associated compset. Always confirm that the *compset longname* and the *grid longname* are correct when using aliases to create a case. +The CIME regression test system requires aliases, but aliases can also be used for convenience. *Compset aliases* are unique; each is associated with one and only one compset. *Grid aliases*, on the other hand, are overloaded; the same grid alias may result in a different grid depending on the associated compset. Always confirm that the *compset longname* and the *grid longname* are correct when using aliases to create a case. ================ Component sets @@ -24,6 +24,8 @@ A compset longname has this form:: TIME_ATM[%phys]_LND[%phys]_ICE[%phys]_OCN[%phys]_ROF[%phys]_GLC[%phys]_WAV[%phys]_ESP[_BGC%phys] +Here are the supported values for each element of the longname:: + TIME = model time period (e.g. 1850, 2000, 20TR, RCP8...) CIME supports the following values for ATM,LND,ICE,OCN,ROF,GLC,WAV and ESP. @@ -59,15 +61,14 @@ A compset longname has this form:: The OPTIONAL %phys attributes specify sub-modes of the given system. For example, DOCN%DOM is the DOCN data ocean (rather than slab-ocean) mode. ALL the possible %phys choices for each component are listed by - calling **manage_case** with the **-list** compsets argument. + calling manage_case with the -list compsets argument. ALL data models have a %phys option that corresponds to the data model mode. -As an example, the CESM compset longname (below) refers to running a pre-industrial control with active CESM components CAM, CLM, CICE, POP2, MOSART, CISM2 and WW3 in a BDRD BGC coupling scenario.:: +As an example, this actual CESM compset longname refers to running a pre-industrial control with active CESM components CAM, CLM, CICE, POP2, MOSART, CISM2 and WW3 in a BDRD BGC coupling scenario:: 1850_CAM60_CLM50%BGC_CICE_POP2%ECO_MOSART_CISM2%NOEVOLVE_WW3_BGC%BDRD -The alias for this compset is B1850. Input to **create_newcase** can be either a compset longname or a compset alias. -It is also possible to create your own custom compset. See *How do I create my own compset?* in the FAQ. +The alias for this compset is B1850. Either a compset longname or a compset alias can be input to **create_newcase**. You can also create your own custom compset. See *How do I create my own compset?* in the FAQ. =============================== Model Grids @@ -77,6 +78,8 @@ A model grid longname has the form:: a%name_l%name_oi%name_r%name_m%mask_g%name_w%name +For reference:: + a% = atmosphere grid l% = land grid oi% = ocean/sea-ice grid (must be the same) @@ -94,18 +97,18 @@ A model grid longname has the form:: be identical to the land grid. The internal CISM grid can be different, however, and is specified by the g% value. -As an example, examine this longname:: +As an example, examine this actual grid longname:: a%ne30np4_l%ne30np4_oi%gx1v7_r%r05_m%gx1v7_g%null_w%null -It refers to a model grid with a ne30np4 spectral element 1-degree atmosphere and land grids, gx1v7 Greenland pole 1-degree ocean and sea-ice grids, a 1/2 degree river routing grid, null wave and internal cism grids, and an gx1v7 ocean mask. +It refers to a model grid with a ne30np4 spectral element, 1-degree atmosphere and land grids, gx1v7 Greenland pole, 1-degree ocean and sea-ice grids, a 1/2 degree river routing grid, null wave and internal cism grids, and an gx1v7 ocean mask. The alias for this grid is ne30_g16. CIME also permits users to introduce their own :ref:`user-defined grids `. Component grids are denoted by the following naming convention: -- "[dlat]x[dlon]" are regular lon/lat finite volume grids where dlat and dlon are the approximate grid spacing. The shorthand convention is "fnn" where nn generally is a pair of numbers indicating the resolution. An example is 1.9x2.5 or f19 for the approximately "2-degree" finite volume grid. Note that CAM uses an [nlat]x[nlon] naming convention internally for this grid. +- "[dlat]x[dlon]" are regular lon/lat finite volume grids where dlat and dlon are the approximate grid spacing. The shorthand convention is "fnn" where nn generally is a pair of numbers indicating the resolution. An example is 1.9x2.5 or f19 for the approximately "2-degree" finite-volume grid. Note that CAM uses an [nlat]x[nlon] naming convention internally for this grid. - "Tnn" are spectral lon/lat grids where nn is the spectral truncation value for the resolution. The shorthand name is identical. Example: T85. @@ -121,7 +124,7 @@ Component grids are denoted by the following naming convention: Querying CIME - calling **query_config** ============================================== -The utility **$CIMEROOT/scripts/query_config** permits you to query the out-of-the-box compsets, components, grids and machines that are available for a model. +Use the utility **$CIMEROOT/scripts/query_config** to see which out-of-the-box compsets, components, grids and machines are available for a model. Optional arguments include the following: :: @@ -131,17 +134,21 @@ Optional arguments include the following: --grids --machines -If CIME is downloaded in standalone mode, only standalone CIME compsets can be queried. If CIME is part of a larger checkout that includes the prognostic components of a model, **query_config** will allow you to query all prognostic component compsets, as well. +If CIME is downloaded in standalone mode, only standalone CIME compsets can be queried. If CIME is part of a larger checkout that includes the prognostic components of a model, **query_config** will allow you to query all prognostic component compsets. -Run **query_config -- --help** to see lists of available compsets, components, grids and machines. +To see lists of available compsets, components, grids and machines, look at the **help** text: + :: + + > query_config --help **Usage examples** - To run **query_config** for compset information, use the **---compsets** option and the component name, which is **drv** in this example: + +To run **query_config** for compset information, follow this example, where **drv** is the component name: :: - query_config --compsets drv + > query_config --compsets drv - The output will be similar to this: +The output will be similar to this: :: -------------------------------------- @@ -158,12 +165,12 @@ Run **query_config -- --help** to see lists of available compsets, components, g Each model component specifies its own definitions of what can appear after the ``%`` modifier in the compset longname (for example, ``DOM`` in ``DOCN%DOM``). - To see what supported modifiers are for ``DOCN``, run **query_config** as in this example: +To see what supported modifiers are for ``DOCN``, run **query_config** as in this example: :: - query_config --component docn + > query_config --component docn - The output will be similar to this: +The output will be similar to this: :: ========================================= diff --git a/_sources/users_guide/cloning-a-case.txt b/_sources/users_guide/cloning-a-case.txt index 9105dcd3a52..ffaf3c447d5 100644 --- a/_sources/users_guide/cloning-a-case.txt +++ b/_sources/users_guide/cloning-a-case.txt @@ -6,11 +6,11 @@ Cloning a Case If you have access to a run that you want to clone, the **create_clone** command will create a new case while preserving local modifications to the case. -Here is the simplest example of using **create_clone**: +Here is a simple example: :: - cd $CIMEROOT/scripts - create_clone --case $CASEROOT --clone $CLONEROOT + > cd $CIMEROOT/scripts + > create_clone --case $CASEROOT --clone $CLONEROOT The **create_clone** script preserves any local namelist modifications made in the **user_nl_xxxx** files as well as any source code modifications in the **SourceMods** tree. Otherwise, **$CASEROOT/** directory will appear as if **create_newcase** had just been run. @@ -19,6 +19,6 @@ The **create_clone** script preserves any local namelist modifications made in t See the **help** text for more usage information. :: - create_clone --help + > create_clone --help Another approach to duplicating a case is to use the information in the case's **README.case** and **CaseStatus** files to create a new case and duplicate the relevant **xlmchange** commands that were issued in the original case. This alternative will *not* preserve any local modifications that were made to the original case, such as source-code or build-script revisions; you will need to import those changes manually. diff --git a/_sources/users_guide/create-a-case.txt b/_sources/users_guide/create-a-case.txt index ba297b0071a..7cca2cb450f 100644 --- a/_sources/users_guide/create-a-case.txt +++ b/_sources/users_guide/create-a-case.txt @@ -12,12 +12,17 @@ The first step in creating a CIME-based experiment is to use **create_newcase**. If you are not on an out-of-the box CIME-supported platform, you will need to :ref:`port ` CIME to your system before proceeding. -Review the input options for **create_newcase** by using the **---help** option. The only required arguments to **create_newcase** are: -:: +Review the input options for **create_newcase** in the **help** text. + :: - create_newcase --case [CASE] --compset [COMPSET] --res [GRID] + > create_newcase --help -CIME supports out of the box *component sets*, *model grids** and *hardware platforms*. Compsets and grids were discussed in the :ref:`previous section `. +The only required arguments to **create_newcase** are shown here: + :: + + > create_newcase --case [CASE] --compset [COMPSET] --res [GRID] + +CIME supports out-of-the-box *component sets*, *model grids* and *hardware platforms*. Compsets and grids were discussed in the :ref:`previous section `. --------------------------------- Result of calling create_newcase @@ -26,19 +31,19 @@ Result of calling create_newcase Following is a simple example of using **create_newcase** with aliases for both compset and grid names. The complete example appears in the :ref:`basic example `. -In what follows, ``$CIMEROOT`` is the full pathname of the root directory of the CIME distribution. -:: +Here, ``$CIMEROOT`` is the full pathname of the root directory of the CIME distribution. + :: > cd $CIMEROOT/scripts > create_newcase --case ~/cime/example1 --compset A --res f09_g16_rx1 -In the example, the command creates a ``$CASEROOT`` directory **~/cime/example1**. (If that directory already exists, a warning is printed and the command aborts. +In the example, the command creates a ``$CASEROOT`` directory: **~/cime/example1**. If that directory already exists, a warning is printed and the command aborts. Additional details: -- ``$CASE`` is ``example1`` (``$CASE`` can include letters, numbers, ".", and "_") +- ``$CASE`` can include letters, numbers, ".", and "_". In the example, it is ``example1``. - The compset is ``2000_DATM%NYF_SLND_DICE%SSMI_DOCN%DOM_DROF%NYF_SGLC_SWAV``. -- The model resolution is ``a%0.9x1.25_l%0.9x1.25_oi%gx1v6_r%r05_m%gx1v6_g%null_w%null`` +- The model resolution is ``a%0.9x1.25_l%0.9x1.25_oi%gx1v6_r%r05_m%gx1v6_g%null_w%null``. - **create_newcase** installs files in ``$CASEROOT`` to build and run the model and to optionally archive the case on the target platform. @@ -47,19 +52,17 @@ Running **create_newcase** creates various scripts, files and directories ``$CAS - ``user scripts`` ================= ===================================================================================================== - case.setup Script used to set up the case (create the case.run script, the Macros file and user_nl_xxx files) - case.build Script to build component and utility libraries and model executable - case.submit Script to submit the case to run using the machine's batch queueing system - case.st_archive Script to perform short-term archiving of output data - case.lt_archive Script to perform long-term archiving of output data - xmlchange Script to modify values in the xml files - xmlquery Script to query values in the xml files - preview_namelists Script for users to see their component namelists in ``$CASEROOT/CaseDocs`` before running the model - - .. warning:: the namelists generated in ``$CASEROOT/CaseDocs`` should not be edited by the user - - they are only there to document model behavior. - check_input_data Script for checking for various input datasets and moves them into place. + case.setup Script used to set up the case (create the case.run script, the Macros file and user_nl_xxx files). + case.build Script to build component and utility libraries and model executable. + case.submit Script to submit the case to run using the machine's batch queueing system. + case.st_archive Script to perform short-term archiving of output data. + case.lt_archive Script to perform long-term archiving of output data. + xmlchange Script to modify values in the xml files. + xmlquery Script to query values in the xml files. + preview_namelists Script for users to see their component namelists in ``$CASEROOT/CaseDocs`` before running the model. + + .. warning:: Users should not edit namelists that are generated in ``$CASEROOT/CaseDocs``. They are there only to document model behavior. + check_input_data Script for checking for various input data sets and moving them into place. pelayout Script to query and modify the NTASKS, ROOTPE, and NTHRDS for each component model. This a convenience script that can be used in place of xmlchange and xmlquery. ================= ===================================================================================================== @@ -84,17 +87,17 @@ Running **create_newcase** creates various scripts, files and directories ``$CAS env_mach_pes.xml Sets component machine-specific processor layout (see :ref:`changing pe layout` ). The settings in this are critical to a well-load-balanced simulation (see :ref:`load balancing `). - env_run.xml Sets run-time settings such as length of run, frequency of restarts, output of coupler diagnostics, - + env_run.xml Sets runtime settings such as length of run, frequency of restarts, output of coupler diagnostics, and short-term and long-term archiving. This file can be edited at any time before a job starts. - env_batch.xml Sets batch system specific settings such as wallclock time and queue name. + + env_batch.xml Sets batch system settings such as wallclock time and queue name. ===================== =============================================================================================================================== - ``User Source Mods Directory`` ===================== =============================================================================================================================== - SourceMods Top-level directory containing sub-directories for each compset component where + SourceMods Top-level directory containing subdirectories for each compset component where you can place modified source code for that component. ===================== =============================================================================================================================== @@ -108,25 +111,24 @@ Running **create_newcase** creates various scripts, files and directories ``$CAS - ``non-modifiable work directories`` ===================== =============================================================================================================================== - Buildconf/ Work directory containing scripts to generate component namelists and component and utility libraries (e.g., PIO, MCT) - - You should never have to edit the contents of this directory. + Buildconf/ Work directory containing scripts to generate component namelists and component and utility libraries + (PIO or MCT, for example). You should never have to edit the contents of this directory. LockedFiles/ Work directory that holds copies of files that should not be changed. Certain xml files are *locked* after their variables have been used by should no longer be changed. - CIME does this by *locking* a file and not permitting you to modify that file unless, depending on the file, **case.setup ---clean** or **case.build ---clean** are called. + CIME does this by *locking* a file and not permitting you to modify that file unless, depending on the file, ``case.setup --clean`` or ``case.build --clean`` is called. Tools/ Work directory containing support utility scripts. You should never need to edit the contents of this directory. ===================== =============================================================================================================================== -The ``$CASEROOT`` xml files are organized so that variables can be locked at certain points to prevent users from changing variables after they have been resolved (used) in other parts of the scripts system. +The ``$CASEROOT`` xml files are organized so that variables can be locked at certain points to prevent users from changing them after they have been resolved (used) in other parts of the scripts system. CIME does the following: - Locks variables in **env_case.xml** after **create_newcase**. -- Locks variables in **env_mach_pes.xml** are locked after **case.setup**. +- Locks variables in **env_mach_pes.xml** after **case.setup**. - Locks variables in **env_build.xml** after completion of **case.build**. @@ -134,10 +136,10 @@ Variables in **env_run.xml**, **env_batch.xml** and **env_archive.xml** are neve The **env_case.html** file can never be unlocked. -These files can be "unlocked" as follows: +These other files can be "unlocked" as follows: -- **case.setup --clean** unlocks **env_mach_pes.xml** +- To unlock **env_mach_pes.xml**, run ``case.setup --clean``. -- **case.build --clean** unlocks **env_build.xml** +- To unlock **env_build.xml**, run ``case.build --clean``. diff --git a/_sources/users_guide/introduction-and-overview.txt b/_sources/users_guide/introduction-and-overview.txt index 80a5e843f86..32de7a4ee31 100644 --- a/_sources/users_guide/introduction-and-overview.txt +++ b/_sources/users_guide/introduction-and-overview.txt @@ -5,26 +5,29 @@ Introduction ************************** -The Common Infrastructure for Modeling the Earth (CIME) provides a UNIX command-line-based user interface for +The Common Infrastructure for Modeling the Earth (CIME) provides a UNIX command-line-based interface for configuring, compiling and executing Earth system models. Part 1 of this guide explains the basic commands -needed to get a model running. +that are needed to get a model running. Prerequisites ============= -Familiarity with the basic climate modeling concepts. +Part 1 of this guide assumes that CIME and the necessary input files have been installed on +the computer you are using. If that is not the case, see Installing CIME. + +Other prerequisites: -Familiarity with UNIX command line terminals and the UNIX development environment. +- Familiarity with basic climate modeling concepts. -CIME's commands are Python scripts and require a correct version of the Python interpreter to be installed. +- Familiarity with UNIX command line terminals and the UNIX development environment. -The Python version must be greater than 2.7 but less than 3.0. Determine which version you have by typing: +- A correct version of the Python interpreter. + +CIME's commands are Python scripts and require a correct version of the Python interpreter to be installed. The Python version must be greater than 2.7 but less than 3.0. Determine which version you have by typing: :: > python --version -**NOTE:** Part 1 of this guide assumes that CIME and the necessary input files have been installed on -the computer you are using. If that is not the case, see Installing CIME. Terms and concepts @@ -32,22 +35,22 @@ Terms and concepts The following terms and concepts are ingrained in CIME and are used frequently in this documentation. -**active** vs **data** vs **stub** models: - Components of a model that solve a complex set of equations to describe the model's behavior are called +**active, data and stub models** + *active models*: Components of a model that solve a complex set of equations to describe the model's behavior are called *active* models. Sometimes they are called *prognostic* or *full* models. - CIME recognizes 7 different active models of a climate model. They are: + CIME recognizes 7 different active models. They are: atmosphere, ocean, sea-ice, land surface, river, glacier, wave An external system processing (ESP) stub-only component is also allowed. - For some climate problems, it is necessary to reduce feedbacks within the system by replacing an active model with a + *data models*: For some climate problems, it is necessary to reduce feedbacks within the system by replacing an active model with a version that sends and receives the same variables to and from other models, but with the values read from files rather than computed from the equations. The values received are ignored. These active-model substitutes are called *data models*. CIME provides data models for each of the supported components. - For some configurations, no data model is needed, so CIME provides *stub* versions that simply occupy the + *stub models*: For some configurations, no data model is needed, so CIME provides *stub* versions that simply occupy the required place in the climate execution sequence and do not send or receive any data. **case**: @@ -81,7 +84,7 @@ Before using any CIME commands, set the ``CIME_MODEL`` environment variable. In **** with the appropriate text, such as "acme" or "cesm." :: - setenv CIME_MODEL + > setenv CIME_MODEL Directory content @@ -138,7 +141,7 @@ directory structure. Discovering available cases ============================== -To identify which compsets, grids and machines your CIME-enabled model supports, use the **query_config** command found in **cime/scripts**. Use the **---help** option for more information. +To identify which compsets, grids and machines your CIME-enabled model supports, use the **query_config** command found in **cime/scripts**. See the **help** text for more information. :: @@ -147,7 +150,7 @@ To identify which compsets, grids and machines your CIME-enabled model supports, Quick start ================== -To quickly see how a case is created, configured, built and run with CIME, execute the following commands for an example. (This assumes that CIME has been ported to your current machine). +To see an example of how a case is created, configured, built and run with CIME, execute the following commands for an example. (This assumes that CIME has been ported to your current machine). :: > cd cime/scripts @@ -159,10 +162,10 @@ To quickly see how a case is created, configured, built and run with CIME, execu The output from each command is explained in the following sections. -You can follow the progress of your run by monitoring the **CaseStatus** file. +After you submit the case, you can follow the progress of your run by monitoring the **CaseStatus** file. :: > tail CaseStatus -Repeat the command until you see the message "case.run success" +Repeat the command until you see the message ``case.run success``. diff --git a/_sources/users_guide/running-a-case.txt b/_sources/users_guide/running-a-case.txt index 41eca525311..ba3caaa85e6 100644 --- a/_sources/users_guide/running-a-case.txt +++ b/_sources/users_guide/running-a-case.txt @@ -12,18 +12,17 @@ Calling **case.submit** Before you submit the case using **case.submit**, make sure the batch queue variables are set correctly for your run -targeted. The batch submissions variables are contained in the file -**$CASEROOT/env_batch.xml** under the XML ```` -and ```` elements. Make sure that you -have appropriate account numbers (``PROJECT``), time limits -(``JOB_WALLCLOCK_TIME``), and queue (``JOB_QUEUE``) for those groups.. - -Also modify **$CASEROOT/env_run.xml** for your -case using :ref:`xmlchange`. - -Once you have run **case.setup** and **case.build**, run -**case.submit** to submit the run to your machine's batch queue -system. +Those variables are contained in the file **$CASEROOT/env_batch.xml** +under the XML ```` and ```` +elements. + +Make sure that you have appropriate account numbers (``PROJECT``), time limits +(``JOB_WALLCLOCK_TIME``), and queue (``JOB_QUEUE``) for those groups. + +Also modify **$CASEROOT/env_run.xml** for your case using :ref:`xmlchange`. + +Once you have executed **case.setup** and **case.build**, run **case.submit** +to submit the run to your machine's batch queue system. :: > cd $CASEROOT @@ -39,12 +38,12 @@ When called, the **case.submit** script will: - Confirm that locked files are consistent with the current xml files. -- Run **preview_namelist**, which in turn will run each component's **buildnml** +- Run **preview_namelist**, which in turn will run each component's **buildnml**. -- Run :ref:`**check_input_data**` to verify that the required - data is present. +- Run :ref:`check_input_data` to verify that the required + data are present. -- Submit the job to the batch queue. which in turn will run the script **case.run**. +- Submit the job to the batch queue. which in turn will run the **case.run** script. Upon successful completion of the run, **case.run** will: @@ -56,19 +55,19 @@ Upon successful completion of the run, **case.run** will: - Submit the short-term archiver script **case.st_archive** to the batch queue if ``$DOUT_S`` is TRUE. -- Resubmit **case.run** if ``$RESUBMIT`` >0. +- Resubmit **case.run** if ``$RESUBMIT`` > 0. Short-term archiving will copy and move component history, log, diagnostic, and restart files from ``$RUNDIR`` to the short-term -archive directory, ``$DOUT_S_ROOT``. +archive directory ``$DOUT_S_ROOT``. --------------------------------- Monitoring case job statuses --------------------------------- The **$CASEROOT/CaseStatus** file contains a log of all the job states -and **xmlchange** commands in chronological order. An example of status -messages includes: +and **xmlchange** commands in chronological order. Here is an example of status +messages: :: 2017-02-14 15:29:50: case.setup starting @@ -92,8 +91,6 @@ messages includes: 2017-02-14 16:20:58: st_archive success --------------------------------------------------- -When the short-term archiver is done, data from ``$RUNDIR`` is in -subdirectories under ``$DOUT_S_ROOT``. .. note:: After a successful first run, set the **env_run.xml** variable @@ -113,13 +110,13 @@ Troubleshooting a job that fails --------------------------------- There are several places to look for information if a job fails. -Start with the STDOUT and STDERR file(s) in **$CASEROOT**. +Start with the **STDOUT** and **STDERR** file(s) in **$CASEROOT**. If you don't find an obvious error message there, the **$RUNDIR/$model.log.$datestamp** files will probably give you a hint. -First check **cpl.log.$datestamp**, which will often tell you -when the model failed. Then check the rest of the component log +First, check **cpl.log.$datestamp**, which will often tell you +*when* the model failed. Then check the rest of the component log files. See :ref:`troubleshooting run-time problems` for more information. @@ -134,11 +131,10 @@ for your case exist on local disk in the appropriate subdirectory of ``$DIN_LOC_ROOT``. It automatically downloads missing data. The required input data sets needed for each component are found in the -**$CASEROOT/Buildconf** directory in the files ``xxx.input_data_list``, -where ``xxx`` is the component name. These files are generated by a call +**$CASEROOT/Buildconf** directory. These files are generated by a call to **preview_namlists** and are in turn created by each component's **buildnml** script. For example, for compsets consisting only of data -models (that is, ``A`` compsets), the following files are created: +models (``A`` compsets), the following files are created: :: datm.input_data_list @@ -146,19 +142,19 @@ models (that is, ``A`` compsets), the following files are created: docn.input_data_list drof.input_data_list -You can independently verify that the required data is present locally by +You can independently verify the presence of the required data by using the following commands: :: > cd $CASEROOT - > check_input_data -help - > check_input_data -inputdata $DIN_LOC_ROOT -check + > check_input_data --help + > check_input_data --inputdata $DIN_LOC_ROOT --check If data sets are missing, obtain them from the input data server: :: > cd $CASEROOT - > check_input_data -inputdata $DIN_LOC_ROOT -export + > check_input_data --inputdata $DIN_LOC_ROOT --export .. _controlling-start-stop-restart: @@ -174,9 +170,24 @@ a flag to determine if the run should be flagged as a continuation run. At a minimum, you will need to set the variables ``$STOP_OPTION`` and ``$STOP_N``. Other driver namelist settings then will have consistent and -reasonable default values. These default settings guarantee that +reasonable default values. The default settings guarantee that restart files are produced at the end of the model run. +By default, the stop time settings are: +:: + + STOP_OPTION = ndays + STOP_N = 5 + STOP_DATE = -999 + +The default settings are appropriate only for initial testing. Before +starting a longer run, update the stop times based on the case +throughput and batch queue limits. For example, if the model runs 5 +model years/day, set ``RESUBMIT=30, STOP_OPTION= nyears, and STOP_N= +5``. The model will then run in five-year increments and stop after +30 submissions. + + --------------------------------------------------- Run-type initialization --------------------------------------------------- @@ -227,8 +238,8 @@ The case initialization type is set using the ``$RUN_TYPE`` variable in ``hybrid`` A hybrid run is initialized like a startup but it uses initialization data sets from a previous case. It is similar - somewhat analogous to a branch run with relaxed restart - constraints. A hybrid run allows users to bring together + to a branch run with relaxed restart constraints. + A hybrid run allows users to bring together combinations of initial/restart files from a previous case (specified by ``$RUN_REFCASE``) at a given model output date (specified by ``$RUN_REFDATE``). Unlike a branch run, the starting @@ -254,29 +265,6 @@ a hybrid or branch run, you must specify values for ``$RUN_REFCASE`` and ``$RUN_REFDATE``. All run startup variables are discussed in `run start control variables`_. -**A brief note on restarting runs** - -When you first begin a branch, hybrid or startup run, ``CONTINUE_RUN`` -must be set to ``FALSE``. After the job has run successfully and -there are restart files, you will need to change ``CONTINUE_RUN`` to -TRUE for the remainder of your run. Setting the ``RESUBMIT`` option to -a value > 0 will cause the ``CONTINUE_RUN`` variable to be set to ``TRUE`` -automatically upon completion of the initial run. - -By default, the stop time settings are: -:: - - STOP_OPTION = ndays - STOP_N = 5 - STOP_DATE = -999 - -The default settings are appropriate only for initial testing. Before -starting a longer run, update the stop times based on the case -throughput and batch queue limits. For example, if the model runs 5 -model years/day, set ``RESUBMIT=30, STOP_OPTION= nyears, and STOP_N= -5``. The model will then run in five-year increments, and stop after -30 submissions. - .. _controlling-output-data: ========================= @@ -286,34 +274,33 @@ Controlling output data During a model run, each model component produces its own output data sets consisting of history, initial, restart, diagnostics, output log and rpointer files. Component history files and restart files are -in netCDF format. Restart files are used to either exactly restart the +in netCDF format. Restart files are used to either restart the same model or to serve as initial conditions for other model cases. The -rpointer files are text files listing the component history and -and restart files required for restart. +rpointer files are text files that list the component history and +restart files that are required for restart. -Archiving is a phase of a model run where the generated output data is +Archiving is the phase of a model run when output data are moved from ``$RUNDIR`` to a local disk area (short-term archiving). It has no impact on the production run except to clean up disk space in the ``$RUNDIR`` and help manage user quotas. -In **env_run.xml**, several variables control the behavior of +Several variables in **env_run.xml** control the behavior of short-term archiving. This is an example of how to control the data output flow with two variable settings: - :: DOUT_S = TRUE DOUT_S_ROOT = /$SCRATCH/$user/$CASE/archive -Key points to keep in mind about short-term archiving: +The first setting above is the default, so short-term archiving is enabled. The second sets where to move files at the end of a successful run. -- Short-term archiving is enabled by default (``$DOUT_S = TRUE``). +Also: - All output data is initially written to ``$RUNDIR``. -- Unless a user explicitly turns off short-term archiving, files will - be moved to ``$DOUT_S_ROOT`` at the end of a successful model run. +- Unless you explicitly turn off short-term archiving, files are + moved to ``$DOUT_S_ROOT`` at the end of a successful model run. - Users generally should turn off short-term archiving when developing new code. @@ -353,26 +340,23 @@ for a description of output data filenames. Restarting a run ====================== -Each active component (and some data components) write restart files +Active components (and some data components) write restart files at intervals that are dictated by the driver via the setting of the ``$REST_OPTION`` and ``$REST_N`` variables in **env_run.xml**. Restart files allow the model to stop and then start again with bit-for-bit exact capability; the model output is exactly the same as if the model -had not stopped). The driver coordinates the writing of restart -files as well as the time evolution of the model. All components -receive restart and stop information from the driver and write -restarts or stop as the drives specifies. +had not stopped. The driver coordinates the writing of restart +files as well as the time evolution of the model. -Keep in mind that runs initialized as branch or hybrid runs, require +Runs that are initialized as branch or hybrid runs require restart/initial files from previous model runs (as specified by the -variables ``$RUN_REFCASE`` and ``$RUN_REFDATE``). The user must pre-stage -these required files to the case ``$RUNDIR`` (normally ``$EXEROOT/run``) +variables ``$RUN_REFCASE`` and ``$RUN_REFDATE``). Pre-stage these +iles to the case ``$RUNDIR`` (normally ``$EXEROOT/run``) before the model run starts. Normally this is done by copying the contents of the relevant **$RUN_REFCASE/rest/$RUN_REFDATE.00000** directory. Whenever a component writes a restart file, it also writes a restart -pointer file in the format **rpointer.$component**. The pointer -file contains the name of that new restart file. Upon a restart, each +pointer file in the format **rpointer.$component**. Upon a restart, each component reads the pointer file to determine which file to read in order to continue the run. These are examples of pointer files created for a component set using full active model components. @@ -403,15 +387,14 @@ back up to a previous restart. If short-term archiving is enabled, find the latest **$DOUT_S_ROOT/rest/yyyy-mm-dd-ssss/** directory and copy its contents into your run directory (``$RUNDIR``). -Make sure that the new rpointer.* files overwrite older files in -in ``$RUNDIR``, or the job may not restart in the correct place. - -You can then continue the run using the new restarts. +Make sure that the new restart pointer files overwrite older files in +in ``$RUNDIR`` or the job may not restart in the correct place. You can +then continue the run using the new restarts. Occasionally, when a run has problems restarting, it is because the -rpointer.* and restart files are out of sync. The rpointer.* files -are text files that can easily be edited to match the correct dates -of the restart and history files. All the restart files should +pointer and restart files are out of sync. The pointer files +are text files that can be edited to match the correct dates +of the restart and history files. All of the restart files should have the same date. ============================ @@ -424,8 +407,7 @@ which is set to **$CASEROOT/logs** by default. If the job aborts, log files are NOT be copied out of the ``$RUNDIR`` directory. The output data flow from a successful run depends on whether or not -short-term archiving is enabled, as it is by default. (The **env_run.xml** -variable ``$DOUT_S`` is set as ``DOUT_S=TRUE``. +short-term archiving is enabled, as it is by default. ------------- No archiving diff --git a/_sources/users_guide/setting-up-a-case.txt b/_sources/users_guide/setting-up-a-case.txt index 7ee6ceae884..eb683f5d3df 100644 --- a/_sources/users_guide/setting-up-a-case.txt +++ b/_sources/users_guide/setting-up-a-case.txt @@ -8,29 +8,23 @@ Setting up a Case Calling **case.setup** =================================== -After creating a case or changing aspects of a case, such as the pe-layout, call the **case.setup** command from ``$CASEROOT`` This creates additional files and directories in ``$CASEROOT``. They are described below. - -To see the options that are available with **case.setup**, use the **---help**. option. +After creating a case or changing aspects of a case, such as the pe-layout, call the **case.setup** command from ``$CASEROOT``. This creates additional files and directories in ``$CASEROOT``. They are described below. ============================= =============================================================================================================================== - case.run Run script containing the batch directives - - The batch directives are generated using the contents of env_mach_pes.xml. - Calling **case.setup --clean** will remove this file. + case.run Run script containing the batch directives. The directives are generated using the contents + of **env_mach_pes.xml**. Running ``case.setup --clean`` will remove this file. Macros.make File containing machine-specific makefile directives for your target platform/compiler. - This file is created if it does not already exist. - The user can modify this file to change certain aspects of the build, such as compiler flags. - - Calling **case.setup --clean** will not remove the file once it has been created. - However. if you remove or rename the Macros.make file, **case.setup** will recreate it. + The user can modify the file to change certain aspects of the build, such as compiler flags. + Running ``case.setup --clean`` will not remove the file once it has been created. + However. if you remove or rename the Macros.make file, running **case.setup** recreates it. user_nl_xxx[_NNNN] files Files where all user modifications to component namelists are made. **xxx** is any one of the set of components targeted for the case. - For example, for a full active CESM compset, **xxx** would be cam, clm, rtm, and so on. + For example, for a full active CESM compset, **xxx** is cam, clm or rtm, and so on. NNNN goes from 0001 to the number of instances of that component. (See :ref:`multiple instances`) @@ -38,12 +32,13 @@ To see the options that are available with **case.setup**, use the **---help**. For a case with 1 instance of each component (default), NNNN will not appear in the user_nl file names. - A user_nl file of a given name will only be created once. + A user_nl file of a given name is created only once. - Calling **case.setup -\ -\ clean** will *not remove* any user_nl files. + Calling ``case.setup --clean`` will *not remove* any user_nl files. Changing the number of instances in the **env_mach_pes.xml** file will cause only new user_nl files to be added to ``$CASEROOT``. + CaseDocs/ Directory that contains all the component namelists for the run. This is for reference only and files in this directory SHOULD NOT BE EDITED since they will diff --git a/_sources/users_guide/troubleshooting.txt b/_sources/users_guide/troubleshooting.txt index b67a258b2c5..e109b81a01b 100644 --- a/_sources/users_guide/troubleshooting.txt +++ b/_sources/users_guide/troubleshooting.txt @@ -11,7 +11,7 @@ Generally, **create_newcase** errors are reported to the terminal and should pro If **create_newcase** fails on a relatively generic error, first check to make sure the command-line arguments match the interface's specification. See the help text to review usage. :: - create_newcase --help + > create_newcase --help Troubleshooting job submission ------------------------------- @@ -30,7 +30,7 @@ Troubleshooting runtime problems To see if a run completed successfully, check the last several lines of the **cpl.log** file for a string like ``SUCCESSFUL TERMINATION``. A successful job also usually copies the log files to the **$CASEROOT/logs** directory. -**Note**: The first things to check when a job fails: +Check these things first when a job fails: - Did the model time out? @@ -42,7 +42,7 @@ To see if a run completed successfully, check the last several lines of the **cp If any of those things happened, take appropriate corrective action (see suggestions below) and resubmit the job. -If it is not clear any of the above caused a case to fail, then there are several places to look for error messages. +If it is not clear that any of the above caused a case to fail, there are several places to look for error messages. - Check component log files in your run directory (``$RUNDIR``). This directory is set in the **env_run.xml** file. @@ -57,9 +57,8 @@ If it is not clear any of the above caused a case to fail, then there are severa - Check any automated email from the job about why a job failed. Some sites' batch schedulers send these. -- Check the archive directory. - If a case failed, the log files or data may still have been archived. - The archiver is turned on if ``DOUT_S`` is set to TRUE in **env_run.xml**. The directory to check is **$DOUT_S_ROOT/$CASE**. +- Check the archive directory: **$DOUT_S_ROOT/$CASE**. If a case failed, the log files + or data may still have been archived. **Common errors** @@ -73,7 +72,7 @@ Another error that can cause a timeout is a slow or intermittently slow node. The **cpl.log** file normally outputs the time used for every model simulation day. To review that data, grep the **cpl.log** file for the string ``tStamp`` as shown here: :: - grep tStamp cpl.log.* | more + > grep tStamp cpl.log.* | more The output looks like this: :: @@ -98,6 +97,6 @@ Sometimes when a job times out or overflows disk space, the restart files will g With the exception of the CAM and CLM history files, all the restart files have consistent sizes. Compare the restart files against the sizes of a previous restart. If they don't match, remove them and move the previous restart into place before resubmitting the job. -See `restarting a run `_. +See `Restarting a run `_. It is not uncommon for nodes to fail on HPC systems or for access to large file systems to hang. Before you file a bug report, make sure a case fails consistently in the same place. diff --git a/searchindex.js b/searchindex.js index 1053e30844e..43f02b202f3 100644 --- a/searchindex.js +++ b/searchindex.js @@ -1 +1 @@ -Search.setIndex({envversion:48,filenames:["build_cpl/index","build_cpl/introduction","data_models/data-atm","data_models/data-lnd","data_models/data-model-science","data_models/data-ocean","data_models/data-river","data_models/data-seaice","data_models/data-wave","data_models/design-details","data_models/index","data_models/input-streams","data_models/introduction","driver_cpl/bit-for-bit-flag","driver_cpl/budgets","driver_cpl/design","driver_cpl/driver_threading_control","driver_cpl/grids","driver_cpl/history-and-restarts","driver_cpl/implementation","driver_cpl/index","driver_cpl/initialization-and-restart","driver_cpl/introduction","driver_cpl/multi-instance","driver_cpl/namelist-overview","driver_cpl/time-management","index","misc_tools/index","users_guide/adding-cases","users_guide/building-a-case","users_guide/case-basics","users_guide/cime-internals","users_guide/cloning-a-case","users_guide/create-a-case","users_guide/customizing-a-case","users_guide/faq/basics-a-basic-example","users_guide/faq/basics-mpi-example","users_guide/faq/basics-setting-up-a-branch-or-hybrid-run","users_guide/faq/faq","users_guide/index","users_guide/introduction-and-overview","users_guide/multi-instance","users_guide/optimizing-processor-layout","users_guide/porting-cime","users_guide/running-a-case","users_guide/setting-up-a-case","users_guide/testing","users_guide/troubleshooting","users_guide/unit_testing","what_cime/index"],objects:{},objnames:{},objtypes:{},terms:{"0e30":11,"0xhukfql":48,"12th":25,"13th":25,"16x4":34,"1850_cam60_clm50":30,"18th":25,"19th":25,"1_nompi_noopenmp":48,"1st":25,"2000_datm":[30,33],"2000_satm_dlnd":30,"2000_satm_slnd_sice_socn_srof_sglc_dwav":30,"2000_satm_slnd_sice_socn_srof_sglc_swav_sesp":30,"2000_xatm_xlnd_xice_xocn_xrof_xglc_xwav":30,"20170504_163152_31aahi":46,"20tr":30,"24th":25,"256m":43,"25_l":33,"25_oi":33,"2nd":11,"3rd":11,"4th":5,"5_gx1v6":[11,43],"5th":5,"6th":25,"7th":25,"8_cheyenne_intel17":48,"9x1":33,"9x2":[11,28,30,43],"__command_line_test__":48,"_bgc":30,"_cpl_dt":25,"_cpl_offset":25,"_docn":30,"_esp":30,"_fillvalu":5,"_glc":30,"_ice":30,"_in_":41,"_layout":23,"_lnd":30,"_modelio":24,"_nnnn":45,"_ocn":30,"_restart":9,"_rof":30,"_wav":30,"case":[2,3,5,6,7,8,9,11,12,15,17,18,23,26],"char":31,"class":[3,39,46],"default":[2,3,4,5,7,9,11,16,17,24,28,29,34,39],"export":[2,3,5,7,8,29,44,48],"false":44,"final":[9,12,15,16,17,22,31,42,43,48],"function":[7,9,12,19,20],"import":[12,17,25,29,32,34,40,41,42,44,48],"long":[1,9,14,30,33,39,42,43],"new":[5,9,11,17,21,22,26],"null":[2,3,4,5,6,7,8,9,11,12,30,33],"public":9,"return":[2,3,5,6,7,9,12,21,25,48],"short":[2,7,15,30,33,39,42,43],"static":17,"true":[2,3,5,6,7,8,9,13,25,28,37,44,47,48],"try":[42,43,47],"var":[2,9],"while":[5,11,15,17,25,28,32,34,44],a0l0i0o0g0c0:29,a1l0i0o0g0c0:29,abil:[13,16,25,41,42,49],abl:[9,18,25,41,44,48],abort:[4,17,33,44,48],about:[4,9,11,15,17,22,25,42,44,47,48],abov:[4,11,12,15,25,41,42,47,48],absolut:[15,17,42],accept:[15,48],access:[9,32,43,44,47,48],accommod:[5,11],accompani:[2,28,42],accomplish:[5,17],accord:[11,48],accordingli:5,accordlingli:41,account:[17,42,43,44],acct:46,accumlu:25,accumul:[7,18,25],accur:17,accuraci:17,achiev:[28,42,48],acm:[28,29,31,40,43,46],acme:[26,30],acme_develop:46,acquir:15,across:[17,18,21,34,42],act:[7,17],action:47,activ:[2,3,4,5,7,9,12,15,17,29,30],actual:[5,9,11,17,18,48],add:[1,2,5,11,14,17,28,34,39,43,46],addit:[2,3,5,6,7,12,14,15,17,18,22,25,27,30,31,34,37,40,42,43,44,45,48],addition:49,address:43,adesp:30,adesp_test:30,adjust:[5,15],adlnd:30,adopt:15,advanc:[9,11,15,25],advantag:[12,42,48],adwav:30,aerosol:2,affect:17,afrac:17,after:[5,11,17,28,29,30,31,33,34,42,43,44,45,48],afterward:48,again:[15,28,34,44],against:[46,47],aggreg:42,aiaf:30,aic:5,aid:48,alarm:[18,25],albedo:[15,21,25],algorithm:[9,11,15,17],alia:30,alias:[30,33],align:[5,9,11],all:[2,3,4,5,6,7,8,9,11,12,13,15,17,18,21,22,23,25,28,29,30,31,34,35,40,41,42,43,44,45,46,47,48,49],allact:31,alloc:[34,48],allocat:[9,36,48],allocstr:9,allow:[11,15,16,17,23,25,30,40,43,44,46,48,49],almost:[3,48],alon:[27,49],along:48,alongsid:48,alreadi:[28,29,33,37,45,46,48],also:[2,3,5,6,7,9,11,12,15,17,18,21,22,24,25,28,29,30,31,34,40,41,42,43,44,46,47,48],altern:[5,17,25,32,48],although:[4,5,9,15,17,18,42],alwai:[5,9,11,15,17,23,25,30,42,48],ambigu:17,amip:5,amipsst:5,among:[12,44,48],amount:[12,15,25,47],analog:44,analysi:[42,43,44,46],analyz:44,ang:2,angl:11,ani:[2,3,5,7,8,11,12,15,16,17,18,23,28,29,30,31,32,33,34,37,40,41,42,43,44,45,47,48,49],anidf:[2,3,7],anidr:[2,3,7],annual:[6,7,14],anomali:2,anomaly_forc:2,anomoli:2,anoth:[1,12,17,23,28,42,47,48],another:[32,47],answer:48,any:[2,3,5,6,7,12,48],anyth:[32,41],aoflux_grid:17,appear:[2,3,5,6,7,8,11,29,30,31,32,33,34,45,47],append:43,appli:[5,17,21,25],applic:[5,49],applicat:[22,42],approach:[17,32],appropri:[5,11,12,15,28,31,34,40,43,44,47,48],approxim:[9,30],aqp10:30,aqp1:30,aqp2:30,aqp3:30,aqp4:30,aqp5:30,aqp6:30,aqp7:30,aqp8:30,aqp9:30,aquap:30,aquaplanet:30,arbitrari:[9,42],arbitrarili:15,arcfactor:2,architectur:49,archiv:[31,33,37,39,43],archive:39,area:[9,11,12],arg:43,argonn:15,argument:[5,9,15,30,33,34,43,46,47,48],around:17,arrai:[2,3,5,7,8,9,11,48],ascal:17,ask:12,aspect:[17,29,45,47],assert:48,assertequ:48,assertfals:48,assertgreaterthan:48,assertgreaterthanorequ:48,assertion:39,assertisfinit:48,assertisnan:48,assertlessthan:48,assertlessthanorequ:48,asserttru:48,assign:42,assimil:[23,41],assist:28,assocait:9,associ:[2,3,5,6,7,8,9,11,12,15,17,18,21,22,24,25,28,29,30,31,34,47,48,49],assum:[2,3,4,5,6,7,8,11,17,28,30,35,37,40,41,42,48],assume:37,assumpt:[4,17],assur:[5,36,43],atm:[2,11,12,17,28,29,30,31,34,41,42,44,49],atm_cpl_dt:25,atm_cpl_offset:25,atm_grid:2,atm_in:34,atm_in_0001:41,atm_in_0002:41,atm_modelio:24,atm_ncpl:25,atm_pres:[2,4],atmnam:28,atmname_ocnnam:28,attempt:[17,36,43,46],attribut:[9,21,30,31,34,43,48],attribute_vector:15,attrvect:9,autom:[46,47,49],automat:[9,11,25,34,35,44,48],automaticali:17,auxiliari:40,avail:[4,5,9,12,15,30,39],avcoszen:9,avect_wrapp:48,averag:[5,11,14,17,18,23,25,28,47],avflb:9,avfub:9,avg:47,avifld:[2,3,5,6,7,8],avofld:[2,3,5,6,7,8],avrlb:9,avrub:9,avsdf:[2,3,7],avsdr:[2,3,7],awai:[17,44],awar:42,axi:[9,11,12],b1850:[30,37],b1850_cn:35,b1850cn:43,b_1850_cn:43,back:[6,15,17,35,37,39],background:22,backtrack:47,backward:11,balanc:[15,27,33,34,37,42,43,49],bar:48,base:[9,11,15,16,17,25,31,33,39,40,42,43,44,46],baselin:[39,43,44],baseline:46,baseline_root:43,bash:48,basi:[16,29],basic:[9,12,15,17,21,23,25,26,27,28],batch:15,batch_spec_file:31,batch_system:43,bcgen:5,bcphidri:2,bcphiwet:2,bcphodri:2,bdrd:30,becaus:[3,5,7,9,11,12,15,17,25,42,44,48],becom:[13,17,18,29,47],been:[9,12,14,15,17,21,25,28,29,32,33,34,40,43,45,46,47,48],befor:[2,3,5,6,7,9,11,12,17,25,28,30,33,40,42,43,44,47,48],began:[5,44],begin:44,beginn:38,behavior:[2,3,5,6,7,8,33,40,44,48],behind:[17,46],belong:34,below:[3,5,7,8,9,11,17,28,29,30,31,34,41,43,44,45,47,48],benefit:48,best:[15,29,31,42,48],better:[15,17,48],beyond:[9,34],bfb:43,bfbflag:13,bgc:30,bgc_cice_pop2:30,bia:[2,15,42],bias_correct:2,big:46,bilinear:[11,17,28],binari:44,bld:[29,43],blddir:29,bldlog:29,bless_test_result:46,block:[9,15,34],both:[3,5,9,11,12,15,17,18,22,30,33,34,42,43],bothmask:11,bottom:[5,42,47],bound:[7,9],boundari:[5,18,30],box:[5,11,12,28,30,31,33,41,43],bracket:9,brief:[28,40,44],bring:[26,44],broken:42,bsub:[42,47],budget_ann:14,budget_annual:14,budget_daili:14,budget_daily:14,budget_inst:14,budget_longter_eoy:14,budget_longterm_stop:14,budget_ltann:14,budget_ltend:14,budget_month:14,budget_monthly:14,budgets:14,buffer:[21,42],bug:47,build_threaded:29,buildconf:[29,33,34,44],buildex:34,buildnml:[2,3,5,6,7,8,11,24,29,34,44],built:[11,15,28,40,43,45,46,48],bullet:48,bundl:[15,17],cach:15,calcul:[5,7,15,17,22,25,34],calendar:9,call:[5,7,9,11,12,15,16,17,18,21,25,28],cam40:30,cam50:30,cam55:30,cam5:[5,34],cam60:30,cam:[5,12,28,30,31],cam_config_opts:34,cam_namelist_opts:34,cam_nml_usecase:34,can:[2,3,4,5,6,7,8,9,11,12,14,15,16,17,18,22,25,28,29,30,31,33,34,36,40,41,42,43,44,45,46,47,48,49],cannot:[11,15,25,33,34,44,48],capabl:[12,15,17,23,41,43,44,49],captur:47,care:4,carefulli:[25,43],carri:[13,17,22,42,43],cart3d:17,cartesian:5,case_last:31,casedoc:[11,29,33,34,41,45],caseroot:[2,5,11,14,23,29,31,32,33,34,35,41,42,43,44,45,46,47],casestatu:[32,33,40,44],categori:[11,46],caus:[11,44,45,47,48],caveat:[25,41],ccsm4:[22,42,43],ccsm:[2,5,37,42],ccsm_cprnc:43,ccsm_driver:25,ccsm_pe:[16,21],ccsm_time:42,ccsm_timing_stat:42,ccsmroot:28,cell:[17,28,30],celsiu:[4,5],centuri:14,certain:[15,33,45,46],cesm1:[18,22,42],cesm2:44,cesm:[2,3],cesm_driv:22,cesm_setup:34,cesm_unit_test_tutori:48,cesmdata:48,cesmdataroot:48,chang:[3,5,6,7,8,9,11,13,15,16,17,25,28,29,32,33,34,35,37,40,41,42,43,44,45,46,48],changed:29,changelog:40,changelog_templ:40,charact:[2,3,4,5,6,7,8,9,11,15,17,31,36,47],characterist:15,charg:[15,42],cheap:9,cheapest:42,check_input_data:[29,33,44],check_map:28,checkout:30,chmod:[11,34],choic:[4,17,30,40,48],choos:[12,44,48],chosen:[4,17],chronolog:[11,44],chunk:[9,15],cice:[2,5,7,30,31,34,41,43],cice_blckx:34,cice_blcky:34,cice_config_opts:34,cice_decomptype:34,cice_mxblcks:34,cice_namelist_opts:34,cime_config:[2,3,5,6,7,8,11,24,29,31,34],cime_model:[28,40,43],cime_output_root:43,cimeroot:[2,3,5,6,7,9,11,17,24,28,30,31,32,33,34,35,37,43,48],circa:2,circumst:29,cism1:30,cism2:30,cism:[30,31],cism_grid:34,cism_in:34,clarifi:[17,43],clean:[29,33,34,41,44,45,46,48],cleanli:18,cleanup:48,clear:[24,47],clen:36,climat:[5,21,26,27],climatolog:[2,5,6,7,8],climo:[8,30],clm1pt:2,clm45:30,clm50:30,clm:[2,3,28,29,30,31],clm_qian:[2,11],clm_qian_wiso:2,clmcruncep:2,clmcruncep_v5:2,clmgswp3:2,clmncep:[2,11],clock:[15,18,19,20,21],cloneroot:32,close:[15,17,46],cmake:[40,43,48],cmakelist:[40,48],cmap:2,co2:2,co2diag:2,co2lnd:2,co2ocn:2,co2prog:2,coars:9,coarsest:16,cobalt:43,code:[2,3,5,7,8,9,11,12,22,25,29,32,33,40,41,44,48],cold:44,collabor:15,collect:40,com:[48,49],combin:[4,5,7,15,17,28,31,42,43,44,48,49],come:[46,48],comma:43,command:[11,28,29,31,32,33,36,40,41,44,45,47,49],comment:[5,11,29,46,48],common:[2,4,15,28,29,40,44,46,47],commun:[12,15,16,17,21,34,42,44],compar:[18,28,42,43,46,47],compare:46,compare_base_rest:46,compare_test_result:46,comparion:46,comparison:[17,42,46,48,49],compat:[11,43],compil:29,compile_thread:48,compiler:43,compilers:43,compilers_spec_file:31,complaint:43,complement:[17,48],complementari:17,complet:[5,12,17,21,33,34,42,43,44,46,47,48,49],completed:46,complex:[11,15,40,48],compliant:[11,18,29,34],complic:43,compnam:29,compon:[1,2,3,5,6,7,8,9,11,12,13,14],compress:29,compris:[28,44,49],compset:[2,3,5,6,7,8,11],compsets_spec_file:31,comput:[4,5,7,9,11,13,15,16,17,21,22,25,28,34,40,42,43,45],concept:[30,39],condit:[44,48],conduct:49,config:[11,28,31,34,40,43],config_args:[9,43],config_atm_file:31,config_batch:[31,39],config_compil:[31,39],config_compilers_v2:[31,43],config_compon:[2,3,5,6,7,8,31,34],config_component_:31,config_compset:31,config_cpl_file:31,config_cpl_file_model_specific:31,config_esp_file:31,config_fil:31,config_glc_file:31,config_grid:[28,31],config_grids_v2:31,config_ice_file:31,config_lnd_file:31,config_machin:[31,39],config_machines_templ:43,config_ocn_file:31,config_p:[31,43],config_rof_file:31,config_test:46,config_tests_file:31,config_wav_file:31,configur:[1,5,12,15],configuraiton:42,confirm:[30,44,47],conform:[5,43],conjunct:[2,3,5,6,7,8,11,42],conmpon:14,conserv:[14,17,25,28,30],consid:[17,25,42],consider:[15,42],consist:[3,4,5,7,11,15,17,18,21,25,28,43,44,47,48,49],constant:[4,5,11,34,42,43],constantli:17,constrain:34,constraint:[15,34,42,44],construct:11,consult:47,contact:[28,43],contain:[2,3,5,6,9,11,12,15,17,18,21,24,25,27,28,29,31,33,34,38,42,43,44,45,47,48,49],content:[1,11],continu:[9,35,37,42,44],continue_run:[37,44],contrast:11,contribut:15,control:[5,14,15],conveni:[30,33,48],convent:[9,28,30,43,44,48],converg:5,convers:48,convert:[5,17],coord:9,coordin:[2,5,11,15,18,25,44],copi:[2,3,5,6,7,8,11,12,15,25,33,34,41,43,44,46,47],copyall:[2,3,4,5,6,7,8,12],core2:[2,6],core2_iaf:2,core2_nyf:[2,34],core:[2,36,43,47],corev2:2,correct:[2,5,11],correctli:[34,42,43,44],correspond:[2,3,5,6,11,30,34,37,41,43,44],cosin:11,cosp:5,cost:[9,15,42,43,47],cosz:9,coszen:[9,11],could:[11,15,17,25,31,36,40,42],count:[5,13,15,16,34,42],coupler:[1,2,3,4,5,6,7,8,12,13,14,15,17],cours:44,cover:[12,17,22,48],coverag:[5,7,41],covert:17,cpl7:[15,22,26,35,37],cpl:[29,35,37,41,42,43,44,47],cpl_modelio:24,cplhist:[2,3,6,12],cplhistforc:2,cplhistforcingforocnic:2,cplug:15,cpp:34,cppdefs:43,cprnc:[27,43],craig:[15,22,25,42],crash:44,create_clon:32,create_esmf_map:28,create_newcas:[28,30,31,32],create_newcase:46,create_test:[39,43],creation:[34,39],critic:[17,21,25,33],cruncep:2,crux:43,cseg:[11,12,48],csh:[34,40,43,44,48],csm_share:29,ctest:48,cube:30,current:[2,5,7,8,9,15,16,17,18,25,28,33,40,41,42,43,44,46],currfil:9,currpioid:9,curv:15,cusom:42,custom:10,customiz:11,cycl:[9,11,15],cyclic:5,dai:[5,11,15,18,25,28,42,43,44,47],daili:[9,11,14,42,43,47],data_comp:[2,3,5,6,7,11,31,34],dataset:[5,9,11,28,29,33],datasourc:[9,11,12],datatyp:[11,15,21,25],date:[5,9,11,18,29,42,43,44,47],datefil:5,datesec:5,datestamp:[29,42,44],datm7:[11,12],datm_clmncep_yr_align:2,datm_co2_tseries:2,datm_cplhist_case:2,datm_cplhist_dir:2,datm_cplhist_yr_align:2,datm_cplhist_yr_end:2,datm_cplhist_yr_start:2,datm_fld:2,datm_in:[2,11,34],datm_in_nnn:[2,34],datm_nml:[2,11,12],datm_presaero:2,datm_topo:2,dcmake_install_prefix:48,deal:[17,29],dealloc:48,debug:[14,29,45],decad:[21,25],decid:42,declar:48,decomp:[2,3,5,6,7,8,12],decomposit:[2,3,5,6,7,8,12,13,15,17,34,42],decreas:42,deduc:47,default_valu:31,defer:17,defin:[2,3,5,6,7,8,9,11,17,21,28,30],definit:[17,30,31,43,48],defint:43,degener:15,degre:[9,15,17,28,30,35],delta:11,demonst:17,den:[2,7,11,12],denot:[30,40],depart:15,depend:[2,3,5,6,7,8,9,11,12,15,17,25,28,29,30,31,33,42,43,44,46,47,48],deposit:2,depth:5,deriv:[5,7,11,12,15,17,25],desc:[9,31,43],descib:17,describ:[2,3,5,6,7,8,9,11,12,14,15,25,40,43,45,48],descript:[2,3,5,6,7,8,9,10],design:5,desir:[5,11,15,16,25,35,42],desktop:48,destin:[13,17,28],detect:17,determin:[5,9,12,29,30,31,34,40,42,44],develop:[2,5,15,18,21,22,25,26,40,41,42,44,48],dhdx:[5,7],dhdy:[5,7],diagnos:[14,25],diagnost:[13,15,21,22,29,33,34,42,43,44],diagram:22,diatren_ann_rx1:6,diatren_iaf_rx1:6,dice:[4,5],dice_fld:7,dice_in:[7,11,34],dice_in_nnn:[7,34],dice_nml:[7,11,12],dict:46,dictat:44,did:47,differ:[2,9,11,12,13,14,15,16,17,18,24,25,30,33,34,35,40,41,42,46,48,49],difficult:44,digit:14,dim:9,dimens:[5,9,15],dimension:9,dimid:5,din_loc_root:[29,43,44],din_loc_root_clmforc:[29,43],dir:[46,48],direct:[11,17,39],directli:[2,3,4,5,6,7,8,12,15,29,34,48],directori:[2,3,6,8,11,28,29,31,32,33,34,35,37,39],discov:39,discret:11,discuss:[2,9,11,22,28,31,33,34,41,42,43,44,48],disk:[29,44,47],displac:[28,30],distinct:[5,15,34,48],distribut:[15,23,27,33],diurnal:15,divid:[5,9,11,25],dlat:30,dlnd_cplhist_case:3,dlnd_cplhist_dir:3,dlnd_cplhist_yr_align:3,dlnd_cplhist_yr_end:3,dlnd_cplhist_yr_start:3,dlnd_fld:3,dlnd_in:[3,11,34],dlnd_in_nnn:[3,34],dlnd_nml:[3,11,12],dlon:30,dmpi:48,dn10:[2,11,12],do_budget:14,docn:4,docn_fld:5,docn_in:[5,11,34],docn_in_0001:41,docn_in_0002:41,docn_in_nnn:[5,34],docn_nml:[5,11,12],docn_ocn_in_0001:41,docn_ocn_in_0002:41,docn_som_filename:5,docn_sstdata_filename:5,docn_sstdata_year_end:5,docn_sstdata_year_start:5,document:[14,15,22,25],doe:[5,9,11,15,17,23,25,33,34,43,44,45,49],doesn:[9,42],dofil:9,doi:22,dom:[17,30,31],dom_a:17,dom_drof:[30,33],dom_i:17,dom_l:17,dom_o:17,domain:[9,11],domainfil:[9,11,12],domaininfo:[9,11,12],domap:9,domareanam:9,domfilenam:9,domfilepath:9,dommasknam:9,domtvarnam:9,domxvarnam:9,domyvarnam:9,domzvarnam:9,don:[9,11,42,44,47,48],done:[2,3,5,6,7,9,13,15,17,33,42,44,48],dopenmp:48,dot:11,doubt:29,dout_l_msroot:43,dout_s:[44,47],dout_s_root:[43,44,47],down:[40,42,43,47],download:[29,30,44,48],draw:48,drive:[2,7,44,46],driven:[43,46,48],driver:[2,3,5,6,7,9,12,13,14,15],driver_cpl:[17,22,24,31],driver_fld:[2,3,5,6,7,8],drof:4,drof_cplhist_case:6,drof_cplhist_dir:6,drof_cplhist_yr_align:6,drof_cplhist_yr_end:6,drof_cplhist_yr_start:6,drof_fld:6,drof_in:[6,11,34],drof_in_nnn:34,drof_nml:[6,11,12],drop:48,drv:[17,30,31,44],drv_flds_in:[24,41],drv_in:[17,24,34,41],drv_thread:16,dstdry1:2,dstdry2:2,dstdry3:2,dstdry4:2,dstmask:11,dstwet1:2,dstwet2:2,dstwet3:2,dstwet4:2,dtest:43,dtlimit:[9,11],dtmax:9,dtmin:9,due:[5,15,17,42,43],duplic:[32,48],durat:46,dure:[9,15,16,42,43,44],duu10n:5,dwav:4,dwav_fld:8,dwav_in:[8,11],dwav_nml:[8,11,12],dxxx_mode:12,dycor:28,dynam:[15,49],each:[2,3,4,5,6,7,8,9,11,12,13,14,15,16,17,21,23,25,29,30,31,33,34,40,41,42,43,44,45,46,47,48,49],earli:[25,43],earlier:48,earth:[22,40,42,43,49],easi:[17,44,46,48],easier:48,easiest:17,easili:[11,12,15,43,44],east:17,eccen:9,eccentr:9,eco_mosart_cism2:30,ect:46,edit:[3,4,5,6,7,8,11,28,31,33,34,35,42,44],edited:[34,45],edu:44,effect:17,effici:34,effort:14,eight:[15,42],either:[4,6,9,14,15,25,29,30,34,41,42,43,44,47,48],elaps:9,element:[11,30,31,43,44,48],elemnet:11,elev:3,elimin:25,elsewher:11,email:47,empti:48,enabl:[5,40,44,48,49],encapsul:[9,15],encount:44,end:[2,3,5,6,9,11,14,18,25,34,35,36,37,42,43,44,47,48],energi:15,ensembl:[27,41,49],ensur:[14,16,17,18,21,23,28,34,48],ensure:48,entir:[17,44,46],entri:[11,28,31,34,40,43],entry_id:31,env:[17,25,43,46,48],env_arch:33,env_batch:[33,44,47],env_build:[29,33,34],env_cas:[31,32,33],env_mach_p:[23,29,33,34,35,41,45],env_mach_specif:[33,43,45,48],env_run:[2,3,5,6,7,8,12,14,17,25,29,33,34,37,42,44,47],environ:[16,28,33,40,43,44,45,47,48],environment_vari:43,eps_aarea:17,eps_agrid:17,eps_amask:17,eps_frac:[17,34],eps_oarea:17,eps_ogrid:17,eps_omask:17,equal:[5,9,17,34],equat:40,equinox:9,eri:[43,46],err:47,errat:47,erron:4,error:[4,11,17,29,34,36,44,47,48],ers:[43,46],ers_d:43,ert:43,esg:43,esmci:49,esmf:[15,17,25,28],esmf_regridweightgen:28,esmf_wrf_timemgr:25,esp:[29,30,40],esp_modelio:24,especi:[43,47],essenti:49,establish:[12,15,21,42],estim:[41,42],etc:[12,40,42,43,48],evap:[2,3,5,7],even:[15,34,42,46],evenli:[23,25,34],event:25,everi:[14,17,25,28,31,34,42,43,47,48],everyth:29,everywher:17,evolut:[17,44],evolv:[17,18],exact:[16,43,44,46],exactli:[2,9,11,17,18,44],examin:[2,3,5,7,8,30,46],exampl:[2,4,5,9,11,12,15,17,25,28,29,30,31,32,33,34],example1:33,example_case:[35,37],example_casep:37,exce:43,except:[2,4,5,11,17,28,29,33,37,42,44,47],exchang:[2,3,4,5,6,7,8],exclud:46,exec:43,execut:[5,9,15,22,28,29,33,37,40,41,43,44,46,48,49],exercis:[42,48],exeroot:[29,44],exist:[1,5,9,28,29,33,43,44,45],expand:5,expect:[4,12,17,18,23,25,29,43,47,48],expens:42,experi:[11,30,33,34,41],experiment:[2,42],expert:[38,41],explain:40,explan:46,explanatori:46,explicit:[25,48],explicitli:[5,44,48],express:[31,43],extend:[11,23,25,48],extens:[29,48],extent:7,extern:[5,12,15,40,44,48],extra:[9,12,47],extract:[5,17,48],extrapol:11,extrem:9,f09_g16:[5,35,37],f09_g16_rx1:33,f19:[28,30],f19_f19:46,f19_g16:[28,40,43],f90:[5,9,11,17,22,25,36],fact:[3,12],factor:[2,7,17],factorfn:2,faii_evap:7,faii_lat:7,faii_lwup:7,faii_sen:7,faii_swnet:7,faii_taui:7,faii_taux:7,fail:[29,39],failur:[46,48],fairli:23,fall:11,fall_evap:3,fall_fco2_lnd:2,fall_flxdst1:3,fall_flxdst2:3,fall_flxdst3:3,fall_flxdst4:3,fall_lat:3,fall_lwup:3,fall_sen:3,fall_swnet:3,fall_taui:3,fall_taux:3,fals:[2,3,4,5,6,7,8,9,13,48],familiar:[29,40],faoo_fco2_ocn:2,faoo_fdms_ocn:2,faq:30,fashion:[18,25,34,44],fast:48,faster:42,favor:2,faxa_bcphidri:2,faxa_bcphiwet:2,faxa_bcphodri:2,faxa_dstdry1:2,faxa_dstdry2:2,faxa_dstdry3:2,faxa_dstdry4:2,faxa_dstwet1:2,faxa_dstwet2:2,faxa_dstwet3:2,faxa_dstwet4:2,faxa_lwdn:[2,5,7],faxa_ocphidri:2,faxa_ocphiwet:2,faxa_ocphodri:2,faxa_prec:5,faxa_rain:[5,7],faxa_rainc:2,faxa_rainc_18o:2,faxa_rainc_hdo:2,faxa_rainl:2,faxa_rainl_18o:2,faxa_rainl_hdo:2,faxa_snow:[5,7],faxa_snowc:2,faxa_snowc_18o:2,faxa_snowc_hdo:2,faxa_snowl:2,faxa_snowl_18o:2,faxa_snowl_hdo:2,faxa_swndf:[2,7],faxa_swndr:[2,7],faxa_swnet:2,faxa_swvdf:[2,7],faxa_swvdr:[2,7],faxx_evap:2,faxx_lat:2,faxx_lwup:2,faxx_sen:2,faxx_taui:2,faxx_taux:2,feasibl:44,featur:[11,13,16,17,23,25,44,48],feb:11,feedback:[40,47],feel:12,few:[12,15,17,42,48],fewer:9,fhello_world_mpi:36,fieldinfo:[9,11,12],figur:15,figx1:15,file:[2,3,4,5,6,7,8],file_desc_t:9,fileatm:28,filelnd:28,filenam:[2,3,5,6,7,8,9,11,12,18,24,34,40,44],fileocn:28,fileopen:9,filepath:[9,11,12],filertm:28,fill:[5,9,11,15,17,43,48],fillalgo:[9,11],fillmask:[9,11],fillread:[9,11],fillwrit:[9,11],filter:41,find:[31,39,42,44,46],fine:[16,25,47],finish:[42,46],finit:[17,28,30],fioi_melth:[5,7],fioi_meltw:[5,7],fioi_salt:[5,7],fioi_swpen:7,fioi_taui:7,fioi_taux:7,fioo_q:[5,7],first:[5,9,11,15,17,25,28,30,31,33,34,35,37,40,42,43,44,47,48],five:[11,44],fix:[4,11,15,42],flag:[2,3,4,5,6,7,8,9],flddst1:3,fldlistfil:9,fldlistmodel:9,flexibl:[22,29,34,41,42],flgl_qice:3,flop:17,flow:[22,44],flowchart:42,flux:[2,5,7,15],flux_qacc0:7,flux_qacc:7,flux_qmin:7,flux_swpf:7,flxdst2:3,flxdst3:3,flxdst4:3,fly:11,fmulti:41,fnn:30,follow:[2,3,5,6,7,8,9,11,12,15,17,21,22,25,28,29,30,31,33,34,35,36,37,38,40,41,42,43,44,46,48],foo:48,footprint:15,forc:[2,3,5,6,7,8,15,21,23,25,43,46],force_prognostic_tru:[2,3,5,6,7,8],forgotten:48,form:[5,11,13,29,30,44,46],formal:17,format:[5,11,12,18,24,28,44,46,47],former:48,forr_rofi:6,forr_rofl:6,fortran2003:48,fortran90:36,fortran:[11,12,15,16,24,25,36,39,40],fortran_unit_test:48,forward:[11,15,25,43],found:[2,3,4,5,6,7,8,9,11,12,15,22,29,31,40,42,44,47],found_gvd:9,found_lvd:9,four:[28,48],foxx_evap:5,foxx_lat:5,foxx_lwup:5,foxx_rofi:5,foxx_rofl:5,foxx_sen:5,foxx_swnet:5,foxx_taui:5,foxx_taux:5,frac:17,frac_init:17,frac_set:17,fraclist_a:17,fraclist_g:17,fraclist_i:17,fraclist_l:17,fraclist_o:17,fraction:[5,7],fractions_:17,fractions_a:17,fractions_i:17,fractions_l:17,fractions_o:17,framework:48,freez:5,frequenc:[2,5,9,15,18,19,20],frequent:[15,40],friendli:44,from:[2,3,4],front:[5,48],frustrat:36,fswpen:5,full:[5,12,28,33,40,42,44,45,46,47,48,49],fundament:[9,12,17],further:[11,25,46],futur:[17,23,25],fv1:11,g16:28,g17:30,gain:48,gather:13,gcgcs:2,gen_cesm_map:28,gen_domain:28,gen_domain_fil:28,gen_esmf_mapping_fil:28,gen_mapping_fil:28,gener:[2,3,4,5,6,7,8,9,11,12,13,14,15,17,18,21,22,24,25,28,29,30,33,34,39,41,42,43,44,45,46,47],general_grid:15,generate:46,generic:[11,12],get:[40,43,47,48],gfrac:17,ggrid:9,giss:[2,34],git:43,github:[48,49],give:[44,48],given:[4,5,9,11,16,17,23,29,30,31,34,42,43,44,45],glacier:[3,40],glade:[11,12,48],glc:[3,28,29,30,41,42,44],glc_cplhist:3,glc_elevclass:48,glc_modelio:24,glc_nec:3,global:[9,13,15,17,28,34,48],global_segmap:15,gmake:43,gmake_j:[29,43],gnu:[36,43],goal:21,goe:45,gold:46,good:[15,33,48],gpcp:2,gptl:29,gradient:17,great:29,greater:[11,17,25,34,40],greatest:[9,11],greenland:30,grep:47,grid:[3,5,9,11,12,13,14,15],gridcel:17,gridfil:[11,28],gridmap:28,gridr:9,grids_spec_file:31,gridtyp:28,group:[2,3,4,5,6,7,8,9,11,12,15,24,31,34,44],gsmap:9,gsmapr:9,gswp3:2,guarante:[42,43,44],guid:[11,26,27,31],guidanc:47,guidelin:39,gx1v6:[5,28],gx1v6_g:33,gx1v6_r:33,gx1v6_tavg_cont:5,gx1v7:30,gx1v7_g:30,gx1v7_r:30,gxgxs:2,had:[32,34,44],half:15,hand:[30,49],handl:[9,11,15,25,29],hang:47,happen:[16,17,47,48],hardwar:[15,16,22,33,34,42,43,47],hardwir:[9,25,34,42],has:29,have:[5,9,11,12,14,15,16,17,23,25,28,29,30,31,32,33,34,37,40,41,42,43,44,46,47,48],havedata:9,heart:9,heat:5,heirarch:43,heirarchi:43,hello:36,hello_mpi:36,help:[9,11,22,29,30,32,33,34,36,40,42,43,44,45,46,47,48],helper:48,here:[1,25,27,29,31,32,33,34,36,40,43,44,47,48],hhmmss:[44,47],hierarchi:12,high:[15,22,31,42],higher:[15,17,25],highest:15,highli:[9,28],hint:44,hist:44,histor:17,histori:[2,3,5,6,12],hit:47,hold:33,home:[43,46],homebrew:43,hopefulli:11,host:43,hostnam:[28,40],hour:[2,11,25,36,42,44],hourli:[9,11,15],how:[1,2,3,4,5,6,7,8,9,11,22,26,28,30,34,36,39,40,42,43,44,46,47],howev:[2,5,12,15,17,30,41,44,45,47,48],hpc:47,hpss:44,html:33,http:[43,44,48,49],hub:49,humid:2,i2x_i:17,iaf:[2,5,30,31],iaf_docn:30,iaf_drof:30,iaf_sglc_swav:30,iaf_slnd_dice:30,ice2atm:17,ice:5,ice_cov:5,ice_in:34,ice_in_0001:41,ice_in_0002:41,ice_modelio:24,ice_pres:[3,7],icefrac:5,icesst:5,ideal:[15,42],idealli:15,ident:[9,12,15,17,18,25,28,30,34,37,43],identifi:[2,9,31,34,40,42,43],idl:[15,34,42],ifrac:[2,5,7,17],ifrad:17,ignor:[9,11,40,41,44],ijhpca:[15,25],illustr:[12,41,46],imag:15,imager:7,imbal:[15,42],immedi:48,impact:[9,13,17,25,34,42,44,46],implemenent:9,implement:[2,9,11,15,16,17,18],impli:43,implicit:36,important:32,improv:[9,15,17,34,42],inabl:17,inact:34,inc_netcdf:5,inc_pnetcdf:9,incident:48,includ:[2,5,9,11,12,17,18,25,29,30,33,34,35,37,40,42,44,49],inconsist:[17,43],incorpor:44,increas:[15,35,42,47],increment:44,incur:25,inde:11,indefinit:11,indeped:25,index:[0,10,11,20,26,27,39,49],indic:[28,29,30,34,42,44,46,47],indirectli:48,individu:[15,16,17,22,29,30,42,44],industri:[30,44],industrial:43,infin:48,infinit:17,info:9,infodata:21,inform:[5,9,11,12,15,17,18,25,29,30,31,32,34,40,42,43,44,46,47,48],informat:11,infrastructur:[15,22,26,27,40,41,46,48,49],infrequ:[15,42],ingrain:40,inher:[11,42,43],init:[9,15,21],initarr:9,initi:[7,9,15,16,17,21,25,35,37,39,42],initial:[15,19,20],inout:48,input:[2,3,4],input_data_list:[29,44],input_templ:5,inputdata:[5,9,11,12,43,44],insid:[17,25],instal:[28,33,40,43,48],install:[28,40,48],instanc:[2,3,5,7,9,11,15,19,20],instanten:14,instead:[5,11,48],institut:44,instruct:[5,22,28,48],instruction:40,integ:[9,14,25,30,36],integr:[1,16,18,25,43,44],intel:[29,46],intend:[34,48],intent:48,inter:[7,49],interact:[25,29,43,48],interannu:[2,5,6,30],interconnect:42,interfac:[3,9,12],intermitt:[42,43,47],internat:[22,42],internet:43,interp:9,interpa:12,interpb:12,interpc:12,interpol:[4,5,9,11,12,15],interpret:[5,15,40,42,46],interv:[11,14,44],intra:[6,49],intrins:[16,34,43],intro:40,introduc:[17,25,28,30,37],introduct:0,invari:4,invok:[5,34,41,42],invoke:29,involv:[14,28,34,41,42],io_desc_t:9,io_root:9,io_strid:9,io_typ:9,ioff:6,iosystem_desc_t:9,iradsw:2,ish:48,isotop:2,issu:[11,15,17,22,32,36,43],itself:[9,11,35,37,43,44,48],jacob:42,jan:47,jenkin:46,jgfouca:46,job:[15,33,35,37,39,42,43],job_queue:44,job_wallclock_time:[35,37,44],journal:[22,42],jpg:15,junit:48,just:[5,9,11,12,15,17,25,28,32,40,42,48],k_gvd:9,k_lvd:9,k_testcimecas:46,kalman:41,keep:[9,18,33,42,44],kelvin:[4,5],kernal:15,keyword:[11,34],keywword:2,kind:36,know:[11,12,48],knowledg:12,known:48,l2r:17,lab:15,lag:[15,25,34],laid:34,lambm0:9,lamult:8,land:2,languag:40,larg:[2,9,15,17,43,44,47],larger:[25,30],largest:16,last:[5,9,11,17,21,43,47],lat:[2,3,5,7,9,11,12,17,30],later:[5,11,12,15,48],latest:[44,47],latitud:[5,9,17],launch:[16,47],layer:5,layout:[15,24,25,29,31,33],lead:[5,48],leak:48,least:[9,11,15,42],leav:42,left:[11,46],len:36,lend:44,length:[5,15,18,25,33,42,47],less:[5,9,17,40,48],let:41,letter:33,level:[14,15,16,22,33,40,43,46,48],leverag:[9,28],levi:28,lfrac:[2,3,17],lfrin:17,lib:[29,40],lib_netcdf:5,lib_pnetcdf:9,librari:[9,24,25,29,33,39],licens:40,license:40,like:[2,5,11,12,15,16,17,25,28,31,42,43,44,46,47,48],limit:[9,11,15,16,25,39],line:[5,15,17,34,35,37,40,43,47,48,49],linear:[5,9,11],linearli:[11,42],link:[40,44],linux:43,list:[9,11,12,28,29,30,31,33,43,44,46,48],lmwg:2,lnd2atm:17,lnd2rtm:17,lnd:[3,11,17,28,29,30,34,41,42,44,49],lnd_in:34,lnd_in_0001:41,lnd_in_0002:41,lnd_modelio:24,lndname:28,lndname_ocnnam:28,load:[15,27,33,34,37,42,43,44,45,48,49],local:[9,11,13,15,17,29,32,43,44,47,48],locat:[5,9,11,22,29,34,43,44,48],lock:[33,44],lockedfil:33,log:[17,18,29,35,37,42,43,44,46,47],logdir:44,logic:9,login:43,lon:[5,9,11,12,17,30],longer:[5,17,25,33,44,47],longitud:[5,9,17],longnam:[30,31],longwav:2,look:[11,12,28,31,35,37,42,44,46,47,48],loop:[2,3,6,11,16,19,20,22],looser:15,lost:5,lot:48,low:[31,42],lower:[9,11,25],lsf:43,lsize:9,lsizer:9,lt_archiv:33,ltarchive_spec_file:31,lwdn:[2,5,7],lwdn_af:2,lwup:[2,3,5,7],mac:[36,43],mach:[31,43],machin:[9,28,30],machine_compiler:46,machine_spec_file:31,machines_spec_file:31,macport:43,macro:[9,29,33,45],made:[14,15,17,32,34,42,44,45,46],magazin:48,mai:[4,9,11,15,17,25,28,29,30,40,42,43,44,46,47,48],main:[11,22,25,40,43,48,49],maintain:[25,40,44,48],major:[17,44,48],make:[5,9,11,14,17,25,28,29,30,33,34,35,37,40,42,43,44,45,46,47,48],makefil:[5,45],manag:[12,18,19,20,21,24],manage_cas:[30,31],manage_testlist:39,manange_cas:28,mandatori:46,mangl:47,mani:[9,11,17,18,21,28,36,43,46,48],manner:44,manor:25,manual:[11,29,32,48],map:[2,3,5,6,7,8,9,11,12,13,15],map_atmname_to_lndname_aav:28,map_atmname_to_lndname_blin:28,map_atmname_to_ocnname_aav:28,map_atmname_to_ocnname_blin:28,map_atmname_to_ocnname_patc:28,map_atmocn_mct:17,map_lndname_to_atmname_aav:28,map_lndname_to_rtmname_aav:28,map_ocnname_to_atmname_aav:28,map_ocnname_to_atmname_blin:28,map_ocnname_to_lndname_aav:28,map_rtmname_to_lndname_aav:28,mapa2:17,mapa2i:17,mapa2l:17,mapa2o:17,mapalgo:[9,11,12],mapi2a:17,mapi2o:17,mapl2a:17,mapmask:[9,11],mapo2a:17,mapo2i:17,mapper:15,mapread:[9,11],mapwrit:[9,11],mar:11,markdown:40,mask:[9,11,12,17,28,30],mask_g:30,massiv:42,mast:14,master:[2,3,5,6,7,8,36,46],match:[2,3,5,7,8,17,25,31,44,46,47,48],matrix:9,max:9,max_tasks_per_node:43,maxim:[5,15,42],maximum:[11,15,16,17,25,42,43],mct_avect:9,mct_ggrid:9,mct_gsmap:9,mct_rearr:9,mct_smatp:9,mean:[5,9,15,17,28,34,42,43,46,48],mechan:44,meet:[9,21,25],melt:[5,7],melth:[5,7],meltw:[5,7],melvin:43,melvin_gnu:46,member:48,memcomp:46,memleak:46,memori:9,mention:[12,15,17,25,43],mere:5,merg:[15,17,21,22,25,34,43,48],messag:[4,17,29,40,44,47,48],met:43,meta:[9,11],method:[9,11,12,15,17,18,21,25,39,42,44],metric:42,michael:28,microwav:7,mid:[5,11,47],middl:[5,11,18],might:[4,5,11,12,15,17,23,25,31,42,47,48],migrat:44,millisecond:48,min:9,mind:44,minim:[9,15,21,25,42,47,48],minimum:[11,12,16,17,30,42,43,44,48],minu:28,minumum:43,minut:44,miscellan:26,miss:[4,5,9,11,29,44],missing_valu:5,misunderstood:34,mix:[5,15,41,42,49],mkdir:48,mkmapdata:28,mksurfdata:28,mksurfdata_map:28,mktemp:48,mlevy_at_ucar_dot_edu:28,mod:[31,33,46],mode:[2,3,4],model_build:46,model_grid:28,model_pres:4,modeldt:9,modif:[11,32,34,37,43,45],modifi:[5,11,12,17,28,29,30,33],modify_via_xml:34,modul:[0,9,10,20,26,27,29,39,43,45,46,48,49],module_system:43,monitor:[39,40,43],month:[5,11,15,35,37,42,43,44,47,48],monthli:[5,9,11,14,18,44],more:[5,9,11,12,15,19,20],mortem:46,mosart:30,most:[9,11,12,18,25,28,29,33,40,42,47,48],motiv:41,move:[9,15,21,25,33,44,47,48],mpi:[9,15,16,21,34],mpi_comm_rank:36,mpi_comm_siz:36,mpi_comm_world:36,mpi_final:36,mpi_get_processor_name:36,mpi_init:36,mpi_max_processor_name:36,mpi_wtime:36,mpich:[36,48],mpilib:[43,48],mpilibs:[43,48],mpirun:43,mrg:17,mrg_x2a:17,mrg_x2o:17,much:[9,15,17,25,42,48],multi:[5,19,20],multipl:[2,3,5,7,11,12,15,23,25,28,34,40,41,42,43,45,48],multipli:17,must:[4,5,9,11,18,23,25,28,29,30,33,34,40,42,43,44],mutual:34,mvelpp:9,my_build_dir:48,my_test_id:46,mycas:40,mype:36,myproj:46,myqueu:46,mytest:46,n_gvd:9,n_lvd:9,name:1,name_l:30,name_m:30,name_oi:30,name_r:30,name_w:30,nameatm:28,namelist_definition_datm:[2,11],namelist_definition_dic:7,namelist_definition_dlnd:3,namelist_definition_docn:5,namelist_definition_drof:6,namelist_definition_drv:34,namelist_definition_dwav:8,namelist_definition_file:31,namelist_var:11,namelnd:28,nameocn:28,namertm:28,namlist:9,nan:48,nation:[15,40],ncap2:5,ncar:[2,15,28,48],ncdump:5,ncep:[2,11,12],ncgen:5,nck:5,ncpl:25,ncpl_base_period:25,ncrcat:5,ncrenam:5,ndai:[42,44],ne30:30,ne30_g16:[30,41,43],ne30_ne30:43,ne30np4:30,ne30np4_l:30,ne30np4_oi:30,nearest:[9,11],nearli:[15,25],necessari:[5,27,28,29,35,37,40,44,48],necessarili:15,need:[2,3,4,5,6,7,9,11,12,15,16,17,25,28,29,31,32,33,37,40,41,42,43,44,47,48,49],neg:[2,11,34],neighbor:11,neither:43,net:[14,17,48],netcdf:[5,9,11,18,43,44,47,49],never:[17,33,34,42],new_namelist_valu:11,newer:43,newgrid:28,next:10,nfile:9,nflds_snow:3,nif:7,nightli:46,ninst:[34,41],ninst_:23,ninst_atm:41,ninst_ice:41,ninst_lnd:41,ninst_ocn:41,ninst_rof:41,nlat:[5,30],nlcomp:46,nlon:[5,30],nml:24,nmlo:24,nmonth:[18,35,37,44],nnnn:[41,45],nnoni:11,nnonj:11,node:[15,31,34,42,43,47],nodename_regex:43,noevolve_ww3_bgc:30,nomask:11,non:[4,5,17,28,33,46,49],none:[2,3,5,6,7,8,36,43],nonsolarflux:2,noout:43,nor:43,normal:[2,5,7,9,11,14,17,18,25,34,42,44,47],north:17,northward:17,not_set:11,note:[2,5,11,17,24,29,30,34,35,40,44,46,47,48],notifi:46,now:[17,25,34,42],npfix:17,nstream:9,nstrmax:9,ntasks:[33,34,41],ntasks_ice:34,ntasks_ocn:34,nthrds:[33,34,41],nthrds_ice:34,nthrds_ocn:34,nthrrds:34,null_w:[30,33],num_iotask:9,number:[2,3,5,9,11,15,16,17,25,30,33,34,36,41,42,43,44,45,48],numer:[28,40],nvecmax:9,nvector:9,nxg:9,nyear:[18,42,44],nyf:[11,12],nyf_sglc_swav:[30,33],nyf_sglc_swav_desp:30,nyf_slnd_dice:[30,33],nyg:9,nzg:9,obj:29,object:[29,43],obliqr:9,obliqu:9,observ:[2,5,6,7,12,44],obtain:[5,11,29,30,31,34,44],obviou:44,obvious:42,occasion:[42,44],occupi:[29,40],occur:[9,15,42],ocean:2,ocean_tight_coupl:25,ocn2atm:17,ocn:[5,17,28,29,30,34,41,42,44,49],ocn_coupling:34,ocn_grid:28,ocn_ice_forcing:34,ocn_in:34,ocn_modelio:24,ocn_pres:5,ocn_transient:34,ocnnam:28,ocnnext_alarm:25,ocnrun_alarm:25,ocphidri:2,ocphiwet:2,ocphodri:2,octal:5,off:[2,3,4,5,6,7,8,11,12,14,15,16,29,34,42,44,48,49],offici:25,offlin:[17,28],offset:[9,11,12,25],ofrac:[2,17],ofrad:17,often:[9,11,12,15,34,42,44,47,48],okai:43,old:[5,17],older:44,omit:28,omp_num_threads:16,omp_set_num_thread:16,omp_stacksize:43,onc:[15,25,41,45,48],once:[11,15,43,44,48],one:[2,3,5,6,7,8,15,17,42,43,47],onli:2,only:[11,29,34,41,43],onto:48,open:[9,46],openmp:[15,16,34,42,48],oper:[2,3,5,6,7,9,11,12,13,15,17,21,33,42,43,48],oppos:[9,11],optim:[9,17,29,31,42,44],optimal:42,optimiz:[34,39],optimum:15,option:[5,9,11,12,13,15,17,18,24,29,30,33,39,40,42],optional:[9,30,43,48],orbit:9,order:[9,11,13,17,21,29,30,31,39,42,43,44],organ:33,origin:32,other:[2,5,7,11,12,13,14,15,16,17,22,23,25,28,30,31,33,34,40,42,44,48,49],otherwis:[25,28,32,43,48],our:42,out:[5,11,12,13,17,21,22,28,30,31,33,34,41,42,43,44,47,48],outlin:5,output:[3,4,5,6,11,12,14,17,18,24,25,28,29,30,31,33,39,40,41,42,43],output_root:46,outsid:11,over:[2,3,5,6,9,11,14,15,17,18,21,25,42,43,47,48],overal:[15,17,42],overflow:47,overlap:[12,15,25,34,42],overload:30,overlook:17,overrid:29,overridden:43,overview:[9,10],overwrit:[43,44],overwritten:[34,45],ovf:44,own:[4,11,15,28,29,30,43,44,47,48],pack:12,packag:[15,39],page:[0,10,20,26,27,39,49],pair:[2,11,30,34],parallel:[9,12],paramet:[15,17,34,41,43,44],parent:43,pars:[11,31,47],part:[5,9,15,18,22,26,29,30,33],partial:[11,13,17],particular:[5,11,12,15,17,34,41,42,43,49],particularli:[15,17,48],partit:[34,42],pass:[2,3,5,7,8,12,15,25,43,46,48],past:17,patch:[5,28],path:[5,9,29,39],pathnam:[28,33],pattern:15,pbot:2,pbot_af:2,pdf:48,pelayout:33,pend:[11,46],penetr:7,per:[5,15,16,25,34,42,43],percent:[5,17],perfect:15,perform:[5,9,11,12],perhap:4,perihelion:9,period:[2,11,12,14,18,25,30,44],perl:40,permiss:[11,34],permit:[30,33],perspect:[12,42],pes:43,pes_per_node:43,pes_spec_file:31,pesiz:31,pfunit3:48,pfunit:39,pfunit_path:48,phase:[15,16,21,44,46],phy:[30,34],physic:[5,9,15,43,47,49],pick:11,piec:[42,48],pinpoint:48,pio:[9,24,29,33],pio_inparm:21,pio_iodesc:9,pio_spec_file:31,pio_subsystem:9,place:[5,11,17,28,29,33,34,40,41,42,43,44,46,47,48],plai:25,plain:11,platform:[33,39],pleas:28,plot:43,pnetcdf:[9,43],pnetcdf_path:9,point:[2,5,11,16,17,23,25,29,30,33,34,41,42,44,48],pointer:[9,29,44,48],polar:17,pole:[17,28,30],pop2:[2,5,30],pop2_blckx:34,pop2_blcky:34,pop2_decomptype:34,pop2_mxblcks:34,pop:[5,7,31],popul:29,port:[26,31,33,36],portion:48,posit:[11,25],possibl:[5,9,12,15,25,28,29,30,31,42,43,44,47,48],post:[44,46],potenti:[5,15,17,25,36,42,43],practic:[9,15,42,43,48],pragprog:48,pre:[2,3,5,6,7,8,11,30,43,44],prec:[2,5],prec_af:2,preced:31,precip:[2,11],precis:[5,17],precsf:2,predict:9,prefer:[44,48],prefix:23,prepend:[11,34],preprocess:15,prerequiset:43,prerequisit:39,presaero:[2,11],prescrib:[2,5,7,12,30,34,41],prescribed_0001:41,prescribed_0002:41,presenc:29,present:[9,12,15,28,44],preserv:[13,17,32],pressur:2,prestag:37,presumpt:17,pretti:[42,43,46],prev_histori:5,prevent:[15,33],preview:34,preview_namelist:[11,33,34,44],preview_namlist:44,previou:[2,3,5,6,9,12,25,28,29,33,37,39,43],previous:2,primari:[9,24,31,41],primarili:[6,8,12,22],principl:15,print:[33,46,47,48],prior:[16,28,36,43,46],privat:9,probabl:44,probe:46,problem:[9,14,33,39,40,43,44],proc:46,proce:29,procedur:[5,43,48],proceed:33,process:[15,28,29,36,40,43,44,48],processor:[9,13,15,16,21,22,25,31,33,34,39],produc:[2,3,17,18,42,43,44,47,48],product:[12,15,18,42,43,44,48],prof_inparm:21,profile:42,prognost:[2,3],program:[22,36,43,49],programm:49,progress:[40,44,46],proj3:[11,12],project:[26,43,44,46,48],project_required:43,pronghorn:31,proper:[5,25],properli:[17,43],properti:11,propos:42,proven:33,provid:[2,3,4,5,6,7,8,11,12,13,15,17,22,24,25,28,29,34,40,41,42,43,44,46,47,48],proxi:43,proxy:43,pslv:[2,5,11,12],pstrid:34,pt1:30,ptem:[2,7],pull:43,pure:5,purpos:5,put:[11,41,44,46,48],python:[40,46,48,49],q10:11,q_10:[2,12],qbot:5,qian:2,qicenn:3,qref:[2,3,7],qsub:47,quantiti:17,queri:28,queue:[15,31,33,42,43,44,46,47],quick:39,quicker:9,quickli:[40,42],quit:[9,47,48],quota:[44,47],r05_m:[30,33],radian:9,radiat:[2,15,17,21,25],rain:[5,7],rainc:2,rainc_18o:2,rainc_hdo:2,rainl:2,rainl_18o:2,rainl_hdo:2,ram1:3,ran:29,random:48,rang:[11,38],rank:15,rare:42,rate:7,rather:[12,30,34,40,48],ratio:[11,17],raw:44,rcp8:30,reach:47,read:[3,4,5,6,7,9,11,12,15,21,40,43,44,47,48],readi:43,readme:[28,32,33,40,48],real:[9,36,48],realiz:11,realli:[4,25],reanalysi:12,rearrang:[9,13,15,17,21,25],rearrr:9,reason:[9,15,17,34,42,43,44,48],rebuilt:29,receiv:[4,7,12,15,17,40,44],recent:9,recogn:[17,40],recommend:[28,29,42,43],record:[40,45],recreat:45,redirect:47,reduc:[9,25,40,47],redund:9,refer:[2,5,11,15,17,22,25,30,34,40,41,42,44,45],referenc:[5,9],referencemanu:48,reflect:[17,29],regard:46,regardless:[15,48],region:17,regress:[30,39],regrid:[9,17,49],regular:[30,31,43],regularli:18,reintroduc:11,reiter:25,rel:[9,15,17,18,24,25,29,34,42,44,47],relat:[2,3,5,6,7,8,9,11,15,17],relax:44,releas:[29,44],relev:[11,32,44],reli:15,reliabl:42,remain:[17,21,42,44,48],remaind:44,remot:9,remov:[5,11,41,45,47],renam:[5,45],repeat:[5,40,46,48],repeatedli:11,replac:[1,5,40,48,49],replic:2,report:[47,49],repositori:[5,43],repres:[15,25,46],reproduc:[43,44,46],request:[18,23,31,34,43,44,47],requir:[2,3,5,6,7,8,9,11,12,15,17,18,21,23,25,28,29,30,33,39,40,41,42],reread:9,rerun:[11,29],rescal:17,reset:48,resid:29,resolut:[5,15,17,28,30,33,34,35,40,42,43,49],resolv:[15,33],resourc:[42,48],respect:[14,17,34,42,43,44,48],respons:[12,15,25,43],rest:[37,44],rest_date:44,rest_n:[42,44],rest_option:[42,44],restart:[2,3,5,6,7,8],restart_n:18,restart_opt:18,restart_option:42,restart_ymd:18,restfil:[2,3,5,6,7,8],restfilm:[2,3,5,6,7,8,9],restrict:11,resubmit:[35,37,44,47],result:[2,5,9,11,13,15,17,18,23,25,30],resumit:37,reus:[11,12,48],review:[33,42,43,47],revis:32,right:[11,25],risk:29,robust:23,rof:[6,28,29,30,41,42,44],rof_in:34,rof_in_0001:41,rof_in_0002:41,rof_modelio:24,rof_pres:6,roff:6,rofi:5,rofl:5,rofospher:6,role:25,root:[2,3,5,6,7,8,13,15,29,31,33,34,35,43,46],rootpe:[33,34,41],rootpe_ocn:34,roundoff:17,rout:30,routin:[9,17,21,48],rpointer:[9,18,44],rtm:[28,30],rtmname:28,rule:[42,48],run:[2,3,4],run_refcase:[37,44],run_refdate:[37,44],run_startdate:[5,44],run_test:48,run_type:[37,44],rundir:[11,29,37,44,47],running:46,runoff:[6,12,15,17,21,25,28],runtim:[17,33,34,39,42,45],sa_co2diag:2,sa_co2prog:2,sa_den:[2,7],sa_lwdn_af:2,sa_pbot:2,sa_pbot_af:2,sa_prec_af:2,sa_precsf:2,sa_pslv:[2,5],sa_ptem:[2,7],sa_shum:[2,7],sa_shum_16o:2,sa_shum_18o:2,sa_shum_af:2,sa_swdn_af:2,sa_tbot:[2,7],sa_tbot_af:2,sa_topo:2,sa_u:[2,7],sa_u_af:2,sa_v:[2,7],sa_v_af:2,sa_z:[2,7],sack:48,safe:48,safer:5,safest:29,sai:[36,41,42],salin:5,salt:[5,7],same:[2,3,5,7,9,11,12,16,17,18,23,25,28,30,34,40,41,43,44,46,47,48],samegrid:17,samegrid_:17,samegrid_ao:17,samegrid_ro:17,sampl:9,sandbox:31,satisfi:43,satm:[30,31],save:[5,9,11,12,15,36,44],save_timing_dir:43,scalabl:15,scalar:[9,15,17,18],scale:[11,15,17,42,43],scatter:9,scenario:[30,37,44],schedul:[46,47],schema:[31,43],scheme:[25,44],scienc:[2,3],scientif:[5,15,21,25,34,42,43,49],scope:48,scpl_sice_socn_srof_sglc_swav:30,scratch:[29,44,46],scrip:[15,28],script:[2,3,4,5,6,7,8,11,17,25,26,28,29,30,31,32,33,34,35,37,39,40,42,43,44,45],scripts_regression_test:[43,46,48],sea:[5,7,15,17,25,30],search:[0,9,10,20,26,27,28,31,39,42,43,47,49],season:[15,42,43],sec:[9,48],secifi:11,second:[9,11,15,17,21,25,28,34,42,43,44,46,47,48],section:[9,10],see:[9,11,25,28,29,30,32,33,34,40,42,43,44,45,46,47,48],seem:9,seg:9,select:9,self:[17,46,48],sen:[2,3,5,7],send:[4,12,28,40,44,47],sens:[42,47],sensit:44,sensor:7,sent:[2,3,4,5,6,7,8,9,12,15,17,21],separ:[2,3,5,6,7,8,9,12,15,22,25,42,43],seper:43,seq_domain_mct:17,seq_frac_mct:17,seq_infodata:21,seq_map:[17,24,48],seq_mct_drv:[35,37],seq_timemgr:21,seq_timemgr_mod:25,sequenti:[15,23,34,42],seri:[2,11,15,24,42,44],serial:[9,41,43,48],serious:17,serv:[11,44,48],server:[29,44],sesp:30,set:[2,3,4,5,6,7,8,9,11,12,13,14,15,16,17,18,21,23,24,25,28,29],setenv:40,setup:[12,15,29,33,34,35,37,39,40,41,42,44],setup_outfil:5,sever:[2,9,11,14,15,17,24,27,40,42,43,44,47],sf_ifrac:2,sf_lfrac:2,sf_ofrac:2,sglc:30,share:[11,12,15,16,29,40,43,48],sharedlib:46,sharedlib_build:46,sharedlibroot:29,shell:[43,45,48],shift:[11,25],shnum:11,shortest:25,shorthand:30,shortwav:[2,7,17],should:[2,3,4,5,6,7,8,11,15,17,18,23,24,25,28,29,33,34,37,40,41,42,43,44,45,46,47,48],shouldn:48,show:[12,15,48],shown:[29,31,33,36,40,47],shr_dmodel_mod:9,shr_kind_cl:9,shr_kind_cs:9,shr_kind_cxx:9,shr_kind_in:9,shr_strdata:9,shr_strdata_mod:11,shr_strdata_nml:[2,3,4,5,6,7,8,9,10],shr_strdata_typ:9,shr_stream_file_nul:9,shr_stream_filetyp:9,shr_stream_mod:9,shr_stream_streamtyp:9,shum:[2,7,12],shum_16o:2,shum_18o:2,shum_af:2,si_anidf:7,si_anidr:7,si_avsdf:7,si_avsdr:7,si_ifrac:[5,7,17],si_qref:7,si_t:7,si_tref:7,sice:30,sign:25,signal:48,signific:[9,12,15,29,34,42,47],significantli:15,similar:[11,30,44,48],similarli:7,simpl:[9,11,33,43,48,49],simplest:[32,43],simpli:[5,11,12,28,40,43,48],simplifi:[25,28],simul:[2,3,5,6,17,33,42,43,47],simulated_year:42,sinc:[5,14,17,28,34,41,45],singl:[2,5,12,15,17,23,28,30,41,42,43,44,46,48,49],site:[2,47],six:[25,48],size:[9,15,17,42,47],skip:[28,48],sl_anidf:3,sl_anidr:3,sl_avsdf:3,sl_avsdr:3,sl_fv:3,sl_landfrac:3,sl_qref:3,sl_ram1:3,sl_snowh:[2,3],sl_t:3,sl_topo:3,sl_tref:3,sl_tsrf:3,slab:[5,30],slightli:[12,17,25,46],slnd:30,slow:47,slp_:[2,11,12],slurm:43,small:[9,15,17,48],smallest:25,smatp:9,smatpf:9,smooth:28,smp:29,smp_build:29,smp_value:29,sms:46,sno:3,snow:[3,5,7],snowc:2,snowc_18o:2,snowc_hdo:2,snowh:3,snowhl:2,snowl:2,snowl_18o:2,snowl_hdo:2,so_:[5,7],so_dhdi:[5,7],so_dhdx:[5,7],so_duu10n:5,so_fswpen:5,so_t:[2,5,7],so_u:[5,7],so_v:[5,7],socn:30,soft:43,softwar:[25,40],software_environ:45,solar:[2,11,34],solar_const:34,solv:40,som:[5,30],somaqp:30,some:[4,5,11,12,15,17,22,25,28,33,34],somedata:48,someth:[11,25],sometim:[11,40,46,47,48],somewhat:[42,44],somewher:9,sourc:[9,11,12,13,17,22,32,33,40,43,44,48,49],sourceforg:48,sourcemod:[5,29,32,33],space:[9,11,12,15,29,30,44,47],span:38,spars:9,spatial:[4,5,9,11,12,15],specfi:12,special:[2,3,5,7,8,11,29,48],specif:[2,9,11,12,15,22,25,28,30],specifi:[2,3,4,5,6,7,9,11,12,14,15,17,18,23,24,25,28,29,30,31,34,35,40,43,44,48],spectral:30,speed:48,sphere:30,spin:[2,15,42,43],spinup:[2,12],split:40,spoke:49,spot:[15,42],spread:[11,34],spval:11,src:[2,3,5,6,7,9,29,31,34,40,48],srcmask:11,srcroot:[5,31,34],srof:30,ssmi:7,ssmi_docn:[30,33],ssmi_iaf:7,ssss:44,sssss:44,sst:[5,7,11,30],sst_aquap:30,sst_cpl:5,sstice_data_filename:5,sstice_grid_filename:5,sstice_stream:5,sstice_t:5,sstice_year_align:5,sstice_year_end:5,sstice_year_start:5,ssticetemp:5,st_archiv:[33,43,44],stabil:[15,25],stage:44,stamp:[12,29,47],stand:[27,46,49],standalon:[30,40],standard:[4,5,9,15],start:[2,3,5,6,9,14,15,18,33,34,37,39],startup:44,state1hr:2,state3hr:2,state:[7,17,18,25,44,46,48],statement:48,statist:[23,27,42,49],statu:[44,46,48],status:[29,39],stderr:44,stdout:44,step:[2,5,9,14,15,17,25,28,33,35,39,41],still:[15,17,23,25,28,44,47,48],stop:[11,18,39],stop_date:44,stop_n:[35,37,42,44],stop_option:[35,37,42,44],storag:44,store:[9,43],str_fillalgo:9,str_fillmask:9,str_mapalgo:9,str_mapmask:9,straight:15,strategi:[2,3,5,6,7,8,42],strdata:[9,11,12],stream1:11,stream2:11,stream_input_filenam:11,streama:12,streamb:12,streamc:12,streamn:11,stress:41,stride:34,string:[2,3,4,5,6,7,8,11,34,40,47,48],strm_h:5,strm_qbot:5,strnxg:9,strnyg:9,strnzg:9,strong:15,strongli:[29,42],stub:[34,40,41,49],stub_comp:31,studi:44,stuff:48,sub:[11,30,33,40,43],subdirectori:31,subject:42,submiss:[34,39,43,44],submit:[33,34,35,37,39,40,43],subroutin:[15,17,48],subsequ:[18,31],subset:[11,15,22,25,42,44],substitut:40,subtl:[17,25],subvers:29,succeed:[35,37],success:[16,40,44,47,48],successful:[35,37,47],successfulli:[29,43,44,46,47],suffici:5,suggest:[29,47],suit:[28,46],sum:[13,17],summar:[22,29,34,42,45],summari:[11,15,17,42,43],supercomput:40,suppli:[1,46],support:[2,3,5,6,7,8,9,11,12,15,17,18,25,28,29,30,31,33,34,39,40,41,42,43,44],supported_by:43,sure:[9,11,14,25,34,35,37,42,44,47,48],surfac:[2,5,7,15,17,21,25,28,40],surrog:9,suspect:47,sw_lamult:8,sw_ustok:8,sw_vstoke:8,swav:30,swdn:2,swdn_af:2,sweet:[15,42],swndf:[2,7],swndr:[2,7],swnet:[2,3,5,7,17],swpen:7,swup:2,swvdf:[2,7],swvdr:[2,7],sx_anidf:2,sx_anidr:2,sx_avsdf:2,sx_avsdr:2,sx_qref:2,sx_t:2,sx_tref:2,sync:44,synchron:[21,25],syntax:11,system:[1,11,15,16,17,21,22,25,28,29,30],system_tests_dir:31,t31_g37:43,t62:[11,12,31],t62_g16:43,t85:30,t_10:[2,11,12],tab:11,tabe:[2,3,5,6,7,8],tag:43,tail:40,take:[5,9,12,17,42,43,46,47,48],taken:[4,11,14],tape:44,tar:44,target:[2,9,11,29],task:[2,3,5,6,7,8,9,15,16,23,25,34,41,43],taui:[2,3,5],taux:[2,3,5],tauxa:7,tauxo:7,tauya:7,tauyo:7,taxmod:[5,9,11],tbot:[2,7,11,12],tbot_af:2,tdd:48,teardown:39,tell:[17,44,48],temp2:5,temp:5,temperatur:[2,4,5,17],templat:[25,40,43],tempor:[2,4,11,12,15,25,42,43],ten:15,term:[14,17,33,39],termin:[40,47],termination:[35,37,47],test:[5,15,18,26,27,28,30,31,36],test_cime_cas:46,test_circl:48,test_root:46,test_suites:46,testcas:[46,48],testcircl:48,testid:46,testmods:46,tests:[43,46],tests_mods_dir:31,tests_spec_file:31,teststatu:46,testtype:46,text:[11,12,32,34,40,43,44,47],than:[2,5,9,11,12,17,25,30,31,34,40,42,47,48],thei:[2,3,5,7,8,9,11,12,15,17,18,29,33,34,40,41,42,43,45,46,47,48],them:[11,15,27,29,33,43,44,46,47,48],therebi:11,therefor:[5,11,34,44],thi:[2,3,4,5,6,7,8,9,11,12,13,14,15,16,17,18,21,22,23,25,28,29,30,31,32,33,34,35,40,41,42,43,44,45,46,47,48],thing:[11,12,17,42,43,46,47,48],third:15,those:[2,3,5,6,7,8,9,11,12,13,16,17,21,23,25,29,31,32,34,44,47],though:[9,17,48],thoughput:42,thought:17,thousand:15,thread:15,three:[9,12,15,16,17,34,44],through:3,throughout:[11,48],throughput:[15,34,42,43,44,46],thu:44,tightli:15,time:[2,4,5,9,11,12,15,17,18,19,20,21,22,23,24],time_atm:30,timeout:47,timer:42,timescal:43,timestamp:[9,11,18,47],timestep:[9,15,17,25,42,47],timing:42,tintalgo:[9,11],tinterpalgo:9,tlat:5,tlon:5,tlong:5,tnn:30,tod:9,todlb:9,todo:[5,9,41,43],todub:9,togeth:[13,40,44],toler:[17,48],took:[46,47],tool:[5,17,21,26],toot:34,top:[15,22,33,34,40,43,46,48],topo:2,topographi:2,toponn:3,total:[5,9,15,17,22,34,35,37,42],toward:43,tower:2,tpqw:[2,11],track:[18,33,42,43,46],trans_1850:11,transfer:25,translat:[2,3,5,6,7,8],trap:11,tream:9,treat:[15,17,42],tree:[22,29,32,34,48],tref:[2,3,7],trigger:[18,25],tripol:30,troubleshoot:39,truncat:[17,30],trunk:48,tsrfnn:3,tstamp:[42,43,47],tstamp_writ:47,turn:[2,3,4,5,6,7,8,9,11,12,14,15,16,29,42,43,44,47],tweak:28,two:[2,3,4,5,6,7,8,9,11,12,15,17,21,23,25,30,31,34,36,42,43,44,46,48],txt:[11,34,40,41,45,48],type:[2,9,13,15,17,31,39,40,42,43],typic:[9,12,15,17,25,31,40,42,44,47,48,49],u_10:[2,11,12],u_af:2,ucar:44,uiliz:2,unalt:4,uncommon:47,under:[15,22,29,40,41,44],undergo:28,underli:[17,46],understand:[22,30,36,42,48],undertak:42,unexpect:48,uniform:11,union:[34,42],uniqu:[2,3,5,6,7,8,12,15,17,30,34,40,42,44,48],unit:[25,39,40,42,43],unit_test:[40,48],uniti:28,unittest:46,unix:40,unknown:42,unless:[4,33,42,43,44],unlik:4,unlike:[18,44],unlock:33,unmask:28,unpredict:47,unreli:48,unrepeat:48,unscal:17,unset:[31,43],unsur:42,until:[17,25,40,44,46],upcom:41,updat:[2,5,17,25,44,46],update_acme_test:46,upon:[9,15,17,44,46],upper:[9,11],usag:[9,15,26,28,29,32,33,34,41,46,47,48],usage:[26,30],use:[11,26,29,35],used:46,useful:47,user:[2,3,4,5,7,8,9,11,12,15,16,17,22,26,28,29,30,31,33,34,37],user_:[11,34],user_datm:[11,34],user_dic:34,user_dlnd:34,user_docn:[34,41],user_drof:34,user_mods_dir:31,user_nl:45,user_nl_:[37,41],user_nl_c:34,user_nl_cam:34,user_nl_cam_0001:41,user_nl_cam_0002:41,user_nl_cic:34,user_nl_cice_0001:41,user_nl_cice_0002:41,user_nl_clm:34,user_nl_clm_0001:41,user_nl_clm_0002:41,user_nl_cpl:[34,41],user_nl_datm:[2,11,34],user_nl_datm_nnn:34,user_nl_dic:[7,34],user_nl_dice_nnn:34,user_nl_dlnd:[3,34],user_nl_dlnd_nnn:34,user_nl_docn:[5,34],user_nl_docn_0001:41,user_nl_docn_0002:41,user_nl_docn_nnn:34,user_nl_drof:[6,34],user_nl_drof_nnn:34,user_nl_dwav:8,user_nl_pop2:34,user_nl_rtm:34,user_nl_rtm_0001:41,user_nl_rtm_0002:41,user_nl_xxx:[11,33,34,45],user_nl_xxx_nn:41,user_nl_xxx_nnnn:41,user_nl_xxxx:32,user_xxx:11,userdefined_laptop_templ:43,users:41,using:[28,39],usr_gdat:28,usr_gnam:28,usrspec:28,ustok:8,ustrm:9,usual:[16,18,30,36,40,42,43,44,47,48],util:[9,11,17,28,29,30,33,34,40,49],utiliz:41,uwind:2,v_10:[2,11,12],v_af:2,val:34,vari:[5,15,17,42],variablenam:[11,12],variat:[9,42,47],varieti:38,variou:[4,5,15,26,29,31,33,42,46],vect_map:17,vector:[2,3,5,6,7,8,9,11,17],veloc:17,veri:[7,15,17,36,42,43,48],verifi:[4,11,17,34,43,44,48],vernal:9,version:[2,5,17,30,36,40,43,49],versu:15,vertenstein:42,vertic:9,via:[9,11,12,15,17,23,25,29,34,44,48],view:[11,30,48],volum:[17,28,30,44],vstoke:8,vstrm:9,vwind:2,wai:[2,11,15,17,25,29,34,42,44,46,48],wait:42,wall:[42,47],wallclock:[33,35,42,47],want:[1,5,11,29,32,34,41,46,48],warn:33,watch:2,water:[2,7,14],wav:[28,29,30,41,42,44],wav_modelio:24,wav_pres:8,wave:[2,7],weight:[9,11,15,17,21,28,49],well:[2,3,5,6,7,8,11,15,17,21,22,28,30,32,33,42,43,44,47,48],were:[3,15,17,32,33,44],what:[1,2,3,4,5,6,7,11,12,14,25,26,29,30,31,33,39,43,47],whatev:[17,48],when:[2,3,4,5,9,11,12,13,14,15,16,17,18,25,27,28,30,31,41,42,43,44,45,46,47,48],whenev:[17,18,44],where:[3,5,9,11,12,13,15,17,25,28,29,30],wherea:5,whether:[11,12,15,17,42,44,48],which:[2,4,5,9,11,12,15,17,18,25,28,29,30,31,34,40,42,43,44,45,46,47,48],whole:11,whose:[2,3,5,6,7,8,28],why:47,wide:47,wil:46,wind:17,wiso_datm:2,within:[2,3,5,6,7,8,9,15,17,22,25,40,41,42,46],without:[2,3,5,7,8,9,11,15,25,34,44,46,48,49],won:[11,46],word:[15,16,23,42],work:[1,2,5,15,22,25,30,33,43,48],workflow:[43,49],workstat:40,world:36,worst:48,worthwhil:42,would:[2,5,9,11,12,15,17,25,34,36,42,43,45,46,48],wrap_nf_def_var:5,wraparound:11,write:[9,11,14,17,18,28,36,39,43,44,47],writeabl:34,written:[9,14,17,18,22,28,42,43,44,48],wrt:[7,9],wtime:36,ww3:[2,5,7,30],www:44,xatm:[30,31],xcpl_comp:31,xglc:30,xlat:5,xlmchang:32,xlnd:30,xlon:5,xml_schema:[31,43],xml_variable_nam:34,xmlchang:[29,33,34,35,37,41,42,44],xmllint:43,xmlqueri:[29,33],xocn:30,xrof:30,xsd:[31,43],xunit:48,xwav:30,xxx:[11,44,45],xxx_in:11,xxxxxxxx:48,yeager:2,year:[2,3,5,6,9,11,14,25,28,35,37,42,43,44],year_align:11,year_first:11,year_last:11,yearalign:9,yearfirst:9,yearlast:9,yearli:5,yellowston:[28,31,35,42],yes:48,ymd:9,ymdlb:9,ymdub:9,you:[1,2,5,11,12,28,29,30,31,32,33,34,36,37,40,41,42,43,44,45,46,47,48],your:[1,5,6,8,11,28,29,30,31,33,34,35,36,37,39,40,41,42],yourself:48,yymmdd:[28,44,47],yyyi:44,yyyymmdd:[9,47],zenith:11,zero:[2,3,5,6,7,12,17,21,28,34]},titles:["Building a Coupled Model with CIME","1. Introduction","5. Data Atmosphere (DATM)","6. Data Land (DLND)","4. Data Model Science","8. Data Ocean (DOCN)","9. Data River (DROF)","7. Data Ice (DICE)","10. Data Wave (DWAV)","3. Design Details","CIME Data Models","2. Input Streams","1. Introduction","3.5. Bit-for-bit flag","3.7. Mass and Heat Budgets","2. Design","3.4. Driver Threading Control","3.2. Grids","3.6. History and Restarts","3. Implementation","CIME Driver/Coupler","3.3. Initialization and Restart","1. Introduction","3.8. Multi-instance Functionality","3.9. More on Driver Namelists","3.1. Time Management","Welcome to the CIME documentation!","Miscellaneous Tools","7. Adding new cases","5. Building a Case","2. The basics of CIME cases","1. CIME internals","8. Cloning a Case","3. Creating a Case","7. Customizing a Case","8.2. A Basic Example","8.1. MPI example","8.3. Setting up a branch or hybrid run","8. FAQ","CIME User’s Guide Part 1: Basic Usage","1. Introduction","6. Multi-instance component functionality","3. Optimizing Processor Layout","2. Porting and Validating CIME on a new Platform","6. Running a Case","4. Setting up a Case","4. Testing with create_test","9. Troubleshooting","5. Fortran Unit Testing","What is CIME?"],titleterms:{"case":[28,29,30,32,33,34,39,40,44,45,47],"class":48,"default":40,"function":[23,41],"long":44,"new":[28,43,48],"short":44,acme:[34,46],activ:34,add:48,adding:[28,46,48],archiv:44,archive:44,area:17,assertion:48,atmospher:[2,34],avail:40,back:44,base:48,baselin:46,basic:[30,35,39],batch:[31,43],between:[2,3,5,6,7,8],bit:13,branch:37,budget:14,build:[0,29,48],call:[29,30,33,44,45],cam:34,cesm:[5,34],check:17,cime:[0,10,20,26,30,31,39,40,43,48,49],cism:34,climat:40,clm:34,clock:25,clone:32,compil:[31,43],compon:[15,28,30,31,34,41],compset:[28,31],concept:40,concurr:15,config_batch:43,config_compil:43,config_machin:43,configur:17,content:[26,40],control:[16,44],correct:17,coupl:[0,15,25],coupler:20,creat:[5,33],create_newcas:33,create_test:46,creation:47,custom:[11,34],data:[2,3,4,5,6,7,8,9,10,11,29,34,42,44],datamod:[2,3,5,6,7,8],datm:[2,34],datm_mode:2,defin:[31,48],descript:11,design:[9,12,15],detail:[9,48],develop:49,dice:[7,34],dice_mode:7,direct:43,directori:40,discov:40,dlnd:[3,34],dlnd_mode:3,docn:[5,34],docn_mode:5,document:[26,48],domain:17,driver:[16,20,24,25,34],drof:[6,8,34],drof_mode:[6,8],dwav:8,dwav_mode:8,exampl:[35,36,48],fail:44,faq:38,field:[2,3,5,6,7,8],file:[9,11,34,43,48],find:48,flag:13,flux:17,fortran:48,fraction:17,frequenc:25,from:5,fulli:5,gener:48,grid:[17,28,30,31],guid:39,guidelin:48,heat:14,histori:18,how:48,hybrid:37,ice:7,implement:19,independ:[2,3,5,6,7,8],indice:[0,10,20,26,27,39,49],initi:44,initial:21,input:[5,11,12,29,44],instanc:[23,41],interfac:15,intern:[2,3,5,6,7,8,31,39],interpol:17,introduct:[1,12,22,40,48],job:[44,47],kei:40,land:[3,34],layout:[34,42],librari:43,limit:42,loop:25,machin:[31,43,48],manag:[25,46],manage_testlist:46,map:17,mass:14,mct:15,memori:15,method:48,miscellan:27,mode:5,model:[0,4,9,10,15,29,30,31,34,40,42,44],modifi:34,monitor:44,more:[24,48],mpi:36,multi:[23,41],name:[2,3,5,6,7,8],namelist:[2,3,5,6,7,8,11,12,24,34],next:12,ocean:[5,34],onli:5,optimiz:42,option:43,order:48,output:44,overview:[11,12,15,48,49],packag:43,parallel:15,part:39,path:43,perform:15,pfunit:48,platform:43,pop2:34,port:[39,43],prerequisit:40,previou:44,problem:47,processor:42,prognost:5,queri:30,query_config:30,quick:40,rebuild:29,regress:46,relationship:[2,3,5,6,7,8],requir:43,restart:[9,18,21,44],result:[33,44],river:[6,34],rtm:34,run:[5,37,44,48],runtim:47,scienc:4,script:46,sea:34,section:12,sequenc:15,set:[30,31,34,37,40,42,45],setup:[45,48],shr_strdata_nml:11,some:40,specif:[31,34,43],sstdata:5,standard:17,start:[40,44],status:44,step:43,stop:44,stream:[2,3,5,6,7,8,11,34],structur:9,subdirectori:40,submiss:47,submit:44,support:48,system:[31,48],tabl:[0,10,20,26,27,39,49],target:31,teardown:48,term:[40,44],test:[39,46,48],thread:16,through:9,time:[25,42],todo:46,tool:27,toolkit:15,trigrid:17,troubleshoot:[44,47],type:44,unit:48,usage:39,use:39,user:39,using:[42,46],valid:[2,3,5,6,7,43],valu:[2,3,5,6,7,8,11],variabl:[2,3,5,6,7,8],wave:8,welcom:26,what:[48,49],where:[31,49],write:48,xml:[2,3,5,6,7,8,34,43,48],your:[43,48]}}) \ No newline at end of file +Search.setIndex({envversion:48,filenames:["build_cpl/index","build_cpl/introduction","data_models/data-atm","data_models/data-lnd","data_models/data-model-science","data_models/data-ocean","data_models/data-river","data_models/data-seaice","data_models/data-wave","data_models/design-details","data_models/index","data_models/input-streams","data_models/introduction","driver_cpl/bit-for-bit-flag","driver_cpl/budgets","driver_cpl/design","driver_cpl/driver_threading_control","driver_cpl/grids","driver_cpl/history-and-restarts","driver_cpl/implementation","driver_cpl/index","driver_cpl/initialization-and-restart","driver_cpl/introduction","driver_cpl/multi-instance","driver_cpl/namelist-overview","driver_cpl/time-management","index","misc_tools/index","users_guide/adding-cases","users_guide/building-a-case","users_guide/case-basics","users_guide/cime-internals","users_guide/cloning-a-case","users_guide/create-a-case","users_guide/customizing-a-case","users_guide/faq/basics-a-basic-example","users_guide/faq/basics-mpi-example","users_guide/faq/basics-setting-up-a-branch-or-hybrid-run","users_guide/faq/faq","users_guide/index","users_guide/introduction-and-overview","users_guide/multi-instance","users_guide/optimizing-processor-layout","users_guide/porting-cime","users_guide/running-a-case","users_guide/setting-up-a-case","users_guide/testing","users_guide/troubleshooting","users_guide/unit_testing","what_cime/index"],objects:{},objnames:{},objtypes:{},terms:{"0e30":11,"0xhukfql":48,"12th":25,"13th":25,"16x4":34,"1850_cam60_clm50":30,"18th":25,"19th":25,"1_nompi_noopenmp":48,"1st":25,"2000_datm":[30,33],"2000_satm_dlnd":30,"2000_satm_slnd_sice_socn_srof_sglc_dwav":30,"2000_satm_slnd_sice_socn_srof_sglc_swav_sesp":30,"2000_xatm_xlnd_xice_xocn_xrof_xglc_xwav":30,"20170504_163152_31aahi":46,"20tr":30,"24th":25,"256m":43,"25_l":33,"25_oi":33,"2nd":11,"3rd":11,"4th":5,"5_gx1v6":[11,43],"5th":5,"6th":25,"7th":25,"8_cheyenne_intel17":48,"9x1":33,"9x2":[11,28,30,43],"__command_line_test__":48,"_bgc":30,"_cpl_dt":25,"_cpl_offset":25,"_docn":30,"_esp":30,"_fillvalu":5,"_glc":30,"_ice":30,"_in_":41,"_layout":23,"_lnd":30,"_modelio":24,"_nnnn":45,"_ocn":30,"_restart":9,"_rof":30,"_wav":30,"case":[2,3,5,6,7,8,9,11,12,15,17,18,23,26],"char":31,"class":[3,39,46],"default":[2,3,4,5,7,9,11,16,17,24,28,29,34,39],"export":[2,3,5,7,8,29,44,48],"false":44,"final":[9,12,15,16,17,22,31,42,43,48],"function":[7,9,12,19,20],"import":[12,17,25,29,32,34,40,41,42,44,48],"long":[1,9,14,30,33,39,42,43],"new":[5,9,11,17,21,22,26],"null":[2,3,4,5,6,7,8,9,11,12,30,33],"public":9,"return":[2,3,5,6,7,9,12,21,25,48],"short":[2,7,15,30,33,39,42,43],"static":17,"true":[2,3,5,6,7,8,9,13,25,28,37,44,48],"try":[42,43,47],"var":[2,9],"while":[5,11,15,17,25,28,32,34,44],a0l0i0o0g0c0:29,a1l0i0o0g0c0:29,abil:[13,16,25,41,42,49],abl:[9,18,25,41,44,48],abort:[4,17,33,44,48],about:[4,9,11,15,17,22,25,42,47,48],abov:[4,11,12,15,25,41,42,44,47,48],absolut:[15,17,42],accept:[15,48],access:[9,32,43,44,47,48],accommod:[5,11],accompani:[2,28,42],accomplish:[5,17],accord:[11,48],accordingli:5,accordlingli:41,account:[17,42,43,44],acct:46,accumlu:25,accumul:[7,18,25],accur:17,accuraci:17,achiev:[28,42,48],acm:[28,29,31,40,43,46],acme:[26,30],acme_develop:46,acquir:15,across:[17,18,21,34,42],act:[7,17],action:47,activ:[2,3,4,5,7,9,12,15,17,29,30],active:44,actual:[5,9,11,17,18,30,48],add:[1,2,5,11,14,17,28,34,39,43,46],addit:[2,3,5,6,7,12,14,15,17,18,22,25,27,30,31,34,37,40,42,43,44,45,48],addition:[33,49],address:43,adesp:30,adesp_test:30,adjust:[5,15],adlnd:30,adopt:15,advanc:[9,11,15,25],advantag:[12,42,48],adwav:30,aerosol:2,affect:17,afrac:17,after:[5,11,17,28,29,30,31,33,34,40,42,43,44,45,48],afterward:48,again:[15,28,34,44],against:[46,47],aggreg:42,aiaf:30,aic:5,aid:48,alarm:[18,25],albedo:[15,21,25],algorithm:[9,11,15,17],alia:30,alias:[30,33],align:[5,9,11],all:[2,3,4,5,6,7,8,9,11,12,13,15,17,18,21,22,23,25,28,29,30,31,34,35,40,41,42,43,44,45,46,47,48,49],allact:31,alloc:[34,48],allocat:[9,36,48],allocstr:9,allow:[11,15,16,17,23,25,30,40,43,44,46,48,49],almost:[3,48],alon:[27,49],along:48,alongsid:48,alreadi:[28,29,33,37,45,46,48],also:[2,3,5,6,7,9,11,12,15,17,18,21,22,24,25,28,29,30,31,34,40,41,42,43,44,46,47,48],altern:[5,17,25,32,48],although:[4,5,9,15,17,18,42],alwai:[5,9,11,15,17,23,25,30,42,48],ambigu:17,amip:5,amipsst:5,among:[12,44,48],amount:[12,15,25,47],analysi:[42,43,44,46],analyz:44,ang:2,angl:11,ani:[2,3,5,7,8,11,12,15,16,17,18,23,28,29,30,31,32,33,34,37,40,41,42,43,44,45,47,48,49],anidf:[2,3,7],anidr:[2,3,7],annual:[6,7,14],anomali:2,anomaly_forc:2,anomoli:2,anoth:[1,12,17,23,28,42,47,48],another:[32,47],answer:48,any:[2,3,5,6,7,12,48],anyth:[32,41],aoflux_grid:17,appear:[2,3,5,6,7,8,11,29,30,31,32,33,34,45,47],append:43,appli:[5,17,21,25],applic:[5,49],applicat:[22,42],approach:[17,32],appropri:[5,11,12,15,28,31,34,40,43,44,47,48],approxim:[9,30],aqp10:30,aqp1:30,aqp2:30,aqp3:30,aqp4:30,aqp5:30,aqp6:30,aqp7:30,aqp8:30,aqp9:30,aquap:30,aquaplanet:30,arbitrari:[9,42],arbitrarili:15,arcfactor:2,architectur:49,archiv:[31,33,37,39,43],archive:39,area:[9,11,12],arg:43,argonn:15,argument:[5,9,15,30,33,34,43,46,47,48],around:17,arrai:[2,3,5,7,8,9,11,48],ascal:17,ask:12,aspect:[17,29,45,47],assert:48,assertequ:48,assertfals:48,assertgreaterthan:48,assertgreaterthanorequ:48,assertion:39,assertisfinit:48,assertisnan:48,assertlessthan:48,assertlessthanorequ:48,asserttru:48,assign:42,assimil:[23,41],assist:28,assocait:9,associ:[2,3,5,6,7,8,9,11,12,15,17,18,21,22,24,25,28,29,30,31,34,47,48,49],assum:[2,3,4,5,6,7,8,11,17,28,30,35,37,40,41,42,48],assume:37,assumpt:[4,17],assur:[5,36,43],atm:[2,11,12,17,28,29,30,31,34,41,42,44,49],atm_cpl_dt:25,atm_cpl_offset:25,atm_grid:2,atm_in:34,atm_in_0001:41,atm_in_0002:41,atm_modelio:24,atm_ncpl:25,atm_pres:[2,4],atmnam:28,atmname_ocnnam:28,attempt:[17,36,43,46],attribut:[9,21,30,31,34,43,48],attribute_vector:15,attrvect:9,autom:[46,47,49],automat:[9,11,25,34,35,44,48],automaticali:17,auxiliari:40,avail:[4,5,9,12,15,30,39],avcoszen:9,avect_wrapp:48,averag:[5,11,14,17,18,23,25,28,47],avflb:9,avfub:9,avg:47,avifld:[2,3,5,6,7,8],avofld:[2,3,5,6,7,8],avrlb:9,avrub:9,avsdf:[2,3,7],avsdr:[2,3,7],awai:[17,44],awar:42,axi:[9,11,12],b1850:[30,37],b1850_cn:35,b1850cn:43,b_1850_cn:43,back:[6,15,17,35,37,39],background:22,backtrack:47,backward:11,balanc:[15,27,33,34,37,42,43,49],bar:48,base:[9,11,15,16,17,25,31,33,39,40,42,43,44,46],baselin:[39,43,44],baseline:46,baseline_root:43,bash:48,basi:[16,29],basic:[9,12,15,17,21,23,25,26,27,28],batch:15,batch_spec_file:31,batch_system:43,bcgen:5,bcphidri:2,bcphiwet:2,bcphodri:2,bdrd:30,becaus:[3,5,7,9,11,12,15,17,25,42,44,48],becom:[13,17,18,29,47],been:[9,12,14,15,17,21,25,28,29,32,33,34,40,43,45,46,47,48],befor:[2,3,5,6,7,9,11,12,17,25,28,30,33,40,42,43,44,47,48],began:[5,44],beginn:38,behavior:[2,3,5,6,7,8,33,40,44,48],behind:[17,46],belong:34,below:[3,5,7,8,9,11,17,28,29,31,34,41,43,44,45,47,48],benefit:48,best:[15,29,31,42,48],better:[15,17,48],beyond:[9,34],bfb:43,bfbflag:13,bgc:30,bgc_cice_pop2:30,bia:[2,15,42],bias_correct:2,big:46,bilinear:[11,17,28],binari:44,bld:[29,43],blddir:29,bldlog:29,bless_test_result:46,block:[9,15,34],both:[3,5,9,11,12,15,17,18,22,30,33,34,42,43],bothmask:11,bottom:[5,42,47],bound:[7,9],boundari:[5,18,30],box:[5,11,12,28,30,31,33,41,43],bracket:9,brief:[28,40],bring:[26,44],broken:42,bsub:[42,47],budget_ann:14,budget_annual:14,budget_daili:14,budget_daily:14,budget_inst:14,budget_longter_eoy:14,budget_longterm_stop:14,budget_ltann:14,budget_ltend:14,budget_month:14,budget_monthly:14,budgets:14,buffer:[21,42],bug:47,build_threaded:29,buildconf:[29,33,34,44],buildex:34,buildnml:[2,3,5,6,7,8,11,24,29,34,44],built:[11,15,28,40,43,45,46,48],bullet:48,bundl:[15,17],cach:15,calcul:[5,7,15,17,22,25,34],calendar:9,call:[5,7,9,11,12,15,16,17,18,21,25,28],cam40:30,cam50:30,cam55:30,cam5:[5,34],cam60:30,cam:[5,12,28,30,31],cam_config_opts:34,cam_namelist_opts:34,cam_nml_usecase:34,can:[2,3,4,5,6,7,8,9,11,12,14,15,16,17,18,22,25,28,29,30,31,33,34,36,40,41,42,43,44,45,46,47,48,49],cannot:[11,15,25,33,34,44,48],capabl:[12,15,17,23,41,43,44,49],captur:47,care:4,carefulli:[25,43],carri:[13,17,22,42,43],cart3d:17,cartesian:5,case_last:31,casedoc:[11,29,33,34,41,45],caseroot:[2,5,11,14,23,29,31,32,33,34,35,41,42,43,44,45,46,47],casestatu:[32,33,40,44],categori:[11,46],caus:[11,45,47,48],caveat:[25,41],ccsm4:[22,42,43],ccsm:[2,5,37,42],ccsm_cprnc:43,ccsm_driver:25,ccsm_pe:[16,21],ccsm_time:42,ccsm_timing_stat:42,ccsmroot:28,cell:[17,28,30],celsiu:[4,5],centuri:14,certain:[15,33,45,46],cesm1:[18,22,42],cesm2:44,cesm:[2,3],cesm_driv:22,cesm_setup:34,cesm_unit_test_tutori:48,cesmdata:48,cesmdataroot:48,chang:[3,5,6,7,8,9,11,13,15,16,17,25,28,29,32,33,34,35,37,40,41,42,43,44,45,46,48],changed:29,changelog:40,changelog_templ:40,charact:[2,3,4,5,6,7,8,9,11,15,17,31,36,47],characterist:15,charg:[15,42],cheap:9,cheapest:42,check_input_data:[29,33,44],check_map:28,checkout:30,chmod:[11,34],choic:[4,17,30,40,48],choos:[12,44,48],chosen:[4,17],chronolog:[11,44],chunk:[9,15],cice:[2,5,7,30,31,34,41,43],cice_blckx:34,cice_blcky:34,cice_config_opts:34,cice_decomptype:34,cice_mxblcks:34,cice_namelist_opts:34,cime_config:[2,3,5,6,7,8,11,24,29,31,34],cime_model:[28,40,43],cime_output_root:43,cimeroot:[2,3,5,6,7,9,11,17,24,28,30,31,32,33,34,35,37,43,48],circa:2,circumst:29,cism1:30,cism2:30,cism:[30,31],cism_grid:34,cism_in:34,clarifi:[17,43],clean:[29,33,34,41,44,45,46,48],cleanli:18,cleanup:48,clear:[24,47],clen:36,climat:[5,21,26,27],climatolog:[2,5,6,7,8],climo:[8,30],clm1pt:2,clm45:30,clm50:30,clm:[2,3,28,29,30,31],clm_qian:[2,11],clm_qian_wiso:2,clmcruncep:2,clmcruncep_v5:2,clmgswp3:2,clmncep:[2,11],clock:[15,18,19,20,21],cloneroot:32,close:[15,17,46],cmake:[40,43,48],cmakelist:[40,48],cmap:2,co2:2,co2diag:2,co2lnd:2,co2ocn:2,co2prog:2,coars:9,coarsest:16,cobalt:43,code:[2,3,5,7,8,9,11,12,22,25,29,32,33,40,41,44,48],cold:44,collabor:15,collect:40,com:[48,49],combin:[4,5,7,15,17,28,31,42,43,44,48,49],come:[46,48],comma:43,command:[11,28,29,31,32,33,36,40,41,44,45,47,49],comment:[5,11,29,46,48],common:[2,4,15,28,29,40,44,46,47],commun:[12,15,16,17,21,34,42,44],compar:[18,28,42,43,46,47],compare:46,compare_base_rest:46,compare_test_result:46,comparion:46,comparison:[17,42,46,48,49],compat:[11,43],compil:29,compile_thread:48,compiler:43,compilers:43,compilers_spec_file:31,complaint:43,complement:[17,48],complementari:17,complet:[5,12,17,21,33,34,42,43,44,46,47,48,49],completed:46,complex:[11,15,40,48],compliant:[11,18,29,34],complic:43,compnam:29,compon:[1,2,3,5,6,7,8,9,11,12,13,14],compress:29,compris:[28,44,49],compset:[2,3,5,6,7,8,11],compsets_spec_file:31,comput:[4,5,7,9,11,13,15,16,17,21,22,25,28,34,40,42,43,45],concept:[30,39],condit:[44,48],conduct:49,config:[11,28,31,34,40,43],config_args:[9,43],config_atm_file:31,config_batch:[31,39],config_compil:[31,39],config_compilers_v2:[31,43],config_compon:[2,3,5,6,7,8,31,34],config_component_:31,config_compset:31,config_cpl_file:31,config_cpl_file_model_specific:31,config_esp_file:31,config_fil:31,config_glc_file:31,config_grid:[28,31],config_grids_v2:31,config_ice_file:31,config_lnd_file:31,config_machin:[31,39],config_machines_templ:43,config_ocn_file:31,config_p:[31,43],config_rof_file:31,config_test:46,config_tests_file:31,config_wav_file:31,configur:[1,5,12,15],configuraiton:42,confirm:[30,44,47],conform:[5,43],conjunct:[2,3,5,6,7,8,11,42],conmpon:14,conserv:[14,17,25,28,30],consid:[17,25,42],consider:[15,42],consist:[3,4,5,7,11,15,17,18,21,25,28,43,44,47,48,49],constant:[4,5,11,34,42,43],constantli:17,constrain:34,constraint:[15,34,42,44],construct:11,consult:47,contact:[28,43],contain:[2,3,5,6,9,11,12,15,17,18,21,24,25,27,28,29,31,33,34,38,42,43,44,45,47,48,49],content:[1,11],continu:[9,35,37,42,44],continue_run:[37,44],contrast:11,contribut:15,control:[5,14,15],conveni:[30,33,48],convent:[9,28,30,43,44,48],converg:5,convers:48,convert:[5,17],coord:9,coordin:[2,5,11,15,18,25,44],copi:[2,3,5,6,7,8,11,12,15,25,33,34,41,43,44,46,47],copyall:[2,3,4,5,6,7,8,12],core2:[2,6],core2_iaf:2,core2_nyf:[2,34],core:[2,36,43,47],corev2:2,correct:[2,5,11],correctli:[34,42,43,44],correspond:[2,3,5,6,11,30,34,37,41,43,44],cosin:11,cosp:5,cost:[9,15,42,43,47],cosz:9,coszen:[9,11],could:[11,15,17,25,31,36,40,42],count:[5,13,15,16,34,42],coupler:[1,2,3,4,5,6,7,8,12,13,14,15,17],cours:44,cover:[12,17,22,48],coverag:[5,7,41],covert:17,cpl7:[15,22,26,35,37],cpl:[29,35,37,41,42,43,44,47],cpl_modelio:24,cplhist:[2,3,6,12],cplhistforc:2,cplhistforcingforocnic:2,cplug:15,cpp:34,cppdefs:43,cprnc:[27,43],craig:[15,22,25,42],crash:44,create_clon:32,create_esmf_map:28,create_newcas:[28,30,31,32],create_newcase:46,create_test:[39,43],creation:[34,39],critic:[17,21,25,33],cruncep:2,crux:43,cseg:[11,12,48],csh:[34,40,43,44,48],csm_share:29,ctest:48,cube:30,current:[2,5,7,8,9,15,16,17,18,25,28,33,40,41,42,43,44,46],currfil:9,currpioid:9,curv:15,cusom:42,custom:10,customiz:11,cycl:[9,11,15],cyclic:5,dai:[5,11,15,18,25,28,42,43,44,47],daili:[9,11,14,42,43,47],data_comp:[2,3,5,6,7,11,31,34],dataset:[5,9,11,28],datasourc:[9,11,12],datatyp:[11,15,21,25],date:[5,9,11,18,42,43,44,47],datefil:5,datesec:5,datestamp:[29,42,44],datm7:[11,12],datm_clmncep_yr_align:2,datm_co2_tseries:2,datm_cplhist_case:2,datm_cplhist_dir:2,datm_cplhist_yr_align:2,datm_cplhist_yr_end:2,datm_cplhist_yr_start:2,datm_fld:2,datm_in:[2,11,34],datm_in_nnn:[2,34],datm_nml:[2,11,12],datm_presaero:2,datm_topo:2,dcmake_install_prefix:48,deal:[17,29],dealloc:48,debug:[14,29,45],decad:[21,25],decid:42,declar:48,decomp:[2,3,5,6,7,8,12],decomposit:[2,3,5,6,7,8,12,13,15,17,34,42],decreas:42,deduc:47,default_valu:31,defer:17,defin:[2,3,5,6,7,8,9,11,17,21,28,30],definit:[17,30,31,43,48],defint:43,degener:15,degre:[9,15,17,28,30,35],delta:11,demonst:17,den:[2,7,11,12],denot:[30,40],depart:15,depend:[2,3,5,6,7,8,9,11,12,15,17,25,28,29,30,31,33,42,43,44,46,47,48],deposit:2,depth:5,deriv:[5,7,11,12,15,17,25],desc:[9,31,43],descib:17,describ:[2,3,5,6,7,8,9,11,12,14,15,25,29,40,43,45,48],descript:[2,3,5,6,7,8,9,10],design:5,desir:[5,11,15,16,25,35,42],desktop:48,destin:[13,17,28],detect:17,determin:[5,9,12,29,30,31,34,40,42,44],develop:[2,5,15,18,21,22,25,26,40,41,42,44,48],dhdx:[5,7],dhdy:[5,7],diagnos:[14,25],diagnost:[13,15,21,22,29,33,34,42,43,44],diagram:22,diatren_ann_rx1:6,diatren_iaf_rx1:6,dice:[4,5],dice_fld:7,dice_in:[7,11,34],dice_in_nnn:[7,34],dice_nml:[7,11,12],dict:46,dictat:44,did:47,differ:[2,9,11,12,13,14,15,16,17,18,24,25,30,33,34,35,40,41,42,46,48,49],difficult:44,digit:14,dim:9,dimens:[5,9,15],dimension:9,dimid:5,din_loc_root:[29,43,44],din_loc_root_clmforc:[29,43],dir:[46,48],direct:[11,17,39],directli:[2,3,4,5,6,7,8,12,15,29,34,48],directori:[2,3,6,8,11,28,29,31,32,33,34,35,37,39],discov:39,discret:11,discuss:[2,9,11,22,28,31,33,34,41,42,43,44,48],disk:[29,44,47],displac:[28,30],distinct:[5,15,34,48],distribut:[15,23,27,33],diurnal:15,divid:[5,9,11,25],dlat:30,dlnd_cplhist_case:3,dlnd_cplhist_dir:3,dlnd_cplhist_yr_align:3,dlnd_cplhist_yr_end:3,dlnd_cplhist_yr_start:3,dlnd_fld:3,dlnd_in:[3,11,34],dlnd_in_nnn:[3,34],dlnd_nml:[3,11,12],dlon:30,dmpi:48,dn10:[2,11,12],do_budget:14,docn:4,docn_fld:5,docn_in:[5,11,34],docn_in_0001:41,docn_in_0002:41,docn_in_nnn:[5,34],docn_nml:[5,11,12],docn_ocn_in_0001:41,docn_ocn_in_0002:41,docn_som_filename:5,docn_sstdata_filename:5,docn_sstdata_year_end:5,docn_sstdata_year_start:5,document:[14,15,22,25],doe:[5,9,11,15,17,23,25,33,34,43,44,45,49],doesn:[9,42],dofil:9,doi:22,dom:[17,30,31],dom_a:17,dom_drof:[30,33],dom_i:17,dom_l:17,dom_o:17,domain:[9,11],domainfil:[9,11,12],domaininfo:[9,11,12],domap:9,domareanam:9,domfilenam:9,domfilepath:9,dommasknam:9,domtvarnam:9,domxvarnam:9,domyvarnam:9,domzvarnam:9,don:[9,11,42,44,47,48],done:[2,3,5,6,7,9,13,15,17,33,42,44,48],dopenmp:48,dot:11,doubt:29,dout_l_msroot:43,dout_s:44,dout_s_root:[43,44,47],down:[40,42,43,47],download:[29,30,44,48],draw:48,drive:[2,7,46],driven:[43,46,48],driver:[2,3,5,6,7,9,12,13,14,15],driver_cpl:[17,22,24,31],driver_fld:[2,3,5,6,7,8],drof:4,drof_cplhist_case:6,drof_cplhist_dir:6,drof_cplhist_yr_align:6,drof_cplhist_yr_end:6,drof_cplhist_yr_start:6,drof_fld:6,drof_in:[6,11,34],drof_in_nnn:34,drof_nml:[6,11,12],drop:48,drv:[17,30,31,44],drv_flds_in:[24,41],drv_in:[17,24,34,41],drv_thread:16,dstdry1:2,dstdry2:2,dstdry3:2,dstdry4:2,dstmask:11,dstwet1:2,dstwet2:2,dstwet3:2,dstwet4:2,dtest:43,dtlimit:[9,11],dtmax:9,dtmin:9,due:[5,15,17,42,43],duplic:[32,48],durat:46,dure:[9,15,16,42,43,44],duu10n:5,dwav:4,dwav_fld:8,dwav_in:[8,11],dwav_nml:[8,11,12],dxxx_mode:12,dycor:28,dynam:[15,49],each:[2,3,4,5,6,7,8,9,11,12,13,14,15,16,17,21,23,25,29,30,31,33,34,40,41,42,43,44,45,46,47,48,49],earli:[25,43],earlier:48,earth:[22,40,42,43,49],easi:[17,44,46,48],easier:48,easiest:17,easili:[11,12,15,43],east:17,eccen:9,eccentr:9,eco_mosart_cism2:30,ect:46,edit:[3,4,5,6,7,8,11,28,31,33,34,35,42,44],edited:[34,45],edu:44,effect:17,effici:34,effort:14,eight:[15,42],either:[4,6,9,14,15,25,29,30,34,41,42,43,44,47,48],elaps:9,element:[11,30,31,43,44,48],elemnet:11,elev:3,elimin:25,elsewher:11,email:47,empti:48,enabl:[5,40,44,48,49],encapsul:[9,15],encount:44,end:[2,3,5,6,9,11,14,18,25,34,35,36,37,42,43,44,47,48],energi:15,ensembl:[27,41,49],ensur:[14,16,17,18,21,23,28,34,48],ensure:48,entir:[17,44,46],entri:[11,28,31,34,40,43],entry_id:31,env:[17,25,43,46,48],env_arch:33,env_batch:[33,44,47],env_build:[29,33,34],env_cas:[31,32,33],env_mach_p:[23,29,33,34,35,41,45],env_mach_specif:[33,43,45,48],env_run:[2,3,5,6,7,8,12,14,17,25,29,33,34,37,42,44,47],environ:[16,28,33,40,43,44,45,47,48],environment_vari:43,eps_aarea:17,eps_agrid:17,eps_amask:17,eps_frac:[17,34],eps_oarea:17,eps_ogrid:17,eps_omask:17,equal:[5,9,17,34],equat:40,equinox:9,eri:[43,46],err:47,errat:47,erron:4,error:[4,11,17,29,34,36,44,47,48],ers:[43,46],ers_d:43,ert:43,esg:43,esmci:49,esmf:[15,17,25,28],esmf_regridweightgen:28,esmf_wrf_timemgr:25,esp:[29,30,40],esp_modelio:24,especi:[43,47],essenti:49,establish:[12,15,21,42],estim:[41,42],etc:[12,40,42,43,48],evap:[2,3,5,7],even:[15,34,42,46],evenli:[23,25,34],event:25,everi:[14,17,25,28,31,34,42,43,47,48],everyth:29,everywher:17,evolut:[17,44],evolv:[17,18],exact:[16,43,44,46],exactli:[2,9,11,17,18,44],examin:[2,3,5,7,8,30,46],exampl:[2,4,5,9,11,12,15,17,25,28,29,30,31,32,33,34],example1:33,example_case:[35,37],example_casep:37,exce:43,except:[2,4,5,11,17,28,29,33,37,42,44,47],exchang:[2,3,4,5,6,7,8],exclud:46,exec:43,execut:[5,9,15,22,28,29,33,37,40,41,43,44,46,48,49],exercis:[42,48],exeroot:[29,44],exist:[1,5,9,28,29,33,43,44,45],expand:5,expect:[4,12,17,18,23,25,29,43,47,48],expens:42,experi:[11,30,33,34,41],experiment:[2,42],expert:[38,41],explain:40,explan:46,explanatori:46,explicit:[25,48],explicitli:[5,44,48],express:[31,43],extend:[11,23,25,48],extens:[29,48],extent:7,extern:[5,12,15,40,44,48],extra:[9,12,47],extract:[5,17,48],extrapol:11,extrem:9,f09_g16:[5,35,37],f09_g16_rx1:33,f19:[28,30],f19_f19:46,f19_g16:[28,40,43],f90:[5,9,11,17,22,25,36],fact:[3,12],factor:[2,7,17],factorfn:2,faii_evap:7,faii_lat:7,faii_lwup:7,faii_sen:7,faii_swnet:7,faii_taui:7,faii_taux:7,fail:[29,39],failur:[46,48],fairli:23,fall:11,fall_evap:3,fall_fco2_lnd:2,fall_flxdst1:3,fall_flxdst2:3,fall_flxdst3:3,fall_flxdst4:3,fall_lat:3,fall_lwup:3,fall_sen:3,fall_swnet:3,fall_taui:3,fall_taux:3,fals:[2,3,4,5,6,7,8,9,13,48],familiar:[29,40],faoo_fco2_ocn:2,faoo_fdms_ocn:2,faq:30,fashion:[18,25,34,44],fast:48,faster:42,favor:2,faxa_bcphidri:2,faxa_bcphiwet:2,faxa_bcphodri:2,faxa_dstdry1:2,faxa_dstdry2:2,faxa_dstdry3:2,faxa_dstdry4:2,faxa_dstwet1:2,faxa_dstwet2:2,faxa_dstwet3:2,faxa_dstwet4:2,faxa_lwdn:[2,5,7],faxa_ocphidri:2,faxa_ocphiwet:2,faxa_ocphodri:2,faxa_prec:5,faxa_rain:[5,7],faxa_rainc:2,faxa_rainc_18o:2,faxa_rainc_hdo:2,faxa_rainl:2,faxa_rainl_18o:2,faxa_rainl_hdo:2,faxa_snow:[5,7],faxa_snowc:2,faxa_snowc_18o:2,faxa_snowc_hdo:2,faxa_snowl:2,faxa_snowl_18o:2,faxa_snowl_hdo:2,faxa_swndf:[2,7],faxa_swndr:[2,7],faxa_swnet:2,faxa_swvdf:[2,7],faxa_swvdr:[2,7],faxx_evap:2,faxx_lat:2,faxx_lwup:2,faxx_sen:2,faxx_taui:2,faxx_taux:2,feasibl:44,featur:[11,13,16,17,23,25,44,48],feb:11,feedback:[40,47],feel:12,few:[12,15,17,42,48],fewer:9,fhello_world_mpi:36,fieldinfo:[9,11,12],figur:15,figx1:15,file:[2,3,4,5,6,7,8],file_desc_t:9,fileatm:28,filelnd:28,filenam:[2,3,5,6,7,8,9,11,12,18,24,34,40,44],fileocn:28,fileopen:9,filepath:[9,11,12],filertm:28,fill:[5,9,11,15,17,43,48],fillalgo:[9,11],fillmask:[9,11],fillread:[9,11],fillwrit:[9,11],filter:41,find:[31,39,42,44,46],fine:[16,25,47],finish:[42,46],finit:[17,28,30],fioi_melth:[5,7],fioi_meltw:[5,7],fioi_salt:[5,7],fioi_swpen:7,fioi_taui:7,fioi_taux:7,fioo_q:[5,7],first:[5,9,11,15,17,25,28,30,31,33,34,35,37,40,42,43,44,47,48],five:[11,44],fix:[4,11,15,42],flag:[2,3,4,5,6,7,8,9],flddst1:3,fldlistfil:9,fldlistmodel:9,flexibl:[22,29,34,41,42],flgl_qice:3,flop:17,flow:[22,44],flowchart:42,flux:[2,5,7,15],flux_qacc0:7,flux_qacc:7,flux_qmin:7,flux_swpf:7,flxdst2:3,flxdst3:3,flxdst4:3,fly:11,fmulti:41,fnn:30,follow:[2,3,5,6,7,8,9,11,12,15,17,21,22,25,28,29,30,31,33,34,35,36,37,38,40,41,42,43,44,46,48],foo:48,footprint:15,forc:[2,3,5,6,7,8,15,21,23,25,43,46],force_prognostic_tru:[2,3,5,6,7,8],forgotten:48,form:[5,11,13,29,30,44,46],formal:17,format:[5,11,12,18,24,28,44,46,47],former:48,forr_rofi:6,forr_rofl:6,fortran2003:48,fortran90:36,fortran:[11,12,15,16,24,25,36,39,40],fortran_unit_test:48,forward:[11,15,25,43],found:[2,3,4,5,6,7,8,9,11,12,15,22,29,31,40,42,44,47],found_gvd:9,found_lvd:9,four:[28,48],foxx_evap:5,foxx_lat:5,foxx_lwup:5,foxx_rofi:5,foxx_rofl:5,foxx_sen:5,foxx_swnet:5,foxx_taui:5,foxx_taux:5,frac:17,frac_init:17,frac_set:17,fraclist_a:17,fraclist_g:17,fraclist_i:17,fraclist_l:17,fraclist_o:17,fraction:[5,7],fractions_:17,fractions_a:17,fractions_i:17,fractions_l:17,fractions_o:17,framework:48,freez:5,frequenc:[2,5,9,15,18,19,20],frequent:[15,40],friendli:44,from:[2,3,4],front:[5,48],frustrat:36,fswpen:5,full:[5,12,28,33,40,42,44,45,46,47,48,49],fundament:[9,12,17],further:[11,25,46],futur:[17,23,25],fv1:11,g16:28,g17:30,gain:48,gather:13,gcgcs:2,gen_cesm_map:28,gen_domain:28,gen_domain_fil:28,gen_esmf_mapping_fil:28,gen_mapping_fil:28,gener:[2,3,4,5,6,7,8,9,11,12,13,14,15,17,18,21,22,24,25,28,29,30,33,34,39,41,42,43,44,45,46,47],general_grid:15,generate:46,generic:[11,12],get:[40,43,47,48],gfrac:17,ggrid:9,giss:[2,34],git:43,github:[48,49],give:[44,48],given:[4,5,9,11,16,17,23,29,30,31,34,42,43,44,45],glacier:[3,40],glade:[11,12,48],glc:[3,28,29,30,41,42,44],glc_cplhist:3,glc_elevclass:48,glc_modelio:24,glc_nec:3,global:[9,13,15,17,28,34,48],global_segmap:15,gmake:43,gmake_j:[29,43],gnu:[36,43],goal:21,goe:45,gold:46,good:[15,33,48],gpcp:2,gptl:29,gradient:17,great:29,greater:[11,17,25,34,40],greatest:[9,11],greenland:30,grep:47,grid:[3,5,9,11,12,13,14,15],gridcel:17,gridfil:[11,28],gridmap:28,gridr:9,grids_spec_file:31,gridtyp:28,group:[2,3,4,5,6,7,8,9,11,12,15,24,31,34,44],gsmap:9,gsmapr:9,gswp3:2,guarante:[42,43,44],guid:[11,26,27,31],guidanc:47,guidelin:39,gx1v6:[5,28],gx1v6_g:33,gx1v6_r:33,gx1v6_tavg_cont:5,gx1v7:30,gx1v7_g:30,gx1v7_r:30,gxgxs:2,had:[32,34,44],half:15,hand:[30,49],handl:[9,11,15,25,29],hang:47,happen:[16,17,47,48],hardwar:[15,16,22,33,34,42,43,47],hardwir:[9,25,34,42],has:29,have:[5,9,11,12,14,15,16,17,23,25,28,29,30,31,32,33,34,37,40,41,42,43,44,46,47,48],havedata:9,heart:9,heat:5,heirarch:43,heirarchi:43,hello:36,hello_mpi:36,help:[9,11,22,29,30,32,33,34,36,40,42,43,44,46,47,48],helper:48,here:[1,25,27,29,30,31,32,33,34,36,40,43,44,47,48],hhmmss:[44,47],hierarchi:12,high:[15,22,31,42],higher:[15,17,25],highest:15,highli:[9,28],hint:44,hist:44,histor:17,histori:[2,3,5,6,12],hit:47,hold:33,home:[43,46],homebrew:43,hopefulli:11,host:43,hostnam:[28,40],hour:[2,11,25,36,42,44],hourli:[9,11,15],how:[1,2,3,4,5,6,7,8,9,11,22,26,28,30,34,36,39,40,42,43,44,46,47],howev:[2,5,12,15,17,30,41,44,45,47,48],hpc:47,hpss:44,html:33,http:[43,44,48,49],hub:49,humid:2,i2x_i:17,iaf:[2,5,30,31],iaf_docn:30,iaf_drof:30,iaf_sglc_swav:30,iaf_slnd_dice:30,ice2atm:17,ice:5,ice_cov:5,ice_in:34,ice_in_0001:41,ice_in_0002:41,ice_modelio:24,ice_pres:[3,7],icefrac:5,icesst:5,ideal:[15,42],idealli:15,ident:[9,12,15,17,18,25,28,30,34,37,43],identifi:[2,9,31,34,40,42,43],idl:[15,34,42],ifrac:[2,5,7,17],ifrad:17,ignor:[9,11,40,41,44],ijhpca:[15,25],illustr:[12,41,46],imag:15,imager:7,imbal:[15,42],immedi:48,impact:[9,13,17,25,34,42,44,46],implemenent:9,implement:[2,9,11,15,16,17,18],impli:43,implicit:36,important:32,improv:[9,15,17,34,42],inabl:17,inact:34,inc_netcdf:5,inc_pnetcdf:9,incident:48,includ:[2,5,9,11,12,17,18,25,29,30,33,34,35,37,40,42,44,49],inconsist:[17,43],incorpor:44,increas:[15,35,42,47],increment:44,incur:25,inde:11,indefinit:11,indeped:25,index:[0,10,11,20,26,27,39,49],indic:[28,29,30,34,42,44,46,47],indirectli:48,individu:[15,16,17,22,29,30,42,44],industri:[30,44],industrial:43,infin:48,infinit:17,info:9,infodata:21,inform:[5,9,11,12,15,17,18,25,29,30,31,32,34,40,42,43,44,46,47,48],informat:11,infrastructur:[15,22,26,27,40,41,46,48,49],infrequ:[15,42],ingrain:40,inher:[11,42,43],init:[9,15,21],initarr:9,initi:[7,9,15,16,17,21,25,35,37,39,42],initial:[15,19,20],inout:48,input:[2,3,4],input_data_list:[29,44],input_templ:5,inputdata:[5,9,11,12,43,44],insid:[17,25],instal:[28,33,40,43,48],install:[28,40,48],instanc:[2,3,5,7,9,11,15,19,20],instanten:14,instead:[5,11,48],institut:44,instruct:[5,22,28,48],instruction:40,integ:[9,14,25,30,36],integr:[1,16,18,25,43,44],intel:[29,46],intend:[34,48],intent:48,inter:[7,49],interact:[25,29,43,48],interannu:[2,5,6,30],interconnect:42,interfac:[3,9,12],intermitt:[42,43,47],internat:[22,42],internet:43,interp:9,interpa:12,interpb:12,interpc:12,interpol:[4,5,9,11,12,15],interpret:[5,15,40,42,46],interv:[11,14,44],intra:[6,49],intrins:[16,34,43],intro:40,introduc:[17,25,28,30,37],introduct:0,invari:4,invok:[5,34,41,42],invoke:29,involv:[14,28,34,41,42],io_desc_t:9,io_root:9,io_strid:9,io_typ:9,ioff:6,iosystem_desc_t:9,iradsw:2,ish:48,isotop:2,issu:[11,15,17,22,32,36,43],itself:[9,11,35,37,43,44,48],jacob:42,jan:47,jenkin:46,jgfouca:46,job:[15,33,35,37,39,42,43],job_queue:44,job_wallclock_time:[35,37,44],journal:[22,42],jpg:15,junit:48,just:[5,9,11,12,15,17,25,28,32,40,42,48],k_gvd:9,k_lvd:9,k_testcimecas:46,kalman:41,keep:[9,18,33,42],kelvin:[4,5],kernal:15,keyword:[11,34],keywword:2,kind:36,know:[11,12,48],knowledg:12,known:48,l2r:17,lab:15,lag:[15,25,34],laid:34,lambm0:9,lamult:8,land:2,languag:40,larg:[2,9,15,17,43,44,47],larger:[25,30],largest:16,last:[5,9,11,17,21,43,47],lat:[2,3,5,7,9,11,12,17,30],later:[5,11,12,15,48],latest:[44,47],latitud:[5,9,17],launch:[16,47],layer:5,layout:[15,24,25,29,31,33],lead:[5,48],leak:48,least:[9,11,15,42],leav:42,left:[11,46],len:36,lend:44,length:[5,15,18,25,33,42,47],less:[5,9,17,40,48],let:41,letter:33,level:[14,15,16,22,33,40,43,46,48],leverag:[9,28],levi:28,lfrac:[2,3,17],lfrin:17,lib:[29,40],lib_netcdf:5,lib_pnetcdf:9,librari:[9,24,25,29,33,39],licens:40,license:40,like:[2,5,11,12,15,16,17,25,28,31,42,43,44,46,47,48],limit:[9,11,15,16,25,39],line:[5,15,17,34,35,37,40,43,47,48,49],linear:[5,9,11],linearli:[11,42],link:[40,44],linux:43,list:[9,11,12,28,29,30,31,33,43,44,46,48],lmwg:2,lnd2atm:17,lnd2rtm:17,lnd:[3,11,17,28,29,30,34,41,42,44,49],lnd_in:34,lnd_in_0001:41,lnd_in_0002:41,lnd_modelio:24,lndname:28,lndname_ocnnam:28,load:[15,27,33,34,37,42,43,44,45,48,49],local:[9,11,13,15,17,29,32,43,44,47,48],locat:[5,9,11,22,29,34,43,44,48],lock:[33,44],lockedfil:33,log:[17,18,29,35,37,42,43,44,46,47],logdir:44,logic:9,login:43,lon:[5,9,11,12,17,30],longer:[5,17,25,33,44,47],longitud:[5,9,17],longnam:[30,31],longwav:2,look:[11,12,28,30,31,35,37,42,44,46,47,48],loop:[2,3,6,11,16,19,20,22],looser:15,lost:5,lot:48,low:[31,42],lower:[9,11,25],lsf:43,lsize:9,lsizer:9,lt_archiv:33,ltarchive_spec_file:31,lwdn:[2,5,7],lwdn_af:2,lwup:[2,3,5,7],mac:[36,43],mach:[31,43],machin:[9,28,30],machine_compiler:46,machine_spec_file:31,machines_spec_file:31,macport:43,macro:[9,29,33,45],made:[14,15,17,32,34,42,44,45,46],magazin:48,mai:[4,9,11,15,17,25,28,29,30,40,42,43,44,46,47,48],main:[11,22,25,40,43,48,49],maintain:[25,40,44,48],major:[17,44,48],make:[5,9,11,14,17,25,28,29,33,34,35,37,40,42,43,44,45,46,47,48],makefil:[5,45],manag:[12,18,19,20,21,24],manage_cas:[30,31],manage_testlist:39,manange_cas:28,mandatori:46,mangl:47,mani:[9,11,17,18,21,28,36,43,46,48],manner:44,manor:25,manual:[11,29,32,48],map:[2,3,5,6,7,8,9,11,12,13,15],map_atmname_to_lndname_aav:28,map_atmname_to_lndname_blin:28,map_atmname_to_ocnname_aav:28,map_atmname_to_ocnname_blin:28,map_atmname_to_ocnname_patc:28,map_atmocn_mct:17,map_lndname_to_atmname_aav:28,map_lndname_to_rtmname_aav:28,map_ocnname_to_atmname_aav:28,map_ocnname_to_atmname_blin:28,map_ocnname_to_lndname_aav:28,map_rtmname_to_lndname_aav:28,mapa2:17,mapa2i:17,mapa2l:17,mapa2o:17,mapalgo:[9,11,12],mapi2a:17,mapi2o:17,mapl2a:17,mapmask:[9,11],mapo2a:17,mapo2i:17,mapper:15,mapread:[9,11],mapwrit:[9,11],mar:11,markdown:40,mask:[9,11,12,17,28,30],mask_g:30,massiv:42,mast:14,master:[2,3,5,6,7,8,36,46],match:[2,3,5,7,8,17,25,31,44,46,47,48],matrix:9,max:9,max_tasks_per_node:43,maxim:[5,15,42],maximum:[11,15,16,17,25,42,43],mct_avect:9,mct_ggrid:9,mct_gsmap:9,mct_rearr:9,mct_smatp:9,mean:[5,9,15,17,28,34,42,43,46,48],mechan:44,meet:[9,21,25],melt:[5,7],melth:[5,7],meltw:[5,7],melvin:43,melvin_gnu:46,member:48,memcomp:46,memleak:46,memori:9,mention:[12,15,17,25,43],mere:5,merg:[15,17,21,22,25,34,43,48],messag:[4,17,29,40,44,47,48],met:43,meta:[9,11],method:[9,11,12,15,17,18,21,25,39,42,44],metric:42,michael:28,microwav:7,mid:[5,11,47],middl:[5,11,18],might:[4,5,11,12,15,17,23,25,31,42,47,48],migrat:44,millisecond:48,min:9,minim:[9,15,21,25,42,47,48],minimum:[11,12,16,17,30,42,43,44,48],minu:28,minumum:43,minut:44,miscellan:26,miss:[4,5,9,11,29,44],missing_valu:5,misunderstood:34,mix:[5,15,41,42,49],mkdir:48,mkmapdata:28,mksurfdata:28,mksurfdata_map:28,mktemp:48,mlevy_at_ucar_dot_edu:28,mod:[31,33,46],mode:[2,3,4],model_build:46,model_grid:28,model_pres:4,modeldt:9,modif:[11,32,34,37,43,45],modifi:[5,11,12,17,28,29,30,33],modify_via_xml:34,modul:[0,9,10,20,26,27,29,39,43,45,46,48,49],module_system:43,monitor:[39,40,43],month:[5,11,15,35,37,42,43,44,47,48],monthli:[5,9,11,14,18,44],more:[5,9,11,12,15,19,20],mortem:46,mosart:30,most:[9,11,12,18,25,28,29,33,40,42,47,48],motiv:41,move:[9,15,21,25,33,44,47,48],mpi:[9,15,16,21,34],mpi_comm_rank:36,mpi_comm_siz:36,mpi_comm_world:36,mpi_final:36,mpi_get_processor_name:36,mpi_init:36,mpi_max_processor_name:36,mpi_wtime:36,mpich:[36,48],mpilib:[43,48],mpilibs:[43,48],mpirun:43,mrg:17,mrg_x2a:17,mrg_x2o:17,much:[9,15,17,25,42,48],multi:[5,19,20],multipl:[2,3,5,7,11,12,15,23,25,28,34,40,41,42,43,45,48],multipli:17,must:[4,5,9,11,18,23,25,28,29,30,33,34,40,42,43,44],mutual:34,mvelpp:9,my_build_dir:48,my_test_id:46,mycas:40,mype:36,myproj:46,myqueu:46,mytest:46,n_gvd:9,n_lvd:9,name:1,name_l:30,name_m:30,name_oi:30,name_r:30,name_w:30,nameatm:28,namelist_definition_datm:[2,11],namelist_definition_dic:7,namelist_definition_dlnd:3,namelist_definition_docn:5,namelist_definition_drof:6,namelist_definition_drv:34,namelist_definition_dwav:8,namelist_definition_file:31,namelist_var:11,namelnd:28,nameocn:28,namertm:28,namlist:9,nan:48,nation:[15,40],ncap2:5,ncar:[2,15,28,48],ncdump:5,ncep:[2,11,12],ncgen:5,nck:5,ncpl:25,ncpl_base_period:25,ncrcat:5,ncrenam:5,ndai:[42,44],ne30:30,ne30_g16:[30,41,43],ne30_ne30:43,ne30np4:30,ne30np4_l:30,ne30np4_oi:30,nearest:[9,11],nearli:[15,25],necessari:[5,27,28,29,35,37,40,44,48],necessarili:15,need:[2,3,4,5,6,7,9,11,12,15,16,17,25,28,29,31,32,33,37,40,41,42,43,44,47,48,49],neg:[2,11,34],neighbor:11,neither:43,net:[14,17,48],netcdf:[5,9,11,18,43,44,47,49],never:[17,33,34,42],new_namelist_valu:11,newer:43,newgrid:28,next:10,nfile:9,nflds_snow:3,nif:7,nightli:46,ninst:[34,41],ninst_:23,ninst_atm:41,ninst_ice:41,ninst_lnd:41,ninst_ocn:41,ninst_rof:41,nlat:[5,30],nlcomp:46,nlon:[5,30],nml:24,nmlo:24,nmonth:[18,35,37,44],nnnn:[41,45],nnoni:11,nnonj:11,node:[15,31,34,42,43,47],nodename_regex:43,noevolve_ww3_bgc:30,nomask:11,non:[4,5,17,28,33,46,49],none:[2,3,5,6,7,8,36,43],nonsolarflux:2,noout:43,nor:43,normal:[2,5,7,9,11,14,17,18,25,34,42,44,47],north:17,northward:17,not_set:11,note:[2,5,11,17,24,29,30,34,35,46,48],notifi:46,now:[17,25,34,42],npfix:17,nstream:9,nstrmax:9,ntasks:[33,34,41],ntasks_ice:34,ntasks_ocn:34,nthrds:[33,34,41],nthrds_ice:34,nthrds_ocn:34,nthrrds:34,null_w:[30,33],num_iotask:9,number:[2,3,5,9,11,15,16,17,25,30,33,34,36,41,42,43,44,45,48],numer:[28,40],nvecmax:9,nvector:9,nxg:9,nyear:[18,42,44],nyf:[11,12],nyf_sglc_swav:[30,33],nyf_sglc_swav_desp:30,nyf_slnd_dice:[30,33],nyg:9,nzg:9,obj:29,object:[29,43],obliqr:9,obliqu:9,observ:[2,5,6,7,12,44],obtain:[5,11,29,30,31,34,44],obviou:44,obvious:42,occasion:[42,44],occupi:[29,40],occur:[9,15,42],ocean:2,ocean_tight_coupl:25,ocn2atm:17,ocn:[5,17,28,29,30,34,41,42,44,49],ocn_coupling:34,ocn_grid:28,ocn_ice_forcing:34,ocn_in:34,ocn_modelio:24,ocn_pres:5,ocn_transient:34,ocnnam:28,ocnnext_alarm:25,ocnrun_alarm:25,ocphidri:2,ocphiwet:2,ocphodri:2,octal:5,off:[2,3,4,5,6,7,8,11,12,14,15,16,29,34,42,44,48,49],offici:25,offlin:[17,28],offset:[9,11,12,25],ofrac:[2,17],ofrad:17,often:[9,11,12,15,34,42,44,47,48],okai:43,old:[5,17],older:44,omit:28,omp_num_threads:16,omp_set_num_thread:16,omp_stacksize:43,onc:[15,25,41,45,48],once:[11,15,43,44,48],one:[2,3,5,6,7,8,15,17,42,43,47],onli:2,only:[11,29,34,41,43],onto:48,open:[9,46],openmp:[15,16,34,42,48],oper:[2,3,5,6,7,9,11,12,13,15,17,21,33,42,43,48],oppos:[9,11],optim:[9,17,29,31,42,44],optimal:42,optimiz:[34,39],optimum:15,option:[5,9,11,12,13,15,17,18,24,30,33,39,40,42],optional:[9,30,43,48],orbit:9,order:[9,11,13,17,21,29,30,31,39,42,43,44],organ:33,origin:32,other:[2,5,7,11,12,13,14,15,16,17,22,23,25,28,30,31,33,34,40,42,44,48,49],otherwis:[25,28,32,43,48],our:42,out:[5,11,12,13,17,21,22,28,30,31,33,34,41,42,43,44,47,48],outlin:5,output:[3,4,5,6,11,12,14,17,18,24,25,28,29,30,31,33,39,40,41,42,43],output_root:46,outsid:11,over:[2,3,5,6,9,11,14,15,17,18,21,25,42,43,47,48],overal:[15,17,42],overflow:47,overlap:[12,15,25,34,42],overload:30,overlook:17,overrid:29,overridden:43,overview:[9,10],overwrit:[43,44],overwritten:[34,45],ovf:44,own:[4,11,15,28,29,30,43,44,47,48],pack:12,packag:[15,39],page:[0,10,20,26,27,39,49],pair:[2,11,30,34],parallel:[9,12],paramet:[15,17,34,41,43,44],parent:43,pars:[11,31,47],part:[5,9,15,18,22,26,29,30,33],partial:[11,13,17],particular:[5,11,12,15,17,34,41,42,43,49],particularli:[15,17,48],partit:[34,42],pass:[2,3,5,7,8,12,15,25,43,46,48],past:17,patch:[5,28],path:[5,9,29,39],pathnam:[28,33],pattern:15,pbot:2,pbot_af:2,pdf:48,pelayout:33,pend:[11,46],penetr:7,per:[5,15,16,25,34,42,43],percent:[5,17],perfect:15,perform:[5,9,11,12],perhap:4,perihelion:9,period:[2,11,12,14,18,25,30,44],perl:40,permiss:[11,34],permit:[30,33],perspect:[12,42],pes:43,pes_per_node:43,pes_spec_file:31,pesiz:31,pfunit3:48,pfunit:39,pfunit_path:48,phase:[15,16,21,44,46],phy:[30,34],physic:[5,9,15,43,47,49],pick:11,piec:[42,48],pinpoint:48,pio:[9,24,29,33],pio_inparm:21,pio_iodesc:9,pio_spec_file:31,pio_subsystem:9,place:[5,11,17,28,29,33,34,40,41,42,43,44,46,47,48],plai:25,plain:11,platform:[33,39],pleas:28,plot:43,pnetcdf:[9,43],pnetcdf_path:9,point:[2,5,11,16,17,23,25,29,30,33,34,41,42,48],pointer:[9,44,48],polar:17,pole:[17,28,30],pop2:[2,5,30],pop2_blckx:34,pop2_blcky:34,pop2_decomptype:34,pop2_mxblcks:34,pop:[5,7,31],popul:29,port:[26,31,33,36],portion:48,posit:[11,25],possibl:[5,9,12,15,25,28,29,30,31,42,43,44,47,48],post:[44,46],potenti:[5,15,17,25,36,42,43],practic:[9,15,42,43,48],pragprog:48,pre:[2,3,5,6,7,8,11,30,43,44],prec:[2,5],prec_af:2,preced:31,precip:[2,11],precis:[5,17],precsf:2,predict:9,prefer:[44,48],prefix:23,prepend:[11,34],preprocess:15,prerequiset:43,prerequisit:39,presaero:[2,11],prescrib:[2,5,7,12,30,34,41],prescribed_0001:41,prescribed_0002:41,presenc:[29,44],present:[9,12,15,28,44],preserv:[13,17,32],pressur:2,prestag:37,presumpt:17,pretti:[42,43,46],prev_histori:5,prevent:[15,33],preview:34,preview_namelist:[11,33,34,44],preview_namlist:44,previou:[2,3,5,6,9,12,25,28,29,33,37,39,43],previous:2,primari:[9,24,31,41],primarili:[6,8,12,22],principl:15,print:[33,46,47,48],prior:[16,28,36,43,46],privat:9,probabl:44,probe:46,problem:[9,14,33,39,40,43,44],proc:46,proce:29,procedur:[5,43,48],proceed:33,process:[15,28,29,36,40,43,44,48],processor:[9,13,15,16,21,22,25,31,33,34,39],produc:[2,3,17,18,42,43,44,47,48],product:[12,15,18,42,43,44,48],prof_inparm:21,profile:42,prognost:[2,3],program:[22,36,43,49],programm:49,progress:[40,44,46],proj3:[11,12],project:[26,43,44,46,48],project_required:43,pronghorn:31,proper:[5,25],properli:[17,43],properti:11,propos:42,proven:33,provid:[2,3,4,5,6,7,8,11,12,13,15,17,22,24,25,28,29,34,40,41,42,43,44,46,47,48],proxi:43,proxy:43,pslv:[2,5,11,12],pstrid:34,pt1:30,ptem:[2,7],pull:43,pure:5,purpos:5,put:[11,41,44,46,48],python:[40,46,48,49],q10:11,q_10:[2,12],qbot:5,qian:2,qicenn:3,qref:[2,3,7],qsub:47,quantiti:17,queri:28,queue:[15,31,33,42,43,44,46,47],quick:39,quicker:9,quickli:42,quit:[9,47,48],quota:[44,47],r05_m:[30,33],radian:9,radiat:[2,15,17,21,25],rain:[5,7],rainc:2,rainc_18o:2,rainc_hdo:2,rainl:2,rainl_18o:2,rainl_hdo:2,ram1:3,ran:29,random:48,rang:[11,38],rank:15,rare:42,rate:7,rather:[12,30,34,40,48],ratio:[11,17],raw:44,rcp8:30,reach:47,read:[3,4,5,6,7,9,11,12,15,21,40,43,44,47,48],readi:43,readme:[28,32,33,40,48],real:[9,36,48],realiz:11,realli:[4,25],reanalysi:12,rearrang:[9,13,15,17,21,25],rearrr:9,reason:[9,15,17,34,42,43,44,48],rebuilt:29,receiv:[4,7,12,15,17,40],recent:9,recogn:[17,40],recommend:[28,29,42,43],record:[40,45],recreat:45,redirect:47,reduc:[9,25,40,47],redund:9,refer:[2,5,11,15,17,22,25,30,34,40,41,42,44,45],referenc:[5,9],referencemanu:48,reflect:[17,29],regard:46,regardless:[15,48],region:17,regress:[30,39],regrid:[9,17,49],regular:[30,31,43],regularli:18,reintroduc:11,reiter:25,rel:[9,15,17,18,24,25,34,42,44,47],relat:[2,3,5,6,7,8,9,11,15,17],relax:44,releas:[29,44],relev:[11,32,44],reli:15,reliabl:42,remain:[17,21,42,44,48],remot:9,remov:[5,11,41,45,47],renam:[5,45],repeat:[5,40,46,48],repeatedli:11,replac:[1,5,40,48,49],replic:2,report:[47,49],repositori:[5,43],repres:[15,25,46],reproduc:[43,44,46],request:[18,23,31,34,43,44,47],requir:[2,3,5,6,7,8,9,11,12,15,17,18,21,23,25,28,29,30,33,39,40,41,42],reread:9,rerun:[11,29],rescal:17,reset:48,resid:29,resolut:[5,15,17,28,30,33,34,35,40,42,43,49],resolv:[15,33],resourc:[42,48],respect:[14,17,34,42,43,44,48],respons:[12,15,25,43],rest:[37,44],rest_date:44,rest_n:[42,44],rest_option:[42,44],restart:[2,3,5,6,7,8],restart_n:18,restart_opt:18,restart_option:42,restart_ymd:18,restfil:[2,3,5,6,7,8],restfilm:[2,3,5,6,7,8,9],restrict:11,resubmit:[35,37,44,47],result:[2,5,9,11,13,15,17,18,23,25,30],resumit:37,reus:[11,12,48],review:[29,33,42,43,47],revis:32,right:[11,25],risk:29,robust:23,rof:[6,28,29,30,41,42,44],rof_in:34,rof_in_0001:41,rof_in_0002:41,rof_modelio:24,rof_pres:6,roff:6,rofi:5,rofl:5,rofospher:6,role:25,root:[2,3,5,6,7,8,13,15,29,31,33,34,35,43,46],rootpe:[33,34,41],rootpe_ocn:34,roundoff:17,rout:30,routin:[9,17,21,48],rpointer:[9,18,44],rtm:[28,30],rtmname:28,rule:[42,48],run:[2,3,4],run_refcase:[37,44],run_refdate:[37,44],run_startdate:[5,44],run_test:48,run_type:[37,44],rundir:[11,29,37,44,47],running:46,runoff:[6,12,15,17,21,25,28],runtim:[17,33,34,39,42,45],sa_co2diag:2,sa_co2prog:2,sa_den:[2,7],sa_lwdn_af:2,sa_pbot:2,sa_pbot_af:2,sa_prec_af:2,sa_precsf:2,sa_pslv:[2,5],sa_ptem:[2,7],sa_shum:[2,7],sa_shum_16o:2,sa_shum_18o:2,sa_shum_af:2,sa_swdn_af:2,sa_tbot:[2,7],sa_tbot_af:2,sa_topo:2,sa_u:[2,7],sa_u_af:2,sa_v:[2,7],sa_v_af:2,sa_z:[2,7],sack:48,safe:48,safer:5,safest:29,sai:[36,41,42],salin:5,salt:[5,7],same:[2,3,5,7,9,11,12,16,17,18,23,25,28,30,34,40,41,43,44,46,47,48],samegrid:17,samegrid_:17,samegrid_ao:17,samegrid_ro:17,sampl:9,sandbox:31,satisfi:43,satm:[30,31],save:[5,9,11,12,15,36,44],save_timing_dir:43,scalabl:15,scalar:[9,15,17,18],scale:[11,15,17,42,43],scatter:9,scenario:[30,37,44],schedul:[46,47],schema:[31,43],scheme:[25,44],scienc:[2,3],scientif:[5,15,21,25,34,42,43,49],scope:48,scpl_sice_socn_srof_sglc_swav:30,scratch:[29,44,46],scrip:[15,28],script:[2,3,4,5,6,7,8,11,17,25,26,28,29,30,31,32,33,34,35,37,39,40,42,43,44,45],scripts_regression_test:[43,46,48],sea:[5,7,15,17,25,30],search:[0,9,10,20,26,27,28,31,39,42,43,47,49],season:[15,42,43],sec:[9,48],secifi:11,second:[9,11,15,17,21,25,28,34,42,43,44,46,47,48],section:[9,10],see:[9,11,25,28,29,30,32,33,34,40,42,43,44,45,46,47,48],seem:9,seg:9,select:9,self:[17,46,48],sen:[2,3,5,7],send:[4,12,28,40,44,47],sens:[42,47],sensit:44,sensor:7,sent:[2,3,4,5,6,7,8,9,12,15,17,21],separ:[2,3,5,6,7,8,9,12,15,22,25,42,43],seper:43,seq_domain_mct:17,seq_frac_mct:17,seq_infodata:21,seq_map:[17,24,48],seq_mct_drv:[35,37],seq_timemgr:21,seq_timemgr_mod:25,sequenti:[15,23,34,42],seri:[2,11,15,24,42,44],serial:[9,41,43,48],serious:17,serv:[11,44,48],server:[29,44],sesp:30,set:[2,3,4,5,6,7,8,9,11,12,13,14,15,16,17,18,21,23,24,25,28,29],setenv:40,setup:[12,15,29,33,34,35,37,39,40,41,42,44],setup_outfil:5,sever:[2,9,11,14,15,17,24,27,40,42,43,44,47],sf_ifrac:2,sf_lfrac:2,sf_ofrac:2,sglc:30,share:[11,12,15,16,29,40,43,48],sharedlib:46,sharedlib_build:46,sharedlibroot:29,shell:[43,45,48],shift:[11,25],shnum:11,shortest:25,shorthand:30,shortwav:[2,7,17],should:[2,3,4,5,6,7,8,11,15,17,18,23,24,25,28,29,33,34,37,40,41,42,43,44,45,46,47,48],shouldn:48,show:[12,15,48],shown:[29,31,33,36,40,47],shr_dmodel_mod:9,shr_kind_cl:9,shr_kind_cs:9,shr_kind_cxx:9,shr_kind_in:9,shr_strdata:9,shr_strdata_mod:11,shr_strdata_nml:[2,3,4,5,6,7,8,9,10],shr_strdata_typ:9,shr_stream_file_nul:9,shr_stream_filetyp:9,shr_stream_mod:9,shr_stream_streamtyp:9,shum:[2,7,12],shum_16o:2,shum_18o:2,shum_af:2,si_anidf:7,si_anidr:7,si_avsdf:7,si_avsdr:7,si_ifrac:[5,7,17],si_qref:7,si_t:7,si_tref:7,sice:30,sign:25,signal:48,signific:[9,12,15,29,34,42,47],significantli:15,similar:[11,30,44,48],similarli:7,simpl:[9,11,32,33,43,48,49],simplest:43,simpli:[5,11,12,28,40,43,48],simplifi:[25,28],simul:[2,3,5,6,17,33,42,43,47],simulated_year:42,sinc:[5,14,17,28,29,34,41,45],singl:[2,5,12,15,17,23,28,30,41,42,43,44,46,48,49],site:[2,47],six:[25,48],size:[9,15,17,42,47],skip:[28,48],sl_anidf:3,sl_anidr:3,sl_avsdf:3,sl_avsdr:3,sl_fv:3,sl_landfrac:3,sl_qref:3,sl_ram1:3,sl_snowh:[2,3],sl_t:3,sl_topo:3,sl_tref:3,sl_tsrf:3,slab:[5,30],slightli:[12,17,25,46],slnd:30,slow:47,slp_:[2,11,12],slurm:43,small:[9,15,17,48],smallest:25,smatp:9,smatpf:9,smooth:28,smp:29,smp_build:29,smp_value:29,sms:46,sno:3,snow:[3,5,7],snowc:2,snowc_18o:2,snowc_hdo:2,snowh:3,snowhl:2,snowl:2,snowl_18o:2,snowl_hdo:2,so_:[5,7],so_dhdi:[5,7],so_dhdx:[5,7],so_duu10n:5,so_fswpen:5,so_t:[2,5,7],so_u:[5,7],so_v:[5,7],socn:30,soft:43,softwar:[25,40],software_environ:45,solar:[2,11,34],solar_const:34,solv:40,som:[5,30],somaqp:30,some:[4,5,11,12,15,17,22,25,28,33,34],somedata:48,someth:[11,25],sometim:[11,40,46,47,48],somewhat:42,somewher:9,sourc:[9,11,12,13,17,22,32,33,40,43,44,48,49],sourceforg:48,sourcemod:[5,29,32,33],space:[9,11,12,15,29,30,44,47],span:38,spars:9,spatial:[4,5,9,11,12,15],specfi:12,special:[2,3,5,7,8,11,29,48],specif:[2,9,11,12,15,22,25,28,30],specifi:[2,3,4,5,6,7,9,11,12,14,15,17,18,23,24,25,28,29,30,31,34,35,40,43,44,48],spectral:30,speed:48,sphere:30,spin:[2,15,42,43],spinup:[2,12],split:40,spoke:49,spot:[15,42],spread:[11,34],spval:11,src:[2,3,5,6,7,9,29,31,34,40,48],srcmask:11,srcroot:[5,31,34],srof:30,ssmi:7,ssmi_docn:[30,33],ssmi_iaf:7,ssss:44,sssss:44,sst:[5,7,11,30],sst_aquap:30,sst_cpl:5,sstice_data_filename:5,sstice_grid_filename:5,sstice_stream:5,sstice_t:5,sstice_year_align:5,sstice_year_end:5,sstice_year_start:5,ssticetemp:5,st_archiv:[33,43,44],stabil:[15,25],stage:44,stamp:[12,47],stand:[27,46,49],standalon:[30,40],standard:[4,5,9,15],start:[2,3,5,6,9,14,15,18,33,34,37,39],startup:44,state1hr:2,state3hr:2,state:[7,17,18,25,44,46,48],statement:48,statist:[23,27,42,49],statu:[44,46,48],status:[29,39],stderr:44,stdout:44,step:[2,5,9,14,15,17,25,28,33,35,39,41],still:[15,17,23,25,28,44,47,48],stop:[11,18,39],stop_date:44,stop_n:[35,37,42,44],stop_option:[35,37,42,44],storag:44,store:[9,43],str_fillalgo:9,str_fillmask:9,str_mapalgo:9,str_mapmask:9,straight:15,strategi:[2,3,5,6,7,8,42],strdata:[9,11,12],stream1:11,stream2:11,stream_input_filenam:11,streama:12,streamb:12,streamc:12,streamn:11,stress:41,stride:34,string:[2,3,4,5,6,7,8,11,34,40,47,48],strm_h:5,strm_qbot:5,strnxg:9,strnyg:9,strnzg:9,strong:15,strongli:[29,42],stub:[34,40,41,49],stub_comp:31,studi:44,stuff:48,sub:[11,30,40,43],subdirectori:[29,31,33],subject:42,submiss:[34,39,43,44],submit:[33,34,35,37,39,40,43],subroutin:[15,17,48],subsequ:[18,31],subset:[11,15,22,25,42,44],substitut:40,subtl:[17,25],subvers:29,succeed:[35,37],success:[16,40,44,47,48],successful:[35,37,47],successfulli:[29,43,44,46,47],suffici:5,suggest:[29,47],suit:[28,46],sum:[13,17],summar:[22,34,42,45],summari:[11,15,17,42,43],supercomput:40,suppli:[1,46],support:[2,3,5,6,7,8,9,11,12,15,17,18,25,28,29,30,31,33,34,39,40,41,42,43,44],supported_by:43,sure:[9,11,14,25,34,35,37,42,44,47,48],surfac:[2,5,7,15,17,21,25,28,40],surrog:9,suspect:47,sw_lamult:8,sw_ustok:8,sw_vstoke:8,swav:30,swdn:2,swdn_af:2,sweet:[15,42],swndf:[2,7],swndr:[2,7],swnet:[2,3,5,7,17],swpen:7,swup:2,swvdf:[2,7],swvdr:[2,7],sx_anidf:2,sx_anidr:2,sx_avsdf:2,sx_avsdr:2,sx_qref:2,sx_t:2,sx_tref:2,sync:44,synchron:[21,25],syntax:11,system:[1,11,15,16,17,21,22,25,28,29,30],system_tests_dir:31,t31_g37:43,t62:[11,12,31],t62_g16:43,t85:30,t_10:[2,11,12],tab:11,tabe:[2,3,5,6,7,8],tag:43,tail:40,take:[5,9,12,17,42,43,46,47,48],taken:[4,11,14],tape:44,tar:44,target:[2,9,11,29],task:[2,3,5,6,7,8,9,15,16,23,25,34,41,43],taui:[2,3,5],taux:[2,3,5],tauxa:7,tauxo:7,tauya:7,tauyo:7,taxmod:[5,9,11],tbot:[2,7,11,12],tbot_af:2,tdd:48,teardown:39,tell:[17,44,48],temp2:5,temp:5,temperatur:[2,4,5,17],templat:[25,40,43],tempor:[2,4,11,12,15,25,42,43],ten:15,term:[14,17,33,39],termin:[40,47],termination:[35,37,47],test:[5,15,18,26,27,28,30,31,36],test_cime_cas:46,test_circl:48,test_root:46,test_suites:46,testcas:[46,48],testcircl:48,testid:46,testmods:46,tests:[43,46],tests_mods_dir:31,tests_spec_file:31,teststatu:46,testtype:46,text:[11,12,29,30,32,33,34,40,43,44,47],than:[2,5,9,11,12,17,25,30,31,34,40,42,47,48],thei:[2,3,5,7,8,9,11,12,15,17,18,29,33,34,40,41,42,43,45,46,47,48],them:[11,15,27,29,33,43,44,46,47,48],therebi:11,therefor:[5,11,34,44],thi:[2,3,4,5,6,7,8,9,11,12,13,14,15,16,17,18,21,22,23,25,28,29,30,31,32,33,34,35,40,41,42,43,44,45,46,47,48],thing:[11,12,17,42,43,46,47,48],third:15,those:[2,3,5,6,7,8,9,11,12,13,16,17,21,23,25,31,32,34,44,47],though:[9,17,48],thoughput:42,thought:17,thousand:15,thread:15,three:[9,12,15,16,17,34,44],through:3,throughout:[11,48],throughput:[15,34,42,43,44,46],thu:44,tightli:15,time:[2,4,5,9,11,12,15,17,18,19,20,21,22,23,24],time_atm:30,timeout:47,timer:42,timescal:43,timestamp:[9,11,18,47],timestep:[9,15,17,25,42,47],timing:42,tintalgo:[9,11],tinterpalgo:9,tlat:5,tlon:5,tlong:5,tnn:30,tod:9,todlb:9,todo:[5,9,41,43],todub:9,togeth:[13,40,44],toler:[17,48],took:[46,47],tool:[5,17,21,26],toot:34,top:[15,22,33,34,40,43,46,48],topo:2,topographi:2,toponn:3,total:[5,9,15,17,22,34,35,37,42],toward:43,tower:2,tpqw:[2,11],track:[18,33,42,43,46],trans_1850:11,transfer:25,translat:[2,3,5,6,7,8],trap:11,tream:9,treat:[15,17,42],tree:[22,29,32,34,48],tref:[2,3,7],trigger:[18,25],tripol:30,troubleshoot:39,truncat:[17,30],trunk:48,tsrfnn:3,tstamp:[42,43,47],tstamp_writ:47,turn:[2,3,4,5,6,7,8,9,11,12,14,15,16,29,42,43,44],tweak:28,two:[2,3,4,5,6,7,8,9,11,12,15,17,21,23,25,30,31,34,36,42,43,44,46,48],txt:[11,34,40,41,45,48],type:[2,9,13,15,17,31,39,40,42,43],typic:[9,12,15,17,25,31,40,42,44,47,48,49],u_10:[2,11,12],u_af:2,ucar:44,uiliz:2,unalt:4,uncommon:47,under:[15,22,29,40,41,44],undergo:28,underli:[17,46],understand:[22,30,36,42,48],undertak:42,unexpect:48,uniform:11,union:[34,42],uniqu:[2,3,5,6,7,8,12,15,17,30,34,40,42,44,48],unit:[25,39,40,42,43],unit_test:[40,48],uniti:28,unittest:46,unix:40,unknown:42,unless:[4,33,42,43,44],unlik:4,unlike:[18,44],unlock:33,unmask:28,unpredict:47,unreli:48,unrepeat:48,unscal:17,unset:[31,43],unsur:42,until:[17,25,40,44,46],upcom:41,updat:[2,5,17,25,44,46],update_acme_test:46,upon:[9,15,17,44,46],upper:[9,11],usag:[9,15,26,28,29,32,33,34,41,46,47,48],usage:[26,30],use:[11,26,30,35],used:46,useful:47,user:[2,3,4,5,7,8,9,11,12,15,16,17,22,26,28,29,30,31,33,34,37],user_:[11,34],user_datm:[11,34],user_dic:34,user_dlnd:34,user_docn:[34,41],user_drof:34,user_mods_dir:31,user_nl:45,user_nl_:[37,41],user_nl_c:34,user_nl_cam:34,user_nl_cam_0001:41,user_nl_cam_0002:41,user_nl_cic:34,user_nl_cice_0001:41,user_nl_cice_0002:41,user_nl_clm:34,user_nl_clm_0001:41,user_nl_clm_0002:41,user_nl_cpl:[34,41],user_nl_datm:[2,11,34],user_nl_datm_nnn:34,user_nl_dic:[7,34],user_nl_dice_nnn:34,user_nl_dlnd:[3,34],user_nl_dlnd_nnn:34,user_nl_docn:[5,34],user_nl_docn_0001:41,user_nl_docn_0002:41,user_nl_docn_nnn:34,user_nl_drof:[6,34],user_nl_drof_nnn:34,user_nl_dwav:8,user_nl_pop2:34,user_nl_rtm:34,user_nl_rtm_0001:41,user_nl_rtm_0002:41,user_nl_xxx:[11,33,34,45],user_nl_xxx_nn:41,user_nl_xxx_nnnn:41,user_nl_xxxx:32,user_xxx:11,userdefined_laptop_templ:43,users:41,using:[28,39],usr_gdat:28,usr_gnam:28,usrspec:28,ustok:8,ustrm:9,usual:[16,18,30,36,40,42,43,44,47,48],util:[9,11,17,28,29,30,33,34,40,49],utiliz:41,uwind:2,v_10:[2,11,12],v_af:2,val:34,vari:[5,15,17,42],variablenam:[11,12],variat:[9,42,47],varieti:38,variou:[4,5,15,26,29,31,33,42,46],vect_map:17,vector:[2,3,5,6,7,8,9,11,17],veloc:17,veri:[7,15,17,36,42,43,48],verifi:[4,11,17,34,43,44,48],vernal:9,version:[2,5,17,30,36,40,43,49],versu:15,vertenstein:42,vertic:9,via:[9,11,12,15,17,23,25,29,34,44,48],view:[11,30,48],volum:[17,28,30,44],vstoke:8,vstrm:9,vwind:2,wai:[2,11,15,17,25,29,34,42,44,46,48],wait:42,wall:[42,47],wallclock:[33,35,42,47],want:[1,5,11,29,32,34,41,46,48],warn:33,watch:2,water:[2,7,14],wav:[28,29,30,41,42,44],wav_modelio:24,wav_pres:8,wave:[2,7],weight:[9,11,15,17,21,28,49],well:[2,3,5,6,7,8,11,15,17,21,22,28,32,33,42,43,44,47,48],were:[3,15,17,32,33,44],what:[1,2,3,4,5,6,7,11,12,14,25,26,29,30,31,39,43,47],whatev:[17,48],when:[2,3,4,5,9,11,12,13,14,15,16,17,18,25,27,28,30,31,41,42,43,44,45,46,47,48],whenev:[17,18,44],where:[3,5,9,11,12,13,15,17,25,28,29,30],wherea:5,whether:[11,12,15,17,42,44,48],which:[2,4,5,9,11,12,15,17,18,25,28,29,30,31,34,40,42,43,44,45,46,47,48],whole:11,whose:[2,3,5,6,7,8,28],why:47,wide:47,wil:46,wind:17,wiso_datm:2,within:[2,3,5,6,7,8,9,15,17,22,25,40,41,42,46],without:[2,3,5,7,8,9,11,15,25,34,44,46,48,49],won:[11,46],word:[15,16,23,42],work:[1,2,5,15,22,25,30,33,43,48],workflow:[43,49],workstat:40,world:36,worst:48,worthwhil:42,would:[2,5,9,11,12,15,17,25,34,36,42,43,46,48],wrap_nf_def_var:5,wraparound:11,write:[9,11,14,17,18,28,36,39,43,44,47],writeabl:34,written:[9,14,17,18,22,28,42,43,44,48],wrt:[7,9],wtime:36,ww3:[2,5,7,30],www:44,xatm:[30,31],xcpl_comp:31,xglc:30,xlat:5,xlmchang:32,xlnd:30,xlon:5,xml_schema:[31,43],xml_variable_nam:34,xmlchang:[29,33,34,35,37,41,42,44],xmllint:43,xmlqueri:[29,33],xocn:30,xrof:30,xsd:[31,43],xunit:48,xwav:30,xxx:[11,45],xxx_in:11,xxxxxxxx:48,yeager:2,year:[2,3,5,6,9,11,14,25,28,35,37,42,43,44],year_align:11,year_first:11,year_last:11,yearalign:9,yearfirst:9,yearlast:9,yearli:5,yellowston:[28,31,35,42],yes:48,ymd:9,ymdlb:9,ymdub:9,you:[1,2,5,11,12,28,29,30,31,32,33,34,36,37,40,41,42,43,44,45,46,47,48],your:[1,5,6,8,11,28,29,30,31,33,34,35,36,37,39,40,41,42],yourself:48,yymmdd:[28,44,47],yyyi:44,yyyymmdd:[9,47],zenith:11,zero:[2,3,5,6,7,12,17,21,28,34]},titles:["Building a Coupled Model with CIME","1. Introduction","5. Data Atmosphere (DATM)","6. Data Land (DLND)","4. Data Model Science","8. Data Ocean (DOCN)","9. Data River (DROF)","7. Data Ice (DICE)","10. Data Wave (DWAV)","3. Design Details","CIME Data Models","2. Input Streams","1. Introduction","3.5. Bit-for-bit flag","3.7. Mass and Heat Budgets","2. Design","3.4. Driver Threading Control","3.2. Grids","3.6. History and Restarts","3. Implementation","CIME Driver/Coupler","3.3. Initialization and Restart","1. Introduction","3.8. Multi-instance Functionality","3.9. More on Driver Namelists","3.1. Time Management","Welcome to the CIME documentation!","Miscellaneous Tools","7. Adding new cases","5. Building a Case","2. The basics of CIME cases","1. CIME internals","8. Cloning a Case","3. Creating a Case","7. Customizing a Case","8.2. A Basic Example","8.1. MPI example","8.3. Setting up a branch or hybrid run","8. FAQ","CIME User’s Guide Part 1: Basic Usage","1. Introduction","6. Multi-instance component functionality","3. Optimizing Processor Layout","2. Porting and Validating CIME on a new Platform","6. Running a Case","4. Setting up a Case","4. Testing with create_test","9. Troubleshooting","5. Fortran Unit Testing","What is CIME?"],titleterms:{"case":[28,29,30,32,33,34,39,40,44,45,47],"class":48,"default":40,"function":[23,41],"long":44,"new":[28,43,48],"short":44,acme:[34,46],activ:34,add:48,adding:[28,46,48],archiv:44,archive:44,area:17,assertion:48,atmospher:[2,34],avail:40,back:44,base:48,baselin:46,basic:[30,35,39],batch:[31,43],between:[2,3,5,6,7,8],bit:13,branch:37,budget:14,build:[0,29,48],call:[29,30,33,44,45],cam:34,cesm:[5,34],check:17,cime:[0,10,20,26,30,31,39,40,43,48,49],cism:34,climat:40,clm:34,clock:25,clone:32,compil:[31,43],compon:[15,28,30,31,34,41],compset:[28,31],concept:40,concurr:15,config_batch:43,config_compil:43,config_machin:43,configur:17,content:[26,40],control:[16,44],correct:17,coupl:[0,15,25],coupler:20,creat:[5,33],create_newcas:33,create_test:46,creation:47,custom:[11,34],data:[2,3,4,5,6,7,8,9,10,11,29,34,42,44],datamod:[2,3,5,6,7,8],datm:[2,34],datm_mode:2,defin:[31,48],descript:11,design:[9,12,15],detail:[9,48],develop:49,dice:[7,34],dice_mode:7,direct:43,directori:40,discov:40,dlnd:[3,34],dlnd_mode:3,docn:[5,34],docn_mode:5,document:[26,48],domain:17,driver:[16,20,24,25,34],drof:[6,8,34],drof_mode:[6,8],dwav:8,dwav_mode:8,exampl:[35,36,48],fail:44,faq:38,field:[2,3,5,6,7,8],file:[9,11,34,43,48],find:48,flag:13,flux:17,fortran:48,fraction:17,frequenc:25,from:5,fulli:5,gener:48,grid:[17,28,30,31],guid:39,guidelin:48,heat:14,histori:18,how:48,hybrid:37,ice:7,implement:19,independ:[2,3,5,6,7,8],indice:[0,10,20,26,27,39,49],initi:44,initial:21,input:[5,11,12,29,44],instanc:[23,41],interfac:15,intern:[2,3,5,6,7,8,31,39],interpol:17,introduct:[1,12,22,40,48],job:[44,47],kei:40,land:[3,34],layout:[34,42],librari:43,limit:42,loop:25,machin:[31,43,48],manag:[25,46],manage_testlist:46,map:17,mass:14,mct:15,memori:15,method:48,miscellan:27,mode:5,model:[0,4,9,10,15,29,30,31,34,40,42,44],modifi:34,monitor:44,more:[24,48],mpi:36,multi:[23,41],name:[2,3,5,6,7,8],namelist:[2,3,5,6,7,8,11,12,24,34],next:12,ocean:[5,34],onli:5,optimiz:42,option:43,order:48,output:44,overview:[11,12,15,48,49],packag:43,parallel:15,part:39,path:43,perform:15,pfunit:48,platform:43,pop2:34,port:[39,43],prerequisit:40,previou:44,problem:47,processor:42,prognost:5,queri:30,query_config:30,quick:40,rebuild:29,regress:46,relationship:[2,3,5,6,7,8],requir:43,restart:[9,18,21,44],result:[33,44],river:[6,34],rtm:34,run:[5,37,44,48],runtim:47,scienc:4,script:46,sea:34,section:12,sequenc:15,set:[30,31,34,37,40,42,45],setup:[45,48],shr_strdata_nml:11,some:40,specif:[31,34,43],sstdata:5,standard:17,start:[40,44],status:44,step:43,stop:44,stream:[2,3,5,6,7,8,11,34],structur:9,subdirectori:40,submiss:47,submit:44,support:48,system:[31,48],tabl:[0,10,20,26,27,39,49],target:31,teardown:48,term:[40,44],test:[39,46,48],thread:16,through:9,time:[25,42],todo:46,tool:27,toolkit:15,trigrid:17,troubleshoot:[44,47],type:44,unit:48,usage:39,use:39,user:39,using:[42,46],valid:[2,3,5,6,7,43],valu:[2,3,5,6,7,8,11],variabl:[2,3,5,6,7,8],wave:8,welcom:26,what:[48,49],where:[31,49],write:48,xml:[2,3,5,6,7,8,34,43,48],your:[43,48]}}) \ No newline at end of file diff --git a/users_guide/building-a-case.html b/users_guide/building-a-case.html index 32e612284ca..d9028374b94 100644 --- a/users_guide/building-a-case.html +++ b/users_guide/building-a-case.html @@ -96,7 +96,7 @@

Quick search

5. Building a Case

-

The following summarizes details of building the model executable.

+

The following describes the process of building the model executable.

5.1. Calling case.build

After calling case.setup, run case.build to build the model executable. Running this will:

@@ -104,20 +104,18 @@

Quick search

  • Create the component namelists in $RUNDIR and $CASEROOT/CaseDocs.
  • Create the necessary compiled libraries mct, pio, gptl and csm_share. The libraries will be placed in a path below $SHAREDLIBROOT.
  • -
  • Create the necessary component compiled libraries. -These will be placed in $EXEROOT/bld/lib.
  • -
  • Create the model executable ($MODEL.exe), which will be placed in $EXEROOT.
  • +
  • Create the necessary compiled libraries. These are be placed in $EXEROOT/bld/lib.
  • +
  • Create the model executable ($MODEL.exe), which is placed in $EXEROOT.
  • You do not need to change the default build settings to create the executable, but it is useful to become familiar with them in order to make optimal use of the system. The CIME scripts provide you with a great deal of flexibility in customizing the build process.

    -

    The env_build.xml variables control various aspects of building the model executable. -Most of the variables should not be modified, but users can modify these:

    +

    The env_build.xml variables control various aspects of building the executable. Most of the variables should not be modified, but users can modify these:

    • $BUILD_THREADED
    • $DEBUG
    • $GMAKE_J
    -

    The best way to determine what xml variables are in your $CASEROOT directory is to use the xmlquery command. For usage information, run:

    -
    ./xmlquery --help
    +

    The best way to see what xml variables are in your $CASEROOT directory is to use the xmlquery command. For usage information, run:

    +
    > ./xmlquery --help
     

    To build the model, change to your $CASEROOT directory and execute case.build.

    @@ -125,23 +123,22 @@

    Quick search

    > ./case.build
    -

    Diagnostic comments will appear as the build proceeds.

    -

    The case.build command generates the utility and component libraries and the model executable, and it generates build logs for each component. Each build log file is date stamped, and a pointer to the build log file for that library or component is shown.

    -

    The build log files have names in this form: $component.bldlog.$datestamp. They are located in $BLDDIR. If they are compressed (as indicated by a .gz file extension), then the build ran successfully.

    +

    Diagnostic comments appear as the build proceeds.

    +

    The case.build command generates the utility and component libraries and the model executable, and it generates build logs for each component. Each log file is named form: $component.bldlog.$datestamp. They are located in $BLDDIR. If they are compressed (as indicated by a .gz file extension), the build ran successfully.

    Invoking case.build creates the following directory structure in $EXEROOT if the Intel compiler is used:

    atm/, cpl/, esp/, glc/, ice/, intel/, lib/, lnd/, ocn/, rof/, wav/
     
    -

    Except for intel/ and lib/, each of those directories contains an obj/ directory for the compiled object files for the target model component.

    -

    The mct, pio, gptl and csm_share libraries are placed in a directory tree that reflects their dependencies. See the bldlog for a given component to locate the library.

    -

    Special include modules are also placed in lib/include. The model executable (for example, cesm.exe or acme.exe) is placed directly in $EXEROOT.

    -

    Component namelists, component logs, output datasets, and restart files are placed in $RUNDIR. -It is important to note that $RUNDIR and $EXEROOT are independent variables that are set as $CASEROOT/env_run.xml.

    +

    Except for intel/ and lib/, each directory contains an obj/ subdirectory for the target model component’s compiled object files.

    +

    The mct, pio, gptl and csm_share libraries are placed in a directory tree that reflects their dependencies. See the bldlog for a given component to locate the library.

    +

    Special include modules are placed in lib/include. The model executable (cesm.exe or acme.exe, for example) is placed directly in $EXEROOT.

    +

    Component namelists, component logs, output data sets, and restart files are placed in $RUNDIR. +It is important to note that $RUNDIR and $EXEROOT are independent variables that are set in the $CASEROOT/env_run.xml file.

    5.2. Rebuilding the model

    Rebuild the model under the following circumstances:

    -

    If either env_build.xml or Macros.make has been modified, and/or if code is added to SourceMods/src.*, then it’s safest to clean the build and rebuild from scratch as shown here:

    +

    If either env_build.xml or Macros.make has been modified, and/or if code is added to SourceMods/src., it’s safest to clean the build and rebuild from scratch as shown here:

    > cd $CASEROOT
     > ./case.build --clean
     
    @@ -151,38 +148,60 @@

    Quick search

    > ./case.build
    -

    If the threading has been turned on or off in any component relative to the previous build, the build script should fail with the following error and suggestion that the model be rebuilt from scratch:

    +

    If the threading has been changed (turned on or off) in any component since the previous build, the build script should fail with the following error and suggestion that the model be rebuilt from scratch:

    ERROR SMP STATUS HAS CHANGED
     SMP_BUILD = a0l0i0o0g0c0
     SMP_VALUE = a1l0i0o0g0c0
    -A manual clean of your obj directories is strongly recommended
    +A manual clean of your obj directories is strongly recommended.
     You should execute the following:
        ./case.build --clean
        ./case.build
     
      ---- OR ----
     
    - You can override this error message at your own risk by executing
    + You can override this error message at your own risk by executing:
        ./xmlchange SMP_BUILD=0
    - Then rerun the build script interactively
    + Then rerun the build script interactively.
     

    If there is any doubt, rebuild.

    -

    The case.build –clean command will clean all of the model components but not support libraries such as mct and gptl. -Use case.build –clean-all to clean everything associated with the build.

    -

    You can also clean an individual component using case.build –clean compname, where “compname” is the name of the component you want to clean (for example, atm, clm, pio and so on). Run case.build –help for details.

    +
    +
    Run this to clean all of the model components (except for support libraries such as mct and gptl):
    +
    > case.build --clean
    +
    +
    +
    +
    Run this to clean everything associated with the build:
    +
    > case.build --clean-all
    +
    +
    +
    +
    You can also clean an individual component as shown here, where “compname” is the name of the component you want to clean (for example, atm, clm, pio and so on).
    +
    > case.build --clean compname
    +
    +
    +
    +
    +

    Review the help text for more information.

    5.3. Input data

    All active components and data components use input data sets. In order to run CIME and the CIME-compliant active components, a local disk needs the directory tree that is specified by the xml variable $DIN_LOC_ROOT to be populated with input data.

    -

    Input data is provided as part of the CIME release via data from a subversion input data server. It is downloaded from the server on an as-needed basis determined by the case. Data may already exist in the default local file system’s input data area as specified by $DIN_LOC_ROOT. (See below.)

    +

    Input data is provided as part of the CIME release via data from a subversion input data server. It is downloaded from the server on an as-needed basis determined by the case. Data may already exist in the default local file system’s input data area as specified by $DIN_LOC_ROOT.

    Input data can occupy significant space on a system, so users should share a common $DIN_LOC_ROOT directory on each system if possible.

    The build process handles input data as follows:

    -
      -
    • The buildnml scripts in the various component cime_config directories create listings of required component input data sets in the Buildconf/$component.input_data_list files.
    • -
    • check_input_data, which is called by case.build, checks for the presence of the required input data files in the root directory $DIN_LOC_ROOT.
    • -
    • If all required data sets are found on the local disk, the build can proceed.
    • -
    • If any of the required input data sets are not found locally, the files that are missing will be listed. At this point, you must obtain the required data from the input data server using check_input_data with the -export option.
    • +
        +
      • The buildnml scripts in the various component cime_config directories create listings of required component input data sets in the Buildconf/$component.input_data_list files.

        +
      • +
      • check_input_data, which is called by case.build, checks for the presence of the required input data files in the root directory $DIN_LOC_ROOT.

        +
      • +
      • If all required data sets are found on the local disk, the build can proceed.

        +
      • +
      • If any of the required input data sets are not found locally, the files that are missing are listed. At this point, you must obtain the required data from the input data server with check_input_data as shown here:

        +
        check_input_data --export
        +
        +
        +

      The env_run.xml variables $DIN_LOC_ROOT and $DIN_LOC_ROOT_CLMFORC determine where you should expect input data to reside on a local disk.

    diff --git a/users_guide/case-basics.html b/users_guide/case-basics.html index c18b6def94d..65d306b285b 100644 --- a/users_guide/case-basics.html +++ b/users_guide/case-basics.html @@ -99,17 +99,19 @@

    Quick search

    Two concepts to understand before working with CIME are component sets and model grids.

    • Component sets, which are usually referred to as “compsets,” define both individual model components and any component-specific namelist or configuration settings that are used in a case.
    • -
    • Model grids specify the grid or resolution for each component making up the model.
    • +
    • Model grids specify the grid or resolution for each component of the model.

    Creating a CIME experiment or case requires, at a minimum, specifying a compset and a model grid.

    -

    Out-of-the-box compsets and models grids are associated with two names: a longname and an alias name. Examples of both follow.

    -

    The CIME regression test system requires aliases, but aliases can also be used for convenience. Compset aliases are unique; each compset alias is associated with one and only one compset. Grid aliases, on the other hand, are overloaded; the same grid alias may result in a different grid depending on the associated compset. Always confirm that the compset longname and the grid longname are correct when using aliases to create a case.

    +

    Out-of-the-box compsets and models grids each have two names: a longname and an alias name. Examples of both follow.

    +

    The CIME regression test system requires aliases, but aliases can also be used for convenience. Compset aliases are unique; each is associated with one and only one compset. Grid aliases, on the other hand, are overloaded; the same grid alias may result in a different grid depending on the associated compset. Always confirm that the compset longname and the grid longname are correct when using aliases to create a case.

    2.1. Component sets

    A compset longname has this form:

    TIME_ATM[%phys]_LND[%phys]_ICE[%phys]_OCN[%phys]_ROF[%phys]_GLC[%phys]_WAV[%phys]_ESP[_BGC%phys]
    -
    -TIME = model time period (e.g. 1850, 2000, 20TR, RCP8...)
    +
    +
    +

    Here are the supported values for each element of the longname:

    + -

    As an example, the CESM compset longname (below) refers to running a pre-industrial control with active CESM components CAM, CLM, CICE, POP2, MOSART, CISM2 and WW3 in a BDRD BGC coupling scenario.:

    +

    As an example, this actual CESM compset longname refers to running a pre-industrial control with active CESM components CAM, CLM, CICE, POP2, MOSART, CISM2 and WW3 in a BDRD BGC coupling scenario:

    1850_CAM60_CLM50%BGC_CICE_POP2%ECO_MOSART_CISM2%NOEVOLVE_WW3_BGC%BDRD
     
    -

    The alias for this compset is B1850. Input to create_newcase can be either a compset longname or a compset alias. -It is also possible to create your own custom compset. See How do I create my own compset? in the FAQ.

    +

    The alias for this compset is B1850. Either a compset longname or a compset alias can be input to create_newcase. You can also create your own custom compset. See How do I create my own compset? in the FAQ.

    2.2. Model Grids

    A model grid longname has the form:

    a%name_l%name_oi%name_r%name_m%mask_g%name_w%name
    -
    -a%  = atmosphere grid
    +
    +
    +

    For reference:

    +
    a%  = atmosphere grid
     l%  = land grid
     oi% = ocean/sea-ice grid (must be the same)
     r%  = river grid
    @@ -178,16 +181,16 @@ 

    2.2. Model Gridshowever, and is specified by the g% value.

    -

    As an example, examine this longname:

    +

    As an example, examine this actual grid longname:

    a%ne30np4_l%ne30np4_oi%gx1v7_r%r05_m%gx1v7_g%null_w%null
     
    -

    It refers to a model grid with a ne30np4 spectral element 1-degree atmosphere and land grids, gx1v7 Greenland pole 1-degree ocean and sea-ice grids, a 1/2 degree river routing grid, null wave and internal cism grids, and an gx1v7 ocean mask. +

    It refers to a model grid with a ne30np4 spectral element, 1-degree atmosphere and land grids, gx1v7 Greenland pole, 1-degree ocean and sea-ice grids, a 1/2 degree river routing grid, null wave and internal cism grids, and an gx1v7 ocean mask. The alias for this grid is ne30_g16.

    CIME also permits users to introduce their own user-defined grids.

    Component grids are denoted by the following naming convention:

    diff --git a/users_guide/cloning-a-case.html b/users_guide/cloning-a-case.html index 586ac7c8111..f84ddb78023 100644 --- a/users_guide/cloning-a-case.html +++ b/users_guide/cloning-a-case.html @@ -87,15 +87,15 @@

    Quick search

    8. Cloning a Case

    If you have access to a run that you want to clone, the create_clone command will create a new case while preserving local modifications to the case.

    -

    Here is the simplest example of using create_clone:

    -
    cd $CIMEROOT/scripts
    -create_clone --case $CASEROOT --clone $CLONEROOT
    +

    Here is a simple example:

    +
    > cd $CIMEROOT/scripts
    +> create_clone --case $CASEROOT --clone $CLONEROOT
     

    The create_clone script preserves any local namelist modifications made in the user_nl_xxxx files as well as any source code modifications in the SourceMods tree. Otherwise, $CASEROOT/ directory will appear as if create_newcase had just been run.

    Important: Do not change anything in the env_case.xml file.

    See the help text for more usage information.

    -
    create_clone --help
    +
    > create_clone --help
     

    Another approach to duplicating a case is to use the information in the case’s README.case and CaseStatus files to create a new case and duplicate the relevant xlmchange commands that were issued in the original case. This alternative will not preserve any local modifications that were made to the original case, such as source-code or build-script revisions; you will need to import those changes manually.

    diff --git a/users_guide/create-a-case.html b/users_guide/create-a-case.html index 4ed9fada083..3c15d0e1400 100644 --- a/users_guide/create-a-case.html +++ b/users_guide/create-a-case.html @@ -101,25 +101,36 @@

    Quick search

    3.1. Calling create_newcase

    The first step in creating a CIME-based experiment is to use create_newcase.

    If you are not on an out-of-the box CIME-supported platform, you will need to port CIME to your system before proceeding.

    -

    Review the input options for create_newcase by using the —help option. The only required arguments to create_newcase are:

    -
    create_newcase --case [CASE] --compset [COMPSET] --res [GRID]
    +
    +
    Review the input options for create_newcase in the help text.
    +
    > create_newcase --help
     
    -

    CIME supports out of the box component sets, model grids* and hardware platforms. Compsets and grids were discussed in the previous section.

    +
    +
    The only required arguments to create_newcase are shown here:
    +
    > create_newcase --case [CASE] --compset [COMPSET] --res [GRID]
    +
    +
    +
    +
    +

    CIME supports out-of-the-box component sets, model grids and hardware platforms. Compsets and grids were discussed in the previous section.

    3.1.1. Result of calling create_newcase

    Following is a simple example of using create_newcase with aliases for both compset and grid names. The complete example appears in the basic example.

    -

    In what follows, $CIMEROOT is the full pathname of the root directory of the CIME distribution.

    -
    > cd $CIMEROOT/scripts
    +
    +
    Here, $CIMEROOT is the full pathname of the root directory of the CIME distribution.
    +
    > cd $CIMEROOT/scripts
     > create_newcase --case ~/cime/example1 --compset A --res f09_g16_rx1
     
    -

    In the example, the command creates a $CASEROOT directory ~/cime/example1. (If that directory already exists, a warning is printed and the command aborts.

    +
    +
    +

    In the example, the command creates a $CASEROOT directory: ~/cime/example1. If that directory already exists, a warning is printed and the command aborts. Additional details:

      -
    • $CASE is example1 ($CASE can include letters, numbers, ”.”, and “_”)
    • +
    • $CASE can include letters, numbers, ”.”, and “_”. In the example, it is example1.
    • The compset is 2000_DATM%NYF_SLND_DICE%SSMI_DOCN%DOM_DROF%NYF_SGLC_SWAV.
    • -
    • The model resolution is a%0.9x1.25_l%0.9x1.25_oi%gx1v6_r%r05_m%gx1v6_g%null_w%null
    • +
    • The model resolution is a%0.9x1.25_l%0.9x1.25_oi%gx1v6_r%r05_m%gx1v6_g%null_w%null.
    • create_newcase installs files in $CASEROOT to build and run the model and to optionally archive the case on the target platform.

    Running create_newcase creates various scripts, files and directories $CASEROOT, as shown here.

    @@ -133,37 +144,36 @@

    3.1.1. Result of calling create_newcase case.setup -Script used to set up the case (create the case.run script, the Macros file and user_nl_xxx files) +Script used to set up the case (create the case.run script, the Macros file and user_nl_xxx files). case.build -Script to build component and utility libraries and model executable +Script to build component and utility libraries and model executable. case.submit -Script to submit the case to run using the machine’s batch queueing system +Script to submit the case to run using the machine’s batch queueing system. case.st_archive -Script to perform short-term archiving of output data +Script to perform short-term archiving of output data. case.lt_archive -Script to perform long-term archiving of output data +Script to perform long-term archiving of output data. xmlchange -Script to modify values in the xml files +Script to modify values in the xml files. xmlquery -Script to query values in the xml files +Script to query values in the xml files. preview_namelists -

    Script for users to see their component namelists in $CASEROOT/CaseDocs before running the model

    -
    +

    Script for users to see their component namelists in $CASEROOT/CaseDocs before running the model.

    +

    Warning

    -

    the namelists generated in $CASEROOT/CaseDocs should not be edited by the user

    +

    Users should not edit namelists that are generated in $CASEROOT/CaseDocs. They are there only to document model behavior.

    -

    they are only there to document model behavior.

    check_input_data -Script for checking for various input datasets and moves them into place. +Script for checking for various input data sets and moving them into place. pelayout Script to query and modify the NTASKS, ROOTPE, and NTHRDS for each component model. This a convenience script that can be used in place of xmlchange and xmlquery. @@ -203,12 +213,11 @@

    3.1.1. Result of calling create_newcaseenv_run.xml -

    Sets run-time settings such as length of run, frequency of restarts, output of coupler diagnostics,

    -

    and short-term and long-term archiving. This file can be edited at any time before a job starts.

    - +Sets runtime settings such as length of run, frequency of restarts, output of coupler diagnostics, +and short-term and long-term archiving. This file can be edited at any time before a job starts. env_batch.xml -Sets batch system specific settings such as wallclock time and queue name. +Sets batch system settings such as wallclock time and queue name. @@ -223,7 +232,7 @@

    3.1.1. Result of calling create_newcase SourceMods -Top-level directory containing sub-directories for each compset component where +Top-level directory containing subdirectories for each compset component where you can place modified source code for that component. @@ -257,14 +266,13 @@

    3.1.1. Result of calling create_newcase Buildconf/ -

    Work directory containing scripts to generate component namelists and component and utility libraries (e.g., PIO, MCT)

    -

    You should never have to edit the contents of this directory.

    - +Work directory containing scripts to generate component namelists and component and utility libraries +(PIO or MCT, for example). You should never have to edit the contents of this directory. LockedFiles/

    Work directory that holds copies of files that should not be changed.

    Certain xml files are locked after their variables have been used by should no longer be changed.

    -

    CIME does this by locking a file and not permitting you to modify that file unless, depending on the file, case.setup —clean or case.build —clean are called.

    +

    CIME does this by locking a file and not permitting you to modify that file unless, depending on the file, case.setup --clean or case.build --clean is called.

    Tools/ @@ -275,19 +283,19 @@

    3.1.1. Result of calling create_newcase$CASEROOT xml files are organized so that variables can be locked at certain points to prevent users from changing variables after they have been resolved (used) in other parts of the scripts system.

    +

    The $CASEROOT xml files are organized so that variables can be locked at certain points to prevent users from changing them after they have been resolved (used) in other parts of the scripts system.

    CIME does the following:

    • Locks variables in env_case.xml after create_newcase.
    • -
    • Locks variables in env_mach_pes.xml are locked after case.setup.
    • +
    • Locks variables in env_mach_pes.xml after case.setup.
    • Locks variables in env_build.xml after completion of case.build.

    Variables in env_run.xml, env_batch.xml and env_archive.xml are never locked, and most can be changed at any time. There are some exceptions in the env_batch.xml file.

    The env_case.html file can never be unlocked.

    -

    These files can be “unlocked” as follows:

    +

    These other files can be “unlocked” as follows:

      -
    • case.setup –clean unlocks env_mach_pes.xml
    • -
    • case.build –clean unlocks env_build.xml
    • +
    • To unlock env_mach_pes.xml, run case.setup --clean.
    • +
    • To unlock env_build.xml, run case.build --clean.

    diff --git a/users_guide/introduction-and-overview.html b/users_guide/introduction-and-overview.html index 7e2e9589147..12c403fff6e 100644 --- a/users_guide/introduction-and-overview.html +++ b/users_guide/introduction-and-overview.html @@ -99,37 +99,40 @@

    Quick search

    1. Introduction

    -

    The Common Infrastructure for Modeling the Earth (CIME) provides a UNIX command-line-based user interface for +

    The Common Infrastructure for Modeling the Earth (CIME) provides a UNIX command-line-based interface for configuring, compiling and executing Earth system models. Part 1 of this guide explains the basic commands -needed to get a model running.

    +that are needed to get a model running.

    1.1. Prerequisites

    -

    Familiarity with the basic climate modeling concepts.

    -

    Familiarity with UNIX command line terminals and the UNIX development environment.

    -

    CIME’s commands are Python scripts and require a correct version of the Python interpreter to be installed.

    -

    The Python version must be greater than 2.7 but less than 3.0. Determine which version you have by typing:

    +

    Part 1 of this guide assumes that CIME and the necessary input files have been installed on +the computer you are using. If that is not the case, see Installing CIME.

    +

    Other prerequisites:

    +
      +
    • Familiarity with basic climate modeling concepts.
    • +
    • Familiarity with UNIX command line terminals and the UNIX development environment.
    • +
    • A correct version of the Python interpreter.
    • +
    +

    CIME’s commands are Python scripts and require a correct version of the Python interpreter to be installed. The Python version must be greater than 2.7 but less than 3.0. Determine which version you have by typing:

    > python --version
     
    -

    NOTE: Part 1 of this guide assumes that CIME and the necessary input files have been installed on -the computer you are using. If that is not the case, see Installing CIME.

    1.2. Terms and concepts

    The following terms and concepts are ingrained in CIME and are used frequently in this documentation.

    -
    active vs data vs stub models:
    -

    Components of a model that solve a complex set of equations to describe the model’s behavior are called +

    active, data and stub models
    +

    active models: Components of a model that solve a complex set of equations to describe the model’s behavior are called active models. Sometimes they are called prognostic or full models.

    -

    CIME recognizes 7 different active models of a climate model. They are:

    +

    CIME recognizes 7 different active models. They are:

    atmosphere, ocean, sea-ice, land surface, river, glacier, wave

    An external system processing (ESP) stub-only component is also allowed.

    -

    For some climate problems, it is necessary to reduce feedbacks within the system by replacing an active model with a +

    data models: For some climate problems, it is necessary to reduce feedbacks within the system by replacing an active model with a version that sends and receives the same variables to and from other models, but with the values read from files rather than computed from the equations. The values received are ignored. These active-model substitutes are called data models. CIME provides data models for each of the supported components.

    -

    For some configurations, no data model is needed, so CIME provides stub versions that simply occupy the +

    stub models: For some configurations, no data model is needed, so CIME provides stub versions that simply occupy the required place in the climate execution sequence and do not send or receive any data.

    case:
    @@ -157,7 +160,7 @@

    1.2. Terms and concepts1.3. Setting defaults

    Before using any CIME commands, set the CIME_MODEL environment variable. In csh, use setenv as shown and replace <model> with the appropriate text, such as “acme” or “cesm.”

    -
    setenv CIME_MODEL <model>
    +
    > setenv CIME_MODEL <model>
     
    @@ -285,14 +288,14 @@

    1.4. Directory content

    1.5. Discovering available cases

    -

    To identify which compsets, grids and machines your CIME-enabled model supports, use the query_config command found in cime/scripts. Use the —help option for more information.

    +

    To identify which compsets, grids and machines your CIME-enabled model supports, use the query_config command found in cime/scripts. See the help text for more information.

    > ./query_config --help
     

    1.6. Quick start

    -

    To quickly see how a case is created, configured, built and run with CIME, execute the following commands for an example. (This assumes that CIME has been ported to your current machine).

    +

    To see an example of how a case is created, configured, built and run with CIME, execute the following commands for an example. (This assumes that CIME has been ported to your current machine).

    > cd cime/scripts
     > ./create_newcase --case mycase --compset X --res f19_g16
     > cd mycase
    @@ -302,11 +305,11 @@ 

    1.6. Quick start
    > tail CaseStatus
     

    -

    Repeat the command until you see the message “case.run success”

    +

    Repeat the command until you see the message case.run success.

    diff --git a/users_guide/running-a-case.html b/users_guide/running-a-case.html index 7bb1671e33a..f4f893bde9f 100644 --- a/users_guide/running-a-case.html +++ b/users_guide/running-a-case.html @@ -119,16 +119,14 @@

    Quick search

    6.1. Calling case.submit

    Before you submit the case using case.submit, make sure the batch queue variables are set correctly for your run -targeted. The batch submissions variables are contained in the file -$CASEROOT/env_batch.xml under the XML <group id="case.run"> -and <group id="case.st_archive"> elements. Make sure that you -have appropriate account numbers (PROJECT), time limits -(JOB_WALLCLOCK_TIME), and queue (JOB_QUEUE) for those groups..

    -

    Also modify $CASEROOT/env_run.xml for your -case using xmlchange.

    -

    Once you have run case.setup and case.build, run -case.submit to submit the run to your machine’s batch queue -system.

    +Those variables are contained in the file $CASEROOT/env_batch.xml +under the XML <group id="case.run"> and <group id="case.st_archive"> +elements.

    +

    Make sure that you have appropriate account numbers (PROJECT), time limits +(JOB_WALLCLOCK_TIME), and queue (JOB_QUEUE) for those groups.

    +

    Also modify $CASEROOT/env_run.xml for your case using xmlchange.

    +

    Once you have executed case.setup and case.build, run case.submit +to submit the run to your machine’s batch queue system.

    > cd $CASEROOT
     > ./case.submit
     
    @@ -139,10 +137,10 @@

    6.1.1. Result of running case.submit
  • Load the necessary environment.
  • Confirm that locked files are consistent with the current xml files.
  • -
  • Run preview_namelist, which in turn will run each component’s buildnml
  • -
  • Run **check_input_data** to verify that the required -data is present.
  • -
  • Submit the job to the batch queue. which in turn will run the script case.run.
  • +
  • Run preview_namelist, which in turn will run each component’s buildnml.
  • +
  • Run check_input_data to verify that the required +data are present.
  • +
  • Submit the job to the batch queue. which in turn will run the case.run script.
  • Upon successful completion of the run, case.run will:

    Short-term archiving will copy and move component history, log, diagnostic, and restart files from $RUNDIR to the short-term -archive directory, $DOUT_S_ROOT.

    +archive directory $DOUT_S_ROOT.

    6.1.2. Monitoring case job statuses

    The $CASEROOT/CaseStatus file contains a log of all the job states -and xmlchange commands in chronological order. An example of status -messages includes:

    +and xmlchange commands in chronological order. Here is an example of status +messages:

    2017-02-14 15:29:50: case.setup starting
     ---------------------------------------------------
     2017-02-14 15:29:54: case.setup success
    @@ -184,8 +182,6 @@ 

    6.1.2. Monitoring case job statuses---------------------------------------------------

    -

    When the short-term archiver is done, data from $RUNDIR is in -subdirectories under $DOUT_S_ROOT.

    Note

    After a successful first run, set the env_run.xml variable @@ -202,12 +198,12 @@

    6.1.2. Monitoring case job statuses

    6.1.3. Troubleshooting a job that fails

    There are several places to look for information if a job fails. -Start with the STDOUT and STDERR file(s) in $CASEROOT. +Start with the STDOUT and STDERR file(s) in $CASEROOT. If you don’t find an obvious error message there, the $RUNDIR/$model.log.$datestamp files will probably give you a hint.

    -

    First check cpl.log.$datestamp, which will often tell you -when the model failed. Then check the rest of the component log +

    First, check cpl.log.$datestamp, which will often tell you +when the model failed. Then check the rest of the component log files. See troubleshooting run-time problems for more information.

    @@ -218,27 +214,26 @@

    6.1.3. Troubleshooting a job that fails$DIN_LOC_ROOT. It automatically downloads missing data.

    The required input data sets needed for each component are found in the -$CASEROOT/Buildconf directory in the files xxx.input_data_list, -where xxx is the component name. These files are generated by a call +$CASEROOT/Buildconf directory. These files are generated by a call to preview_namlists and are in turn created by each component’s buildnml script. For example, for compsets consisting only of data -models (that is, A compsets), the following files are created:

    +models (A compsets), the following files are created:

    datm.input_data_list
     dice.input_data_list
     docn.input_data_list
     drof.input_data_list
     
    -

    You can independently verify that the required data is present locally by +

    You can independently verify the presence of the required data by using the following commands:

    > cd $CASEROOT
    -> check_input_data -help
    -> check_input_data -inputdata $DIN_LOC_ROOT -check
    +> check_input_data --help
    +> check_input_data --inputdata $DIN_LOC_ROOT --check
     

    If data sets are missing, obtain them from the input data server:

    > cd $CASEROOT
    -> check_input_data -inputdata $DIN_LOC_ROOT -export
    +> check_input_data --inputdata $DIN_LOC_ROOT --export
     

    @@ -251,8 +246,20 @@

    6.1.3. Troubleshooting a job that fails$STOP_OPTION and $STOP_N. Other driver namelist settings then will have consistent and -reasonable default values. These default settings guarantee that +reasonable default values. The default settings guarantee that restart files are produced at the end of the model run.

    +

    By default, the stop time settings are:

    +
    STOP_OPTION = ndays
    +STOP_N = 5
    +STOP_DATE = -999
    +
    +
    +

    The default settings are appropriate only for initial testing. Before +starting a longer run, update the stop times based on the case +throughput and batch queue limits. For example, if the model runs 5 +model years/day, set RESUBMIT=30, STOP_OPTION= nyears, and STOP_N= +5. The model will then run in five-year increments and stop after +30 submissions.

    6.3.1. Run-type initialization

    The case initialization type is set using the $RUN_TYPE variable in @@ -298,8 +305,8 @@

    6.3.1. Run-type initializationhybrid
    A hybrid run is initialized like a startup but it uses initialization data sets from a previous case. It is similar -somewhat analogous to a branch run with relaxed restart -constraints. A hybrid run allows users to bring together +to a branch run with relaxed restart constraints. +A hybrid run allows users to bring together combinations of initial/restart files from a previous case (specified by $RUN_REFCASE) at a given model output date (specified by $RUN_REFDATE). Unlike a branch run, the starting @@ -323,25 +330,6 @@

    6.3.1. Run-type initialization$RUN_REFCASE and $RUN_REFDATE. All run startup variables are discussed in `run start control variables<http://www.cesm.ucar.edu/models/cesm2.0/external-link-here>`_.

    -

    A brief note on restarting runs

    -

    When you first begin a branch, hybrid or startup run, CONTINUE_RUN -must be set to FALSE. After the job has run successfully and -there are restart files, you will need to change CONTINUE_RUN to -TRUE for the remainder of your run. Setting the RESUBMIT option to -a value > 0 will cause the CONTINUE_RUN variable to be set to TRUE -automatically upon completion of the initial run.

    -

    By default, the stop time settings are:

    -
    STOP_OPTION = ndays
    -STOP_N = 5
    -STOP_DATE = -999
    -
    -
    -

    The default settings are appropriate only for initial testing. Before -starting a longer run, update the stop times based on the case -throughput and batch queue limits. For example, if the model runs 5 -model years/day, set RESUBMIT=30, STOP_OPTION= nyears, and STOP_N= -5. The model will then run in five-year increments, and stop after -30 submissions.

    @@ -349,27 +337,27 @@

    6.3.1. Run-type initialization$RUNDIR to a local disk area (short-term archiving). It has no impact on the production run except to clean up disk space in the $RUNDIR and help manage user quotas.

    -

    In env_run.xml, several variables control the behavior of +

    Several variables in env_run.xml control the behavior of short-term archiving. This is an example of how to control the data output flow with two variable settings:

    DOUT_S = TRUE
     DOUT_S_ROOT = /$SCRATCH/$user/$CASE/archive
     
    -

    Key points to keep in mind about short-term archiving:

    +

    The first setting above is the default, so short-term archiving is enabled. The second sets where to move files at the end of a successful run.

    +

    Also:

      -
    • Short-term archiving is enabled by default ($DOUT_S = TRUE).
    • All output data is initially written to $RUNDIR.
    • -
    • Unless a user explicitly turns off short-term archiving, files will -be moved to $DOUT_S_ROOT at the end of a successful model run.
    • +
    • Unless you explicitly turn off short-term archiving, files are +moved to $DOUT_S_ROOT at the end of a successful model run.
    • Users generally should turn off short-term archiving when developing new code.

    Standard output generated from each component is saved in $RUNDIR @@ -400,24 +388,21 @@

    6.3.1. Run-type initialization

    6.5. Restarting a run

    -

    Each active component (and some data components) write restart files +

    Active components (and some data components) write restart files at intervals that are dictated by the driver via the setting of the $REST_OPTION and $REST_N variables in env_run.xml. Restart files allow the model to stop and then start again with bit-for-bit exact capability; the model output is exactly the same as if the model -had not stopped). The driver coordinates the writing of restart -files as well as the time evolution of the model. All components -receive restart and stop information from the driver and write -restarts or stop as the drives specifies.

    -

    Keep in mind that runs initialized as branch or hybrid runs, require +had not stopped. The driver coordinates the writing of restart +files as well as the time evolution of the model.

    +

    Runs that are initialized as branch or hybrid runs require restart/initial files from previous model runs (as specified by the -variables $RUN_REFCASE and $RUN_REFDATE). The user must pre-stage -these required files to the case $RUNDIR (normally $EXEROOT/run) +variables $RUN_REFCASE and $RUN_REFDATE). Pre-stage these +iles to the case $RUNDIR (normally $EXEROOT/run) before the model run starts. Normally this is done by copying the contents of the relevant $RUN_REFCASE/rest/$RUN_REFDATE.00000 directory.

    Whenever a component writes a restart file, it also writes a restart -pointer file in the format rpointer.$component. The pointer -file contains the name of that new restart file. Upon a restart, each +pointer file in the format rpointer.$component. Upon a restart, each component reads the pointer file to determine which file to read in order to continue the run. These are examples of pointer files created for a component set using full active model components.

    @@ -441,13 +426,13 @@

    6.5.1. Backing up to a previous restart$RUNDIR).

    -

    Make sure that the new rpointer.* files overwrite older files in -in $RUNDIR, or the job may not restart in the correct place.

    -

    You can then continue the run using the new restarts.

    +

    Make sure that the new restart pointer files overwrite older files in +in $RUNDIR or the job may not restart in the correct place. You can +then continue the run using the new restarts.

    Occasionally, when a run has problems restarting, it is because the -rpointer.* and restart files are out of sync. The rpointer.* files -are text files that can easily be edited to match the correct dates -of the restart and history files. All the restart files should +pointer and restart files are out of sync. The pointer files +are text files that can be edited to match the correct dates +of the restart and history files. All of the restart files should have the same date.

    @@ -458,8 +443,7 @@

    6.6. Archiving model output data$RUNDIR directory.

    The output data flow from a successful run depends on whether or not -short-term archiving is enabled, as it is by default. (The env_run.xml -variable $DOUT_S is set as DOUT_S=TRUE.

    +short-term archiving is enabled, as it is by default.

    6.6.1. No archiving

    If no short-term archiving is performed, model output data remains diff --git a/users_guide/setting-up-a-case.html b/users_guide/setting-up-a-case.html index b82e6c1a479..ede74dfa2e2 100644 --- a/users_guide/setting-up-a-case.html +++ b/users_guide/setting-up-a-case.html @@ -96,8 +96,7 @@

    Quick search

    4. Setting up a Case

    4.1. Calling case.setup

    -

    After creating a case or changing aspects of a case, such as the pe-layout, call the case.setup command from $CASEROOT This creates additional files and directories in $CASEROOT. They are described below.

    -

    To see the options that are available with case.setup, use the —help. option.

    +

    After creating a case or changing aspects of a case, such as the pe-layout, call the case.setup command from $CASEROOT. This creates additional files and directories in $CASEROOT. They are described below.

    @@ -106,29 +105,27 @@

    4.1. Calling case.setup

    - + - diff --git a/users_guide/troubleshooting.html b/users_guide/troubleshooting.html index aeb33ed6c61..19fd5b06725 100644 --- a/users_guide/troubleshooting.html +++ b/users_guide/troubleshooting.html @@ -100,7 +100,7 @@

    Quick search

    9.1. Troubleshooting case creation

    Generally, create_newcase errors are reported to the terminal and should provide some guidance about what caused them.

    If create_newcase fails on a relatively generic error, first check to make sure the command-line arguments match the interface’s specification. See the help text to review usage.

    -
    create_newcase --help
    +
    > create_newcase --help
     
    @@ -117,7 +117,7 @@

    9.2. Troubleshooting job submission

    9.3. Troubleshooting runtime problems

    To see if a run completed successfully, check the last several lines of the cpl.log file for a string like SUCCESSFUL TERMINATION. A successful job also usually copies the log files to the $CASEROOT/logs directory.

    -

    Note: The first things to check when a job fails:

    +

    Check these things first when a job fails:

    Common errors

    One common error is for a job to time out, which often produces minimal error messages. @@ -147,7 +146,7 @@

    9.3. Troubleshooting runtime problemstStamp as shown here:

    -
    grep tStamp cpl.log.* | more
    +
    > grep tStamp cpl.log.* | more
     

    The output looks like this:

    @@ -167,7 +166,7 @@

    9.3. Troubleshooting runtime problemsrestarting a run.

    +See Restarting a run.

    It is not uncommon for nodes to fail on HPC systems or for access to large file systems to hang. Before you file a bug report, make sure a case fails consistently in the same place.

    case.run

    Run script containing the batch directives

    -

    The batch directives are generated using the contents of env_mach_pes.xml. -Calling case.setup –clean will remove this file.

    -
    Run script containing the batch directives. The directives are generated using the contents +of env_mach_pes.xml. Running case.setup --clean will remove this file.
    Macros.make

    File containing machine-specific makefile directives for your target platform/compiler.

    -

    This file is created if it does not already exist.

    -

    The user can modify this file to change certain aspects of the build, such as compiler flags.

    -

    Calling case.setup –clean will not remove the file once it has been created. -However. if you remove or rename the Macros.make file, case.setup will recreate it.

    +

    File containing machine-specific makefile directives for your target platform/compiler. +This file is created if it does not already exist.

    +

    The user can modify the file to change certain aspects of the build, such as compiler flags. +Running case.setup --clean will not remove the file once it has been created. +However. if you remove or rename the Macros.make file, running case.setup recreates it.

    user_nl_xxx[_NNNN] files

    Files where all user modifications to component namelists are made.

    xxx is any one of the set of components targeted for the case. -For example, for a full active CESM compset, xxx would be cam, clm, rtm, and so on.

    +For example, for a full active CESM compset, xxx is cam, clm or rtm, and so on.

    NNNN goes from 0001 to the number of instances of that component. (See multiple instances)

    For a case with 1 instance of each component (default), NNNN will not appear in the user_nl file names.

    -

    A user_nl file of a given name will only be created once.

    -

    Calling case.setup –clean will not remove any user_nl files.

    +

    A user_nl file of a given name is created only once.

    +

    Calling case.setup --clean will not remove any user_nl files.

    Changing the number of instances in the env_mach_pes.xml file will cause only new user_nl files to be added to $CASEROOT.