Usage with the MUSES Calculation Engine
Module name
module: lepton_module
Labels
Input
Label |
Description |
Path (inside container) |
|---|---|---|
|
Configuration of the module runtime options |
|
|
Nuclear table input file gridded in temperature and chemical potentials |
|
|
Grid data with particle properties information |
|
|
Grid data with flavor equilibration information |
|
Output
Label |
Description |
Path (inside container) |
|---|---|---|
|
Module execution status |
|
|
Configuration of the module runtime options, echoed back |
|
|
Beta-equilibrium equation of state |
|
|
Charge-neutral equation of state |
|
|
Particle properties for the beta-equilibrium EoS |
|
|
Particle properties for the charge-neutral EoS |
|
|
Charge-neutral EoS with the variables required by the flavor equilibration module |
|
|
Purely leptonic EoS |
|
|
Particle properties for the purely leptonic EoS |
|
Workflow example
The snippet below shows a typical CE workflow that pipes the output of a
eos_module into the lepton_module to compute the beta-equilibrium EoS:
processes:
- name: <<eos_process_name>>
module: <<ce_eos_module>>
config:
{}
- name: lepton_process
module: lepton_module
config:
global:
use_beta_equilibrium: true
particles:
use_electron: true
use_muon: true
pipes:
input_eos:
label: eos_file
module: <<ce_eos_module>>
process: <<eos_process_name>>
components:
- type: chain
name: workflow
sequence:
- <<eos_process_name>>
- lepton_process
The input_eos pipe maps the upstream eos_file output label of <<ce_eos_module>> to
the input_eos input label of this module.
Troubleshooting
- The module exits with a non-zero status code.
Inspect
/opt/output/status.yamlfor the detailed message. Status codes follow an HTTP-style convention:200— success.300/301— invalid or failed physics (e.g. EoS failed the stability or causality check, seecheck_eos_stability/check_eos_causality).400/404/422— invalid, missing, or unparsable input configuration.500/501/503— internal error, unimplemented feature, or permission error.
- Beta-equilibrium fails with “EoS is not stable” or “EoS is not causal”.
Enable them explicitly via
check_eos_stability/check_eos_causalityto catch nuclear models that are unstable or superluminal before they reach downstream modules. Both are disabled by default.- Verbose / debug output.
Increase
global.verbosein the config:0— silent (default)1— standard progress2/3— detailed solver and derivative diagnostics
Validating a config file locally.
python3 scripts/validate_config.py --config_file_path input/
For questions, issues or bug reports, open an issue on the GitLab repository of the module, post on the MUSES Forum, or contact the lead developer:
Mateus Reinke Pelicer (mateusreinke@hotmail.com)