A containerised development environment for C and Python scientific computing. Built on Debian Trixie, designed to work identically on macOS, Linux, and Windows via VS Code Dev Containers.
Inspired by FermiBottle, the Docker-based environment used by the Fermi LAT collaboration.
- Docker Desktop
- VS Code with the Dev Containers extension
- Windows only: Git for Windows (includes Git Bash) — open PowerShell and run:
winget install -e --id Git.Git
winget install -e --id Docker.DockerDesktop
winget install -e --id Microsoft.VisualStudioCodegit clone https://github.com/krishnatejavedula/physicsbox.git ~/Apps/physicsbox
cd ~/Apps/physicsbox
chmod +x setup.sh entrypoint.sh
make installOpen in VS Code:
code ~/Apps/physicsboxClick Reopen in Container when prompted.
| Getting Started | Requirements, installation, and Windows-specific setup |
| Daily Use | Starting and stopping the container, opening a terminal, and launching JupyterLab |
| Environment | Lean and full build variants, adding packages, and managing conda environments |
| Gnuplot | File-based plotting, script template, output formats, and X11 forwarding |
| Personalisation | Dotfiles, shell config, and mounting additional project folders |
| Reference | Full make command list, setup.sh flags, and image cleanup |
| Troubleshooting | Common issues, deleted files, and uninstalling |