'\" te
.\" Copyright (c) 2007, Sun Microsystems, Inc.  All Rights Reserved 
.TH mlib_SignalDTWKVectorInit_F32 3MLIB "2 Mar 2007" "SunOS 5.11" "mediaLib Library Functions"
.SH NAME
mlib_SignalDTWKVectorInit_F32 \- initialization for K-best paths of vector data
.SH SYNOPSIS
.LP
.nf
cc [ \fIflag\fR... ] \fIfile\fR... \fB-lmlib\fR [ \fIlibrary\fR... ]
#include <mlib.h>

\fBmlib_status\fR \fBmlib_SignalDTWKVectorInit_F32\fR(\fBvoid *\fR\fIstate\fR, 
     \fBconst mlib_f32 **\fR\fIdref\fR, \fBmlib_s32\fR \fIlref\fR, \fBmlib_s32\fR \fIndata\fR, 
     \fBmlib_s32\fR \fIkbest\fR, \fBmlib_s32\fR \fIdtype\fR, \fBmlib_s32\fR \fIdelta\fR, 
     \fBmlib_s32\fR \fIlocal\fR, \fBmlib_s32\fR \fIslope\fR);
.fi

.SH DESCRIPTION
.sp
.LP
The \fBmlib_SignalDTWKVectorInit_F32()\fR function initializes the internal state structure for dynamic time warping (DTW) for K-best paths of vector data.
.sp
.LP
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.
.SH PARAMETERS
.sp
.LP
The function takes the following arguments:
.sp
.ne 2
.mk
.na
\fB\fIdref\fR\fR
.ad
.RS 9n
.rt  
The reference data array.
.RE

.sp
.ne 2
.mk
.na
\fB\fIlref\fR\fR
.ad
.RS 9n
.rt  
The length of the reference data array.
.RE

.sp
.ne 2
.mk
.na
\fB\fIndata\fR\fR
.ad
.RS 9n
.rt  
The length of each data vector.
.RE

.sp
.ne 2
.mk
.na
\fB\fIkbest\fR\fR
.ad
.RS 9n
.rt  
The number of the best paths evaluated.
.RE

.sp
.ne 2
.mk
.na
\fB\fIdtype\fR\fR
.ad
.RS 9n
.rt  
The type of distance metric between data vectors. \fBMLIB_DTW_L1NORM\fR for L1 norm of difference (sum of absolute difference). \fBMLIB_DTW_L2NORM\fR for L2 norm of difference (Euclidean distance).
.RE

.sp
.ne 2
.mk
.na
\fB\fIdelta\fR\fR
.ad
.RS 9n
.rt  
The delta in the endpoint constraints.
.RE

.sp
.ne 2
.mk
.na
\fB\fIlocal\fR\fR
.ad
.RS 9n
.rt  
The type of the local continuity constraints. \fBMLIB_DTW_ITAKURA\fR for Itakura type constraints.
.RE

.sp
.ne 2
.mk
.na
\fB\fIslope\fR\fR
.ad
.RS 9n
.rt  
The type of the slope weighting. \fBMLIB_DTW_NONE\fR for no slope weighting.
.RE

.sp
.ne 2
.mk
.na
\fB\fIstate\fR\fR
.ad
.RS 9n
.rt  
Pointer to the internal state structure.
.RE

.SH RETURN VALUES
.sp
.LP
The function returns \fBMLIB_SUCCESS\fR if successful. Otherwise it returns \fBMLIB_FAILURE\fR.
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Interface StabilityCommitted
_
MT-LevelMT-Safe
.TE

.SH SEE ALSO
.sp
.LP
mlib_SignalDTWKVectorInit_F32(3MLIB), \fBmlib_SignalDTWKVector_F32\fR(3MLIB), \fBmlib_SignalDTWKVectorPath_F32\fR(3MLIB), \fBmlib_SignalDTWKVectorFree_F32\fR(3MLIB), \fBattributes\fR(5)