deltametrics.plan.compute_channel_width

deltametrics.plan.compute_channel_width(channelmask, section=None, return_widths=False)

Compute channel width from a mask and section.

Compute the width of channels identified in a ChannelMask along a section. This function identifies the individual channels that are crossed by the section and computes width of each channel as the along-section distance.

In essence, this processing implicitly assumes that the section cuts each channel perpendicularly. We therefore recommend using this function with a ~dm.section.CircularSection type, unless you know what you are doing. By default, only the mean and standard deviation are returned, but the list of widths can be returned with return_widths=True.

Note

If a numpy array is passed for section, then the distance between points along the section is assumed to be ==1.

Parameters:

• channelmask (ChannelMask or ndarray) – The channel mask (i.e., should be binary) to compute channel widths from.

• section (BaseSection subclass, or ndarray) – The section along which to compute channel widths. If a Section type is passed, the .idx_trace attribute will be used to query the ChannelMask and determine widths. Otherwise, an Nx2 array can be passed, which specified the dim1-dim2 coordinate pairs to use as the trace.

• return_widths (bool, optional) – Whether to return (as third argument) a list of channel widths. Default is false (do not return list).

Returns:

• mean (float) – Mean of measured widths.

• stddev (float) – Standard deviation of measured widths.

• widths (list) – List of width measurements. Returned only if return_widths=True.

Examples

(Source code, png, hires.png)