mtk_get: Gets Object Attribute Value

Gets the value of an attribute from a MTKObject, and stores it in a Tangram-II variable. With it, users can acquire and store, in a Tangram-II variable, any parameter value (attribute) or output of a MTKObject.

Usage: mtk_get($<$tangram2_dest_variable$>$, $<$mtk_object_name$>$,
$<$object_attribute$>$ [,$<$index_list$>$] )

where $<$tangram2_dest_variable$>$ specifies the Tangram-II's destination variable, in which the attribute value will be stored; $<$mtk_object_name$>$ specifies the object's name, from which we will get the attribute; $<$object_attribute$>$ specifies the object's attribute whose value we are interested in; and [,$<$index_list$>$] specifies the position of the attribute (if the attribute happens to be a vector, or matrix) in which we are interested in.

Example: Acquiring the new PI values, after a HMM training

Events=
event = event( TIME )
condition = ( TRUE )
action = 
{    
    float param_PI[2];
    ...
    /* Training the HMM */
    mtk_run( Predictor, "training", TRAINING_ITERATIONS, TRACE_OBSERVATIONS );

    /* Acquiring new PI values */
    mtk_get( param_PI[0], Predictor, "pi", 0 );
    mtk_get( param_PI[1], Predictor, "pi", 1 );
    ...
};