echopype.commongrid.compute_NASC(ds_Sv: Dataset, range_bin: str = '10m', dist_bin: str = '0.5nmi', method: str = 'map-reduce', closed: Literal['left', 'right'] = 'left', **flox_kwargs) Dataset#

Compute Nautical Areal Scattering Coefficient (NASC) from an Sv dataset.


A dataset containing Sv data. The Sv dataset must contain latitude, longitude, and depth as data variables.

range_binstr, default ‘10m’

bin size along depth in meters (m).

dist_binstr, default ‘0.5nmi’

bin size along distance in nautical miles (nmi).

method: str, default ‘map-reduce’

The flox strategy for reduction of dask arrays only. See flox documentation for more details.

closed: {‘left’, ‘right’}, default ‘left’

Which side of bin interval is closed.


Additional keyword arguments to be passed to flox reduction function.


A dataset containing NASC


The NASC computation implemented here generally corresponds to the Echoview algorithm PRC_NASC # noqa The difference is that since in echopype masking of the Sv dataset is done explicitly using functions in the mask subpackage, the computation only involves computing the mean Sv and the mean height within each cell, where some Sv “pixels” may have been masked as NaN.

In addition, in echopype the binning of pings into individual cells is based on the actual horizontal distance computed from the latitude and longitude coordinates of each ping in the Sv dataset. Therefore, both regular and irregular horizontal distance in the Sv dataset are allowed. This is different from Echoview’s assumption of constant ping rate, vessel speed, and sample thickness when computing mean Sv (see # noqa