create_cloneΒΆ
create_clone is a script in CIMEROOT/scripts.
$ ./create_clone --help
usage: create_clone [-h] [-d] [-v] [-s] --case CASE --clone CLONE
[--ensemble ENSEMBLE] [--user-mods-dir USER_MODS_DIR]
[--keepexe] [--mach-dir MACH_DIR] [--project PROJECT]
[--cime-output-root CIME_OUTPUT_ROOT]
optional arguments:
-h, --help show this help message and exit
-d, --debug Print debug information (very verbose) to file /glade/work/turuncu/APPS/ufs-mrweather-app/cime/scripts/create_clone.log
-v, --verbose Add additional context (time and file) to log messages
-s, --silent Print only warnings and error messages
--case CASE, -case CASE
(required) Specify a new case name. If not a full pathname,
the new case will be created under then current working directory.
--clone CLONE, -clone CLONE
(required) Specify a case to be cloned. If not a full pathname,
the case to be cloned is assumed to be under then current working directory.
--ensemble ENSEMBLE clone an ensemble of cases, the case name argument must end in an integer.
for example: ./create_clone --clone case.template --case case.001 --ensemble 4
will create case.001, case.002, case.003, case.004 from existing case.template
--user-mods-dir USER_MODS_DIR
Full pathname to a directory containing any combination of user_nl_* files
and shell_commands script (typically containing xmlchange commands).
The directory can also contain an SourceMods/ directory with the same structure
as would be found in a case directory. If this argument is used in conjunction
with the --keepexe flag, then no changes will be permitted to the env_build.xml
in the newly created case directory.
--keepexe, -keepexe Sets EXEROOT to point to original build. It is HIGHLY recommended
that the original case be built BEFORE cloning it if the --keepexe flag is specfied.
This flag will make the SourceMods/ directory in the newly created case directory a
symbolic link to the SourceMods/ directory in the original case directory.
--mach-dir MACH_DIR, -mach_dir MACH_DIR
Specify the locations of the Machines directory, other than the default.
The default is CIMEROOT/machines.
--project PROJECT, -project PROJECT
Specify a project id for the case (optional).
Used for accounting and directory permissions when on a batch system.
The default is user or machine specified by PROJECT.
Accounting (only) may be overridden by user or machine specified CHARGE_ACCOUNT.
--cime-output-root CIME_OUTPUT_ROOT
Specify the root output directory. The default is the setting in the original
case directory. NOTE: create_clone will fail if this directory is not writable.