Configuration File

The config.yaml file provides the configuration parameters for the Lepton module. It defines various parameters and settings that control the module’s functionality, such as which particles to include, the input and output files, and specific options for the calculations. In the following sections we give an overview of the parameters available in the configuration file.

Global Settings

These parameters define the general settings and options for the module, and are under the global key:

  • run_name: (string, default: “”)

    Sets a name for the module run. This name will be used to create a subdirectory under /output/ where the output files will be stored.

    Important: When using Lepton in a workflow in the MUSES Calculation Engine (CE), do not setup a run_name. The CE uses static paths for the files, and setting a run_name will cause the CE to fail.

  • use_beta_equilibrium: (boolean, default: `false`) Enables the calculation of the beta-equilibrated equation of state. Requires the input of a nuclear equation of state file specified by eos_input_file.

  • use_charge_neutrality: (boolean, default: `false`) Enables the calculation of the charge-neutrality equation of state. Requires the input of a nuclear equation of state file specified by eos_input_file.

  • use_lepton_eos: (boolean, default: `false`) Enables the calculation of a purely leptonic equation of state. The particles included in the calculation must be specified using the options use_electron, use_muon, use_tau, use_electron_neutrino, use_muon_neutrino, and use_tau_neutrino.

  • lepton_fraction: (number, default: `0.0`, range: 0.0 to 1.0) Sets the lepton fraction, used only when neutrinos are included in the calculation.

  • verbose: (integer, default: `0`, range: 0 to 4) Controls the verbosity level of the output:

    • 0: No output

    • 1: Minimal output

    • 2: Standard output

    • 3: Extended output

    • 4: Debug output

  • check_eos_stability: (boolean, default: `false`) Enables a stability check for the nuclear equation of state, checking if pressure and chemical potential are not decreasing functions of baryon density, and if speed of sound is casual. The results are printed in the info.yaml file.

Particle Settings

These parameters specify which leptons and neutrinos are included in the calculations, and are under the particles key:

  • use_electron: (boolean, default: `true`) Includes electrons in the calculations.

  • use_muon: (boolean, default: `false`) Includes muons in the calculations.

  • use_tau: (boolean, default: `false`) Includes taus in the calculations.

  • use_electron_neutrino: (boolean, default: `false`) Includes electron neutrinos in the calculations. The lepton_fraction must be set between 0 and 1.

  • use_muon_neutrino: (boolean, default: `false`) Includes muon neutrinos in the calculations. The lepton_fraction must be set between 0 and 1.

  • use_tau_neutrino: (boolean, default: `false`) Includes tau neutrinos in the calculations. The lepton_fraction must be set between 0 and 1.

Input File Settings

Defines the input files required by the module, and are under the input key. Important: In the CE, it is not necessary to setup the input files, as the CE uses static paths for the files, which are the default paths below.

  • eos_input_file: (string, default: `”nuclear_grid.csv”`) Specifies the nuclear equation of state file in CSV format, located in the input/ directory.

  • particle_properties_input_file: (string, default: `”particle_properties.csv”`) Specifies the file containing particle properties, located in the input/ directory.

  • flavor_equilibration_input_file: (string, default: `”flavor_equilibrium.csv”`) Specifies the file containing nuclear parameters for the flavor equilibration module, located in the input/ directory.

Output File Settings

Controls the output files generated by the module, and are under the output key:

  • output_particle_properties: (boolean, default: `false`) Provides a particle properties data output. Requires an input file specified by particle_properties_input_file.

  • output_flavor_equilibration: (boolean, default: `false`) Provides the flavor equilibration module input. It requires an input file specified by flavor_equilibration_input_file, and it will only be generated if use_charge_neutrality is enabled.

  • output_compOSE: (boolean, default: `false`) Provides an output in compOSE format. Requires the eos_input_file to be specified.

  • output_derivatives: (boolean, default: `false`) Enables the output of derivatives of the beta-equilibrated equation of state.

  • output_hdf5: (boolean, default: `false`) Enables the output of the EoS and the derivatives in HDF5 format, in addition to CSV.

Derivatives Settings

Parameters for controlling numerical derivatives, under the derivatives key:

  • relative_step_size: (number, default: `5.e-3`, range: 0.0 to 1.0) Sets the relative step size for numerical derivatives.

  • precision: (integer, default: `1`, range: 1 to 3) Sets the precision of the derivatives using the central finite difference method:

    • 1: First order

    • 2: Second order

    • 3: Third order

Multidimensional Interpolator Settings

Parameters for using multidimensional interpolation, under the multidimensional_interpolator key:

  • use_multidimensional_interpolator: (boolean, default: `false`) Enables multidimensional interpolation for the nuclear equation of state. It must be enabled if your grid is not irregular in both baryon density and baryon chemical potential.

  • number_of_points: (integer, default: `100`, minimum: 1) Sets the number of points in density for the multidimensional interpolator.

Lepton EoS Parameters

Defines parameters for the lepton equation of state, under the lepton_eos_parameters key:

  • electron_cp_initial: (number, default: `0.0`, unit: MeV) Initial electron chemical potential.

  • electron_cp_final: (number, default: `0.0`, unit: MeV) Final electron chemical potential.

  • electron_cp_step: (number, default: `0.0`, unit: MeV) Step size for electron chemical potential.

  • electron_neutrino_cp_initial: (number, default: `0.0`, unit: MeV) Initial electron neutrino chemical potential.

  • electron_neutrino_cp_final: (number, default: `0.0`, unit: MeV) Final electron neutrino chemical potential.

  • electron_neutrino_cp_step: (number, default: `0.0`, unit: MeV) Step size for electron neutrino chemical potential.

  • delta_cp_muon: (number, default: `0.0`, unit: MeV) Fixed difference between muon and electron chemical potentials.

  • delta_cp_tau: (number, default: `0.0`, unit: MeV) Fixed difference between tau and electron chemical potentials.

  • delta_cp_muon_neutrino: (number, default: `0.0`, unit: MeV) Fixed difference between muon neutrino and electron neutrino chemical potentials.

  • delta_cp_tau_neutrino: (number, default: `0.0`, unit: MeV) Fixed difference between tau neutrino and electron neutrino chemical potentials.

compOSE Options

Defines options for generating the compOSE file, under the compOSE_options key:

  • baryon_density_spacing: (string, default: `linear`) Sets the type of spacing in baryon density. Options: linear, logarithmic.

  • baryon_density_points: (integer, default: `301`) Number of points in the baryon density.

  • charge_fraction_spacing: (string, default: `linear`) Sets the type of spacing in charge fraction. Options: linear, logarithmic.

  • charge_fraction_points: (integer, default: `60`) Number of points in the charge fraction.