oevislib_net  0.14.3.0
Loading...
Searching...
No Matches
Edge Detection 1D

Classes

class  oevislib_net.ComputerVision.EdgeDetection1D.SamplingParams
 Groups all the parameters used to control the image sampling along a path. More...
class  oevislib_net.ComputerVision.EdgeDetection1D.EdgeScanParams
 Groups all the parameters used to control the edge scanning process. More...
class  oevislib_net.ComputerVision.EdgeDetection1D.RidgeScanParams
 Groups all the parameters used to control the ridge scanning process. More...
class  oevislib_net.ComputerVision.EdgeDetection1D.StripeScanParams
 Groups all the parameters used to control the stripe scanning process. More...
class  oevislib_net.ComputerVision.EdgeDetection1D.LocalBlindness
 Contains parameters used in the 1D scanning process to prevent the detection of weak edges in the vicinity of stronger ones. More...
class  oevislib_net.ComputerVision.EdgeDetection1D.Edge1D
 Groups all the parameters used to describe an edge found during the 1D scanning process. More...
class  oevislib_net.ComputerVision.EdgeDetection1D.Ridge1D
 Groups all the parameters used to describe a ridge found during the 1D scanning process. More...
class  oevislib_net.ComputerVision.EdgeDetection1D.Stripe1D
 Groups all the parameters used to describe a stripe found during the 1D scanning process. More...
class  oevislib_net.ComputerVision.EdgeDetection1D.Gap1D
 Groups all the parameters used to describe a gap between two 1D structures. More...
class  oevislib_net.ComputerVision.EdgeDetection1D.ScanTemplate
 Structure created expanding a scanning path along its normal direction, used to speed up the 1D scanning process. More...

Functions

static Array< Edge1Doevislib_net.ComputerVision.EdgeDetection1D.EdgeDetection1D.FindEdges1D (Image inImage, Path inScanPath, Optional< UCS2D > inScanPathAlignment=null, int inScanWidth=5, SamplingParams inSamplingParams=null, EdgeScanParams inEdgeScanParams=null, float inMinDistance=0.0f, Optional< float > inMaxDistance=null, Optional< LocalBlindness > inLocalBlindness=null, Optional< Array< Gap1D > > outGaps=null, Optional< Path > outAlignedScanPath=null, Optional< Profile > outBrightnessProfile=null, Optional< Profile > outResponseProfile=null, Optional< Array< Path > > outSamplingPoints=null, Optional< float > outSamplingStep=null)
 Finds the points in which the image brightness change rapidly, along a scanning path.
static Array< Edge1Doevislib_net.ComputerVision.EdgeDetection1D.EdgeDetection1D.FindEdges1D (Image inImage, ScanTemplate inScanTemplate, EdgeScanParams inEdgeScanParams=null, float inMinDistance=0.0f, Optional< float > inMaxDistance=null, Optional< LocalBlindness > inLocalBlindness=null, Optional< Array< Gap1D > > outGaps=null, Optional< Profile > outBrightnessProfile=null, Optional< Profile > outResponseProfile=null)
 Finds the points in which the image brightness change rapidly, along a scanning path.
static Array< Ridge1Doevislib_net.ComputerVision.EdgeDetection1D.EdgeDetection1D.FindRidges1D (Image inImage, Path inScanPath, Optional< UCS2D > inScanPathAlignment=null, int inScanWidth=5, SamplingParams inSamplingParams=null, RidgeScanParams inRidgeScanParams=null, float inMinDistance=0.0f, Optional< float > inMaxDistance=null, Optional< LocalBlindness > inLocalBlindness=null, Optional< Array< Gap1D > > outGaps=null, Optional< Path > outAlignedScanPath=null, Optional< Profile > outBrightnessProfile=null, Optional< Profile > outFirstDerivativeProfile=null, Optional< Profile > outSecondDerivativeProfile=null, Optional< Array< Path > > outSamplingPoints=null, Optional< float > outSamplingStep=null)
 Finds the local maxima of the brightness profile along a scanning path.
static Array< Ridge1Doevislib_net.ComputerVision.EdgeDetection1D.EdgeDetection1D.FindRidges1D (Image inImage, ScanTemplate inScanTemplate, RidgeScanParams inRidgeScanParams=null, float inMinDistance=0.0f, Optional< float > inMaxDistance=null, Optional< LocalBlindness > inLocalBlindness=null, Optional< Array< Gap1D > > outGaps=null, Optional< Profile > outBrightnessProfile=null, Optional< Profile > outFirstDerivativeProfile=null, Optional< Profile > outSecondDerivativeProfile=null)
 Finds the local maxima of the brightness profile along a scanning path.
static Array< Stripe1Doevislib_net.ComputerVision.EdgeDetection1D.EdgeDetection1D.FindStripes1D (Image inImage, Path inScanPath, Optional< UCS2D > inScanPathAlignment=null, int inScanWidth=5, SamplingParams inSamplingParams=null, StripeScanParams inStripeScanParams=null, float inMinGapWidth=0.0f, Optional< float > inMaxGapWidth=null, Optional< LocalBlindness > inLocalBlindness=null, Optional< Array< Gap1D > > outGaps=null, Optional< Path > outAlignedScanPath=null, Optional< Profile > outBrightnessProfile=null, Optional< Profile > outResponseProfile=null, Optional< Array< Path > > outSamplingPoints=null, Optional< float > outSamplingStep=null)
 Finds segments included between two edges of opposite transition.
static Array< Stripe1Doevislib_net.ComputerVision.EdgeDetection1D.EdgeDetection1D.FindStripes1D (Image inImage, ScanTemplate inScanTemplate, StripeScanParams inStripeScanParams=null, float inMinGapWidth=0.0f, Optional< float > inMaxGapWidth=null, Optional< LocalBlindness > inLocalBlindness=null, Optional< Array< Gap1D > > outGaps=null, Optional< Profile > outBrightnessProfile=null, Optional< Profile > outResponseProfile=null)
 Finds segments included between two edges of opposite transition.
static ScanTemplate oevislib_net.ComputerVision.EdgeDetection1D.EdgeDetection1D.BuildScanTemplate (ImageFormat inImageFormat, Path inScanPath, Optional< UCS2D > inScanPathAlignment=null, int inScanWidth=5, SamplingParams inSamplingParams=null, Optional< Path > outAlignedScanPath=null, Optional< Array< Path > > outSamplingPoints=null, Optional< float > outSamplingStep=null)
 Expands the scan path into a scanning template used to speed up 1D struct detection.
static void oevislib_net.ComputerVision.EdgeDetection1D.EdgeDetection1D.TranslateScanTemplate (ScanTemplate ioScanTemplate, Vector2D inDelta, bool inInverse=false, Optional< Array< Path > > outSamplingPoints=null)
 Translates the scan template along the provided vector.

Detailed Description

Function Documentation

◆ BuildScanTemplate()

ScanTemplate oevislib_net.ComputerVision.EdgeDetection1D.EdgeDetection1D.BuildScanTemplate ( ImageFormat inImageFormat,
Path inScanPath,
Optional< UCS2D > inScanPathAlignment = null,
int inScanWidth = 5,
SamplingParams inSamplingParams = null,
Optional< Path > outAlignedScanPath = null,
Optional< Array< Path > > outSamplingPoints = null,
Optional< float > outSamplingStep = null )
inlinestatic

Expands the scan path into a scanning template used to speed up 1D struct detection.

If the provided path is degenerate (i.e. its length is equal to zero) the function returns an empty ScanTemplate object.

Parameters
inImageFormatMetadata of the input image.
inScanPathPath along which the edges are searched. The path should contain at least 2 points.
inScanPathAlignmentCoordinate system of the input scan path.
inScanWidthWidth of the scan path [pixels]. Range [1, +inf].
inSamplingParamsParameters used to control the sampling process.
outAlignedScanPathInput scan path aligned to the provided coordinate system.
outSamplingPointsArray of the paths extracted from the scan path expanded with the provided width. Each path contribute to a single sampling point in the brightness profile.
outSamplingStepDistance between consecutive sampling points.
Returns
The computed scan template object.

◆ FindEdges1D() [1/2]

Array< Edge1D > oevislib_net.ComputerVision.EdgeDetection1D.EdgeDetection1D.FindEdges1D ( Image inImage,
Path inScanPath,
Optional< UCS2D > inScanPathAlignment = null,
int inScanWidth = 5,
SamplingParams inSamplingParams = null,
EdgeScanParams inEdgeScanParams = null,
float inMinDistance = 0::0f,
Optional< float > inMaxDistance = null,
Optional< LocalBlindness > inLocalBlindness = null,
Optional< Array< Gap1D > > outGaps = null,
Optional< Path > outAlignedScanPath = null,
Optional< Profile > outBrightnessProfile = null,
Optional< Profile > outResponseProfile = null,
Optional< Array< Path > > outSamplingPoints = null,
Optional< float > outSamplingStep = null )
inlinestatic

Finds the points in which the image brightness change rapidly, along a scanning path.

This overload build the scan template at each function call. When the parameters used to build the scan template do not change in a loop, build the scan template separately and used the other overload.

Parameters
inImageInput image. It cannot be empty.
inScanPathPath along which the edges are searched. The path should contain at least 2 points.
inScanPathAlignmentCoordinate system of the input scan path.
inScanWidthWidth of the scan path [pixels]. Range [1, +inf].
inSamplingParamsParameters used to control the sampling process.
inEdgeScanParamsParameters used to control the edge scanning process.
inMinDistanceWhen two consecutive edges have a distance lower than this value, the second one is neglected. Range [0, +inf].
inMaxDistanceWhen two consecutive edges have a distance higher than this value, the second one is neglected. Range [0, +inf].
inLocalBlindnessParameters used to prevent the detection of weak edges nearby strong edges.
outGapsArray containing the gaps between the found edges.
outAlignedScanPathInput scan path aligned to the provided coordinate system.
outBrightnessProfileProfile containing the image sampled along the input scan path.
outResponseProfileFirst derivative of the brightness profile.
outSamplingPointsArray of the paths extracted from the scan path expanded with the provided width. Each path contribute to a single sampling point in the brightness profile.
outSamplingStepDistance between consecutive sampling points.
Returns
Array containing all the found edges.

◆ FindEdges1D() [2/2]

Array< Edge1D > oevislib_net.ComputerVision.EdgeDetection1D.EdgeDetection1D.FindEdges1D ( Image inImage,
ScanTemplate inScanTemplate,
EdgeScanParams inEdgeScanParams = null,
float inMinDistance = 0::0f,
Optional< float > inMaxDistance = null,
Optional< LocalBlindness > inLocalBlindness = null,
Optional< Array< Gap1D > > outGaps = null,
Optional< Profile > outBrightnessProfile = null,
Optional< Profile > outResponseProfile = null )
inlinestatic

Finds the points in which the image brightness change rapidly, along a scanning path.

Parameters
inImageInput image. It cannot be empty.
inScanTemplateThe scan path expanded to some width. The object must be pre-computed using the buildScanTemplate function.
inEdgeScanParamsParameters used to control the edge scanning process.
inMinDistanceWhen two consecutive edges have a distance lower than this value, the second one is neglected. Range [0, +inf].
inMaxDistanceWhen two consecutive edges have a distance higher than this value, the second one is neglected. Range [0, +inf].
inLocalBlindnessParameters used to prevent the detection of weak edges nearby strong edges.
outGapsArray containing the gaps between the found edges.
outBrightnessProfileProfile containing the image sampled along the input scan path.
outResponseProfileFirst derivative of the brightness profile.
Returns
Array containing all the found edges.

◆ FindRidges1D() [1/2]

Array< Ridge1D > oevislib_net.ComputerVision.EdgeDetection1D.EdgeDetection1D.FindRidges1D ( Image inImage,
Path inScanPath,
Optional< UCS2D > inScanPathAlignment = null,
int inScanWidth = 5,
SamplingParams inSamplingParams = null,
RidgeScanParams inRidgeScanParams = null,
float inMinDistance = 0::0f,
Optional< float > inMaxDistance = null,
Optional< LocalBlindness > inLocalBlindness = null,
Optional< Array< Gap1D > > outGaps = null,
Optional< Path > outAlignedScanPath = null,
Optional< Profile > outBrightnessProfile = null,
Optional< Profile > outFirstDerivativeProfile = null,
Optional< Profile > outSecondDerivativeProfile = null,
Optional< Array< Path > > outSamplingPoints = null,
Optional< float > outSamplingStep = null )
inlinestatic

Finds the local maxima of the brightness profile along a scanning path.

This overload build the scan template at each function call. When the parameters used to build the scan template do not change in a loop, build the scan template separately and used the other overload.

Parameters
inImageInput image. It cannot be empty.
inScanPathPath along which the ridges are searched. The path should contain at least 2 points.
inScanPathAlignmentCoordinate system of the input scan path.
inScanWidthWidth of the scan path [pixels]. Range [1, +inf].
inSamplingParamsParameters used to control the sampling process.
inRidgeScanParamsParameters used to control the ridge scanning process.
inMinDistanceWhen two consecutive ridges have a distance lower than this value, the second one is neglected. Range [0, +inf].
inMaxDistanceWhen two consecutive ridges have a distance higher than this value, the second one is neglected. Range [0, +inf].
inLocalBlindnessParameters used to prevent the detection of weak ridges nearby strong ridges.
outGapsArray containing the gaps between the found ridges.
outAlignedScanPathInput scan path aligned to the provided coordinate system.
outBrightnessProfileProfile containing the image sampled along the input scan path.
outFirstDerivativeProfileFirst derivative of the brightness profile.
outSecondDerivativeProfileSecond derivative of the brightness profile.
outSamplingPointsArray of the paths extracted from the scan path expanded with the provided width. Each path contribute to a single sampling point in the brightness profile.
outSamplingStepDistance between consecutive sampling points.
Returns
Array containing all the found ridges.

◆ FindRidges1D() [2/2]

Array< Ridge1D > oevislib_net.ComputerVision.EdgeDetection1D.EdgeDetection1D.FindRidges1D ( Image inImage,
ScanTemplate inScanTemplate,
RidgeScanParams inRidgeScanParams = null,
float inMinDistance = 0::0f,
Optional< float > inMaxDistance = null,
Optional< LocalBlindness > inLocalBlindness = null,
Optional< Array< Gap1D > > outGaps = null,
Optional< Profile > outBrightnessProfile = null,
Optional< Profile > outFirstDerivativeProfile = null,
Optional< Profile > outSecondDerivativeProfile = null )
inlinestatic

Finds the local maxima of the brightness profile along a scanning path.

Parameters
inImageInput image. It cannot be empty.
inScanTemplateThe scan path expanded to some width. The object must be pre-computed using the buildScanTemplate function.
inRidgeScanParamsParameters used to control the ridge scanning process.
inMinDistanceWhen two consecutive edges have a distance lower than this value, the second one is neglected. Range [0, +inf].
inMaxDistanceWhen two consecutive edges have a distance higher than this value, the second one is neglected. Range [0, +inf].
inLocalBlindnessParameters used to prevent the detection of weak ridges nearby strong ridges.
outGapsArray containing the gaps between the found edges.
outBrightnessProfileProfile containing the image sampled along the input scan path.
outFirstDerivativeProfileFirst derivative of the brightness profile.
outSecondDerivativeProfileSecond derivative of the brightness profile.
Returns
Array containing all the found ridges.

◆ FindStripes1D() [1/2]

Array< Stripe1D > oevislib_net.ComputerVision.EdgeDetection1D.EdgeDetection1D.FindStripes1D ( Image inImage,
Path inScanPath,
Optional< UCS2D > inScanPathAlignment = null,
int inScanWidth = 5,
SamplingParams inSamplingParams = null,
StripeScanParams inStripeScanParams = null,
float inMinGapWidth = 0::0f,
Optional< float > inMaxGapWidth = null,
Optional< LocalBlindness > inLocalBlindness = null,
Optional< Array< Gap1D > > outGaps = null,
Optional< Path > outAlignedScanPath = null,
Optional< Profile > outBrightnessProfile = null,
Optional< Profile > outResponseProfile = null,
Optional< Array< Path > > outSamplingPoints = null,
Optional< float > outSamplingStep = null )
inlinestatic

Finds segments included between two edges of opposite transition.

This overload build the scan template at each function call. When the parameters used to build the scan template do not change in a loop, build the scan template separately and used the other overload.

Parameters
inImageInput image. It cannot be empty.
inScanPathPath along which the stripes are searched. The path should contain at least 2 points.
inScanPathAlignmentCoordinate system of the input scan path.
inScanWidthWidth of the scan path [pixels]. Range [1, +inf].
inSamplingParamsParameters used to control the sampling process.
inStripeScanParamsParameters used to control the stripe scanning process.
inMinGapWidthWhen two consecutive stripes have a distance lower than this value, the second one is neglected. Range [0, +inf].
inMaxGapWidthWhen two consecutive stripes have a distance higher than this value, the second one is neglected.
inLocalBlindnessParameters used to prevent the detection of weak stripes nearby strong stripes.
outGapsArray containing the gaps between the found stripes.
outAlignedScanPathInput scan path aligned to the provided coordinate system.
outBrightnessProfileProfile containing the image sampled along the input scan path.
outResponseProfileFirst derivative of the brightness profile.
outSamplingPointsArray of the paths extracted from the scan path expanded with the provided width. Each path contribute to a single sampling point in the brightness profile.
outSamplingStepDistance between consecutive sampling points.
Returns
Array containing all the found stripes.

◆ FindStripes1D() [2/2]

Array< Stripe1D > oevislib_net.ComputerVision.EdgeDetection1D.EdgeDetection1D.FindStripes1D ( Image inImage,
ScanTemplate inScanTemplate,
StripeScanParams inStripeScanParams = null,
float inMinGapWidth = 0::0f,
Optional< float > inMaxGapWidth = null,
Optional< LocalBlindness > inLocalBlindness = null,
Optional< Array< Gap1D > > outGaps = null,
Optional< Profile > outBrightnessProfile = null,
Optional< Profile > outResponseProfile = null )
inlinestatic

Finds segments included between two edges of opposite transition.

Parameters
inImageInput image. It cannot be empty.
inScanTemplateThe scan path expanded to some width. The object must be pre-computed using the buildScanTemplate function.
inStripeScanParamsParameters used to control the stripe scanning process.
inMinGapWidthWhen two consecutive stripes have a distance lower than this value, the second one is neglected. Range [0, +inf].
inMaxGapWidthWhen two consecutive stripes have a distance higher than this value, the second one is neglected. Range [0, +inf].
inLocalBlindnessParameters used to prevent the detection of weak stripes nearby strong stripes.
outGapsArray containing the gaps between the found stripes.
outBrightnessProfileProfile containing the image sampled along the input scan path.
outResponseProfileFirst derivative of the brightness profile.
Returns
Array containing all the found stripes.

◆ TranslateScanTemplate()

void oevislib_net.ComputerVision.EdgeDetection1D.EdgeDetection1D.TranslateScanTemplate ( ScanTemplate ioScanTemplate,
Vector2D inDelta,
bool inInverse = false,
Optional< Array< Path > > outSamplingPoints = null )
inlinestatic

Translates the scan template along the provided vector.

Parameters
ioScanTemplateScanTemplate that will be translated. The object cannot be empty.
inDeltaTranslation vector.
inInverseIf true, the translation vector is inverted.
outSamplingPointsArray of the paths extracted from the scan path expanded with the provided width.