shape_histo_pointT_shape_histo_pointShapeHistoPointShapeHistoPointshape_histo_point (Operator)
Name
shape_histo_pointT_shape_histo_pointShapeHistoPointShapeHistoPointshape_histo_point — Determine a histogram of features along all threshold values.
Signature
void ShapeHistoPoint(const HObject& Region, const HObject& Image, const HTuple& Feature, const HTuple& Row, const HTuple& Column, HTuple* AbsoluteHisto, HTuple* RelativeHisto)
HTuple HRegion::ShapeHistoPoint(const HImage& Image, const HString& Feature, Hlong Row, Hlong Column, HTuple* RelativeHisto) const
HTuple HRegion::ShapeHistoPoint(const HImage& Image, const char* Feature, Hlong Row, Hlong Column, HTuple* RelativeHisto) const
HTuple HRegion::ShapeHistoPoint(const HImage& Image, const wchar_t* Feature, Hlong Row, Hlong Column, HTuple* RelativeHisto) const
(
Windows only)
static void HOperatorSet.ShapeHistoPoint(HObject region, HObject image, HTuple feature, HTuple row, HTuple column, out HTuple absoluteHisto, out HTuple relativeHisto)
HTuple HRegion.ShapeHistoPoint(HImage image, string feature, int row, int column, out HTuple relativeHisto)
def shape_histo_point(region: HObject, image: HObject, feature: str, row: int, column: int) -> Tuple[Sequence[Union[int, float]], Sequence[float]]
Description
Like shape_histo_allshape_histo_allShapeHistoAllShapeHistoAllShapeHistoAllshape_histo_all the operator
shape_histo_pointshape_histo_pointShapeHistoPointShapeHistoPointShapeHistoPointshape_histo_point carries out 255 threshold value operations
within RegionRegionRegionRegionregionregion with the gray values of ImageImageImageImageimageimage.
Contrary to shape_histo_allshape_histo_allShapeHistoAllShapeHistoAllShapeHistoAllshape_histo_all only the segmented region
containing the pixel (RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn) is taken
into account here. The entry i in the histogram then corresponds
to the number of holes of this region segmented with the threshold
i (FeatureFeatureFeatureFeaturefeaturefeature = 'holes'"holes""holes""holes""holes""holes") or the feature value of
the region (FeatureFeatureFeatureFeaturefeaturefeature = 'convexity'"convexity""convexity""convexity""convexity""convexity",
'compactness'"compactness""compactness""compactness""compactness""compactness", 'ansisometry'"ansisometry""ansisometry""ansisometry""ansisometry""ansisometry"), respectively.
Attention
Note that the operator shape_histo_pointshape_histo_pointShapeHistoPointShapeHistoPointShapeHistoPointshape_histo_point only considers
the given RegionRegionRegionRegionregionregion and ignores any previously set domain
of the input image ImageImageImageImageimageimage.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
RegionRegionRegionRegionregionregion (input_object) region → objectHRegionHObjectHRegionHobject
Region in which the features are to be examined.
ImageImageImageImageimageimage (input_object) singlechannelimage → objectHImageHObjectHImageHobject (byte)
Gray value image.
FeatureFeatureFeatureFeaturefeaturefeature (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Feature to be examined.
Default:
'convexity'
"convexity"
"convexity"
"convexity"
"convexity"
"convexity"
List of values:
'anisometry'"anisometry""anisometry""anisometry""anisometry""anisometry", 'compactness'"compactness""compactness""compactness""compactness""compactness", 'convexity'"convexity""convexity""convexity""convexity""convexity", 'holes'"holes""holes""holes""holes""holes"
RowRowRowRowrowrow (input_control) point.y → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Row of the pixel which the region must contain.
Default:
256
Suggested values:
10, 50, 100, 200, 300, 400
ColumnColumnColumnColumncolumncolumn (input_control) point.x → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Column of the pixel which the region must contain.
Default:
256
Suggested values:
10, 50, 100, 200, 300, 400
AbsoluteHistoAbsoluteHistoAbsoluteHistoAbsoluteHistoabsoluteHistoabsolute_histo (output_control) histogram-array → HTupleSequence[Union[int, float]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Absolute distribution of the feature.
RelativeHistoRelativeHistoRelativeHistoRelativeHistorelativeHistorelative_histo (output_control) histogram-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Relative distribution of the feature.
Result
The operator shape_histo_pointshape_histo_pointShapeHistoPointShapeHistoPointShapeHistoPointshape_histo_point returns the value 2 (
H_MSG_TRUE)
if an
image with defined gray values is entered. The behavior in case of
empty input (no input images available) is set via the operator
set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>),
the behavior in case of empty region is set via
set_system(::'empty_region_result',<Result>:)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>).
If necessary an exception is raised.
Possible Predecessors
get_mbuttonget_mbuttonGetMbuttonGetMbuttonGetMbuttonget_mbutton,
area_centerarea_centerAreaCenterAreaCenterAreaCenterarea_center
Possible Successors
histo_to_threshhisto_to_threshHistoToThreshHistoToThreshHistoToThreshhisto_to_thresh,
thresholdthresholdThresholdThresholdThresholdthreshold,
gen_region_histogen_region_histoGenRegionHistoGenRegionHistoGenRegionHistogen_region_histo
Alternatives
shape_histo_allshape_histo_allShapeHistoAllShapeHistoAllShapeHistoAllshape_histo_all
See also
connectionconnectionConnectionConnectionConnectionconnection,
connect_and_holesconnect_and_holesConnectAndHolesConnectAndHolesConnectAndHolesconnect_and_holes,
convexityconvexityConvexityConvexityConvexityconvexity,
compactnesscompactnessCompactnessCompactnessCompactnesscompactness
Module
Foundation