ANALOG: A program for estimating paleoclimate parameters
using the method of modern analogs

U.S. Geological Survey Open-File Report 94-645

by Peter Schweitzer (U.S. Geological Survey, Reston, VA 22092)

This directory contains source and executable code, data, and
documentation for ANALOG, a program to estimate paleoclimate
parameters using the method of modern analogs.

The program runs on (32-bit) MS-DOS, Macintosh, and UNIX systems.

Major directories here are:

    bin       Executable programs
    data      Example data, including some useful modern data bases
    doc       Documentation
    src       Source code
    archives  Compressed archive files containing the data set
                Choose analog.zip if you run MS-DOS
                Choose analog.sea.hqx if you run a Macintosh
                Choose analog.tar.Z if you run UNIX

Documentation for WWW browsers can be obtained through the URL

    http://geochange.er.usgs.gov/pub/tools/analog/doc/analog.html

---------------

How to use the program:

MS-DOS systems:

    You must have a PC with a 32-bit processor (80386, 486, or Pentium)
    and at least 2 megabytes of extended memory (that's 2MB in addition to
    the lower 640k).

    ANALOG is a 32-bit program built with the WATCOM C/C++32 compiler, to
    run under the DOS extender DOS/4G by Rational Systems, Inc.  An
    adequate version of DOS/4G is available with ANALOG, customized to run
    with products created using the WATCOM development system.  This means

    >>  You need both ANALOG.EXE and DOS4GW.EXE to run under MS-DOS.

    All you need to do with DOS4GW.EXE is put it somewhere along your
    PATH, so DOS can find it when ANALOG.EXE wants to load it.

    Compose the run description file and the transformation files as
    described in the documentation (doc/analog.ps is a PostScript
    version), then invoke the program at the command line, specifying only
    the name of the run description file:

        C:>ANALOG RUN_DESC

    If you specified "verbose", you will probably want to redirect the
    console output to a file (otherwise it will scroll off the screen very
    fast and you won't see it):

        C:>ANALOG RUN_DESC >OUT

    Examine the file OUT, looking for the words "Error" and "Warning".
    These messages typically indicate that something fishy is going on,
    and you will be better off knowing what it is before interpreting your
    results.

Macintosh systems:

    You must be running System 7, and there must be about 2 megabytes of
    memory available in addition to the amount the system uses.

    Compose the run description file and the transformation files as
    described in the documentation (doc/analog.ps is a PostScript
    version), then invoke the program by double-clicking its icon.  You
    are presented with a command line dialog box with an editable text
    field containing the name of the program.  Don't delete it.  Type the
    name of the run description file after the program name (make sure
    that a space separates the two).  Then click OK.

    If you specified "verbose", you will probably want to redirect the
    console output to a file (otherwise it will scroll out of the window
    very fast and you won't see it).  Before you click OK, click the radio
    button marked "File" (or the one marked "Console + File") under
    "Standard Output".  You'll get a standard create file dialog.  Give it
    the name of a new file.  You probably won't want to use the name that
    you specified in the report section of your run description file,
    because it will then mix your results with the verbose progress
    information.  After dismissing the file dialog, you're back at the
    command line dialog.  Click OK to start.

    ANALOG takes a while to run, especially if you're using large data
    bases (the CLIMAP core top data base has 1145 entries; the NAPD modern
    data base has 1700 entries).  The program is only marginally Macintosh-
    aware, so it does not yield control of the system while it is
    running.  In any event, it should be done within a few minutes.

    Examine the file you directed the output to, looking for the words
    "Error" and "Warning".  These messages typically indicate that
    something fishy is going on, and you will be better off knowing what
    it is before interpreting your results.

UNIX systems:

    You must have an ANSI-conformant C compiler.  Move to the src
    directory, edit the Makefile so that your C compiler will be used,
    then run "make".  Assuming the program could be compiled and linked,
    operation is essentially the same as for MS-DOS users.

    Compose the run description file and the transformation files as
    described in the documentation (doc/analog.ps is a PostScript
    version), then invoke the program at the command line, specifying only
    the name of the run description file:

        $ analog run_description

    If you specified "verbose", you will probably want to redirect the
    standard output to a file (otherwise it will scroll off the screen
    very fast and you won't see it):

        $ analog run_description >out

    Examine the file out, looking for the words "Error" and "Warning".
    These messages typically indicate that something fishy is going on,
    and you will be better off knowing what it is before interpreting your
    results.

---------------

Contact information for the author:

    Peter N. Schweitzer
    Mail Stop 955, National Center
    U.S. Geological Survey
    Reston, VA 22092

    Tel: (703) 648-6533
    FAX: (703) 648-6647
    email: pschweitzer@usgs.gov
    http://geochange.er.usgs.gov/

(end)
