Skip to content

Latest commit

 

History

History
70 lines (58 loc) · 2.6 KB

delphin.interface.rst

File metadata and controls

70 lines (58 loc) · 2.6 KB
Raw

delphin.interface

delphin.interface

This module manages the communication between data providers, namely processors like ACE or remote services like the DELPH-IN Web API, and user code or storage backends, namely [incr tsdb()] test suites <delphin.itsdb>. An interface sends requests to a provider, then receives and interprets the response.

The interface may also detect and deserialize supported DELPH-IN formats if the appropriate modules are available.

Processor

Response

Result

Wrapping a Processor for Preprocessing

The ~delphin.interface.Processor class can be used to implement a preprocessor that maintains the same interface as the underlying processor. The following example wraps an ~delphin.ace.ACEParser instance of the English Resource Grammar with a ~delphin.repp.REPP instance.

>>> from delphin import interface >>> from delphin import ace >>> from delphin import repp >>> >>> class REPPWrapper(interface.Processor): ... def __init__(self, cpu, rpp): ... self.cpu = cpu ... self.task = cpu.task ... self.rpp = rpp ... def process_item(self, datum, keys=None): ... preprocessed_datum = str(self.rpp.tokenize(datum)) ... return self.cpu.process_item(preprocessed_datum, keys=keys) ... >>> # The preprocessor can be used like a normal Processor: >>> rpp = repp.REPP.from_config('../../grammars/erg/pet/repp.set') >>> grm = '../../grammars/erg-2018-x86-64-0.9.30.dat' >>> with ace.ACEParser(grm, cmdargs=['-y']) as _cpu: ... cpu = REPPWrapper(_cpu, rpp) ... response = cpu.process_item('Abrams hired Browne.') ... for result in response.results(): ... print(result.mrs()) ... <Mrs object (proper named hire proper named) at 140488735960480> <Mrs object (unknown compound udef named hire parg addressee proper named) at 140488736005424> <Mrs object (unknown proper compound udef named hire parg named) at 140488736004864> NOTE: parsed 1 / 1 sentences, avg 1173k, time 0.00986s

A similar technique could be used to manage external processes, such as MeCab for morphological segmentation of Japanese for Jacy. It could also be used to make a postprocessor, a backoff mechanism in case an input fails to parse, etc.