/ 
DTA-CAB-1.115
River stage zero No dependents
/ DTA::CAB::Chain

NAME

DTA::CAB::Chain - serial multi-analyzer pipeline

SYNOPSIS

use DTA::CAB::Chain;

##========================================================================
## Constructors etc.

$obj = CLASS_OR_OBJ->new(%args);
@keys = $anl->typeKeys(\%opts);

##========================================================================
## Methods: Chain selection

\@analyzers = $ach->chain();
\@analyzers = $ach->subAnalyzers();

##========================================================================
## Methods: I/O

$bool = $ach->ensureLoaded();

##========================================================================
## Methods: Analysis

$bool = $ach->canAnalyze();
$bool = $anl->enabled(\%opts);
undef = $anl->initInfo();

$doc = $ach->analyzeTypes($doc,$types,\%opts);
$doc = $ach->analyzeSentences($doc,\%opts);
$doc = $ach->analyzeLocal($doc,\%opts);
$doc = $ach->analyzeClean($doc,\%opts);

DESCRIPTION

DTA::CAB::Chain is an abstract DTA::CAB::Analyzer subclass for implementing serial document processing "pipelines" or "cascades" in terms of a flat list of DTA::CAB::Analyzer objects.

Constructors etc.

new
$obj = CLASS_OR_OBJ->new(%args);

%$obj, %args:

chain => [ $a1, $a2, ..., $aN ],        ##-- default analysis chain; see also chain() method (default: empty)
typeKeys
@keys = $anl->typeKeys(\%opts);

Returns list of type-wise keys to be expanded for this analyzer by expandTypes() Default implementation just concatenates typeKeys() for sub-analyzers.

Methods: Chain selection

chain
\@analyzers = $ach->chain();
\@analyzers = $ach->chain(\%opts)

Get selected analyzer chain. Default method returns all globally enabled analyzers in $anl->{chain}.

subAnalyzers
\@analyzers = $ach->subAnalyzers();
\@analyzers = $ach->subAnalyzers(\%opts)

Returns a list of all sub-analyzers. Override just calls chain().

Methods: I/O

ensureLoaded
$bool = $ach->ensureLoaded();
$bool = $ach->ensureLoaded(\%opts)

Ensures analysis data is loaded from default files Override calls $a->ensureLoaded() for each $a in $ach->subAnalyzers(\%opts).

Methods: Analysis

canAnalyze
$bool = $ach->canAnalyze();
$bool = $ach->canAnalyze(\%opts)

Returns true if analyzer can perform its function (e.g. data is loaded & non-empty). Override returns true if all enabled analyzers in the chain can analyze.

enabled
$bool = $anl->enabled(\%opts);

Returns $anl->{enabled} and (disjunction over all sub-analyzers).

initInfo
undef = $anl->initInfo();

Logs initialization info. Default method reports values of {label}, enabled().

Methods: Analysis: API

analyzeTypes
$doc = $ach->analyzeTypes($doc,$types,\%opts);

Perform type-wise analysis of all (text) types in $doc->{types}. Chain default calls $a->analyzeTypes for each analyzer $a in the chain.

analyzeSentences
$doc = $ach->analyzeSentences($doc,\%opts);

Perform sentence-wise analysis of all sentences $doc->{body}[$si]. Chain default calls $a->analyzeSentences for each analyzer $a in the chain.

analyzeLocal
$doc = $ach->analyzeLocal($doc,\%opts);

Perform local document-level analysis of $doc. Chain default calls $a->analyzeLocal for each analyzer $a in the chain.

analyzeClean
$doc = $ach->analyzeClean($doc,\%opts);

Cleanup any temporary data associated with $doc. Chain default calls $a->analyzeClean for each analyzer $a in the chain, then superclass Analyzer->analyzeClean.

AUTHOR

Bryan Jurish <moocow@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2010-2019 by Bryan Jurish

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

SEE ALSO

dta-cab-analyze.perl(1), DTA::CAB::Analyzer(3pm), DTA::CAB::Chain::Multi(3pm), DTA::CAB(3pm), perl(1), ...