Skip to contents

Loading & Preparation

Import raw GPR root CSV data and prepare coordinates.

load
Load and Prepare Root Data
load_root_csv()
Load GPR root CSV file
split_survey_column()
Split survey column
convert_coordinates()
Convert coordinate columns to numeric
prepare_root_data()
Load and prepare root data from CSV

Segment Creation

Convert root node points into spatial line segments.

segments
Create Root Segments
points_to_sf()
Convert root points to sf object
make_segments()
Build line segments between consecutive root nodes
process_single_root()
Process a single root into segments
process_all_roots()
Process all roots into segments

Segment Metrics

Calculate geometric properties for each root segment.

segment_metrics
Segment Geometric Metrics
calc_segment_length()
Calculate segment 3D length
calc_segment_azimuth()
Calculate segment azimuth
calc_inclination()
Calculate segment inclination angle
classify_slope()
Classify segment slope
calc_all_segment_metrics()
Calculate all segment metrics at once

Tree Joining

Link root segments to tree stem positions.

trees
Join Roots with Tree Locations
join_nearest_tree()
Join root segments to nearest tree
propagate_tree_name()
Propagate tree name to all segments of the same root

Root & Tree Metrics

Aggregate segment data at root and tree level.

root_metrics
Root and Tree Level Metrics
calc_root_length()
Calculate total length per root
calc_tree_length()
Calculate total root length per tree
assign_depth_class()
Assign depth class
calc_depth_stats()
Calculate depth statistics per tree
count_orientations()
Count segment orientations per tree

2D Polygons

Convex hull polygons representing root system spread.

polygons
2D Root System Polygons
build_convex_hulls()
Build convex hull polygons per tree
calc_hull_area()
Calculate hull area and extent

3D Volume

Estimate 3D bounding volume of root systems.

volume
3D Root System Volume
calc_real_z()
Calculate real vertical range per tree
calc_range_3d()
Calculate 3D bounding volume

Overlap & Distance

Inter-tree competition and root-to-trunk distances.

overlap
Root System Overlap Analysis
make_tree_pairs()
Generate unique tree pairs
calc_pair_overlap()
Calculate overlap between two geometries
calc_all_overlaps()
Calculate all pairwise root system overlaps
distance
Root-to-Trunk Distance
merge_root_segments()
Merge root segments into single geometries
calc_dist_to_trunk()
Calculate distance from each root to its tree trunk

Pipeline Wrappers

Convenience functions chaining multiple steps.

pipeline
Processing Pipelines
build_segments_with_metrics()
Full segment pipeline
summarise_tree_roots()
Tree-level summary pipeline
GRootR GRootR-package
GRootR: 3D Visualization and Statistical Analysis of Tree Roots from GPR