3. About this thesis    Intro

If you are reading this as a printed thesis, it is likely a shortened version of the full document it is part of. To conform to the expectations of a PhD thesis many parts are removed that are irrelevant for the basic presentation of the work done during the thesis.

However, a fellow researcher who wishes to understand all the details, in particular in terms of reproducibility of the results, the full document should be read instead. If possible, a PhD thesis should be a tome of knowledge about the topic that allows the interested reader to absorb as much of the authors knowledge as possible to help with the continuation of the research. Crucially, this includes details about how results were obtained and access to results in numerical formats, which is both commonly lacking in regular PhD theses.

For this reason the idea of an extended thesis was born, found at 1

https://phd.vindaar.de.

There you will not only find a PDF of the thesis you are likely reading right now, but also:

  • a PDF version of the extended document,
  • an HTML version of the extended document,
  • the raw Org document of the thesis 2,
  • a link to the repository of the thesis,
  • a link to a repository of the entire raw datasets used in the thesis (plus reconstructed data) following the FAIR (Wilkinson et al. 2016) guiding principles,
  • a large amount of additional documents of notes taken during research and development.

The extended document contains many additional subsections tagged 'extended', similar to the 'Intro' tag (see the top right of the page) of this chapter. These either contain personal thoughts about why certain decisions were taken or additional research done that either lead nowhere or simply is not very relevant for the thesis. Maybe most importantly, you will find a subsection for every single plot and table included in this thesis (that was created by me) with the commands or code snippets to produce them! In addition, the linked git repository of the thesis not only contains all the figures included in the thesis as vector graphics, but also a CSV file for every plot. 3 Use them freely under the only condition to reference this thesis when you do so.

In essence the idea is to provide a fully reproducible thesis.

Furthermore, every thesis, especially those relying on large pieces of software, contains mistakes, bugs, wrong assumptions and more. Most of these are not known to the researcher, in case of wrong assumptions possibly due to lack of knowledge in a specific topic. Other times shortcomings are known, but left out for convenience. In this thesis I try to be transparent about known shortcomings. There are almost certainly bugs in the referenced code that I'm not aware of, bad assumptions about certain things, etc. Where I am aware of sketchy choices and mistakes, I will highlight them honestly.

During the work of my PhD I have written and contributed to a large number of free software / open source projects. The TimepixAnalysis 4 project – the code base at the heart of all data reconstruction and analysis for this thesis – is just one more such project. What this means is that I have no intention of abandoning it in the future, even if I leave academia. As long as there is demand for it (for example for a GridPix3 detector used at BabyIAXO), I'll be happy to maintain and extend it as needed. Future reader, don't let "last updated N years ago" scare you! Just open an issue on Github 5.

Note that I'm always available for questions about my work or this thesis either via Matrix (@vindaar:matrix.org) or on other channels (Twitter / Discord / Github @vindaar) or plainly by email phd@vindaar.de. Please do not hesitate to contact me, even if it is several years since this thesis was initially released.

3.1. Extended notes for the extended thesis [/]    extended

The extended version includes many source code blocks that can be extracted either directly using Emacs by calling org-babel-tangle in the Org document (M-x org-babel-tangle or C-c C-v t) or alternatively using ntangle:

ntangle thesis.org
  • [ ] REPRODUCE ALL RESULTS

Ideally, all results can be reproduced with a single:

./generateResults.sh

call (we'll see how that will work out).

The package versions for the code used in the extended version will be frozen at a specific time. The list of version numbers will be found below.

3.2. Why Org mode    extended

Well, if you read this, you probably understand why I wrote it in Org mode!

3.3. Notes for future PhD students and IAXO analyses    extended

Note that even if it's 2037 right now and you are a PhD student trying to understand my analysis, because you are working on (Baby)IAXO data that doesn't mean you cannot reach me to ask questions. Unless I died (let's hope not!) I'll still be reachable via

phd@vindaar.de

no matter when.

But then again at that point you probably already told your personal AGI to just reconstruct all I did, so well. Let's see how this ages, shall we?

Footnotes:

1

The actual thesis will be found there once the thesis has been published. Links to data, figures and other resources are available before though.

2

The thesis is not written directly in LaTeX, but in Emacs Org mode. From there it is exported to different targets.

3

CSV is not a great format (it's not even standardized after all), but it is convenient for such a purpose.

5

Or whatever is the go-to in the year you currently reside. I'll be sure to update the link on my website if we move host.

Click on any heading marked 'extended' to open it