summaryrefslogtreecommitdiffstats
path: root/media/pocketsphinx/src/ps_alignment.h
diff options
context:
space:
mode:
Diffstat (limited to 'media/pocketsphinx/src/ps_alignment.h')
-rw-r--r--media/pocketsphinx/src/ps_alignment.h189
1 files changed, 189 insertions, 0 deletions
diff --git a/media/pocketsphinx/src/ps_alignment.h b/media/pocketsphinx/src/ps_alignment.h
new file mode 100644
index 000000000..a25d6975d
--- /dev/null
+++ b/media/pocketsphinx/src/ps_alignment.h
@@ -0,0 +1,189 @@
+/* -*- c-basic-offset: 4; indent-tabs-mode: nil -*- */
+/* ====================================================================
+ * Copyright (c) 2010 Carnegie Mellon University. All rights
+ * reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in
+ * the documentation and/or other materials provided with the
+ * distribution.
+ *
+ * This work was supported in part by funding from the Defense Advanced
+ * Research Projects Agency and the National Science Foundation of the
+ * United States of America, and the CMU Sphinx Speech Consortium.
+ *
+ * THIS SOFTWARE IS PROVIDED BY CARNEGIE MELLON UNIVERSITY ``AS IS'' AND
+ * ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+ * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY
+ * NOR ITS EMPLOYEES BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * ====================================================================
+ *
+ */
+
+/**
+ * @file ps_alignment.h Multi-level alignment structure
+ */
+
+#ifndef __PS_ALIGNMENT_H__
+#define __PS_ALIGNMENT_H__
+
+/* System headers. */
+
+/* SphinxBase headers. */
+#include <sphinxbase/prim_type.h>
+
+/* Local headers. */
+#include "dict2pid.h"
+#include "hmm.h"
+
+#define PS_ALIGNMENT_NONE ((uint16)0xffff)
+
+struct ps_alignment_entry_s {
+ union {
+ int32 wid;
+ struct {
+ uint16 ssid;
+ uint16 cipid;
+ uint16 tmatid;
+ } pid;
+ uint16 senid;
+ } id;
+ int16 start;
+ int16 duration;
+ uint16 parent;
+ uint16 child;
+};
+typedef struct ps_alignment_entry_s ps_alignment_entry_t;
+
+struct ps_alignment_vector_s {
+ ps_alignment_entry_t *seq;
+ uint16 n_ent, n_alloc;
+};
+typedef struct ps_alignment_vector_s ps_alignment_vector_t;
+
+struct ps_alignment_s {
+ dict2pid_t *d2p;
+ ps_alignment_vector_t word;
+ ps_alignment_vector_t sseq;
+ ps_alignment_vector_t state;
+};
+typedef struct ps_alignment_s ps_alignment_t;
+
+struct ps_alignment_iter_s {
+ ps_alignment_t *al;
+ ps_alignment_vector_t *vec;
+ int pos;
+};
+typedef struct ps_alignment_iter_s ps_alignment_iter_t;
+
+/**
+ * Create a new, empty alignment.
+ */
+ps_alignment_t *ps_alignment_init(dict2pid_t *d2p);
+
+/**
+ * Release an alignment
+ */
+int ps_alignment_free(ps_alignment_t *al);
+
+/**
+ * Append a word.
+ */
+int ps_alignment_add_word(ps_alignment_t *al,
+ int32 wid, int duration);
+
+/**
+ * Populate lower layers using available word information.
+ */
+int ps_alignment_populate(ps_alignment_t *al);
+
+/**
+ * Populate lower layers using context-independent phones.
+ */
+int ps_alignment_populate_ci(ps_alignment_t *al);
+
+/**
+ * Propagate timing information up from state sequence.
+ */
+int ps_alignment_propagate(ps_alignment_t *al);
+
+/**
+ * Number of words.
+ */
+int ps_alignment_n_words(ps_alignment_t *al);
+
+/**
+ * Number of phones.
+ */
+int ps_alignment_n_phones(ps_alignment_t *al);
+
+/**
+ * Number of states.
+ */
+int ps_alignment_n_states(ps_alignment_t *al);
+
+/**
+ * Iterate over the alignment starting at the first word.
+ */
+ps_alignment_iter_t *ps_alignment_words(ps_alignment_t *al);
+
+/**
+ * Iterate over the alignment starting at the first phone.
+ */
+ps_alignment_iter_t *ps_alignment_phones(ps_alignment_t *al);
+
+/**
+ * Iterate over the alignment starting at the first state.
+ */
+ps_alignment_iter_t *ps_alignment_states(ps_alignment_t *al);
+
+/**
+ * Get the alignment entry pointed to by an iterator.
+ */
+ps_alignment_entry_t *ps_alignment_iter_get(ps_alignment_iter_t *itor);
+
+/**
+ * Move alignment iterator to given index.
+ */
+ps_alignment_iter_t *ps_alignment_iter_goto(ps_alignment_iter_t *itor, int pos);
+
+/**
+ * Move an alignment iterator forward.
+ */
+ps_alignment_iter_t *ps_alignment_iter_next(ps_alignment_iter_t *itor);
+
+/**
+ * Move an alignment iterator back.
+ */
+ps_alignment_iter_t *ps_alignment_iter_prev(ps_alignment_iter_t *itor);
+
+/**
+ * Get a new iterator starting at the parent of the current node.
+ */
+ps_alignment_iter_t *ps_alignment_iter_up(ps_alignment_iter_t *itor);
+/**
+ * Get a new iterator starting at the first child of the current node.
+ */
+ps_alignment_iter_t *ps_alignment_iter_down(ps_alignment_iter_t *itor);
+
+/**
+ * Release an iterator before completing all iterations.
+ */
+int ps_alignment_iter_free(ps_alignment_iter_t *itor);
+
+#endif /* __PS_ALIGNMENT_H__ */