reiz.marker

Sending markers

Sending markers requires a MarkerServer running. This markerserver is used as a man-in-the-middle to forward all markers into an already existing LSLOutlet. This MarkerServer opens an Outlet that can be detected independently from the experiments you are running. When you then run an experiment, it receives messages from this experiment, and redistributes them in LSL-format.

LabRecorder can only start recording Outlets that are existing. If you start a MarkerServer immediatly before you run the experiment, there might not be sufficient time for LabRecorder to detect the stream. Certainly, it adds some precious seconds for starting the Outlet, and delays your run.

We recommend to use a reiz-marker-Server as an independent process. Using reiz-marker allows easier recording, reduces computational load on your main script, and can prevent forgetting to record a MarkerStream with LabRecorder. It does though add a little bit more complexity and a miniscule delay.

From the terminal

You can start the MarkerServer as an independent process with reiz-marker from your terminal and shut it down gracefull with reiz-marker –kill.

usage: reiz-marker [-h] [--port PORT] [--host HOST] [--name NAME] [--ping] [--kill]

Reiz Marker Server

optional arguments:
-h, --help   show this help message and exit
--port PORT  Marker Server port.
--host HOST  Marker Server host ip.
--name NAME  Marker Server name.
--ping       test connection to Markerserver
--kill       send a poison pill to the Markerserver

From within Python

Alternatively, start() starts such a process from within Python, and you can kill it later with stop(). You can additionally safeguard your script to make sure a MarkerServer is running in at least these two ways:

  1. check whether the MarkerServer is avaible, and abort with a notice, if that is not the case.

  2. start a throw-away MarkerServer with start().

Sending markers

There is not much need to push markers for stimuli events manually, as you can create a Cue and add the desired marker-string during instantiation. Often, you want to send additional information, e.g. the age and id of the subject, or the parameters with which the experiment was run. In these cases, pushing dictionaries or arbitrary strings during initialization of your experiment can be useful.

push([marker, tstamp, sanitize, port])

push a marker to the MarkerServer for redistribution as LSL

push_json([marker, tstamp])

encode a dictionary as json and push it to the MarkerServer

Safeguarding

available([port, verbose])

test whether a markerserver is already available at port

start()

start a throw-away MarkerServer

stop()

stop the throw-away MarkerServer