Running the GEOS-5 SBU Benchmark: Difference between revisions

Line 111:

===Setting up an experiment===

Go into the model application directory and ~~run the setup script~~:

Go into the model application directory and do a couple of preliminary commands:

$ cd $ESMADIR/src/Applications/GEOSgcm_App

$ ./~~gcm_setup~~

$ echo $NOBACKUP > ~/.HOMDIRroot

$ echo $NOBACKUP > ~/.EXPDIRroot

~~and provide required answers~~.

These echos set up some defaults. While they both don't have to be in the same location, it's highly recommended they are. Also, make sure they are in a nobackup directory.

~~'''''MAT~~: ~~Add~~ a ~~sample~~ run ~~here'''''~~

Now you can run <tt>create_expt.py</tt>:

<nowiki>$ ~mathomp4/bin/create_exp.py -h

usage: create_expt.py [-h] [-v] [-q] [--expdsc EXPDSC]

[--horz {a,b,c,d,e,c12,c24,c48,c90,c180,c360,c720,c1440,c2880}]

[--vert {72,132}] [--ocean {o1,o2,o3}] [--land {1,2}]

[--runoff {yes,no}] [--gocart {A,C}]

[--emission {MERRA2,PIESA,CMIP,NR,MERRA2-DD,OPS}]

[--history HISTORY] [--account ACCOUNT] [--gpu]

expid

Utility to quickly create experiment. At present, it creates an experiment in

the same manner as gcm_setup would with home and experiment directories as

usual.

positional arguments:

expid Experiment ID

optional arguments:

-h, --help show this help message and exit

-v, --verbose Verbose output

-q, --quiet Quietly Setup Experiment (no printing)

--expdsc EXPDSC Experiment Description (Default: same as expid)

--horz {a,b,c,d,e,c12,c24,c48,c90,c180,c360,c720,c1440,c2880}

Horizontal Resolution (Default: c48 on clusters, c12

on desktop)

--vert {72,132} Vertical Resolution (Default: 72)

--ocean {o1,o2,o3} Data Ocean Resolution (Default: o1)

--land {1,2} Land Surface Model (Default: 1)

--runoff {yes,no} Runoff Routing Model (Default: no)

--gocart {A,C} GOCART aerosols: Actual (A) or Climatological (C)

(Default: A on clusters, C on desktops)

--emission {MERRA2,PIESA,CMIP,NR,MERRA2-DD,OPS}

GOCART Emissions to use (Default: MERRA2)

--history HISTORY History Template (Default: Current)

--account ACCOUNT Account Number to Use (Default: g0620 at NCCS, g26141

at NAS)

--gpu Setup Experiment to use GPUs</nowiki>

This is a script that attempts to ease setting up a GEOS-5 AGCM run. It has some "smarts" in that it will detect from an experiment ID some information, but you can be explicit (to the point you can specify impossible experiments too).

===Run a one-day test===

@@ Line 111: / Line 111: @@
 ===Setting up an experiment===
-Go into the model application directory and run the setup script:
+Go into the model application directory and do a couple of preliminary commands:
   $ cd $ESMADIR/src/Applications/GEOSgcm_App
-  $ ./gcm_setup
+  $ echo $NOBACKUP > ~/.HOMDIRroot
+ $ echo $NOBACKUP > ~/.EXPDIRroot
-and provide required answers.
+These echos set up some defaults. While they both don't have to be in the same location, it's highly recommended they are. Also, make sure they are in a nobackup directory.
-'''''MAT: Add a sample run here'''''
+Now you can run <tt>create_expt.py</tt>:
+ <nowiki>$ ~mathomp4/bin/create_exp.py -h
+usage: create_expt.py [-h] [-v] [-q] [--expdsc EXPDSC]
+                      [--horz {a,b,c,d,e,c12,c24,c48,c90,c180,c360,c720,c1440,c2880}]
+                      [--vert {72,132}] [--ocean {o1,o2,o3}] [--land {1,2}]
+                      [--runoff {yes,no}] [--gocart {A,C}]
+                      [--emission {MERRA2,PIESA,CMIP,NR,MERRA2-DD,OPS}]
+                      [--history HISTORY] [--account ACCOUNT] [--gpu]
+                      expid
+Utility to quickly create experiment. At present, it creates an experiment in
+the same manner as gcm_setup would with home and experiment directories as
+usual.
+positional arguments:
+  expid                 Experiment ID
+optional arguments:
+  -h, --help            show this help message and exit
+  -v, --verbose         Verbose output
+  -q, --quiet           Quietly Setup Experiment (no printing)
+  --expdsc EXPDSC       Experiment Description (Default: same as expid)
+  --horz {a,b,c,d,e,c12,c24,c48,c90,c180,c360,c720,c1440,c2880}
+                        Horizontal Resolution (Default: c48 on clusters, c12
+                        on desktop)
+  --vert {72,132}       Vertical Resolution (Default: 72)
+  --ocean {o1,o2,o3}    Data Ocean Resolution (Default: o1)
+  --land {1,2}          Land Surface Model (Default: 1)
+  --runoff {yes,no}     Runoff Routing Model (Default: no)
+  --gocart {A,C}        GOCART aerosols: Actual (A) or Climatological (C)
+                        (Default: A on clusters, C on desktops)
+  --emission {MERRA2,PIESA,CMIP,NR,MERRA2-DD,OPS}
+                        GOCART Emissions to use (Default: MERRA2)
+  --history HISTORY     History Template (Default: Current)
+  --account ACCOUNT     Account Number to Use (Default: g0620 at NCCS, g26141
+                        at NAS)
+  --gpu                 Setup Experiment to use GPUs</nowiki>
+This is a script that attempts to ease setting up a GEOS-5 AGCM run. It has some "smarts" in that it will detect from an experiment ID some information, but you can be explicit (to the point you can specify impossible experiments too).
 ===Run a one-day test===