


MLPARSE(1)               USER COMMANDS                 MLPARSE(1)



NAME
     mlparse - parse a sequence of pattern vectors using  an  MLP
     and a grammar

SYNOPSIS
     mlparse  (-n  networkfile|-l  label-string|-i  anitem)   (-s
     sfsfile)  (-o sfsfile) (-p priorprobs) (-O anoffset) (-d) (-
     a) (-M) (-r patternbase) (-c|-t topN) (-m minblock) mlpmodel

DESCRIPTION
     mlparse takes as input a set of pattern vectors  (either  in
     PRW  files  or  on  the standard input), a simple transition
     network grammar and an MLP producing  activations  for  each
     terminal  symbol  for  each  vector, and determines the best
     sequence of labels using Viterbi decoding (dynamic  program-
     ming).   The  grammar  may be substiuted for a linear string
     specified on the command line or in an SFS  annotation  item
     for  the purposes of labelling.  The results may be saved as
     an annotation item (warning: it is easy to introduce artifi-
     cial offsets into the resulting annotations).

     Options:

     -I         Identify the program name and version.

     -nnetwork  Constrain the labels generated by a simple  tran-
                sition  network.   The  format of the network int
                the file is that specified by HTK.

     -llabel-string
                Constrain the labels to  the  sequence  specified
                (use  quotes  to delimit).  In this case only the
                positions of  the  annotations  in  time  are  of
                interest.

     -iannotationitem
                Constrain the labels generated  to  the  sequence
                specified  in the given annotation item in an SFS
                file.  In this case only  the  positions  of  the
                annotations  in time are of interest.  Use the -s
                option to specify the name of the SFS file.

     -ssfsfile  Specify the name of the SFS file to  provide  the
                input  annotations.   Also  specifies the default
                file for saving results as annotations.

     -a         Save results as annotations  into  an  SFS  file.
                Default is to print on the standard output.

     -osfsfile  Specify the name of an SFS  file  into  which  to
                save the results as annotations.  Defaults to the
                -s file.



SFS                     Last change: UCL                        1






MLPARSE(1)               USER COMMANDS                 MLPARSE(1)



     -Ooffset   Specify an offset to be added into any  generated
                annotation  item (this can be used to correct for
                offsets introduced by the vector generation  pro-
                cess).

     -d         Save the MLP outputs in a given  SFS  file  as  a
                display (DI) item.

     -ppriorprobs
                Specify a file containing prior probabilities for
                each  of  the  pattern  classes.  the file should
                contain lines containing a text label and a  real
                probability  only.   The program labstat produces
                the correct format.  The prior probabilities  are
                divided  into  the MLP output values before pars-
                ing.  Default, all classes equally likely.

     -M         Use simpler metric for comparing distance between
                net  outputs  and class.  Default is to normalise
                to a 'probability' for the class, p,  and  return
                1-p.  This option merely returns 1-activation for
                class node.

     -rpatternbase
                Specify the source basename for the pattern  vec-
                tors.   If  no  -r  option is specified or if the
                filename is  '-',  then  the  standard  input  is
                assumed.

input and
     Output recognition result as a  'confusion'  generated  from  the
                output frame labels.

     -ttopN     Output recognition results for the  topN  parses.
                Because  of  the  DP this only makes sense if the
                network in use consists  of  a  number  of  fully
                parallel  options.  The outputs are listed across
                a line with the score in parentheses.

     -mminblock Specify minimum duration of a  label  in  frames.
                Useful for re-alignment with -i an.

VERSION/AUTHOR
     11
       Mark Huckvale

SOURCE
     /users/mark/sfs/man/../prw/mlpw.src/mlparse.c







SFS                     Last change: UCL                        2



