| CESM User's Guide (CESM1.2 Release Series User's Guide) (PDF) | ||
|---|---|---|
| Prev | Chapter 2. Creating and Setting Up A Case | Next |
This is an advanced feature provided for expert users. If you are a new user, skip this section.
If you have access to the run you want to clone, the
create_clone command will create a new case while also preserving
local modifications to the case that you want to clone. You can run the
utility create_clone either from $CCSMROOT or from the directory
where you want the new case to be created. It has the following
arguments:
-caseThe name or path of the new case.
-cloneThe full pathname of the case to be cloned.
-silentEnables silent mode. Only fatal messages will be issued.
-verboseEchoes all settings.
-helpPrints usage instructions.
Here is the simplest example of using create_clone:
> cd $ |
create_clone will preserve any local namelist modifications made in the user_nl_xxxx files as well as any source code modifications in the SourceMods tree. Note that the new case directory will be
identical to the cloned case directory
except for the original cloned scripts
$CASEROOT.$MACH.build, $CASEROOT.$MACH.clean_build,
$CASEROOT.$MACH.run, and $CASEROOT.$MACH.l_archive,
which will have new names in the new case.
Important:: Do not change anything in the env_case.xml file. The $
CASEROOT/ directory will now appear as if create_newcase had just been run -- with the exception that local modifications to the env_* files are preserved.
Another approach to duplicating a case is to use the information in that case's README.case file to create a new case. Note that this approach will not preserve any local modifications that were made to the original case, such as source-code or build-script modifications; you will need to import those changes manually.