=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
    DENDROCHRONOLOGY PROGRAM LIBRARY      Update number 118     15 JUN 1998
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
 
                     SOME NEW FEATURES OF THE PROGRAMS
 
* [This README.TXT file is updated when a new version of one or more programs
  or routines becomes available.  It describes new features in the programs,
  with the most recent changes first.]
 
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
                            DISCLAIMER  (See below)
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
 
* If you find problems or have suggestions about any of the programs, please
  contact:
 
    Richard Holmes, c/o Laboratory of Tree-Ring Research,
    University of Arizona, Tucson, Arizona 85721  USA
 
    E-mail: RHolmes@LTRR.Arizona.EDU
 
* If you have detected a problem, it is possible that it has already been
  found and the corrected version has been made available.  Make sure you
  have the latest versions of the programs; see ANONYMOUS FTP below.
 
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
 
* In Programs ARSTAN, CRONOL and DPL/CRN, if a time series is to be divided by
  a detrending curve, it is subtracted instead if the time series goes
  negative or the detrending curve goes to zero or negative.  The mean of the
  resulting indices will be 1.0  [09JUN98]
 
*  A couple of screen savers have been added: SCRSAV.  Try them.  [01JUN98]
 
* Program ARSTAN uses the Compact format by default, and saves files with the
  number of radii (__ARS.NRA) and the number of trees (__ARS.NTR).  [29MAY98]
 
* A new format for data, known as "New compact", is now available in Programs
  DPL, FMT, COFECHA and SCRPLT.  It will eventually be available in all
  programs in this group.  The advantage of this format is the preservation of
  precision even when extremely large values are found in the same data set.
  [20MAY98]
 
* Now available is a new version of COF10K, a high-capacity COFECHA.
  It will work with time spans of up to 10240 years in length and 8000 series.
  The program will run slowly with a very large data set.  [19MAY98]
 
* Program FMT (Manipulate data or change format) is now an independent program,
  as well as being in DPL.  [13MAY98]
 
* Program PCA (Principal Components Analysis) is now an independent program,
  as well as being in DPL.  [13MAY98]
 
* Program YUX (Makes casewise file for spreadsheet) is now an independent
  program, as well as being in DPL.  [13MAY98]
 
* Program DPL/PCA (Principal Components Analysis) now handles very long
  series correctly.  [17APR98]
 
* Program ARSTAN no longer adjusts the mean of the chronology to unity.
  Eigenvalues and Eigenvectors are saved in a file with the extension __.EV;
  and Principal component amplitude series are saved in a file with extension
  __.PC  [16APR98]
 
* Program DPL/SUR (survey of data files) now orders correctly by any selected
  item.  [27MAR98]
 
* In Program DPL/YUX (data series in columns for spreadsheets) precision has
  been improved; there are up to double or more the number of significant
  digits.  This means that large and small values are given with maximum
  precision.  This is an important improvement.  [23MAR98]
 
* Program DPL/MET provides better documentation in the output file.  [19MAR98]
 
* Program EDRM and routine DPL/EDT had a problem with series identifications;
  this has been remedied.  [16MAR98]
 
* Programs were simplified and recompiled.  [04MAR98]
 
* Program ARSTAN tree summaries are truncated if required to include only
  continuous time spans; they do not include voids between non-continuous
  radial series.  [29JAN98]
 
* DPL.FMT now allows you to fit a spline curve of rigidity proportional to
  the length of the series.  For example, a rigidity of "-67" will fit a
  spline of 50% frequency response of 67% of the series length.  You may
  also save both spline and indices in a single run.  [01DEC97]
 
* The date computation in all programs was corrected so that there will be
  no problem when the year 2000 arrives.  Version was set to 3.00 in most
  programs.  [14JUL97]
 
* The algorithm in Programs ARSTAN, CRONOL and DPL/CRN for computing the
  negative exponential curve fit was extensively modified and dramatically
  improved by Ed Cook of the Tree Ring Laboratory at Lamont-Doherty Earth
  Observatory.  The new routine is now included in all versions of the
  programs.  The negative exponential curve fit may go negative, that is,
  the curve may have a negative asymptote.  The user may override this
  provision and revert to linear regression fit.  This is in Option 2,
  "Detrending Method", when curve fit type "1" is selected.  When
  the series of measurements is divided by the curve, however, a constant is
  added to raise both series to all positive values, the division is performed,
  and the constant is subtracted again.  Program ARSTAN checks for indices over
  4.0 and lists them by series; this is one tool you may use to find problems
  in the curve fit.  [02FEB98], [03JUN97]
 
* You may now set your favorite default colors for text and screen.  You may
  have one color combination during execution of programs and another when you
  are outside them.  Use either DPL and type (~), or use program SETCLR.  If
  the file ANSI.SYS is not activated in your CONFIG.SYS file, use SETCLR and
  respond with a slash (/).  All programs were recompiled today.  [24OCT96]
 
* Program EVENT (Superposed Epoch Analysis) now will handle a maximum window
  size of 102 years -- those before plus those after plus key year.  [11SEP96]
 
* Mean sensitivity is now calculated even for series that contain negative
  values, according to the formula:
 
      MS = SUM(I=2,N)/(N-1)  2. * |(Y(I) - Y(I-1))| / ( |Y(I)| + |Y(I-1)| )
 
           if ( |Y(I)| + |Y(I-1)| ) is non-zero
 
  Where MS is mean sensitivity of the series
        Y  is the time series of values
        N  is the number of values in the series
 
  With the caveat:  If there are any negative values in a series, the decimal
  point for mean sensitivity is printed as an asterisk.  In such cases mean
  sensitivity cannot strictly be calculated correctly.  [24APR96]
 
* In opening files two new convenient features are added.  The program spells
  out the format it finds for the data file; you may correct it if it is
  incorrect.  After seeing the first eight lines of the data file, you may
  now close the file with a backslash (\) and open another file as desired.
  Data series in Compact format may be interspersed among those in ITRDB
  Measurement or Index format, if the first series is not in Compact format.
 
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
 
                                 DISCLAIMER
 
> The following disclaimer applies to the Dendrochronology Program Library,
  Program ARSTAN, all programs in the Dendroecology Program Library, and any
  other software distributed by myself directly, via Anonymous FTP, or by
  any other means.
 
> All software has received only limited testing and neither the author(s),
  the Laboratory of Tree-Ring Research, nor the University of Arizona can
  accept responsibility for its compatibility with other computer systems or
  user needs.  The user must judge its efficacy for the intended use.
 
> Although every effort is made to ensure that the software functions
  properly, no guarantee is made to this effect and we cannot be responsible
  for any problems with it, including adaptation of the software to any
  particular computer system.
 
> The software is made available free of charge.  Any payment accepted
  is for actual costs of diskettes, copying, printing and/or postage.
 
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
 
ANONYMOUS FTP
 
The Dendrochronology Program Library and programs in the
Dendroecology Program Library are in the ANONYMOUS FTP directory
 
		/SYS/HOME/ANONYMOU/PUB/DPL
 
They are not compressed, but alive and well and ready to work.
 
Each time you unload programs, be sure to use the most updated version of the
memory manager program DOSXMSF.EXE.  Instructions below show how to obtain the
programs.
 
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
 
HOW TO GET PROGRAMS VIA ANONYMOUS FTP
 
Following are instructions to obtain the latest versions of computer programs
available from the Tree-Ring Laboratory of the University of Arizona.
First is a table of computer prompts, your responses and an explanation.
After the table is a more complete record of a typical FTP session.
 
TRANSFERRING EXECUTABLE FILES TO YOUR PC
 
Be sure to set your FTP client to binary mode to transfer executable files
to your PC.  Put executable files in a subdirectory listed in the PATH
statement in the AUTOEXEC.BAT file.  You may then run any program simply by
typing the name, e.g.:  "DPL" or "EVENT"
 
--------------------   -------------------------    ---------------------------
 Prompt_by_computer     Your_input                   Explanation
--------------------   -------------------------    ---------------------------
$> [Your computer]     ftp kati.ltrr.arizona.edu    Connect to server
KATI.LTRR.ARIZONA.EDU> login anonymous              Anonymous login
Password:              rholmes@ltrr.arizona.edu     Your E-mail address
KATI.LTRR.ARIZONA.EDU> binary                       Set to BINARY transfer
KATI.LTRR.ARIZONA.EDU> cd pub                       Change to PUBLIC directory
KATI.LTRR.ARIZONA.EDU> cd dpl                       Change to DPL directory
KATI.LTRR.ARIZONA.EDU> mget dosxmsf.exe             Get Memory manager *
KATI.LTRR.ARIZONA.EDU> mget dpl.exe                 Get Program Library
KATI.LTRR.ARIZONA.EDU> mget arstan.exe              Get Program ARSTAN
KATI.LTRR.ARIZONA.EDU> mget [any other programs]    Get other programs
KATI.LTRR.ARIZONA.EDU> bye                          Exit connection to server
FTP>                   exit [may vary by system]    Exit FTP
 
* This is a new version of the memory manager, required for any version of
Programs DPL, ARSTAN and others dated after 24 May 1994.
 
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
 
Following is a nearly complete record of a typical FTP session.
A blank line comes before a line where you respond, and the remaining lines
are printed on the screen by the computer.
 
Your response follows the symbol ">" or in the case of the password, ":".
--------------------------------------------------------------------------------
 
$> ftp kati.ltrr.arizona.edu
 
KATI.LTRR.ARIZONA.EDU>login anonymous
<Anonymous Login OK, send id as password.
 
Password: rholmes@ltrr.arizona.edu
<User Logged.
<Home Directory: /SYS/HOME/ANONYMOU
 
KATI.LTRR.ARIZONA.EDU>binary
Type: Image, Structure: File, Mode: Stream
 
KATI.LTRR.ARIZONA.EDU>cd pub
<Public upload directory.
<This is a collection of software that you can copy to your machine.
<The directories here are:
<   FIRE  . . . . . . . . . .  Subdirectory for fire history program
<   BIBLIO . . . . . . . . . . Subdirectory for bibliographic database
<   ITRDBLIB  . . . . . . . .  Subdirectory for ITRDB program library
<   PRECON . . . . . . . . . . Subdirectory for PRECON software update
<"/SYS/HOME/ANONYMOU/PUB" is current directory.
 
KATI.LTRR.ARIZONA.EDU>cd dpl
<Be sure to set your FTP client to binary mode to transfer the .EXE files
<"/SYS/HOME/ANONYMOU/PUB/DPL" is current directory.
 
KATI.LTRR.ARIZONA.EDU>mget dosxmsf.exe
<Opening ASCII data connection.
<Transfer complete.
<Opening BINARY data connection for /SYS/HOME/ANONYMOU/PUB/DPL/dosxmsf.exe
(374950 bytes).
<Transfer complete.
 
KATI.LTRR.ARIZONA.EDU>mget dpl.exe
<Opening ASCII data connection.
<Transfer complete.
<Opening BINARY data connection for /SYS/HOME/ANONYMOU/PUB/DPL/dpl.exe
(537600 bytes).
<Transfer complete.
 
KATI.LTRR.ARIZONA.EDU>mget arstan.exe
<Opening ASCII data connection.
<Transfer complete.
<Opening BINARY data connection for /SYS/HOME/ANONYMOU/PUB/DPL/arstan.exe (
315392 bytes).
<Transfer complete.
 
KATI.LTRR.ARIZONA.EDU>bye
<Goodbye.
 
FTP>exit
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=