ANUCLIM Change log
ANUCLIM 1.2 release
incorporating
anuclim 4.6
bioclim 3.7
esoclim 3.7
groclim 4.3
by David Houlder, CRES, ANU
New features and bug fixes since previous release:
1. No limits on grid row length for bioclim, esoclim.
Previous releases had fixed limits on the length of input grids
(e.g. DEMs). This release dynamically allocates memory
according to the grid row length (number of columns).
2. Expanded grid row length for groclim.
The grid row length in groclim is now 10000 columns.
3. Fixed esoclim report-style output of surface 4 (radiation
with rainfall).
The previous release had a bug which caused the report-style
output to only show values for one month.
4. Long file pathnames.
File pathnames in all programs can now be up to 255 characters long.
5. Support for relative pathnames in surflist file to simplify
installation.
In previous releases, the surflist file normally listed the
absolute pathnames of surface files, meaning that it had to be
edited for each individual installation, or when the surface
directory was moved.
Relative pathnames in the surflist file are now resolved with
respect to the directory containing the surflist file. This
means you can install or move the surface directory anywhere
without having to edit the surflist file.
6. Surface knot limit increased.
The number of knots permissible in a surface file in now 1000.
7. esoclim ARC/INFO FLOATGRID output format fixed.
In previous releases, esoclim was writing spurious null bytes
at the start of all but the first output grid.
8. ARC/INFO FLOATGRID header now has correct byte ordering for
x86 machines.
9. New output format from bioclim for use with biomap (".bcp
file").
The 'unformatted .bio' file that used to be used as input to
biomap has been replaced by a new file containing a header
record that describes the file. This means that biomap no
longer has to ask you for the parameter numbers in the 'grid'.
Apart from the header information, the file is now a 'raw
binary' file, meaning that it can be read by programs not
written in fortran.
The initial part of the header information is an ASCII string,
terminated by a platform-dependent end-of-line sequence, making
for easy identification of the file (e.g. "head -1 xxx.bcp" or
"what xxx.bcp" under unix). The remainder of the header
includes information that biomap uses to determine if the file
is incomplete (e.g. bioclim crashed), or if the file came from
a machine with a different byte order.
The ".bio" suffix is now used for just one file type - the text
output from bioclim.
biomap will automatically detect if the parameters file is not
in the new ".bcp" format and revert to its old behaviour of
prompting for parameter numbers and reading the file as a
fortran-unformatted file.
10. No 'default grid file' in biomap.
This made no sense for users other than those at CRES.
11. Increased field widths for ARC/INFO ASCIIGRID input files.
All programs now read key values up to 30 characters long.
12. Longer identifiers for sites in bioclim and esoclim.
Identifiers now have a maximum length of 15 characters.
13. New percentile span in biomap: 2.5%-97.5%
14. Streamlining of prompts in anuclim.
The series of prompts in anuclim has been reworked. Prompts for
filenames now check to see if the file is readable/writable and
ask again if there is a problem.
The confusing prompts regarding southern/western hemisphere
sign characters have been replaced by a (hopefully) clearer
single question.
The grid corner/centre prompt for 'headerless grids' has been
removed. This flag had no effect on the interpretation of the
grid value positions, and is only used to choose corner/centre
conventions for output arc/info grids.
All input grids are now assumed to have the top left cell as
the first value in the file. In the rare event that your grid
starts with the bottom left cell, you can still edit the
command file to change the flag.
15. Grid window option fixed.
The grid window or "subsample" option did not work in previous
releases. Its calculation of the window row and column spans
was broken, often causing a "position error" message.
The grid window calculations have been fixed, and the window
coordinates are aligned to the nearest cell boundary. A message
notifies you if the window limits are re-aligned.
16. Percent-complete message in bioclim and esoclim.
When run with grid input, bioclim and esoclim report progress
with a percent-complete message at approximately 5% intervals.
17. biomap now works when the profile has parameters not found
in the grid.
In previous releases, biomap would not find any domains if
there were parameters in the profile (".pro" file) that weren't
in the bioclimatic parameters file (".bio" file). biomap now
just ignores extraneous parameters.
18. biomap runs faster
biomap was performing unnecessary iterations of the innermost
loop when testing the statistical parameters. biomap should run
around twice as fast as in previous releases.
19. biomap more easily scripted, prompts streamlined.
The series of prompts in biomap has been streamlined. biomap is
now much more easily driven with a command file, especially in
its percentile-spans mode. In this mode, the selection of which
tests to perform, the test symbol to use and the parameters to
use is now described by 5 consecutive lines in the command
input.
20. bioclim would sometimes crash when using evaporation.
bioclim would sometimes attempt to take the square root of a
tiny negative number, due to floating point precision effects.
These cases are now coerced to zero.
21. slope/aspect correction for radiation may never have worked
on some platforms.
An out-of-bounds array reference meant that it may have been
possible that bioclim and esoclim used nonsense values as the
slope and aspect variables. This has been fixed.
22. groclim never worked with arc/info grid input
groclim used to get into trouble when reading the header part
of an arc/info asciigrid file. This has been fixed.
23. POSITION ERROR message changed to OUTSIDE SURFACE LIMITS.
Hopefully this is more descriptive of the problem with the
data file. This message will appear if a data point or
grid cell is outside the surface limits for the country.
24. common source tree for all platforms.
Executables for all platforms are now built from the one set of
source code, hopefully banishing version mismatches within
releases.
25. Better dos/ms-windows memory management.
The executables supplied for the x86 platform should now run
from DOS directly, or from a DOS window started in Windows 3.1,
95 or NT.
26. Improved radiation-with-rainfall surface for Australia.
The radiation-with-rainfall surface has been improved by
incorporating a robust partial spline dependence on rainfall.
Incompatibilities with previous releases:
1. Format of ".pro" file has changed.
".pro" files generated by previous versions of bioclim will not
work with the new biomap due to the extra 2.5%..97.5% class.
2. Prompt sequence for anuclim changed.
3. Prompt sequence for biomap changed.
Note: Command file formats for bioclim, esoclim and groclim
have _not_ changed.
--- Released ANUCLIM 1.2 Tue Jun 17 11:51:58 EST 1997 -----
ANUCLIM 1.3 release
incorporating
anuclim 4.7
bioclim 3.8
esoclim 3.8
groclim 4.4
by David Houlder, CRES, ANU
Problems fixed by this release:
1. IDRISI grid input didn't read .doc file
anuclim didn't attempt to read the idrisi grid .doc file to
obtain grid limits, row, column counts etc. This information is
now read from the .doc file if it can be found.
2. All programs wrote incorrect IDRISI grid limits
The output .doc file for IDRISI grids contained x and y limits
that were wrong by half a grid cell on each side.
Note: It appears as though the IDRISI point/line input is currently
restricted to files that can fit into the work arrays. For point data,
these arrays limit the number of points in a file to 2500 for bioclim
and esoclim, and 10000 for groclim.
--- Released ANUCLIM 1.3 Mon Jul 28 13:35:28 EST 1997 -----
This release: ANUCLIM 1.4
Incorporates:
addsurf 1.1
anuclim 4.8
bioclim 3.9
esoclim 3.9
groclim 4.5
Previous release: ANUCLIM 1.2
New features and bug fixes since previous release:
Most of these changes relate to Idrisi input or output.
1. anuclim remembers the most recently used surflist file.
The surflist filename now defaults to the one used by the
previous run of anuclim. This should eliminate a lot of
retyping of the (often lengthy) surflist filename. The name of
the surflist file is stored in a file called ACPREFS.TXT in the
current working directory, so you can end up with several
different settings for the default surflist if you run anuclim
from a number of different working directories.
You can copy or link ACPREFS.TXT between directories in order
to make the defaults known elsewhere. In future versions of
anuclim, the format of the file may change in order to store
other settings.
2. Idrisi binary format grid output option suppressed in anuclim.
At present only Idrisi ASCII format grids can be generated, and
the anuclim output mode prompt has been changed to reflect this
limitation.
3. Cosmetic changes to bioclim output choice prompts in anuclim.
4. Default "yes" to bioclim derived parameters and frequency plots
questions in anuclim.
5. Removed extraneous embedded spaces in warning message in anuclim.
One of the file existence checks for input files in anuclim
reported the filename with a heap of trailing spaces.
6. Reads Idrisi .doc file for input grid information.
anuclim now reads grid resolution, missing value and limit
information from the corresponding .doc file if it is
available. If unavailable, it reverts to prompting for this
information.
7. Fixed Idrisi grid output.
Each program now writes files with the required .img extension,
and writes a .doc file for each .img file it produces. The
parameter or surface number is embedded in the filename. See
below for more details.
8. Added dummy identifiers for locations in arc/info and Idrisi
point files.
The dummy identifiers are useful with the report-style outputs
from bioclim and esoclim, and essentially just enumerate the
points in the input file.
9. Fixed Idrisi grid read.
The Idrisi grid read code was broken in previous releases, and
caused the programs to crash on the first row of the grid.
10. Fixed Idrisi point read.
The Idrisi point read code in previous releases limited the
number of points in an input file to a number between 1000 and
2500, depending on the program version. Point files can now be
arbitrarily long.
11. Fixed formatting in .doc file generation
Some of the key/value pairs were incorrectly formatted and
could not be read into Idrisi.
12. Enhancements to Idrisi .doc files on output.
The .doc files now include a file description (in the case of
bioclim, the parameter description string), and information
about the program and date in the comment section.
13. Fixed Idrisi vector output.
Output vector files now have the required .vec extension and a
.dvc documentation file is written for each vector file.
In previous releases only the vector file was written.
14. Fixed filename generation for Idrisi outputs.
All Idrisi outputs now generate the appropriate data and
documentation file pairs. The filenames are formulated as
follows, where
F=user supplied filename prefix
M=month number
N=parameter number
S=surface number
X=img and doc, or vec and dvc extension as appropriate
Lower case characters are literal.
bioclim: FFFFFFNN.XXX
esoclim: FFFFMMsS.XXX (for S<10)
FFFFMMSS.XXX (for S>=10)
groclim: FFFFyrNN.XXX (for yearly parameters)
FFFFMMNN.XXX (for monthly parameters)
Filenames should adhere to the 8.3 naming convention on the
DOS/MS-Windows platforms as the executables currently run in
DOS mode.
15. Reads all Idrisi file storage types.
Previous releases assumed the files were ASCII. This release uses
the documentation files to identify the file type, and can read
ASCII, integer, byte and floating point files.
Note that the integer and floating point formats must be read
and written using a machine architecture with the same byte
order.
16 bioclim didn't write any Idrisi .doc files if a grid window was
specified.
bioclim now always writes .doc files for Idrisi grid output.
17. Idrisi .doc files were created with hard-coded ref. system and
ref. units.
These are now written with the correct values for the
coordinate system in use.
This release: ANUCLIM 1.5
Incorporates:
addsurf 1.1
anuclim 4.9
bioclim 3.10
esoclim 3.10
groclim 4.5
biomap 2.1
Previous release: ANUCLIM 1.2
New features and bug fixes since previous release:
Most of these changes relate to Idrisi input or output.
1. anuclim remembers the most recently used surflist file.
The surflist filename now defaults to the one used by the
previous run of anuclim. This should eliminate a lot of
retyping of the (often lengthy) surflist filename. The name of
the surflist file is stored in a file called ACPREFS.TXT in the
current working directory, so you can end up with several
different settings for the default surflist if you run anuclim
from a number of different working directories.
You can copy or link ACPREFS.TXT between directories in order
to make the defaults known elsewhere. In future versions of
anuclim, the format of the file may change in order to store
other settings.
2. Idrisi binary format grid output added to esoclim.
Both bioclim and esoclim can now generate Idrisi binary grids.
The values written are unscaled reals.
3. Cosmetic changes to bioclim output choice prompts in anuclim.
4. Default "yes" to bioclim derived parameters and frequency plots
questions in anuclim.
5. Removed extraneous embedded spaces in warning message in anuclim.
One of the file existence checks for input files in anuclim
reported the filename with a heap of trailing spaces.
6. Reads Idrisi .doc file for input grid information.
anuclim now reads grid resolution, missing value and limit
information from the corresponding .doc file if it is
available. If unavailable, it reverts to prompting for this
information.
7. Fixed Idrisi grid output.
Each program now writes files with the required .img extension,
and writes a .doc file for each .img file it produces. The
parameter or surface number is embedded in the filename. See
below for more details.
8. Added dummy identifiers for locations in arc/info and Idrisi
point files.
The dummy identifiers are useful with the report-style outputs
from bioclim and esoclim, and essentially just enumerate the
points in the input file.
9. Fixed Idrisi grid read.
The Idrisi grid read code was broken in previous releases, and
caused the programs to crash on the first row of the grid.
10. Fixed Idrisi point read.
The Idrisi point read code in previous releases limited the
number of points in an input file to a number between 1000 and
2500, depending on the program version. Point files can now be
arbitrarily long.
11. Fixed formatting in .doc file generation
Some of the key/value pairs were incorrectly formatted and
could not be read into Idrisi.
12. Enhancements to Idrisi .doc files on output.
The .doc files now include a file description (in the case of
bioclim, the parameter description string), and information
about the program and date in the comment section.
13. Fixed Idrisi vector output.
Output vector files now have the required .vec extension and a
.dvc documentation file is written for each vector file.
In previous releases only the vector file was written.
14. Fixed filename generation for Idrisi outputs.
All Idrisi outputs now generate the appropriate data and
documentation file pairs. The filenames are formulated as
follows, where
F=user supplied filename prefix
M=month number
N=parameter number
S=surface number
X=img and doc, or vec and dvc extension as appropriate
Lower case characters are literal.
bioclim: FFFFFFNN.XXX
esoclim: FFFFMMsS.XXX (for S<10)
FFFFMMSS.XXX (for S>=10)
groclim: FFFFyrNN.XXX (for yearly parameters)
FFFFMMNN.XXX (for monthly parameters)
Filenames are coerced to the 8.3 naming convention for
compatibility with MS-DOS and MS-Windows 3.1. See below for more
information.
15. Reads all Idrisi file storage types.
Previous releases assumed the files were ASCII. This release uses
the documentation files to identify the file type, and can read
ASCII, integer, byte and floating point files.
Note that the integer and floating point formats must be read
and written using a machine architecture with the same byte
order.
16 bioclim didn't write any Idrisi .doc files if a grid window was
specified.
bioclim now always writes .doc files for Idrisi grid output.
17. Idrisi .doc files were created with hard-coded ref. system and
ref. units.
These are now written with the correct values for the
coordinate system in use.
18. anuclim was only listing all countries in surflist if the country
numbers were consecutive.
Country numbers can now be listed in any order.
19. anuclim no longer asks for country numbers if only one country
is listed in the surflist.
20. addsurf no longer prompts for the obsolete surface divisor parameter
21. Cosmetic changes to addsurf prompt sequence and climate variable list.
22. Added predefined format to anuclim for BIORAP export format.
The predefined format matches the file format generated by the
biorap database bioclim/esoclim export option. (see
http://www.erin.gov.au)
23. First binary Idrisi grid output file from bioclim sometimes
had garbage at end.
bioclim was writing garbage (arc/info header strings) into the
first Idrisi binary output file ( now called xxxxxx01.img).
This problem may only have been apparent with small output grids.
24. Better detection of existing Idrisi output files.
All programs now check for the prior existence of each .img, .doc,
.vec, .dvc file they write and bail out if any are found.
25. Idrisi output filenames truncated to form valid 8.3 filenames
Your filename prefix will be truncated if it is too long to form
a DOS-style 8.3 filename when the parameter/month/surface suffix
is appended. The filenames are truncated so that the file part of
the pathname is 8 characters long when the suffix is appended. A
warning message alerts you to the truncation at runtime.
26. Revised Australian temperature surfaces.
The revised temperature surfaces supplied on the patch disc
with anuclim 1.2 have been incorporated into anuclim 1.5. The
surfaces were created from an updated data set which includes
the years 1983 to 1995. Several station locations have been
corrected and an improved climate surface fitting methodology
has been used.
--- Released ANUCLIM 1.5 5 December 1997 -----
This release: ANUCLIM 1.6
Incorporates:
addsurf 1.1
anuclim 4.10
bioclim 3.11
esoclim 3.10
groclim 4.6
biomap 2.2
Previous release: ANUCLIM 1.5
New features and bug fixes since previous release:
1. Wrong prompt in anuclim. The responses to the question
"The coordinate reference information (longitude of
origin for TM, central' meridian for UTM) can be ...
1: on each line of the file
2: not in the file, but the same for all locations."
were incorrect.
Prompt now says:
0: not in the file, but the same for all locations."
1: on each line of the file
2. anuclim sometimes asked twice for slope/aspect radiation correction.
Now asks just once.
3. anuclim didn't generate command file containing radiation
surface for groclim if radiation surface was climate var 5.
groclim would not use surface 5, even if present in command file.
Now uses surface 5 if 4 not available.
4. bioclim was plotting symbols below x axis on line printer plots.
Fixed.
5. Temperature CoV in bioclim, biomap now reported to 2 decimal places.
The temperature coefficient of variance is in terms of degrees
Kelvin, so the previous rounding to the nearest integer lost
too much precision. The temperature CoV values in the .pro,
.bcp and .bio files from bioclim are now rounded to 2 decimal
places. When writing integer grids for arc/info or idrisi, the
values are multiplied by 100 before rounding.
This change will most noticeably affect the operation of biomap,
and should produce much better results when comparing the
temperature CoV parameter.
6. .pro file from bioclim now includes file version identifier.
This prevents comparing the profile against parameters
calculated by an incompatible version of bioclim. This was
introduced mainly to stop you inadvertently comparing files
with differing temperature CoV precisions (see above).
7. unix installation script fixed.
The unix installation script failed at the end of installing
anuclim 1.5. The error occurred after all files had been
installed, so this doesn't affect the operation of the package,
and meant that a few lines of information were not displayed.
Fixed in anuclim 1.6.
Incompatibilities with previous releases:
These 2 incompatibilities are deliberate, and designed to stop you
inadvertently comparing the old and new CoV values.
1. Format of ".pro" file has changed.
".pro" files generated by previous versions of bioclim will not
work with the new biomap due to the inclusion of the file version
record.
".pro" files generated with the new bioclim will not work with
previous versions of biomap.
The temperature CoV values are also different.
2. ".bcp" file has changed.
The temperature CoV values are now written to 2 decimal places.
The new .bcp format will not work with the old biomap, and vice versa.
Note: Command file formats for bioclim, esoclim and groclim
have _not_ changed.
--- Released ANUCLIM 1.6 5 March 1998 ----
This release: ANUCLIM 1.6.1
Incorporates:
addsurf 1.1
anuclim 4.10
bioclim 3.11
esoclim 3.10
groclim 4.6
biomap 2.2
Previous release: ANUCLIM 1.6
New features and bug fixes since previous release:
1. Some files in surf directory didn't have read permission (unix only)
2. Corrected transformation code in Australian wind surfaces.
These were incorrect in all previous versions of anuclim and will
have given incorrect values for wind speeds and wind run. The new
files have the extension 1s1, the old files have the extension 1s0.
The old files have a header like this
13 2 200 3 3 0
0.11000000E+03 0.15500000E+03 0
-0.45000000E+02 -0.10000000E+02 0
0.00000000E+00 0.30000000E+04 1
0.10000000E+04
The new ones look like this
13 2 200 3 3 0
0.11000000e+03 0.15500000e+03 0
-0.45000000e+02 -0.10000000e+02 0
0.00000000e+00 0.30000000e+04 6
0.30000000e+02 0.15000000e+02
Incompatibilities with previous releases:
None.
--- Released ANUCLIM 1.6.1 Thu Oct 15 1998 ---
This release: ANUCLIM 1.7
Incorporates:
addsurf 1.1
anuclim 4.10
bioclim 3.12
esoclim 3.11
groclim 4.7
biomap 2.2
Changes since release: ANUCLIM 1.6.1
Note:
This may be an interim release for CRES use only.
New features and bug fixes since previous release:
1. Revised surface interrogation routines.
calsur and rdsurf changed to allow new format surface files.
Surface files can now have a header record to identify their version,
and no allow a square-root transformation on the dependent variable.
Ask Mike Hutchinson for more info.
calsur is quite a bit faster now too, due (maybe) to changes in em.f
Incompatibilities with previous releases:
none known
--- Released ANUCLIM 1.7 15 September 1998 ---
This release: ANUCLIM 1.8
Incorporates:
addsurf 1.1
anuclim 4.11
bioclim 3.13
esoclim 3.11
groclim 4.7
biomap 2.3
bcpcat 1.2
Changes since release: ANUCLIM 1.6
New features and bug fixes:
0. Substantial revisions to Australian rainfall, evaporation and
radiation surfaces.
See the supplied metadata (surf/*.txt) for more information
1. Some files in surf directory didn't have read permission (unix only)
All surface files are now installed with read permission for all
users.
2. Corrected transformation code in Australian wind surfaces.
These were incorrect in all previous versions of anuclim and will
have given incorrect values for wind speeds and wind run. The new
files have the extension 1s1, the old files have the extension 1s0.
The old files have a header like this
13 2 200 3 3 0
0.11000000E+03 0.15500000E+03 0
-0.45000000E+02 -0.10000000E+02 0
0.00000000E+00 0.30000000E+04 1
0.10000000E+04
The new ones look like this
13 2 200 3 3 0
0.11000000e+03 0.15500000e+03 0
-0.45000000e+02 -0.10000000e+02 0
0.00000000e+00 0.30000000e+04 6
0.30000000e+02 0.15000000e+02
3. Revised surface interrogation routines.
calsur and rdsurf changed to allow new format surface files.
Surface files can now have a header record to identify their version,
and to allow a square-root transformation on the dependent variable.
calsur is quite a bit faster now too, due to changes in em.f
4. Complains about existing output files.
In previous versions there were problems with writing to arc/info
file types (usually grids) when some of the output files already
existed. Often the new output was appended to the old, but other
anomalous behaviour was possible. bioclim, esoclim and groclim
now complain and exit if any of the output files already exist.
5. Fixed bioclim crash on large grids when evaporation surface
was not selected.
6. '% complete' messages in biomap.
7. bioclim writes new format .bcp file.
The header of the .bcp file now includes the year-period count
(12 or 52), and, when derived from a grid, the grid bounds and
cell size. You can see these values with
bcpcat -v 1 < something.bcp
8. bioclim drops points out-of-bounds from profile and .bio.
Previous versions of bioclim generated zeroes for data points
outside the surface bounds, and this affected the generated
parameter profile.
9. arcview text-table output from biomap.
New output format for biomap. Resulting files can be used in
arcview as tables (plain text with header, comma delimited)
10. anuclim, bioclim, esoclim and groclim now read arc/info floatgrid files
When generating the command file, anuclim will automatically detect
whether your file is asciigrid or floatgrid, and read the grid bounds
from the appropriate file. bioclim, esoclim and groclim will also
automatically detect the file format.
11. anuclim was sometimes asking for soil water info when it didn't
need to.
12. anuclim no longer prompts for the evaporation units.
The evaporation units are now assumed to be mm/month for all
countries. anuclim will detect the old-style Australian evaporation
surface and revert to mm/day for this special case, triggered
by the following conditions: The name of the file must not end
with the pattern .2??, .3?? ... .9??, and the bounds for the
surface must fall within 100, 160, -50, 0 (w, e, s, n bounds).
13. bcpcat now displays period and grid information
See 7. above.
10. bcpcat now supplied for PCs
Incompatibilities with previous releases:
The new surface files will not work with previous versions
of anuclim. Old surface files are still compatible with this
version of anuclim.
The new .bcp file format is not compatible with previous versions
of anuclim. Previous versions of the .bcp file format are
compatible with this version of anuclim.
On a PC, the anuclim executables will now only run under Windows
95, NT or later, although still at a console prompt. All the
executables are now 32-bit, which does away with the DOS memory
settings and associated problems, and probably makes them run
faster too.
Known problems, limitations etc.
On the DEC Alpha platform, bioclim will report 'WRITE ERROR -CHECK
DISC SPACE' if an output field overflows. This is most likely to
happen if one of your data points is out of bounds by an order of
magnitude or more. The offending data point will be the last one
written to the output file, and will show **** in the field
concerned.
The BYTEORDER keyword in the header of ARC/INFO binary grids used
as input data is ignored. Binary grids must be in the native
byte-order of your machine. Output grids have the BYTEORDER
keyword set correctly.
--- Released ANUCLIM 1.8 18 December 1998 ---
This release: ANUCLIM 5.0
Incorporates
anuclim 5.0
anuclimc 4.11
bioclim 3.14
esoclim 3.11
groclim 4.7
biomap 2.3
bcpcat 1.2
New features and bug fixes:
1. ANUCLIM 5.0 has a completely new
graphical user interface and user's guide. BIOCLIM, ESOCLIM,
GROCLIM and BIOMAP are largely unchanged from the anuclim 1.8 release.
2. Improved radiation-with-rainfall surface (JLK and MH fixed
"Theodore vortex")
3. On some platforms, BIOCLIM would sometimes crash if not all
surfaces were used due to uninitialised values in unused surface value
arrays. These values are now initialised to 0.
Details: Sometimes crashed due to uninitialised values in unused
surface value arrays. All set to 0 after allocate() now. This
involved a change to comsub.f, which esoclim and groclim use, so
strictly speaking they should have their version numbers incremented
too.
4. Fixed radiation-ratio table information in surflist file. There
was an extra space before the table filename and the Tasmanian patch
number was wrong.
5. Slope/aspect modification on grid input was failing on the Irix
platform. On the 2nd and subsequent rows of the grid it would attempt
to open a radiation ratio table with a garbage filename. This bug was
not apparent on the win32 or other unix platforms.
Needed a 'save' attribute on safile() array in comsub.f.
6. Better installation mechanism on Windows 95..NT
7. New user's guide. Supplied as HTML and linked to the on-line help.
8. Changed bcphead.c and bcphead.h to provide better API to bcp file
format. shouldn't affect operation of bcpcat though. Again, strictly
speaking bcpcat should have a new version number, although I don't
think any new code is executed.
Incompatibilities with previous release:
None known.
Known problems:
win32 only: BIOMAP image preview pointer coordinate display broken if
x-x or y-y bounds are integral, This was fixed after the win32 release
and is included in the unix release. See below for patch details.
------------ released 5.0 for win32 10 nov 1999 ----
------------ released 5.0 for unix 30 November 1999 ----
This release: ANUCLIM 5.0 patch 1
Incorporates
tcl/tkImgXYZ.so
tcl/biomap.tcl
biomap.tcl 1.20 00/03/07 14:22:30
tcl/sitepvw.tcl
sitepvw.tcl 1.16 00/03/07 14:22:28
tcl/anuclim.tcl
anuclim.tcl 1.13 00/03/07 14:22:25
tcl/pkgIndex.tcl
1. Fix for blank BIOMAP image preview and asciigrid output when using
a grid specified in UTM coordinates in ANUCLIM 5.0.
Details:
There is a problem with biomap when using a .bcp file that was built
from a grid that was specified in terms of UTM coordinates, Under
these circumstances, the map preview image will be blank, and if you
have selected asciigrid output, the output file will contain just a
header and zeroes.
The point output formats from biomap are unaffected, even when the
image preview appears blank. The problem only appears if your DEM (or
other grid input to bioclim) is defined in terms of UTM coordinates. A
.pro file built from site data with UTM coordinates doesn't cause the
problem.
2. Fixed biomap pointer coordinate display for integer grid limits on win32.
Details:
Uses the fix that only made it onto the unix 5.0 CD (ensures
floating point arithmetic when map limits are integers).
3. Changed .bcp file error message slightly.
Details:
When you select a corrupt .bcp file, the error message now
mentions the possibility that bioclim hasn't/didn't finish
writing it.
Incompatibilities with previous release:
None known.
Source code affected:
utm.h:
utm.h 1.4 00/03/14 11:16:10
utm.c:
utm.c 1.4 00/03/14 11:15:22
tkImgXYZ.c:
tkImgXYZ.c 1.19 00/03/14 11:09:31
biomap.tcl:
biomap.tcl 1.20 00/03/07 14:22:30
sitepvw.tcl:
sitepvw.tcl 1.16 00/03/07 14:22:28
anuclim.tcl:
anuclim.tcl 1.13 00/03/07 14:22:25
pkgIndex.tcl:
Makefile:
Notes:
This patch fixes the UTM grid problem is almost all cases, but
a complete fix for the problem will require encoding the
coordinate system and its parameters in the .bcp file
header. See the comments in tcl/tkImgXYZ.c (parseBcpTcl in
particular) and utm.c for more details.
The patch is distributed as a self extracting archive under
both unix and win32. See README for details.
See http://cres.anu.edu.au/software/patches/anuclim
------------ released 5.0p1 for unix and win32 16 March 2000 ----
This release: CRES internal use only. No public release
Incorporates
bioclim 3.15
esoclim 3.12
groclim 4.8
1. Increased number of knots to 3000
Details:
Just a stop-gap measure until I get anuclim using the anusplin 4.x
style surfaces. Previous limit of 1500 knots was failing on
Oswaldo's Mexican rainfall surface. There's no check in the code
for this array overflow condition.
------------ CRES internal release for Solaris, 2 August 2000 ----
This release: ANUCLIM 5.1
Incorporates
anuclim 5.1
anuclimc 4.11
bioclim 3.18
esoclim 3.15
groclim 4.11
biomap 2.3
bcpcat 1.3
New features:
1. Faster surface value calculation, removal of knot limit and use of
ANUSPLIN 4.x surfaces.
Details:
The core of bioclim, esoclim and groclim has been completely rewritten
to perform much more efficient surface value calculations. bioclim,
esoclim and groclim run at 2 to 3 times the speed of the versions
supplied with anuclim 5.0. The new code also removes the knot limit
that previously applied to climate surfaces, and now allows both
ANUSPLIN 3.x and ANUSPLIN 4.x surfaces to be used. See the ANUSPLIN
documentation for more details.
2. Outlier identification for bioclim frequency plots.
Details:
bioclim has two new features that enable you to spot
suspicious data points in your input data. This first is the
'parameter extremes' list which lists each site that appears as either
a maximum or minimum value on one or more parameters. The second is
the labelling of outlier points on the cumulative frequency plots.
3. Export to spreadsheet from .bio file
Details:
A new option on the bioclim menu translates a .bio file into a .csv
(comma separated values) text file that can be read into spreadsheets
such as Excel or Gnumeric.
4. Skips header, footer and other junk lines when doing free format read.
Details:
When reading free-format text files in esoclim, bioclim or groclim,
any line that cannot be interpreted as a site is ignored. This allows
you to keep header, footer or comment lines in the text file without
introducing errors. A count of the lines that are skipped is reported
in the log file.
5. Warnings highlighted and counted in log windows
Details:
Warning messages from bioclim, esoclim and groclim are highlighted in
the log window (in orange and black, by default), and a count of
warning messages is displayed at the end of the log.
6. Reports which patches have radiation ratio tables and the number of
points modified by each
Details:
esoclim, bioclim and groclim now log the number of points
modified by each radiation-ratio table. They also produce a warning
message if radiation modification is selected but no points fall
within the bounds of the available tables.
7. Australian surface metadata now supplied in HTML form in user's guide.
Details:
The surface metadata (in HTML) is now part of the on-line
help. This information was previously supplied in the surf directory
in plain text and Microsoft Word documents.
8. Limit on runaway log window messages
Details:
In anuclim 5.0, processing a grid file in esoclim, bioclim or groclim
where many of the points lie outside the surface bounding box could
cause the log window messages to consume all the available memory on
your computer. The log window size is now limited to 5000 lines
(configurable). The log file is not truncated, and if the line limit
is exceeded a warning message is displayed.
9. bioclim log window and plots reorganised
Details:
The log window plots now scroll independently of the rest of the log
window, reducing the possibility that warnings or errors in the log
window will be missed.
10. Log windows cleared before each run
Details:
Messages from previous runs in a log window are now erased each time
you click the "Run" button.
11. On-line help now shows file pathname
Details:
The file pathname of the currently displayed HTML file is shown at the
top of the help browser. This enables you to tell where anuclim and
its documentation is installed on your computer.
12. On-line help starts web-browser for Internet links from user's guide.
Bug fixes:
1. Incorporates 5.0 patch 1
Details:
Fixed blank biomap preview when using a .bcp file derived
from a grid in UTM coordinates, and fixes biomap pointer position
display on win32.
2. Fixed problem with occasional spurious data point in cumulative
frequency plots.
Details:
There was a bug in the code that reads the .bio file to produce the
high-res cumulative frequency plots shown in the bioclim and "Show
parameter profiles" windows. It didn't always reliably detect the end
of the parameter values and sometimes read junk from the chunky
character plots and attempted to interpret that as parameter values.
The result of this was an extreme outlier in the plot and the error
message "Non-numeric fields in /some/file/name, first one at site
whatever" ('whatever' was usually blank).
3. Fixed an unreported bug that was returning garbage for points
outside a surface patch.
Details: Some climate variables (e.g. rainfall) don't have patches
covering all of the rectangle described by the overall country
bounding box. For these, the surface calculation code was returning
garbage values for points outside a surface but still within the
overall bounds. These cases now return the specified no-data value.
4. Fixed wasteful memory allocation for filenames.
Details: previous versions of bioclim, esoclim and groclim allocated
hundreds of kilobytes of memory for surface filenames that were never
used.
5. Fixed unreported potential bug with bioclim mask grid input.
Details: On some platforms, it was possible that bioclim would not
work with mask grid input. Its unlikely that this was ever discovered,
as it meant using only those surfaces that have 2 independent variables.
6. bcpcat now returns 0 exit status on normal exit.
7. Fixed "Save as EPS file" on bioclim log window.
Details: This used to give an error message 'bad screen distance' and
fail to write any EPS files.
8. Fixed floatgrid output from esoclim and bioclim when using grid
windows. Details: bioclim and esoclim were writing garbage when
floatgrid output was selected and a grid window was also specified.
9. Better completion estimates when using grid windows.
Details: The completion estimate indicated by bioclim, esoclim and
groclim now indicates the progress in relation to the grid window
area, not to the area of the grid down to the bottom of the window.
10. Handle no-sites case more gracefully in bioclim.
Details: bioclim used to crash after reading a file where no sites
were within surface limits. It now exits cleanly after displaying the
site count.
Incompatibilities with previous release:
1. Cannot use the radiation with rainfall surface supplied with anuclim
5.0 and earlier
Other changes:
1. Ignores the 'Sets' value in the surflist file
Details: The 'Sets' parameter in PART 3 of the surflist file 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.
Known problems:
none known
------------ released 5.1 for Solaris, Irix, Compaq Unix, ------------
----------- win32 on 21 December 2000 ------------