Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Expand
titleExercise 1 instructions
  • copy the template.mpas_analysis_short.cfg into a new file my_exercise1.cfg. Open it with your editor of choice.

The config file is split into different sections defined by section title denoted by [] (such as [run] or [execute]).

  • specify your own output directory:

update [output]/baseDirectory to your own directory /pscratch/sd/<first-letter-of-moniker>/<moniker>/e3sm2024tutorial/mpas-analysis/exercise1

and htmlSubdirectory to /global/cfs/cdirs/ntrain6/www/<moniker>/e3sm2024tutorial/exercise1

  • read the [generate] line. This line specifies the analysis tasks that will be performed.

  • read the date ranges (defined by startYear and endYear). Note that these appear twice, once in a section under [climatology]and once under [timeSeries].

  • make sure you save your changes.

Q1.a. Describe in your own words the tasks and plots you expect this script to produce.

  • open job_script_template.slurm

  • read and check the #SBATCH options at the top of the file. Key options for today are --account=ntrain6, --reservation=e3sm_day2, --time=00:10:00.

  • modify the mpas-analysis command to point to your my_exercise1.cfg (replacing template.mpas_analysis_short.cfg)

  • in the directory, run the following command: Note the job ID generated

Code Block
sbatch job_script_template.slurm

You can check the job status by running:

Code Block
squeue -u $USER

The analysis script should take approx. 2min to run once it starts. It may spend longer in the queue before starting. (If queue wait times are long, we can switch to the debug queue)

Code Block
cd $CFS/ntrain6/www/<moniker>/ 
chmod -R o+rx e3sm2024tutorial

Q1.b. How would you know that the job is done? how would you know if it was done successfully?

  • open the html directory in your favorite browser: https://portal.nersc.gov/cfs/ntrain6/www/<moniker>/e3sm2024tutorial/exercise1

Option 1: if the page does not exist, or is empty, double-check that the html path is consistent with your config file, then proceed to the Troubleshooting section.

Option 2: if the page exists and the plots are present, congratulations! Navigate the available plots and answer the following questions.

Q2.a. Navigate the available plots (you can click on plots). Note which plots are available and compare to your answer to Q1.a. Is there anything that you had not anticipated?

Q2.b. Summarize the key features that you notice (either positive or negative) in the ocean and sea ice analysis plots produced. Make sure to take note of the plots axis labels, title and legend.

Q2.c. Pick one concerning feature you noted in Q2.b. How would you go about determining whether this signal is significant? How would you go about determining whether this feature is new?

...