errors.tex

隐马尔科夫模型工具箱

%/* ----------------------------------------------------------- */
%/*                                                             */
%/*                          ___                                */
%/*                       |_| | |_/   SPEECH                    */
%/*                       | | | | \   RECOGNITION               */
%/*                       =========   SOFTWARE                  */ 
%/*                                                             */
%/*                                                             */
%/* ----------------------------------------------------------- */
%/* developed at:                                               */
%/*                                                             */
%/*      Speech Vision and Robotics group                       */
%/*      Cambridge University Engineering Department            */
%/*      http://svr-www.eng.cam.ac.uk/                          */
%/*                                                             */
%/*      Entropic Cambridge Research Laboratory                 */
%/*      (now part of Microsoft)                                */
%/*                                                             */
%/* ----------------------------------------------------------- */
%/*         Copyright: Microsoft Corporation                    */
%/*          1995-2000 Redmond, Washington USA                  */
%/*                    http://www.microsoft.com                 */
%/*                                                             */
%/*              2001  Cambridge University                     */
%/*                    Engineering Department                   */
%/*                                                             */
%/*   Use of this software is governed by a License Agreement   */
%/*    ** See the file License for the Conditions of Use  **    */
%/*    **     This banner notice must not be removed      **    */
%/*                                                             */
%/* ----------------------------------------------------------- */
%
% HTKBook - Julian Odell and Steve Young 15/11/95
%
% This chapter added to by Gareth Moore 17/01/02

\mychap{Error and Warning Codes}{errors}
\index{errors!full listing}\index{warning codes!full listing}

When a problem occurs in any \HTK\ tool, either
error\index{error message!format}
or warning messages\index{warning message!format} are printed.  

If a warning occurs then a message is sent to standard output and
execution continues. The format of this warning message is as follows:
\begin{verbatim}
    WARNING [-nnnn] Function: 'Brief Explanation' in HTool
\end{verbatim}

The message consists of four parts.  On the first line is the tool
name and the error number\index{error number!structure of}.  Positive
error numbers are fatal, whilst negative numbers are warnings and
allow execution to continue.  On the second line is the function in
which the problem occurred and a brief textual explanation.  The
reason for sending warnings to standard output is so that they are
synchronised with any trace output.

If an error occurs a number of error messages may be produced on
standard error. Many of the functions in the \HTK\ Library do not exit
immediately when an error condition occurs, but instead print a message and return a failure
value back to their calling function. This process may be repeated several
times. When the \HTK\ Tool that called the function receives the failure
value, it exits the program with a fatal error message. Thus the
displayed output has a typical format as follows:

\begin{verbatim}
  ERROR [+nnnn] FunctionA: 'Brief explanation'
  ERROR [+nnnn] FunctionB: 'Brief explanation'
  ERROR [+nnnn] FunctionC: 'Brief explanation'
 FATAL ERROR - Terminating program HTool
\end{verbatim}

Error numbers in \HTK\ are allocated on a module by module
and tool by tool basis in blocks of 100 as shown by the table shown
overleaf.
Within each block of 100 numbers the first 20 (0 - 19)
and the final 10 (90-99) are reserved for standard types 
of error which are common to all tools and library 
modules.

All other codes are module or tool specific.

\mysect{Generic Errors}{generr}

\begin{itemize}
\erno{+??00} Initialisation failed \\
        The initialisation procedure for the tool produced an
        error. This could be due to errors in the command line
        arguments or configuration file.
\erno{+??01} Facility not implemented \\
        HTK does not support the operation requested.

\erno{+??05} Available memory exhausted \\
        The operation requires more memory than is available.
\erno{+??06} Audio not available \\
        The audio device is not available, either there is no driver for
        the current machine, the library was compiled with \texttt{NO\_AUDIO}
        set or another process has exclusive access to the audio device.

\begin{center}
\begin{tabular}{|c|c|c|c|}
\hline
HCopy    & 1000-1099     & HShell        & 5000-5099    \\
HList    & 1100-1199     & HMem          & 5100-5199    \\
HLEd     & 1200-1299     & HMath         & 5200-5299    \\
HLStats  & 1300-1399     & HSigP         & 5300-5399    \\
HDMan    & 1400-1499     &               &              \\
HSLab    & 1500-1599     & HAudio        & 6000-6099    \\
         &               & HVQ           & 6100-6199    \\
         &               & HWave         & 6200-6299    \\
HCompV   & 2000-2099     & HParm         & 6300-6399    \\
HInit    & 2100-2199     & HLabel        & 6500-6599    \\
HRest    & 2200-2299     &               &              \\
HERest   & 2300-2399     & HGraf         & 6800-6899    \\
HSmooth  & 2400-2499     &               &              \\
HQuant   & 2500-2599     & HModel        & 7000-7099    \\
HHEd     & 2600-2699     & HTrain        & 7100-7199    \\
HEAdapt  & 2700-2799     & HUtil         & 7200-7299    \\
         &               & HFB           & 7300-7399    \\
         &               & HAdapt        & 7400-7499    \\
HBuild   & 3000-3099     &               &              \\
HParse   & 3100-3199     & HDict         & 8000-8099    \\
HVite    & 3200-3299     & HLM           & 8100-8199    \\
HResults & 3300-3399     & HNet          & 8200-8299    \\
HSGen    & 3400-3499     & HRec          & 8500-8599    \\
HLRescore& 4000-4100     & HLat          & 8600-8699    \\
\hline
LCMap    & 15000-15099   & LAdapt        & 16400-16499  \\
LWMap    & 15100-15199   & LPlex         & 16600-16699  \\
LUtil    & 15200-15299   & HLMCopy       & 16900-16999  \\
LGBase   & 15300-15399   & Cluster       & 17000-17099  \\
LModel   & 15400-15499   & LLink         & 17100-17199  \\
LPCalc   & 15500-15599   & LNewMap       & 17200-17299  \\
LPMerge  & 15600-15699   &               &              \\
\hline
\end{tabular}
\end{center}

\erno{+??10} Cannot open file for reading \\
        Specified file could not be opened for reading.  The file may not
        exist or the filter through which it is read may not be set correctly.
\erno{+??11} Cannot open file for writing \\
        Specified file could not be opened for writing.  The directory may
        not exist or be writable by the user or the filter through which the
        file is written may not be set correctly.
\erno{+??13} Cannot read from file \\
        Cannot read data from file.  The file may have been truncated,  
        incorrectly formatted or the filter process may have died.
\erno{+??14} Cannot write to file \\
        Cannot write data to file.  The file system is full or the filter
        process has died.

\erno{+??15} Required function parameter not set \\
        You have called a library routine without setting one of the arguments.
\erno{+??16} Memory heap of incorrect type \\
        Some library routines require you to pass them a heap of a particular
        type.

\erno{+??19} Command line syntax error \\
        The command line is badly formed, refer to the manual or the command
        summary printed when the command is executed without arguments.

\erno{+??9?} Sanity check failed \\
        Several functions perform checks that structures are self consistent
        and that everything is functioning correctly.  When these sanity checks
        fail they indicate the code is not functioning as intended.  These
        errors should not occur and are not correctable by the user.
\end{itemize}

\mysect{Summary of Errors by Tool and Module}{errsum}

\begin{itemize}

\module{\htool{HCopy}}

\begin{itemize}
\erno{+1030}    Non-existent part of file specified\\
        \htool{HCopy} needed to access a non-existent part of the input file.
        Check that the times are specified correctly, that the label file
        contains enough labels and that it corresponds to the data file.

\erno{\pm 1031} Label file formatted incorrectly\\
        \htool{HCopy} is only able to properly copy label files with the
        same number of levels/alternatives.  When using labels with multiple
        alternatives only the first one is used to determine segment 
        boundaries.

\erno{+1032}    Appending files of different type/size/rate\\
        Files that are joined together must have the same parameter kind and 
        sample rate.

\erno{-1089}    ALIEN format set\\
        Input/output format has been set to \texttt{ALIEN}, ensure that 
        this was intended.

\end{itemize}

\module{\htool{HList}}

\module{\htool{HLEd}}

\begin{itemize}
\erno{+1230}    Edit script syntax error\\
        The \htool{HLEd} command script contains a syntax error, check the 
        input script against the descriptions of each command in 
        section~\ref{s:HLEd} or obtained by running \texttt{HLEd -Q}.

\erno{\pm 1231} Operation invalid\\
        You have either exceeded \htool{HLEd} limits on the number of 
        boundaries that can be specified, tried to perform an operation on 
        a non-existent level or tried to sort an auxiliary level into time 
        order.  None of these operations are supported.

\erno{+1232}    Cannot find pronunciation\\
        The dictionary does not contain a valid pronunciation (only occurs
        when attempting expansion from a dictionary).

\erno{-1289}    ALIEN format set\\
        Input/output format has been set to \texttt{ALIEN}, ensure that 
        this was intended.

\end{itemize}

\module{\htool{HLStats}}

\begin{itemize}
\erno{+1328}    Load/Make HMMSet failed\\
        The model set could not be loaded due to either an error opening the
        file or the data within being inconsistent.

\erno{\pm 1330} No operation specified\\
        You have invoked \htool{HLStats} but have not specified an operation 
        to be performed.

\erno{-1389}    ALIEN format set\\
        Input format has been set to \texttt{ALIEN}, ensure that this was 
        intended.

\end{itemize}

\module{\htool{HDMan}}

\begin{itemize}
\erno{\pm 1430} Limit exceeded\\
        \htool{HDMan} has several built in limits on the number of different
        pronunciation, phones, contexts and command arguments.  This error 
        occurs when you try to exceed one of them.  

\erno{\pm 1431} Item not found\\
        Could not find item for deletion.  Check that it actually occurs in the
        dictionary.

\erno{\pm 1450} Edit script file syntax error\\
        The \htool{HDMan} command script contains a syntax error, check the 
        input script against the descriptions of each command in 
        section~\ref{s:HDMan} or obtained by running \texttt{HDMan -Q}.

\erno{\pm 1451} Dictionary file syntax error\\
        One of the input dictionaries contained a syntax error.  Ensure that 
        it is in a \HTK\ readable form (see section~\ref{s:usehdman}).

\erno{\pm 1452} Word out of order in dictionary error\\
        Entries in the dictionary must be sorted into alphabetical (ASCII) order.

\end{itemize}

\module{\htool{HSLab}}

\begin{itemize}
\erno{-1589}    ALIEN format set\\
        Input/output format has been set to \texttt{ALIEN}, ensure that 
        this was intended.

\end{itemize}

\module{\htool{HCompV}}

\begin{itemize}
\erno{+2020}    HMM does not appear in HMMSet\\
        Supplied HMM filename does not appear in HMMSet. Check
        correspondence between HMM filename and HMMSet.

\erno{+2021}    Not enough data to calculate variance\\
        There are not enough frames of data to evaluate a
        reliable estimate of variance. Use more data.

\erno{+2028}    Load/Make HMMSet failed\\
        The model set could not be loaded due to either an error opening the
        file or the data within being inconsistent.

\erno{+2030}    Needs continuous models\\
        HCompV can only operate on models with an HMM set kind
        of \texttt{PLAINHS} or \texttt{SHAREDHS}.

\erno{+2039}    Speaker pattern matching failure\\
        The specified speaker pattern could not be matched against a
        given untterance file name.

\erno{+2050}    Data does not match HMM\\
        An aspect of the data does not match the equivalent aspect in 
        the HMMSet.  Check the parameter kind of the data.

\erno{-2089}    ALIEN format set\\
        Input format has been set to \texttt{ALIEN}, ensure that this was 
        intended.

\end{itemize}

\module{\htool{HInit}}

\begin{itemize}
\erno{+2120}    Unknown update flag\\
        Unknown flag set by \texttt{-u} option, use combinations of 
        \texttt{tmvw}.

\erno{+2121}    Too little data\\
        Not enough data to reliably estimate parameters.  Use more 
        training data.

\erno{+2122}    Segment with fewer frames than model states\\
        Segment may be too short to be matched to model, do not use
        this segment for training.

\erno{+2123}    Cannot mix covariance kind in a single mix\\
        Covariance kind of all mixture components in any one state must be
        the same.

\erno{+2124}    Bad covariance kind\\