Changes between Initial Version and Version 1 of SwiftWork/SwiftAtm/GeneralInstructions

Show
Ignore:
Timestamp:
03/08/12 13:01:55 (6 years ago)
Author:
jacob
Comment:

add README-swift

Legend:

Unmodified
Added
Removed
Modified
  • SwiftWork/SwiftAtm/GeneralInstructions

    v1 v1  
     1(this is the text from the README-swift file included in the distribution) 
     2 
     3== Installation == 
     4 
     51. Follow the instructions for installing the regular AMWG package. 
     6 
     7(In short, you will need installations of NCL, NCO and the "convert" tool from ImageMagick) 
     8 
     92. You will also need the Swift executable ( http://www.ci.uchicago.edu/swift/wwwdev/downloads/index.php ) which requires a current version of Java. 
     10 
     11 
     12== Configuration == 
     13 
     141.  Create a run directory.  Then from this directory create a directory named swift. 
     15 
     162.  Copy diag120131.csh to the run directory and edit to run the comparison you'd like to do. 
     17 
     183.  To turn the swift option on, set use_swift to 0 in the top level diag script. 
     19 
     204.  You will also have to set swift_scratch_dir in the top level diag script and make sure this directory exists prior to running the package.  This directory will store all of the Swift specific files that are created.  This directory can grow quite large. 
     21 
     225.  Copy swift/amwg_stats.swift to the swift directory you created. 
     23 
     246.  Modify/create the 4 swift configuration files listed below. These need to be placed in your run directory.   Examples can be found in swift/conf/: 
     25 
     26fs.data: (cdm file)  
     27 
     28cf.properties: (config file)  
     29 
     30sites.xml: (sites file) Edit the "workdirectory"  
     31(for more information, see  http://www.ci.uchicago.edu/swift/guides/release-0.92/userguide/sitecatalog.php).  
     32This file is set up to run on a local machine without a queue. 
     33 
     34tc.data: (tc file) This file lists all of the executables that the package will use. You will need to change the locations to point to where they are located on your machine. Append_ncks.csh, dummy_file.csh, plot_paleo.csh, and run_ncl.csh are located in the swift/utils/ directory.  
     35 
     36 
     37== Running == 
     38 
     39Run this version from the command line just like the original package (./diag*.csh). You also need to edit diag*.csh 
     40(just like the original) to point to your data, etc. 
     41 
     42Most error messages can be found in the last several lines of $swift_scratch_dir/amwg_stats-*.log.