nltk.corpus.reader.MTECorpusReader

class nltk.corpus.reader.MTECorpusReader

Bases: TaggedCorpusReader

Reader for corpora following the TEI-p5 xml scheme, such as MULTEXT-East. MULTEXT-East contains part-of-speech-tagged words with a quite precise tagging scheme. These tags can be converted to the Universal tagset

__init__(root=None, fileids=None, encoding='utf8')

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

>>> root = '/...path to corpus.../'
>>> reader = MTECorpusReader(root, 'oana-*.xml', 'utf8') 

Parameters

• root – The root directory for this corpus. (default points to location in multext config file)

• fileids – A list or regexp specifying the fileids in this corpus. (default is oana-en.xml)

• encoding – The encoding of the given files (default is utf8)

words(fileids=None)

Parameters

fileids – A list specifying the fileids that should be used.

Returns

the given file(s) as a list of words and punctuation symbols.

Return type

list(str)

sents(fileids=None)

Parameters

fileids – A list specifying the fileids that should be used.

Returns

the given file(s) as a list of sentences or utterances, each encoded as a list of word strings

Return type

list(list(str))

paras(fileids=None)

Parameters

fileids – A list specifying the fileids that should be used.

Returns

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 string

Return type

list(list(list(str)))

lemma_words(fileids=None)

Parameters

fileids – A list specifying the fileids that should be used.

Returns

the given file(s) as a list of words, the corresponding lemmas and punctuation symbols, encoded as tuples (word, lemma)

Return type

list(tuple(str,str))

tagged_words(fileids=None, tagset='msd', tags='')

Parameters

• fileids – A list specifying the fileids that should be used.

• tagset – The tagset that should be used in the returned object, either “universal” or “msd”, “msd” is the default

• tags – An MSD Tag that is used to filter all parts of the used corpus that are not more precise or at least equal to the given tag

Returns

the given file(s) as a list of tagged words and punctuation symbols encoded as tuples (word, tag)

Return type

list(tuple(str, str))

lemma_sents(fileids=None)

Parameters

fileids – A list specifying the fileids that should be used.

Returns

the given file(s) as a list of sentences or utterances, each encoded as a list of tuples of the word and the corresponding lemma (word, lemma)

Return type

list(list(tuple(str, str)))

tagged_sents(fileids=None, tagset='msd', tags='')

Parameters

• fileids – A list specifying the fileids that should be used.

• tagset – The tagset that should be used in the returned object, either “universal” or “msd”, “msd” is the default

• tags – An MSD Tag that is used to filter all parts of the used corpus that are not more precise or at least equal to the given tag

Returns

the given file(s) as a list of sentences or utterances, each each encoded as a list of (word,tag) tuples

Return type

list(list(tuple(str, str)))

lemma_paras(fileids=None)

Parameters

fileids – A list specifying the fileids that should be used.

Returns

the given file(s) as a list of paragraphs, each encoded as a list of sentences, which are in turn encoded as a list of tuples of the word and the corresponding lemma (word, lemma)

Return type

list(List(List(tuple(str, str))))

tagged_paras(fileids=None, tagset='msd', tags='')

Parameters

• fileids – A list specifying the fileids that should be used.

• tagset – The tagset that should be used in the returned object, either “universal” or “msd”, “msd” is the default

• tags – An MSD Tag that is used to filter all parts of the used corpus that are not more precise or at least equal to the given tag

Returns

the given file(s) as a list of paragraphs, each encoded as a list of sentences, which are in turn encoded as a list of (word,tag) tuples

Return type

list(list(list(tuple(str, str))))

abspath(fileid)

Return the absolute path for the given file.

Parameters

fileid (str) – The file identifier for the file whose path should be returned.

Return type

PathPointer

abspaths(fileids=None, include_encoding=False, include_fileid=False)

Return a list of the absolute paths for all fileids in this corpus; or for the given list of fileids, if specified.

Parameters

• fileids (None or str or list) – Specifies the set of fileids for which paths should be returned. Can be None, for all fileids; a list of file identifiers, for a specified set of fileids; or a single file identifier, for a single file. Note that the return value is always a list of paths, even if fileids is a single file identifier.

• include_encoding – If true, then return a list of (path_pointer, encoding) tuples.

Return type

list(PathPointer)

citation()

Return the contents of the corpus citation.bib file, if it exists.

encoding(file)

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.

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).

fileids()

Return a list of file identifiers for the fileids that make up this corpus.

license()

Return the contents of the corpus LICENSE file, if it exists.

open(file)

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.

Parameters

file – The file identifier of the file to read.

raw(fileids=None)

Parameters

fileids – A list specifying the fileids that should be used.

Returns

the given file(s) as a single string.

Return type

str

readme()

Return the contents of the corpus README file, if it exists.

property root

The directory where this corpus is stored.

Type

PathPointer