mlib_SignalDTWKVectorInit_S16

- initialization for K-best paths of vector data

Synopsis

cc [ flag... ] file... -lmlib [ library... ]
#include <mlib.h>

mlib_status mlib_SignalDTWKVectorInit_S16(void *state, 
     const mlib_s16 **dref, mlib_s32 lref, mlib_s32 ndata, 
     mlib_s32 kbest, mlib_s32 dtype, mlib_s32 sref, 
     mlib_s32 delta, mlib_s32 local, mlib_s32 slope);

Description

The mlib_SignalDTWKVectorInit_S16() function initializes the internal state structure for dynamic time warping (DTW) for K-best paths of vector data.

The init function performs internal state structure allocation and global initialization. Per DTW function call initialization is done in DTW function, so the same internal state structure can be reused for multiple DTW function calls.

Parameters

The function takes the following arguments:

dref

The reference data array.

lref

The length of the reference data array.

ndata

The length of each data vector.

kbest

The number of the best paths evaluated.

dtype

The type of distance metric between data vectors. MLIB_DTW_L1NORM for L1 norm of difference (sum of absolute difference). MLIB_DTW_L2NORM for L2 norm of difference (Euclidean distance).

sref

The scaling factor of the reference data array, where actual_data = input_data * 2**(-scaling_factor).

delta

The delta in the endpoint constraints.

local

The type of the local continuity constraints. MLIB_DTW_ITAKURA for Itakura type constraints.

slope

The type of the slope weighting. MLIB_DTW_NONE for no slope weighting.

state

Pointer to the internal state structure.

Return Values

The function returns MLIB_SUCCESS if successful. Otherwise it returns MLIB_FAILURE.

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

mlib_SignalDTWKVectorInit_S16(3MLIB), mlib_SignalDTWKVector_S16(3MLIB), mlib_SignalDTWKVectorPath_S16(3MLIB), mlib_SignalDTWKVectorFree_S16(3MLIB), attributes(5)