This website now uses giscus to offer comments for all of the blog posts and the spectrum pages on here, yay!

Giscus is a very straightforward way to enable commenting on a website and it’s built-in straight to the Jekyll theme I’m using. It uses my own GitHub repos to store the comments in the repo’s “Discussion” section and you only need a GitHub account to comment. Just log into the comment section below (one login per website) and you can start writing!

That way, everything is 100% transparent and there is no tracking or ads or anything like that. If you choose to log into your GitHub account to comment, an authentication cookie will be set in your browser for this website only to keep you logged in. That’s it.

Finally I can say: Please let me know what you think of this new feature down below! Cheers!

You can now browse the database in its (mostly) finished form and look at all the beautiful HPGe spectra. At this point in time all the most commonly used radioisotopes are here as well as a ton of other isotopes mainly used in nuclear medicine. I hope to expand the scope of the different individual detectors on top of the HPGe detector. This includes, of course, scintillation detectors as they are the only real way for hobbyists and “normal” people to get into gamma spectroscopy. But I need your help with this! I can probably count the amount of isotopes I have lying around and have access to on one hand. In the future I am definitely planning on getting access to some more exciting ones than just Am-241, but for now I need your help. Feel free to add your own spectra to this database!

Contributing

You can add to any of the existing radioisotopes if your detector hasn’t been featured there already or if you’re spectrum is in any kind special (like better resolution, less noise, etc.). You can also add an entirely new isotope to the list!

To do so, you only have to provide the energy spectrum files and your detector calibration file. These must be compatible with the Gamma MCA app as that’s the tool I am using to export the HTML plots. Optionally, you can also include a fitting background spectrum. Unfortunately, simply exporting images of your spectrum is not enough as there are plenty of other static databases and this would also break uniformity in the page. Having a lightweight Javascript plot to look at the spectra is just so much better, even just for the sake of zooming into the image without having to look at a pixelated mess.

Compatability

To check file compatability you can do so directly in Gamma MCA, here’s a screenshot:

1. Import your energy and background spectrum files. These can be pretty much any common file format, like CSV, TKA, XML, etc. If that works out and you can see your spectrum in the plot below, go to the next step. Otherwise, please submit an issue on GitHub, see below.
2. You can do up to a 3-point calibration by selecting points in the plot and assigning the correct energy. This will create a calibration file in the background (don’t forget to hit Calibrate and check) that you have to export again by simply clicking on Export.
3. This step is optional: If you imported all the files and applied the calibration, you can also directly export the plot as an HTML file by clicking the floppy disk icon. You can attach this too when submitting, but you really don’t have to.

Now you should have 2 - 4 files: the energy spectrum, (ideally background,) calibration (and HTML file).

GitHub

The submission process is pretty straightforward. There are essentially three places for us to interact: issues, pull requests and the discussions.

If you only want to submit the files you just collected, you will have to create a new issue. Tell us a bit about your setup (detector, scintillator, …), but most importantly what isotopes you measured, in what quantity, for how long and stuff like that. Just some info on top of the raw spectrum that I can add to the plot. Please also tell me if you don’t want to be explicitly mentioned in the database, otherwise I’ll add your username. Lastly, attach your files to the post.

That’s it! I’ll reply to you after some time and let you know if we’re ready to go.

If you really don’t want to do all of this via GitHub or simply don’t have an account, you can also send me an email. You can find my contact detail to the left of this post.

Jekyll requires blog post files to be named according to the following format:

YEAR-MONTH-DAY-title.MARKUP

Where YEAR is a four-digit number, MONTH and DAY are both two-digit numbers, and MARKUP is the file extension representing the format used in the file. After that, include the necessary front matter. Take a look at the source for this post to get an idea about how it works.

Jekyll also offers powerful support for code snippets:

def print_hi(name)
  puts "Hi, #{name}"
end
print_hi('Tom')
#=> prints 'Hi, Tom' to STDOUT.

Check out the Jekyll docs for more info on how to get the most out of Jekyll. File all bugs/feature requests at Jekyll’s GitHub repo. If you have questions, you can ask them on Jekyll Talk.