Analyze positioning performance from acoustic telemetry

Calculates performance metrics for fish positioning estimates to evaluate the quality and reliability of position estimates.

Usage

analyze_positioning_performance(positioning_results)

Arguments

positioning_results

A list returned by calculate_fish_positions containing position probabilities and summary statistics.

Value

A list containing:

by_fish_time

Data frame with performance metrics for each fish-time combination:

• max_prob - Maximum probability value in the position estimate

• mean_prob - Mean probability across all cells

• prob_95_quantile - 95th percentile of probability values

• n_high_prob_cells - Number of cells with probability > 0.1

• total_cells - Total number of cells with position estimates

overall

List with overall performance statistics:

• mean_max_prob - Average of maximum probabilities across all estimates

• mean_concentration - Average probability concentration ratio

• positioning_success_rate - Proportion of estimates with max_prob > 0.1

summary_stats

Summary statistics from the original positioning analysis

Details

Performance metrics help evaluate positioning quality:

• High max_prob values indicate confident position estimates

• Low concentration ratios suggest widely distributed probability

• Success rate shows proportion of meaningful position estimates

The 0.1 probability threshold for "high probability cells" and success rate can be adjusted based on the specific application and required confidence levels.

See also

calculate_fish_positions, plot_fish_positions

Examples

if (FALSE) {
# Calculate positions
results <- calculate_fish_positions(station_detections, distances, stations)

# Analyze performance
performance <- analyze_positioning_performance(results)

# View overall performance
performance$overall

# View detailed metrics
head(performance$by_fish_time)

# Get summary statistics
performance$summary_stats
}