Heracles 4.3 Quick Start: Difference between revisions
Created page with "This page describes the minimum steps required to build and run GEOS-5 Heracles 4.0 on NCCS discover and NAS pleiades. '''You should successfully complete the steps in these..." |
|||
| (4 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
This page describes the minimum steps required to build and run GEOS-5 Heracles 4. | This page describes the minimum steps required to build and run GEOS-5 Heracles 4.3 on NCCS discover and NAS pleiades. '''You should successfully complete the steps in these instructions before doing anything more complicated. Also, it is helpful to read this page in its entirety before starting.''' | ||
'''Back to [[GEOS-5 Documentation for Heracles 4. | '''Back to [[GEOS-5 Documentation for Heracles 4.3]]''' | ||
== How to Obtain GEOS-5 and Compile Source Code == | == How to Obtain GEOS-5 and Compile Source Code == | ||
| Line 28: | Line 28: | ||
where ''USERID'' is, of course, your repository username, which should be the same as your NASA and NCCS username. Then, issue the command: | where ''USERID'' is, of course, your repository username, which should be the same as your NASA and NCCS username. Then, issue the command: | ||
cvs co -r Heracles- | cvs co -r Heracles-4_3 GEOSagcm | ||
This should check out the latest stable version of the model from the repository and create a directory called <code>GEOSagcm</code>. | This should check out the latest stable version of the model from the repository and create a directory called <code>GEOSagcm</code>. | ||
| Line 94: | Line 94: | ||
Spaces are ok here. It will then ask for the source code version tag to associate with the model -- you should hit enter for the default: | Spaces are ok here. It will then ask for the source code version tag to associate with the model -- you should hit enter for the default: | ||
Enter an Experiment Source Tag for History (Default: Heracles- | Enter an Experiment Source Tag for History (Default: Heracles-4_3): | ||
Hit enter for the default to the next question: | Hit enter for the default to the next question: | ||
| Line 189: | Line 189: | ||
The <code>umask 022</code> is not strictly necessary, but it will make the various files readable to others, which will facilitate data sharing and user support. Your home directory <code>~''USERID''</code> is also inaccessible to others by default; running <code>chmod 755 ~</code> is helpful. | The <code>umask 022</code> is not strictly necessary, but it will make the various files readable to others, which will facilitate data sharing and user support. Your home directory <code>~''USERID''</code> is also inaccessible to others by default; running <code>chmod 755 ~</code> is helpful. | ||
Copy the restart (initial condition) files and associated <code>cap_restart</code> into ''EXPDIR''. You can get an arbitrary set of restarts by copying the contents of the directory <code>/ | Copy the restart (initial condition) files and associated <code>cap_restart</code> into ''EXPDIR''. You can get an arbitrary set of restarts by copying the contents of the directory <code>/discover/nobackup/mathomp4/Restarts-H10/nc4/Reynolds/c48</code>, containing 2-degree cubed sphere restarts from April 14, 2000, and their corresponding <code>cap_restart</code>. | ||
The script you submit, <code>gcm_run.j</code>, is in ''HOMEDIR''. It should be ready to go as is. The parameter END_DATE in <code>CAP.rc</code> can be set to the date you want the run to stop. Submit the job with <code>sbatch gcm_run.j</code>. You can keep track of it with <code> | The script you submit, <code>gcm_run.j</code>, is in ''HOMEDIR''. It should be ready to go as is. The parameter END_DATE in <code>CAP.rc</code> can be set to the date you want the run to stop. Submit the job with <code>sbatch gcm_run.j</code>. You can keep track of it with <code>squeue</code> or <code>squeue -u ''USERID''</code>, or follow stdout with <code>tail -f ''EXPDIR''/slurm-''JOBID''.out</code>, ''JOBID'' being returned by <code>sbatch</code> and displayed with <code>squeue</code>. Jobs can be killed with <code>scancel ''JOBID''</code>. | ||
== Output and Plots == | == Output and Plots == | ||
| Line 211: | Line 211: | ||
---- | ---- | ||
'''Back to [[GEOS-5 Documentation for Heracles 4. | '''Back to [[GEOS-5 Documentation for Heracles 4.3]]''' | ||
Contact | Contact Matt Thompson at GMAO with questions and comments | ||