Technicalities about the Access to CORSIKA

Dear New CORSIKA User !

CORSIKA is available to every scientist free of charge. Please don't distribute the program to other interested persons, but rather send us their E-mail addresses, so their addresses can be added to the CORSIKA mailing list and they automatically will be informed on the most recent version of our program and from time to time on error corrections and updates.

Please cite the CORSIKA program including version number, if you publish results based on CORSIKA calculations. The actual reference to CORSIKA is the report FZKA 6019 (1998). Also inform tanguy.pierog(at)kit.edu or dieter.heck(at)kit.edu if you detect any error or inconsistency. If you agree with these regulations, please acknowledge it by E-mail.

An anonymous ftp server is installed at the Karlsruhe research center, which contains all the files belonging to CORSIKA. To get access to this anonymous ftp, your computer's host name has to be registered in our system. The access right is restricted to this host. From other hosts you will not have access. In some cases, the host address might be identical with your E-mail address, but frequently the normal E-mail address does not contain the computer's name (for the Karlsruhe situation the E-mail address is dieter.heck(at)kit.edu, while the computer's name is ftp-ik.fzk.de). Requests for access should be sent to tanguy.pierog(at)kit.edu or dieter.heck(at)kit.edu.

Therefore please send the host name of the computer, by which you intend to fetch the CORSIKA files!

The actual CORSIKA (version 6.900) set is distributed as gzipped .tar file consisting of several files:

• a file README giving short instructions how to proceed,

• an executable shell script "corsika-install" to be used to install CORSIKA,

• a file AUTHORS giving the names of authors,

• a file COPYING giving copyright instructions,

• a file ChangeLog giving CORSIKA history,

• a file INSTALL giving instructions how to "corsika-install" to install CORSIKA,

• a file NEWS giving latest news about CORSIKA,

• a file cDO_NOT_RUN_CONFIGURE to remind NOT to use ./configure but ./corsika-install (without arguments) instead,

• files Makefile.am, Makefile.in, aclocal.m4, configure.in, configure, and subdirectory config/ needed for installation. These files and directories should not be changed unless you know exactly what you are doing. All subdirectories have a Makefile.am and a Makefile.in needed by ./configure to create proper Makefiles.

• a subdirectory bernlohr/ containing the bernlohr package for Imaging Atmospheric Cherenkov Telescopes and extended atmospheres (bernlohr-1.41.tar.gz is automatically extracted if needed).

• a subdirectory doc/ containing:
  • a postscript file CORSIKA_PHYSICS.ps containing the physics description of CORSIKA (Report FZKA 6019). (The file CORSIKA_PHYSICS.pdf contains it in Acrobat format.),

  • a postscript file CORSIKA_GUIDE69xx.ps giving a description, how to install and run CORSIKA (The file CORSIKA_GUIDE69xx.pdf contains it in Acrobat format.),

  • a file references.tex which gives the actual references to CORSIKA and the hadronic interaction models in LaTeX format (to be used in your publications),

• a subdirectory dpmjet/ containing source files of the DPMJET2.55 model (dpmjet253c.f,dpmjet254.f, dpmjet255c.f, dpmjet256c.f),

• a subdirectory epos/ containing the source package for the EPOS model (epos1.99.tar.gz is automatically extracted if needed.),

• a subdirectory herwig/ where to install HERWIG and containing a README file inside,

• a subdirectory include/ containing the config.h.in files needed by configure to do config.h. The file config.h contains all the preprocessor commands needed by CORSIKA.

• a subdirectory lib/ is created when compiling CORSIKA. It contains all Makefiles, object files and libraries.

• a subdirectory nexus/ containing the source package for the NEXUS model (nexus3.97_cors.tar.gz is automatically extracted if needed.),

• a subdirectory pythia/ where to install PYTHIA and containing a file README.corsika inside,

• a subdirectory run/ to be used to run CORSIKA containing:
  • 13 data sets containing the energy dependent cross sections for nucleon-nucleus processes (NUCNUCCS), for electromagnetic inter- actions (6 sets EGSDAT5_x.x), for QGSJET01 (QGSDAT01 and SECTNU), for QGSJET-II (sectnu-II-03) (Because of its size the qgsdat-II-03 has to be downloaded separatly from the server and copied here only for LINUX using g77 (binary format); for other system or compiler (like gfortran), just let your computer recalculate this file (but it takes a while (>24h))), numerical data to be used by the VENUS routines (VENUSDAT) and for the DPMJET routines the Glauber tables (GLAUBTAR.DAT) and the nuclear data (NUCLEAR.BIN). [The NUCLEAR.BIN file may be used only with those computers (DEC-UNIX, LINUX) applying the IEEE standard for direct access read and write. For other computers (DEC-VAX, HP) a different NUCLEAR.BIN file is necessary which is available from CERN or from the author of DPMJET .],

  • 3 data sets atmabs.dat, mirreff.dat, and quanteff.dat to take into account the atmospheric absorption, mirror reflectivity, and quantum efficiency of Cherenkov radiation,

  • 2 input examples (all_inputs and nexus_inputs) to steer the simulation with any model or with NEXUS,

  • the binary files of CORSIKA after compilation.

• a subdirectory src/ containing:
  • the major part of the source code (corsika.F and corsika.h) which is a Fortran code file with some C preprocessor commands, that contains the code of CORSIKA including the EGS4 and HDPM model routines. It contains also the interfaces to FLUKA, GHEISHA, UrQMD, DPMJET, EPOS, neXus, QGSJET, SIBYLL, and VENUS, but without those hadronic interaction codes,

  • 5 separate files with the pure Fortran code of the GHEISHA, QGSJET01C, QGSJET-II, SIBYLL2.1, and VENUS routines, respectively (gheisha_2002d.f, qgsjet01c.f, qgsjet-II-03.f, sibyll2.1.f, and venus.f),

  • 2 separate files with the pure C code of the PRESHOWER and STACEE, respectively (preshw.c and stacee.c),

  • 2 routines to read the binary CORSIKA particle output files (corsikaread.f and corsikaread_thin.f are compiled the first time CORSIKA is compiled and installed in run/),

  • 2 special routines in C needed for compilation (timerc.c and trapfpe.c),

  • a routine (plottracks3c.f) and its include file (work.inc) to visualize shower plots established with the option PLOTSH,

  • a routine map2png.c to visualize shower plots established with option PLOTSH2.

• a subdirectory urqmd/ containing the source package of the URQMD model (urqmd1.3_cors.tar.gz is automatically extracted if needed.).

ftp ftp-ik.fzk.de
~~~~~~~~~~~~~~~~~
Trying 141.52.67.78 

Connected to ftp-ik.fzk.de. 

220 ftp-ik FTP server (Version [number & date]) ready. 

Name (ftp-ik.fzk.de:username): anonymous [or ftp]
                               ~~~~~~~~~     ~~~
331 Guest login ok, send your complete e-mail address as password.

Password: your_mail_address
          ~~~~~~~~~~~~~~~~~
230-                       Welcome to ftp-ik.fzk.de, the

230-                ******  I N F O and S O F T  Server  ******

230-           Forschungszentrum Karlsruhe, Institut fuer Kernphysik

230-                     KASCADE Collaboration Karlsruhe

230-

230- current directory: /      local time: [date & time]

230- You are user number # out of a possible total of 10 in our domain class

230- All transfers to and from ftp-ik.fzk.de are logged. If you don't like this

230- then disconnect now!

230-

230 Guest login ok, access restrictions apply.

Remote system type is UNIX.

Using binary mode to transfer files.

ftp > cd pub/corsika/v690
     ~~~~~~~~~~~~~~~~~~~~
250 CWD command successful.

ftp > mget *
      ~~~~~~
mget corsika-6900.tar.gz? y
                          ~
.
.
.

ftp > quit
      ~~~~
221-You have transferred # bytes in # files.

221-Total traffic for this session was # bytes in # transfers.

221-Thank you for using the FTP service on ftp-ik.fzk.de.

221 Goodbye.

If you are not successfull to fetch files from the subdirectory ~ftp/pub/corsika/v690 (because of `permission denied' or 'No such file or directory'), then please try to copy the README file located in ~ftp/pub. This file has no limited access and should be readable by you. If you have copied this README file successfully please send an e-mail to tanguy.pierog(at)kit.edu. or dieter.heck(at)kit.edu The automatic registration of each access to this file from outside gives us a hint what to change to enable your access to the CORSIKA files.

CORSIKA Home Page