# Contents of /trunk/doc/install/intro.tex

Revision 2547 - (show annotations)
Mon Jul 20 05:50:46 2009 UTC (11 years, 2 months ago) by caltinay
File MIME type: application/x-tex
File size: 2969 byte(s)
More work on the install guide.


 1 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% 2 % 3 % Copyright (c) 2003-2008 by University of Queensland 4 % Earth Systems Science Computational Center (ESSCC) 5 6 % 7 % Primary Business: Queensland, Australia 8 % Licensed under the Open Software License version 3.0 9 10 % 11 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% 12 13 \chapter{Introduction} 14 This document describes how to install \esfinley on your computer. 15 To learn how to use \esfinley please see the User's guide or, for more detailed 16 information, the API documentation. 17 18 \esfinley is primarily developed on Linux desktop, SGI ICE and \macosx systems. 19 It is distributed in two forms: 20 \begin{enumerate} 21 \item Binary bundles -- these are great for first time users or for those who want to start using \esfinley immediately 22 \item Source bundles -- these require compilation and should be used if the binary bundles don't work on the target machine or if extra functionality is required such as \mpi parallelisation. 23 \end{enumerate} 24 25 The binary bundles are currently available for the following platforms: 26 \begin{itemize} 27 \item Debian and Ubuntu Linux distributions ($32$-bit i686) (.deb package) 28 \item Linux desktop systems with gcc (stand-alone bundle) 29 \item \macosx Leopard systems with gcc (stand-alone bundle) 30 \item Windows systems with Visual Studio (stand-alone bundle) 31 \end{itemize} 32 33 See \Chap{chap:bin} for instructions on how to set these up and run \esfinley. 34 If you choose to compile from source your options are to 35 \begin{itemize} 36 \item install dependencies (e.g. using your package manager) and only compile \esfinley, OR 37 \item compile everything from source. 38 \end{itemize} 39 40 Compiling \esfinley when its dependencies are already installed is discussed in \Chap{chap:essrc}. 41 To compile \esfinley and all dependencies from source please see \Chap{chap:allsrc}. 42 The latter option takes a significant amount of time and is only required if the versions of the dependent libraries available on your system do not work with \esfinley. 43 44 Once everything is installed you can test your installation using the Python scripts in \filename{examples.zip} or \filename{examples.tar.gz}\footnote{These should either be in \filename{escript.d/release/doc} or in the case of Debian, in \filename{/usr/share/doc/escript}.}. 45 Unpack the examples and try to run the following from a terminal: 46 \begin{shellCode} 47 escript poission.py 48 \end{shellCode} 49 If this produces a VTK file called \filename{u.vtu} then you are likely to have a functional \esfinley installation. 50 You can try and visualize the VTK data or delete the file. 51 For visualization we suggest using \filename{VisIt}\footnote{\url{https://wci.llnl.gov/codes/visit/}} or \filename{MayaVi}\footnote{\url{http://mayavi.sourceforge.net}} which are both freely available. 52 53 See the site \url{https://answers.launchpad.net/escript-finley} for online help.