A user interface for acoustic digitzer signals for the SBC collaboration. To use, clone this repository into the gati-linux-driver folder of your Gage software if using Linux and run "cmake .", followed by "make" (on Windows, you should be able to download this repository anywhere and it should work as long as you also have the Gage software downloaded). Also make sure you have C++ 20 installed.
The files in include/SBCBinaryFormat in this repository were written by Hector Hawley Herrera and can be found here. Other dependencies include imgui, implot, ImGuiFileDialog, glfw and spdlog. None of these need to be downloaded separately; just wanted to acknowledge work that's been done by other people.
There are four tabs on the control panel:
These control parameters that remain constant while the digitizer is acquiring data, including the number of samples per event to collect (both before and after a trigger) and the total number of events. Data saving is also included; you can save in .txt or .sbc.bin format, with an additional option to save whatever signals are currently being displayed on the UI (in case you didn't select Save File before acquiring and now want to save your data).
These control channel-specific parameters, including input range in mV and DC offset as a percentage of the input range. See SBC-Piezo-Base-Code repository or the Gage INI file documentation for more info.
These control trigger parameters, including number of triggers and parameters for each.
This tab controls displaying data from previous runs. It can only open from .sbc.bin files, but it recognizes files with multiple events and these can be viewed using event number input as well as arrows to go from one event to the next consecutive event. It can display files that have been recorded directly from the UI, as well as files recorded with the SBC-Piezo-Base-Code repository.
Each graph corresponds to a digitizer channel. If your signal is not visible on the y-axis, double click on it to zoom to fit the data. You can also click and drag or scroll to adjust position and scale.
- When installing dependencies using CPM, the way implot is set up produces an error; you can fix this by running "cmake .", then adding the following lines to _deps/implot-src/implot.h immediately after #pragma once and BEFORE #include "imgui.h":
- #ifndef IMGUI_DEFINE_MATH_OPERATORS
- #define IMGUI_DEFINE_MATH_OPERATORS
- #endif
- Currently, external trigger range is set by default to 10000 mV (+/-5 V) and is not modifiable, so the level percentage is with respect to this; I can fix this in a future revision if necessary
- If you don't set the right parameters in Acquisition Options and want to stop a run, you have to close the entire UI to do this (it is not multithreaded, and multithreading may not even work on Linux, so this is something that we just have to deal with for now).
- In file saving, the timestamp of the first event appears to be wrong (it's always much higher than the next event, although the following timestamps seem correct relative to each other). Since timestamps are a minor feature of this program and the UI may not even be used when recording actual runs (since there is a no-UI version that exists already), I haven't dedicated a lot of time to fixing this yet, although I can do that if necessary.
- If your data is too long (around 12-15k samples or more), you won't be able to view all data at the same time on the graph x-axes (you shouldn't double click to rescale or the program will throw an error as it won't have enough space to display all the data). You can still scroll/click and drag to view later samples, though, and all your desired data will still be collected and saved. I'm considering adding functionality to hide certain graphs from view or changing layout to allow for longer graphs.
- Not really an issue, but I could probably do error handling a bit better for SBCBinaryFormat and ImGui errors (Gage errors should be handled ok)