Update DBH estimation in ITSMe

.Rbuildignore

@@ -7,3 +7,5 @@
 ^docs$
 ^pkgdown$
 ^CITATION\.cff$
+^\.positai$
+^\.claude$

.gitignore

@@ -6,3 +6,4 @@
 
 
 docs
+.positai

DESCRIPTION

@@ -17,13 +17,13 @@ Description: With this package you can obtain structural metrics from individual
 License: MIT + file LICENSE
 Encoding: UTF-8
 Roxygen: list(markdown = TRUE)
-RoxygenNote: 7.3.3
 Imports: 
     alphashape3d,
     concaveman,
     data.table,
     ggforce,
     ggplot2,
+    nabor,
     graphics,
     lidR,
     nabor,
@@ -47,3 +47,4 @@ Suggests:
     testthat (>= 3.0.0)
 VignetteBuilder: knitr
 Config/testthat/edition: 3
+Config/roxygen2/version: 8.0.0

NEWS.md

@@ -0,0 +1,19 @@
+# ITSMe 2.0.0.9000
+
+## DBH estimation and quality control
+
+- Added more robust DBH estimation through the `how`
+  argument. The original ITSMe behaviour can be obtained with `how = "mean"`;
+  `how = "median"` (new default) uses the median point-to-centre radius; and numeric values
+  use a trimmed mean of the point-to-centre radii.
+- Added DBH quality-control metrics to `diameter_slice_pc()` and `dbh_pc()`:
+  `arc_coverage` and `inner_circle_empty`.
+- Updated `summary_basic_pointcloud_metrics_pertree()` and
+  `summary_basic_pointcloud_metrics()` so DBH quality-control metrics are
+  included in the returned summary data frame when `"stem diameter"` is
+  calculated.
+- Updated the lower-trunk fallback logic in `dbh_pc()` so that a well-supported
+  direct DBH slice is less likely to be overwritten because of noisy or
+  incomplete lower-stem points.
+- Documented the new DBH estimation options and quality-control metrics in the
+  main ITSMe vignette.