Name
get_component_relationsget_component_relationsGetComponentRelationsget_component_relationsGetComponentRelationsGetComponentRelations — Return the relations between the model components that are contained in
a training result.
Herror get_component_relations(Hobject* Relations, const Hlong ComponentTrainingID, const Hlong ReferenceComponent, const char* Image, double* Row, double* Column, double* Phi, double* Length1, double* Length2, double* AngleStart, double* AngleExtent)
Herror T_get_component_relations(Hobject* Relations, const Htuple ComponentTrainingID, const Htuple ReferenceComponent, const Htuple Image, Htuple* Row, Htuple* Column, Htuple* Phi, Htuple* Length1, Htuple* Length2, Htuple* AngleStart, Htuple* AngleExtent)
Herror get_component_relations(Hobject* Relations, const HTuple& ComponentTrainingID, const HTuple& ReferenceComponent, const HTuple& Image, double* Row, double* Column, double* Phi, double* Length1, double* Length2, double* AngleStart, double* AngleExtent)
Herror get_component_relations(Hobject* Relations, const HTuple& ComponentTrainingID, const HTuple& ReferenceComponent, const HTuple& Image, HTuple* Row, HTuple* Column, HTuple* Phi, HTuple* Length1, HTuple* Length2, HTuple* AngleStart, HTuple* AngleExtent)
HRegionArray HComponentTraining::GetComponentRelations(const HTuple& ReferenceComponent, const HTuple& Image, HTuple* Row, HTuple* Column, HTuple* Phi, HTuple* Length1, HTuple* Length2, HTuple* AngleStart, HTuple* AngleExtent) const
void GetComponentRelations(HObject* Relations, const HTuple& ComponentTrainingID, const HTuple& ReferenceComponent, const HTuple& Image, HTuple* Row, HTuple* Column, HTuple* Phi, HTuple* Length1, HTuple* Length2, HTuple* AngleStart, HTuple* AngleExtent)
HRegion HComponentTraining::GetComponentRelations(Hlong ReferenceComponent, const HTuple& Image, HTuple* Row, HTuple* Column, HTuple* Phi, HTuple* Length1, HTuple* Length2, HTuple* AngleStart, HTuple* AngleExtent) const
HRegion HComponentTraining::GetComponentRelations(Hlong ReferenceComponent, const HString& Image, double* Row, double* Column, double* Phi, double* Length1, double* Length2, double* AngleStart, double* AngleExtent) const
HRegion HComponentTraining::GetComponentRelations(Hlong ReferenceComponent, const char* Image, double* Row, double* Column, double* Phi, double* Length1, double* Length2, double* AngleStart, double* AngleExtent) const
void HOperatorSetX.GetComponentRelations(
[out] IHUntypedObjectX** Relations, [in] VARIANT ComponentTrainingID, [in] VARIANT ReferenceComponent, [in] VARIANT Image, [out] VARIANT* Row, [out] VARIANT* Column, [out] VARIANT* Phi, [out] VARIANT* Length1, [out] VARIANT* Length2, [out] VARIANT* AngleStart, [out] VARIANT* AngleExtent)
IHRegionX* HComponentTrainingX.GetComponentRelations(
[in] Hlong ReferenceComponent, [in] VARIANT Image, [out] VARIANT* Row, [out] VARIANT* Column, [out] VARIANT* Phi, [out] VARIANT* Length1, [out] VARIANT* Length2, [out] VARIANT* AngleStart, [out] VARIANT* AngleExtent)
static void HOperatorSet.GetComponentRelations(out HObject relations, HTuple componentTrainingID, HTuple referenceComponent, HTuple image, out HTuple row, out HTuple column, out HTuple phi, out HTuple length1, out HTuple length2, out HTuple angleStart, out HTuple angleExtent)
HRegion HComponentTraining.GetComponentRelations(int referenceComponent, HTuple image, out HTuple row, out HTuple column, out HTuple phi, out HTuple length1, out HTuple length2, out HTuple angleStart, out HTuple angleExtent)
HRegion HComponentTraining.GetComponentRelations(int referenceComponent, string image, out double row, out double column, out double phi, out double length1, out double length2, out double angleStart, out double angleExtent)
get_component_relationsget_component_relationsGetComponentRelationsget_component_relationsGetComponentRelationsGetComponentRelations returns the relations between model
components after training them with train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents.
With the parameter ReferenceComponentReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent, you can select a
reference component. get_component_relationsget_component_relationsGetComponentRelationsget_component_relationsGetComponentRelationsGetComponentRelations then returns
the relations between the reference component and all other components
in the model image (if ImageImageImageImageImageimage = 'model_image'"model_image""model_image""model_image""model_image""model_image" or
ImageImageImageImageImageimage = 0) or in a training image (if
ImageImageImageImageImageimage >= 1). In order to obtain the
relations in the ith training image, ImageImageImageImageImageimage must be
set to i. The result of the training returned by
train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents must be passed in
ComponentTrainingIDComponentTrainingIDComponentTrainingIDComponentTrainingIDComponentTrainingIDcomponentTrainingID. ReferenceComponentReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent describes
the index of the reference component and must be within the range of
0 and n-1, if n is the number of model components
(see train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents).
The relations are returned in form of regions in RelationsRelationsRelationsRelationsRelationsrelations
as well as in form of numerical values in RowRowRowRowRowrow,
ColumnColumnColumnColumnColumncolumn, PhiPhiPhiPhiPhiphi, Length1Length1Length1Length1Length1length1, Length2Length2Length2Length2Length2length2,
AngleStartAngleStartAngleStartAngleStartAngleStartangleStart, and AngleExtentAngleExtentAngleExtentAngleExtentAngleExtentangleExtent.
The region object tuple RelationsRelationsRelationsRelationsRelationsrelations is designed as
follows. For each component a separate region is
returned. Consequently, RelationsRelationsRelationsRelationsRelationsrelations contains n
regions, where the order of the regions within the tuple is
determined by the index of the corresponding components. The
positions of all components in the image are represented by circles
with a radius of 3 pixels. For each component other than the
reference component ReferenceComponentReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent, additionally the
position relation and the orientation relation relative to the
reference component are represented. The position relation is
represented by a rectangle and the orientation relation is represend
by a circle sector with a radius of 30 pixels. The center of the
circle is placed at the mean relative position of the component. The
rectangle describes the movement of the reference point of the
respective component relative to the pose of the reference
component, while the circle sector describes the variation of the
relative orientation (see train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents). A
relative orientation of 0 corresponds to the relative orientation of
both components in the model image. If both components appear in the
same relative orientation in all images, the circle sector
consequently degenerates to a straight line.
In addition to the region object tuple RelationsRelationsRelationsRelationsRelationsrelations, the
relations are also returned in form of numerical values in
RowRowRowRowRowrow, ColumnColumnColumnColumnColumncolumn, PhiPhiPhiPhiPhiphi, Length1Length1Length1Length1Length1length1,
Length2Length2Length2Length2Length2length2, AngleStartAngleStartAngleStartAngleStartAngleStartangleStart, and
AngleExtentAngleExtentAngleExtentAngleExtentAngleExtentangleExtent. These parameters are tuples of length n
and contain the relations of all components relative to the
reference component, where the order of the values within the tuples
is determined by the index of the corresponding component. The
position relation is described by the parameters of the corresponding
rectangle RowRowRowRowRowrow, ColumnColumnColumnColumnColumncolumn, PhiPhiPhiPhiPhiphi,
Length1Length1Length1Length1Length1length1, and Length2Length2Length2Length2Length2length2 (see
gen_rectangle2gen_rectangle2GenRectangle2gen_rectangle2GenRectangle2GenRectangle2). The orientation relation is described by
the starting angle AngleStartAngleStartAngleStartAngleStartAngleStartangleStart and the angle extent
AngleExtentAngleExtentAngleExtentAngleExtentAngleExtentangleExtent. For the reference component only the position
within the image is returned in RowRowRowRowRowrow and
ColumnColumnColumnColumnColumncolumn. All other values are set to 0.
If the reference component has not been found in the current image,
an array of empty regions is returned and the corresponding parameter
values are set to 0.
The operator get_component_relationsget_component_relationsGetComponentRelationsget_component_relationsGetComponentRelationsGetComponentRelations is particularly useful
in order to visualize the result of the training that was performed
with train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents. With this, it is possible to
evaluate the variations that are contained in the training
images. Sometimes it might be reasonable to restart the training
with train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents while using a different set of
training images.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Region representation of the relations.
Handle of the training result.
Index of reference component.
Restriction: ReferenceComponent >= 0
Image for which the component relations are to be
returned.
Default value:
'model_image'
"model_image"
"model_image"
"model_image"
"model_image"
"model_image"
Suggested values: 'model_image'"model_image""model_image""model_image""model_image""model_image", 0, 1, 2, 3, 4, 5, 6, 7, 8
Row coordinate of the center of the rectangle
representing the relation.
Column index of the center of the rectangle
representing the relation.
PhiPhiPhiPhiPhiphi (output_control) rectangle2.angle.rad(-array) → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)
Orientation of the rectangle representing
the relation (radians).
Assertion: - pi / 2 < Phi && Phi <= pi / 2
First radius (half length) of the rectangle
representing the relation.
Assertion: Length1 >= 0.0
Second radius (half width) of the rectangle
representing the relation.
Assertion: Length2 >= 0.0 && Length2 <= Length1
Smallest relative orientation angle.
Extent of the relative orientation angles.
If the handle of the training result is valid, the operator
get_component_relationsget_component_relationsGetComponentRelationsget_component_relationsGetComponentRelationsGetComponentRelations returns the value 2 (H_MSG_TRUE). If
necessary an exception is raised.
train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents
train_model_componentstrain_model_componentsTrainModelComponentstrain_model_componentsTrainModelComponentsTrainModelComponents
gen_rectangle2gen_rectangle2GenRectangle2gen_rectangle2GenRectangle2GenRectangle2
Matching