BDAT20: BDAT 2.0 assortment function

In rBDAT: Implementation of BDAT Tree Taper Fortran Functions

BDAT 2.0 assortment function

Description

Calculates volumes and assortments for given tree/s.

Usage

BDAT20(
  BDATArtNr,
  D1,
  H1 = 0,
  D2 = 0,
  H2 = 0,
  H,
  lX = 0,
  Hkz = 0,
  Skz = 0,
  Az = 0,
  Hsh = 0,
  Zsh = 0,
  Zab = 0,
  Sokz = 1,
  NMaxFixLng = 0,
  FixLngDef = matrix(rep(0, length(BDATArtNr) * 4), ncol = 4),
  result = "raw"
)

Arguments

BDATArtNr	numeric, 1 <= spp <= 36, see getSpeciesCode
D1	numeric, first measured diameter [cm], usually in 1.3m
H1	numeric, height of first measured diameter [m]
D2	numeric, second measured diameter [cm], or form parameter, see buildTree.
H2	H2: numeric, height of second measured diameter [m], or form parameter, see buildTree.
H	numeric, tree height [m]
lX	length of unusable wood at stem foot [m], defaults to 0
Hkz	indicator for tree top, 0 - normal (default), 1 - Wipfelbruch, 2 - Gipfelbruch
Skz	indicator for stem type, defaults to 0, see buildTree
Az	minimum cutting diameter over bark [cm], defaults to 0, using tabulated data depending on DBH (not documented)
Hsh	usable stem height, defaults to 0, i.e. 0.7*H
Zsh	minimum cutting diameter under bark for stem wood [cm], defaults to 0, using tabulated data depending on DBH (not documented)
Zab	minimum cutting diameter under bark for top segment [cm], defaults to 0, i.e. 14cm under bark.
Sokz	type assortment calculation, 0 - no assortment, 1 - mid diameter (Mittenstärke), 2 - Heilbronner Sortierung, defaults to 1
NMaxFixLng	number of fixed length assortments at stem foot, defaults to 0 (no fixed length assortments, irrespective of FixLngDef)
FixLngDef	matrix of 4 * length(spp), having minimum cutting diameter, required assortment length, absolute and relative add-on
result	indicator about what information should be returned

Value

Using default value of result, which is 'raw', a list is returned keeping information about the input value and produced assortments - the unprocessed returns from the Fortran code.

See getAssortment for more details, as this function is internally called.

See Also

getAssortment for a more flexible function with a more convenient english name.

Examples

BDAT20(BDATArtNr = c(1, 1), D1 = c(30, 25), H = c(25, 20)) # returns long list
BDAT20(BDATArtNr = c(1, 1), D1 = c(30, 25), H = c(25, 20), result = "Vol")
# size class
BDAT20(BDATArtNr = c(1, 1), D1 = c(30, 25), H = c(25, 20), result = "Skl")
BDAT20(
  BDATArtNr = c(1, 1), D1 = c(30, 25), H = c(25, 20), NMaxFixLng = 1,
  result = "Fix"
)

rBDAT documentation built on Oct. 14, 2022, 5:07 p.m.