Installation under UNIX

In the following all citations refer to the manual in file manual.ps. There are also hints for fine tunining the installation (Sec. 5.4).

Unpacking the files

After downloading the compressed source code and manual the files have to be treated as follows.
  • Create a directory where the source files etc. should reside. Below this directory is referred to as CANDYS_DIR. Switch to that directory.
  • The anonymous ftp provides two variants: gzipped and zipped files. Moreover, the manual comes in three variants: American letter format (man_let.*). European A4 format (man_a4.*), or European A5 booklet format (man_book.*). In the following, manual.* will denote the variant you like.
  • When using the *.tgz files: The files have to be unpacked and decoded by commands

    gunzip candys.tgz manual.tgz

    tar xvf candys.tar

    tar xvf manual.tar

    The files *.tgz and *.tar are not longer needed.
  • When using the *.zip files: The files have to be unpacked and decoded by commands

    unzip candys.zip

    unzip manual.zip

    The files *.zip are not longer needed.
  • The result is a couple of subdirectories filled with the source code files and the manual. The subdirectories contain the following files.
  • bin: JAVA variant pp.jar of graphical post-processor will contain the graphical online processor if X11 is available
  • doc: the manual manual.ps
  • exa: the example source code file Lorenz.cxx
  • include: the header files *.h
  • lib: empty; will contain the shared objects
  • math: the files Candys.m and correctmath for the use of Mathematica
  • og: the sources *.cc and *.h of the online graphics and the makefile.in
  • src: the source code files *.cxx. and the makefile.in

    • Installation of shared objects (or ordinary libraries)

  • Switch to directory CANDYS_DIR (the main directory of the installation).
  • Create the libraries and the post-processor by commands

    configure

    The result is several makefiles drawn from template files and adapted to your platform.

    make

    The result is the shared objects (or ordinary libraries in case of GYGWIN) in subdirectory lib and (if X11 is available) the server of the online graphics bin/ogserver.
  • After that you may remove intermediate files by command

    make clean

    •

    Preparing an executable program

  • Switch to the directory where your model and the result files should reside.
  • Prepare the source code of your model (c.f. Sections 7.1 through 7.4) and place it into the that directory. Henceforth, the name Model denotes the file name of your module without the extension .cxx.
  • Enter command

    CANDYS_DIR/makecandys Model

    The result is the executable program Model.

    • Upgrading an existing executable program

    Executable programs installed for CANDYS/QA version 4.4.6.4 should be upgraded to be fully compatible with the current version.
  • Switch to the directory where the source code Model.cxx and the result files reside.
  • Enter command

    CANDYS_DIR/remake Model

    The result is a new executable program Model as well as upgraded result files (adapted to new file structure).

    • Running an executable program

  • Switch to the directory where your Model program resides.
  • Enter command

    Model

    •
    Go up