The EICUG Software Working Group is working on physics and detector simulations that enable for the Yellow Report Initiative a quantitative assessment of the measurement capabilities of the EIC detector(s) and their physics impact. The common simulation tools and workflow environment being setup by the working group allow the EICUG to pursue Yellow Report studies in a manner that is accessible, consistent, and reproducible to the EICUG as a whole.

Communication

The EICUG Software Working Group will start to announce software updates, known bugs, and other software related news on the eicug-software@eicug.org mailing list. While summaries of the announcements will be shared on eicug-software@eicug.org and the monthly newsletter, we encourage all working groups to subscribe to the eicug-software@eicug.org.

JupyterHub

We are preparing JupyterHub resources at BNL and JLAB that will allow you to run the EIC Software in the cloud and to easily share your analyses with other users. A prototype is being tested at JLAB.

Support us to support you better

The common simulation tools and workflow environment can only grow with user input. The EICUG Software Working Group asks interested users to join our support team to ensure fast response to user requests. This is an ideal opportunity to learn more about the software and its development.

Tutorials

The tutorials for fast and detector full simulations are available on the EICUG YouTube channel

Uproot and Awkward Array Tutorial

• Jim Pivarski (Princeton), known for innovative software in DIANA/HEP, IRIS-HEP and other projects, will give tutorials on how to process and analyze Root files with pure Python libraries: uproot and awkward array The tutorials are aimed for anyone who would like to learn more about using data science tools in Python for Nuclear Physics analysis.
• Wednesday, April 8, at 10:00 a.m. (EDT)
• Remote access will be provided via BlueJeans: https://bluejeans.com/920347364
• The tutorial will be recorded.
• More details are available on: https://indico.bnl.gov/event/8242/

Advanced Fast Simulations Tutorial

• Dmitry Romanov (JLAB) and Kolja Kauder (BNL) will give an advanced tutorial on fast simulations based on the feedback and requests of the last months.
• Thursday, April 9, at 10:00 a.m. (EDT)
• Remote access will be provided via BlueJeans: https://bluejeans.com/920347364
• The tutorial will be recorded.
• More details are available on: https://indico.bnl.gov/event/8243/

Software Update

In our first Software News, updates on eic_smear and ESCalate are included. Further updates on these and other packages will be in future newsletters.

eic_smear

Legacy version (1.0.3-final) The version used for the EIC White Paper (with a minor fix and some new tests) was fixed to 1.0.3-final for preservation.

Yellow Report versions (1.0.4+) The current version, tentatively named 1.0.4-RC, has a few impactful updates:

1. The code was made compliant to C++17, the latest stable C++ standard.
2. A bug was found and fixed that translated negative smeared values into NaN. This affects only a small phase space, mostly for very small phi values, but it is nevertheless recommended to update at your earliest opportunity and check for differences in your studies.
3. Calculations for x and y according to the Jacquet Blondel method can produce a slew of warnings because values slightly smaller than 0 or larger than 1 are generated through roundoff errors. This is fixed.
4. Testing and Q&A macros have been added in the tests/ directory.

In the works:

• Implementations according to the Electron-Ion Collider Detector Requirements and R&D Handbook: Once out, this should be the default used by everybody until vetted reference detectors are compiled. Note that none of the existing smearers were ever meant as truly representative of their namesakes, mostly as starting points.
• pT and pz smearing is currently not functional. While no existing smearers rely on them, this is nevertheless a bug that will be fixed in the next update. More examples and QA are to follow as well.

ESCalate framework

A lightweight modular fast and full simulation framework for EIC. https://gitlab.com/eic/escalate

Previously separate packages, G4E and eJana, are now distributed as the ESCalate framework. ESCalate brings together Monte Carlo event generators, eic-smear for fast simulations, G4E for full detector simulations, as well as JANA2 and eJana for reconstruction.

The structure of the ESCalate framework is shown below. Part of ESCalate are ejpm for distributing the software and a variety of smaller tools. In addition to tutorials, examples for Geant4 detectors, eJANA plugins for reconstruction and physics analyses, and analyses in JupyterLab are provided.

ESCalate provides modularity in two ways:

1. Subpackage modularity: Each package inside the framework can be used solely and separately from the rest of the framework.
2. Subprocess modularity: JANA2 (and eJana) modularize code in small libraries called plugins allowing to run tasks in a seamless multithreaded way.

The framework itself ensures that data between packages is consistent and output of one package can be correctly read from another. ESCalate provides Python orchestration to facilitate the configuration of each package and allow for a workflow between the packages.

---

About the Software Working Group

Please see our website for more information about the Software Working Group and engage in the discussion on our mailing list. For software questions, please see our tutorials, contact us via software-support@eicug.org, or join our Slack channel (see QR code below).

---