1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
// Sylva: LiDAR processing for forest ecology and remote sensing research.
// Copyright (C) 2026 Tim Devereux, The University of Queensland.
// Free software under the GNU General Public License v3.0 or later;
// see the LICENSE file. There is no warranty, to the extent permitted by law.
//! Change detection between two epochs of one plot.
//!
//! The principle throughout is to separate real change from noise and from
//! not having seen something: every change carries its uncertainty or level
//! of detection, and whatever the data cannot support is labelled as such
//! rather than reported as change.
//!
//! * [`epochs`]: the second epoch aligned onto the first on stable features
//! (stems and ground), with the uncertainty of that alignment;
//! * [`trees`]: trees matched between epochs (survivors, deaths, recruits)
//! and their increments with a minimum detectable increment;
//! * [`summary`]: plot-level growth, mortality and recruitment with Monte
//! Carlo intervals;
//! * [`provenance`]: the settings each epoch was processed with, compared;
//! * [`synthetic`]: two scanned epochs of a synthetic plot with known
//! changes, the reference every function here is validated against;
//! * [`points`]: cloud-to-cloud and M3C2 distances, rasters of difference;
//! * [`voxels`]: voxel occupancy change from two ray-traced grids;
//! * [`qsm`]: QSMs compared, branch by branch, where both were measured.
/// `v > 0`, false for NaN.
pub
/// `v >= 0`, false for NaN.
pub