nltk.corpus.reader.TaggedCorpusReader

class documentation

class TaggedCorpusReader(CorpusReader): (source)

Known subclasses: nltk.corpus.reader.CategorizedTaggedCorpusReader, nltk.corpus.reader.MacMorphoCorpusReader, nltk.corpus.reader.MTECorpusReader, nltk.corpus.reader.TimitTaggedCorpusReader

Constructor: TaggedCorpusReader(root, fileids, sep, word_tokenizer, ...)

View In Hierarchy

Reader for simple part-of-speech tagged corpora. Paragraphs are assumed to be split using blank lines. Sentences and words can be tokenized using the default tokenizers, or by custom tokenizers specified as parameters to the constructor. Words are parsed using nltk.tag.str2tuple. By default, '/' is used as the separator. I.e., words should have the form:

word1/tag1 word2/tag2 word3/tag3 ...

But custom separators may be specified as parameters to the constructor. Part of speech tags are case-normalized to upper case.

Method	`__init__`	Construct a new Tagged Corpus reader for a set of documents located at the given root directory. Example usage:
Method	`paras`	No summary
Method	`raw`	No summary
Method	`sents`	No summary
Method	`tagged_paras`	No summary
Method	`tagged_sents`	No summary
Method	`tagged_words`	No summary
Method	`words`	No summary
Instance Variable	`_para_block_reader`	Undocumented
Instance Variable	`_sent_tokenizer`	Undocumented
Instance Variable	`_sep`	Undocumented
Instance Variable	`_tagset`	Undocumented
Instance Variable	`_word_tokenizer`	Undocumented

Inherited from CorpusReader:

Method	`__repr__`	Undocumented
Method	`abspath`	Return the absolute path for the given file.
Method	`abspaths`	Return a list of the absolute paths for all fileids in this corpus; or for the given list of fileids, if specified.
Method	`citation`	Return the contents of the corpus citation.bib file, if it exists.
Method	`encoding`	Return the unicode encoding for the given corpus file, if known. If the encoding is unknown, or if the given file should be processed using byte strings (str), then return None.
Method	`ensure_loaded`	Load this corpus (if it has not already been loaded). This is used by LazyCorpusLoader as a simple method that can be used to make sure a corpus is loaded -- e.g., in case a user wants to do help(some_corpus).
Method	`fileids`	Return a list of file identifiers for the fileids that make up this corpus.
Method	`license`	Return the contents of the corpus LICENSE file, if it exists.
Method	`open`	Return an open stream that can be used to read the given file. If the file's encoding is not None, then the stream will automatically decode the file's contents into unicode.
Method	`readme`	Return the contents of the corpus README file, if it exists.
Class Variable	`root`	Undocumented
Method	`_get_root`	Undocumented
Instance Variable	`_encoding`	The default unicode encoding for the fileids that make up this corpus. If `encoding` is None, then the file contents are processed using byte strings.
Instance Variable	`_fileids`	A list of the relative paths for the fileids that make up this corpus.
Instance Variable	`_root`	The root directory for this corpus.

def __init__(self, root, fileids, sep='/', word_tokenizer=WhitespaceTokenizer(), sent_tokenizer=RegexpTokenizer('\n', gaps=True), para_block_reader=read_blankline_block, encoding='utf8', tagset=None): (source) ¶

overrides nltk.corpus.reader.CorpusReader.__init__

overridden in nltk.corpus.reader.CategorizedTaggedCorpusReader, nltk.corpus.reader.MacMorphoCorpusReader, nltk.corpus.reader.MTECorpusReader, nltk.corpus.reader.TimitTaggedCorpusReader

Construct a new Tagged Corpus reader for a set of documents located at the given root directory. Example usage:

>>> root = '/...path to corpus.../'
>>> reader = TaggedCorpusReader(root, '.*', '.txt') # doctest: +SKIP

Parameters
root	The root directory for this corpus.
fileids	A list or regexp specifying the fileids in this corpus.
sep	Undocumented
word_tokenizer	Undocumented
sent_tokenizer	Undocumented
para_block_reader	Undocumented
encoding	Undocumented
tagset	Undocumented

def paras(self, fileids=None): (source) ¶

overridden in nltk.corpus.reader.CategorizedTaggedCorpusReader, nltk.corpus.reader.MTECorpusReader, nltk.corpus.reader.TimitTaggedCorpusReader

Returns
list(list(list(str)))	the given file(s) as a list of paragraphs, each encoded as a list of sentences, which are in turn encoded as lists of word strings.

def raw(self, fileids=None): (source) ¶