NAME

       mlpack_hmm_generate - hidden markov model (hmm) sequence generator

SYNOPSIS

        mlpack_hmm_generate -l int -m unknown [-s int] [-t int] [-V bool] [-o string] [-S string] [-h -v]

DESCRIPTION

       This utility takes an already-trained HMM, specified as the '--model_file (-m)' parameter,
       and generates a random observation  sequence  and  hidden  state  sequence  based  on  its
       parameters.  The  observation  sequence  may be saved with the '--output_file (-o)' output
       parameter, and the internal state sequence may  be  saved  with  the  '--state_file  (-S)'
       output parameter.

       The  state  to  start  the  sequence  in  may  be  specified with the '--start_state (-t)'
       parameter.

       For example, to generate a sequence of length 150 from the  HMM  'hmm.bin'  and  save  the
       observation  sequence to 'observations.csv' and the hidden state sequence to 'states.csv',
       the following command may be used:

       $ mlpack_hmm_generate --model_file hmm.bin  --length  150  --output_file  observations.csv
       --state_file states.csv

REQUIRED INPUT OPTIONS

       --length (-l) [int]
              Length of sequence to generate.

       --model_file (-m) [unknown]
              Trained HMM to generate sequences with.

OPTIONAL INPUT OPTIONS

       --help (-h) [bool]
              Default help info.

       --info [string]
              Print help on a specific option. Default value ''.

       --seed (-s) [int]
              Random seed. If 0, 'std::time(NULL)' is used.  Default value 0.

       --start_state (-t) [int]
              Starting state of sequence. Default value 0.

       --verbose (-v) [bool]
              Display  informational  messages  and the full list of parameters and timers at the
              end of execution.

       --version (-V) [bool]
              Display the version of mlpack.

OPTIONAL OUTPUT OPTIONS

       --output_file (-o) [string]
              Matrix to save observation sequence to.

       --state_file (-S) [string]
              Matrix to save hidden state sequence to.

ADDITIONAL INFORMATION

       For further information, including relevant papers, citations,  and  theory,  consult  the
       documentation found at http://www.mlpack.org or included with your distribution of mlpack.