# :MARKer:Y:POSition

:MARKer Manual-Line Commands

- :MARKer:X:POSition
- :MARKer:X:STATe
- :MARKer:Y:POSition
- :MARKer:Y:STATe
- :MARKer:REFerence

## Command Syntax

    :MARKer:YN:POSition  <amplitude>

Where N identifies one of four markers {1:4}{A|B|C}. For example, ``:MARKer2B``.

Where <amplitude> is a double.

In the command syntax, Y1, Y2, Y3, and Y4 select the marker. Appending a letter specifies the S-parameter in a waveform content window as identified in the following table. For example,

    :MARKer:Y2B:SOURce

selects the Y2 marker on the B waveform content window, which is the Degrees (Hz) window. Although a number-letter combination is often used to specify a channel ("2B"), it does not refer to a channel in this case. Normally, only the "Waveform" window is displayed so, for example, you would specify "Y2A". The letter designation is required.

Selecting the Y Manual Line Marker
Waveform | Command String | Selected Marker
--- | --- | ---
FFT math operator, or S-Parameter Waveforms | `:MARKer:Y{1:4}A:SOURce` | On source waveform's Decibels (Hz) window.
`:MARKer:Y{1:4}B:SOURce` | On source waveform's Degrees (Hz) window.
`:MARKer:Y{1:4}C:SOURce` | On source waveform's Seconds (Hz) window.
All Other Waveforms | `:MARKer:Y{1:4}:SOURce` | On source waveform's Waveform window.

## Query Syntax

    :MARKer:YN:POSition?

## Description

Sets the Y-axis position of a Y1, Y2, Y3, or Y4 manual line marker. This value corresponds to the position entered in the Markers dialog box and shown in the Marker results table. The query returns the last entered position value, even if the marker was previously turned on, positioned, and then turned off. A default setup, sets all marker positions to 0.0. To query the value of the Y1, Y2, Y3, or Y4 manual line marker, use the :MEASure subsystem command `:MEASure:MARKer:Y?` query.

To set the position of a waveform tracking marker, use the `:MARKer:X:POSition` command.

Use this command on manual-line markers that are displayed in Waveform content windows. This command does not apply to tracking markers.

## Example Command Sequence

This example illustrates how to use all of the marker related commands and, as a result, is not presented as a best measurement practice. The example uses a tracking marker, manual line X marker, and manual line Y marker. Because a tracking marker is used, the waveforms must be single-valued. You could also turn on two tracking markers and read the delta values between them.

                      //  Configure Manual Line Marker X1
    :MARKer:X1:STATe MANual  //  Turn on marker
    :MARKer:X1:SOURce CHANnel1  //  Assign marker to connection 1 channel 1 waveform
    :MARKer:X1:POSition 80E-12  //  Position marker to 80 ps
                      //  Configure Manual Line Marker Y1
    :MARKer:Y1A:STATe MANual  //  Turn on Y manual line marker 1.
    :MARKer:Y1A:SOURce CHANnel1  //  Assign marker to connection 1 channel 1 waveform
    :MARKer:Y1A:POSition 120E-3  //  Position marker to 120 mv
    :MARKer:REFerence X1  //  Set markers X1 and Y1 as the reference
                      //  Configure Tracking Marker Pair 2
    :MARKer:Y2A:STATe TRACking  //  Turn on marker
    :MARKer:X2:SOURce FUNCtion3  //  Assign marker to FUNCtion3 waveform
    :MARKer:X2:POSition 200E-12  //  Position marker on screen

    …  //  Prompt tester to position marker on the waveform
                      //  Return Marker Table Measurements for Tracking Marker 2
    :MEASure:MARKer:DX2?  //  Return ΔPosition

    :MEASure:MARKer:IDX2?  //  Return inverse of ΔPosition

    :MEASure:MARKer:DY2A?  //  Return ΔMagnitude

    :MEASure:MARKer:Y2A?  //  Return Y2 Magnitude