man pages section 3: Multimedia Library Functions

Exit Print View

Updated: July 2014
 
 

mlib_SignalDTWKScalarInit_S16 (3MLIB)

Name

mlib_SignalDTWKScalarInit_S16 - initialization for K-best paths of scalar data

Synopsis

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

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

Description

The mlib_SignalDTWKScalarInit_S16() function initializes the internal state structure for dynamic time warping (DTW) for K-best paths of scalar 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.

kbest

The number of the best paths evaluated.

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:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
MT-Safe

See also

mlib_SignalDTWKScalarInit_S16(3MLIB), mlib_SignalDTWKScalar_S16(3MLIB), mlib_SignalDTWKScalarPath_S16(3MLIB), mlib_SignalDTWKScalarFree_S16(3MLIB), attributes(5)