output_dir is now a required argument of
import_sample_concentric_format1_raw_to_pre(),
import_sample_concentric_format2_raw_to_pre() and
import_standwise_relascope_format1_raw_to_pre(). It used to default to
input_path, so the preprocessed files were written into the folder the raw
data came from -- a directory the caller never named, and one that may well
be read-only. A call without the argument now stops before anything is read,
with a message saying what to pass. The argument keeps its position, so
positional calls are unaffected.
A coordinate-system declaration that spells one and the same system in more
than one way is no longer mistaken for two. Point files carrying both 4326
and EPSG:4326 do occur; they were refused as ambiguous and asked for a
coord_sys argument the file did not need. Declarations are now resolved
before they are compared. Two genuinely different systems, and values that
cannot be read at all, are still refused.
The ex1 example data carried the angle and the distance the wrong way round
on plot 5, which put six trees between 92 and 326 m from their plot centre.
Corrected in data_ex1_sample_raw_trees and in the matching file under
inst/extdata. Only the tree positions change; every value the converter
derives from these data is unchanged.
The examples of the PDF output functions run again. They had been hidden
behind \dontrun{}, where nothing executes them and nothing notices when
they decay: one called an object that was never defined, another carried a
literal ... where a call belonged, and several ended in a viewer command
that only works on macOS. They are under \donttest{} now, write to
tempdir(), and are executed by example().
Several examples were computing the same thing repeatedly. One help page ran the same increment five times over, another ran a full increment chain on what is a page about data. They show what they are about, and no more.
pull_trees() documents what it returns: the class, what a row is, and the
two columns it adds rather than carries over from the inventory plots.
The Description field cites Kangas and Maltamo (2006), a standard work on forest inventory methods.
The checks of version 3.0.0 took longer than is welcome on the CRAN check farm. Tests and examples now do far less repeated work, and the check time is down by about a third.
fill_heights_back() no longer spreads small inventories over a cluster.
Every worker receives a copy of the whole inventory, and below a few hundred
plots that transfer costs far more than the work itself -- on a ten-plot
inventory the sequential run is thirty times faster. Inventories large enough
to benefit are unaffected.
The two interim stages of the repeated-survey increment are shipped as data:
data_ex3_increment_matched and data_ex3_increment_fills. Examples of the
later steps start from them instead of rebuilding the chain that leads up to
them, which also puts the subject of each example on its first line. See
?data_ex3_increment_interim.
The table examples start from data_ex3_sample_trees_essentials and
therefore group species the BaySF way, as the increment documentation does
throughout.