Operator Reference

HALCON Operator Reference / Legacy / Identification
ClassesClasses | | Operators

serialize_sample_identifierT_serialize_sample_identifierSerializeSampleIdentifierSerializeSampleIdentifierserialize_sample_identifier (Operator)

serialize_sample_identifierT_serialize_sample_identifierSerializeSampleIdentifierSerializeSampleIdentifierserialize_sample_identifier — Serialize a sample identifier.

Warning

serialize_sample_identifierserialize_sample_identifierSerializeSampleIdentifierSerializeSampleIdentifierserialize_sample_identifier 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

serialize_sample_identifier( : : SampleIdentifier : SerializedItemHandle)

Herror T_serialize_sample_identifier(const Htuple SampleIdentifier, Htuple* SerializedItemHandle)

void SerializeSampleIdentifier(const HTuple& SampleIdentifier, HTuple* SerializedItemHandle)

HSerializedItem HSampleIdentifier::SerializeSampleIdentifier() const

static void HOperatorSet.SerializeSampleIdentifier(HTuple sampleIdentifier, out HTuple serializedItemHandle)

HSerializedItem HSampleIdentifier.SerializeSampleIdentifier()

def serialize_sample_identifier(sample_identifier: HHandle) -> HHandle

Description

serialize_sample_identifierserialize_sample_identifierSerializeSampleIdentifierSerializeSampleIdentifierserialize_sample_identifier serializes the data of a sample identifier (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic principle of serialization). The same data that is written in a file by write_sample_identifierwrite_sample_identifierWriteSampleIdentifierWriteSampleIdentifierwrite_sample_identifier is converted to a serialized item. The sample identifier is defined by the handle SampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifiersample_identifier. The serialized sample identifier is returned by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle and can be deserialized by deserialize_sample_identifierdeserialize_sample_identifierDeserializeSampleIdentifierDeserializeSampleIdentifierdeserialize_sample_identifier.

For an explanation of the concept of sample-based identification see the introduction of chapter Legacy / Identification.

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.

SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (output_control)  serialized_item → HSerializedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the serialized item.

Result

If the parameters are valid, the operator serialize_sample_identifierserialize_sample_identifierSerializeSampleIdentifierSerializeSampleIdentifierserialize_sample_identifier returns the value 2 ( H_MSG_TRUE) . If necessary, an exception is raised.

Possible Predecessors

prepare_sample_identifierprepare_sample_identifierPrepareSampleIdentifierPrepareSampleIdentifierprepare_sample_identifier, train_sample_identifiertrain_sample_identifierTrainSampleIdentifierTrainSampleIdentifiertrain_sample_identifier, 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, set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParamset_sample_identifier_param

Possible Successors

clear_sample_identifierclear_sample_identifierClearSampleIdentifierClearSampleIdentifierclear_sample_identifier

Alternatives

write_sample_identifierwrite_sample_identifierWriteSampleIdentifierWriteSampleIdentifierwrite_sample_identifier

Module

Matching

ClassesClasses | | Operators