tyn_sc_2.03

readme-v2-03.txt

TYN SC 2.03
Dr. T. D. Mitchell, 2.2.04, t.mitchell@uea.ac.uk
Tyndall Centre, www.tyndall.ac.uk
This data-set is only to be used with the author's permission.

CHANGES FROM PREVIOUS VERSIONS
changes made from v2.02
A new GCM (ECHam4) has been added to the data-set, giving a total of 5 GCMs
and 20 scenarios. 

changes made from v2.01
1.There was an error in scenarios.txt, affecting only PCM B2 and B1 scenarios.
  Incorrect global temperatures (3.070 and 2.521) had been (it seems)
  duplicated from HadCM3, instead of the correct values (1.894 and 1.541)
  being supplied. The effect was to reduce the size of the climate changes.i
2.It is now possible to unpack the raw data files without using the fortran
  software supplied below. See http://www.cru.uea.ac.uk/~timm/grid/algorithm.html 
 
DIRECTORY STRUCTURE
The full data-set is sub-divided into three sub-directories:
data - contains all the raw data files
compaq - contains the fortran routines used to unpack the raw
         data files into the scenarios
xlf - contains alternative versions of the fortran routines,
         for use on the PIK machines

DOWNLOADING
You will find downloading the files easier if you use the archive*
files, which collect some of the main file sets into archives. If you
follow this recommendation, all you need to download is:
./data/archive*
./data/obs*
./data/iavar*
./data/scenarios.txt
./compaq/archive* (only one of the fortran subdirectories is required)
./xlf/archive*
If you do not follow this recommendation, you will need to download
everything except the archive* files.

For reference, I archived thus:
pax -w files > archive
The files can be restored thus:
pax -ru < archive
Many of the files will require decompression with 'compress'.

UNPACKING INTO SCENARIOS
You may either use the supplied fortran software, or unpack yourself using
  the information at http://www.cru.uea.ac.uk/~timm/grid/algorithm.html

SUPPLIED FORTRAN SOFTWARE
How to unpack the basic files into scenario files:
A. transfer the entire contents of the subdirectories onto a Unix machine
B. uncompress all files with .Z suffices (uncompress [filename])
C. compile the *seqgrim* program (on the home Unix system - see file headers):
D. compile the *unpack* program (on the home Unix system - see file headers):
E. copy the executables across to the data directory
F. run the *unpack* program (which itself calls the *seqgrim* program)
WARNING:
The software supplied should not be altered. Any alterations will risk altering 
the process of unpacking the basic files.

FILE IDENTITIES
readme* = this file
scenarios.txt = vital instructions file for software to read - do NOT alter!
*.f90 and *.f = software for unpacking the basic files into 21st century scenario 
		files, under Compaq (.f90) or xlf (.f) compiler
hd* = response patterns for 2070-2099 (basic files)
*-*.ann = time-series of global temperature change (basic files)
iavar* = inter-annual variability from 1901-2000 (basic files, nat-var files)
obs* = 1961-90 climatology (basic files)
min.???.ann = minimum legitimate value (basic files)
max.???.ann = maximum legitimate value (basic files)

ALSO AVAILABLE
The CRU TS 2.0 is a companion data-set to TYN SC 2.0. It consists of grids
of observed data for 1901-2000 in the same format.