PocketSphinx  5prealpha
ps_alignment.h
Go to the documentation of this file.
1 /* -*- c-basic-offset: 4; indent-tabs-mode: nil -*- */
2 /* ====================================================================
3  * Copyright (c) 2010 Carnegie Mellon University. All rights
4  * reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  *
10  * 1. Redistributions of source code must retain the above copyright
11  * notice, this list of conditions and the following disclaimer.
12  *
13  * 2. Redistributions in binary form must reproduce the above copyright
14  * notice, this list of conditions and the following disclaimer in
15  * the documentation and/or other materials provided with the
16  * distribution.
17  *
18  * This work was supported in part by funding from the Defense Advanced
19  * Research Projects Agency and the National Science Foundation of the
20  * United States of America, and the CMU Sphinx Speech Consortium.
21  *
22  * THIS SOFTWARE IS PROVIDED BY CARNEGIE MELLON UNIVERSITY ``AS IS'' AND
23  * ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
24  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
25  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY
26  * NOR ITS EMPLOYEES BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
27  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
28  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
29  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
30  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
31  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
32  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33  *
34  * ====================================================================
35  *
36  */
37 
42 #ifndef __PS_ALIGNMENT_H__
43 #define __PS_ALIGNMENT_H__
44 
45 /* System headers. */
46 
47 /* SphinxBase headers. */
48 #include <sphinxbase/prim_type.h>
49 
50 /* Local headers. */
51 #include "dict2pid.h"
52 #include "hmm.h"
53 
54 #define PS_ALIGNMENT_NONE ((uint16)0xffff)
55 
57  union {
58  int32 wid;
59  struct {
60  uint16 ssid;
61  uint16 cipid;
62  uint16 tmatid;
63  } pid;
64  uint16 senid;
65  } id;
66  int16 start;
67  int16 duration;
68  int32 score;
69  uint16 parent;
70  uint16 child;
71 };
72 typedef struct ps_alignment_entry_s ps_alignment_entry_t;
73 
75  ps_alignment_entry_t *seq;
76  uint16 n_ent, n_alloc;
77 };
78 typedef struct ps_alignment_vector_s ps_alignment_vector_t;
79 
81  dict2pid_t *d2p;
82  ps_alignment_vector_t word;
83  ps_alignment_vector_t sseq;
84  ps_alignment_vector_t state;
85 };
86 typedef struct ps_alignment_s ps_alignment_t;
87 
89  ps_alignment_t *al;
90  ps_alignment_vector_t *vec;
91  int pos;
92 };
93 typedef struct ps_alignment_iter_s ps_alignment_iter_t;
94 
98 ps_alignment_t *ps_alignment_init(dict2pid_t *d2p);
99 
103 int ps_alignment_free(ps_alignment_t *al);
104 
108 int ps_alignment_add_word(ps_alignment_t *al,
109  int32 wid, int duration);
110 
114 int ps_alignment_populate(ps_alignment_t *al);
115 
119 int ps_alignment_populate_ci(ps_alignment_t *al);
120 
124 int ps_alignment_propagate(ps_alignment_t *al);
125 
129 int ps_alignment_n_words(ps_alignment_t *al);
130 
134 int ps_alignment_n_phones(ps_alignment_t *al);
135 
139 int ps_alignment_n_states(ps_alignment_t *al);
140 
144 ps_alignment_iter_t *ps_alignment_words(ps_alignment_t *al);
145 
149 ps_alignment_iter_t *ps_alignment_phones(ps_alignment_t *al);
150 
154 ps_alignment_iter_t *ps_alignment_states(ps_alignment_t *al);
155 
159 ps_alignment_entry_t *ps_alignment_iter_get(ps_alignment_iter_t *itor);
160 
164 ps_alignment_iter_t *ps_alignment_iter_goto(ps_alignment_iter_t *itor, int pos);
165 
169 ps_alignment_iter_t *ps_alignment_iter_next(ps_alignment_iter_t *itor);
170 
174 ps_alignment_iter_t *ps_alignment_iter_prev(ps_alignment_iter_t *itor);
175 
179 ps_alignment_iter_t *ps_alignment_iter_up(ps_alignment_iter_t *itor);
183 ps_alignment_iter_t *ps_alignment_iter_down(ps_alignment_iter_t *itor);
184 
188 int ps_alignment_iter_free(ps_alignment_iter_t *itor);
189 
190 #endif /* __PS_ALIGNMENT_H__ */
ps_alignment_iter_t * ps_alignment_iter_goto(ps_alignment_iter_t *itor, int pos)
Move alignment iterator to given index.
Definition: ps_alignment.c:424
Definition: ps_alignment.h:56
ps_alignment_iter_t * ps_alignment_iter_down(ps_alignment_iter_t *itor)
Get a new iterator starting at the first child of the current node.
Definition: ps_alignment.c:481
Building triphones for a dictionary.
ps_alignment_iter_t * ps_alignment_iter_prev(ps_alignment_iter_t *itor)
Move an alignment iterator back.
Definition: ps_alignment.c:449
ps_alignment_iter_t * ps_alignment_phones(ps_alignment_t *al)
Iterate over the alignment starting at the first phone.
Definition: ps_alignment.c:383
ps_alignment_iter_t * ps_alignment_words(ps_alignment_t *al)
Iterate over the alignment starting at the first word.
Definition: ps_alignment.c:369
int ps_alignment_propagate(ps_alignment_t *al)
Propagate timing information up from state sequence.
Definition: ps_alignment.c:313
int ps_alignment_add_word(ps_alignment_t *al, int32 wid, int duration)
Append a word.
Definition: ps_alignment.c:108
int ps_alignment_n_words(ps_alignment_t *al)
Number of words.
Definition: ps_alignment.c:351
int ps_alignment_n_states(ps_alignment_t *al)
Number of states.
Definition: ps_alignment.c:363
int ps_alignment_iter_free(ps_alignment_iter_t *itor)
Release an iterator before completing all iterations.
Definition: ps_alignment.c:417
Implementation of HMM base structure.
ps_alignment_iter_t * ps_alignment_states(ps_alignment_t *al)
Iterate over the alignment starting at the first state.
Definition: ps_alignment.c:397
ps_alignment_iter_t * ps_alignment_iter_up(ps_alignment_iter_t *itor)
Get a new iterator starting at the parent of the current node.
Definition: ps_alignment.c:461
ps_alignment_t * ps_alignment_init(dict2pid_t *d2p)
Create a new, empty alignment.
Definition: ps_alignment.c:51
ps_alignment_iter_t * ps_alignment_iter_next(ps_alignment_iter_t *itor)
Move an alignment iterator forward.
Definition: ps_alignment.c:437
int ps_alignment_free(ps_alignment_t *al)
Release an alignment.
Definition: ps_alignment.c:59
ps_alignment_entry_t * ps_alignment_iter_get(ps_alignment_iter_t *itor)
Get the alignment entry pointed to by an iterator.
Definition: ps_alignment.c:411
int ps_alignment_n_phones(ps_alignment_t *al)
Number of phones.
Definition: ps_alignment.c:357
int ps_alignment_populate(ps_alignment_t *al)
Populate lower layers using available word information.
Definition: ps_alignment.c:129
int ps_alignment_populate_ci(ps_alignment_t *al)
Populate lower layers using context-independent phones.
Definition: ps_alignment.c:247
Building composite triphone (as well as word internal triphones) with the dictionary.
Definition: dict2pid.h:84