Marker Commands¶

:MARKer[:GET]?¶

Syntax	:MARKer[:GET]?
Description	Gets the list of marker events generated by OXYGEN. Note: This is the default query of the MARKer group.
Parameter	None
Explanation	Queries the complete OXYGEN marker event list. The time format of each event’s time can be controlled with the :MARK:TFOR command below (see example).
Return Format	`(<type>, <name>, <description>, <time>, <reserved>), (...), ...` \| `NONE` `type`: the event type, as <string> `name`: the event name, as <string> `description`: extra information about the event, as <string> `time`: <nrf> \| <string>. The event time. It is a number (<nrf>) in seconds, counted from the start of the acquisition or the recording. Or it is text (<string>) in absolute ISO time format. `reserved`: this field is empty and reserved for future use
Example	-> :MARK:TFOR? <- ACQ_TIME -> :MARK:GET? //:MARK? is the equivalent query <- ("RECORDING_START","Recording Start","",11361.292100000000573,""), ("RECORDING_PAUSE","Recording Pause","",11363.814300000000003,"") ... -> :MARK:TFOR ABS_TIME -> :MARK? //equivalent query <- ("RECORDING_START","Recording Start","","2026-09-02T13:44:10.900100096+02:00",""), ("RECORDING_PAUSE","Recording Pause","","2026-09-02T13:44:13.422299904+02:00","") ... -> :MARK:TFOR REL_TIME -> :MARK? <- ("RECORDING_START","Recording Start","",0.0,""),("RECORDING_PAUSE","Recording Pause","",2.5222,"")

: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 one marker at time <time> (in seconds after the start of the acquisition), with the name <label> and the text <description>. If you do not give a <time> value, 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:TFORmat?¶

Syntax	:MARKer:TFORmat?
Description	Queries the current SCPI session local time format variable.
Parameter	None
Explanation	Shows the session-local time format that is currently used for the returned SCPI marker list (see the :MARK:GET? query).
Return Format	<literal> ACQ_TIME (default) - timestamps in seconds since acquisition start ABS_TIME - absolute timestamp string in ISO format incl. local timezone offset REL_TIME - relative timestamps in seconds since last significant measurement event
Example	-> :MARK:TFOR? <- ACQ_TIME

:MARKer:TFORmat <literal>¶

Syntax

:MARKer:TFORmat <literal>

Description

Sets the SCPI session local time format.

Parameter

Name	Type	Range	Default
Time format	literal	ACQ_TIME \| ABS_TIME \| REL_TIME	None

Explanation

Changes the SCPI session local time format for the returned marker event list. See the :MARK:GET? query for more information.

Example

-> :MARK:TFOR?
<- ACQ_TIME
-> :MARK:TFOR ABS_TIME
-> :MARK:TFOR?
<- ABS_TIME

Marker Setup Subsystem¶

With the commands and queries in the setup subsystem, you can get and set the event list settings of the OXYGEN event list page.

:MARKer:SETup[:TFORmat]?¶

Syntax	:MARKer:SETup[:TFORmat]?
Description	Queries the current event list time format from OXYGEN.
Parameter	None
Explanation	Shows the time format that is currently used for the event list.
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 time format used for the event list.

Parameter

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

Explanation

Changes the time format used for the event list.

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 how many decimal places are used for 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 number of decimal places used for the event list timestamps.

Parameter

Name	Type	Range	Default
Time precision	nrf	0-9	None

Explanation

Changes the number of decimal places used for the event list timestamps.

Example

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