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:

$ 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]

Get help on a specific module or 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. Default value ''.

--state_file (-S) [string]

Matrix to save hidden state sequence to. Default value ''.

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.