ClassesClasses | | Operators

get_component_relationsT_get_component_relationsGetComponentRelationsGetComponentRelations (Operator)

Name

get_component_relationsT_get_component_relationsGetComponentRelationsGetComponentRelations — Return the relations between the model components that are contained in a training result.

Signature

get_component_relations( : Relations : ComponentTrainingID, ReferenceComponent, Image : Row, Column, Phi, Length1, Length2, AngleStart, 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)

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

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)

Description

get_component_relationsget_component_relationsGetComponentRelationsGetComponentRelationsGetComponentRelations returns the relations between model components after training them with train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentsTrainModelComponents. With the parameter ReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent, you can select a reference component. get_component_relationsget_component_relationsGetComponentRelationsGetComponentRelationsGetComponentRelations then returns the relations between the reference component and all other components in the model image (if ImageImageImageImageimage = 'model_image'"model_image""model_image""model_image""model_image" or ImageImageImageImageimage = 0) or in a training image (if ImageImageImageImageimage >= 1). In order to obtain the relations in the ith training image, ImageImageImageImageimage must be set to i. The result of the training returned by train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentsTrainModelComponents must be passed in ComponentTrainingIDComponentTrainingIDComponentTrainingIDComponentTrainingIDcomponentTrainingID. ReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent 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_componentsTrainModelComponentsTrainModelComponentsTrainModelComponents).

The relations are returned in form of regions in RelationsRelationsRelationsRelationsrelations as well as in form of numerical values in RowRowRowRowrow, ColumnColumnColumnColumncolumn, PhiPhiPhiPhiphi, Length1Length1Length1Length1length1, Length2Length2Length2Length2length2, AngleStartAngleStartAngleStartAngleStartangleStart, and AngleExtentAngleExtentAngleExtentAngleExtentangleExtent.

The region object tuple RelationsRelationsRelationsRelationsrelations is designed as follows. For each component a separate region is returned. Consequently, RelationsRelationsRelationsRelationsrelations 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 ReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent, 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_componentsTrainModelComponentsTrainModelComponentsTrainModelComponents). 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 RelationsRelationsRelationsRelationsrelations, the relations are also returned in form of numerical values in RowRowRowRowrow, ColumnColumnColumnColumncolumn, PhiPhiPhiPhiphi, Length1Length1Length1Length1length1, Length2Length2Length2Length2length2, AngleStartAngleStartAngleStartAngleStartangleStart, and AngleExtentAngleExtentAngleExtentAngleExtentangleExtent. 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 RowRowRowRowrow, ColumnColumnColumnColumncolumn, PhiPhiPhiPhiphi, Length1Length1Length1Length1length1, and Length2Length2Length2Length2length2 (see gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2GenRectangle2). The orientation relation is described by the starting angle AngleStartAngleStartAngleStartAngleStartangleStart and the angle extent AngleExtentAngleExtentAngleExtentAngleExtentangleExtent. For the reference component only the position within the image is returned in RowRowRowRowrow and ColumnColumnColumnColumncolumn. 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_relationsGetComponentRelationsGetComponentRelationsGetComponentRelations is particularly useful in order to visualize the result of the training that was performed with train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentsTrainModelComponents. 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_componentsTrainModelComponentsTrainModelComponentsTrainModelComponents while using a different set of training images.

Execution Information

Parameters

RelationsRelationsRelationsRelationsrelations (output_object)  region(-array) objectHRegionHRegionHobject *

Region representation of the relations.

ComponentTrainingIDComponentTrainingIDComponentTrainingIDComponentTrainingIDcomponentTrainingID (input_control)  component_training HComponentTraining, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the training result.

ReferenceComponentReferenceComponentReferenceComponentReferenceComponentreferenceComponent (input_control)  integer HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Index of reference component.

Restriction: ReferenceComponent >= 0

ImageImageImageImageimage (input_control)  string HTupleHTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)

Image for which the component relations are to be returned.

Default value: 'model_image' "model_image" "model_image" "model_image" "model_image"

Suggested values: 'model_image'"model_image""model_image""model_image""model_image", 0, 1, 2, 3, 4, 5, 6, 7, 8

RowRowRowRowrow (output_control)  rectangle2.center.y(-array) HTupleHTupleHtuple (real) (double) (double) (double)

Row coordinate of the center of the rectangle representing the relation.

ColumnColumnColumnColumncolumn (output_control)  rectangle2.center.x(-array) HTupleHTupleHtuple (real) (double) (double) (double)

Column index of the center of the rectangle representing the relation.

PhiPhiPhiPhiphi (output_control)  rectangle2.angle.rad(-array) HTupleHTupleHtuple (real) (double) (double) (double)

Orientation of the rectangle representing the relation (radians).

Assertion: - pi / 2 < Phi && Phi <= pi / 2

Length1Length1Length1Length1length1 (output_control)  rectangle2.hwidth(-array) HTupleHTupleHtuple (real) (double) (double) (double)

First radius (half length) of the rectangle representing the relation.

Assertion: Length1 >= 0.0

Length2Length2Length2Length2length2 (output_control)  rectangle2.hheight(-array) HTupleHTupleHtuple (real) (double) (double) (double)

Second radius (half width) of the rectangle representing the relation.

Assertion: Length2 >= 0.0 && Length2 <= Length1

AngleStartAngleStartAngleStartAngleStartangleStart (output_control)  angle.rad(-array) HTupleHTupleHtuple (real) (double) (double) (double)

Smallest relative orientation angle.

AngleExtentAngleExtentAngleExtentAngleExtentangleExtent (output_control)  angle.rad(-array) HTupleHTupleHtuple (real) (double) (double) (double)

Extent of the relative orientation angles.

Result

If the handle of the training result is valid, the operator get_component_relationsget_component_relationsGetComponentRelationsGetComponentRelationsGetComponentRelations returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.

Possible Predecessors

train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentsTrainModelComponents

Possible Successors

train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentsTrainModelComponents

See also

gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2GenRectangle2

Module

Matching


ClassesClasses | | Operators