get_sample_identifier_object_infoT_get_sample_identifier_object_infoGetSampleIdentifierObjectInfoGetSampleIdentifierObjectInfoget_sample_identifier_object_info (Operator)
get_sample_identifier_object_infoT_get_sample_identifier_object_infoGetSampleIdentifierObjectInfoGetSampleIdentifierObjectInfoget_sample_identifier_object_info — Retrieve information about an object of a sample identifier.
Warning
get_sample_identifier_object_infoget_sample_identifier_object_infoGetSampleIdentifierObjectInfoGetSampleIdentifierObjectInfoget_sample_identifier_object_info is obsolete and is only provided for
reasons of backward compatibility. New applications should use the operators
for Deep-Learning-based classification instead, for details see
Deep Learning / Classification.
Signature
Description
get_sample_identifier_object_infoget_sample_identifier_object_infoGetSampleIdentifierObjectInfoGetSampleIdentifierObjectInfoget_sample_identifier_object_info retrieves information from the
SampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifiersample_identifier. This information comprises the number of objects
and object samples as well as their indices. Furthermore, the information
set with set_sample_identifier_object_infoset_sample_identifier_object_infoSetSampleIdentifierObjectInfoSetSampleIdentifierObjectInfoset_sample_identifier_object_info can be retrieved.
For an explanation of the concept of sample-based identification
see the introduction of chapter Legacy / Identification.
The parameter ObjectIdxObjectIdxObjectIdxobjectIdxobject_idx defines the index of the object for which
information is retrieved. Note that this parameter is not evaluated if
InfoNameInfoNameInfoNameinfoNameinfo_name is set to 'num_preparation_objects'"num_preparation_objects""num_preparation_objects""num_preparation_objects""num_preparation_objects",
'preparation_object_idx'"preparation_object_idx""preparation_object_idx""preparation_object_idx""preparation_object_idx", 'num_training_objects'"num_training_objects""num_training_objects""num_training_objects""num_training_objects", or
'training_object_idx'"training_object_idx""training_object_idx""training_object_idx""training_object_idx".
InfoNameInfoNameInfoNameinfoNameinfo_name defines the kind of information to be returned in
InfoValueInfoValueInfoValueinfoValueinfo_value. The following values for InfoNameInfoNameInfoNameinfoNameinfo_name are
possible:
- 'num_preparation_objects'"num_preparation_objects""num_preparation_objects""num_preparation_objects""num_preparation_objects":
-
The number of preparation
objects. Note that all preparation objects for which the object index has
been set to 'unknown'"unknown""unknown""unknown""unknown", are counted as one single preparation
object.
- 'preparation_object_idx'"preparation_object_idx""preparation_object_idx""preparation_object_idx""preparation_object_idx":
-
The list of indices of all
available preparation objects. Note that this list will contain the
string 'unknown'"unknown""unknown""unknown""unknown", if the object index of at least one preparation
object hast been set to 'unknown'"unknown""unknown""unknown""unknown".
- 'num_preparation_samples'"num_preparation_samples""num_preparation_samples""num_preparation_samples""num_preparation_samples":
-
The number of preparation
samples for the preparation object indicated by ObjectIdxObjectIdxObjectIdxobjectIdxobject_idx.
- 'preparation_sample_idx'"preparation_sample_idx""preparation_sample_idx""preparation_sample_idx""preparation_sample_idx":
-
The list of indices of all
available preparation samples for the preparation object indicated by
ObjectIdxObjectIdxObjectIdxobjectIdxobject_idx.
- 'num_training_objects'"num_training_objects""num_training_objects""num_training_objects""num_training_objects":
-
The number of training objects.
- 'training_object_idx'"training_object_idx""training_object_idx""training_object_idx""training_object_idx":
-
The list of indices of all
available training objects.
- 'num_training_samples'"num_training_samples""num_training_samples""num_training_samples""num_training_samples":
-
The number of training samples for
the training object indicated by ObjectIdxObjectIdxObjectIdxobjectIdxobject_idx.
- 'training_sample_idx'"training_sample_idx""training_sample_idx""training_sample_idx""training_sample_idx":
-
The list of indices of all
available training samples for the training object indicated by
ObjectIdxObjectIdxObjectIdxobjectIdxobject_idx.
- 'preparation_object_name'"preparation_object_name""preparation_object_name""preparation_object_name""preparation_object_name":
-
The information of the
preparation object that has been set with
set_sample_identifier_object_infoset_sample_identifier_object_infoSetSampleIdentifierObjectInfoSetSampleIdentifierObjectInfoset_sample_identifier_object_info for the preparation object
indicated by ObjectIdxObjectIdxObjectIdxobjectIdxobject_idx.
- 'training_object_name'"training_object_name""training_object_name""training_object_name""training_object_name":
-
The information of the training
object that has been set with set_sample_identifier_object_infoset_sample_identifier_object_infoSetSampleIdentifierObjectInfoSetSampleIdentifierObjectInfoset_sample_identifier_object_info
for the training object indicated by ObjectIdxObjectIdxObjectIdxobjectIdxobject_idx.
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
SampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifiersample_identifier (input_control) sample_identifier → HSampleIdentifier, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the sample identifier.
ObjectIdxObjectIdxObjectIdxobjectIdxobject_idx (input_control) integer(-array) → HTupleMaybeSequence[Union[int, str]]HTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)
Index of the object for which information is retrieved.
Suggested values:
0, 1, 2, 3, 4, 5, 'unknown'"unknown""unknown""unknown""unknown"
InfoNameInfoNameInfoNameinfoNameinfo_name (input_control) attribute.name(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Define, for which kind of object information is
retrieved.
Default:
'num_training_objects'
"num_training_objects"
"num_training_objects"
"num_training_objects"
"num_training_objects"
List of values:
'num_preparation_objects'"num_preparation_objects""num_preparation_objects""num_preparation_objects""num_preparation_objects", 'num_preparation_samples'"num_preparation_samples""num_preparation_samples""num_preparation_samples""num_preparation_samples", 'num_training_objects'"num_training_objects""num_training_objects""num_training_objects""num_training_objects", 'num_training_samples'"num_training_samples""num_training_samples""num_training_samples""num_training_samples", 'preparation_object_idx'"preparation_object_idx""preparation_object_idx""preparation_object_idx""preparation_object_idx", 'preparation_object_name'"preparation_object_name""preparation_object_name""preparation_object_name""preparation_object_name", 'preparation_sample_idx'"preparation_sample_idx""preparation_sample_idx""preparation_sample_idx""preparation_sample_idx", 'training_object_idx'"training_object_idx""training_object_idx""training_object_idx""training_object_idx", 'training_object_name'"training_object_name""training_object_name""training_object_name""training_object_name", 'training_sample_idx'"training_sample_idx""training_sample_idx""training_sample_idx""training_sample_idx"
InfoValueInfoValueInfoValueinfoValueinfo_value (output_control) attribute.value(-array) → HTupleSequence[Union[int, str]]HTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)
Information about the object.
Result
If the parameters are valid, the operator
get_sample_identifier_object_infoget_sample_identifier_object_infoGetSampleIdentifierObjectInfoGetSampleIdentifierObjectInfoget_sample_identifier_object_info returns the value 2 (
H_MSG_TRUE)
. If
necessary an exception is raised.
Possible Predecessors
add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_data,
add_sample_identifier_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataadd_sample_identifier_training_data
See also
create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier,
prepare_sample_identifierprepare_sample_identifierPrepareSampleIdentifierPrepareSampleIdentifierprepare_sample_identifier,
train_sample_identifiertrain_sample_identifierTrainSampleIdentifierTrainSampleIdentifiertrain_sample_identifier,
apply_sample_identifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifierapply_sample_identifier,
set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParamset_sample_identifier_param,
get_sample_identifier_paramget_sample_identifier_paramGetSampleIdentifierParamGetSampleIdentifierParamget_sample_identifier_param,
remove_sample_identifier_preparation_dataremove_sample_identifier_preparation_dataRemoveSampleIdentifierPreparationDataRemoveSampleIdentifierPreparationDataremove_sample_identifier_preparation_data,
remove_sample_identifier_training_dataremove_sample_identifier_training_dataRemoveSampleIdentifierTrainingDataRemoveSampleIdentifierTrainingDataremove_sample_identifier_training_data,
write_sample_identifierwrite_sample_identifierWriteSampleIdentifierWriteSampleIdentifierwrite_sample_identifier,
read_sample_identifierread_sample_identifierReadSampleIdentifierReadSampleIdentifierread_sample_identifier,
serialize_sample_identifierserialize_sample_identifierSerializeSampleIdentifierSerializeSampleIdentifierserialize_sample_identifier,
deserialize_sample_identifierdeserialize_sample_identifierDeserializeSampleIdentifierDeserializeSampleIdentifierdeserialize_sample_identifier,
clear_sample_identifierclear_sample_identifierClearSampleIdentifierClearSampleIdentifierclear_sample_identifier
Module
Matching