RAMPFIT Version 1.10 (November 2007)

============================================================

Dear User!

Thank you for your interest in RAMPFIT.

This file explains installation, lists history of changes
to RAMPFIT since the original publication and makes a few
annotations to the RAMPFIT manual (Mudelsee 2000).

Feedback by you on problems, uncovered bugs, experiences
with your implementation etc. are appreciated.

If you require a special installation, or you are
interested in the FORTRAN 77 source code, please
contact me.

Hannover, November 2007, Manfred Mudelsee

Climate Risk Analysis
Schneiderberg 26
30167 Hannover
Germany
Email: mudelsee@mudelsee.com
URL: http://www.mudelsee.com

============================================================

        I               Installation (on PC)
                I.1     DOS
                I.2     Windows 95/98/NT
                I.3     Linux

        II              Changes

        III             Annotations to Mudelsee (2000)
                III.1   Appendix A.2 (Part 2: regression)
                III.2   Appendix A.3 (Part 3: residual diagnostics)
                III.3   Appendix A.4 (Part 4: bootstrap resampling)


============================================================

        I               Installation (on PC)
                        ====================

RAMPFIT has been tested on IBM-type PCs (and also Sun
workstation) under several operating systems. In principle,
the installation comprises (1) copying of RAMPFIT executable
and (2) installation of the freeware graphics program
Gnuplot (version 3.6 or higher).

                I.1     DOS
                        ===

If you need a version for DOS, contact me!


                I.2     Windows 95/98/NT
                        ================

Copy the files pkunzip.exe and

        rampfit.zip

to your RAMPFIT directory (say, C:\rampfit). Uncompressing
with the command

        pkunzip rampfit.zip

you obtain the following files:

        rampfit.exe     :       RAMPFIT executable

Install Gnuplot (Version 4.2, also on my URL) similarly.

RAMPFIT is run from the DOS window (not DOS mode) with the command

        rampfit

rampfit.exe was compiled with Absoft's F77/95 Version 10.0
compiler.

                I.3     Linux
                        =====

If you need a version for Linux, contact me!

        II              Changes
                        =======

The changes listed are with respect to the version provided
with the original paper (Mudelsee 2000) in April 2000.

Version         Changes

1.01            main program, # 20      suggested value for tau corrected
(July 2000)     subroutine avestd       improved robustness against
                                        roundoff errors
                subroutine bootn        meaning of p
                                        brought in line with paper
                subroutine info3        variable name "rho" replaced by "a",
                                        brought in line with paper
                subroutine rfit         crucial variables declared
                                        as double precision
                subroutine smooth       improved robustness against
                                        roundoff errors
                elsewhere               typing errors corrected

1.02            new Gnuplot version (3.7)
(October 2001)

1.03
(December 2001) more digits in info fields

                simulation counter added
1.10            adapted to Gnuplot 4.2
(November 2007)


        III             Annotations to Mudelsee (2000)
                        ==============================

The original paper (which can be downloaded from my URL),
containing a manual of RAMPFIT, is:

Mudelsee M (2000) Ramp function regression:
                  A tool for quantifying climate transitions.
                  Computers and Geosciences, Vol. 26, No. 3, pp. 293-307.

                III.1   Appendix A.2 (Part 2: regression)
                        =================================

Part 2 information field displays the fit result. A double exclamation
mark before estimated parameters t1 or t2 means a boundary solution.

                III.2   Appendix A.3 (Part 3: residual diagnostics)
                        ===========================================

Part III information field displays the result of AR(1) fit to residuals.
A value of a = 0.000 and tau = -999.999 means that there is no estimated
positive autocorrelation.

                III.3   Appendix A.4 (Part 4: bootstrap resampling)
                        ===========================================

As regards the choice of parameter p, the paper incorrectly states that
you may wish to take a smaller value which would increase the average
block length. Correct is: a larger value achieves that.

                III.4   Output files
                        ============

Output files are written to the RAMPFIT directory.


END OF FILE README.TXT