1mlpack_hmm_generate(1)           User Commands          mlpack_hmm_generate(1)
2
3
4

NAME

6       mlpack_hmm_generate - hidden markov model (hmm) sequence generator
7

SYNOPSIS

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

DESCRIPTION

12       This   utility   takes   an   already-trained  HMM,  specified  as  the
13       '--model_file (-m)'  parameter,  and  generates  a  random  observation
14       sequence  and hidden state sequence based on its parameters. The obser‐
15       vation sequence may be  saved  with  the  '--output_file  (-o)'  output
16       parameter,  and  the  internal  state  sequence  may  be saved with the
17       '--state_file (-S)' output parameter.
18
19       The  state  to  start  the  sequence  in  may  be  specified  with  the
20       '--start_state (-t)' parameter.
21
22       For  example,  to  generate  a  sequence  of  length  150  from the HMM
23       'hmm.bin' and save the observation sequence to  'observations.csv'  and
24       the hidden state sequence to 'states.csv', the following command may be
25       used:
26
27       $ hmm_generate --model_file hmm.bin --length 150 --output_file observa‐
28       tions.csv --state_file states.csv
29

REQUIRED INPUT OPTIONS

31       --length (-l) [int]
32              Length of sequence to generate.
33
34       --model_file (-m) [unknown]
35              Trained HMM to generate sequences with.
36

OPTIONAL INPUT OPTIONS

38       --help (-h) [bool]
39              Default help info.
40
41       --info [string]
42              Get help on a specific module or option.  Default value ''.
43
44       --seed (-s) [int]
45              Random seed. If 0, 'std::time(NULL)' is used.  Default value 0.
46
47       --start_state (-t) [int]
48              Starting state of sequence. Default value 0.
49
50       --verbose (-v) [bool]
51              Display  informational  messages and the full list of parameters
52              and timers at the end of execution.
53
54       --version (-V) [bool]
55              Display the version of mlpack.
56

OPTIONAL OUTPUT OPTIONS

58       --output_file (-o) [string]
59              Matrix to save observation sequence to. Default value ''.
60
61       --state_file (-S) [string]
62              Matrix to save hidden state sequence to.  Default value ''.
63

ADDITIONAL INFORMATION

65       For further information, including relevant papers, citations, and the‐
66       ory,  consult  the  documentation  found  at  http://www.mlpack.org  or
67       included with your distribution of mlpack.
68
69
70
71mlpack-3.0.4                   21 February 2019         mlpack_hmm_generate(1)