EXTRACT_DIGITAL_TRACE_T3DSO1XXX
Download Flojoy Studio to try this app
Extracts the digital trace from an from an T3DSO1000(A)-2000 oscilloscope The trace is defined by the x and y limits as seen on the instrument.
Requires a CONNECT_T3DSO1XXX block at the start of the app to connect with
the instrument. The VISA address will then be listed under 'connection'.
This block should work with any Teledyne LeCroy T3DSO1000(A)-2000 series oscilloscope. Params: connection : VisaConnection The VISA address (requires the CONNECT_T3DSO1XXX block). trace : Literal The digital trace to read the waveform from. resolution : int | None The number of points to read from the trace. If None, the full trace is return. Returns: out : OrderedPair The trace of the oscilloscope.
Python Code
from flojoy import flojoy, DataContainer, VisaConnection, OrderedPair
from typing import Optional, Literal
import logging
@flojoy(inject_connection=True)
def EXTRACT_DIGITAL_TRACE_T3DSO1XXX(
connection: VisaConnection,
trace: Literal[
"D1",
"D2",
"D3",
"D4",
"D5",
"D6",
"D7",
"d8",
"D9",
"D10",
"D11",
"D12",
"D13",
"D14",
"D15",
] = "D1",
resolution: int | None = 5000,
default: Optional[DataContainer] = None,
) -> OrderedPair:
"""Extracts the digital trace from an from an T3DSO1000(A)-2000 oscilloscope
The trace is defined by the x and y limits as seen on the instrument.
Requires a CONNECT_T3DSO1XXX block at the start of the app to connect with
the instrument. The VISA address will then be listed under 'connection'.
This block should work with any Teledyne LeCroy T3DSO1000(A)-2000 series oscilloscope.
Parameters
----------
connection: VisaConnection
The VISA address (requires the CONNECT_T3DSO1XXX block).
trace: Literal
The digital trace to read the waveform from.
resolution: int | None
The number of points to read from the trace. If None, the full trace is return.
Returns
-------
OrderedPair
The trace of the oscilloscope.
"""
scope = connection.get_handle()
scope.write("chdr off")
time_Scale = scope.query("tdiv?")
sample_rate = scope.query("di:sara?")
sample_rate_unit = {"G": 1e9, "M": 1e6, "k": 1e3}
for unit in sample_rate_unit.keys():
if sample_rate.find(unit) != -1:
sample_rate = sample_rate.split(unit)
sample_rate = float(sample_rate[0]) * sample_rate_unit[unit]
break
sample_rate = float(sample_rate)
scope.chunk_size = 20 * 1024 * 1024
scope.write("d0:wf? dat2")
recv = list(scope.read_raw())[15:]
recv.pop()
recv.pop()
volt_value = []
data = bytearray(recv)
for char in data:
for i in range(0, 8):
volt_value.append((char >> i) & 1)
time_value = []
for idx in range(0, len(volt_value)):
time_data = -(float(time_Scale) * 14 / 2) + idx * (1 / sample_rate)
time_value.append(time_data)
# Downsample base on user input
if isinstance(resolution, int):
assert resolution > 0, "Resolution must be greater than zero"
if resolution > len(time_value):
logging.warning(
f"Resolution ({resolution}) is greater than the number of points ({len(time_value)}). Returning full trace."
)
else:
step = int(len(time_value) // resolution)
time_value = time_value[::step]
volt_value = volt_value[::step]
return OrderedPair(x=time_value, y=volt_value)
Example App
Having problems with this example app? Join our Discord community and we will help you out!
This app shows how to use the blocks for a T3DSO1000(A)-2000 oscilloscope.
Blocks used:
CONNECT_T3DSO1XXXRESET_T3DSO1XXXAUTO_SETUP_T3DSO1XXXDISPLAY_ON_OFF_T3DSO1XXXSET_HORIZONTAL_SCALE_T3DSO1XXXSET_VERTICAL_SCALE_T3DSO1XXXEXTRACT_TRACE_T3DSO1XXXMEASUREMENT_T3DSO1XXXSCREENSHOT_T3DSO1XXX- 2x
BIG_NUMBER SCATTERIMAGE
The blocks were connected as shown, and the app was run. The result displayed the trace of the signal, the frequency, and the amplitude of the signal, along with a screenshot of the oscilloscope screen for verification.