Skip to content

Data access

The scan of the AGATA crystal A005 has been performed at IPHC in 2023 for the vertical scan and in 2024 for the horizontal scan.

The data have been first converted in ADF format and then calibrated and stored in ROOT format. This page explain how to access and use such data.

iRODS access#

Configure iRODS:

You then need to configure iRODS for the AGATA server:

Create the file: ~/.irods/irods_environment.json with the following content: 

{
    "irods_cwd": "/ccin2p3/home/agata/D4B",
    "irods_home": "/ccin2p3/home/agata/D4B",
    "irods_host": "ccirods.in2p3.fr",
    "irods_port": 5570,
    "irods_user_name": "scan",
    "irods_zone_name": "ccin2p3"
}

To install iRODS icommands:

The data are stored on the AGATA iRODS server (working on the 4.x iRODS version).

docker pull gitlab-registry.in2p3.fr/ip2igamma/docker_images:irods-icommands
docker run -it --rm -u $(id -u):$(id -g) \
       -v ${HOME}/.irods:/home/.irods \
       gitlab-registry.in2p3.fr/ip2igamma/docker_images:irods-icommands \
       bash

The output should be similar to:

 ___    __    __  __  __  __    __      ____  ____  ___   ____
/ __)  /__\  (  \/  )(  \/  )  /__\    (_  _)(  _ \(__ \ (_  _)
( (_- /(__)\  )    (  )    (  /(__)\    _)(_  )___/ / _/  _)(_
\___/(__)(__)(_/\/\_)(_/\/\_)(__)(__)  (____)(__)  (____)(____)
irods Version is 4.3.3
  • Using apptainer/singulariry:

First build the apptainer image from the docker container

apptainer build irods-icommands.sif docker://gitlab-registry.in2p3.fr/ip2igamma/docker_images:irods-icommands

Then launch the apptainer image:

apptainer run ${HOME}/singularity/irods-icommands.sif bash

To initialize iRODS:

user:$ iinit 
Enter your current iRODS password:

Please contact O. Stezowski or J. Dudouet for the password

Locate the data:

user:$ icd /ccin2p3/home/agata/scan/IPHC/A005_2023
user:$ ils
/ccin2p3/home/agata/scan/IPHC/A005_2023:
  A005_Replay.tgz
  C- /ccin2p3/home/agata/scan/IPHC/A005_2023/ADF
  C- /ccin2p3/home/agata/scan/IPHC/A005_2023/ExperimentalBases
  C- /ccin2p3/home/agata/scan/IPHC/A005_2023/ROOT

Go in your analysis directory and download the data you want:

user:$ cd /Path/to/my/analysis/directory
user:$ irsync -r i: ./

for details on the icommands, see the dedicated documentation

Data content#

As shown above:

user:$ icd /ccin2p3/home/agata/scan/IPHC/A005_2023
user:$ ils
/ccin2p3/home/agata/scan/IPHC/A005_2023:
  A005_Replay.tgz
  C- /ccin2p3/home/agata/scan/IPHC/A005_2023/ADF
  C- /ccin2p3/home/agata/scan/IPHC/A005_2023/ExperimentalBases
  C- /ccin2p3/home/agata/scan/IPHC/A005_2023/ROOT
  • ADF:

This folder contains the raw scanned data in ADF format (1.3TB). The vertical and horizontal scans are available, as well as a \(^{60}\)Co source run used for x-talk evaluation

user:$ icd /ccin2p3/home/agata/scan/IPHC/A005_2023/ADF/Prod
user:$ ils
  C- /ccin2p3/home/agata/scan/IPHC/A005_2023/ADF/Prod/A005_2023_21_08_M_V_Cs_total-area_2x2mm_C1
  C- /ccin2p3/home/agata/scan/IPHC/A005_2023/ADF/Prod/A005_2024_07_19_H_M_Cs_TotalArea_1858pts_2x2mm_C1
  C- /ccin2p3/home/agata/scan/IPHC/A005_2023/ADF/Prod/A005_Imageur_H_M_60Co_15mn_20cm_test
  • ROOT:

This folder contains the calibrated data of the vertical and horizontal scans (1.8TB), filtered on segment multiplicity 1

user:$ icd /ccin2p3/home/agata/scan/IPHC/A005_2023/ROOT/TTrees_M1
user:$ ils
  C- /ccin2p3/home/agata/scan/IPHC/A005_2023/ROOT/TTrees_M1/A005_2023_21_08_M_V_Cs_total-area_2x2mm_C1
  C- /ccin2p3/home/agata/scan/IPHC/A005_2023/ROOT/TTrees_M1/A005_2024_07_19_H_M_Cs_TotalArea_1858pts_2x2mm_C1
  • ExperimentalBases:

This folder contains Experimental bases (in ADL format) that have been produce using the machine learning method (see M. Abushawish PhD thesis).

user:$ icd /ccin2p3/home/agata/scan/IPHC/A005_2023/ExperimentalBases
user:$ ils
  NN_A005_AGATA.dat
  NN_A005_AGATA_with_ND.dat
  NN_A005_IKP.dat
  NN_A005_IKP_with_ND.dat

IKP refers to the IKP nomenclature for labelling the segment numbers (used for the scan). AGATA refers to the AGATA nomenclature. "with_ND" means that the basis file is containing the parameters for neutron damage correction (imported from the original ADL basis)

  • A005_Replay.tgz:

This file is a tarball of the analysis directory used for data analysis, with all the corresponding calibration files (Look up tables, calibration files...). This is coded for being launched on a SLURM farm, but can be adapted.

Once extracted, some links have to be made to access the data correclty, as in the following example for the horizontal scan:

Example of data calibration of the horizontal A005 scan#

This page gives as example, the different steps of data calibration from ADF to ROOT for the horizontal scan of A005