sidescanpy.grids.resolution

Recommended grid / chip resolution from a section’s native sampling.

Contents

recommend_resolution

Half the finer of the median ping spacing and the sample interval, in metres.

sidescanpy.grids.resolution.recommend_resolution(ds)

Half the finer of the median ping spacing and the sample interval, in metres.

Oversamples past the finest native axis (every real sample on that axis lands in its own cell) and leaves the coarser axis to be interpolated. When the sample interval is unavailable (no slant_range_m) this is half the ping spacing.

Parameters:

dsxr.Dataset or PingGeometry

A georeferenced section (measured with sidescanpy.analysis.measure_ping_geometry()), or an already measured PingGeometry.

Returns:

float or None

Resolution in metres, or None when ping spacing can’t be measured (fewer than 2 pings, or no along-track navigation).