-------------------------------------------------------------------- -------------------------------------------------------------------- Howdy. Welcome to version one of Spherekit. We have done our best to design a simple installation process, and, in fact, it's pretty darn simple. There are two sections to this document: I. Basic Installation Following the steps below will install the SK binaries on your system. The basic installation takes up about 20 megs. II. D.E.M. Installation A few extra steps will also install a netCDF version of the National Geophysical Data Center's etopo5 set of topographic data, and enable SK to automatically extract the elevations of a given set of coordinates. The DEM file takes up about 37 megs. Section I. Basic Installation -------------------------------------------------------------------- -------------------------------------------------------------------- A) download the compressed SK tar file for your system. B) move the file to a directory just below where you would like to have it installed. C) type `gunzip SKv1.*.tar.gz' this (SURPRISE) uncompresses the tar file. gunzip can be found at http://www.pe.utexas.edu/Archive_Tools/archive.html D) type `tar -xvf SKv1.*.tar` to expand the file. E) cd to the SKv1 directory. F) type ./make_sk, this generates three files: SKv1..tcl - the main SK graphical user interface sk - a wrapper for the above test_sk - a program to test SK G) type ./test_sk. This program should lead you through a short (~10 minutes) test procedure. This requires that you have set your DISPLAY environment variable correctly. H) set your SK work directory. Whenever you create an object in Spherekit, you create a file. SK defaults to storing data in subdirectories off of your current directory. You can tell SK where to store this data by defining an environmental variable, by typing something like: `setenv SK_WORK_DIR /net/usr/richardNixon/SK` Having each Spherekit user place a line like this in their .cshrc file will make things run smoothly. I) Add the SK directory to each users path statement. Source your .cshrc file. Type `sk` to run Spherekit J) (optional) work through the tutorial provided in http://www.ncgia.ucsb.edu/pubs/spherekit/tutorial.html. -------------------------------------------------------------------- -------------------------------------------------------------------- If you have questions, contact Chris Funk at chris@geog.ucsb.edu -------------------------------------------------------------------- -------------------------------------------------------------------- Section I. D.E.M. Installation -------------------------------------------------------------------- -------------------------------------------------------------------- The DEM data file is the 5 minute NGDC etopo5, which we have converted to the platform-independent netcdf format. For more information, please see www.ngdc.noaa.gov/mgg/global/etopo5.HTML. Follow these steps to install the DEM data. A) Download the DEM data from the Spherekit website. B) Place the data where you'd like to keep it. (The same directory as the SK binaries is a likely choice). C) Uncompress the data. Type 'uncompress NGDC.DEM.nc.gz'. D) cd to the directory containing the main SK script - SKv1.tcl E) type './set_sk_demdir NODEM ', where is the fully specified pathname for the DEM data. That's it. If you have been successful, a 'Load D.E.M.' option should appear under the Import menu. If, at some later date, you would like to disable the DEM data, do this: A) cd to the directory containing the main SK script - SKv1.tcl B) type './set_sk_demdir NODEM' -------------------------------------------------------------------- -------------------------------------------------------------------- If you have questions, contact: chris@geog.ucsb.edu (Chris Funk) -------------------------------------------------------------------- --------------------------------------------------------------------