Gamma MCA

Progressive web application for gamma spectroscopy including file and live plot support via the serial interface.

Built using Bootstrap, Plotly.js, Font Awesome and Z-Schema.

Feature Overview

• No installation required - accessible on every internet-connected device
• Can be easily installed for stand-alone offline use
• Straightforward interface to get down to business
• File import of common data formats (e.g. CSV, TKA, XML, JSON)
• Export JSON/XML files combining all the spectra, calibration data and sample info
• Live plotting via the serial interface, compatible with any serial device (e.g. Arduino)
• Serial console to control your device
• Linear and quadratic energy calibration
• Gaussian correlation filtering for peak detection
• Customizable list of common isotopes and their gamma-ray energies
• Export interactive graphs of your spectrum to embed it into your website
• Automatic peak detection (energy and isotope)
• ... and much more!

Importing Spectra

There are essentially two types of files you can use - both being text files, e.g. CSVs, XMLs or JSONs:

1. Chronological streams where each new detected event gets printed to the file after the previous one. This includes streams from our Open Gamma Detector or any other serial device that has been set up to do so. Important: The whole file will be read and the individual events are confined using the delimiter. Whitespace or newlines do not matter. The delimiter can be changed in the settings.
2. Ready-to-use histograms. This includes common file types like TKAs, CSVs and also, e.g., RadiaCode 101 XML exports. Important: If your file has more than one element per line (CSV), the first one will be regarded as channel index/energy and the second as the number of counts. If there's one element only, it will be regarded as the number of counts instead.

Gamma MCA can import JSON files complying with the NPES JSON Schema.

Using Serial

Thanks to the Web Serial API you can use any serial device capable of doing gamma spectroscopy or processing the data to plot your spectra. The are two types of prints supported:

1. Chronological streams where each new detected event gets printed to the serial interface after the other. Important: Your device has to print an EOL character (default's a semicolon ;) after every single event to signalize the end of a data entry. Whitespace or newlines do not matter. The delimiter can be changed in the settings.
2. Ready-to-use histograms. This data has been pre-processed and the finished histogram will be periodically transmitted. Important: Your device has to print an EOL character (default's a semicolon ;) after every single histogram channel to signalize the end of a data entry and each new histogram needs to be on a new line (\r\n or Arduino Serial.println(...))! The delimiter can be changed in the settings, as well as the correct number of ADC channels that is required for this to work.

Both modes are currently supported by our Open Gamma Detector or any other serial device that has been set up to do so.

Note: The API is currently only supported by Chromium-based (desktop) browsers! This includes most browsers except for Safari and Firefox. The feature is either enabled by default or you have to enable it in the settings yourself. See Can I Use?.com.

Contributing

The PWA is written with TypeScript. To make changes to the code, please only commit to and make pull requests for the dev branch! main will only pull changes from dev once I approve it.

You can find all the .ts files inside the source folder. The tsconfig.json as well as the package.json for installation of the node packages and compilation is in the root directory. The index.html is the only HTML file and can also be found there. To change other files like the CSS, fonts or so, head to assets. Other JS libs used in this app can be found in assets/js/external.

To make changes to the service worker, have a look at service-worker.js. It is written in vanilla JS, because compiling it in TS is absolute pain and totally not worth it.

---

Notice: The LICENSE does not apply to the name "Gamma MCA" and especially the Gamma MCA logo. These are Copyright 2021 by me, Phoenix1747.