Package: corsika-panama
,-.----.                           ,--.das     nd               ____ ulticore utils for corsik  7
\    /  \     ,---,              ,--.'|   ,---,               ,'  , `.                    ,---,
|   :    \   '  .' \         ,--,:  : |  '  .' \           ,-+-,.' _ |                   '  .' \
|   |  .\ : /  ;    '.    ,`--.'`|  ' : /  ;    '.      ,-+-. ;   , ||                  /  ;    '.
.   :  |: |:  :       \   |   :  :  | |:  :       \    ,--.'|'   |  ;|                 :  :       \
|   |   \ ::  |   /\   \  :   |   \ | ::  |   /\   \  |   |  ,', |  ':                 :  |   /\   \
|   : .   /|  :  ' ;.   : |   : '  '; ||  :  ' ;.   : |   | /  | |  ||                 |  :  ' ;.   :
;   | |`-' |  |  ;/  \   \'   ' ;.    ;|  |  ;/  \   \'   | :  | :  |,                 |  |  ;/  \   \
|   | ;    '  :  | \  \ ,'|   | | \   |'  :  | \  \ ,';   . |  ; |--'                  '  :  | \  \ ,'
:   ' |    |  |  '  '--'  '   : |  ; .'|  |  '  '--'  |   : |  | ,                     |  |  '  '--'
:   : :    |  :  :        |   | '`--'  |  :  :        |   : '  |/                      |  :  :
|   | :    |  | ,'        '   : |      |  | ,'        ;   | |`-'                       |  | ,'
`---'.|    `--''          ;   |.'      `--''          |   ;/                           `--''
  `---`                   '---'                       '---'PANAMA - A python toolkit forCORSIKA7.FeaturesThis python package provides multiple features -- each feature can be used independently, but they also work great together.Execute CORSIKA7 on multiple coresRead CORSIKA7 DAT files ("particle files") topandas DataFramesCorrectly parse output from theEHISToptionCalculate weights for a multiple primary spectraTo see some examples on how to use panama, see the introduction in the documentation.
To get an overview of how the features play together, have a look at the example notebook in the documentation.
In-depth explanation is provided in the API documentation.Installationpipinstallcorsika-panamaIf you want to convert Corsikas DAT files to HDF5 files, you need to install the optionalhdfdependencypip install corsika-panama[hdf]CORSIKA7For usage and installation of CORSIKA7, please refer toits websiteand itsuserguide.
To properly use this package, knowledge of CORSIKA7 is required.If you want to install CORSIKA7, you need to request access to their CORSIKA7 mailing list,as described on their website, then you will receive the CORSIKA7
password.
If you want to skip the process of getting familiar with the software and compiling it with coconut, panama provides a (linux) script for compiling
it.
You will need afortrancompiler. CORSIKA7 will then be pre-configured with the curved earth, EHIST, SIBYLL2.3d and URQDM options.
For finer control over the used options, please compile CORSIKA7 yourself.
After cloning this repository, you can then executeCORSIKA_VERSION=77500CORSIKA_PW=CORSIKA_PASSWORD_YOU_WILL_RECEIVE_BY_MAILadmin/download_corsika.shwhich will download and compile CORSIKA7 version 77500.
If you are interested in automatically testing software using CORSIKA7, using GitHub actions,
have a look at the.githubfolder of this project in combination with the admin script.ContributingContributions and suggestions are very welcome.
Feel free to open anissueorpull request.
This project usespdmfor the build system as well as a
dependency and virtual environment manager.
For suggestions on how to set up a development environment, have a look atCONTRIBUTING.md.Further NotesThis project tries to stay compatible with the suggestions fromScikit hep.Naming idea goes back to@Jean1995, thanks for that!
He originally proposed "PArallel ruN of corsikA on MAny cores", as
the scope of this library grew bigger, it evolved into the current name.This started as part of the code I wrote formy master thesis.
I ended in the same place where most CORSIKA7 users end when running large CORSIKA7 simulations and wrote small scripts
to split one simulation request into multiple CORSIKA7 processes with different seeds.
The FACT software (fact-project/corsika_wrapper)
and the IceCube software does essentially the same thing (and I am sure, MAGIC, CTA and other air-shower based observatories do the same).
I hope this package provides a more experiment-independent and better documented version of internal software packages.Related RepositoriesReading DAT files usescta-observatory/pycorsikaio.Cosmic Ray models implemented inThe-Ludwig/FluxComp.