.. _building_cgcam:


Building  cgcam
===========================

To build the code do the following:
 1. Move into the ``cgcam/src`` directory.
 2. Type ``configure`` to detect your compiler and to write the 
    compiler.[spec,opt,debug] files.  If the ``configure`` command
    fails, make sure you have
    perl installed and do in fact have a mpi/fortran environment set up.
    Also check to see that you have the current directory listed on your
    search path, if not you will need to execute ``./configure`` instead.  
    If this is the case, you may want to consider adding the current
    directory to your search path by including a line like 
    ``export PATH=$PATH:.`` in your bourne shell variant startup file or 
    ``setenv PATH $PATH:.`` in your c shell variant startup file.
    If you use a compiler other than intel, gcc, pgi, or cray, you will
    need to edit the compiler.[spec,opt,debug] files to suit your compiler.
    Note that the makefile reads the compiler information from the file
    compiler.spec.  The files compiler.opt and compiler.debug are used to
    keep track of optimized and debug compiler flags.  If you need to debug
    the code then do ``make debug``, ``make cgcam``.  Once you are done 
    debugging do ``make opt``, ``make cgcam``.
 3. To build the cgcam code as well as the cart_mesh program, issue

::

    make cgcam
    make cart_mesh