Open data acquisition oscilloscope
softscope softscope(obj) softscope('fname.si')
Note: You cannot use the legacy interface on 64–bit MATLAB®. See Session-Based Interface to acquire and generate data.
softscope opens the Hardware Configuration graphical user interface (GUI), which allows you to configure the hardware device to be used with the Oscilloscope. The Oscilloscope opens when you click the OK button, and at least one hardware channel is selected.
The Oscilloscope is a graphical user interface (GUI) that allows you to
Stream acquired data into a display.
Scale displayed data, and configure triggers and measurements.
Configure analog input hardware settings.
Export measurements and acquired data.
To support these tasks, the Oscilloscope includes several helper GUIs, which are described below.
The Hardware Configuration GUI allows you to add channels from a particular hardware device to the Oscilloscope GUI. You can configure the device's sample rate and input type, as well as the input range for each added channel. The GUI shown below is configured to add both sound card channels using the default sample rate.
The Oscilloscope GUI consists of these panes:
Display pane — The display pane contains the hardware channel data (a trace) and the measurements, if defined. The display area also contains labels for each channel's horizontal and vertical units, and indicators for
The trigger level (if defined)
The location of the start of the trigger (used for pretriggers)
Channel pane — The channel pane lists the hardware channels, math channels, and reference channels that are currently being viewed in a display. The Channel Panel also contains knobs for configuring
The display's horizontal offset and horizontal scale
The selected channel's vertical offset and vertical scale
Trigger pane — The trigger pane allows you to define how data acquisition is initiated. There are three trigger types:
One-shot — Acquire the specified number of samples once.
Continuous — Continuously acquire the specified number of samples.
Sequence — Continuously acquire the specified number of samples, and use the dependent trigger type each time.
For each trigger type, the Oscilloscope begins to acquire data after you press the Trigger button.
Measurement pane — The measurement pane lists all measurements that are currently being taken. When defining a measurement, you must specify
The hardware, math, or reference channel
The measurement type
Whether the measurement result is drawn as a cursor in the display
The Oscilloscope GUI shown below is configured to display the sound card channels in separate displays.
The Channel Exporter allows you to export the data associated with a hardware channel, a math channel, or a reference channel. You can export the channel data to one of four destinations:
The MATLAB workspace as an array
The MATLAB workspace as a structure
A MATLAB figure window
All channels added to the oscilloscope are listed in the GUI.
The Measurement Exporter allows you to export the data associated with a measurement. You can export the measurement to one of three destinations:
The MATLAB workspace
A MATLAB figure window
The number of measurements exported depends on the BufferSize property value. By default, BufferSize is 1 indicating that the last measurement value calculated is available to export.
The Scope Editor consists of two panes:
Scope — Add and remove displays, the channel pane, the measurement pane, and the trigger pane. Note that you can define as many displays as you want, but there can only be only one channel pane, measurement pane, and trigger pane in the Oscilloscope at a time.
Scope Properties — Configure properties for the displays, the channel pane, the measurement pane, and the trigger pane.
The Channel Editor consists of three panes:
Channel — Add or delete math channels and reference channels, and select which defined channels are available to the Oscilloscope.
Channel Properties — Configure properties for defined hardware channels, math channels, and reference channels.
Channel Display — Select the Oscilloscope display for each defined channel, or choose to not display a channel.
The Measurement Editor consists of three panes:
Measurement — Add or delete measurements, and select which defined measurements are available to the Oscilloscope.
Measurement Properties — Configure properties for the defined measurements.
Measurement Type — Add or delete measurement types, and select which defined measurement types are available to the Oscilloscope.