========================================================================== 
    arts++ library
========================================================================== 

    To compliet sk_analysis_dump you need to download the arts++ 
    library.
        download:    /tools/utilities/arts/download/
        online docs: /tools/utilities/arts/

========================================================================== 
    building
========================================================================== 

    To build sk_analysis_dump, do:

	./configure [options]
	make

    ./configure takes the following options in addition to the standard 
    options:

	--with-arts=DIR     use Arts in DIR (default: /usr/local/arts)
	--with-geode=DIR    use Geode in DIR (default: /usr/local/geode)
	--with-coral=DIR    use CoralReef in DIR (default: /usr/local/Coral)
	--with-netacuity=DIR    use Netacuity in DIR (default: netacuity_api)

    There have been compilation problems with the arts++ on Linux's gcc
    2.95.4.  Thye error messages look like:
	Error: invalid character (0xffffff9b) in mnemonic

    By turning off optimization this could be avoided.  When running
    arts++ configure command do:
	env CXXFLAGS="-Wall -Wpointer-arith -Wstrict-prototypes \
	-Wmissing-prototypes -Wwrite-strings -Winline" ./configure

========================================================================== 
    list of files
========================================================================== 

   sk_analysis_dump.cc
	Sample C++ code that processes the skitter traces stored in the 
	binary ArtsIpPathData format one at a time and prints the results
	to the standard output. The output format is described below.

    zfstream.cc
	Written by Kevin Ruland <kevin@rodin.wustl.edu>
	Part of the zlib distribution.  Wrapper for C++.

    Makefile
	Sample Makefile which includes all the dependencies.

    OUTPUT
	Outline of the output of sk_analysis_dump.

    README
	This file.

    libsea/skitter2walrus.pl
	This program reads the text output of sk_analysis_dump and
	produces a libsea walrus graph.
	see:/tools/visualization/walrus/
    
    libsea/Heap.pm
	Support class used by skitter2walrus.pl to handle a Heap.
    
    libsea/LibSeaGraphWriter.pl
	Code for createing a libsea graph.

========================================================================== 
    sample usage
========================================================================== 


./sk_analysis_dump datafile
---------------------------
	Default

cat datafile | ./sk_analysis_dump
---------------------------
	Reads the file from STDIN

./sk_analysis_dump -h
---------------------
	Prints options accepted by sk_analysis_dump

./sk_analysis_dump -G geode_server_name datafile
------------------------------------------------
	Geographical information is added to the default output.
	
./sk_analysis_dump datafile | ./skitter2walrus.pl > walrusfile
---------------------------------------------------------------
	This processes the data from datafile into a walrus file.