# standard-surflist.txt -- # # Surface description file for ANUCLIM # # The text below is copied from the surflist file supplied with the # Australian climate surfaces. Use this file as a template for # creating or modifying your own surflist files. # ------------------------------------------------------------------ # surflist -- # # Surface description file for ANUCLIM # # SCCS-ID: @(#) surflist 1.4 00/11/14 14:45:58 # # This file is an essential part of the ANUCLIM package and contains # information on country names, climate variable names, surface file # names and slope/aspect radiation ratio table filenames. Its main # purpose is to list the ANUSPLIN surface files that describe the # climate over one or more countries. See the ANUCLIM user's guide # for a full description of the role this information plays. For more # information on the surface files themselves, see the ANUSPLIN user's # guide or the CRES website http://cres.anu.edu.au # # This file is divided into 4 sections. Sections are separated by a # line of the form " PART n", where n is the following section # number. The PART token must be in uppercase and start in column # 3. Within a section, lines must appear in a specific sequence. See # the sections below for details. The sections must be numbered # consecutively starting with 1. # # Changes can be made either by upgrading or adding to any of the four # sections, but the following rules must be adhered to: # # Blank lines are not allowed. Comment lines beginning with a hash # character in column 1 can be included anywhere where a PART token # would also be legal (i.e. most places except within a subsection in # section 3). Comments can also appear at the end of a line except on # those lines that have a character string as their last # component. Formatting of numeric values must be preserved. # # CHANGES TO SURFACE FILES BETWEEN ANUCLIM 5.0 AND 5.1 # # This surflist file is designed to be used with ANUCLIM 5.1 or # newer. There are two changes in ANUCLIM 5.1 that affect the surflist # file: # # - ANUCLIM 5.1 can use surface files produced by ANUSPLIN # 4.x. It can also use the ANUSPLIN 3.x surfaces used by # ANUCLIM 5.0, except for the radiation-with-rainfall # surface. This surface fits each month to a different set of # 3rd independent variable values (the monthly rainfall # values), rather than the time-invariant elevation values # used for all other surfaces. The radiation with rainfall # surface mentioned in PART 3 (rainrad.2s3) is the ANUSPLIN # 4.x style version of the rainrad.2s2 surface supplied with # ANUCLIM 5.0. # # - The 'Sets' parameter in PART 3 is now ignored. This # information is read from the surface coefficient files instead # of the surflist file. Note that an integer value must still be # present though, and its probably worth keeping it accurate for # backwards compatibility. # #--------- PART 1 #--------- # # Country numbers and names. Maximum 7 countries. Fortran # format for these lines is (i4,1x,a30) # # More country names can be added, up to the maximum, but the # corresponding surface information must be added to PART 3. # #Num Name 1 Australia # #--------- PART 2 #--------- # # Climate variable numbers and names. Maximum 16 # variables. Fortran format is (i4,1x,a30). # # Climate variables 1 to 6 must be maximum temperature deg.C, # minimum temperature deg.C, rainfall mm, radiation with # rainfall Mj/m2/day, radiation Mj/m2/day, evaporation mm/month. # # Climate variables 7 to 16 can be anything you wish. # #Num Name 1 maximum temperature deg.C 2 minimum temperature deg.C 3 rainfall mm. 4 radiation with rainfall Mj/m2/day 5 radiation Mj/m2/day 6 evaporation mm/month 7 dew point at 0900h deg.C 8 dew point at 1500h deg.C 9 dry bulb at 0900h deg.C 10 wet bulb at 0900h deg.C 11 dry bulb at 1500h deg.C 12 wet bulb at 1500h deg.C 13 raindays 14 wind run Km/day 15 wind speed at 0900h m/s 16 wind speed at 1500h m/s # #--------- PART 3 #--------- # # Surface identifiers, names and geographic limits. # # This section is divided into subsections. There is one # subsection for each climate variable. Each subsection names # the ANUSPLIN surface files and corresponding geographic limits # for each patch included in the collection of surfaces for that # climate variable. # # The first line in a subsection has the fortran format (3i3,2i5). # Reading from left to right, the fields are: # Cn: Country number (from part 1) # Vn: Climate varaible number (from part 2) # Np: Number of surface files (patches) # 3IV: 3rd independent variable indicator # Sets: Number of surface file sets within each surface file # # The 3rd independent variable indicator is one of the following values # 0 none (i.e. only 2 IVs) # 1 Longitude # 2 Latitude # 3 Elevation # 4 Distance from coast # 5 Slope # 6 Aspect # 7 Rainfall # 8 Max.. soil water avail. # 9 Soil type # # The number of surface file sets within each surface file is # only used by ANUCLIM 5.0 (and older). For ANUCLIM 5.1 (and # newer), this value must still be present, buts its value is # ignored (this information is obtained from the surface # coefficient file instead). The 'Sets' parameter is usually 1, # and indicates the number of ANUSPLIN surface files that were # concatenated to form the patch. This was only used for # radiation with rainfall, where 12 surfaces (each fitted to # (x,y,rainfall) for one month) were coalesced into one file. # # Following the subsection header line are pairs of lines that # describe each patch. The first line in a pair is the ANUSPLIN # surface filename, relative to the directory containing this # surflist file. The second line in a pair is that file's # surface limits. The fortran format for these lines is (4f8). # Reading from left to right, the fields are: # minimum longitude # maximum longitude # minimum latitude # maximum latitude # # The number of these pairs of lines within a subsection must # match the patch count in the subsection header line exactly. # # The surface file naming convention uses the filename extension # to encode the surface version number. All the surface files # have names of the form *.[0-9]s[0-9]. The digit before the 's' # is the major version number and the digit after the 's' is the # minor version number. These files must be surface files # produced by ANUSPLIN 4.x or 3.x. They are text files # consisting of header information and surface coefficient # values. The first line of the 4.x style surface has the form # 'ANUSPLIN 1.0 UNITS: xxx TITLE: yyy'. The first line of a 3.x # style surface consists of 6 integers. # #---- # Maximum temperature # #Cn Vn Np 3IV Sets 1 1 1 3 1 maxt.2s1 110.00 155.00 -45.00 -10.00 / Surface limits # #---- # Minimum temperature # #Cn Vn Np 3IV Sets 1 2 1 3 1 mint.2s1 110.00 155.00 -45.00 -10.00 / Surface limits # #---- # Rainfall # # See PART 4 for details on how these patches relate to the # radiation ratio tables. # #Cn Vn Np 3IV Sets 1 3 7 3 1 qldnrain.2s1 141.00 154.00 -25.00 -10.00 / Surface limits (patch 1) qldsrain.2s1 142.00 154.00 -31.00 -25.00 / Surface limits (patch 2) nswrain.2s1 142.00 154.00 -35.50 -31.00 / Surface limits (patch 3) vicrain.2s1 142.00 151.00 -39.50 -35.50 / Surface limits (patch 4) tasrain.2s1 143.00 149.00 -44.00 -39.50 / Surface limits (patch 5) warain.2s1 112.00 120.00 -36.00 -18.00 / Surface limits (patch 6) ctrrain.2s1 120.00 142.00 -39.00 -10.00 / Surface limits (patch 7) # #---- # Radiation by (longitude, latitude, rainfall) # 17/8/2000, DH: rainrad.2s3 is an ANUSPLIN 4.x style surface. It won't # work with ANUCLIM 5.0 or older. #Cn Vn Np 3IV Sets 1 4 1 7 12 rainrad.2s3 110.00 155.00 -45.00 -10.00 / Surface limits # #---- # Radiation by (longitude, latitude) # #Cn Vn Np 3IV Sets 1 5 1 0 1 rad.1s0 110.00 155.00 -45.00 -10.00 / Surface limits # #---- # Evaporation mm/month # # Note: previous versions of this surface were in mm/day. ANUCLIM 1.8 # and later use the surface version number and the surface limits to # determine whether the units are mm/day or mm/month. If the limits # indicate Australia, and the surface version is 1s0 or # unrecognisable, it uses mm/day otherwise it uses mm/month. # #Cn Vn Np 3IV Sets 1 6 1 3 1 panevap.2s1 110.00 155.00 -45.00 -10.00 / Surface limits # #---- # Dew point at 0900h deg.C # #Cn Vn Np 3IV Sets 1 7 1 3 1 dew09.1s0 110.00 155.00 -45.00 -10.00 / Surface limits # #---- # Dew point at 1500h deg.C # #Cn Vn Np 3IV Sets 1 8 1 3 1 dew15.1s0 110.00 155.00 -45.00 -10.00 / Surface limits # #---- # Dry bulb at 0900h deg.C # #Cn Vn Np 3IV Sets 1 9 1 3 1 dry09.1s0 110.00 155.00 -45.00 -10.00 / Surface limits # #---- # Wet bulb at 0900h deg.C # #Cn Vn Np 3IV Sets 1 10 1 3 1 wet09.1s0 110.00 155.00 -45.00 -10.00 / Surface limits # #---- # Dry bulb at 1500h deg.C # #Cn Vn Np 3IV Sets 1 11 1 3 1 dry15.1s0 110.00 155.00 -45.00 -10.00 / Surface limits # #---- # Wet bulb at 1500h deg.C # #Cn Vn Np 3IV Sets 1 12 1 3 1 wet15.1s0 110.00 155.00 -45.00 -10.00 / Surface limits # #---- # Raindays # #Cn Vn Np 3IV Sets 1 13 1 3 1 rainday.1s0 110.00 155.00 -45.00 -10.00 / Surface limits # #---- # Wind run Km/day # #Cn Vn Np 3IV Sets 1 14 1 4 1 windrun.1s1 110.00 155.00 -45.00 -10.00 / Surface limits # #---- # Wind speed at 0900h m/s # #Cn Vn Np 3IV Sets 1 15 1 4 1 wind09.1s1 110.00 155.00 -45.00 -10.00 / Surface limits # #---- # Wind speed at 1500h m/s # #Cn Vn Np 3IV Sets 1 16 1 4 1 wind15.1s1 110.00 155.00 -45.00 -10.00 / Surface limits # #--------- PART 4 #--------- # # Radiation diffuse/direct ratio tables to be used when the # input file contains slope and aspect data and you request # modification of the radiation estimates. Each table is # associated with a rainfall surface patch (see PART 3). The # rainfall surface file patches are numbered sequentially # starting with 1. See the ANUCLIM user's guide for more information. # # Reading from left to right, the fields are: # Cn: Country number # Pn: Rainfall surface patch number (see PART 3) # Filename: Filename of the set of ratio tables # relative to the directory containing this file. # To date only two ratio tables exist for Australia and they are: # nqlratio.dat North Queensland # tasratio.dat Tasmania # # Cn Pn Filename 1 1 nqlratio.dat 1 5 tasratio.dat