;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
readme for data related to 5cm soil temperatures for use with WLEF


There are four types of files in this directory:
     sarraynnnn.txt     contain summary soil temperature data
                        from Wisconsin ChEAS sites
                        for the year nnnn
                         (created in create_sarray.pro)

     prefsoilnn.txt     contain preferred 5cm soil temperature
                        data for use with WLEF data
                         (created in prefsoil.pro)     

     ...diurnyy.s.txt   contain normalized diurnal patterns 
                        for generating hourly data from a
                        daily mean and range
                         (created in tsdiurnyy.pro)
                        
     daymeansnn_filled.txt contain daily mean and range information
                        (for both 5cm soil and 30m air) used
                        to fill major holes in 1997 and 1998
                          (created in tsdiurnyy.pro and 
                           manually adjusted/filled)
     
     also used for 1997 and 1998 are the filled air temperature datasets



Format of sarraynnnn.txt

    0      year
    1      month of year
    2      day of month
    3      hour of day LST
    4      day of year
    5      Willow Springs Ts 0cm   (1997-2001)
    6      Willow Springs Ts 5cm
    7      Willow Springs Ts 10cm
    8-10   Willow Creek Ts 0cm, 5cm, 10cm (beginning November 1998)
   11-13   Mixed Upland micromet site Ts 0cm, 5cm, 10cm (beg Nov 98)
   14-16   Red Pine micromet site Ts 0cm, 5cm, 10cm (beg Nov 98)
   17-19   Alder micromet site Ts 0cm, 5cm, 10cm (beg Nov 98)
   20-22   Aspen micromet site Ts 0cm, 5cm, 10cm (beg Nov 98)

    Unavailable data are indicated by -999
    Willow Creek and the micromet sites are hourly averaged
    Willow Springs data is taken from the WLEF met file


Format of prefsoilnn.txt

   1       year
   2       day of year
   3       hour of day LST
   4       preferred 5cm soil temperature  (degrees C)
   5       source of data
              1 Willow Springs clear cut site
              2 Mixed Upland micromet site
              3 Red Pine micromet site
              4 interpolate Willow Springs (small holes)
              5 modeled from estimated daily mean and range
                  using season-appropriate normalized diurnal
                  pattern   (1997 and 1998)

Formats for files used in gap filling for 1997 and 1998 are 
described below.

Notes on gap filling:

1. Willow Springs is the only data source for 1997 and 1998 
   (until the micromet sites came on-line in November 1998).
   Gaps in these data are filled by interpolation (for very
   small gaps) and by a modeling approach outlined below.
2. For 1999-2001, Willow Springs is the primary source of data,
   with gaps filled with equivalent hourly averaged data from
   the Mixed Upland micromet site (closest to the WLEF tower),
   and then the Red Pine micromet site. Please note that the
   soil characteristics of all these sites, while not identical,
   are judged to be representative of the area.
3. Willow Springs data are not available after 2001. For 2002
   Mixed Upland and Red Pine micromet site data are used.
   For 2003 Mixed Upland micromet site data are used exclusively.
4. Gap filling for the 1997 and 1998:


Format of diurnal pattern (columns are selected 10-day bins,
                            1 row for each hour)

      each hourly datum is the fraction of the daily range
      to be added to the minimum temperature for the day
      (minimum temperature is the daily mean minus half 
       the range)
       Diurnal patterns are developed from 10-day bin averages
       for the time period with data closest to the gap to be filled (and
       with similar seasonal characteristics). For example, there
       is almost no diurnal variation once the soil freezes.
  


Format of daymeansnn.txt (rows equal to the days for which data must
                         be generated)

   1       day of year
   2       mean 5cm soil temperature (modeled)
   3       5cm soil temperature daily range (modeled
               and approximately 10% of air temperature range)
   4       mean 30m air temperature (from filled air temp data)
   5       30m air temperature daily range



Martha Butler   June 2003; March 2004