AWG and Digitizer Pattern Browser
Introduced in version 3.5.32
The AWG and Digitizer Pattern Browser (window title Pattern Browser) shows what the server actually sent to the hardware. While an experiment is being programmed, the pulse generator, AWG and digitizer drivers can write debug dumps of their patterns, sequences and acquisitions to disk; the browser lists those dumps, plots them, steps through the AWG block table that comes with them, and holds the switches that turn the dumps on and off. Use it to check a waveform sample by sample when the spectrometer does not do what the pulse program says.
Open it from the Window menu as AWG Export Browser, or from the matching toolbar button. The menu item is a toggle: selecting it again closes the window.
Export switches
The six buttons at the left of the toolbar are the server's debug flags. They are
not a local setting: the server publishes the state of its flags, so the buttons show the real state
when the window opens and follow changes made from the Console Use or from another client. Each
button has a console equivalent that takes 1 or 0, so a script can switch
the dumps on before a run and off after it.
| Button | Console command | Effect |
| Report | .s.spec.awg_report.s.spec.acquisition_report |
Introduced in version 3.8.10 Prints a summary of every AWG program (pattern sizes, memory slots, markers) and of every digitizer acquisition (samples, shots, rates) to the Log Window and Status Bar. One button sets both flags. |
| AWG engine export | .s.spec.awg_engine_export |
Writes every block the AWG engine assembled, before the driver converts it to the device
format. One .spb file per block, all AWG drivers. |
| AWG pattern export | .s.spec.awg_pattern_export |
Writes the device-ready pattern the driver uploads. What exactly is written depends on the driver; see Files below. |
| AWG sequence export | .s.spec.awg_sequence_export |
Prints the sequence program of the AWG (the play list of blocks, loops and triggers) to the log. |
| Generator sequence export | .s.spec.pulse_sequence_export |
Prints the program of the pulse generator (TTL word list with durations) to the log. |
| Acquisition export | .s.spec.acquisition_export |
Writes the raw digitizer records of every acquisition to disk, before averaging and post-processing. |
All flags are off when the server starts. Leave them off during routine measurements: the exports write a file for every pattern rebuild and every acquisition, and the folder fills up quickly.
Files
The dumps are written by the server to its local disk, and the browser
reads them from the client's disk. On a two-computer setup the dump folder therefore has to be
shared or copied. The AWG exports go to C:\Temp\AWG\, the acquisition exports to
C:\Temp\AVG\; the folders must exist, the server does not create them.
| File | Content |
.spb | The waveform: a time column followed by one column per trace. For the AWG engine and the HDAWG driver the traces are I, Q and the two marker bits; for the acquisition export they are the digitizer channels. This is the file the browser plots. |
.seq | The block table of a .spb of the same name: for each
block its first sample, its length and how many times it loops. Present for the HDAWG pattern
export. |
.hdr, .dat, .bin | Header, text and binary
forms of the acquisition export, next to its .spb. |
The AWG engine export names its files awgengine-seq<n>-id<m>-<first sample>(<length>).spb.
Introduced in version 3.8.10
The HDAWG pattern export writes one.spb and .seq per AWG core covering the
whole staged waveform memory, plus one .spb per waveform slot, so a single slot can be
inspected on its own. Other AWG drivers export the pattern they upload without a block table.
Browsing
The folder field at the top left starts at C:\Temp. The list below
it shows subfolders in brackets and the .spb files of the folder; double-click a folder
to enter it and [.] to go up. A single click on a file plots it. R re-reads the folder
after a new run, and X deletes every dump file (spb, seq,
hdr, dat, bin) in the folder after a confirmation. Other files
and subfolders are left alone, but the deletion cannot be undone.
The read mode list under the file list tells the browser how to decode the columns. Time C1 C2 C3 ... - AWGEngine, the default, plots every column as its own trace and is the right choice for all engine, HDAWG and acquisition dumps. The other entries are for raw 16-bit dumps of the Spectrum DN6 and Keysight 8190A drivers, where analog samples and marker bits share one word; the Channel 1 and Channel 2 fields show the bit layout of the selected mode, and the marker bits come out as separate traces. Scale sets the height of each trace; traces are stacked at unit spacing, so a scale of 0.5 keeps them from overlapping.
A frame of the file is plotted; the horizontal scroll bar under the plot moves the frame through the file, and the strip at the bottom shows the whole file in miniature with the current frame marked. The plot itself is a regular Data Views: zoom with the mouse and read values with the cursor.
Blocks
Introduced in version 3.8.10
When the file has a block table, the second scroll bar steps from block to block and the field next to it shows the block index; hover it to see the block's start, length and loop count. The log at the bottom left lists the table asindex: start(length) xloops.
With Block unchecked the plot shows a full frame starting at the block, with the block
boundaries marked. With Block checked the plot shows exactly one block, rescaled to fit, which
is the quickest way to check a single pulse shape or an empty (play-zero) slot.
Views 1 to 8
Introduced in version 3.8.10
The eight numbered buttons store and recall a view: the zoom rectangle of the plot together with the reference-sine settings. Ctrl-click a button to store the current view into it. A plain click applies the stored view and keeps the button down, and while it is down every file that is loaded afterwards is shown with the same view, so consecutive dumps can be compared at the same place and magnification. Click the button again to release it. A button that was never stored does nothing.Reference sine
The narrow button at the right edge of the plot opens a panel that draws a reference sine over the data, for reading the phase and frequency of an I/Q waveform by eye. Frequency, Amp and Offset define the sine, Position is the time its first sample is drawn at, and Phase and Ph. Offset add up to its phase; keep the offset for a fixed correction and turn Phase to match the trace. t moves the sine into the visible part of the plot. Remove trace takes the sine off the plot and restores automatic scaling; closing the panel does the same.
See also Pulse and AWG Engine for how patterns and sequences are built, and Acquisition Engine for the acquisition side.

