GeoThinneR 2.0.0
CRAN release: 2025-04-24
Breaking changes. This version is backward-incompatible with earlier versions of GeoThinneR.
Major changes
- Introduced a new
GeoThinned
S3 class to represent thinning results. All calls tothin_points()
now return aGeoThinned
object instead of a list of logical vectors or data frames. - Added new helper methods for
GeoThinned
objects:-
print()
andsummary()
for inspection. -
plot()
for visual comparison of thinned vs. original data. -
largest()
to retrieve the trial with the most retained points. -
largest_index()
to get the index of the best trial. -
get_trial()
to access specific trials.
-
- Redesigned
thin_points()
to return structured output and provide a more consistent user interface. - Output structure and behavior of all thinning methods has been updated for compatibility with the new object-oriented design.
- We have improved the thinning algorithms by implementing two new modifications of the kd-tree method: local kd-trees (
local_kd_tree
) and restricted search (k_estimation
). - The round and hashing method (
round_hash
) now is deprecated and has been removed from the package because of presenting lower accuracy than the other distance-based methods. - The thinning method argument
method
now includes the three main thinning strategies implemented in GeoThinneR for better understanding and usability. These are: “distance”, “grid”, and “precision”. - The
search_type
argument has been included for distance-based thinning (method = "distance"
) to select between the search algorithms (“brute”, “kd_tree”, “local_kd_tree”, and “k_estimation”). - The
n
argument for the grid-based thinning (method = "grid"
) now lets you specify the number of points to retain per grid cell.
Minor changes
- The
long_col
argument now is calledlon_col
for consistency with thelat_col
argument. - The default column names (
lon_col
and `lat_col’) have been changed from “decimalLongitude” and “decimalLatitude” to “lon” and “lat”. - Improved documentation, error messages, and reproducibility behavior across all functions.
- Updated the package vignette to reflect all changes.