Get list of neighbours based on metric in image
#include "dip_neighbourlist.h"
dip_Error dip_NeighbourListMakeImage ( metric, coords, distance, resources )
A list coords is created with the relative coordinates to the neighbours of a pixel in an image, with dimensionality as in metric. metric is an image that specifies the distance to each of the neighbours. This image must be odd in size, the centre pixel is the origin of the neighbourhood. Any pixel with value 0 is not considered part of the neighbourhood. distance contains the distance to each of the neighbours in coords.
Distances between two pixels are taken to be the Euclidean distance. There are better metrics described in the literature for small neighbourhoods, that yield a more isotropic measure when compounded over longer distances. These are not implemented in this function.
coords and distance are allocated and tracked in resources.
Data type | Name | Description |
dip_Image | metric | Image whose pixel values indicate the neighbour distance |
dip_CoordinateArray * | coords | Output neighbour coordinates |
dip_FloatArray * | distance | Output distances to neighbours |
dip_Resources | resources | Resources tracking structure. See ResourcesNew |
NeighbourListMake, NeighbourListMakeChamfer, NeighbourListMakeImage, NeighbourListToIndices, NeighbourIndicesListMake