From 2d1fd0444b780fb5ae36a74edffa760d52c4295c Mon Sep 17 00:00:00 2001
From: Chris Greenshields <chris@manfred.(none)>
Date: Mon, 27 Jul 2009 12:38:05 +0100
Subject: [PATCH] Updated ParaView information in README
---
README | 57 +++++++++++++++++++++++++++++++++++++--------------------
1 file changed, 37 insertions(+), 20 deletions(-)
diff --git a/README b/README
index cef52e987fe..f89776546c5 100644
--- a/README
+++ b/README
@@ -23,10 +23,11 @@
section "Running OpenFOAM in 32-bit mode".
*** Qt (from http://trolltech.com/products/qt)
- The ParaView 3.6.1 visualisation package suggests that Qt version 4.3.x
- should be installed on the system. The source may build against more recent
- versions, but this is done at the user's own risk. To check whether Qt4 is
- installed, and the version, type:
+ The ParaView 3.6.1 visualisation package requires Qt to be installed on the
+ system. ParaView's producers state that ParaView is only officially
+ supported on Qt version 4.3.x. However, we have found in limited tests that
+ ParaView works satisfactorily with newer versions of Qt than 4.3.x. To
+ check whether Qt4 is installed, and the version, type:
+ qmake --version
Both 32- and 64-bit version of ParaView were compiled with Qt-4.4.3 (with
@@ -38,6 +39,7 @@
The default versions of Qt used by some GNU/Linux releases are as follows.
+ ubuntu-7.10: Version 4.3.2
+ ubuntu-8.04: Version 4.3.4
+ + ubuntu-9.04: Version 4.5.0
+ openSuSE-10.2: Version 4.2.1 - too old
+ openSuSE-10.3: Version 4.3.1
+ openSuSE-11.0: Version 4.4.0
@@ -59,14 +61,13 @@
The environment variable settings are contained in files in an etc/ directory
in the OpenFOAM release. e.g. in
- + $HOME/OpenFOAM/OpenFOAM-<VERSION>/etc/
- + where <VERSION> corresponds to the version 1.6, 1.7, ...
+ + $HOME/OpenFOAM/OpenFOAM-1.6/etc/
1) EITHER, if running bash or ksh (if in doubt type 'echo $SHELL'), source the
etc/bashrc file by adding the following line to the end of your
$HOME/.bashrc file:
- + . $HOME/OpenFOAM/OpenFOAM-<VERSION>/etc/bashrc
+ + . $HOME/OpenFOAM/OpenFOAM-1.6/etc/bashrc
Then update the environment variables by sourcing the $HOME/.bashrc file by
typing in the terminal:
@@ -76,7 +77,7 @@
2) OR, if running tcsh or csh, source the etc/cshrc file by adding the
following line to the end of your $HOME/.cshrc file:
- + source $HOME/OpenFOAM/OpenFOAM-<VERSION>/etc/cshrc
+ + source $HOME/OpenFOAM/OpenFOAM-1.6/etc/cshrc
Then update the environment variables by sourcing the $HOME/.cshrc file by
typing in the terminal:
@@ -92,13 +93,13 @@
appropriate resource file. Here is a bash/ksh/sh example:
+ export FOAM_INST_DIR=/data/app/OpenFOAM
- + foamDotFile=$FOAM_INST_DIR/OpenFOAM-<VERSION>/etc/bashrc
+ + foamDotFile=$FOAM_INST_DIR/OpenFOAM-1.6/etc/bashrc
+ [ -f $foamDotFile ] && . $foamDotFile
and a csh/tcsh example:
+ setenv FOAM_INST_DIR /data/app/OpenFOAM
- + foamDotFile=$FOAM_INST_DIR/OpenFOAM-<VERSION>/etc/bashrc
+ + foamDotFile=$FOAM_INST_DIR/OpenFOAM-1.6/etc/bashrc
+ if ( -f $foamDotFile ) source $foamDotFile
The value set in '$FOAM_INST_DIR' will be used to locate the remaining parts
@@ -135,34 +136,36 @@
* Getting Started
Create a project directory within the $HOME/OpenFOAM directory named
- <USER>-<VERSION> (e.g. 'chris-1.6' for user chris and OpenFOAM version 1.6)
+ <USER>-1.6 (e.g. 'chris-1.6' for user chris and OpenFOAM version 1.6)
and create a directory named 'run' within it, e.g. by typing:
- + mkdir -p $HOME/OpenFOAM/${USER}-${WM_PROJECT_VERSION}/run
+ + mkdir -p $FOAM_RUN/run
Copy the 'tutorial' examples directory in the OpenFOAM distribution to the
'run' directory. If the OpenFOAM environment variables are set correctly,
then the following command will be correct:
- + cp -r $WM_PROJECT_DIR/tutorials
- $HOME/OpenFOAM/${USER}-${WM_PROJECT_VERSION}/run
+ + cp -r $WM_PROJECT_DIR/tutorials $FOAM_RUN
Run the first example case of incompressible laminar flow in a cavity:
- + cd $HOME/OpenFOAM/${USER}-${WM_PROJECT_VERSION}/run/tutorials/icoFoam/cavity
+ + cd $FOAM_RUN/tutorials/incompressible/icoFoam/cavity
+ blockMesh
+ icoFoam
+ paraFoam
+ Refer to the OpenFOAM User Guide at http://www.OpenFOAM.org/doc/user.html for
+ more information.
+
* Compiling Paraview 3.6.1 and the PV3FoamReader module
- A version of Qt 4.3.x should be installed to compile ParaView. The compilation
- is a fairly simple process using the supplied buildParaView script that
+ If there are problems encountered with ParaView, then it may be necessary to
+ compile ParaView from sources. The compilation
+ is a fairly simple process using the supplied makeParaView script that
has worked in our tests with other packages supplied in the ThirdParty
directory, namely cmake-2.6.4 and gcc-4.3.3. Execute the following:
+ cd $WM_THIRD_PARTY_DIR
+ rm -rf paraview-3.6.1/platforms
- + buildParaView
-
+ + makeParaView
The PV3FoamReader module is an OpenFOAM utility that can be compiled in the
usual manner as follows:
@@ -170,6 +173,21 @@
+ ./Allwclean
+ ./Allwmake
+*** Compiling Paraview with a local version of Qt
+ If the user still encounters problems with ParaView, it may relate to the
+ version of Qt, in which case, it is recommended that the user first
+ downloads the supported version 4.3.5 of Qt as described in the section on
+ "Qt". The user should unpack the source pack in the $WM_THIRD_PARTY_DIR.
+ Then the user can build Qt 4.3.5 by executing from within
+ $WM_THIRD_PARTY_DIR:
+ + makeQt
+
+ The user should then compile ParaView using the local version of Qt by
+ executing makeParaView with the -qmake option, giving the full path of the
+ newly built qmake as an argument:
+ + makeParaView -qmake <path_to_qmake>
+
+ The user must then recompile the PV3FoamReader module as normal (see above).
* Documentation
http://www.OpenFOAM.org/doc
@@ -185,4 +203,3 @@
is the default mode on a 64-bit machine. To use an installed 32-bit version,
the user must set the environment variable WM_ARCH_OPTION to 32 before
sourcing the etc/bashrc (or etc/cshrc) file.
-
--
GitLab