GCubeR (version 0.1.3)

add_c130_dbh: Add or compute c130 and dbh columns

Description

Ensures that both c130 (circumference at 1.30 m) and dbh (diameter at 1.30 m) are present in the dataset. If one is missing, it is computed from the other.

Usage

add_c130_dbh(data, output = NULL)

Value

The same data frame with both c130 and dbh columns. Note: the function does not modify the input data frame in place. To update your object, you must reassign the result, e.g.: data2 <- add_c130_dbh(data2)

Arguments

data

A data frame containing tree measurements. Must include at least one of the following columns:

• c130: circumference at 1.30 m (cm)

• dbh: diameter at 1.30 m (cm)

output

Optional file path where the resulting data frame should be exported as a CSV. If NULL (default), no file is written.

Details

• This function should be used at the very beginning of the workflow to ensure both c130 and dbh columns are available for subsequent functions.

• Conversion uses the formula: dbh = c130 / pi and c130 = dbh * pi.

• Units are centimeters (cm).

• If both columns are present, values are left unchanged.

Examples

data <- data.frame(c130 = c(31.4, 62.8))
data <- add_c130_dbh(data)

data2 <- data.frame(dbh = c(10, 20))
data2 <- add_c130_dbh(data2)