TRACe:DELete[:NAME]
Syntax
TRACe:DELete[:NAME] {(@<channel>)|<slot>}, <name>
Description
This command deletes a trace from volatile memory. Deleting a trace also frees up space in memory previously allocated for the trace.
Used With:
34950A Digital I/O Module (digital output channels only)
34951A Isolated DAC Module
Parameters
|
Name |
Type |
Range of Values |
Default Value |
|
<channel> |
Numeric |
One channel in the form (@sccc). Select from s101 through s104, s201 through s204. |
This is a required parameter |
|
<slot> |
Discrete |
{1|2|3|4|5|6|7|8} |
This is a required parameter |
|
<name> |
ASCII String |
A previously-defined trace name consisting of up to 12 characters. |
This is a required parameter |
Remarks
If the specified trace name is not currently stored in memory, an error is generated.
Any channels that were associated with the deleted trace name will lose that association.
As traces are deleted, there may be non-contiguous blocks of memory. Use the TRACe:FREE? command to determine the largest contiguous block of memory available.
For the 34950A, if you change the width of a bank (see CONFigure:DIGital:WIDTh command), all traces in memory are cleared.
For the 34950A, this command does not delete the built-in trace patterns (count-up pattern or "walking ones" pattern).
For the 34950A, you cannot delete a trace while buffered memory is enabled. If necessary, use the [SENSe:]DIGital:MEMory:ENABle command to disable memory and then delete the trace.
For the 34951A, this command does not delete any of the built-in trace waveforms (Sine, Square, Ramp, etc).
For the 34951A, you cannot delete a trace that is currently being output on the specified slot. If you attempt to delete an active trace, an error will be generated. If necessary, use the SOURce:FUNCtion:ENABle command to turn off the trace so it can be deleted.
To delete all traces from the specified slot, use the TRACe:DELete:ALL command.
A Factory Reset (*RST command), Instrument Preset (SYSTem:PRESet command), and Card Reset (SYSTem:CPON command) deletes the trace waveform from memory and removes all trace name associations. In addition, storing the instrument state (*SAV command) will delete the trace waveform from memory and remove all trace name associations.
Examples
The following command deletes the trace named "DOUT1" from channel 101 on the 34950A in slot 3.
TRAC:DEL (@3101),DOUT1
The following command deletes the trace named "TEST_WFORM" from the 34951A in slot 4.
TRAC:DEL 4,TEST_WFORM