DTA::TokWrap::Processor::tcfdecode0 - DTA tokenizer wrappers: TCF[tei,text,tokens,sentences]->TEI,text extraction
use DTA::TokWrap::Processor::tcfdecode0; $dec = DTA::TokWrap::Processor::tcfdecode0->new(%opts); $doc_or_undef = $dec->tcfdecode0($doc);
DTA::TokWrap::Processor::tcfdecode0 provides an object-oriented DTA::TokWrap::Processor wrapper for extracting the tei,text,tokens, and sentences layers from a tokenized TCF ("Text Corpus Format", cf. http://weblicht.sfs.uni-tuebingen.de/weblichtwiki/index.php/The_TCF_Format) document as originally encoded by a DTA::TokWrap::Processor::tcfencode ("tcfencoder") object. The encoded TCF document should have the following layers:
tei
text
tokens
sentences
Source TEI-XML encoded as an XML text node; should be identical to the source XML {xmlfile} or {xmldata} passed to the tcfencoder. Also accepts type "text/tei+xml".
Serialized text encoded as an XML text node; should be identical to the serialized text {txtfile} or {txtdata} passed to the tcfencoder.
Tokens returned by the tokenizer for the text layer. Document order of tokens should correspond exactly to the serial order of the associated text in the text layer.
Sentences returned by the tokenizer for the tokens in the tokens layer. Document order of sentences must correspond exactly to the serial order of the associated text in the text layer.
The following additional layers will be decoded if the decode_tcfa option is set to a true value:
decode_tcfa
TCF lemmata identified by tokenIDs in 1:1 correspondence with the tokens in the tokens layer.
tokenIDs
TCF part-of-speech tags identified by tokenIDs in 1:1 correspondence with the tokens in the tokens layer.
TCF orthographic normalizations (replace operations only) identified by tokenIDs in 1:1 correspondence with the tokens in the tokens layer.
replace
DTA::TokWrap::Processor::tcfdecode0 inherits from DTA::TokWrap::Processor.
$obj = $CLASS_OR_OBJECT->new(%args);
Constructor. Default %args:
decode_tcfx => $bool, ##-- whether to decode $tcfxdata (default=1) decode_tcft => $bool, ##-- whether to decode $tcftdata (default=1) decode_tcfw => $bool, ##-- whether to decode $tcfwdata (default=1) decode_tcfa => $bool, ##-- whether to decode $tcfadata (default=1)
%defaults = $CLASS->defaults();
Static class-dependent defaults.
$doc_or_undef = $CLASS_OR_OBJECT->tcfdecode0($doc);
Decode0s the {tcfdoc} key of the DTA::TokWrap::Document object to TCF, storing the result in $doc->{tcfxdata}, $doc->{tcftdata}, and $doc->{tcfwdata}.
$doc->{tcfxdata}
$doc->{tcftdata}
$doc->{tcfwdata}
Relevant %$doc keys:
tcfdoc => $tcfdoc, ##-- (input) TCF input document ## tcfxdata => $tcfxdata, ##-- (output) TEI-XML decode0d from TCF tcftdata => $tcftdata, ##-- (output) text data decode0d from TCF tcfwdata => $tcfwdata, ##-- (output) tokenized data decode0d from TCF, without byte-offsets, with "SID/WID" attributes tcfadata => $tcfadata, ##-- (output) annotation data decode0d from TCF ## tcfdecode0_stamp0 => $f, ##-- (output) timestamp of operation begin tcfdecode0_stamp => $f, ##-- (output) timestamp of operation end tcfxdata_stamp => $f, ##-- (output) timestamp of operation end tcftdata_stamp => $f, ##-- (output) timestamp of operation end tcfwdata_stamp => $f, ##-- (output) timestamp of operation end tcfadata_stamp => $f, ##-- (output) timestamp of operation end
DTA::TokWrap::Intro(3pm), dta-tokwrap.perl(1), ...
Bryan Jurish <moocow@cpan.org>
Copyright (C) 2014-2018 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.14.2 or, at your option, any later version of Perl 5 you may have available.
To install DTA::TokWrap, copy and paste the appropriate command in to your terminal.
cpanm
cpanm DTA::TokWrap
CPAN shell
perl -MCPAN -e shell install DTA::TokWrap
For more information on module installation, please visit the detailed CPAN module installation guide.