README.md

+# astron-texmf
+
+LaTeX class that generates documents that look vaguely like ASTRON “standard” MS Word documents.
+Comes bundled with a similar template for [ESCAPE Project](https://www.projectescape.eu/) documents.
+
+Provides a bunch of niceties, including Git integration (automatically stamp documents with version numbers, generate change records based on tags, etc) and an extensive (does this mean unwieldy?) set of acronyms.
+
+See the example directory in this repository for a brief example or refer to e.g. [ESCAPE D5.4](https://git.astron.nl/astron-sdc/escape-wp5/docs/escape-d5.4) for a more comprehensive demo.

bin/gen_change_record.py

+#!/usr/bin/env python3
+
+# Generate a change record for inclusion in an astron-texmf style LaTeX
+# document.
+# Assumes that all the relevant versions in the document have tags which match
+# \d+\.\d+.
+import subprocess
+from dataclasses import dataclass
+from datetime import datetime
+from io import StringIO
+from re import match
+
+
+@dataclass
+class Tag(object):
+    """Represent a git tag"""
+
+    name: str
+    message: str
+
+    @property
+    def rev(self):
+        return subprocess.check_output(["git", "rev-parse", self.name]).decode().strip()
+
+    @property
+    def date(self):
+        for line in (
+            subprocess.check_output(["git", "cat-file", "-p", self.rev])
+            .decode()
+            .strip()
+            .split("\n")
+        ):
+            if line.startswith("tagger"):
+                return datetime.fromtimestamp(int(line.split()[-2]))
+
+
+def escape_latex(text):
+    return text.strip().replace("#", r"\#").replace("&", r"\&")
+
+
+def get_all_tags():
+    try:
+        tags = [
+            Tag(*tag.split(None, 1))
+            for tag in subprocess.check_output(["git", "tag", "-n99", "--merged"])
+            .decode()
+            .strip()
+            .split("\n")
+            if tag
+        ]
+    except:
+        tags = []
+    return tags
+
+
+def generate_change_record(tags):
+    output = StringIO()
+    if tags:
+        output.write("\setDocChangeRecord{\n")
+        for tag in sorted(tags, key=lambda x: x.name, reverse=True):
+            if match(r"\d+\.\d+", tag.name):
+                output.write(f"    \\addChangeRecord{{{escape_latex(tag.name)}}}")
+                output.write(f"{{{tag.date.strftime('%Y-%m-%d')}}}")
+                output.write(f"{{{escape_latex(tag.message)}}}\n")
+        output.write("}")
+    return output.getvalue()
+
+
+if __name__ == "__main__":
+    print(generate_change_record(get_all_tags()))

example/.gitignore

@@ -11,3 +11,4 @@ example.out
 example.pdf
 example.run.xml
 meta.tex
+changes.tex

example/Makefile

@@ -8,4 +8,5 @@ $(DOCNAME).pdf: $(DOCNAME).tex meta.tex
 	xelatex $(DOCNAME)
 	xelatex $(DOCNAME)
 
-include ../vcs-meta.make
+include $(TEXMFHOME)/../make/vcs-meta.make
+include $(TEXMFHOME)/../make/changes.make

example/example.tex

@@ -31,9 +31,6 @@
   \addPerson{A person}{An institute}{A date}
 }
 
-\input{astron-abbreviations}
-\makeglossaries
-
 \begin{document}
 \maketitle
 
@@ -43,7 +40,7 @@
 \printbibliography
 \clearpage
 
-Check that abbreviations are working properly: \gls{SDC}, \gls{SKA}.
+Check that abbreviations are working properly: \gls{SDC}, \gls{ESCAPE}.
 
 Check that citations are working properly: \autocite{SDC-001}, \autocite{SDC-002}.
 

make/changes.make

+.FORCE:
+
+changes.tex: Makefile .FORCE
+	rm -f $@
+	printf "%s\n" "% GENERATED FILE -- do not edit" >>$@
+	$(TEXMFHOME)/../bin/gen_change_record.py >>$@

vcs-meta.make → make/vcs-meta.make

@@ -7,8 +7,9 @@ GITLASTYEAR := $(shell git log -1 --date=short --pretty=%ad | cut -d- -f1)
 
 meta.tex: Makefile .FORCE
 	rm -f $@
-	printf "%s\n" "% GENERATED FILE -- edit this in the Makefile" >>$@
+	printf "%s\n" "% GENERATED FILE -- do not edit" >>$@
 	printf "%s\n" "\newcommand{\vcsRevision}{$(GITVERSION)}" >>$@
 	printf "%s\n" "\newcommand{\vcsDate}{$(GITDATE)}" >>$@
 	printf "%s\n" "\newcommand{\vcsFirstYear}{$(GITFIRSTYEAR)}" >>$@
 	printf "%s\n" "\newcommand{\vcsLastYear}{$(GITLASTYEAR)}" >>$@
+	printf "%s\n" "\newcommand{\docHandle}{$(DOCHANDLE)}" >>$@

texmf/bibtex/bib/apertif.bib

+@INPROCEEDINGS{2018wtfa.confE..16O,
+       author = {{Oosterloo}, T. and {van Leeuwen}, J. and {Van Cappellen}, W. and {Kruithof}, G. and {Jackson}, C.},
+        title = "{Apertif; the next stage}",
+    booktitle = {Westerbork Telescope 50th Anniversary},
+         year = 2018,
+       volume = {361},
+        month = sep,
+          eid = {16},
+        pages = {16},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2018wtfa.confE..16O},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}

texmf/bibtex/bib/astron.bib

@@ -7,6 +7,30 @@
     year = 2020,
     month = 1,
     day = 30,
-    version = 1,
+    version = "1",
     url = {https://edu.nl/afu73},
 }
+
+@Misc{2019-FuSE-Proposal,
+    author = "{FuSE} Team",
+    title = "{FuSE: Fundamental Sciences E-infrastructre}",
+    year = 2019,
+    howpublished = "{Grant application, National Roadmap for Large-Scale Research Infrastructure 2019--2020}",
+}
+
+@Misc{dijkema_tammo_jan_2018_3479829,
+  author       = {Dijkema, Tammo Jan and
+                  Grange, Yan and
+                  Gunst, André and
+                  Halfwerk, Ronald and
+                  Jürges, Thomas and
+                  Nijboer, Ronald and
+                  Beukema, Ruud},
+  title        = {ASTRON Open Source Policy},
+  month        = oct,
+  year         = 2018,
+  publisher    = {Zenodo},
+  version      = {1.3},
+  doi          = {10.5281/zenodo.3479829},
+  url          = {https://doi.org/10.5281/zenodo.3479829}
+}

texmf/bibtex/bib/escape.bib

+% General ASTRON documents
+
+@Misc{ESCAPE-GA,
+    title = "Grant Agreement Number 824064 --- {ESCAPE}",
+    institution = "European Commission Directorate-General Research \& Innovation",
+    year = 2018,
+    month = 11,
+    day = 6
+}
+
+@TechReport{ESCAPE-D5.1,
+    author = {Meyer-Zhao (ASTRON), Zheng and
+              Grange (ASTRON), Yan and
+              van Haarlem (ASTRON), Michiel and
+              Groep (Nikhef), David and
+              Bolton (SKAO), Rosie and
+              Dickinson (Open University), Hugh and
+              Sánchez-Expósito (IAA-CSIC), Susana and
+              Ramón Rodón (IAA-CSIC), José},
+    title = "D5.1: Preliminary Report on Requirements for {ESFRI} Science Analysis Use Cases",
+    institution = "{ESCAPE}",
+    year = 2019,
+    month = 7,
+    day = 30,
+    version = "1.1",
+    url = {https://projectescape.eu/deliverables-and-reports/d51-preliminary-report-requirements-esfri-science-analysis-use-cases}
+}
+
+@TechReport{ESCAPE-D5.2,
+    author = {Meyer-Zhao (ASTRON), Zheng and
+              Grange (ASTRON), Yan and
+              van Haarlem (ASTRON), Michiel and
+              Szomoru (Nikhef), Arpad and
+              Voutsinas (UEDIN), Stelios and
+              Taffoni (INAF), Giuliano and
+              Sánchez-Expósito (IAA-CSIC), Susana and
+              Chanial (EGO), Pierre and
+              Dickinson (Open University), Hugh and
+              Matthias (CTAO), Füßling},
+    title = "D5.2: Detailed Project Plan",
+    institution = "{ESCAPE}",
+    year = 2019,
+    month = 10,
+    day = 31,
+    version = "1.0",
+    url = {https://projectescape.eu/deliverables-and-reports/d52-detailed-project-plan}
+}
+
+@TechReport{ESCAPE-D5.3,
+    author = {Swinbank (ASTRON), John D. and
+             Bird (CNRS‐LAPP), Ian and
+             Dickinson (Open University), Hugh and
+             Garrido (IAA‐CSIC), Rafael and
+             Hughes (CTAO) Gareth, and
+             Ramón Rodón (IAA‐CSIC), José and
+             Sánchez Expósito (IAA‐CSIC), Susana and
+             Taffoni (INAF), Giuliano and
+             Verdes‐Montenegro (IAA‐CSIC), Lourdes and
+             Verkouter (JIVE), Harro and
+             Vermaas (ASTRON), Nico and
+             Voutsinas (U. Edinburgh), Stelios},
+    title = "D5.3: Performance Assessment of Initial Science Platform Prototype",
+    institution = "{ESCAPE}",
+    year = 2021,
+    month = 08,
+    day = 27,
+    version = "1.0",
+}
+
+@TechReport{2018-EC-FAIR,
+    author = {European Commission Expert Group on FAIR Data},
+    title = "Turning {FAIR} into Reality",
+    institution = "{E}uropean {C}ommission",
+    url = {https://op.europa.eu/s/pCqN}
+}
+
+@Software{vuillaume_thomas_2022_6826881,
+  author       = {Vuillaume, Thomas and
+                  Garcia, Enrique and
+                  Tacke, Christian and
+                  Gál, Tamás},
+  title        = {eossr},
+  month        = jul,
+  year         = 2022,
+  note         = {Release Notes:},
+  publisher    = {Zenodo},
+  version      = {v0.6.1},
+  doi          = {10.5281/zenodo.6826881},
+  url          = {https://doi.org/10.5281/zenodo.6826881}
+}
+
+@InProceedings{gammapy:2017,
+  author = {{Deil}, C. and {Zanin}, R. and {Lefaucheur}, J. and {Boisson}, C. and
+           {Khelifi}, B. and {Terrier}, R. and {Wood}, M. and {Mohrmann}, L. and
+           {Chakraborty}, N. and {Watson}, J. and {Lopez-Coto}, R. and
+           {Klepser}, S. and {Cerruti}, M. and {Lenain}, J.~P. and {Acero}, F. and
+           {Djannati-Ata{\"\i}}, A. and {Pita}, S. and {Bosnjak}, Z. and
+           {Trichard}, C. and {Vuillaume}, T. and {Donath}, A. and
+           {Consortium}, CTA and {King}, J. and {Jouvin}, L. and {Owen}, E. and
+           {Sipocz}, B. and {Lennarz}, D. and {Voruganti}, A. and
+           {Spir-Jacob}, M. and {Ruiz}, J. Enrique and {Arribas}, M. Paz},
+  title = "{Gammapy - A prototype for the CTA science tools}",
+  keywords = {Astrophysics - Instrumentation and Methods for Astrophysics},
+  booktitle = {35th International Cosmic Ray Conference (ICRC2017)},
+  year = 2017,
+  series = {International Cosmic Ray Conference},
+  volume = {301},
+  month = jan,
+  eid = {766},
+  pages = {766},
+  archivePrefix = {arXiv},
+  eprint = {1709.01751},
+  primaryClass = {astro-ph.IM},
+  adsurl = {https://ui.adsabs.harvard.edu/abs/2017ICRC...35..766D},
+  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@ARTICLE{2022A&A...660A..18N,
+       author = {{Nigro}, C. and {Sitarek}, J. and {Gliwny}, P. and {Sanchez}, D. and {Tramacere}, A. and {Craig}, M.},
+        title = "{agnpy: An open-source python package modelling the radiative processes of jetted active galactic nuclei}",
+      journal = {Astronomy \& Astrophysics},
+     keywords = {radiation mechanisms: general, radiation mechanisms: non-thermal, methods: numerical, galaxies: active, galaxies: jets, Astrophysics - Instrumentation and Methods for Astrophysics, Astrophysics - Astrophysics of Galaxies, Astrophysics - High Energy Astrophysical Phenomena},
+         year = 2022,
+        month = apr,
+       volume = {660},
+          eid = {A18},
+        pages = {A18},
+          doi = {10.1051/0004-6361/202142000},
+archivePrefix = {arXiv},
+       eprint = {2112.14573},
+ primaryClass = {astro-ph.IM},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2022A&A...660A..18N},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@ARTICLE{2022A&C....4100648R,
+       author = {{Russo}, S.~A. and {Bertocco}, S. and {Gheller}, C. and {Taffoni}, G.},
+        title = "{Rosetta: A container-centric science platform for resource-intensive, interactive data analysis}",
+      journal = {Astronomy and Computing},
+     keywords = {Science platforms, Data analysis, Reproducibility, Software containers, Big data, HPC, Astrophysics - Instrumentation and Methods for Astrophysics, Computer Science - Distributed, Parallel, and Cluster Computing},
+         year = 2022,
+        month = oct,
+       volume = {41},
+          eid = {100648},
+        pages = {100648},
+          doi = {10.1016/j.ascom.2022.100648},
+archivePrefix = {arXiv},
+       eprint = {2209.02003},
+ primaryClass = {astro-ph.IM},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2022A&C....4100648R},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}

texmf/bibtex/bib/general.bib

 % Documents originating outside ASTRON.
+@ARTICLE{2022ApJ...935..167A,
+       author = {{Astropy Collaboration} and {Price-Whelan}, Adrian M. and {Lim}, Pey Lian and {Earl}, Nicholas and {Starkman}, Nathaniel and {Bradley}, Larry and {Shupe}, David L. and {Patil}, Aarya A. and {Corrales}, Lia and {Brasseur}, C.~E. and {N{\"o}the}, Maximilian and {Donath}, Axel and {Tollerud}, Erik and {Morris}, Brett M. and {Ginsburg}, Adam and {Vaher}, Eero and {Weaver}, Benjamin A. and {Tocknell}, James and {Jamieson}, William and {van Kerkwijk}, Marten H. and {Robitaille}, Thomas P. and {Merry}, Bruce and {Bachetti}, Matteo and {G{\"u}nther}, H. Moritz and {Aldcroft}, Thomas L. and {Alvarado-Montes}, Jaime A. and {Archibald}, Anne M. and {B{\'o}di}, Attila and {Bapat}, Shreyas and {Barentsen}, Geert and {Baz{\'a}n}, Juanjo and {Biswas}, Manish and {Boquien}, M{\'e}d{\'e}ric and {Burke}, D.~J. and {Cara}, Daria and {Cara}, Mihai and {Conroy}, Kyle E. and {Conseil}, Simon and {Craig}, Matthew W. and {Cross}, Robert M. and {Cruz}, Kelle L. and {D'Eugenio}, Francesco and {Dencheva}, Nadia and {Devillepoix}, Hadrien A.~R. and {Dietrich}, J{\"o}rg P. and {Eigenbrot}, Arthur Davis and {Erben}, Thomas and {Ferreira}, Leonardo and {Foreman-Mackey}, Daniel and {Fox}, Ryan and {Freij}, Nabil and {Garg}, Suyog and {Geda}, Robel and {Glattly}, Lauren and {Gondhalekar}, Yash and {Gordon}, Karl D. and {Grant}, David and {Greenfield}, Perry and {Groener}, Austen M. and {Guest}, Steve and {Gurovich}, Sebastian and {Handberg}, Rasmus and {Hart}, Akeem and {Hatfield-Dodds}, Zac and {Homeier}, Derek and {Hosseinzadeh}, Griffin and {Jenness}, Tim and {Jones}, Craig K. and {Joseph}, Prajwel and {Kalmbach}, J. Bryce and {Karamehmetoglu}, Emir and {Ka{\l}uszy{\'n}ski}, Miko{\l}aj and {Kelley}, Michael S.~P. and {Kern}, Nicholas and {Kerzendorf}, Wolfgang E. and {Koch}, Eric W. and {Kulumani}, Shankar and {Lee}, Antony and {Ly}, Chun and {Ma}, Zhiyuan and {MacBride}, Conor and {Maljaars}, Jakob M. and {Muna}, Demitri and {Murphy}, N.~A. and {Norman}, Henrik and {O'Steen}, Richard and {Oman}, Kyle A. and {Pacifici}, Camilla and {Pascual}, Sergio and {Pascual-Granado}, J. and {Patil}, Rohit R. and {Perren}, Gabriel I. and {Pickering}, Timothy E. and {Rastogi}, Tanuj and {Roulston}, Benjamin R. and {Ryan}, Daniel F. and {Rykoff}, Eli S. and {Sabater}, Jose and {Sakurikar}, Parikshit and {Salgado}, Jes{\'u}s and {Sanghi}, Aniket and {Saunders}, Nicholas and {Savchenko}, Volodymyr and {Schwardt}, Ludwig and {Seifert-Eckert}, Michael and {Shih}, Albert Y. and {Jain}, Anany Shrey and {Shukla}, Gyanendra and {Sick}, Jonathan and {Simpson}, Chris and {Singanamalla}, Sudheesh and {Singer}, Leo P. and {Singhal}, Jaladh and {Sinha}, Manodeep and {Sip{\H{o}}cz}, Brigitta M. and {Spitler}, Lee R. and {Stansby}, David and {Streicher}, Ole and {{\v{S}}umak}, Jani and {Swinbank}, John D. and {Taranu}, Dan S. and {Tewary}, Nikita and {Tremblay}, Grant R. and {Val-Borro}, Miguel de and {Van Kooten}, Samuel J. and {Vasovi{\'c}}, Zlatan and {Verma}, Shresth and {de Miranda Cardoso}, Jos{\'e} Vin{\'\i}cius and {Williams}, Peter K.~G. and {Wilson}, Tom J. and {Winkel}, Benjamin and {Wood-Vasey}, W.~M. and {Xue}, Rui and {Yoachim}, Peter and {Zhang}, Chen and {Zonca}, Andrea and {Astropy Project Contributors}},
+        title = "{The Astropy Project: Sustaining and Growing a Community-oriented Open-source Project and the Latest Major Release (v5.0) of the Core Package}",
+      journal = {Astrophysical Journal},
+     keywords = {Astronomy software, Open source software, Astronomy data analysis, 1855, 1866, 1858, Astrophysics - Instrumentation and Methods for Astrophysics},
+         year = 2022,
+        month = aug,
+       volume = {935},
+       number = {2},
+          eid = {167},
+        pages = {167},
+          doi = {10.3847/1538-4357/ac7c74},
+archivePrefix = {arXiv},
+       eprint = {2206.14220},
+ primaryClass = {astro-ph.IM},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2022ApJ...935..167A},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
 @ARTICLE{astropy:2018,
    author = {{The Astropy Collaboration} and {Price-Whelan}, A.~M. and {Sip{\H o}cz}, B.~M. and
 	{G{\"u}nther}, H.~M. and {Lim}, P.~L. and {Crawford}, S.~M. and
@@ -82,3 +101,293 @@ archivePrefix = "arXiv",
           url = "https://doi.org/10.1007/s41781-019-0026-3",
     publisher = "Springer International Publishing"
 }
+
+@INPROCEEDINGS{topcat:2005,
+       author = {{Taylor}, M.~B.},
+        title = "{TOPCAT \& STIL: Starlink Table/VOTable Processing Software}",
+    booktitle = {Astronomical Data Analysis Software and Systems XIV},
+         year = 2005,
+       editor = {{Shopbell}, P. and {Britton}, M. and {Ebert}, R.},
+       series = {Astronomical Society of the Pacific Conference Series},
+       volume = {347},
+        month = dec,
+        pages = {29},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2005ASPC..347...29T},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+% Suggested by https://github.com/jupyter/jupyter/issues/190
+@inproceedings{jupyter:2016,
+       booktitle = {Positioning and Power in Academic Publishing: Players, Agents and Agendas},
+          editor = {Fernando Loizides and Birgit Scmidt},
+           title = {Jupyter Notebooks - a publishing format for reproducible computational workflows},
+          author = {Thomas Kluyver and Benjamin Ragan-Kelley and Fernando P{\'e}rez and Brian Granger and Matthias Bussonnier and Jonathan Frederic and Kyle Kelley and Jessica Hamrick and Jason Grout and Sylvain Corlay and Paul Ivanov and Dami{\'a}n Avila and Safia Abdalla and Carol Willing and  Jupyter development team},
+       publisher = {IOS Press},
+         address = {Netherlands},
+            year = {2016},
+           pages = {87--90},
+             url = {https://eprints.soton.ac.uk/403913/},
+        abstract = {It is increasingly necessary for researchers in all fields to write computer code, and in order to reproduce research results, it is important that this code is published. We present Jupyter notebooks, a document format for publishing code, results and explanations in a form that is both readable and executable. We discuss various tools and use cases for notebook documents.}
+}
+
+@ARTICLE{aladin:2000,
+       author = {{Bonnarel}, F. and {Fernique}, P. and {Bienaym{\'e}}, O. and {Egret}, D. and {Genova}, F. and {Louys}, M. and {Ochsenbein}, F. and {Wenger}, M. and {Bartlett}, J.~G.},
+        title = "{The ALADIN interactive sky atlas. A reference tool for identification of astronomical sources}",
+      journal = {Astronomy and Astrophysics Supplement},
+     keywords = {ASTRONOMICAL DATA BASES: MISCELLANEOUS, CATALOGS, ATLASES, SURVEYS},
+         year = 2000,
+        month = apr,
+       volume = {143},
+        pages = {33--40},
+          doi = {10.1051/aas:2000331},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2000A&AS..143...33B},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@INPROCEEDINGS{esasky:2020,
+       author = {{Mer{\'\i}n}, Bruno and {Giordano}, Fabrizio and {Norman}, Henrik and {Racero}, Elena and {Baines}, Deborah and {Salgado}, Jes{\'u}s and {L{\'o}pez Mart{\'\i}}, Bel{\'e}n and {Alberola}, Sara and {L{\'o}pez Caniego}, Marcos and {Valtchanov}, Ivan and {de Marchi}, Guido and {Arviset}, Christophe},
+        title = "{ESASky v. 2.0: All the Skies in your Browser}",
+    booktitle = {Astronomical Data Analysis Software and Systems XXVII},
+         year = 2020,
+       editor = {{Ballester}, Pascal and {Ibsen}, Jorge and {Solar}, Mauricio and {Shortridge}, Keith},
+       series = {Astronomical Society of the Pacific Conference Series},
+       volume = {522},
+        month = apr,
+        pages = {89},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2020ASPC..522...89M},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@InProceedings{binder:2018,
+  author    = {{P}roject {J}upyter and {M}atthias {B}ussonnier and {J}essica {F}orde and {J}eremy {F}reeman and {B}rian {G}ranger and {T}im {H}ead and {C}hris {H}oldgraf and {K}yle {K}elley and {G}ladys {N}alvarte and {A}ndrew {O}sheroff and {M} {P}acer and {Y}uvi {P}anda and {F}ernando {P}erez and {B}enjamin {R}agan-{K}elley and {C}arol {W}illing},
+  title     = {{B}inder 2.0 - {R}eproducible, interactive, sharable environments for science at scale},
+  booktitle = {{P}roceedings of the 17th {P}ython in {S}cience {C}onference},
+  pages     = {113--120},
+  year      = {2018},
+  editor    = {{F}atih {A}kici and {D}avid {L}ippa and {D}illon {N}iederhut and {M} {P}acer},
+  doi       = {10.25080/Majora-4af1f417-011 }
+}
+
+@software{dirac:2018,
+  author       = {Federico Stagni and
+                  Andrei Tsaregorodtsev and
+                  ubeda and
+                  Philippe Charpentier and
+                  Krzysztof Daniel Ciba and
+                  Zoltan Mathe and
+                  Andre Sailer and
+                  Ricardo Graciani and
+                  Christophe Haen and
+                  Wojciech Krzemien and
+                  Sergio Balbuena and
+                  Marko Petric and
+                  Miłosz and
+                  Joel Closier and
+                  Simon Fayer and
+                  Stephane Poss and
+                  Adrià Casajús and
+                  Tao Lin and
+                  Philipp and
+                  CinziaLu and
+                  Yash Srivastava and
+                  Daniela Remenska and
+                  Andrew McNab and
+                  Pierre Gay and
+                  Marcelo Vilaca and
+                  Luisa Arrabito},
+  title        = {DIRACGrid/DIRAC: v6r20p15},
+  month        = oct,
+  year         = 2018,
+  publisher    = {Zenodo},
+  version      = {v6r20p15},
+  doi          = {10.5281/zenodo.1451647},
+  url          = {https://doi.org/10.5281/zenodo.1451647}
+}
+
+@software{dirac:2022,
+  author       = {Andrei Tsaregorodtsev and
+                  fstagni and
+                  Philippe Charpentier and
+                  ubeda and
+                  Andre Sailer and
+                  Krzysztof Daniel Ciba and
+                  chaen and
+                  Chris Burr and
+                  Andrii Lytovchenko and
+                  Ricardo Graciani and
+                  arrabito and
+                  Wojciech Krzemien and
+                  wirespecter and
+                  Ruben Pozzi and
+                  Sergio Balbuena and
+                  sfayer and
+                  aldbr and
+                  Miłosz and
+                  Joel Closier and
+                  Stephane Poss and
+                  Adrià Casajús and
+                  vipersec and
+                  LCDgit and
+                  Tao Lin and
+                  Daniela Bauer and
+                  CinziaLu and
+                  martynia and
+                  Daniela Remenska and
+                  TaykYoku2 and
+                  Pujan Mehta},
+  title        = {DIRACGrid/DIRAC: v8.0.8},
+  month        = dec,
+  year         = 2022,
+  publisher    = {Zenodo},
+  version      = {v8.0.8},
+  doi          = {10.5281/zenodo.7457409},
+  url          = {https://doi.org/10.5281/zenodo.7457409}
+}
+
+@INPROCEEDINGS{casa:2007,
+       author = {{McMullin}, J.~P. and {Waters}, B. and {Schiebel}, D. and {Young}, W. and {Golap}, K.},
+        title = "{CASA Architecture and Applications}",
+    booktitle = {Astronomical Data Analysis Software and Systems XVI},
+         year = 2007,
+       editor = {{Shaw}, R.~A. and {Hill}, F. and {Bell}, D.~J.},
+       series = {Astronomical Society of the Pacific Conference Series},
+       volume = {376},
+        month = oct,
+        pages = {127},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2007ASPC..376..127M},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@inproceedings{10.1145/2063348.2063364,
+  author = {Wang, Daniel L. and Monkewitz, Serge M. and Lim, Kian-Tat and Becla, Jacek},
+  title = {Qserv: A Distributed Shared-Nothing Database for the LSST Catalog},
+  year = {2011},
+  isbn = {9781450311397},
+  publisher = {Association for Computing Machinery},
+  address = {New York, NY, USA},
+  url = {https://doi.org/10.1145/2063348.2063364},
+  doi = {10.1145/2063348.2063364},
+  abstract = {The LSST project will provide public access to a database catalog that, in its final year, is estimated to include 26 billion stars and galaxies in dozens of trillion detections in multiple petabytes. Because we are not aware of an existing open-source database implementation that has been demonstrated to efficiently satisfy astronomers' spatial self-joining and cross-matching queries at this scale, we have implemented Qserv, a distributed shared-nothing SQL database query system. To speed development, Qserv relies on two successful open-source software packages: the MySQL RDBMS and the Xrootd distributed file system. We describe Qserv's design, architecture, and ability to scale to LSST's data requirements. We illustrate its potential with test results on a 150-node cluster using 55 billion rows and 30 terabytes of simulated data. These results demonstrate the soundness of Qserv's approach and the scale it achieves on today's hardware.},
+  booktitle = {State of the Practice Reports},
+  articleno = {12},
+  numpages = {11},
+  keywords = {shared-nothing, distributed, database, file system, parallel, MPP},
+  location = {Seattle, Washington},
+  series = {SC '11}
+}
+
+@book{doi:10.1142/10986,
+  author = {The Cherenkov Telescope Array Consortium and others},
+  title = {Science with the Cherenkov Telescope Array},
+  publisher = {WORLD SCIENTIFIC},
+  year = {2019},
+  doi = {10.1142/10986},
+  address = {},
+  edition   = {},
+  URL = {https://www.worldscientific.com/doi/abs/10.1142/10986},
+  eprint = {https://www.worldscientific.com/doi/pdf/10.1142/10986}
+}
+
+@ARTICLE{2020PASA...37....2W,
+       author = {{Weltman}, A. and {Bull}, P. and {Camera}, S. and {Kelley}, K. and {Padmanabhan}, H. and {Pritchard}, J. and {Raccanelli}, A. and {Riemer-S{\o}rensen}, S. and {Shao}, L. and {Andrianomena}, S. and {Athanassoula}, E. and {Bacon}, D. and {Barkana}, R. and {Bertone}, G. and {B{\oe}hm}, C. and {Bonvin}, C. and {Bosma}, A. and {Br{\"u}ggen}, M. and {Burigana}, C. and {Calore}, F. and {Cembranos}, J.~A.~R. and {Clarkson}, C. and {Connors}, R.~M.~T. and {Cruz-Dombriz}, {\'A}. de la and {Dunsby}, P.~K.~S. and {Fonseca}, J. and {Fornengo}, N. and {Gaggero}, D. and {Harrison}, I. and {Larena}, J. and {Ma}, Y. -Z. and {Maartens}, R. and {M{\'e}ndez-Isla}, M. and {Mohanty}, S.~D. and {Murray}, S. and {Parkinson}, D. and {Pourtsidou}, A. and {Quinn}, P.~J. and {Regis}, M. and {Saha}, P. and {Sahl{\'e}n}, M. and {Sakellariadou}, M. and {Silk}, J. and {Trombetti}, T. and {Vazza}, F. and {Venumadhav}, T. and {Vidotto}, F. and {Villaescusa-Navarro}, F. and {Wang}, Y. and {Weniger}, C. and {Wolz}, L. and {Zhang}, F. and {Gaensler}, B.~M.},
+        title = "{Fundamental physics with the Square Kilometre Array}",
+      journal = {Publications of the Astronomical Society of Australia},
+     keywords = {astroparticle physics, cosmology, gravitation, pulsars: general, reionisation, telescopes, Astrophysics - Cosmology and Nongalactic Astrophysics, Astrophysics - Instrumentation and Methods for Astrophysics, High Energy Physics - Phenomenology},
+         year = 2020,
+        month = jan,
+       volume = {37},
+          eid = {e002},
+        pages = {e002},
+          doi = {10.1017/pasa.2019.42},
+archivePrefix = {arXiv},
+       eprint = {1810.02680},
+ primaryClass = {astro-ph.CO},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2020PASA...37....2W},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@Article{doi:10.1038/s41597-022-01710-x,
+    author = {{Barker, Michelle}, and {Chue Hong, Neil P.}, and {Katz, Daniel S.}, and {Lamprecht, Anna-Lena}, and {Martinez-Ortiz, Carlos}, and {Psomopoulos, Fotis}, and {Harrow, Jennifer}, and {Castro, Leyla Jael}, and {Gruenpeter, Morane}, and {Martinez, Paula Andrea}, and {Honeyman, Tom}},
+    title = "{Introducing the FAIR Principles for research software}",
+    journal = {Scientific Data},
+    year = 2022,
+    month = oct,
+    volume = {9},
+    doi = {10.1038/s41597-022-01710-x}
+}
+
+@Article{Wilkinson2016,
+author={Wilkinson, Mark D.
+and Dumontier, Michel
+and Aalbersberg, IJsbrand Jan
+and Appleton, Gabrielle
+and Axton, Myles
+and Baak, Arie
+and Blomberg, Niklas
+and Boiten, Jan-Willem
+and da Silva Santos, Luiz Bonino
+and Bourne, Philip E.
+and Bouwman, Jildau
+and Brookes, Anthony J.
+and Clark, Tim
+and Crosas, Merc{\`e}
+and Dillo, Ingrid
+and Dumon, Olivier
+and Edmunds, Scott
+and Evelo, Chris T.
+and Finkers, Richard
+and Gonzalez-Beltran, Alejandra
+and Gray, Alasdair J.G.
+and Groth, Paul
+and Goble, Carole
+and Grethe, Jeffrey S.
+and Heringa, Jaap
+and 't Hoen, Peter A.C
+and Hooft, Rob
+and Kuhn, Tobias
+and Kok, Ruben
+and Kok, Joost
+and Lusher, Scott J.
+and Martone, Maryann E.
+and Mons, Albert
+and Packer, Abel L.
+and Persson, Bengt
+and Rocca-Serra, Philippe
+and Roos, Marco
+and van Schaik, Rene
+and Sansone, Susanna-Assunta
+and Schultes, Erik
+and Sengstag, Thierry
+and Slater, Ted
+and Strawn, George
+and Swertz, Morris A.
+and Thompson, Mark
+and van der Lei, Johan
+and van Mulligen, Erik
+and Velterop, Jan
+and Waagmeester, Andra
+and Wittenburg, Peter
+and Wolstencroft, Katherine
+and Zhao, Jun
+and Mons, Barend},
+title={The FAIR Guiding Principles for scientific data management and stewardship},
+journal={Scientific Data},
+year={2016},
+month={Mar},
+day={15},
+volume={3},
+number={1},
+pages={160018},
+abstract={There is an urgent need to improve the infrastructure supporting the reuse of scholarly data. A diverse set of stakeholders---representing academia, industry, funding agencies, and scholarly publishers---have come together to design and jointly endorse a concise and measureable set of principles that we refer to as the FAIR Data Principles. The intent is that these may act as a guideline for those wishing to enhance the reusability of their data holdings. Distinct from peer initiatives that focus on the human scholar, the FAIR Principles put specific emphasis on enhancing the ability of machines to automatically find and use the data, in addition to supporting its reuse by individuals. This Comment is the first formal publication of the FAIR Principles, and includes the rationale behind them, and some exemplar implementations in the community.},
+issn={2052-4463},
+doi={10.1038/sdata.2016.18},
+url={https://doi.org/10.1038/sdata.2016.18}
+}
+
+
+@book{doi/10.2777/18252,
+author = {European Commission and Directorate-General for Research and Innovation},
+title = {Horizon Europe, open science – Early knowledge and data sharing, and open collaboration},
+publisher = {Publications Office of the European Union},
+year = {2021},
+doi = {doi/10.2777/18252}}

texmf/bibtex/bib/ivoa.bib

 % IVOA documents
 
+@Misc{2010ivoa.rept.1123A,
+       author = {{Arviset}, Christophe and {Gaudet}, Severin and {IVOA Technical Coordination Group}},
+        title = "{IVOA Architecture Version 1.0}",
+ howpublished = {IVOA Note},
+         year = 2010,
+        month = nov,
+        pages = {1123},
+          doi = {10.5479/ADS/bib/2010ivoa.rept.1123A},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2010ivoa.rept.1123A},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
 @Misc{2012ivoa.spec.1104T,
        author = {{Taylor}, M. and {Boch}, T. and {Fitzpatrick}, M. and {Allan}, A. and {Fay}, J. and {Paioro}, L. and {Taylor}, J. and {Tody}, D.},
         title = "{Simple Application Messaging Protocol Version 1.3}",
- howpublished = {IVOA Recommendation 11 April 2012},
+ howpublished = {IVOA Recommendation},
          year = 2012,
         month = apr,
         pages = {1104},
@@ -28,7 +40,7 @@
        author = {{Seaman}, Rob and {Williams}, Roy and {Allan}, Alasdair and {Barthelmy}, Scott and {Bloom}, Joshua and {Brewer}, John and {Denny}, Robert and {Fitzpatrick}, Mike and {Graham}, Matthew and {Gray}, Norman and {Hessman}, Frederic and {Marka}, Szabolcs and {Rots}, Arnold and {Vestrand}, Tom and {Wozniak}, Przemyslaw},
         title = "{Sky Event Reporting Metadata Version 2.0}",
      keywords = {Astrophysics - Instrumentation and Methods for Astrophysics},
- howpublished = {IVOA Recommendation 11 July 2011},
+ howpublished = {IVOA Recommendation},
          year = 2011,
         month = jul,
         pages = {711},
@@ -39,3 +51,35 @@ archivePrefix = {arXiv},
        adsurl = {https://ui.adsabs.harvard.edu/abs/2011ivoa.spec.0711S},
       adsnote = {Provided by the SAO/NASA Astrophysics Data System}
 }
+
+@Misc{2019ivoa.spec.1021O,
+       author = {{Ochsenbein}, Francois and {Taylor}, Mark and {Donaldson}, Tom and {Williams}, Roy and {Davenhall}, Clive and {Demleitner}, Markus and {Durand}, Daniel and {Fernique}, Pierre and {Giaretta}, David and {Hanisch}, Robert and {McGlynn}, Tom and {Szalay}, Alex and {Wicenec}, Andreas},
+        title = "{VOTable Format Definition Version 1.4}",
+ howpublished = {IVOA Recommendation},
+         year = 2019,
+        month = oct,
+        pages = {1021},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2019ivoa.spec.1021O},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@Misc{2016ivoa.spec.1024H,
+       author = {{Harrison}, P.~A. and {Rixon}, G.},
+        title = "{Universal Worker Service Pattern Version 1.1}",
+ howpublished = {IVOA Recommendation},
+         year = 2016,
+        month = oct,
+        pages = {1024},
+          doi = {10.5479/ADS/bib/2016ivoa.spec.1024H},
+       adsurl = {https://ui.adsabs.harvard.edu/abs/2016ivoa.spec.1024H},
+      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@Misc{2021ivoa.rept.ExecPlanner,
+       author = {{Morris}, Dave and {Bertocco}, Sara},
+        title = "{IVOA Execution Planner - design outline}",
+ howpublished = {IVOA Note},
+         year = 2021,
+        month = oct,
+        pages = {1123},
+}

texmf/bibtex/bib/lofar.bib

@@ -10,3 +10,109 @@
     version = "1.2",
     url = {https://edu.nl/xfa7k},
 }
+
+@Article{2022A&A...659A...1S,
+       author = {{Shimwell}, T.~W. and {Hardcastle}, M.~J. and {Tasse}, C. and {Best}, P.~N. and {R{\"o}ttgering}, H.~J.~A. and {Williams}, W.~L. and {Botteon}, A. and {Drabent}, A. and {Mechev}, A. and {Shulevski}, A. and {van Weeren}, R.~J. and {Bester}, L. and {Br{\"u}ggen}, M. and {Brunetti}, G. and {Callingham}, J.~R. and {Chy{\.z}y}, K.~T. and {Conway}, J.~E. and {Dijkema}, T.~J. and {Duncan}, K. and {de Gasperin}, F. and {Hale}, C.~L. and {Haverkorn}, M. and {Hugo}, B. and {Jackson}, N. and {Mevius}, M. and {Miley}, G.~K. and {Morabito}, L.~K. and {Morganti}, R. and {Offringa}, A. and {Oonk}, J.~B.~R. and {Rafferty}, D. and {Sabater}, J. and {Smith}, D.~J.~B. and {Schwarz}, D.~J. and {Smirnov}, O. and {O'Sullivan}, S.~P. and {Vedantham}, H. and {White}, G.~J. and {Albert}, J.~G. and {Alegre}, L. and {Asabere}, B. and {Bacon}, D.~J. and {Bonafede}, A. and {Bonnassieux}, E. and {Brienza}, M. and {Bilicki}, M. and {Bonato}, M. and {Calistro Rivera}, G. and {Cassano}, R. and {Cochrane}, R. and {Croston}, J.~H. and {Cuciti}, V. and {Dallacasa}, D. and {Danezi}, A. and {Dettmar}, R.~J. and {Di Gennaro}, G. and {Edler}, H.~W. and {En{\ss}lin}, T.~A. and {Emig}, K.~L. and {Franzen}, T.~M.~O. and {Garc{\'\i}a-Vergara}, C. and {Grange}, Y.~G. and {G{\"u}rkan}, G. and {Hajduk}, M. and {Heald}, G. and {Heesen}, V. and {Hoang}, D.~N. and {Hoeft}, M. and {Horellou}, C. and {Iacobelli}, M. and {Jamrozy}, M. and {Jeli{\'c}}, V. and {Kondapally}, R. and {Kukreti}, P. and {Kunert-Bajraszewska}, M. and {Magliocchetti}, M. and {Mahatma}, V. and {Ma{\l}ek}, K. and {Mandal}, S. and {Massaro}, F. and {Meyer-Zhao}, Z. and {Mingo}, B. and {Mostert}, R.~I.~J. and {Nair}, D.~G. and {Nakoneczny}, S.~J. and {Nikiel-Wroczy{\'n}ski}, B. and {Orr{\'u}}, E. and {Pajdosz-{\'S}mierciak}, U. and {Pasini}, T. and {Prandoni}, I. and {van Piggelen}, H.~E. and {Rajpurohit}, K. and {Retana-Montenegro}, E. and {Riseley}, C.~J. and {Rowlinson}, A. and {Saxena}, A. and {Schrijvers}, C. and {Sweijen}, F. and {Siewert}, T.~M. and {Timmerman}, R. and {Vaccari}, M. and {Vink}, J. and {West}, J.~L. and {Wo{\l}owska}, A. and {Zhang}, X. and {Zheng}, J.},
+        title = "{The LOFAR Two-metre Sky Survey. V. Second data release}",
+      journal = {Astronomy \& Astrophysics},
+     keywords = {surveys, catalogs, radio continuum: general, techniques: image processing, Astrophysics - Astrophysics of Galaxies, Astrophysics - Cosmology and Nongalactic Astrophysics, Astrophysics - High Energy Astrophysical Phenomena, Astrophysics - Instrumentation and Methods for Astrophysics},
+         year = 2022,
+        month = mar,
+       volume = {659},
+          eid = {A1},
+          doi = {10.1051/0004-6361/202142484},
+archivePrefix = {arXiv},
+       eprint = {2202.11733},
+ primaryClass = {astro-ph.GA},
+}
+
+@TechReport{2019:vanCapellen:LOFAR2MasterPlan,
+    author = "{van~Capellen}, W.A.",
+    title = "{LOFAR 2.0 Master Plan}",
+    institution = "ASTRON",
+    year = 2019,
+    month = 1,
+    day = 10,
+    version = "1.0"
+}
+
+@Misc{2021:LOFAR2WhitePaper,
+    title = "{LOFAR2.0: A premier low-frequency radio telescope for the 2020s}",
+    year = 2021,
+    month = 10,
+    day = 6,
+    version = "Draft"
+}
+
+@Article{2021A&A...648A...1T,
+       author = {{Tasse}, C. and {Shimwell}, T. and {Hardcastle}, M.~J. and {O'Sullivan}, S.~P. and {van Weeren}, R. and {Best}, P.~N. and {Bester}, L. and {Hugo}, B. and {Smirnov}, O. and {Sabater}, J. and {Calistro-Rivera}, G. and {de Gasperin}, F. and {Morabito}, L.~K. and {R{\"o}ttgering}, H. and {Williams}, W.~L. and {Bonato}, M. and {Bondi}, M. and {Botteon}, A. and {Br{\"u}ggen}, M. and {Brunetti}, G. and {Chy{\.z}y}, K.~T. and {Garrett}, M.~A. and {G{\"u}rkan}, G. and {Jarvis}, M.~J. and {Kondapally}, R. and {Mandal}, S. and {Prandoni}, I. and {Repetti}, A. and {Retana-Montenegro}, E. and {Schwarz}, D.~J. and {Shulevski}, A. and {Wiaux}, Y.},
+        title = "{The LOFAR Two-meter Sky Survey: Deep Fields Data Release 1. I. Direction-dependent calibration and imaging}",
+      journal = {Astronomy \& Astrophysics},
+     keywords = {techniques: interferometric, techniques: image processing, surveys, galaxies: active, galaxies: starburst, radio continuum: galaxies, Astrophysics - Instrumentation and Methods for Astrophysics},
+         year = 2021,
+        month = apr,
+       volume = {648},
+          eid = {A1},
+        pages = {A1},
+          doi = {10.1051/0004-6361/202038804},
+archivePrefix = {arXiv},
+       eprint = {2011.08328},
+ primaryClass = {astro-ph.IM},
+}
+
+@Article{2022NatAs...6..350S,
+       author = {{Sweijen}, F. and {van Weeren}, R.~J. and {R{\"o}ttgering}, H.~J.~A. and {Morabito}, L.~K. and {Jackson}, N. and {Offringa}, A.~R. and {van der Tol}, S. and {Veenboer}, B. and {Oonk}, J.~B.~R. and {Best}, P.~N. and {Bondi}, M. and {Shimwell}, T.~W. and {Tasse}, C. and {Thomson}, A.~P.},
+        title = "{Deep sub-arcsecond wide-field imaging of the Lockman Hole field at 144 MHz}",
+      journal = {Nature Astronomy},
+     keywords = {Astrophysics - Instrumentation and Methods for Astrophysics, Astrophysics - Astrophysics of Galaxies},
+         year = 2022,
+        month = jan,
+       volume = {6},
+        pages = {350-356},
+          doi = {10.1038/s41550-021-01573-z},
+archivePrefix = {arXiv},
+       eprint = {2202.01608},
+ primaryClass = {astro-ph.IM},
+}
+
+@ARTICLE{2015A&C....11...25S,
+       author = {{Swinbank}, John D. and {Staley}, Tim D. and {Molenaar}, Gijs J. and {Rol}, Evert and {Rowlinson}, Antonia and {Scheers}, Bart and {Spreeuw}, Hanno and {Bell}, Martin E. and {Broderick}, Jess W. and {Carbone}, Dario and {Garsden}, Hugh and {van der Horst}, Alexander J. and {Law}, Casey J. and {Wise}, Michael and {Breton}, Rene P. and {Cendes}, Yvette and {Corbel}, St{\'e}phane and {Eisl{\"o}ffel}, Jochen and {Falcke}, Heino and {Fender}, Rob and {Grie{\ss}meier}, Jean-Mathias and {Hessels}, Jason W.~T. and {Stappers}, Benjamin W. and {Stewart}, Adam J. and {Wijers}, Ralph A.~M.~J. and {Wijnands}, Rudy and {Zarka}, Philippe},
+        title = "{The LOFAR Transients Pipeline}",
+      journal = {Astronomy and Computing},
+     keywords = {Astronomical transients, Time domain astrophysics, Techniques: image processing, Methods: data analysis, Astronomical databases, Astrophysics - Instrumentation and Methods for Astrophysics},
+         year = 2015,
+        month = jun,
+       volume = {11},
+        pages = {25--48},
+          doi = {10.1016/j.ascom.2015.03.002},
+archivePrefix = {arXiv},
+       eprint = {1503.01526},
+ primaryClass = {astro-ph.IM},
+}
+
+@ARTICLE{2016A&A...585A.128K,
+       author = {{Kondratiev}, V.~I. and {Verbiest}, J.~P.~W. and {Hessels}, J.~W.~T. and {Bilous}, A.~V. and {Stappers}, B.~W. and {Kramer}, M. and {Keane}, E.~F. and {Noutsos}, A. and {Os{\l}owski}, S. and {Breton}, R.~P. and {Hassall}, T.~E. and {Alexov}, A. and {Cooper}, S. and {Falcke}, H. and {Grie{\ss}meier}, J. -M. and {Karastergiou}, A. and {Kuniyoshi}, M. and {Pilia}, M. and {Sobey}, C. and {ter Veen}, S. and {van Leeuwen}, J. and {Weltevrede}, P. and {Bell}, M.~E. and {Broderick}, J.~W. and {Corbel}, S. and {Eisl{\"o}ffel}, J. and {Markoff}, S. and {Rowlinson}, A. and {Swinbank}, J.~D. and {Wijers}, R.~A.~M.~J. and {Wijnands}, R. and {Zarka}, P.},
+        title = "{A LOFAR census of millisecond pulsars}",
+      journal = {Astronomy and Astrophysics},
+     keywords = {telescopes, radio continuum: stars, stars: neutron, pulsars: general, Astrophysics - High Energy Astrophysical Phenomena, Astrophysics - Solar and Stellar Astrophysics},
+         year = 2016,
+        month = jan,
+       volume = {585},
+          eid = {A128},
+        pages = {A128},
+          doi = {10.1051/0004-6361/201527178},
+archivePrefix = {arXiv},
+       eprint = {1508.02948},
+ primaryClass = {astro-ph.HE},
+}
+
+@Misc{2023-LOFAR-ERIC-Data-Policy,
+    author = "Bonati, I. and Vermeulen, R.",
+    title = "Science data policy of {LOFAR} {ERIC}",
+    institution = "LOFAR ERIC",
+    year = 2023,
+    month = 4,
+    day = 25,
+    version = "1.0",
+    url = {https://www.lofar.eu/wp-content/uploads/2023/06/Data-policy_LOFAR-ERIC.pdf}
+}

texmf/bibtex/bib/sdc.bib

@@ -12,19 +12,19 @@
     title = "{SDC} Software Maintenance in an Agile Environment",
     organization = "ASTRON",
     year = 2020,
-    pubstate = "inpreparation",
     eprinttype = "sdc-handle",
-    eprint = "SDC-001"
+    eprint = "SDC-001",
+    version = "1.0"
 }
 
 @Misc{SDC-002,
     author = "John D. {Swinbank}",
-    title = "{ASTRON Science Data Centre} Program Management Plan",
-    institution = "ASTRON",
-    year = 2020,
-    pubstate = "inpreparation",
+    title = "SDC Program Organisation Framework",
+    organization = "ASTRON",
+    year = 2021,
+    version = "1.0",
     eprinttype = "sdc-handle",
-    eprint = "SDC-002"
+    eprint = "SDC-002",
 }
 
 @Misc{SDC-003,
@@ -32,7 +32,7 @@
     title = "{FuSE} Project Management Plan",
     organization = "ASTRON",
     year = 2020,
-    pubstate = "inpreparation",
+    version = "1.0",
     eprinttype = "sdc-handle",
     eprint = "SDC-003"
 }
@@ -42,6 +42,7 @@
     title = "{ASTRON Science Data Centre} Vision",
     organization = "ASTRON",
     year = 2021,
+    version = "0.5",
     pubstate = "inpreparation",
     eprinttype = "sdc-handle",
     eprint = "SDC-006"
@@ -66,3 +67,44 @@
     eprinttype = "sdc-handle",
     eprint = "SDC-008"
 }
+
+@Misc{SDC-009,
+    author = "Roberto {Pizzo} and John D. {Swinbank}",
+    title = "{SDC} Facility Governance",
+    organization = "ASTRON",
+    year = 2021,
+    version = "0.1",
+    pubstate = "inpreparation",
+    eprinttype = "sdc-handle",
+    eprint = "SDC-009"
+}
+
+@Misc{SDC-017,
+    author = "Roberto {Pizzo} and John D. {Swinbank}",
+    title = "{LOFAR2.0 Digital Services} Vision",
+    organization = "ASTRON",
+    year = 2023,
+    version = "2023-02-24",
+    eprinttype = "sdc-handle",
+    eprint = "SDC-017"
+}
+
+@Misc{SDC-022,
+    author = "Roberto {Pizzo} and John D. {Swinbank}",
+    title = "{LOFAR2.0 Digital Services}: Development Proposal to the ILT Board",
+    organization = "ASTRON",
+    year = 2023,
+    version = "2023-03-23",
+    eprinttype = "sdc-handle",
+    eprint = "SDC-022"
+}
+
+@Misc{SDC-029,
+    author = "Busy Week Participants",
+    title = "{LOFAR2.0 Data Processing \& Management Busy Week Report}",
+    organization = "LOFAR ERIC",
+    year = 2024,
+    version = "1.1",
+    eprinttype = "sdc-handle",
+    eprint = "SDC-029"
+}

texmf/bibtex/bib/sdco.bib

@@ -31,3 +31,11 @@
     year = 2020,
     url = {https://support.astron.nl/confluence/display/ROSDC/Federated+AAI}
 }
+
+@Misc{Pizzo:SDCOVision:2022,
+    author = {{Pizzo}, Roberto},
+    title = "{SDCO Vision}",
+    organization = "ASTRON",
+    year = 2020,
+    howpublished = "\url{https://support.astron.nl/confluence/pages/viewpage.action?pageId=73563778}"
+}

texmf/bibtex/bib/ska.bib

+% SDC-series documents
+
+@TechReport{2017-Chryostomou-SRC-background,
+    author = "Chrysostomou, {A.} and the SRCCG",
+    title = "SKA Regional Centres: Background and Framework",
+    organization = "SKAO",
+    year = 2017,
+    number = "SKA-TEL-SKO-0000706"
+}
+
+@TechReport{2021-Breen-SKAO-data-products,
+    author = "Breen, Shari and Bolton, Rosie and Chrysostomou, Antonio",
+    title = "SKAO Science Data Products: A Summary",
+    organization = "SKAO",
+    year = 2021,
+    number = "SKA-TEL-SKO-0001818"
+}
+
+@Misc{2020-SRC-White-Paper,
+    author = "Peter Quinn and Michiel {van Haarlem} and Tao An and Domingos Barbosa and Rosie Bolton and Antonio Chrysostomou and John Conway and Séverin Gaudet and Hans-Rainer Klöckner and Andrea Possenti and Simon Ratcliffe and Anna Scaife and Lourdes Verdes-Montenegro and Jean-Pierre Vilotte and Yogesh Wadadekar",
+    title = "{SKA Regional Centres: A White Paper}",
+    organization = "{SKA Regional Centre Steering Committee}",
+    month = may,
+    year = 2020,
+    version = "1.0",
+    howpublished = {\url{https://confluence.skatelescope.org/display/SRCSC/SRCSC+White+Paper+V1.0}}
+}
+
+@TechReport{2023:SkaPlatformVision,
+  author = {de Boer, J. and Cimpan, I. and Das, A. and Fabbro, S. and Grange, Y.G. and Hardcastle, M.J. and Sharma, R. and Skipper, C.J. and Swinbank, J.D. and Webster, B.},
+  title = "{SRC Science Analysis Platform Vision Document}",
+  organization = "{SKA Regional Centre Network}",
+  year = 2023
+}

texmf/ls-R

@@ -2,6 +2,7 @@
 ./:
 .:
 bibtex
+img
 ls-R
 tex
 
@@ -9,9 +10,16 @@ tex
 bib
 
 ./bibtex/bib:
+apertif.bib
 astron.bib
+escape.bib
+general.bib
+ivoa.bib
 lofar.bib
 sdc.bib
+sdco.bib
+
+./img:
 
 
 ./tex:
@@ -24,3 +32,8 @@ astron
 astron-abbreviations.tex
 astron-logo.pdf
 astron.cls
+common.tex
+escape-galaxy-mind.png
+escape-logo.png
+escape.cls
+flag-eu.png

texmf/tex/latex/astron/astron-abbreviations.tex

 \newacronym{AAAI}{AAAI}{Authentication, Authorization, and Accounting Infrastructure}
-\newacronym{ALTA}{ALTA}{Apertif Long Term Archive}
+\newacronym
+  [%
+    description={\acrshort{Apertif} Long Term Archive}%
+  ]{ALTA}{ALTA}{Apertif Long Term Archive}
+\newacronym{ADEX}{ADEX}{ASTRON Data Explorer}
+\newacronym{ANTARES}{ANTARES}{Astronomy with a Neutrino Telescope and Abyss environmental RESearch}
 \newacronym{AO}{A\&O}{Astronomy and Operations}
 \newacronym{API}{API}{Application Programming Interface}
 \newacronym{ASCL}{ASCL}{Astrophysics Source Code Library}
 \newacronym{Apertif}{Apertif}{APERture Tile In Focus}
+\newacronym{CASA}{CASA}{Common Astronomy Software Applications}
+\newacronym{CEP}{CEP}{CEntral Processing}
+\newacronym
+  [%
+    description={Connecting \acrshort{ESFRI} Projects to \acrshort{EOSC} through \acrshort{VO} framework}%
+  ]{CEVO}{CEVO}{Connecting ESFRI Projects to EOSC through VO framework}
 \newacronym{CPU}{CPU}{Central Processing Unit}
+\newacronym{CSP}{CSP}{Central Signal Processor}
 \newacronym{CWL}{CWL}{Common Workflow Language}
+\newacronym{CTA}{CTA}{Cherenkov Telescope Array}
+\newacronym{CTAO}{CTAO}{Cherenkov Telescope Array Observatory}
+\newacronym
+  [%
+    description={Data Infrastructure Capacity for \acrshort{EOSC}}%
+  ]{DICE}{DICE}{Data Infrastructure Capacity for EOSC}
+\newacronym{DIOS}{DIOS}{Data Infrastructure for Open Science}
+\newacronym{DLaaS}{DLaaS}{Data-Lake-as-a-Service}
 \newacronym{DOI}{DOI}{Digital Object Identifier}
-\newacronym{DUPLLO}{DUPLLO}{Digital Upgrade for Premier LOFAR Low-band Observing}
-\newacronym{EGI-ACE}{EGI-ACE}{EGI Advanced Computing for EOSC}
-\newacronym{EOSC}{EOSC}{European Open Science Cloud}
+\newacronym{DR2}{DR2}{Data Release 2}
+\newacronym
+  [%
+    description={Digital Upgrade for Premier \acrshort{LOFAR} Low-band Observing}%
+  ]{DUPLLO}{DUPLLO}{Digital Upgrade for Premier LOFAR Low-band Observing}
+\newacronym{ECO}{ECO}{Engagement and COmmunication}
+\newacronym{EC}{EC}{European Commission}
+\newacronym
+  [%
+    description={EGI Advanced Computing for \acrshort{EOSC}}%
+  ]{EGI-ACE}{EGI-ACE}{EGI Advanced Computing for EOSC}
+\newacronym{ERIC}{ERIC}{European Research Infrastructure Consortium}
+\newacronym
+  [%
+    prefixfirst={the\space}%
+  ]{EOSC}{EOSC}{European Open Science Cloud}
+\newacronym{EGO}{EGO}{European Gravitational Observatory}
 \newacronym{EPO}{EPO}{Education and Public Outreach}
-\newacronym{ESAP}{ESAP}{European Science Analysis Platform}
-\newacronym{ESCAPE}{ESCAPE}{European Science Cluster of Astronomy \& Particle physics ESFRI research infrastructures}
+\newacronym
+  [%
+    prefixfirst={the\space},%
+    description={\acrshort{ESFRI} Science Analysis Platform}%
+  ]{ESAP}{ESAP}{ESFRI Science Analysis Platform}
+\newacronym
+  [
+    description={European Science Cluster of Astronomy \& Particle physics \acrshort{ESFRI} research infrastructures}
+  ]{ESCAPE}{ESCAPE}{European Science Cluster of Astronomy \& Particle physics ESFRI research infrastructures}
 \newacronym{ESFRI}{ESFRI}{European Strategy Forum on Research Infrastructures}
+\newacronym{ESO}{ESO}{European Southern Observatory}
+\newacronym{EST}{EST}{European Solar Telescope}
+\newacronym
+  [%
+    description={European \acrshort{VLBI} Network}%
+  ]{EVN}{EVN}{European VLBI Network}
 \newacronym{FAIR}{FAIR}{Findable, Accessible, Interoperable, Reusable}
+\newacronym
+  [%
+    description={\acrshort{FAIR} for Research Software}%
+  ]{FAIR4RS}{FAIR4RS}{FAIR for Research Software}
+\newacronym{FAIR-ESFRI}{FAIR}{Facility for Antiproton and Ion Research}
 \newacronym{FPGA}{FPGA}{Field Programmable Gate Array}
 \newacronym{FTE}{FTE}{Full Time Equivalent}
 \newacronym{FTP}{FTP}{File Transfer Protocol}
 \newacronym{FuSE}{FuSE}{Fundamental Sciences E-infrastructure}
+\newacronym{FZJ}{FZJ}{Forschungszentrum Jülich}
+\newacronym{GB}{GB}{Gigabyte}
 \newacronym{GPU}{GPU}{Graphics Processing Unit}
+\newacronym{GUI}{GUI}{Graphical User Interface}
 \newacronym{HBA}{HBA}{High-Band Antenna}
+\newacronym
+  [%
+    description={High-Luminosity \acrshort{LHC}}%
+  ]{HL-LHC}{HL-LHC}{High-Luminosity LHC}
 \newacronym{HPC}{HPC}{High-Performance Computing}
+\newacronym{HTC}{HTC}{High-Throughput Computing}
+\newacronym{HTTP}{HTTP}{Hypertext Transfer Protocol}
+\newacronym{IAA-CSIC}{IAA-CSIC}{Instituto de Astrofísica de Andalucía, Consejo Superior de Investigaciones Científicas}
+\newacronym{IAM}{IAM}{Identity and Access Management}
 \newacronym{ICA}{ICA}{Internal Cooperation Agreement}
-\newacronym{ILT}{ILT}{International \Acrshort{LOFAR} Telescope}
+\newacronym{IDA}{IDA}{Interactive Data Analysis}
+\newacronym
+  [%
+    description={International \acrshort{LOFAR} Telescope}%
+  ]{ILT}{ILT}{International LOFAR Telescope}
+\newacronym{IDC}{IDC}{Instrument Development Committee}
+\newacronym
+  [%
+    description={International \acrshort{LOFAR} Two-metre Sky Survey}%
+  ]{ILoTSS}{ILoTSS}{International LOFAR Two-metre Sky Survey}
 \newacronym{IS}{I\&S}{Innovation and Systems}
 \newacronym{IVOA}{IVOA}{International Virtual Observatory Alliance}
+\newacronym
+  [%
+    description={Joint Institute for \acrshort{VLBI} \acrshort{ERIC}}%
+  ]{JIVE}{JIVE}{Joint Institute for VLBI ERIC}
+\newacronym{JSON}{JSON}{JavaScript Object Notation}
+\newacronym{KIS}{KIS}{Leibniz-Institute for Solar Physics}
 \newacronym{KSP}{KSP}{Key Science Project}
+\newacronym
+  [%
+    description={\acrshort{LOFAR}2.0 Digital Services}%
+  ]{L2DS}{L2DS}{LOFAR2.0 Digital Services}
 \newacronym{LBA}{LBA}{Low-Band Antenna}
-\newacronym{LDV}{LDV}{LOFAR Data Valorisation}
+\newacronym
+  [%
+    description={\Acrshort{LOFAR} Data Valorisation}%
+  ]{LDV}{LDV}{LOFAR Data Valorisation}
+\newacronym{LHC}{LHC}{Large Hadron Collider}
+\newacronym{LINC}{LINC}{LOFAR INitial Calibration}
+\newacronym
+  [%
+    description={\acrshort{LBA} \acrshort{LOFAR} CommUnity Sky Survey}%
+  ]{LLoCuSS}{LLoCuSS}{LBA LOFAR CommUnity Sky Survey}
+\newacronym
+  [
+    description={\acrshort{LOFAR}2.0 Dark Matter eXperiment}
+  ]{LoDMaX}{LoDMaX}{LOFAR2.0 Dark Matter eXperiment}
 \newacronym{LOFAR}{LOFAR}{LOw Frequency ARray}
+\newacronym
+  [
+    description={\acrshort{LOFAR} Two-metre Sky Survey}
+  ]{LoTSS}{LoTSS}{LOFAR Two-metre Sky Survey}
+\newacronym{LSST}{LSST}{Legacy Survey of Space and Time}
 \newacronym{LTA}{LTA}{Long Term Archive}
-\newacronym{LUC}{LUC}{LOFAR Users Committee}
+\newacronym
+  [%
+    description={\acrshort{LOFAR} Users Committee}%
+  ]{LUC}{LUC}{LOFAR Users Committee}
+\newacronym{MIND}{MIND}{Management, Innovation, Networking, and Dissemination}
 \newacronym{MT}{MT}{Management Team}
 \newacronym{NWO}{NWO}{Nederlandse Organisatie voor Wetenschappelijk Onderzoek}
+\newacronym{OIDC}{OIDC}{OpenID Connect}
 \newacronym{ORP}{ORP}{OPTICON--RadioNet Pilot}
+\newacronym{OSSR}{OSSR}{Open-source scientific Software and Service Repository}
+\newacronym{PAF}{PAF}{Project Acquisition Form}
+\newacronym{PI}{PI}{Principal Investigator}
+\newacronym{PID}{PID}{Persistent Identifier}
+\newacronym{PM}{PM}{Person Month}
+\newacronym{PMT}{PMT}{Product Management Team}
+\newacronym{PSNC}{PSNC}{Poznań Supercomputing and Networking Center}
 \newacronym{QA}{QA}{Quality Assessment}
+\newacronym{QoS}{QoS}{Quality of Service}
+\newacronym{RuG}{RuG}{Rijksuniversiteit Groningen}
+\newacronym{RDMA}{RDMA}{Remote Direct Memory Access}
+\newacronym{RFI}{RFI}{radio-frequency interference}
+\newacronym{RUG}{RUG}{Rijksuniversiteit Groningen}
+\newacronym{REST}{REST}{Representational State Transfer}
+\newacronym{SAC}{SAC}{Science Advisory Committee}
+\newacronym{SAFe}{SAFe}{Scaled Agile Framework}
+\newacronym{SAMP}{SAMP}{Simple Application Messaging Protocol}
 \newacronym{SBe}{SBe}{Smart Backend}
-\newacronym{SDCO}{SDCO}{\Acrshort{SDC} Operations}
-\newacronym{SDCP}{SDCP}{\Acrshort{SDC} Program}
+\newacronym
+  [%
+    description={\acrshort{SDC} Operations}%
+  ]{SDCO}{SDCO}{SDC Operations}
+\newacronym
+  [%
+    description={\acrshort{SDC} Program}%
+  ]{SDCP}{SDCP}{SDC Program}
 \newacronym{SDC}{SDC}{Science Data Centre}
 \newacronym{SDF-PPE}{SDF-PPE}{Science Delivery Framework: Production Pipeline Enhancement}
 \newacronym{SDF}{SDF}{Science Delivery Framework}
+\newacronym{SDP}{SDP}{Science Data Processor}
 \newacronym{SD}{SD}{Software Delivery}
-\newacronym{SKAO}{SKAO}{\Acrshort{SKA} Observatory}
-\newacronym{SKARC}{SKARC}{\Acrshort{SKA} Regional Centre}
-\newacronym{SKA}{SKA}{Square Kilometre Array}
-\newacronym{SRCSC}{SRCSC}{\Acrshort{SKA} Regional Centres Steering Committee}
-\newacronym{SRC}{SRC}{\Acrshort{SKA} Regional Centre}
+\newacronym{SKAO}{SKAO}{SKA Observatory}
+\newacronym{SLA}{SLA}{Service Level Agreement}
+\newacronym{SQL}{SQL}{Structured Query Language}
+\newacronym{SRC}{SRC}{SKA Regional Centre}
+\newacronym{SRCNet}{SRCNet}{SKA Regional Centre Network}
+\newacronym{SRCSC}{SRCSC}{SKA Regional Centres Steering Committee}
 \newacronym{SRDP}{SRDP}{Science-Ready Data Product}
 \newacronym{SSH}{SSH}{Secure Shell}
+\newacronym{STFC}{STFC}{Science and Technology Facilities Council}
 \newacronym{TMSS}{TMSS}{Telescope Manager Specification System}
 \newacronym{TO}{TO}{Telescope Operations}
 \newacronym{TPU}{TPU}{Tensor Processing Unit}
+\newacronym{UWS}{UWS}{Universal Worker Service}
 \newacronym{VM}{VM}{Virtual Machine}
 \newacronym{VO}{VO}{Virtual Observatory}
+\newacronym{VLBI}{VLBI}{Very Long Baseline Interferometry}
+\newacronym
+  [%
+    description={Worldwide \acrshort{LHC} Computing Grid}%
+  ]{WLCG}{WLCG}{Worldwide LHC Computing Grid}
+\newacronym{WP}{WP}{Work Package}
+\newacronym{WSRT}{WSRT}{Westerbork Synthesis Radio Telescope}

texmf/tex/latex/astron/astron.cls

@@ -5,20 +5,39 @@
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesClass{astron}[ASTRON document class]
 
+\newlength{\topMargin}
+\newlength{\bottomMargin}
+\newlength{\sideMargin}
+\newlength{\headHeight}
+\newlength{\footSkip}
+\newlength{\headSep}
+\setlength{\topMargin}{3.5cm}
+\setlength{\bottomMargin}{3.5cm}
+\setlength{\sideMargin}{2cm}
+\setlength{\headHeight}{52.05211pt}
+\setlength{\footSkip}{56.9055pt}
+\setlength{\headSep}{25.0pt}
+
+\newcommand{\changeRecordName}{Document History}
+
 % Handle various document types, adding appropriate warning messages.
 % Document type is specified as a class option; if none is specified, we use "undefined".
 \newif\if@hastype
 \@hastypefalse
 \newcommand{\docType}{Undefined}
 
+\DeclareOption{draftwm}{
+  \AtEndOfClass{\RequirePackage[firstpageonly]{draftwatermark}}
+}
+
 \DeclareOption{note}{
   \newcommand{\docTypeDescription}{
     \fbox{%
       \begin{minipage}{\dimexpr\linewidth-2\fboxrule-2\fboxsep}
         \begin{center}
           \begin{small}
-          This technical note expresses the opinions of the authors on the date of writing.\\
-          It is not binding on the SDC Program, and may not accurately reflect future developments.
+            This technical note expresses the opinions of the authors on the date of writing.\\
+            It is not binding on the SDC Program, and may not accurately reflect future developments.
           \end{small}
         \end{center}
       \end{minipage}%
@@ -35,8 +54,8 @@
       \begin{minipage}{\dimexpr\linewidth-2\fboxrule-2\fboxsep}
         \begin{center}
           \begin{small}
-          This document proposes a change to the technical baseline of the SDC Program.\\
-          It is not binding on the Program until approved by a change control process.
+            This document proposes a change to the technical baseline of the SDC Program.\\
+            It is not binding on the Program until approved by a change control process.
           \end{small}
         \end{center}
       \end{minipage}%
@@ -53,9 +72,9 @@
       \begin{minipage}{\dimexpr\linewidth-2\fboxrule-2\fboxsep}
         \begin{center}
           \begin{small}
-          This document is part of the technical baseline of the SDC Program.\\
-          It is binding on the activities of the Program.\\
-          It may only be modified through a formal change control process.
+            This document is part of the technical baseline of the SDC Program.\\
+            It is binding on the activities of the Program.\\
+            It may only be modified through a formal change control process.
           \end{small}
         \end{center}
       \end{minipage}%
@@ -65,100 +84,51 @@
   \renewcommand{\docType}{Baseline}
   \@hastypetrue
 }
-\ProcessOptions\relax
 
-\LoadClass[a4paper,12pt,twoside]{article}
+% Default logo
+\newcommand{\logo}{\includegraphics[width=8cm]{astron-logo}}
 
-\newlength{\topMargin}
-\newlength{\bottomMargin}
-\newlength{\sideMargin}
-\setlength{\topMargin}{3.5cm}
-\setlength{\bottomMargin}{3.5cm}
-\setlength{\sideMargin}{2cm}
-
-\RequirePackage[absolute]{textpos}
-\RequirePackage{biblatex}
-\RequirePackage{fancyhdr}
-\RequirePackage{geometry}
-\RequirePackage[pdfborder={0 0 0}]{hyperref}
-\RequirePackage[nonumberlist,nogroupskip]{glossaries}
-\RequirePackage{graphicx}
-\RequirePackage{lastpage}
-\RequirePackage{libertinus}
-\RequirePackage{microtype}
-\RequirePackage{parskip}
-\RequirePackage{tabularx}
-
-% Link to document repositories for appropriate e-prints in the bibliography
-\DeclareFieldFormat{eprint:sdc-handle}{%
-  Doc handle\addcolon\space
-    \href{https://git.astron.nl/swinbank/doc-#1}{#1}%
+% 75th anniversary logo
+\DeclareOption{75}{
+  \renewcommand{\logo}{\includegraphics[width=4.85cm]{astron75-logo}}
 }
 
-% Standard bibliography files included in this package
-\addbibresource{astron.bib}
-\addbibresource{general.bib}
-\addbibresource{ivoa.bib}
-\addbibresource{lofar.bib}
-\addbibresource{sdc.bib}
-\addbibresource{sdco.bib}
-
-% No need for a fancy font for the URL
-\urlstyle{same}
-
-\geometry{tmargin=\topMargin,
-          bmargin=\bottomMargin,
-          lmargin=\sideMargin,
-          rmargin=\sideMargin,
-          headheight=52.05211pt}
-
-\newcommand{\docTitle}{Set the document title with \texttt{\textbackslash{}setDocTitle}}
-\newcommand{\setDocTitle}[1]{
-   \renewcommand{\docTitle}{#1}
+% LOFAR documents (for now, this just means using the LOFAR logo).
+\DeclareOption{lofar}{
+  \renewcommand{\logo}{\includegraphics[width=6cm]{lofar-logo}}
 }
 
-\newcommand{\docNumber}{Set the document number with \texttt{\textbackslash{}setDocNumber}}
-\newcommand{\setDocNumber}[1]{
-   \renewcommand{\docNumber}{#1}
+\DeclareOption{lofar-eric}{
+  \renewcommand{\logo}{\includegraphics[width=2.15cm]{lofar-eric-logo}}
 }
 
-\newcommand{\docRevision}{Set the document revision with \texttt{\textbackslash{}setDocRevision}}
-\newcommand{\setDocRevision}[1]{
-   \renewcommand{\docRevision}{#1}
+% No logo
+\DeclareOption{nologo}{
+  \renewcommand{\logo}{}
 }
 
-\newcommand{\docDate}{Set the document date with \texttt{\textbackslash{}setDocDate}}
-\newcommand{\setDocDate}[1]{
-   \renewcommand{\docDate}{#1}
+% Short documents don't have a title page; just stick the title next to the logo on the first page.
+\newif\if@shortDoc
+\@shortDocfalse
+\DeclareOption{short}{
+  \@shortDoctrue
 }
 
-\newcommand{\docProgram}{Set the document program with \texttt{\textbackslash{}setDocProgram}}
-\newcommand{\setDocProgram}[1]{
-   \renewcommand{\docProgram}{#1}
-}
+\ProcessOptions\relax
 
 %
-% Document history
+% Standard Definitions
 %
-\providecommand{\addChangeRecord}[3]{ #1 & #2 & #3 \tabularnewline \hline}
-\newcommand{\docChangeRecord}{
-... & ... & ... \tabularnewline \hline
+\input{common}
+
+\newcommand{\docRevision}{Set the document revision with \texttt{\textbackslash{}setDocRevision}}
+\newcommand{\setDocRevision}[1]{
+  \renewcommand{\docRevision}{#1}
 }
-\newcommand{\setDocChangeRecord}[1]{\renewcommand{\docChangeRecord}
-{
-#1
-}}
-
-\newcommand{\changeRecord}{%
-  \clearpage
-  \section*{Document History}
-  \begin{tabularx}{\textwidth}{|X|p{0.13\textwidth}|p{0.68\textwidth}|X|}
-    \hline
-    \textbf{Revision} & \textbf{Date} & \textbf{Description} \tabularnewline
-    \hline\hline
-    \docChangeRecord
-  \end{tabularx}
-  \clearpage
+
+\newcommand{\docProgram}{Set the document program with \texttt{\textbackslash{}setDocProgram}}
+\newcommand{\setDocProgram}[1]{
+  \renewcommand{\docProgram}{#1}
 }
 
 %
@@ -167,56 +137,56 @@
 \providecommand{\addPerson}[3]{ #1 & #2 & #3 \tabularnewline}
 
 \newcommand{\docAuthors}{
-... & ... & ... \tabularnewline
+  ... & ... & ... \tabularnewline
 }
 \newcommand{\setDocAuthors}[1]{\renewcommand{\docAuthors}
-{
-#1
-}}
+  {
+    #1
+  }}
 
 \newcommand{\docCheckers}{
-... & ... & ... \tabularnewline
+  ... & ... & ... \tabularnewline
 }
 \newcommand{\setDocCheckers}[1]{\renewcommand{\docCheckers}
-{
-#1
-}}
+  {
+    #1
+  }}
 
 \newcommand{\docApprovers}{
-... & ... & ... \tabularnewline
+  ... & ... & ... \tabularnewline
 }
 \newcommand{\setDocApprovers}[1]{\renewcommand{\docApprovers}
-{
-#1
-}}
+  {
+    #1
+  }}
 
 \newcommand{\docAuthorizers}{
-... & ... & ... \tabularnewline
+  ... & ... & ... \tabularnewline
 }
 \newcommand{\setDocAuthorizers}[1]{\renewcommand{\docAuthorizers}
-{
-#1
-}}
+  {
+    #1
+  }}
 
 \newcommand{\authorTable}{%
   \begin{tabularx}{\textwidth}{|p{0.35\textwidth}|p{0.35\textwidth}|X|}
     \cline{2-3} \cline{3-3}
-    \multicolumn{1}{c|}{} &
-    \textbf{\footnotesize{}Organisatie / Organization} &
+    \multicolumn{1}{c|}{}                                         &
+    \textbf{\footnotesize{}Organisatie / Organization}            &
     \textbf{\footnotesize{}Datum / Date} \tabularnewline
     \hline
-    \textbf{\footnotesize{}Auteur(s) / Author(s):\vspace{0.2cm}} & & \tabularnewline
+    \textbf{\footnotesize{}Auteur(s) / Author(s):\vspace{0.2cm}}  &   & \tabularnewline
     \docAuthors
     \hline
-    \textbf{\footnotesize{}Controle / Checked:\vspace{0.2cm}} & & \tabularnewline
+    \textbf{\footnotesize{}Controle / Checked:\vspace{0.2cm}}     &   & \tabularnewline
     \docCheckers
     \hline
-    \textbf{\footnotesize{}Goedkeuring / Approval:\vspace{0.2cm}} & & \tabularnewline
+    \textbf{\footnotesize{}Goedkeuring / Approval:\vspace{0.2cm}} &   & \tabularnewline
     \docApprovers
     \hline
-    \textbf{\footnotesize{}Autorisatie / Authorization:} & & \tabularnewline
+    \textbf{\footnotesize{}Autorisatie / Authorization:}          &   & \tabularnewline
     \docAuthorizers
-    \textbf{\footnotesize{}Handtekening / Signature:\vspace{1cm}} & & \tabularnewline
+    \textbf{\footnotesize{}Handtekening / Signature:\vspace{1cm}} &   & \tabularnewline
     \hline
   \end{tabularx}
 }
@@ -228,15 +198,16 @@
 \fancyhf{}
 \lfoot{\thepage \hspace{1pt} / \pageref{LastPage}}
 \rfoot{
-\begin{tabular}{>{\raggedright}ll}
- Doc. Nr.: & \docNumber{}\tabularnewline
- Rev.: & \docRevision{}\tabularnewline
- Date: & \docDate{}\tabularnewline
- Doc. Type: & \docType{}\tabularnewline
-\end{tabular}
+  \renewcommand{\arraystretch}{1}
+  \begin{tabular}{>{\raggedright}ll}
+    Doc. Nr.:  & \docNumber{}\tabularnewline
+    Rev.:      & \docRevision{}\tabularnewline
+    Date:      & \docDate{}\tabularnewline
+    Doc. Type: & \docType{}\tabularnewline
+  \end{tabular}
 }
 
-\rhead{\includegraphics[width=8cm]{astron-logo}}
+\rhead{\logo}
 \cfoot{\textbf{\large{}\docProgram{}}}
 \renewcommand{\headrulewidth}{0pt}
 \renewcommand{\footrulewidth}{1pt}
@@ -245,62 +216,77 @@
 %
 % Construct the title page, history, etc.
 %
-\renewcommand{\maketitle}{
-\vspace*{4cm}
-\begin{center}
-\begin{minipage}{0.7\textwidth}
-\centering\LARGE\textbf{\docTitle{}}
-\end{minipage}
-\end{center}
-
-% This position was determined by trial and error; a bit unsatisfying.
-\newlength{\copyrightBoxPosition}
-\setlength{\copyrightBoxPosition}{25.2cm}
-
-% Add the copyright notice towards the bottom of the page.
-\begin{textblock*}{1\textwidth}(\sideMargin, \copyrightBoxPosition)
-  \fbox{%
-    \begin{minipage}{\dimexpr\linewidth-2\fboxrule-2\fboxsep}
-      \begin{center}
-        \begin{small}
-          \ifthenelse{\equal{\vcsFirstYear}{\vcsLastYear}}
-            {\textcopyright{} ASTRON \vcsFirstYear.\\}
-            {\textcopyright{} ASTRON \vcsFirstYear--\vcsLastYear.\\}
-          All rights are reserved. Reproduction in whole or in part is\\
-          prohibited without written consent of the copyright owner.
-        \end{small}
-      \end{center}
-    \end{minipage}%
+
+% How far should the title be position from the top of the page?
+\newlength{\titleDescent}
+\setlength{\titleDescent}{4cm}
+
+\if@shortDoc
+  \renewcommand{\maketitle}{
+    \begin{textblock*}{0.45\textwidth}(\sideMargin, 0.80cm)
+      \fbox{
+        \begin{minipage}[c][1.3cm]{\textwidth}
+          \centering
+          \Huge\textbf{\docTitle{}}
+        \end{minipage}
+      }
+    \end{textblock*}
   }
-\end{textblock*}
-
-% We generate the author table once (but don't print it) to measure its height,
-% then use that to position the textblock* which ultimately contains the table.
-% Note the measured height is (approximately) half the full height.
-\newlength{\authorTableHalfHeight}
-\settoheight{\authorTableHalfHeight}{\authorTable}
-
-\if@hastype
-  \newlength{\docTypeHalfHeight}
-  \settoheight{\docTypeHalfHeight}{\docTypeDescription}
-  \begin{textblock*}{1\textwidth}(\sideMargin,
-                                  \dimexpr\copyrightBoxPosition-2\docTypeHalfHeight+\fboxsep)
-  \docTypeDescription
-  \end{textblock*}
-
-  \begin{textblock*}{1\textwidth}(\sideMargin,
-                                  \dimexpr\copyrightBoxPosition-2\docTypeHalfHeight-2\authorTableHalfHeight+2\fboxsep)
-  \authorTable
-  \end{textblock*}
 \else
-  \begin{textblock*}{1\textwidth}(\sideMargin,
-                                  \dimexpr\copyrightBoxPosition-2\authorTableHalfHeight+\fboxsep)
-  \authorTable
-  \end{textblock*}
+  \renewcommand{\maketitle}{
+    \vspace*{\titleDescent}
+    \begin{center}
+      \begin{minipage}{0.7\textwidth}
+        \centering\LARGE\textbf{\docTitle{}}
+      \end{minipage}
+    \end{center}
+
+    % This position was determined by trial and error; a bit unsatisfying.
+    \newlength{\copyrightBoxPosition}
+    \setlength{\copyrightBoxPosition}{25.2cm}
+
+    % Add the copyright notice towards the bottom of the page.
+    \begin{textblock*}{1\textwidth}(\sideMargin, \copyrightBoxPosition)
+      \fbox{%
+        \begin{minipage}{\dimexpr\linewidth-2\fboxrule-2\fboxsep}
+          \begin{center}
+            \begin{small}
+              \ifthenelse{\equal{\vcsFirstYear}{\vcsLastYear}}
+              {\textcopyright{} ASTRON \vcsFirstYear.\\}
+              {\textcopyright{} ASTRON \vcsFirstYear--\vcsLastYear.\\}
+              All rights are reserved. Reproduction in whole or in part is\\
+              prohibited without written consent of the copyright owner.
+            \end{small}
+          \end{center}
+        \end{minipage}%
+      }
+    \end{textblock*}
+
+    % We generate the author table once (but don't print it) to measure its height,
+    % then use that to position the textblock* which ultimately contains the table.
+    % Note the measured height is (approximately) half the full height.
+    \newlength{\authorTableHalfHeight}
+    \settoheight{\authorTableHalfHeight}{\authorTable}
+
+    \if@hastype
+      \newlength{\docTypeHalfHeight}
+      \settoheight{\docTypeHalfHeight}{\docTypeDescription}
+      \begin{textblock*}{1\textwidth}(\sideMargin,
+        \dimexpr\copyrightBoxPosition-2\docTypeHalfHeight+\fboxsep)
+        \docTypeDescription
+      \end{textblock*}
+
+      \begin{textblock*}{1\textwidth}(\sideMargin,
+        \dimexpr\copyrightBoxPosition-2\docTypeHalfHeight-2\authorTableHalfHeight+2\fboxsep)
+        \authorTable
+      \end{textblock*}
+    \else
+      \begin{textblock*}{1\textwidth}(\sideMargin,
+        \dimexpr\copyrightBoxPosition-2\authorTableHalfHeight+\fboxsep)
+        \authorTable
+      \end{textblock*}
+    \fi
+    \clearpage
+    \changeRecord
+  }
 \fi
-
-
-\clearpage
-
-\changeRecord
-}