doc/ctsim-install.tex

   1 \chapter{Installation}\label{installation}\index{Installation}%
   2 \setheader{{\it CHAPTER \thechapter}}{}{}{\ctsimheadtitle}{}{{\it CHAPTER \thechapter}}%
   3 \ctsimfooter%
   4
   5 \section{Download}\label{download}\index{Download}%
   6
   7 The latest version of \ctsim, both as executable programs and source code,
   8  can be downloaded from the official
   9  \ctsim\ \urlref{web site}{http://www.ctsim.org}. Additionally, these
  10  files are also available from the \ctsim\ \urlref{FTP site}{ftp://ftp.ctsim.org}.
  11
  12
  13 \section{Installing Windows Binary}
  14
  15 Download the Windows executable file.
  16 Simply execute this program to begin the
  17 installation program. \ctsim\ will then be accessible from the
  18 \texttt{Start} Menu under the \texttt{Programs} submenu.
  19
  20 \ctsim\ is compatible with Windows 98, Windows Me, Windows NT 4.0,
  21 and Windows 2000. Due to use of the OpenGL and htmlhelp libraries,
  22 \ctsim\ is not compatible with the stock Windows 95 system.
  23
  24 \section{Installing Linux RPM}
  25 Download the \ctsim\ RPM file, then use
  26 the \texttt{rpm} manager program as follows:\\
  27 \hspace*{1cm}\texttt{rpm -Uvh} \emph{ctsim-*.rpm}\\
  28
  29 \ctsim\ and \ctsimtext\ will then be installed in the \texttt{/usr/local/bin}
  30 directory. The online help file, \texttt{ctsim.hhp}, will be installed in
  31 directory \texttt{/usr/local/man}.
  32
  33 \section{Build From Sources}\label{build}\index{Source code build}
  34
  35 Refer to the INSTALL file included in the source distribution for
  36 instructions.
  37
  38 \subsection{Optional Libraries}
  39 These libraries are optional and not required to build \ctsim\ from source code.
  40 However, they add functionality to \ctsim\ and there inclusion is recommended.
  41
  42   \begin{itemize}
  43   \item \textbf{wxWindows}\\
  44   Used for the platform-independent graphical interface. The graphical version
  45   of \ctsim\ requires this library.\\
  46   \urlref{Web site}{http://www.wxwindows.org}
  47
  48   \item \textbf{FFTW}\\
  49     Used for fast Fourier transformations of projections and images.
  50     Without this library \ctsim\ will use slower, traditional Fourier transformations.\\
  51     \urlref{Web site}{http://www.fftw.org}
  52
  53   \item \textbf{libpng}\\
  54         Used for PNG file export.\\
  55     \urlref{Web site}{http://www.libpng.org/pub/png/libpng.html}
  56
  57   \item \textbf{zlib}\\
  58         Used for PNG file export.\\
  59     \urlref{Web site}{http://www.info-zip.org/pub/infozip/zlib/zlib_docs.html}
  60
  61   \item \textbf{readline}\\
  62     Used for \ctsimtext\ interactive shell.\\
  63     \urlref{Web site}{http://www.gnu.org}
  64
  65   \item \textbf{dmalloc}\\
  66     Used for debugging memory allocation.\\
  67     \urlref{Web site}{http://www.dmalloc.com}
  68
  69 \end{itemize}