This web service is designed to calculate acceptance corrections for any BSM scenario using HEPMC, PROMC, LHE files. It converts truth-level data (from ProMC, HEPMC or LHE files) into identifiable objects such as isolated jets, b-jets, electrons, and muons, which are then processed by publicly available TensorFlow models.
For ATLAS/CMS : ATLAS and CMS can also use HEPMC and LHE files. ATLAS can use PHYS_LIGHT and DAOD inputs. These formats have not been implemented yet.
AdFilter supports a number of formats with event records. The best supported is a simple ROOT ntuple which contains 4-momenta of jets, bjets, leptons, photons. The example code that creates an ntuple of this style is given here: dummy.py
wget https://raw.githubusercontent.com/chekanov/ADFilter/main/dummy.py python dummy.py
This creates the file "dummy.root" with 5 objects (1 electron, 1 muon and 1 light jet, 1 photon, 1 b-jet). Use it to upload to the ADFilter. Note that you should also supply a CMS energy and the output files using the arguments of this script. The final output of the loss should log(Loss) = -9.822 (see the histogram "Loss" in the created file "dummy_root_ADFilter.root")
ProMC input files from the HepSim repository. Note such files have only truth-level information with particles, thus the program attempts to create jets, b-jets, isolated leptons and photons. The settings to perform jet reconstruction, b-tagging and isolation are described in the log file of the outputs.
Some files to upload for testing from HepSim database:
One can also use Delphes ROOT files after fast simulations. Unlike ProMC files, Delphes files contain reconstructed jets, b-jets, electrons, muons and photons. You can download Delphes files from the HepSim repository (reconstructed tag rfastXXX, where XXX are some numbers). Here is the direct link Delphes ROOT files.
Since Delphes ROOT files can be rather large, the ADFilter only supports "slimmed" Delphes files for upload. To slim the Delphes ROOT files, you need to have ROOT installation and slimming code from GIT. Then run this command:
git clone https://github.com/wasikatcern/skim_ADFilter.git cd skim_ADFilter root -l -q -b 'skim_Delphes.C("original_delphes.root", "skimmed_delphes.root", 13000)'
The number 13000 is the centre-of-mass collision energy (in GeV). We expect that Delphes have the following information (which is default in Delphes):
The output file "skimmed_delphes.root" can be uploaded to the ADfilter. Please use the input file name as unique as possible (not "skimmed_delphes.root" as in this example).
You can also use LHE files (without parton showers). You need to compress such files using gzip, such that the file extension will be ".lhe.gz". This file will be processed by Pythia8 (for parton showering and hadronization). Then the PROMC file will be produced. Finally, this file will be propagated via the jet reconstruction, exactly as for the original PROMC files.
To upload DAOD_PHYS or DAOD_PHYSLIGHT files (ATLAS data format), you need to slim files to create Ntuples acceptable for ADFilter. Here is the code that does this: DAOD2Ntuple.py.
wget https://raw.githubusercontent.com/chekanov/ADFilter/main/DAOD2Ntuple.py lsetup "asetup Athena,main,latest" python ./DAOD2Ntuple.py --inputlist DAOD_PHYS.37222100._000003.pool.root.1 --outputlist output.root --cmsEnergy 13000 --crossSectionPB 100(here 100 is just a dummy cross section in pb).
/eos/atlas/atlascerngroupdisk/phys-exotics/jdm/lepdijet/adfilter/ADFILTER input_file N /tmp/where "input_file" is the input ROOT (Delphes slimmed), *.lhe.gz or *.promc, "N" is the integer values representing trigger (0 - 7) (check as ADFILTER -h). The last argument is the output directory.
The input is converted 4-momenta into the RMM densities. In the case of different trigger channels, the autoencoder uses "parameterized" approach, i.e. it has additional array indicating which trigger is used.
S.V. Chekanov, W. Islam, R. Zhang, N. Luongo, "ADFilter -- A Web Tool for New Physics Searches With Autoencoder-Based Anomaly Detection Using Deep Unsupervised Neural Networks", (September 2024) ANL-HEP-190964, arXiv:2409.03065
If you are an ATLAS Collaboration member, you can use this internal note that describes more features of this tool (multiple trigger streams):
Chekanov, Sergei; Islam, Wasikul; Zhang, Rui; Mohiuddin, Saad; Luongo, Nicholas; Weik, Edison James; Allen, Derrick Ray; "ADFilter - a web tool for anomaly detection using autoencoders based on deep unsupervised neural networks", ATL-COM-PHYS-2024-469, August 2024, CERN, ATL-COM-PHYS-2024-469