# :WAVeform:CGRade:ASCii:DATA?

:WAVeform CGRade Commands

- :WAVeform:CGRade:ASCii:DATA?
- :WAVeform:CGRade:COLumns?
- :WAVeform:CGRade:INTeger:DATA?
- :WAVeform:CGRade:POINts?
- :WAVeform:CGRade:ROWS?
- :WAVeform:CGRade:STATus?
- :WAVeform:CGRade:STATus:REASon?
- :WAVeform:CGRade:UICount?
- :WAVeform:CGRade:WCOunt?
- :WAVeform:CGRade:XINCrement?
- :WAVeform:CGRade:XML:READ?
- :WAVeform:CGRade:XML:WRITe?
- :WAVeform:CGRade:XORigin?
- :WAVeform:CGRade:YINCrement?
- :WAVeform:CGRade:YORigin?

## Query Syntax

    :WAVeform:CGRade:ASCii:DATA?

## Query Response

The data is returned as comma-separated values.

## Description

Returns color grade/gray scale database values in ASCII format. Color grade/gray scale data is transferred as a two dimensional array consisting of 521 rows by 751 columns for a total number of 391,271 points. This array corresponds to the graticule display, where each point contains a sample hit count. The array is transferred column by column, starting with the lower left corner of the graticule.

The time for any column of data points can be calculated as:

where,

- Xincrement is the time spacing between database columns and is returned with the `:WAVeform:CGRade:XINCrement?` query.
- Xindex is the column count index, starting at zero and ending at 750, the value returned by the `:WAVeform:CGRade:COLumns?` query.
- Xorigin is the time position of the first column and is returned using the `:WAVeform:CGRade:XORigin?` query.

The voltage for any data point at a given row (that contains a hit count) is determined by using the following equation:

where,

- Yincrement is the amplitude spacing between database rows and is returned with the `:WAVeform:CGRade:YINCrement?` query.
- Yindex is the row count index, starting at zero and ending at 521, the value returned by the `:WAVeform:CGRade:ROWS?` query.
- Yorigin is a voltage value of the top row and is returned using the `:WAVeform:CGRade:YORigin?` query.

To transfer the data in integer values, use the `:WAVeform:CGRade:INTeger:DATA?` query.