:MEASure:PLEVel:PMAX

Flex Apps:
FlexDCA
Meas. mode:
Jitter
Waveform type:
PAM4
Meas. panel:
Level

Command Syntax

:MEASure:PLEVel:PMAX

Query Syntax

:MEASure:PLEVel:PMAX?

Description

For the Signal-to-Noise-and-Distortion Ratio (SNDR) measurement, returns the measured amplitude (p-max) term of the extracted linear pulse response used in the SNDR measurement. The p-max term is used when measuring SNDR for IEEE 802.3-2022 as shown in the following equation.

Equation. SNDR for IEEE 802.3-2022

The p-max (and P-Signal) measured terms are always available regardless of how the SNDR measurement is configure using the :MEASure:AMPLitude:DEFine:SNDRatio:DEFinition command. To return the P-Signal) term use the :MEASure:PLEVel:PSIGnal? query, To run the SNDR measurement, use the :MEASure:PLEVel:SNDRatio.

You can run and return the p-max measurement even it the Signal-to-Noise-and-Distortion Ratio (SNDR) measurement is not running or displayed int FlexDCA's Level results table.

Prior to FlexDCA revision A.08.40, the p-max measurement could be returned by the :MEASure:PLEVel:PSIGnal command.

Requires FlexDCA revision A.08.40 and above.

Measurement Identification

Avoid subtle programming errors! To ensure that the correct measurement is installed or queried, always explicitly identify a measurement when installing a measurement or querying a measured value, status, or detail. To identify a measurement, specify the measurement's source waveform (:SOURce child command). With some measurements, you may also need to specify other identifying values. Generally, when selecting a measurement using FlexDCA's GUI, if a dialog appears prompting you to select values, you should explicitly specify these values when remotely identifying the measurement. More information.

For example, to return the status of the measurement, :MEASure:PLEVel:PMAX

flex.write(':MEASure:PLEVel:PMAX:SOURce CHAN1A')
if flex.query(':MEASure:PLEVel:PMAX:STATus?') == 'CORR';
    measurement = flex.query(':MEASure:PLEVel:PMAX?')
else:
	details = flex.query(':MEASure:PLEVel:PMAX:STATus:DETails?')
	reason = flex.query(':MEASure:PLEVel:PMAX:STATus:REASon?')

Measurement Ready?

To confirm that the measurement is ready to read, you can query the measurement's status:

if ('CORR' in Flex.query(':MEASure:PLEVel:PMAX:STATus?')):
	measurement = Flex.query(':MEASure:PLEVel:PMAX?')

If averaging is turned on (:ACQuire:AVERaging), you can also confirm if the measurement result is ready by comparing the number of specified averages (:ACQuire:ECOunt?) versus the number of measurement sweeps that have occurred (:MEASure:PLEVel:PMAX:COUNt?). The technique uses the :COUNt? common measurement query. For example,

if (Flex.query(':MEASure:PLEVel:PMAX:COUNt?') >= Flex.query(':ACQuire:ECOUNt?')):
	measurement = Flex.query(':MEASure:PLEVel:PMAX?')

You can also use an acquisition limit lest to test that a number of waveform samples, or pattern acquisitions have completed before returning a measurement. Refer to the :LTESt:ACQuire:CTYPe command.

Common Measurement Child Queries

This command supports the use of the following common measurement queries: :LOCation?, :COUNt?, :MAXimum?, :MINimum?, :MEAN?, and :SDEViation?.

Example Command

:MEASure:PLEVel:PMAX