Repository files navigation

The G4VM (GEANT4 Virtual Machine) aims to make GEANT4 instrument simulations of SOHO/Chandra EPHIN and Solar Orbiter HET readily accessible.

It contains the corresponding GDML models along with a compatible GEANT4 application.The models incorporate the sensitive detectors of the instruments and the passive material shielding the detectors, represented with high precision.Each instrument is provided individually and with a spacecraft model that maps the spacecraft's shielding material onto spherical shell segments with varying densities to account for directionality.

The GEANT4 application can be built independently but is provided in a configuration that works seamlessly within the recommended setup.

Our recommended setup requires three resources:

1. AVirtualization Software (VMware Workstation Player 17)
2. AGeant4 Virtual Machine
3. TheGEANT-4 application source code (found here)

Here we describe the steps needed to set up a machine-independent virtual machine (VM).

Virtualization software needs to be installed. For details, follow the description atthe G4VM.
The proposed setup has been tested using VMware Workstation Player 17 obtainedfrom VMware on macOS and Windows 11. However, an installation usingVirtualBox is also supported.

• VM Download: The compressed VM can be downloaded fromG4VM. Ensure at least~10GB of space compressed and~20GB decompressed on your hard disk.
  The release used throughout this manual is Geant4.11.2.1 as of 13/03/2024.

• Preparation: Before starting the VM, you might want to modify settings such as the number of cores for multithreading or enable directory sharing with the host system. Refer to your VM manual for details.

• Installation:

  1. Decompress the VM files.
  2. Start VMware Workstation Player and initialize the VM by clicking the "Open a Virtual Machine" button to select the VM configuration file.
  3. The VM should now be visible in the VMware Player library.

• First Start: After powering on the machine for the first time, select"I copied it" when asked whether you copied or moved the VM. You now have access to a fully operational Linux system with GEANT-4.
  Default user account:

  • Username:local1
  • Password:local1
  • Root Password:rocky9

  Warning: The default keyboard layout is French and might need adjustment in the upper-right panel.

Follow these steps to get the GEANT-4 application running:

1. Open a terminal viaActivities -> Terminal.

   Warning: The default shell is Tcsh.

2. Clone the repository containing the GEANT-4 applications using:

   git clone https://github.com/spearhead-he/G4VM.git

3. Navigate to the build directory of the GEANT-4 application:

   cd G4VM/G4VM_build/

On ARM systems first compile the binarys by running:

make

A successful compilation will output:

[100%] Built target Spearhead_G4VM

You can now proceed as on Intel-Based Host systems.

Run the GEANT-4 application in QT/UI mode using:

./Spearhead_G4VM

And to run the GEANT-4 application with a macro file use:

./Spearhead_G4VM<path_to_macro>

This tool is developed within the SPEARHEAD (SPEcification, Analysis & Re-calibration of High Energy pArticle Data) project. SPEARHEAD has received funding from the European Union’s Horizon Europe programme under grant agreement No 101135044.

The tool reflects only the authors’ view and the European Commission is not responsible for any use that may be made of the information it contains.