ARPS mini tutorial for CFD 2001 class

Get ARPS tar package ftp://ftp.caps.ou.edu/pub/users/mxue/arps5.0.0Beta5.tar.gz.

Save it in Cray90 J90 scratch disk (/scratch/cfd##).

Do "gunzip arps5.0.0Beta5.tar.gz" to unzip the file, then "tar –xvf arps5.0.0Beta5.tar" to untar the package. Directory arps5.0.0Beta5 should have been created. This version is the latest version that has been used locally for quite a while. It remains as a beta version because of a few remaining problems having to do with MPI (distributed-memory parallel) and adaptive grid refinement (two-way interactive nesting).

For job that requires significant CPU time on Cray J90 (on the order of tens of minutes), you need to run the job in batch mode, using NQS queues. A sample NQS script is /home/mxue/nqs.cfdtest. The script has a few header lines specifying the memory and CPU time limits etc. The rest of the statements are simply statement you would otherwise issue from command line. When the NQS job starts, it assumes that you are in the home directory, therefore you need to cd to the right directory.

To submit the job, enter

qsub nqs.cfdtest

qstat –a shows the status of your job. qstat without any option shows the status of the job queues. ps –u user shows all active processes running under user.

If you have a reasonably fast workstation (e.g., a Pentium III or IV linux workstation), it might be faster to run your jobs there, interactively.

README file in arps directory has a brief instruction on running ARPS.

To use arpsplt, you need to add /usr/local/zxplot/bin into your command search path. You can simply copy /home/mxue/.cshrc into your home directory, and re-log in.

The home directory on Cray J90 has limited space (not sure how much – hopefully it's enough to keep the ARPS source code and executables). /scratch/cfd## is the workstation that you can use, but files there are deleted every two weeks or so. You either have to move the files to your own permanent storage or touch the files to keep them current.

You may try "cd /mnt/home/cfd##" (cfd## is your account name) to see if you can use the larger cross-mounted permanent home directory on bluesky, which is a front end of J90.