# :LTESt:MTESt:MRESult{N}:STATe

:LTESt Mask Limit Commands

- :LTESt:MTESt:MRESult{N}:CTYPe
- :LTESt:MTESt:MRESult{N}:CTYPe:UINTervals
- :LTESt:MTESt:MRESult{N}:CTYPe:WAVeforms
- :LTESt:MTESt:MRESult{N}:SOFailure
- :LTESt:MTESt:MRESult{N}:STATe
- :LTESt:MTESt:SIMage:FNAMe
- :LTESt:MTESt:SIMage:FNAMe:AUPDate
- :LTESt:MTESt:SIMage:FNAMe:USTandard
- :LTESt:MTESt:SIMage:FTYPe?
- :LTESt:MTESt:SIMage:IMETadata
- :LTESt:MTESt:SIMage:INVert
- :LTESt:MTESt:SIMage:MONochrome
- :LTESt:MTESt:SIMage:SINClude
- :LTESt:MTESt:SIMage:STATe
- :LTESt:MTESt:SIMage:WINDow
- :LTESt:MTESt:SWAVeform:CHANnel{N}:FNAMe
- :LTESt:MTESt:SWAVeform:CHANnel:FTYPe
- :LTESt:MTESt:SWAVeform:CHANnel{N}:STATe
- :LTESt:MTESt:SWAVeform:CHANnel{N}:WMEMory
- :LTESt:MTESt:SWAVeform:CMODe{N}:FNAMe
- :LTESt:MTESt:SWAVeform:CMODe:FTYPe
- :LTESt:MTESt:SWAVeform:CMODe{N}:STATe
- :LTESt:MTESt:SWAVeform:CMODe{N}:WMEMory
- :LTESt:MTESt:SWAVeform:DIFF{N}:FNAMe
- :LTESt:MTESt:SWAVeform:DIFF:FTYPe
- :LTESt:MTESt:SWAVeform:DIFF{N}:STATe
- :LTESt:MTESt:SWAVeform:DIFF{N}:WMEMory
- :LTESt:MTESt:SWAVeform:FUNCtion{N}:FNAMe
- :LTESt:MTESt:SWAVeform:FUNCtion{N}:STATe
- :LTESt:MTESt:SWAVeform:FUNCtion{N}:WMEMory
- :LTESt:MTESt:SWAVeform:RESet

## Command Syntax

    :LTESt:MTESt:MRESult{1:16}:STATe {ON | OFF | 1 | 0}

Where {1:16} identifies the specific mask for which to apply the limit test.

## Query Syntax

    :LTESt:MTESt:MRESult{1:16}:STATe?

## Query Response

    {1 | 0}

## Description

Turns on or off mask-test limit testing for a specific mask. The test limit is defined as a specific number of failures for all mask regions (standard or margin). Use the `:LTESt:MTESt:MRESult{N}:CTYPe` command to specify the condition that the limit test will run until.

If however, you want to define very specific test limits for the different values reported in the Mask Test table, use a measurement limit test instead:

- :LTESt:MEASure:MLIMit:STATe
- :LTESt:MEASure:MLIMit:SOURce:TYPE
- :LTESt:MEASure:MLIMit:SOURce:LOCation

## Example

The following example shows how to create a limit test on eye mask number 3 and run the test until 100 failures have occurred. After the test completes, results are reported:

- Waveform is saved to a file.
- Summary file is created.
- Monochrome screen image of the entire Infiniium display is saved to a JPG file.

You can create a test for each active eye mask.

    :ACQuire:SINGle  //  Stop waveform acquisition.

    :LTESt:MTESt:MRESult3:CTYPe WAVeforms
    :LTESt:MTESt:MRESult3:CTYPe:WAVeforms 100  //  Create Test on Mask 3. Stop test after 100 failures.
    :LTESt:MTESt:SWAVeform:CHANnel1:STATe DISK  //  Save connection 1 channel 1 data to file.
    :LTESt:MTESt:SWAVeform:CHANnel1:FNAMe "C:\Users\kentb\Documents\Keysight\Infiniium\Waveforms\Mask Waveform.h5"  //  File Name.
    :LTESt:MTESt:SIMage:STATe ON  //  Save screen image.
    :LTESt:MTESt:SIMage:MONochrome ON  //  Monochrome image capture.
    :LTESt:MTESt:SIMage:WINDow DISPlay  //  Capture entire display.
    :LTESt:MTESt:SIMage:FNAMe "C:\Users\kentb\Documents\Keysight\Infiniium\Screen Images\Mask.jpg"  //  File Name.
    :LTESt:MTESt:MRESult1:STATe ON  //  Turn limit test on.

    :ACQuire:RUN  //  Start waveform acquisition.
    *OPC?  Wait for test completion.