NCL-Teaching

Category

Other

Program On

Teaching

Version

6.4.0, 6.5.0

Author / Distributor

Please see https://www.ncl.ucar.edu/

When citing NCL, please use the following: The NCAR Command Language (Version 6.5.0) [Software]. (2018). Boulder, Colorado: UCAR/NCAR/CISL/TDD. http://dx.doi.org/10.5065/D6WD3XH5"

Description

From https://www.ncl.ucar.edu/: "NCL is an interpreted language designed specifically for scientific data analysis and visualization."

Running Program

Also refer to Running Jobs on Sapelo2

For more information on Environment Modules on Sapelo2 please see the Lmod page.

• Version 6.4.0, installed in /usr/local/apps/eb/NCL/6.4.0-foss-2016b
• Version 6.5.0, installed in /usr/local/apps/eb/NCL/6.5.0-foss-2018a

To use version 6.4.0, please first load the module with

module load NCL/6.4.0-foss-2016b

To use version 6.5.0, please first load the module with

module load NCL/6.5.0-foss-2018a

Sample job submission script (sub.sh) to run version 6.5.0 ncl in a batch job:

#!/bin/bash
#SBATCH --job-name=j_NCL
#SBATCH --partition=batch
#SBATCH --ntasks=1
#SBATCH --mem=2gb
#SBATCH --time=04:00:00
#SBATCH --output=NCL.%j.out
#SBATCH --error=NCL.%j.err

#SBATCH --mail-user=username@uga.edu
#SBATCH --mail-type=END,FAIL

cd $SLURM_SUBMIT_DIR
module load NCL/6.5.0-foss-2018a
ncl [options]

where [options] are ncl options and arguments you want to use. Other parameters of the job, such as the maximum wall clock time, maximum memory, and the job name need to be modified appropriately as well.

Submit the job to the queue with

qsub sub.sh

Documentation

Please see http://www.ncl.ucar.edu/Document/

Examples are available at http://www.ncl.ucar.edu/Applications/

module load NCL/6.5.0-foss-2018a
ncl -h

Usage: ncl -fhnopxsPQV <args> <file.ncl>
	 -f: use new file structure and NetCDF4 features when possible
	 -h: print this message and exit
	 -n: don't enumerate values in print()
	 -o: retain former behavior for certain backwards-incompatible changes
	 -p: don't page output from the system() command
	 -x: echo NCL commands
	 -s: disable pre-loading of default script files
	 -P: enable NCL profiler
	 -Q: turn off echo of NCL version and copyright info
	 -V: print NCL version and exit

Installation

• Version 6.4.0, 6.5.0 pre-compiled binary codes downloaded from http://www.ncl.ucar.edu/Download/install_from_binary.shtml

System

64-bit Linux