From 481ffe4c4f7d8c5408777fffbb4cee680bc58356 Mon Sep 17 00:00:00 2001 From: schnetter <> Date: Thu, 5 Aug 2004 12:42:00 +0000 Subject: Update instructions. darcs-hash:20040805124210-07bb3-7a7010718f822a3f6fb346598975fe1745d673ed.gz --- Carpet/doc/first-steps.tex | 135 ++++----------------------------------------- 1 file changed, 10 insertions(+), 125 deletions(-) (limited to 'Carpet/doc') diff --git a/Carpet/doc/first-steps.tex b/Carpet/doc/first-steps.tex index 09f47e5a6..c42cf75be 100644 --- a/Carpet/doc/first-steps.tex +++ b/Carpet/doc/first-steps.tex @@ -1,4 +1,4 @@ -% $Header: /home/eschnett/C/carpet/Carpet/Carpet/doc/first-steps.tex,v 1.1 2004/08/05 14:38:25 schnetter Exp $ +% $Header: /home/eschnett/C/carpet/Carpet/Carpet/doc/first-steps.tex,v 1.2 2004/08/05 14:42:10 schnetter Exp $ \documentclass[11pt]{article} @@ -120,9 +120,6 @@ if you find some the tools in there not to be fully functional. Packages not required to run {\tt Carpet}, but probably useful for various purposes, such as scalar wave examples, are located in {\tt CarpetExtra}. -%% Finally {\tt CarpetAttic} contains more or -%% less obsolete Thorns you should no longer need. There is nothing wrong, though -%% in checking out all 4 arrangements. % Detailed instructions can be found on the % web page % @@ -143,8 +140,6 @@ the password being once more {\tt anon}. Next checkout Carpet by typing\\ \hspace{1cm}{\tt cvs -d :pserver:cvs\_anon@cvs.carpetcode.org:/home/cvs/carpet checkout CarpetDev}\\ -%% \hspace{1cm}{\tt cvs -d :pserver:cvs\_anon@cvs.carpetcode.org:/home/cvs/carpet checkout CarpetAttic} - %============================================================================= @@ -294,9 +289,9 @@ cannot be exhaustive and rather focus on our experience. Feel free, as before, to add to our list. %============================================================================= -\subsection{HDF and related libraries} +\subsection{HDF library} -The HDF4 and HDF5 libraries are required for handling in/output in +The HDF5 library is required for handling in/output in a particular binary data format. The use of these libraries in Cactus/Carpet is entirely optional, but in the end I found it easier to install the libraries than to @@ -304,54 +299,7 @@ convince my system that I do not want to use them. They should be useful in the long run anyway, so I recommend their installation unless they are already part of your system. -Let us start with HDF4. You can download the libraries from -% -\begin{center} - {\tt http://hdf.ncsa.uiuc.edu/release4/obtain.html} -\end{center} -% -or, if you prefer compiling the source code yourself, you get that from -% -\begin{center} - {\tt ftp://ftp.ncsa.uiuc.edu/HDF/HDF/HDF\_Current/src} -\end{center} -% -Choosing the latter option, I downloaded the gzipped tar archive and unpacked -it locally. The {\tt README} or {\tt INSTALL} file -will tell you that zlib and libjpeg are required for the -use of HDF4. Rather likely you will have them installed already as I did. -Otherwise the instructions for their installation appeared to be -rather straightforward. -Optionally you might also want to install szip. I would recommend you do so -as it is required by FlexIO below. You can get szip, for example, from -% -\begin{center} - {\tt ftp://ftp.ncsa.uiuc.edu/HDF/lib-external/szip/src} -\end{center} -% -The installation was straightforward for me. Just to make certain -about compatibility I compiled -these libraries with the Intel compiler icc, by setting\\ - -\hspace{1cm}{\tt export CC='icc'}\\ - -That may not be necessary, but I wasn't in the mood to figure out -the details. In general -I'd recommend compiling all these libraries with the Intel compilers -and therefore exported\\ - -\hspace{1cm}{\tt export CXX='icc'} - -\hspace{1cm}{\tt export F77='ifc'} - -\hspace{1cm}{\tt export F90='ifc'}\\ - -(use {\tt setenv} instead of {\tt export} and omit the $=$ sign -if you are using {\tt tcsh}). -The ensuing compilation of HDF4 worked fine in accordance with the -instructions of the {\tt INSTALL} file. - -Next we install the hdf5 libraries. The binary version can be obtained from +Let us start with the hdf5 libraries. The binary version can be obtained from % \begin{center} {\tt ftp://ftp.ncsa.uiuc.edu/HDF/HDF5/hdf5-1.6.1/bin} @@ -373,63 +321,8 @@ szip libraries were found (see {\tt INSTALL} file). The Fortran interface did not work for me, so I did not enable that. In future versions of this document this issued may be readdressed. Finally you may need to point the environment variable {\tt LD\_LIBRARY\_PATH} in your {\tt .bashrc} -or {\tt .cshrc} to the directories containing the hdf4 and hdf5 libraries.\\ - - -%============================================================================= -\subsection{libieeeio} - -You will also need the library {\tt libieeeio}. I doubt the -following is the best way -to obtain it, but it worked for me and I do currently not know an alternative, -so we stick with this method. Change into some build directory (preferably -outside the -Cactus directory) and check out the Cactus {\tt FlexIO} package\\ +or {\tt .cshrc} to the directory containing the hdf5 library.\\ -\hspace{1cm} {\tt cvs -d :pserver:cvs\_anon@cvs.cactuscode.org:/packages checkout FlexIO}\\ - -Go to the {\tt FlexIO} directory and type\\ - -\hspace{1cm}{\tt ./configure --with-hdf4 --with-hdf5}\\ - -The {\tt Makefile} still needs plenty of manual modification, though. -First I had to change {\tt HDFROOT} to \\ - -\hspace{1cm}{\tt HDFROOT = /usr/local/hdf4}\\ - -and had to add to {\tt HDFLIBS}\\ - -\hspace{1cm}{\tt -L/usr/local/szip/lib -lsz}\\ - -For some reason the specification of the include paths for {\tt hdf5} -is also screwed, so I had to add to {\tt HDFROOT} \\ - -\hspace{1cm}{\tt -I/usr/local/hdf5/include}\\ - -The variable {\tt H5ROOT} is also wrong and should be set to\\ - -\hspace{1cm}{\tt /usr/local/hdf5}\\ - -Replace the {\tt /usr/local/...} in all these arguments -with whatever is the correct path to -the {\tt hdf} and {\tt szip} libraries on your system. -Finally I wanted to use the Intel compiler and thus set\\ - -\hspace{1cm}{\tt CC = icc} - -\hspace{1cm}{\tt C++ = icc}\\ - -All these things should somewhat have been set correctly by the command -{\tt ./configure} but they were not on my machine. -Anyway, typing\\ - -\hspace{1cm}{\tt make}\\ - -did compile successfully for me. -I did not find a {\tt make install} option, so I merely copied -the file {\tt libieeeio.a} to a directory where it would be found. -This is a big hassle for getting {\tt libieeeio.a} and please replace this -mess with an easier way if you know one. %============================================================================= \subsection{Parallelization} @@ -605,6 +498,8 @@ way except for the following\\ \hspace{1cm}{\tt CactusBase/Boundary} +\hspace{1cm}{\tt CactusBase/CartGrid3D} + \hspace{1cm}{\tt CactusBase/CoordBase} \hspace{1cm}{\tt CactusBase/IOBasic} @@ -617,16 +512,12 @@ way except for the following\\ \hspace{1cm}{\tt CactusBase/Time} -\hspace{1cm}{\tt CactusExternal/FlexIO} - -\hspace{1cm}{\tt CactusExternal/jpeg6b} - -\hspace{1cm}{\tt CactusIO/IOJpeg} - \hspace{1cm}{\tt Carpet/Carpet} \hspace{1cm}{\tt Carpet/CarpetIOASCII} +\hspace{1cm}{\tt Carpet/CarpetIOHDF5} + \hspace{1cm}{\tt Carpet/CarpetInterp} \hspace{1cm}{\tt Carpet/CarpetLib} @@ -637,15 +528,9 @@ way except for the following\\ \hspace{1cm}{\tt Carpet/CarpetSlab} -\hspace{1cm}{\tt CarpetAttic/CarpetIOFlexIO} - \hspace{1cm}{\tt CarpetExtra/IDScalarWave} -\hspace{1cm}{\tt CarpetExtra/WaveToyF77} - -\hspace{1cm}{\tt TAT/Cart3d} - -\hspace{1cm}{\tt TAT/Slab}\\ +\hspace{1cm}{\tt CarpetExtra/WaveToyF77}\\ Before you compile, you need to apply one modification to the file\\ -- cgit v1.2.3