Build Container
Since MadLAD release v3.0, we have introduced auto container building functionality. You can now build a container image with easy.
1. Quick‑Start
python -m madlad.build -c examples/config_build.yaml
-c / --config– path to your YAML configuration (default:examples/config_build.yaml).- The script will pull the required software, assemble the image and tag it with the name you specify.
2. Container Build Configuration
config_build.yaml is split into three logical blocks:
| Block | Purpose | Example |
|---|---|---|
image |
Image metadata (name, tags) | name: "madlad-custom" |
build |
Software to include and their versions (or local paths) | See below |
extra |
Optional additions: PDFs, models, etc. | See below |
2.1 image
image:
name: "madlad-custom"
Optional: With Docker, you can add a
tag:key if you want multiple tags.
2.2 build
build:
mg5: "2.9.18" # MadGraph version (or local path)
pythia: "8.301"
lhapdf: "6.5.0"
fastjet: "3.4.0"
delphes: "3.5.0"
For MadGraph5 (mg5) you can use:
* Version → the public release to download.
Path* → copy a local installation instead of downloading.
Example:
mg5: "/opt/mg5_aMC_v2.9.18"will copy that folder into the image.
2.3 extra
extra:
pdfs: [260000, 260400, 303400]
models: ["2HDMtII_NLO", "HC_NLO_X0_UFO"]
pdfs– a list of LHAPDF IDs that you want to include.models– names of MadGraph or UFO models that you want to include.