badgrowth.tree {CTFS} | R Documentation

## Identify Trees for which DBH was Estimated for Biomass Calculation

### Description

Provides information for each tree for which a DBH was estimated when computing biomass. The DBHs and growth which was measured and estimated are provided in a dataframe.

### Usage

    badgrowth.tree(census1, census2, badgrowth = "meangrowth",
    dbhuse = "second", trim = c(-5, 75), recsize = 110, rounddown = FALSE)

### Arguments

`census1` | name dataframe of first census, must be of same length as `census2`
`census2` | name dataframe of second census, must be of same length as `census1`
`badgrowth` | parameter indicating how to handle trees with “bad” growth. “bad” growth is defined by `trim`. Valid values are: “keep” for retaining all bad growth rates without alteration, “nogrowth” for setting bad growths to 0, “meangrowth” for setting bad growth to the mean value of the dbh size class of the tree, “trim” for using the values of `trim` to set growth to maximum and minium as appropriate.
`dbhuse` | indicate which `dbh` to use for computing growth after implementing value of `badgrowth`. Valid values are: “second” for the dbh in the first census, “second” for dbh in the second census.
`trim` | minimum and maximum value of growth that is considered acceptable when `badgrowth` = “trim”
`recsize` | the maximum DBH (mmm) a recruit to the second census that is considered appropriate, a very site and species specific value that should be carefully determined by the user.
`rounddown` | how to round down values of growth for trees enumerated at Pasoh in 1990 due to a measurement standard. See `CTFS.datafiles`

### Details

This function computes the growth rate of each tree and determines if that growth rate is too high or too low based on user provided values, `trim`. If the growth rate is out of these bounds, a dbh is estimated, based on a user provided choice, `dbhuse`. These trees are returned in a dataframe for inspection to verify how well `biomass` is performing.

### Value

Returns a dataframe with a row for each tree with an estimated dbh. The dbh that is estimated is determined by the user.

`$tag` | an integer, tree identification number
`$sp` | character, species name code
`$gx` | a real number, location on East-West axis, in meters
`$gy` | a real number, location on North-South axis, in meters
`$dbh1` | a numeric vector, DBH in mm measured in year indicated
`$dbh2` | a numeric vector, DBH in mm measured in year indicated
`$realGR` | a real number, growth rate of tree without any elimination of extreme values
`$estdbh1` | a numeric vector, estimated DBH in mm measured in year indicated
`$estdbh2` | a numeric vector, estimated DBH in mm measured in year indicated
`$estlGR` | a real number, estimated growth rate of tree based on value of `badgrowth`
`$pom1` | a numeric vector, point of measurement, in m measured in year indicated
`$pom1` | a numeric vector, point of measurement, in m measured in year indicated
`$status1` | character, value indicating whether the tree is alive, dead or a recruit of that census.
`$status2` | character, value indicating whether the tree is alive, dead or a recruit of that census

### Note

The `estdbh` will depend on the value of `dbhuse`. `dbhuse` is the census dbh that is retained and used to compute `estdbh`.

### Author(s)

Pamela Hall

### See Also

`CTFS.biomass`

### Examples

    ## Not run:
    bci.badtrees <- badgrowth.tree(tst.bci90.full, tst.bci95.full,
            badgrowth="meangrowth",dbhuse="second")
    ## End(Not run)

[Package CTFS version 1.00 Index]