Module data

Find the given resource from the NLTK data package, and return a corresponding path name. If the given resource is not found, raise a LookupError, whose message gives a pointer to the installation instructions for the NLTK data package.

Parameters:

• resource_name (str) - The name of the resource to search for. Resource names are posix-style relative path names, such as 'corpora/brown'. In particular, directory names should always be separated by the '/' character, which will be automatically converted to a platform-appropriate path separator.

Returns: str

Copy the given resource to a local file. If no filename is specified, then use the URL's filename. If there is already a file named filename, then raise a ValueError.

Parameters:

• resource_url (str) - A URL specifying where the resource should be loaded from. The default protocol is "nltk:", which searches for the file in the the NLTK data package.

Load a given resource from the NLTK data package. The following resource formats are currently supported:

• 'pickle'
• 'yaml'
• 'cfg' (context free grammars)
• 'pcfg' (probabilistic CFGs)
• 'fcfg' (feature-based CFGs)
• 'fol' (formulas of First Order Logic)
• 'val' (valuation of First Order Logic model)
• 'raw'

If no format is specified, load() will attempt to determine a format based on the resource name's file extension. If that fails, load() will raise a ValueError exception.

Parameters:

• resource_url (str) - A URL specifying where the resource should be loaded from. The default protocol is "nltk:", which searches for the file in the the NLTK data package.
• cache (bool) - If true, add this resource to a cache. If load finds a resource in its cache, then it will return it from the cache rather than loading it. The cache uses weak references, so a resource wil automatically be expunged from the cache when no more objects are using it.
• verbose (bool) - If true, print a message when loading a resource. Messages are not displayed when a resource is retrieved from the cache.

Write out a grammar file, ignoring escaped and empty lines

Parameters:

• resource_url (str) - A URL specifying where the resource should be loaded from. The default protocol is "nltk:", which searches for the file in the the NLTK data package.
• escape (str) - Prepended string that signals lines to be ignored

Remove all objects from the resource cache.

path

A list of directories where the NLTK data package might reside. These directories will be checked in order when looking for a resource in the data package. Note that this allows users to substitute in their own versions of resources, if they have them (e.g., in their home directory under ~/nltk/data).

Value:

['/users/sb/nltk/data', '/Users/sb/nltk_data', '/usr/share/nltk_data', '/usr/local/share/nltk_data', '/usr/lib/nltk_data', '/usr/local/lib/nltk_data']

FORMATS

A dictionary describing the formats that are supported by NLTK's load() method. Keys are format names, and values are format descriptions.

Value:

{'cfg': 'A context free grammar, parsed by nltk.cfg.parse_cfg().', 'fcfg': 'A feature CFG, parsed by nltk.cfg.parse_fcfg().', 'fol': 'A list of first order logic expressions, parsed by nltk.sem.p arse_fol().', 'pcfg': 'A probabilistic CFG, parsed by nltk.cfg.parse_pcfg().', 'pickle': 'A serialized python object, stored using the pickle module .', 'raw': 'The raw (byte string) contents of a file.', ...

AUTO_FORMATS

A dictionary mapping from file extensions to format names, used by load() when format="auto" to decide the format for a given resource url.

Value:

{'cfg': 'cfg', 'fcfg': 'fcfg', 'fol': 'fol', 'pcfg': 'pcfg', 'pickle': 'pickle', 'val': 'val', 'yaml': 'yaml'}