Codebraid
Minimalist scientific workbook
2023-07-14 — 2023-07-14
Wherein a scientific workbook is presented, driven by Jupyter kernels and Pandoc, and wherein multiple programming languages with inline execution, isolated sessions, and minimal diffs for version control are permitted.
academe
computers are awful
faster pussycat
how do science
julia
plain text
premature optimization
provenance
python
R
UI
workflow
A scientific workbook based on jupyter kernels and pandoc. Looks much simpler, and therefore potentially less horrible, than Jupyter.
Perhaps a close cousin to quarto.
Comparison with Jupyter, knitr, and Pweave from the project website:
| Codebraid | Jupyter Notebook | knitr | Pweave | |
|---|---|---|---|---|
| multiple programming languages per document | ✔ | ✔* | ✔† | ✔* |
| multiple independent sessions per language | ✔ | |||
| inline code execution within paragraphs | ✔ | ✔ | ✔ | |
| no out-of-order code execution | ✔ | ✔‡ | ✔ | |
| no markdown preprocessor or custom syntax | ✔ | ✔ | ||
| minimal diffs for easy version control | ✔ | ✔ | ✔ | |
| insert code output anywhere in a document | ✔ | ✔ | ||
| can divide code into incomplete snippets | ✔ | ✔ | ✔ | |
| support for literate programming | ✔ | ✔ | ||
| compatible with any text editor | ✔ | ✔ | ✔ |
1 References
Poore. 2019. “Codebraid: Live Code in Pandoc Markdown.” Proceedings of the 18th Python in Science Conference.