			TADAM FOR PALM

WHAT IS IT

A set of growth models for British Columbia plantated forest stands:
TADAM-df for Coastal Douglas-fir, TADAM-p for Interior lodgepole pine,
and TADAM-s for Interior white spruce. Based on a stand-level dynamical
system approximation to output from TASS/TIPSY (K.J. Mitchell, "Dynamics
and Simulated Yield of Douglas-fir", Forest Science Monograph 17, 1975
-- www.for.gov.bc.ca/research/tass/).

This implementation is for PDAs running the Palm OS. The programs can
also be run on Windows, Linux or Mac using the Palm Simulator and/or
Emulator.

Available separately:  MS Windows DLL and Excel add-in versions.

More info, latest versions, etc., at 
http://www.unbc.ca/forestry/forestgrowth/tadam.


CONTENTS
	Readme.txt	-  This file
	Tadam*.prc	-  The Palm OS programs
	MathLib.prc	-  Required mathematical library
	palsim.htm	-  Instructions for the Palm Simulator
	tadam.ico	-  Windows icon

DISCLAIMER: No warranties, expressed or implied, no claims of accuracy
or fitness for any purpose whatsoever. It is not impossible that your
Palm could crash, requiring a reset (push the reset button on the back,
and politely report the problem to the author). Normally there is no
data loss, but anyway, it is wise to BACKUP YOUR DATA before trying
this or any other software. USE AT YOUR OWN RISK. 


INSTALLATION

1) Palm OS: Should run on any hand-held using PalmOS version 3.1 or
higher: Palm (not Pilot or PalmPilot), IBM WorkPad, Handspring Visor,
Sony Cli, TRG, Symbol, Kyocera Smartphone, etc. Install TadamDf.prc,
TadamP.prc, and/or TadamS.prc. Also the math library MathLib.prc if you
do not already have it (some Visor models have MathLib included in ROM).

Note: MathLib is a public domain mathematical library used by a number
of PALM OS applications, developed by Rick Huebner (rhuebner@radiks.net,
http://www.radiks.net/~rhuebner/mathlib.html).

2) MS Windows (95 or above):

Install with the Palm Simulator, following the instructions in palmsim.htm. 

Alternatively, install the Palm OS Emulator from
http://www.unbc.ca/forestry/forestgrowth/tadam/Emulator.zip, according
to Instructions.txt in there. For the setting-up you will need access to
a Palm OS hand-held device, or a ROM image file from another source.

3) Unix/Linux, Mac: Install the appropriate version of the Palm OS
Emulator, from http://www.palmos.com/dev/tech/tools/emulator/. Follow
the instructions there to obtain a ROM image. Load Tadam*.prc and
MathLib.prc.


USAGE

Should be "obvious"  :-)
Se the help in the Info menu.  Menus are accessed through the round icon
at the bottom-left of the screen.

Output saved to the Memo Pad can be uploaded to the PC or entered into
spreadsheets or other Palm programs (possibly through the clipboard).
Note that in the Emulator the Palm and Windows clipboards are shared,
but apparently there is no access to the Palm clipboard from Windows in
the Simulator.

	WARNING:  The TIPSY white spruce data base used to develop
	this model contained only 30 TASS simulations, unthinned or
	thinned at 4m top height.  Other projections are essentially
	a figment of TADAM's imagination; use with extreme care!

Please send comments and report any problems to garcia@unbc.ca.


                  CONDITIONS

Copyright (c) 2002, 2003 Oscar Garcia

Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the
"Software"), to use, copy, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following conditions:

a) Modification of the Software is not allowed.

b) The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.



		VERSIONS HISTORY

	TADAM-df  --  Douglas-fir
1.0	15/10/01 - First public release.
1.1	26/11/01 - Fixed division by zero when B=0 in volumes.
1.2	11/01/02 - The code in the "engine" was tidied up, and the
	parameters re-estimated to better conform to the publication.
	Differences of under 1% compared to previous versions might
	be seen.

	TADAM-p  --  Lodgepole pine
1.0	22/08/02 - First public release.
1.1	24/04/03 - Fixed bug in the thinning function. The error
	caused an underestimate for basal areas after thinning of
	around 8%.
	Full independent check of the computer code against data to
	ensure no more surprises!
	Changed left-over references to Douglas-fir in the help files.


	TADAM-s  --  White spruce
1.0	24/08/02 - First public release.
	Changes to distribution file packaging, documentation, and
	web site.


--
Oscar Garcia  -  Professor, FRBC / West Fraser Endowed Chair
in Forest Growth and Yield
University of Northern British Columbia
3333 University Way,  Prince George, B.C.,  Canada V2N 4Z9
Fax +1(250) 960-5538.  Tel. +1(250) 960-5004
garcia@unbc.ca  -  http://web.unbc.ca/~garcia

