Marker Commands¶

:MARKer[:GET]? [<time_format>]¶

Syntax

:MARKer[:GET]? [<time_format>]

Description

Get a list of generated OXYGEN marker events. Note: this is the default query of the MARKer group.

Parameter

Name	Type	Range	Default
<time_format>	<literal>	ACQ \| REC \| ISO	ACQ

Explanation

Queries the full OXYGEN marker event list. Note: a measurement or a DMD file must be active in order to obtain events from the list.

Return Format

(<type>, <name>, <description>, <time>), (...), ... | NONE

type: event type as <string>
name: event name as <string>
description: event info as <string>
time: <nrf> | <string>. Event time as <nrf> in seconds relative to acquisition start or recording start, or as <string> in absolute ISO time format.

Example

-> :MARK:GET?  //:MARK? is the equivalent query
<- ("RECORDING_START","Recording Start","",8.206099999999999),("RECORDING_PAUSE","Recording Pause","",10.739800000000001)
...
-> :MARK? ACQ  //equivalent query
<- ("RECORDING_START","Recording Start","",8.206099999999999),("RECORDING_PAUSE","Recording Pause","",10.739800000000001)
...
-> :MARK? REC
<- ("RECORDING_START","Recording Start","",0.0),("RECORDING_PAUSE","Recording Pause","",2.5337)
...
-> :MARK? ISO
<- ("RECORDING_START","Recording Start","","2026-08-11T15:25:42.90099968+02:00"),("RECORDING_PAUSE","Recording Pause","","2026-08-11T15:25:44.623800064+02:00")

:MARKer:ADD <label>[,<description>][,<time>]¶

Syntax

:MARKer:ADD <label>[,<description>][,<time>]

Description

Add a marker to the current measurement.

Parameter

Name	Type	Default
<label>	ASCII String	None
<description>	ASCII String	None
<time>	Nr2	Current time

Explanation

Adds a single marker at position <time> (in seconds from acquisition start) with <label> and description <description>. If no <time> parameter is specified in the parameter list, the marker is added at the current time.

Example

-> :MARK:ADD "Label 1","Description of Marker 1"
-> :MARK:ADD "Label 1",0.0
-> :MARK:ADD "Label 1","Description of Marker 1",1.2345
<- 0

:MARKer:SETup[:TFORmat]?¶

Syntax	:MARKer:SETup[:TFORmat]?
Description	Queries the current event list time format from OXYGEN.
Parameter	None
Explanation	Shows the current state of the event list time format.
Return Format	<literal> AUTO ABSOLUTE_TIME ABSOLUTE_DATE_TIME RELATIVE_TIME
Example	-> :MARKer:SETup:TFORmat? <- AUTO ... -> :MARK:SET? <- ABSOLUTE_DATE_TIME

:MARKer:SETup[:TFORmat] <literal>¶

Syntax

:MARKer:SETup[:TFORmat] <literal>

Description

Sets the event list time format property.

Parameter

Name	Type	Range	Default
Time format	literal	AUTO \| ABSOLUTE_TIME \| ABSOLUTE_DATE_TIME \| RELATIVE_TIME	None

Explanation

Sets the event list time format property state.

Example

-> :MARKer:SETup:TFORmat?
<- AUTO
-> :MARKer:SETup:TFORmat ABSOLUTE_DATE_TIME
-> :MARK:SET:TFOR?
<- ABSOLUTE_DATE_TIME
...
-> :MARK:SET RELATIVE_TIME //short form
-> :MARK:SET?
<- RELATIVE_TIME

:MARKer:SETup:PRECision?¶

Syntax	:MARKer:SETup:PRECision?
Description	Queries the current precision of event list timestamps.
Parameter	None
Explanation	Shows the current floating-point precision of the event list timestamps.
Return Format	<nrf>
Example	-> :MARKer:SETup:PRECision? <- 3 ... -> :MARK:SET:PREC? <- 3

:MARKer:SETup:PRECision <nrf>¶

Syntax

:MARKer:SETup:PRECision <nrf>

Description

Sets the event list timestamp precision.

Parameter

Name	Type	Range	Default
Time precision	nrf	0-9	None

Explanation

Sets the event list timestamp precision.

Example

-> :MARK:SET:PREC?
<- 3
-> :MARKer:SETup:PRECision 5
-> :MARK:SET:PREC?
<- 5
...
-> :MARK:SET:PREC 1 //short form
-> :MARK:SET?
<- 1