CoCoNuT Code
... in the flesh
Here should appear some CoCoNuTs
 


Starting (prerequisites for CoCoNuT):

Installing CoCoNuT (as many other codes) can be a rather tedious task. Most of the work is spend in finding the external libraries that CoCoNuT needs. So try to be patient and do not skip any of the next steps. The main needs to compile CoCoNuT can be divided in the first three steps to compile CoCoNuT.

STEP 1:

the first set of prerequisites should be easily found in any Linux distribution or UNIX-like system. You will probably have no problems finding precompiled binaries.

  • GNU make tool: All the process of compilation and link is done with this useful tool.
  • FORTRAN 77 compiler: Most of the code, in particular the hydrodynamics part, is written in FORTRAN 77.
  • C++ compiler: The spectral part of the code, that computes the space-time, is written in C++ since it makes use of the LORENE library.
  • SUBVERSION (svn): It is needed to download the code from Internet, and a very useful to develop numerical codes by several contributors at once.

There are some other tools not used directly by CoCoNuT, but which you will need later, e.g. to install LORENE, so you better do it now.

  • CVS: It is similar to SUBVERSION.
  • makedepend: needed only if the C++ compiler does not support the '-M' flag.
  • doxygen and latex: for the LORENE documentation. It is not mandatory, but it is easy to install, and makes your life easy to install and understand LORENE.
  • GSL: to compute Bessel functions in LORENE.
  • SZIP and ZLIB: Compression tools needed by HDF5.
  • X11, libpng and libm: To allow the graphical capabilities of PGPLOT and the mathematical libraries. You need them on LINUX. In other systems you will probably need some time to figure out which are the corresponding libraries...

That was the easy part. It is possible that you need some other packages later depending of your system (e.g. the X11 and C++ headers which come with the "dev" or "devel" packages) but you can proceed to the next step now.

STEP 2:

The next step can take either a couple of minutes or a couple of hours, depending on your system. You need to install now:

  • HDF5: Some distributions include a precompiled version and many system managers install it by default. Otherwise you have to compile it by yourself. You can download it at http://www.hdfgroup.org/HDF5/ .
  • LAPACK: It is also usually easy to find. If not you have to compile it. Download at http://www.netlib.org/lapack/
  • PGPLOT: It is a graphical library used to display figures in LORENE. CoCoNuT does not use any of the functions of PGPLOT, so it is not mandatory to install it. However the initial model generators in LORENE use it and hence it is probably a good idea to install it. Alternatively you can manually deactivate the graphical output in these codes if you do not want to install PGPLOT. You can find the library and instructions to install it at http://www.astro.caltech.edu/~tjp/pgplot/ . This quick installation guide can also help you.

STEP 3:

Next step is compiling and installing LORENE. You can find the detailed instructions to download an install LORENE at http://www.lorene.obspm.fr/ . If you where successful with STEPS 1 and 2, all the LORENE prerequisites should be fulfilled (however is always good to recheck it).

top Comments to: Pablo Cerdá-Durán email cerdaatmpa-garching.mpg.de
Last modified: Tue Jun 24 09:28:18 CEST 2008