		TADAM  -  Excel add-in

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/).

Here is an implementation in the form of an Excel add-in. It was
developed by Gyula Gulyas at Olympic Resource Management. Gyula
currently works for JS Thrower and Associates.

Available separately:  MS Windows DLL and Palm versions.

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


CONTENTS
	Readme.txt	-  This file
	Tadam*.xla	-  The add-ins for the various species,
			   where * is Df, P, or S.
	Tadam*.dll	-  Dll files used by the add-ins
	Tadam*Demo.xls	-  Simple demo spreadsheets


DISCLAIMER: No warranties, expressed or implied, no claims of accuracy
or fitness for any purpose whatsoever. USE AT YOUR OWN RISK. 


INSTALLATION

1. Copy Tadam*.dll to the \Windows\System32 directory. It could also be
left in the directory you will be working in.

2. Open Excel. Go to Tools->Add-ins->Browse, and find and select
Tadam*.xla to register the add-in. You only need to do this once.

3. Open Tadam*Demo.xls and check that everything works.


USAGE

Use the functions in the "Tadam*" functions category. See Tadam*Demo.xls
for examples.  Details:

1. Growth

TADAM's state variables (i.e., the variables defining the stand at any
point in time) are top height, trees per hectare, and basal area.  Growth
is relative to top height, and height and age are connected by the site
index model.

tdpGrowTPH, tdpGrowBA:  These functions project trees per hectare and basal
area between two heights.

tdpHeight:  This function estimates top height from age and site index.
Age is age from planting.  The "time gain" is a horizontal shift of the
curves, useful for modelling unusual establishment or past weather
conditions (the negative of the "establishment delay" in TIPSY);
normally left at 0.

tdpAge: Inverse of the previous one; estimates age from top height and
site index.

2. Site utility functions

tdpSite:  Estimates site index from height and age.

tdpGain:  Calculates the time gain, given age, height and site.

3. Thinnings

tdpBAAfter:  Estimates the basal area from the trees per hectare after a
"typical" thinning.

tdpTPHAfter:  Estimates the trees per hectare from the basal area after a
"typical" thinning.

4. Outputs

tdpVolume:  Total volume, estimated from the current state variables.

tdpMerchVolume:  Merchantable volume, above a given dbh merchantability
limit.  It also excludes tops and stumps, so that the value even for a
zero limit is smaller than that given by tdVolume.

	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 and Gyula Gulyas

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

