### DISCLAIMER ###

This code is provided by the Pierre Auger Collaboration as it is without any warranty, for questions please contact Jonathan Biteau [biteau(at)in2p3.fr]. If this material from Pierre Auger Collaboration was helpful for your research work, we kindly request the following references to be cited in any published material: 2018ApJ...853L..29A, 2019ICRC...36..206C.


### SOURCE MODELS FOR AUGER ARRIVAL DIRECTION  ANALYSIS - NOTES ###
(Last edit: J. Biteau - 2019-09-10 - v. ICRC 2019)

-- PRE-INSTALL ROOT --

Preferred version: ROOT 5.34/36 

Don't forget to define your ROOTSYS environment variable to the root directory. And also don't forget to add the $ROOTSYS/lib directory in your LD_LIBRARY_PATH environment variable (in your .bashrc file for instance) by adding in it : export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$ROOTSYS/lib)


-- Scripts: --

- 1_load_weights.cc: generates the attenuated flux weights above each threshold

-> run "python 1_script_weights.py" to generate all weights above all thresholds for all composition models - done in about 1h


-- FOLDERS: --

- Catalog: contains files listing the populations investigated. Each file contains:
  name_of_the_source | l[°] | b[°] | flux_weight | distance

  One file per source list (see https://arxiv.org/abs/1801.06160):
  - gamma-ray AGN: "agn_sample.dat" -> updated based on the 3FHL
  - starburst galaxies: "sb_sample.dat" -> updated merging the catalogs in 1801.06160 (see corresponding ICRC2019 contribution)
  - Swift-BAT sample: "swift_sample.dat" -> no update (70-month catalog)
  - 2MRS sample without Local Group galaxies: "2mrs_out_checked _woLG.dat" -> no update

- CompoModel: the models are stored in "anaCRP3.root", generated by M. Unger. The macro attFac.C shows how the file is read. The folder contains one sub-folder per source list (must be manually created). The script 1_load_weights.cc reads each of the of the source list in Catalog/ and generates new source lists stored in CompoModel/xxxx/ above thresholds from 32 to 80 EeV by steps of 1 EeV. Each generated file contains:
  name_of_the_source | l[°] | b[°] | attenuated_flux_weight

  Above each threshold, four files are generated  (see https://arxiv.org/abs/1801.06160):
  - exploiting the mix inferred at the absolute minimum of the deviance for an EPOS-LHC hadronic interaction model ("EPO1st" -> Composition model A in 1801.06160)
  - exploiting the mix inferred at the second minimum of the deviance for an EPOS-LHC hadronic interaction model ("EPO2nd" -> Composition model B in 1801.06160)
  - exploiting the mix inferred at the absolute minimum of the deviance for a Sybill hadronic interaction model ("Syb1st" -> Composition model C in 1801.06160)


### REFERENCES ###

@INPROCEEDINGS{2019ICRC...36..206C,
       author = {{Caccianiga}, L.},
        title = "{Anisotropies of the Highest Energy Cosmic-ray Events Recorded by the Pierre Auger Observatory in 15 years of Operation}",
    booktitle = {36th International Cosmic Ray Conference (ICRC2019)},
         year = "2019",
       series = {International Cosmic Ray Conference},
       volume = {36},
        month = "Jul",
          eid = {206},
        pages = {206},
       adsurl = {https://ui.adsabs.harvard.edu/abs/2019ICRC...36..206C},
      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}

@ARTICLE{2018ApJ...853L..29A,
       author = {{Aab}, A. and {Abreu}, P. and {Aglietta}, M. and
         {Albuquerque}, I.~F.~M. and {Allekotte}, I. and {Almela}, A. and
         {Alvarez Castillo}, J. and {Alvarez-Mu{\~n}iz}, J. and
         {Anastasi}, G.~A. and {Anchordoqui}, L. and {Andrada}, B. and
         {Andringa}, S. and {Aramo}, C. and {Arsene}, N. and {Asorey}, H. and
         {Assis}, P. and {Avila}, G. and {Badescu}, A.~M. and {Balaceanu}, A. and
         {Barbato}, F. and {Barreira Luz}, R.~J. and {Beatty}, J.~J. and
         {Becker}, K.~H. and {Bellido}, J.~A. and {Berat}, C. and
         {Bertaina}, M.~E. and {Bertou}, X. and {Biermann}, P.~L. and
         {Biteau}, J. and {Blaess}, S.~G. and {Blanco}, A. and {Blazek}, J. and
         {Bleve}, C. and {Boh{\'a}{\v{c}}ov{\'a}}, M. and {Bonifazi}, C. and
         {Borodai}, N. and {Botti}, A.~M. and {Brack}, J. and {Brancus}, I. and
         {Bretz}, T. and {Bridgeman}, A. and {Briechle}, F.~L. and
         {Buchholz}, P. and {Bueno}, A. and {Buitink}, S. and {Buscemi}, M. and
         {Caballero-Mora}, K.~S. and {Caccianiga}, L. and {Cancio}, A. and
         {Canfora}, F. and {Caruso}, R. and {Castellina}, A. and {Catalani}, F. and
         {Cataldi}, G. and {Cazon}, L. and {Chavez}, A.~G. and
         {Chinellato}, J.~A. and {Chudoba}, J. and {Clay}, R.~W. and
         {Cobos Cerutti}, A.~C. and {Colalillo}, R. and {Coleman}, A. and
         {Collica}, L. and {Coluccia}, M.~R. and {Concei{\c{c}}{\~a}o}, R. and
         {Consolati}, G. and {Contreras}, F. and {Cooper}, M.~J. and
         {Coutu}, S. and {Covault}, C.~E. and {Cronin}, J. and {D'Amico}, S. and
         {Daniel}, B. and {Dasso}, S. and {Daumiller}, K. and {Dawson}, B.~R. and
         {de Almeida}, R.~M. and {de Jong}, S.~J. and {De Mauro}, G. and
         {de Mello Neto}, J.~R.~T. and {De Mitri}, I. and {de Oliveira}, J. and
         {de Souza}, V. and {Debatin}, J. and {Deligny}, O. and
         {D{\'\i}az Castro}, M.~L. and {Diogo}, F. and {Dobrigkeit}, C. and
         {D'Olivo}, J.~C. and {Dorosti}, Q. and {dos Anjos}, R.~C. and
         {Dova}, M.~T. and {Dundovic}, A. and {Ebr}, J. and {Engel}, R. and
         {Erdmann}, M. and {Erfani}, M. and {Escobar}, C.~O. and
         {Espadanal}, J. and {Etchegoyen}, A. and {Falcke}, H. and {Farmer}, J. and
         {Farrar}, G. and {Fauth}, A.~C. and {Fazzini}, N. and {Fenu}, F. and
         {Fick}, B. and {Figueira}, J.~M. and {Filip{\v{c}}i{\v{c}}}, A. and
         {Freire}, M.~M. and {Fujii}, T. and {Fuster}, A. and {Ga{\"\i}or}, R. and
         {Garc{\'\i}a}, B. and {Gat{\'e}}, F. and {Gemmeke}, H. and
         {Gherghel-Lascu}, A. and {Ghia}, P.~L. and {Giaccari}, U. and
         {Giammarchi}, M. and {Giller}, M. and {G{\l}as}, D. and {Glaser}, C. and
         {Golup}, G. and {G{\'o}mez Berisso}, M. and {G{\'o}mez Vitale}, P.~F. and
         {Gonz{\'a}lez}, N. and {Gorgi}, A. and {Grillo}, A.~F. and
         {Grubb}, T.~D. and {Guarino}, F. and {Guedes}, G.~P. and
         {Halliday}, R. and {Hampel}, M.~R. and {Hansen}, P. and {Harari}, D. and
         {Harrison}, T.~A. and {Haungs}, A. and {Hebbeker}, T. and {Heck}, D. and
         {Heimann}, P. and {Herve}, A.~E. and {Hill}, G.~C. and {Hojvat}, C. and
         {Holt}, E. and {Homola}, P. and {H{\"o}randel}, J.~R. and
         {Horvath}, P. and {Hrabovsk{\'y}}, M. and {Huege}, T. and
         {Hulsman}, J. and {Insolia}, A. and {Isar}, P.~G. and {Jandt}, I. and
         {Johnsen}, J.~A. and {Josebachuili}, M. and {Jurysek}, J. and
         {K{\"a}{\"a}p{\"a}}, A. and {Kambeitz}, O. and {Kampert}, K.~H. and
         {Keilhauer}, B. and {Kemmerich}, N. and {Kemp}, E. and {Kemp}, J. and
         {Kieckhafer}, R.~M. and {Klages}, H.~O. and {Kleifges}, M. and
         {Kleinfeller}, J. and {Krause}, R. and {Krohm}, N. and {Kuempel}, D. and
         {Kukec Mezek}, G. and {Kunka}, N. and {Kuotb Awad}, A. and
         {Lago}, B.~L. and {LaHurd}, D. and {Lang}, R.~G. and {Lauscher}, M. and
         {Legumina}, R. and {Leigui de Oliveira}, M.~A. and
         {Letessier-Selvon}, A. and {Lhenry-Yvon}, I. and {Link}, K. and
         {Lo Presti}, D. and {Lopes}, L. and {L{\'o}pez}, R. and
         {L{\'o}pez Casado}, A. and {Lorek}, R. and {Luce}, Q. and {Lucero}, A. and
         {Malacari}, M. and {Mallamaci}, M. and {Mandat}, D. and {Mantsch}, P. and
         {Mariazzi}, A.~G. and {Mari{\textcommabelow s}}, I.~C. and
         {Marsella}, G. and {Martello}, D. and {Martinez}, H. and
         {Mart{\'\i}nez Bravo}, O. and {Mas{\'\i}as Meza}, J.~J. and
         {Mathes}, H.~J. and {Mathys}, S. and {Matthews}, J. and {Matthiae}, G. and
         {Mayotte}, E. and {Mazur}, P.~O. and {Medina}, C. and
         {Medina-Tanco}, G. and {Melo}, D. and {Menshikov}, A. and
         {Merenda}, K. -D. and {Michal}, S. and {Micheletti}, M.~I. and
         {Middendorf}, L. and {Miramonti}, L. and {Mitrica}, B. and
         {Mockler}, D. and {Mollerach}, S. and {Montanet}, F. and {Morello}, C. and
         {Morlino}, G. and {Mostaf{\'a}}, M. and {M{\"u}ller}, A.~L. and
         {M{\"u}ller}, G. and {Muller}, M.~A. and {M{\"u}ller}, S. and
         {Mussa}, R. and {Naranjo}, I. and {Nellen}, L. and {Nguyen}, P.~H. and
         {Niculescu-Oglinzanu}, M. and {Niechciol}, M. and {Niemietz}, L. and
         {Niggemann}, T. and {Nitz}, D. and {Nosek}, D. and {Novotny}, V. and
         {No{\v{z}}ka}, L. and {N{\'u}{\~n}ez}, L.~A. and {Oikonomou}, F. and
         {Olinto}, A. and {Palatka}, M. and {Pallotta}, J. and {Papenbreer}, P. and
         {Parente}, G. and {Parra}, A. and {Paul}, T. and {Pech}, M. and
         {Pedreira}, F. and {P{\c{e}}kala}, J. and {Pelayo}, R. and
         {Pe{\~n}a-Rodriguez}, J. and {Pereira}, L.~A.~S. and {Perlin}, M. and
         {Perrone}, L. and {Peters}, C. and {Petrera}, S. and {Phuntsok}, J. and
         {Pierog}, T. and {Pimenta}, M. and {Pirronello}, V. and {Platino}, M. and
         {Plum}, M. and {Poh}, J. and {Porowski}, C. and {Prado}, R.~R. and
         {Privitera}, P. and {Prouza}, M. and {Quel}, E.~J. and
         {Querchfeld}, S. and {Quinn}, S. and {Ramos-Pollan}, R. and
         {Rautenberg}, J. and {Ravignani}, D. and {Ridky}, J. and {Riehn}, F. and
         {Risse}, M. and {Ristori}, P. and {Rizi}, V. and
         {Rodrigues de Carvalho}, W. and {Rodriguez Fernandez}, G. and
         {Rodriguez Rojo}, J. and {Roncoroni}, M.~J. and {Roth}, M. and
         {Roulet}, E. and {Rovero}, A.~C. and {Ruehl}, P. and {Saffi}, S.~J. and
         {Saftoiu}, A. and {Salamida}, F. and {Salazar}, H. and {Saleh}, A. and
         {Salina}, G. and {S{\'a}nchez}, F. and {Sanchez-Lucas}, P. and
         {Santos}, E.~M. and {Santos}, E. and {Sarazin}, F. and {Sarmento}, R. and
         {Sarmiento-Cano}, C. and {Sato}, R. and {Schauer}, M. and
         {Scherini}, V. and {Schieler}, H. and {Schimp}, M. and {Schmidt}, D. and
         {Scholten}, O. and {Schov{\'a}nek}, P. and {Schr{\"o}der}, F.~G. and
         {Schr{\"o}der}, S. and {Schulz}, A. and {Schumacher}, J. and
         {Sciutto}, S.~J. and {Segreto}, A. and {Shadkam}, A. and
         {Shellard}, R.~C. and {Sigl}, G. and {Silli}, G. and
         {{\v{S}}m{\'\i}da}, R. and {Snow}, G.~R. and {Sommers}, P. and
         {Sonntag}, S. and {Soriano}, J.~F. and {Squartini}, R. and
         {Stanca}, D. and {Stani{\v{c}}}, S. and {Stasielak}, J. and
         {Stassi}, P. and {Stolpovskiy}, M. and {Strafella}, F. and
         {Streich}, A. and {Suarez}, F. and {Suarez Dur{\'a}n}, M. and
         {Sudholz}, T. and {Suomij{\"a}rvi}, T. and {Supanitsky}, A.~D. and
         {{\v{S}}up{\'\i}k}, J. and {Swain}, J. and {Szadkowski}, Z. and
         {Taboada}, A. and {Taborda}, O.~A. and {Theodoro}, V.~M. and
         {Timmermans}, C. and {Todero Peixoto}, C.~J. and {Tomankova}, L. and
         {Tom{\'e}}, B. and {Torralba Elipe}, G. and {Travnicek}, P. and
         {Trini}, M. and {Ulrich}, R. and {Unger}, M. and {Urban}, M. and
         {Vald{\'e}s Galicia}, J.~F. and {Vali{\~n}o}, I. and {Valore}, L. and
         {van Aar}, G. and {van Bodegom}, P. and {van den Berg}, A.~M. and
         {van Vliet}, A. and {Varela}, E. and {Vargas C{\'a}rdenas}, B. and
         {V{\'a}zquez}, R.~A. and {Veberi{\v{c}}}, D. and {Ventura}, C. and
         {Vergara Quispe}, I.~D. and {Verzi}, V. and {Vicha}, J. and
         {Villase{\~n}or}, L. and {Vorobiov}, S. and {Wahlberg}, H. and
         {Wainberg}, O. and {Walz}, D. and {Watson}, A.~A. and {Weber}, M. and
         {Weindl}, A. and {Wiede{\'n}ski}, M. and {Wiencke}, L. and
         {Wilczy{\'n}ski}, H. and {Wirtz}, M. and {Wittkowski}, D. and
         {Wundheiler}, B. and {Yang}, L. and {Yushkov}, A. and {Zas}, E. and
         {Zavrtanik}, D. and {Zavrtanik}, M. and {Zepeda}, A. and
         {Zimmermann}, B. and {Ziolkowski}, M. and {Zong}, Z. and
         {Zuccarello}, F. and {Pierre Auger Collaboration}},
        title = "{An Indication of Anisotropy in Arrival Directions of Ultra-high-energy Cosmic Rays through Comparison to the Flux Pattern of Extragalactic Gamma-Ray Sources}",
      journal = {\apjl},
     keywords = {astroparticle physics, cosmic rays, galaxies: active, galaxies: starburst, methods: data analysis, Astrophysics - High Energy Astrophysical Phenomena, Astrophysics - Cosmology and Nongalactic Astrophysics},
         year = "2018",
        month = "Feb",
       volume = {853},
       number = {2},
          eid = {L29},
        pages = {L29},
          doi = {10.3847/2041-8213/aaa66d},
archivePrefix = {arXiv},
       eprint = {1801.06160},
 primaryClass = {astro-ph.HE},
       adsurl = {https://ui.adsabs.harvard.edu/abs/2018ApJ...853L..29A},
      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}

