ebtelplusplus#

ebtelplusplus (or ebtel++) is an implementation of the enthalpy-based thermal evolution of loops (EBTEL) model implemented in C++ and wrapped in Python.

Examples

Examples of how to set up a simulation

generated/gallery
Topic Guides

Detailed explanations about the EBTEL model

Topic Guides
Contributing

Instructions for how to contribute to ebtelplusplus

Contributing
Reference

Technical description of the inputs, outputs, and behavior of each component of ebteplusplus

API Reference

Note

If you are looking for the original IDL implementation, the repository for that code can be found here.

The EBTEL model, originally developed by Klimchuk et al. [KPC08], efficiently computes spatially-averaged, time-dependent plasma parameters ( e.g. temperature, pressure, density) of dynamically-heated coronal loops. It is often desirable to compute solutions for a large number of coronal loops, but the spatial and temporal scales needed to solve the full 1D-hydrodynamic equations lead to long compute times for even 1D hydrodynamic codes. EBTEL computes quick and accurate solutions for spatially-averaged quantities, allowing efficient insight into how these monolithic structures evolve. EBTEL also calculates the differential emission measure (DEM) for both the transition region and the corona. Details regarding this formulation can be found in Klimchuk et al. [KPC08]. For a more detailed overview of the model, see Deriving the EBTEL Equations.

Installation#

The easiest way to install ebtelplusplus is through pip,

pip install ebtelplusplus

This will install all of the needed Python dependencies as well as a precompiled binary for your particular operating system. Note that it is not necessary to compile the code locally in order to use ebtelplusplus. If you are interested in modifying or contributing to ebtelplusplus, see the Contributing page. Once you’ve successfully installed ebtelplusplus, see the Example Gallery for examples of how to run a simulation.

Citation#

If you use ebtelplusplus in any published work, we ask that you please include citations to the following papers:

If you make use of the variable abundance feature in the radiative losses, please also cite Reep et al. [RUBC24]. Additionally, please add the following line within your methods, conclusion or acknowledgements sections:

This research used version X.Y.Z (software citation) of the ebtelplusplus open source software package.

The software citation should be the specific Zenodo DOI for the version used within your work.