nltk.corpus.reader.Pl196xCorpusReader

class nltk.corpus.reader.Pl196xCorpusReader

Bases: CategorizedCorpusReader, XMLCorpusReader

head_len = 2770

__init__(*args, **kwargs)

Initialize this mapping based on keyword arguments, as follows:

• cat_pattern: A regular expression pattern used to find the category for each file identifier. The pattern will be applied to each file identifier, and the first matching group will be used as the category label for that file.

• cat_map: A dictionary, mapping from file identifiers to category labels.

• cat_file: The name of a file that contains the mapping from file identifiers to categories. The argument cat_delimiter can be used to specify a delimiter.

The corresponding argument will be deleted from kwargs. If more than one argument is specified, an exception will be raised.

decode_tag(tag)

textids(fileids=None, categories=None)

In the pl196x corpus each category is stored in single file and thus both methods provide identical functionality. In order to accommodate finer granularity, a non-standard textids() method was implemented. All the main functions can be supplied with a list of required chunks—giving much more control to the user.

words(fileids=None, categories=None, textids=None)

Returns all of the words and punctuation symbols in the specified file that were in text nodes – ie, tags are ignored. Like the xml() method, fileid can only specify one file.

Returns

the given file’s text nodes as a list of words and punctuation symbols

Return type

list(str)

sents(fileids=None, categories=None, textids=None)

paras(fileids=None, categories=None, textids=None)

tagged_words(fileids=None, categories=None, textids=None)

tagged_sents(fileids=None, categories=None, textids=None)

tagged_paras(fileids=None, categories=None, textids=None)

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)

categories(fileids=None)

Return a list of the categories that are defined for this corpus, or for the file(s) if it is given.

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(categories=None)

Return a list of file identifiers for the files that make up this corpus, or that make up the given category(s) if specified.

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, categories=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

xml(fileids=None, categories=None)