What In The Gamma Is That? Libre spectroscopy software. https://spacecruft.org/spacecruft/witgit
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
jebba 2eede38b89 upstream copyright 6 months ago
docs witgit 6 months ago
.gitignore ignore data dir 6 months ago
LICENSE-GPL witgit 6 months ago
README.md upstream copyright 6 months ago
requirements.txt matplotlib-inline for spyder 6 months ago
witgit-plot start of plotting script, mostly copied from ozel 6 months ago
witgit-proc Read/process pickle file. Source from ozel. 6 months ago
witgit-rec Stripped down recorder, copied bits from ozel 6 months ago
witgit-wut py script stubs 6 months ago

README.md

witgit - What In the Gamma Is That?

witgit is free software gamma ray spectroscopy software under development intended to be used with low cost and DIY hardware running on a free operating system. For educational use only, and probably not even that.

Hardware

It would be swell to support "all" low cost and DIY hardware. These types of hardware appear to the operating system as a sound card, which makes it "easy", without having to do complicated custom drivers.

Libre / Open Source Hardware

  • DIY_particle_detector, open source hardware:

https://github.com/ozel/DIY_particle_detector/tree/master/hardware/V1.2

Proprietary Hardware

Proprietary hardware that is known to work with other DIY software.

  • Images Scientific Instruments Digital Geiger Counter, various GCA models, e.g. GCA-07W-DL.

https://www.imagesco.com/geiger/digital-geiger-counter-dl.html

  • RH Electronics MPPC SiPM CsI(Tl). Various models, such as RH-UNIT-MPPC-8-8-50.

https://rhelectronics.net/store/mppc-sipm-csi-tl-8x8x50mm-usb-gamma-spectrometer-for-theremino-becqmoni-pra.html

Installation

HOWTO Install. Development is currently done using Debian stable (Bullseye/11), which uses Python 3.9.

Install Dependencies

Get system dependency and upgrade Python pip. Perhaps do something like this, or set up a Python virtual environment.

sudo apt update
sudo apt install git python3-pip
pip install --user --upgrade pip

Clone Git Repo

Get source code with git.

git clone https://spacecruft.org/spacecruft/witgit
cd witgit/
pip install --user --upgrade -r requirements.txt

Usage

HOWTO USE. The first step is to record a sample. This is similar to just doing an audio recording. The next step is to process that file, then visualize, then categorize. Along these lines...

mkdir -p data

./witgit-rec                                   # Record

./witgit-proc [filename]                       # Process

./witgit-plot [filename]                       # View Plot

./witgit-wut  [filename]                       # Categorize

Files are automatically timestamped and written to the data/ directory.

Upstream

The code will be built using bits from other free software / open source applications.

DIY Particle Detector

The main source is the "DIY Particle Detector" by Oliver Keller from CERN. It is available upstream under a BSD license, a copy of which is in the docs/ directory.

Mirror:

Other Software

Other spectroscopy software used in DIY community. Caveat: I haven't used the below software, corrections welcome.

Free Software

Theremino

Theremino is a great system with an emphasis on education that supports a very wide range of Arduinos and other equipment. The software can be used for many more purposes than just gamma ray spectroscopy. The showstopper in this case is it is written for a proprietary operating system. There are ways to emulate that system, but that is undesirable.

Proprietary Software

BecqMoni MCA

BecqMoni MCA was quickly created in response to the 2011 Fukushima nuclear disaster in Japan. It uses .NET 3.5 framework under a proprietary operating system. It is freeware, not free software nor open source software. No one has maintained the software for years, nor can anyone improve it. The last release was 2013. It has bitrot and now mostly useless.

PRA

PRA is what the Free Software Foundation would call "freeware", not Free Software. The PRA author calls the software "free software", as they have every right to do, but it is not what the larger free software community generally considers free software. PRA does not provide source code as far as I can tell, for example. It is also written for a proprietary operating system.

Status

Alpha software under development.

Tested Hardware

Appears to work with:

  • RH Electronics RH-UNIT-MPPC-8-8-50.

License

License: GPLv3 or any later version. Other code licensed under their own respective licenses.

Upstream: Copyright (C) 2019, Oliver Keller

Copyright (C) 2022, Jeff Moe