NAME

Moot::HMM - libmoot : HMM

SYNOPSIS

  use Moot;

  ##=====================================================================
  ## Constructors etc
 
  $hmm  = Moot::HMM->new(\%opts);
  $opts = $hmm->config(\%opts);
  $opts = $hmm->config();

  ##=====================================================================
  ## Accessors
  ##  + all of the following are get/set methods, e.g.
  ##    `$hmm->verbose()' gets the value of the 'verbose' property, and
  ##    `$hmm->verbose($i)' sets it
 
  $val = $hmm->verbose();
  $ndots = $hmm->ndots();
 
  $save_ambiguities = $hmm->save_ambiguities();
  $save_flavors = $hmm->save_flavors();
  $save_mark_unknown = $hmm->save_mark_unknown();
 
  $hash_ngrams = $hmm->hash_ngrams();
  $relax = $hmm->relax();
  $use_lex_classes = $hmm->use_lex_classes();
 
  $start_tagid = $hmm->start_tagid();
 
  $unknown_lex_threshhold = $hmm->unknown_lex_threshhold();
  $unknown_class_threshhold = $hmm->unknown_class_threshhold();
 
  $nglambda1 = $hmm->nglambda1();
  $nglambda2 = $hmm->nglambda2();
  $nglambda3 = $hmm->nglambda3();
 
  $wlambda0 = $hmm->wlambda0();
  $wlambda1 = $hmm->wlambda1();
 
  $clambda0 = $hmm->clambda0();
  $clambda1 = $hmm->clambda1();
 
  $beamwd = $hmm->beamwd();
 
  $nsents = $hmm->nsents();
  $ntokens = $hmm->ntokens();
  $nnewtokens = $hmm->nnewtokens();
  $nunclassed = $hmm->nunclassed();
  $nnewclasses = $hmm->nnewclasses();
  $nunknown = $hmm->nunknown();
  $nfallbacks = $hmm->nfallbacks();

  ##=====================================================================
  ## Low-Level Lookup
 
  $logp = $hmm->wordp($word, $tag);          ##-- log p($word|$tag)
 
  $logp = $hmm->classp(\@tagset, $tag);      ##-- log p(\@tagset|$tag)
 
  $logp = $hmm->tagp($tag1);                 ##-- log p($tag1)              : raw
  $logp = $hmm->tagp($tag1,$tag2);           ##-- log p($tag2|$tag1)        : raw
  $logp = $hmm->tagp($tag1,$tag2,$tag3);     ##-- log p($tag3|$tag1,$tag2)  : raw?

  ##=====================================================================
  ## Tagging
 
  ## sentences are tagged in-place; structure:
  @sent = (
           {text=>'This'},
           {text=>'is',    tag=>'this_will_be_overwritten'},
           {text=>'a'      tag=>'this_too'},
           {text=>'test',  analyses=>[{tag=>'N',details=>'test/N'},
                                      {tag=>'V',details=>'test/V',prob=>42}] },
           {text=>'.'      analyses=>[{tag=>'$.'}]},
          );
 
  $hmm->tag_sentence(\@sent,$utf8=1,$trace=0);  ##-- clobbers 'tag' key of each token hash
 
  $hmm->tag_io    ( $reader, $writer );         ##-- sentence-stream tagging
  $hmm->tag_stream( $reader, $writer );         ##-- token-stream tagging

  ##=====================================================================
  ## I/O
 
  $hmm = $CLASS_OR_OBJECT->load($model);
  $hmm = $CLASS_OR_OBJECT->loadBin($binfile);
 
  $bool = $hmm->saveBin($binfile, $zlevel=-1);
  undef = $hmm->txtdump($filename='-');

DESCRIPTION

The Moot module provides an object-oriented interface to the libmoot library for Hidden Markov Model part-of-speech tagging.

SEE ALSO

Moot(3perl), Moot::Constants(3perl), moot(1), perl(1).

AUTHOR

Bryan Jurish <moocow@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2011-2013 by Bryan Jurish

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.14.2 or, at your option, any later version of Perl 5 you may have available.