delphin.mrs.penman

Serialization functions for the PENMAN graph format.

Unlike other *MRS serializers, this one takes a model argument for the load(), loads(), dump(), and dumps() methods, which determines what the graph will look like. This is because DMRS and EDS (and possibly others in the future) yield different graph structures, but both can be encoded as PENMAN graphs. In this sense, it is somewhat like how JSON formatting of *MRS is handled in PyDelphin.

class delphin.mrs.penman.XMRSCodec(indent=True, relation_sort=<function original_order>)

A customized PENMAN codec class for *MRS data.

delphin.mrs.penman.dump(destination, xs, model=None, properties=False, indent=True, **kwargs)

Serialize Xmrs (or subclass) objects to PENMAN and write to a file.

Parameters:

• destination – filename or file object
• xs – iterator of Xmrs objects to serialize
• model – Xmrs subclass used to get triples
• properties – if True, encode variable properties
• indent – if True, adaptively indent; if False or None, don’t indent; if a non-negative integer N, indent N spaces per level

delphin.mrs.penman.dumps(xs, model=None, properties=False, indent=True, **kwargs)

Serialize Xmrs (or subclass) objects to PENMAN notation

Parameters:

• xs – iterator of Xmrs objects to serialize
• model – Xmrs subclass used to get triples
• properties – if True, encode variable properties
• indent – if True, adaptively indent; if False or None, don’t indent; if a non-negative integer N, indent N spaces per level

Returns:

the PENMAN serialization of xs

delphin.mrs.penman.load(fh, model)

Deserialize PENMAN graphs from a file (handle or filename)

Parameters:

• fh – filename or file object
• model – Xmrs subclass instantiated from decoded triples

Returns:

a list of objects (of class model)

delphin.mrs.penman.loads(s, model)

Deserialize PENMAN graphs from a string

Parameters:

• s (str) – serialized PENMAN graphs
• model – Xmrs subclass instantiated from decoded triples

Returns:

a list of objects (of class model)