MWorks files are made up of events. Each event has

Unsigned integer. Time of event (in microseconds).

May be relative to system time or server start time.

Unsigned integer. Number assigned to this type of event.

Some are standard (0 = codec, etc...) others are experiment dependent.

Flexible type. The 'payload' of the event.

May be a dict, list, int, None, etc...

and names (as values).

An MWorks file can be opened in pymworks using pymworks.open_file.

:

import pymworks

fn = 'foo.mwk'

df = pymworks.open_file(fn)

set the indexed kwarg to False for open_file:

:

df = pymworks.open_file(fn, indexed=False)

reversed version (keys=names, values=codes) is available as df.rcodec

:

df.codec # dict, keys = codes, values = event names

df.rcodec # dict, keys = event names, values = codes

Events can be accessed several ways, the easiest being df.get_events.

:

evs = df.get_events() # get all events

cevs = df.get_events(0) # get all events with code 0

# get all events with name 'success'

sevs = df.get_events('success')

# get_events also accepts a list of names (or codes)

toevs = df.get_events(['success', 'failure', 'ignore'])

# or a timerange (in microseconds)

eevs = df.get_events(time_range=[0, 60 * 1E6]) # events during first minute

Events (type pymworks.datafile.Event) each contain a time, code and value

:

e = df.get_events('success')[0] # get first success event

e.time # time of event (in microseconds)

e.code # event code

e.value # value for event