/[escript]/trunk/doc/install/intro.tex
ViewVC logotype

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 2881 - (show annotations)
Thu Jan 28 02:03:15 2010 UTC (9 years, 9 months ago) by jfenwick
File MIME type: application/x-tex
File size: 2985 byte(s)
Don't panic.
Updating copyright stamps

1 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
2 %
3 % Copyright (c) 2003-2010 by University of Queensland
4 % Earth Systems Science Computational Center (ESSCC)
5 % http://www.uq.edu.au/esscc
6 %
7 % Primary Business: Queensland, Australia
8 % Licensed under the Open Software License version 3.0
9 % http://www.opensource.org/licenses/osl-3.0.php
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 \end{itemize}
31
32 Hopefully, a Windows version(stand-alone) of this release will be available soon.
33
34 See \Chap{chap:bin} for instructions on how to set these up and run \esfinley.
35 If you choose to compile from source your options are to
36 \begin{itemize}
37 \item install dependencies (e.g. using your package manager) and only compile \esfinley, OR
38 \item compile everything from source.
39 \end{itemize}
40
41 Compiling \esfinley when its dependencies are already installed is discussed in \Chap{chap:essrc}.
42 To compile \esfinley and all dependencies from source please see \Chap{chap:allsrc}.
43 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.
44
45 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}.}.
46 Unpack the examples and try to run the following from a terminal:
47 \begin{shellCode}
48 escript poission.py
49 \end{shellCode}
50 If this produces a VTK file called \filename{u.vtu} then you are likely to have a functional \esfinley installation.
51 You can try and visualize the VTK data or delete the file.
52 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.
53
54 See the site \url{https://answers.launchpad.net/escript-finley} for online help.

  ViewVC Help
Powered by ViewVC 1.1.26