sep.quadinfo {CTFS}R Documentation

Creates a Vector of Quadrate Characteristics for each Tree in a Dataset

Description

sep.quadinfo creates a vector of the same length as the input data file that contains a categorical value that can be found in the bciquad.info data file. This vector can be used with mortality, growth, recruitment, abundance and other functions to provide for dynamic rates for habitat, quad, etc. This function can also be used as a template for writing other functions that use "table-lookup": using a key variable from the data file to look up the value of a column on a table file based on the row with the key variable value. This function is also used to create the data file structured needed for density dependence analysis, see CTFS.densdepend and neighbordens.1sp

Usage

sep.quadinfo(census1, table.in, by.col = "hab", 
   gridsize = 20, plotdim = c(1000,500))

Arguments

census1 tree data file, must be a data.frame
table.in table file, must be a data.frame and is usually the species information file e.g. bciquad.info
by.col the column name of the variable that is to be used for classifying the trees into groups.
gridsize dimension of square quadrate, side length in meters
plotdim plot dimensions, x,y lengths in meters

Details

The table.in file must contain a variable with the same name as a variable on the data.in file. The table.in file is composed of rows of quadrates with information about each quadrate including its habitat category under some given scheme of classification. The gx and gy value of the tree is used to locate the quadrate number (using gxgy.to.index. Then the quadrate number is used is used to locate a row in table.in and then the value returned is the column with the habitat value for that quadrate.

Note that this function can be used to extract any value from bciquad.info for grouping trees. More variables can be added to bciquad.info for grouping trees.

Use this function with by.col = “quad” to create a vector containing the quadrate number of each tree. This can then be used with sep.vct.data to create the list of dataframes of quadrates containing tree data.

Value

sep.quadinfo returns a vector of values. The mode of the value depends on what column is extracted from table.in.

Author(s)

Pamela Hall

See Also

CTFS.utilities, CTFS.quadfunctions, CTFS.datafiles

Examples

## Not run: 
1. Default use of sep.quadinfo()
hab.vct <- sep.quadinfo(tst.bci90.full,bciquad.info)
length(hab.vct)

2. Using sep.quadinfo for calculation of mortality and recruitment by 
habitat
hab.vct <- sep.quadinfo(tst.bci90.full,bciquad.info)
mort.hab.out <- mortality(bci90.full,split1=hab.vct)
rec.hab.out <- recruit(bci90.full,split1=hab.vct)
## End(Not run)

[Package CTFS version 1.00 Index]