docs: a technical introduction to the platform, as a LaTeX article
docs/blog/rarelens.tex builds a 10-page write-up covering the Nextflow DSL2 pipeline, the three execution backends behind one API call, the Argo and ArgoCD track, Terraform, the external systems integrated, the ranking, the benchmark and the model. It is deliberately as much an account of what was wrong as of what works: the components that scored evidence nobody had looked up, the missense AUROC that fell from 0.872 to 0.500 once allele frequency was removed, the ontology walk that silently dropped 399 terms, and the propagation change that measured slightly worse than what it replaced and was kept anyway with the numbers published. Figures come from one headless-browser script. Screenshots are of the running application; the six diagrams are hand-written HTML styled from the same palette, rendered by the same script. Keeping both in one place is what stops the article drifting from the system, and every number in a diagram has to be changed deliberately.
This commit is contained in:
@@ -0,0 +1,26 @@
|
||||
# Build the technical introduction. Needs a LaTeX toolchain; the Docker route needs none installed.
|
||||
#
|
||||
# make # build rarelens.pdf
|
||||
# make figures # re-capture screenshots and re-render the diagrams (needs the app running)
|
||||
# make clean
|
||||
|
||||
TEX ?= docker run --rm --platform linux/amd64 -v "$(PWD):/w" -w /w ghcr.io/xu-cheng/texlive-full pdflatex
|
||||
BASE ?= http://localhost:5173
|
||||
CHROME ?= /Applications/Google Chrome.app/Contents/MacOS/Google Chrome
|
||||
|
||||
rarelens.pdf: rarelens.tex $(wildcard figures/*.png)
|
||||
$(TEX) -interaction=nonstopmode rarelens.tex >/dev/null
|
||||
$(TEX) -interaction=nonstopmode rarelens.tex | grep -E 'Output written|^!' || true
|
||||
|
||||
# Screenshots come from the running app, diagrams from the HTML in diagram-sources/, both through
|
||||
# one headless browser so the figures and the interface cannot drift apart.
|
||||
figures:
|
||||
cd diagram-sources && npm install --silent playwright && \
|
||||
BASE="$(BASE)" CHROME_PATH="$(CHROME)" \
|
||||
DIAGRAMS=arch,events,pipeline,evidence,benchmark,model node shoot.mjs
|
||||
cp diagram-sources/out/*.png figures/
|
||||
|
||||
clean:
|
||||
rm -f rarelens.aux rarelens.log rarelens.out rarelens.toc preview-*.png
|
||||
|
||||
.PHONY: figures clean
|
||||
Reference in New Issue
Block a user