Returns the number of readings stored in the specified reading buffer. If no buffer is specified, defbuffer1 is used.
| Name | Type | Values | Description |
|---|
| bufferNameopt | string | - | Specifies the reading buffer; can be a default buffer or a user-defined buffer. |
integer - The number of readings stored in the buffer.
Returns the last index in a reading buffer. If no buffer name is specified, defbuffer1 is used.
| Name | Type | Values | Description |
|---|
| bufferNameopt | string | - | A string that indicates the reading buffer; the default buffers (defbuffer1 or defbuffer2) or a user-defined buffer name. |
integer - Returns the last index in the specified reading buffer.
:TRACe:ACTual:END?
:TRACe:ACTual:END? "<bufferName>"
Indicates the starting index in a reading buffer. If no buffer is specified, defbuffer1 is used.
| Name | Type | Values | Description |
|---|
| bufferNameopt | string | - | A string that indicates the reading buffer; the default buffers (defbuffer1 or defbuffer2) or the name of a user-defined buffer. |
integer - Returns the starting index in the specified reading buffer.
:TRACe:ACTual:STARt?
:TRACe:ACTual:STARt? "<bufferName>"
Clears all readings and statistics from the specified reading buffer. If no buffer is specified, defbuffer1 is used.
| Name | Type | Values | Description |
|---|
| bufferNameopt | string | - | Name of the reading buffer to clear; may be a default buffer (defbuffer1 or defbuffer2) or a user-defined buffer. |
:TRACe:CLEar
:TRACe:CLEar "<bufferName>"
Returns specified data elements from a specified reading buffer. If no buffer name is specified, defbuffer1 is used.
| Name | Type | Values | Description |
|---|
| startIndex | integer | 1 | Beginning index of the buffer to return. |
| endIndex | integer | - | Ending index of the buffer to return. |
| bufferNameopt | string | - | Name of the reading buffer; default buffers or a user-defined buffer may be specified. |
| bufferElementsopt | enum | DATE | FORMatted | FRACtional | READing | RELative | SEConds | SOURce | SOURFORMatted | SOURSTATus | SOURUNIT | STATus | TIME | TSTamp | UNIT | List of buffer elements to print; if omitted, READing is used. |
string - Returns the specified data elements from the selected reading buffer as comma-delimited output.
TRAC:DATA? 1, 5, "buf100", READ, SOUR, REL
TRAC:DATA? 1, 5, "buf100", READ, REL
TRAC:DATA? 1, 5, "buf100", REL
TRAC:DATA? 1, 3, "buf100"
Deletes a user-defined reading buffer. You cannot delete the default reading buffers, defbuffer1 and defbuffer2.
| Name | Type | Values | Description |
|---|
| bufferName | string | - | Name of the user-defined reading buffer to delete. |
TRAC:DEL "testData"
Determines whether a reading buffer is filled continuously or filled once and then stops. If no buffer is specified, defbuffer1 is used.
| Name | Type | Values | Description |
|---|
| fillType | enum | CONTinuous | ONCE | Selects continuous filling or fill-once behavior. |
| bufferNameopt | string | - | Name of the reading buffer to configure; if omitted, defbuffer1 is used. |
enum - Returns the current fill mode of the specified reading buffer.
Indicates whether information events are logged when the specified reading buffer is 0% or 100% filled. Set it to on to log buffer status events in the event log; set it to off to suppress them.
| Name | Type | Values | Description |
|---|
| logState | enum | OFF | 0 | ON | 1 | Do not log information events or log information events. |
| bufferNameopt | string | - | Name of the reading buffer to apply the setting to; if omitted, defbuffer1 is used. |
:TRACe:LOG:STATe <logState>
:TRACe:LOG:STATe <logState>, "<bufferName>"
:TRACe:LOG:STATe?
:TRACe:LOG:STATe? "<bufferName>"
Creates a user-defined reading buffer.
| Name | Type | Values | Description |
|---|
| bufferName | string | - | A user-supplied string that indicates the name of the buffer. |
| bufferSize | integer | 10 | Maximum number of readings that can be stored in the buffer; set to 0 to maximize the buffer size. |
| bufferStyleopt | enum | COMPact | STANdard | FULL | WRITable | FULLWRITable | The type of reading buffer to create. |
TRACe:MAKE "capTrace", 200, WRITable
TRACe:MAKE "bufferVolts", 100
TRACe:MAKE "bufferVolts", 1000
Applies a mathematical expression to readings as they are stored in the reading buffer. The result is calculated and stored in the Extra column of the reading buffer.
| Name | Type | Values | Description |
|---|
| bufferName | string | - | Name of the reading buffer; must be set to the style FULL. |
| units | enum | AMP | AMPAC | CELSius | CUSTOM1 | CUSTOM2 | CUSTOM3 | DAC | DBM | DECibel | DIO | FAHRenheit | FARad | HERTz | KELVin | NONE | OHM | PERCent | RATio | RECiprocal | SECond | TOT | VOLT | VOLTAC | WATT | Units to be applied to the value generated by the expression. |
| expression | enum | ADD | AVERage | DIVide | EXPonent | LOG10 | MULTiply | NONE | POLY | POWer | RATE | RECiprocal | SQRoot | SUBtract | Mathematical expression to apply to the reading. |
| constant0 | real | - | Constant used for c0 in the expression. |
| constant1 | real | - | Constant used for c1 in the expression. |
| constant2 | real | - | Constant used for c2 in the expression. |
| constant3 | real | - | Constant used for c3 in the expression. |
| constant4 | real | - | Constant used for c4 in the expression. |
| constant5 | real | - | Constant used for c5 in the expression. |
:TRACe:MATH "<bufferName>", <units>, ADD
:TRACe:MATH "<bufferName>", <units>, AVERage
:TRACe:MATH "<bufferName>", <units>, DIVide
:TRACe:MATH "<bufferName>", <units>, EXPonent
:TRACe:MATH "<bufferName>", <units>, LOG10
:TRACe:MATH "<bufferName>", <units>, MULTiply
:TRACe:MATH "<bufferName>", <units>, NONE
:TRACe:MATH "<bufferName>", <units>, POLY, <constant0>, <constant1>, <constant2>, <constant3>, <constant4>, <constant5>
:TRACe:MATH "<bufferName>", <units>, POWer, <constant0>
:TRACe:MATH "<bufferName>", <units>, RATE
:TRACe:MATH "<bufferName>", <units>, RECiprocal
:TRACe:MATH "<bufferName>", <units>, SQRoot
:TRACe:MATH "<bufferName>", <units>, SUBtract
Sets or queries the number of readings a buffer can store. Changing the buffer size clears any existing data in that buffer.
| Name | Type | Values | Description |
|---|
| newSize | integer | 0 - 4500000 | The new size for the buffer; set to 0 to maximize the buffer size. |
| bufferNameopt | string | - | The reading buffer to affect; defaults to defbuffer1 if omitted. |
integer - Returns the current number of readings a buffer can store.
:TRACe:POINts <newSize>
:TRACe:POINts <newSize>, "<bufferName>"
:TRACe:POINts?
:TRACe:POINts? "<bufferName>"
Saves data from a specified reading buffer to a USB flash drive. If no buffer is specified, the default buffer defbuffer1 is used.
| Name | Type | Values | Description |
|---|
| fileName | string | - | The name of the file on the USB flash drive in which to save the reading buffer. |
| bufferNameopt | string | - | The reading buffer to save; may be a default buffer or a user-defined buffer name. |
| whatopt | enum | ALL | FORMat | RELative | RAW | STAMp | STANdard | BRIEF | EXTRa | Defines which information is saved in the file. |
| startopt | integer | - | Defines the starting point in the buffer to start saving data. |
| endopt | integer | - | Defines the ending point in the buffer to stop saving data. |
TRACe:SAVE "/usb1/myData.csv", "MyBuffer"
TRACe:SAVE "/usb1/myDataRel.csv", "MyBuffer", REL
Appends data from the reading buffer to a file on the USB flash drive. If the file does not exist, the command creates it; the file extension .csv is appended if necessary.
| Name | Type | Values | Description |
|---|
| fileName | string | - | Name of the file on the USB flash drive in which to save the reading buffer. |
| bufferName | string | - | Reading buffer to append, such as defbuffer1, defbuffer2, or a user-defined buffer. |
| timeFormat | enum | ALL | FORMat | RELative | RAW | STAMp | STANdard | BRIEF | EXTRa | Controls how date and time information from the buffer is saved in the file. |
| start | integer | - | Starting point in the buffer to start saving data. |
| end | integer | - | Ending point in the buffer to stop saving data. |
:TRACe:SAVE:APPend "<fileName>"
:TRACe:SAVE:APPend "<fileName>", "<bufferName>"
:TRACe:SAVE:APPend "<fileName>", "<bufferName>", <timeFormat>
:TRACe:SAVE:APPend "<fileName>", "<bufferName>", <timeFormat>, <start>, <end>
Returns the average of all readings in the specified reading buffer. If no buffer is specified, defbuffer1 is used.
| Name | Type | Values | Description |
|---|
| bufferNameopt | string | - | A string that indicates the reading buffer; the default buffers defbuffer1 or defbuffer2 or the name of a user-defined buffer. |
real - The average reading calculated from all the readings in the specified reading buffer.
:TRACe:STATistics:AVERage?
Clears the statistical information associated with the specified reading buffer. It clears the statistics without clearing the readings.
| Name | Type | Values | Description |
|---|
| bufferNameopt | string | - | Name of the reading buffer to clear; may be a default buffer or a user-defined buffer. If no buffer is defined, statistics are cleared from defbuffer1. |
TRACe:STATistics:CLEar
TRACe:STATistics:CLEar "testData"
Returns the maximum reading value in the reading buffer.
| Name | Type | Values | Description |
|---|
| bufferNameopt | string | - | A string that indicates the reading buffer; the default buffers (defbuffer1 or defbuffer2) or the name of a user-defined buffer. If no buffer is specified, defbuffer1 is used. |
real - The maximum reading value in the reading buffer. If no buffer is specified, the default buffer defbuffer1 is used.
TRACe:STAT:MAXimum?
TRACe:STAT:MAXimum? "testData"
Returns the minimum reading value in the reading buffer.
| Name | Type | Values | Description |
|---|
| bufferNameopt | string | - | A string that indicates the reading buffer; if omitted, defbuffer1 is used. |
real - Returns the minimum reading value in the specified reading buffer.
TRACe:STAT:MINimum?
TRACe:STAT:MINimum? "testData"
Returns the peak-to-peak value of all readings in the reading buffer.
| Name | Type | Values | Description |
|---|
| bufferNameopt | string | - | The reading buffer to use; if omitted, defbuffer1 is used. |
real - The peak-to-peak reading value from the specified buffer, or from defbuffer1 if no buffer is specified.
TRACe:STAT:Pk2Pk?
TRACe:STAT:Pk2Pk? "testData"
Returns the standard deviation of all readings in the buffer. If no buffer is specified, defbuffer1 is used.
| Name | Type | Values | Description |
|---|
| bufferNameopt | string | - | A string that indicates the reading buffer; if no buffer is specified, defbuffer1 is used. |
real - Standard deviation of the readings in the specified buffer.
TRACe:STAT:STDDev?
TRACe:STAT:STDDev? "testData"
Makes readings using the active measure function and stores them in a reading buffer. A buffer name may be specified; if omitted, defbuffer1 is used.
| Name | Type | Values | Description |
|---|
| bufferNameopt | string | - | Indicates the reading buffer; can be a default buffer or a user-defined buffer name. |
:TRACe:TRIGger
:TRACe:TRIGger "<bufferName>"
Creates up to three custom units of measure for use in buffers. The custom unit is specified as CUSTOM1, CUSTOM2, or CUSTOM3 and a string name up to three characters long.
| Name | Type | Values | Description |
|---|
| n | enum | 1 | 2 | 3 | Selects which custom unit number to define as CUSTOM1, CUSTOM2, or CUSTOM3. |
| unitOfMeasure | string | - | String that defines the custom unit; up to three characters. |
:TRACe:UNIT CUSTOM<n>, "<unitOfMeasure>"
Sets the units and number of digits of the readings written into a reading buffer. When the buffer style is full writable, you can also specify a second set of units and digits.
| Name | Type | Values | Description |
|---|
| bufferName | string | - | The name of the buffer. |
| units | enum | AMP | AMP_AC | AMPAC | CELSius | CUSTOM1 | CUSTOM2 | CUSTOM3 | DAC | DBM | DECibel | DIO | FAHRenheit | FARad | HERTz | KELVin | NONE | OHM | PERCent | RATio | RECiprocal | SECond | TOT | VOLT | VOLT_AC | VOLTAC | WATT | X | The units for the first measurement in the buffer index. |
| displayDigits | integer | 3 - 8 | The number of digits to use for the first value in the buffer index. |
| extraUnitsopt | enum | AMP | AMP_AC | AMPAC | CELSius | CUSTOM1 | CUSTOM2 | CUSTOM3 | DAC | DBM | DECibel | DIO | FAHRenheit | FARad | HERTz | KELVin | NONE | OHM | PERCent | RATio | RECiprocal | SECond | TOT | VOLT | VOLT_AC | VOLTAC | WATT | X | The units for the second measurement in the buffer index; if not specified, the value for units is used. |
| extraDigitsopt | integer | 3 - 8 | The number of digits to use for the second measurement; if not specified, the value for displayDigits is used. |
:TRAC:WRIT:FORM "write2me", WATT, 4
:TRAC:WRIT:FORM "write2me", WATT, 4, WATT, 4
Writes one or more readings into a reading buffer. The buffer must be set to writable or full writable style, and readings are added in chronological order.
| Name | Type | Values | Description |
|---|
| bufferName | string | - | Name of the buffer to write to. |
| readingValue | real | - | First value recorded in the buffer index. |
| extraValueopt | real | - | Second value recorded in the buffer index; valid only for full writable buffer style. |
| secondsopt | integer | - | Seconds portion of the time stamp. |
| fractionalSecondsopt | real | - | Fractional portion of the time stamp. |
| statusopt | integer | - | Additional information about the reading, expressed as buffer status bits. |
:TRAC:MAKE "write2me", 1000, WRITable
:TRAC:WRIT:FORM "write2me", WATT, 4
:TRAC:WRIT:READ "write2me", 1
:TRAC:WRIT:READ "write2me", 2
:TRAC:WRIT:READ "write2me", 3
:TRAC:WRIT:READ "write2me", 4
:TRAC:WRIT:READ "write2me", 5
:TRAC:WRIT:READ "write2me", 6
:TRAC:MAKE "write2me", 1000, FULLWRIT
:TRAC:WRIT:FORM "write2me", WATT, 4, WATT, 4
:TRAC:WRIT:READ "write2me", 1, 7
:TRAC:WRIT:READ "write2me", 2, 8
:TRAC:WRIT:READ "write2me", 3, 9
:TRAC:WRIT:READ "write2me", 4, 10
:TRAC:WRIT:READ "write2me", 5, 11
:TRAC:WRIT:READ "write2me", 6, 12