README: Update ParaView instructions

Required for the new collated parallel IO using threading.

.gitignore

@@ -1,79 +1,34 @@
-# man gitignore for more information
-
-# editor and misc backup files - anywhere
+# Ignore editor and misc backup files - anywhere
 *~
 .*~
 *.bak
 *.bak[0-9][0-9]
-*.orig
-*.orig[0-9][0-9]
 \#*\#
 
-# file-browser settings - anywhere
-.directory
-
-# CVS recovered versions - anywhere
-.#*
-
-# objects and archives - anywhere
-*.[oa]
-*.la
-*.so
-*.jar
-
-# derived files
-lex.yy.c
-
-# Corefiles
-core
-
-# dependency files - anywhere
-*.dep
-
-# lnInclude (symlink) folders - anywhere
-lnInclude
-
-# build folders - anywhere
-linux*Gcc*/
-linux*Icc*/
-linuxming*/
-SiCortex*Gcc*/
-solaris*Gcc*/
-SunOS*Gcc*/
-
-# source packages - anywhere
+# Ignore source packages - anywhere
 *.tar.bz2
 *.tar.gz
 *.tar
 *.tgz
 *.gtgz
 
+# Ignore build and platforms folders
+build/
+platforms/
 
-# ignore the persistent .build tag in the main directory
-/.build
+# Ignore deprecated scripts
+etc/relocateQt
+etc/tools/QtFunctions
+etc/wmakeFiles/tecio/
+makeQt
 
-# ignore .timeStamp in the main directory
-/.timeStamp
-
-# ignore unpacked sources in the main directory (match pkg-ver)
-# this also matches symlinks
+# Ignore unpacked sources in the main directory (match pkg-ver)
 /*[-_][0-9]*
 
-# ignore all sub-directories
-/*/
+# Include ParaView
+!/ParaView-5.0.1
 
-# do not ignore these ones
-!/etc/
+# Include scotch
+!/scotch_6.0.3
 
-# do not ignore the first level of these ones
-!/malloc/
-/malloc/*/
-!/malloc/fbsdmalloc/
-
-# ignore these extra symlinks
-libccmio
-
-# track this patched version directly - until metis gets dropped
-!/metis-5.0pre2/libmetis/metislib.h
-
-# end-of-file
+# End-of-file

Allclean

@@ -59,4 +59,4 @@ done
 [ -d platforms ] && ( set -x; rm -rf platforms/* )
 
 
-# ----------------------------------------------------------------- end-of-file
+#------------------------------------------------------------------------------

Allwmake

@@ -3,7 +3,7 @@
 # =========                 |
 # \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
 #  \\    /   O peration     |
-#   \\  /    A nd           | Copyright (C) 2011-2014 OpenFOAM Foundation
+#   \\  /    A nd           | Copyright (C) 2011-2016 OpenFOAM Foundation
 #    \\/     M anipulation  |
 #------------------------------------------------------------------------------
 # License
@@ -77,7 +77,7 @@ OPENMPI)
         set -x
         cd "${MPI_ARCH_PATH##*/}" || exit 1    # change to openmpi-VERSION
 
-        make distclean 2>/dev/null
+        [ -e Makefile ] && make distclean 2>/dev/null
         rm -rf $MPI_ARCH_PATH
 
         # start with GridEngine support,
@@ -95,6 +95,7 @@ OPENMPI)
             --prefix=$MPI_ARCH_PATH \
             --disable-orterun-prefix-by-default \
             --enable-shared --disable-static \
+            --enable-mpi-thread-multiple \
             --libdir=$MPI_ARCH_PATH/lib${WM_COMPILER_LIB_ARCH} \
             --enable-mpi-fortran=none \
             --disable-mpi-profile \
@@ -122,7 +123,7 @@ MPICH)
         set -x
         cd $MPI_HOME || exit 1    # change to mpich-VERSION
 
-        make distclean 2>/dev/null
+        [ -e Makefile ] && make distclean 2>/dev/null
         rm -rf $MPI_ARCH_PATH
         rm util/machines/machines.*
 
@@ -173,12 +174,12 @@ esac
 
 
 # get SCOTCH_VERSION, SCOTCH_ARCH_PATH
-if settings=`$WM_PROJECT_DIR/bin/foamEtcFile config/scotch.sh`
+if settings=`$WM_PROJECT_DIR/bin/foamEtcFile config.sh/scotch`
 then
     . $settings
 else
     echo
-    echo "Error: no config/scotch.sh settings"
+    echo "Error: no config.sh/scotch settings"
     echo
 fi
 
@@ -187,8 +188,8 @@ echo ========================================
 echo "Build Scotch decomposition library $SCOTCH_VERSION"
 echo "    $SCOTCH_ARCH_PATH"
 
-# this needs generalizing
-scotchMakefile=../../etc/wmakeFiles/scotch/Makefile.inc.i686_pc_linux2.shlib-OpenFOAM-$WM_ARCH_OPTION$WM_LABEL_OPTION
+# this needs generalizing for any compiler, since it's hard-coded to GCC
+scotchMakefile=../../etc/wmakeFiles/scotch/Makefile.inc.i686_pc_linux2.shlib-OpenFOAM
 
 if [ -f $SCOTCH_ARCH_PATH/include/scotch.h \
   -a -r $FOAM_EXT_LIBBIN/libscotch.so \
@@ -306,14 +307,14 @@ then
 fi
 
 
-# -----------------------------------------------------------------------------
+#------------------------------------------------------------------------------
 
 # Metis is optional
 echo ========================================
 echo Build Metis decomposition
 
 # get METIS_VERSION, METIS_ARCH_PATH
-if settings=`$WM_PROJECT_DIR/bin/foamEtcFile config/metis.sh`
+if settings=`$WM_PROJECT_DIR/bin/foamEtcFile config.sh/metis`
 then
     . $settings
 fi
@@ -330,6 +331,11 @@ then
     (
         set -x
         cd $METIS_VERSION  || exit 1
+
+        # Change user settings automatically
+        sed -i -e 's=\(#define IDXTYPEWIDTH\).*=\1 '$WM_LABEL_SIZE'=' \
+            include/metis.h
+
         make config shared=1 prefix=$METIS_ARCH_PATH
         make -j $WM_NCOMPPROCS install
         cp $METIS_ARCH_PATH/lib/libmetis.so $FOAM_EXT_LIBBIN
@@ -365,4 +371,4 @@ echo ========================================
 echo
 
 
-# ----------------------------------------------------------------- end-of-file
+#------------------------------------------------------------------------------

AllwmakeLibccmio

@@ -3,7 +3,7 @@
 # =========                 |
 # \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
 #  \\    /   O peration     |
-#   \\  /    A nd           | Copyright (C) 2011 OpenFOAM Foundation
+#   \\  /    A nd           | Copyright (C) 2011-2016 OpenFOAM Foundation
 #    \\/     M anipulation  |
 #------------------------------------------------------------------------------
 # License
@@ -26,7 +26,7 @@
 #     AllwmakeLibccmio
 #
 # Description
-#     Get and build CD-adapco's ccmio library
+#     Build CD-adapco's ccmio library
 #
 #------------------------------------------------------------------------------
 packageDir=libccmio-2.6.1
@@ -82,4 +82,4 @@ set -x
 )
 
 
-# ----------------------------------------------------------------- end-of-file
+#------------------------------------------------------------------------------

README.html

@@ -4,7 +4,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
 <head>
 <title>OpenFOAM-dev Third-Party packages</title>
-<!-- 2015-11-02 Mon 20:00 -->
+<!-- 2017-07-25 Tue 11:10 -->
 <meta  http-equiv="Content-Type" content="text/html;charset=utf-8" />
 <meta  name="generator" content="Org-mode" />
 <style type="text/css">
@@ -142,24 +142,24 @@ for the JavaScript code in this tag.
 <div id="text-table-of-contents">
 <ul>
 <li><a href="#sec-1">1. Description</a></li>
-<li><a href="#sec-2">2. Order of execution:</a>
+<li><a href="#sec-2">2. Download and installation instructions</a></li>
+<li><a href="#sec-3">3. Order of execution:</a>
 <ul>
-<li><a href="#sec-2-1">2.1. Optional</a></li>
+<li><a href="#sec-3-1">3.1. Optional</a></li>
 </ul>
 </li>
-<li><a href="#sec-3">3. Versions and locations to download the third party packages</a>
+<li><a href="#sec-4">4. Versions and locations to download the third party packages</a>
 <ul>
-<li><a href="#sec-3-1">3.1. Gcc C++ Compiler</a></li>
-<li><a href="#sec-3-2">3.2. Parallel Processing</a></li>
-<li><a href="#sec-3-3">3.3. ParaView</a></li>
-<li><a href="#sec-3-4">3.4. CGAL</a></li>
-<li><a href="#sec-3-5">3.5. Miscellaneous</a></li>
+<li><a href="#sec-4-1">4.1. Gcc C++ Compiler</a></li>
+<li><a href="#sec-4-2">4.2. Parallel Processing</a>
+<ul>
+<li><a href="#sec-4-2-1">4.2.1. Scotch</a></li>
+<li><a href="#sec-4-2-2">4.2.2. OpenMPI</a></li>
 </ul>
 </li>
-<li><a href="#sec-4">4. Notes</a>
-<ul>
-<li><a href="#sec-4-1">4.1. Building ParaView-4.3.1/4.4.0</a></li>
-<li><a href="#sec-4-2">4.2. Building ParaView-4.1.0</a></li>
+<li><a href="#sec-4-3">4.3. ParaView</a></li>
+<li><a href="#sec-4-4">4.4. CGAL</a></li>
+<li><a href="#sec-4-5">4.5. Miscellaneous</a></li>
 </ul>
 </li>
 </ul>
@@ -175,22 +175,23 @@ Scripts for building third-party packages.
 </div>
 </div>
 <div id="outline-container-sec-2" class="outline-2">
-<h2 id="sec-2"><span class="section-number-2">2</span> Order of execution:</h2>
-<div class="outline-text-2" id="text-2">
+<h2 id="sec-2"><span class="section-number-2">2</span> <a href="https://openfoam.org/download/source/third-party-software/">Download and installation instructions</a></h2>
+</div>
+<div id="outline-container-sec-3" class="outline-2">
+<h2 id="sec-3"><span class="section-number-2">3</span> Order of execution:</h2>
+<div class="outline-text-2" id="text-3">
 <ul class="org-ul">
-<li>makeGcc   (recommended if the system gcc is &lt; 4.7)
+<li>makeGcc   (recommended if the system gcc is &lt; 4.8)
 </li>
 <li>Allwmake  (Builds OpenMPI, Scotch etc.)
 </li>
-<li>makeCmake (if the system cmake version is &lt; 2.8.8)
-</li>
-<li>makeParaView4
+<li>makeParaView
 </li>
 </ul>
 </div>
-<div id="outline-container-sec-2-1" class="outline-3">
-<h3 id="sec-2-1"><span class="section-number-3">2.1</span> Optional</h3>
-<div class="outline-text-3" id="text-2-1">
+<div id="outline-container-sec-3-1" class="outline-3">
+<h3 id="sec-3-1"><span class="section-number-3">3.1</span> Optional</h3>
+<div class="outline-text-3" id="text-3-1">
 <ul class="org-ul">
 <li>AllwmakeLibccmio (Only required for conversion of STAR-CCM+ meshes)
 </li>
@@ -200,14 +201,14 @@ Scripts for building third-party packages.
 </div>
 </div>
 </div>
-<div id="outline-container-sec-3" class="outline-2">
-<h2 id="sec-3"><span class="section-number-2">3</span> Versions and locations to download the third party packages</h2>
-<div class="outline-text-2" id="text-3">
-</div><div id="outline-container-sec-3-1" class="outline-3">
-<h3 id="sec-3-1"><span class="section-number-3">3.1</span> Gcc C++ Compiler</h3>
-<div class="outline-text-3" id="text-3-1">
+<div id="outline-container-sec-4" class="outline-2">
+<h2 id="sec-4"><span class="section-number-2">4</span> Versions and locations to download the third party packages</h2>
+<div class="outline-text-2" id="text-4">
+</div><div id="outline-container-sec-4-1" class="outline-3">
+<h3 id="sec-4-1"><span class="section-number-3">4.1</span> Gcc C++ Compiler</h3>
+<div class="outline-text-3" id="text-4-1">
 <p>
-The minimum version of gcc required is 4.5.0
+The minimum version of gcc required is 4.8.0
 </p>
 <ul class="org-ul">
 <li>gcc   <a href="http://gcc.gnu.org/releases.html">http://gcc.gnu.org/releases.html</a>
@@ -224,42 +225,77 @@ The minimum version of gcc required is 4.5.0
 </ul>
 </div>
 </div>
-<div id="outline-container-sec-3-2" class="outline-3">
-<h3 id="sec-3-2"><span class="section-number-3">3.2</span> Parallel Processing</h3>
-<div class="outline-text-3" id="text-3-2">
+<div id="outline-container-sec-4-2" class="outline-3">
+<h3 id="sec-4-2"><span class="section-number-3">4.2</span> Parallel Processing</h3>
+<div class="outline-text-3" id="text-4-2">
+</div><div id="outline-container-sec-4-2-1" class="outline-4">
+<h4 id="sec-4-2-1"><span class="section-number-4">4.2.1</span> Scotch</h4>
+<div class="outline-text-4" id="text-4-2-1">
+<p>
+Scotch-6.0.3 is provided with ThirdParty-dev or the original source pack
+may be obtained from:
+</p>
 <ul class="org-ul">
-<li>OpenMPI: <a href="http://www.open-mpi.org/software/ompi/v1.8/downloads/openmpi-1.8.5.tar.bz2">http://www.open-mpi.org/software/ompi/v1.8/downloads/openmpi-1.8.5.tar.bz2</a>
-</li>
 <li>Scotch/PtScotch: <a href="https://gforge.inria.fr/frs/download.php/file/34099/scotch_6.0.3.tar.gz">https://gforge.inria.fr/frs/download.php/file/34099/scotch_6.0.3.tar.gz</a>
 </li>
 </ul>
 </div>
 </div>
-<div id="outline-container-sec-3-3" class="outline-3">
-<h3 id="sec-3-3"><span class="section-number-3">3.3</span> ParaView</h3>
-<div class="outline-text-3" id="text-3-3">
+<div id="outline-container-sec-4-2-2" class="outline-4">
+<h4 id="sec-4-2-2"><span class="section-number-4">4.2.2</span> OpenMPI</h4>
+<div class="outline-text-4" id="text-4-2-2">
 <ul class="org-ul">
-<li>cmake       <a href="http://www.cmake.org/files/v3.2/cmake-3.2.1.tar.gz">http://www.cmake.org/files/v3.2/cmake-3.2.1.tar.gz</a>
-</li>
-<li>ParaView    <a href="http://www.paraview.org/files/v4.4/ParaView-v4.4.0-source.tar.gz">http://www.paraview.org/files/v4.4/ParaView-v4.4.0-source.tar.gz</a>
+<li>OpenMPI: <a href="https://www.open-mpi.org/software/ompi/v2.1/downloads/openmpi-2.1.1.tar.bz2">https://www.open-mpi.org/software/ompi/v2.1/downloads/openmpi-2.1.1.tar.bz2</a>
 </li>
 </ul>
 </div>
 </div>
-<div id="outline-container-sec-3-4" class="outline-3">
-<h3 id="sec-3-4"><span class="section-number-3">3.4</span> CGAL</h3>
-<div class="outline-text-3" id="text-3-4">
+</div>
+<div id="outline-container-sec-4-3" class="outline-3">
+<h3 id="sec-4-3"><span class="section-number-3">4.3</span> ParaView</h3>
+<div class="outline-text-3" id="text-4-3">
+<p>
+Patched versions of the ParaView source code were once provided for ParaView
+v5.0.1.  With the current supported version of ParaView (v.5.4.0), the
+source code
+</p>
 <ul class="org-ul">
-<li>CGAL        <a href="https://github.com/CGAL/cgal/releases/download/releases/CGAL-4.7/CGAL-4.7.tar.xz">https://github.com/CGAL/cgal/releases/download/releases/CGAL-4.7/CGAL-4.7.tar.xz</a>
+<li>ParaView-5.4.0 <a href="http://www.paraview.org/files/v5.4/ParaView-v5.4.0.tar.gz">http://www.paraview.org/files/v5.4/ParaView-v5.4.0.tar.gz</a>
+</li>
+</ul>
+<p>
+is downloaded automatically and compiles without modification.  ParaView is
+compiled by running the <code>makeParaView</code> script, i.e.
+</p>
+<ul class="org-ul">
+<li>./makeParaView
+</li>
+</ul>
+<p>
+Expect ParaView to take a long time to compile, typically several hours on a
+desktop computer.  Following compilation, update the environment by sourcing
+the .bashrc (or .cshrc) file or by typing
+</p>
+<ul class="org-ul">
+<li>wmRefresh
+</li>
+</ul>
+</div>
+</div>
+<div id="outline-container-sec-4-4" class="outline-3">
+<h3 id="sec-4-4"><span class="section-number-3">4.4</span> CGAL</h3>
+<div class="outline-text-3" id="text-4-4">
+<ul class="org-ul">
+<li>CGAL        <a href="https://github.com/CGAL/cgal/releases/download/releases/CGAL-4.8.1/CGAL-4.8.1.tar.xz">https://github.com/CGAL/cgal/releases/download/releases/CGAL-4.8.1/CGAL-4.8.1.tar.xz</a>
 </li>
 <li>boost       <a href="http://sourceforge.net/projects/boost/files/boost/1.55.0/boost_1_55_0.tar.bz2/download">http://sourceforge.net/projects/boost/files/boost/1.55.0/boost_1_55_0.tar.bz2/download</a>
 </li>
 </ul>
 </div>
 </div>
-<div id="outline-container-sec-3-5" class="outline-3">
-<h3 id="sec-3-5"><span class="section-number-3">3.5</span> Miscellaneous</h3>
-<div class="outline-text-3" id="text-3-5">
+<div id="outline-container-sec-4-5" class="outline-3">
+<h3 id="sec-4-5"><span class="section-number-3">4.5</span> Miscellaneous</h3>
+<div class="outline-text-3" id="text-4-5">
 <ul class="org-ul">
 <li>libccmio    <a href="http://portal.nersc.gov/svn/visit/trunk/third_party/libccmio-2.6.1.tar.gz">http://portal.nersc.gov/svn/visit/trunk/third_party/libccmio-2.6.1.tar.gz</a>
 </li>
@@ -267,68 +303,11 @@ The minimum version of gcc required is 4.5.0
 </div>
 </div>
 </div>
-<div id="outline-container-sec-4" class="outline-2">
-<h2 id="sec-4"><span class="section-number-2">4</span> Notes</h2>
-<div class="outline-text-2" id="text-4">
-</div><div id="outline-container-sec-4-1" class="outline-3">
-<h3 id="sec-4-1"><span class="section-number-3">4.1</span> Building ParaView-4.3.1/4.4.0</h3>
-<div class="outline-text-3" id="text-4-1">
-<p>
-The ParaView-4.3.1/4.4.0 source-pack provided by KitWare will not build and
-install correctly without a minor correction: lines 653-656 must be removed
-or commented from file
-<i>ThirdParty-dev/ParaView-4.?.?/Qt/Components/CMakeLists.txt</i> after unpacking
-and renaming the ParaView-4.?.? directory.  This is because the file
-ui_pqExportStateWizard.h referred to in the lines 653-656:
-</p>
-<div class="org-src-container">
-
-<pre class="src src-C"><span style="color: #0000cd; font-weight: bold;">if</span>(PARAVIEW_INSTALL_DEVELOPMENT_FILES)
-  install(FILES <span style="color: #008b00;">"${CMAKE_CURRENT_BINARY_DIR}/ui_pqExportStateWizard.h"</span>
-          DESTINATION <span style="color: #008b00;">"${VTK_INSTALL_INCLUDE_DIR}"</span>)
-endif()
-</pre>
-</div>
-<p>
-does not exist and cannot be installed causing the build and installation to
-fail.
-</p>
-
-<p>
-Additionally for ParaView-4.4.0 there is a bug in the STL reader which can
-be patched by running the following command from within the ThirdParty-???
-directory:
-</p>
-<ul class="org-ul">
-<li>wget <a href="https://raw.githubusercontent.com/Kitware/VTK/40937e934308e5009e80769dc0c451ee4f157749/IO/Geometry/vtkSTLReader.cxx">https://raw.githubusercontent.com/Kitware/VTK/40937e934308e5009e80769dc0c451ee4f157749/IO/Geometry/vtkSTLReader.cxx</a> -O ParaView-4.4.0/VTK/IO/Geometry/vtkSTLReader.cxx
-</li>
-</ul>
-<p>
-See also <a href="http://www.openfoam.org/mantisbt/view.php?id=1887">http://www.openfoam.org/mantisbt/view.php?id=1887</a>
-</p>
-</div>
-</div>
-
-<div id="outline-container-sec-4-2" class="outline-3">
-<h3 id="sec-4-2"><span class="section-number-3">4.2</span> Building ParaView-4.1.0</h3>
-<div class="outline-text-3" id="text-4-2">
-<p>
-On Ubuntu 14.10 and higher, OpenSuSE 13.2 and probably other recent
-GNU/Linux distributions there is an issue in the GL libraries requiring a
-change to the vtkXOpenGLRenderWindow.cxx file in ParaView: Uncomment line 30
-</p>
-
-<p>
-#define GLX_GLXEXT_LEGACY
-</p>
-</div>
-</div>
-</div>
 </div>
 <div id="postamble" class="status">
-<p class="date">Date: 23th October 2015</p>
-<p class="date">Created: 2015-11-02 Mon 20:00</p>
-<p class="creator"><a href="http://www.gnu.org/software/emacs/">Emacs</a> 24.5 (<a href="http://orgmode.org">Org</a> mode 8.2.10)</p>
+<p class="date">Date: 25st July 2017</p>
+<p class="date">Created: 2017-07-25 Tue 11:10</p>
+<p class="creator"><a href="http://www.gnu.org/software/emacs/">Emacs</a> 25.1.91 (<a href="http://orgmode.org">Org</a> mode 8.2.10)</p>
 <p class="validation"><a href="http://validator.w3.org/check?uri=referer">Validate</a></p>
 </div>
 </body>

README.org

@@ -2,24 +2,24 @@
 #
 #+TITLE:              OpenFOAM-dev Third-Party packages
 #+AUTHOR:                  The OpenFOAM Foundation
-#+DATE:                       23th October 2015
+#+DATE:                       25st July 2017
 #+LINK:                     http://www.openfoam.org
 #+OPTIONS: author:nil ^:{}
-# Copyright (c) 2014-2015 OpenFOAM Foundation.
+# Copyright (c) 2014-2016 OpenFOAM Foundation.
 
 * Description
   Scripts for building third-party packages.
+* [[https://openfoam.org/download/source/third-party-software/][Download and installation instructions]]
 * Order of execution:
-  + makeGcc   (recommended if the system gcc is < 4.7)
+  + makeGcc   (recommended if the system gcc is < 4.8)
   + Allwmake  (Builds OpenMPI, Scotch etc.)
-  + makeCmake (if the system cmake version is < 2.8.8)
-  + makeParaView4
+  + makeParaView
 *** Optional
     + AllwmakeLibccmio (Only required for conversion of STAR-CCM+ meshes)
     + Allclean (Only required to save disk space)
 * Versions and locations to download the third party packages
 *** Gcc C++ Compiler
-    The minimum version of gcc required is 4.5.0
+    The minimum version of gcc required is 4.8.0
     + gcc   http://gcc.gnu.org/releases.html
     + gmp   http://gmplib.org/
             ftp://ftp.gnu.org/gnu/gmp/gmp-5.1.2.tar.bz2
@@ -28,44 +28,28 @@
     + mpc   http://www.multiprecision.org/
             http://www.multiprecision.org/mpc/download/mpc-1.0.1.tar.gz
 *** Parallel Processing
-    + OpenMPI: http://www.open-mpi.org/software/ompi/v1.8/downloads/openmpi-1.8.5.tar.bz2
-    + Scotch/PtScotch: https://gforge.inria.fr/frs/download.php/file/34099/scotch_6.0.3.tar.gz
+***** Scotch
+      Scotch-6.0.3 is provided with ThirdParty-dev or the original source pack
+      may be obtained from:
+      + Scotch/PtScotch: https://gforge.inria.fr/frs/download.php/file/34099/scotch_6.0.3.tar.gz
+***** OpenMPI
+      + OpenMPI: https://www.open-mpi.org/software/ompi/v2.1/downloads/openmpi-2.1.1.tar.bz2
 *** ParaView
-    + cmake       http://www.cmake.org/files/v3.2/cmake-3.2.1.tar.gz
-    + ParaView    http://www.paraview.org/files/v4.4/ParaView-v4.4.0-source.tar.gz
+    Patched versions of the ParaView source code were once provided for ParaView
+    v5.0.1.  With the current supported version of ParaView (v.5.4.0), the
+    source code
+    + ParaView-5.4.0 http://www.paraview.org/files/v5.4/ParaView-v5.4.0.tar.gz
+    is downloaded automatically and compiles without modification.  ParaView is
+    compiled by running the =makeParaView= script, i.e.
+    + ./makeParaView
+    Expect ParaView to take a long time to compile, typically several hours on a
+    desktop computer.  Following compilation, update the environment by sourcing
+    the .bashrc (or .cshrc) file or by typing
+    + wmRefresh
 *** CGAL
-    + CGAL        https://github.com/CGAL/cgal/releases/download/releases%2FCGAL-4.7/CGAL-4.7.tar.xz
+    + CGAL        https://github.com/CGAL/cgal/releases/download/releases%2FCGAL-4.8.1/CGAL-4.8.1.tar.xz
     + boost       http://sourceforge.net/projects/boost/files/boost/1.55.0/boost_1_55_0.tar.bz2/download
 *** Miscellaneous
     + libccmio    http://portal.nersc.gov/svn/visit/trunk/third_party/libccmio-2.6.1.tar.gz
-* Notes
-*** Building ParaView-4.3.1/4.4.0
-    The ParaView-4.3.1/4.4.0 source-pack provided by KitWare will not build and
-    install correctly without a minor correction: lines 653-656 must be removed
-    or commented from file
-    /ThirdParty-dev/ParaView-4.?.?/Qt/Components/CMakeLists.txt/ after unpacking
-    and renaming the ParaView-4.?.? directory.  This is because the file
-    ui_pqExportStateWizard.h referred to in the lines 653-656:
-    #+begin_src C
-    if(PARAVIEW_INSTALL_DEVELOPMENT_FILES)
-      install(FILES "${CMAKE_CURRENT_BINARY_DIR}/ui_pqExportStateWizard.h"
-              DESTINATION "${VTK_INSTALL_INCLUDE_DIR}")
-    endif()
-    #+end_src
-    does not exist and cannot be installed causing the build and installation to
-    fail.
-
-    Additionally for ParaView-4.4.0 there is a bug in the STL reader which can
-    be patched by running the following command from within the ThirdParty-???
-    directory:
-    + wget https://raw.githubusercontent.com/Kitware/VTK/40937e934308e5009e80769dc0c451ee4f157749/IO/Geometry/vtkSTLReader.cxx -O ParaView-4.4.0/VTK/IO/Geometry/vtkSTLReader.cxx
-    See also http://www.openfoam.org/mantisbt/view.php?id=1887
-
-*** Building ParaView-4.1.0
-    On Ubuntu 14.10 and higher, OpenSuSE 13.2 and probably other recent
-    GNU/Linux distributions there is an issue in the GL libraries requiring a
-    change to the vtkXOpenGLRenderWindow.cxx file in ParaView: Uncomment line 30
-
-    #define GLX_GLXEXT_LEGACY
 
 # --------------------------------------------------------------------------

README_scotch

@@ -0,0 +1,531 @@
+OpenFOAM uses shared object libraries from the Scotch/PT-Scotch software:
+https://www.labri.fr/perso/pelegrin/scotch/
+
+The software is licensed under the CeCILL-C Free Software Licence
+Agreement, a copy of which is reproduced below.
+
+Please note the limitation of both the Licensor's warranty and liability
+as set forth in Articles 8 and 9 of the Agreement.
+
+If only the object libraries of Scotch are provided, the full source code
+can be obtained from:
+https://github.com/OpenFOAM/ThirdParty-dev/tree/master/scotch_6.0.3
+
+---
+
+CeCILL-C FREE SOFTWARE LICENSE AGREEMENT
+
+
+    Notice
+
+This Agreement is a Free Software license agreement that is the result
+of discussions between its authors in order to ensure compliance with
+the two main principles guiding its drafting:
+
+    * firstly, compliance with the principles governing the distribution
+      of Free Software: access to source code, broad rights granted to
+      users,
+    * secondly, the election of a governing law, French law, with which
+      it is conformant, both as regards the law of torts and
+      intellectual property law, and the protection that it offers to
+      both authors and holders of the economic rights over software.
+
+The authors of the CeCILL-C (for Ce[a] C[nrs] I[nria] L[ogiciel] L[ibre])
+license are:
+
+Commissariat <20> l'Energie Atomique - CEA, a public scientific, technical
+and industrial research establishment, having its principal place of
+business at 25 rue Leblanc, immeuble Le Ponant D, 75015 Paris, France.
+
+Centre National de la Recherche Scientifique - CNRS, a public scientific
+and technological establishment, having its principal place of business
+at 3 rue Michel-Ange, 75794 Paris cedex 16, France.
+
+Institut National de Recherche en Informatique et en Automatique -
+INRIA, a public scientific and technological establishment, having its
+principal place of business at Domaine de Voluceau, Rocquencourt, BP
+105, 78153 Le Chesnay cedex, France.
+
+
+    Preamble
+
+The purpose of this Free Software license agreement is to grant users
+the right to modify and re-use the software governed by this license.
+
+The exercising of this right is conditional upon the obligation to make
+available to the community the modifications made to the source code of
+the software so as to contribute to its evolution.
+
+In consideration of access to the source code and the rights to copy,
+modify and redistribute granted by the license, users are provided only
+with a limited warranty and the software's author, the holder of the
+economic rights, and the successive licensors only have limited liability.
+
+In this respect, the risks associated with loading, using, modifying
+and/or developing or reproducing the software by the user are brought to
+the user's attention, given its Free Software status, which may make it
+complicated to use, with the result that its use is reserved for
+developers and experienced professionals having in-depth computer
+knowledge. Users are therefore encouraged to load and test the
+suitability of the software as regards their requirements in conditions
+enabling the security of their systems and/or data to be ensured and,
+more generally, to use and operate it in the same conditions of
+security. This Agreement may be freely reproduced and published,
+provided it is not altered, and that no provisions are either added or
+removed herefrom.
+
+This Agreement may apply to any or all software for which the holder of
+the economic rights decides to submit the use thereof to its provisions.
+
+
+    Article 1 - DEFINITIONS
+
+For the purpose of this Agreement, when the following expressions
+commence with a capital letter, they shall have the following meaning:
+
+Agreement: means this license agreement, and its possible subsequent
+versions and annexes.
+
+Software: means the software in its Object Code and/or Source Code form
+and, where applicable, its documentation, "as is" when the Licensee
+accepts the Agreement.
+
+Initial Software: means the Software in its Source Code and possibly its
+Object Code form and, where applicable, its documentation, "as is" when
+it is first distributed under the terms and conditions of the Agreement.
+
+Modified Software: means the Software modified by at least one
+Integrated Contribution.
+
+Source Code: means all the Software's instructions and program lines to
+which access is required so as to modify the Software.
+
+Object Code: means the binary files originating from the compilation of
+the Source Code.
+
+Holder: means the holder(s) of the economic rights over the Initial
+Software.
+
+Licensee: means the Software user(s) having accepted the Agreement.
+
+Contributor: means a Licensee having made at least one Integrated
+Contribution.
+
+Licensor: means the Holder, or any other individual or legal entity, who
+distributes the Software under the Agreement.
+
+Integrated Contribution: means any or all modifications, corrections,
+translations, adaptations and/or new functions integrated into the
+Source Code by any or all Contributors.
+
+Related Module: means a set of sources files including their
+documentation that, without modification to the Source Code, enables
+supplementary functions or services in addition to those offered by the
+Software.
+
+Derivative Software: means any combination of the Software, modified or
+not, and of a Related Module.
+
+Parties: mean both the Licensee and the Licensor.
+
+These expressions may be used both in singular and plural form.
+
+
+    Article 2 - PURPOSE
+
+The purpose of the Agreement is the grant by the Licensor to the
+Licensee of a non-exclusive, transferable and worldwide license for the
+Software as set forth in Article 5 hereinafter for the whole term of the
+protection granted by the rights over said Software.
+
+
+    Article 3 - ACCEPTANCE
+
+3.1 The Licensee shall be deemed as having accepted the terms and
+conditions of this Agreement upon the occurrence of the first of the
+following events:
+
+    * (i) loading the Software by any or all means, notably, by
+      downloading from a remote server, or by loading from a physical
+      medium;
+    * (ii) the first time the Licensee exercises any of the rights
+      granted hereunder.
+
+3.2 One copy of the Agreement, containing a notice relating to the
+characteristics of the Software, to the limited warranty, and to the
+fact that its use is restricted to experienced users has been provided
+to the Licensee prior to its acceptance as set forth in Article 3.1
+hereinabove, and the Licensee hereby acknowledges that it has read and
+understood it.
+
+
+    Article 4 - EFFECTIVE DATE AND TERM
+
+
+      4.1 EFFECTIVE DATE
+
+The Agreement shall become effective on the date when it is accepted by
+the Licensee as set forth in Article 3.1.
+
+
+      4.2 TERM
+
+The Agreement shall remain in force for the entire legal term of
+protection of the economic rights over the Software.
+
+
+    Article 5 - SCOPE OF RIGHTS GRANTED
+
+The Licensor hereby grants to the Licensee, who accepts, the following
+rights over the Software for any or all use, and for the term of the
+Agreement, on the basis of the terms and conditions set forth hereinafter.
+
+Besides, if the Licensor owns or comes to own one or more patents
+protecting all or part of the functions of the Software or of its
+components, the Licensor undertakes not to enforce the rights granted by
+these patents against successive Licensees using, exploiting or
+modifying the Software. If these patents are transferred, the Licensor
+undertakes to have the transferees subscribe to the obligations set
+forth in this paragraph.
+
+
+      5.1 RIGHT OF USE
+
+The Licensee is authorized to use the Software, without any limitation
+as to its fields of application, with it being hereinafter specified
+that this comprises:
+
+   1. permanent or temporary reproduction of all or part of the Software
+      by any or all means and in any or all form.
+
+   2. loading, displaying, running, or storing the Software on any or
+      all medium.
+
+   3. entitlement to observe, study or test its operation so as to
+      determine the ideas and principles behind any or all constituent
+      elements of said Software. This shall apply when the Licensee
+      carries out any or all loading, displaying, running, transmission
+      or storage operation as regards the Software, that it is entitled
+      to carry out hereunder.
+
+
+      5.2 RIGHT OF MODIFICATION
+
+The right of modification includes the right to translate, adapt,
+arrange, or make any or all modifications to the Software, and the right
+to reproduce the resulting software. It includes, in particular, the
+right to create a Derivative Software.
+
+The Licensee is authorized to make any or all modification to the
+Software provided that it includes an explicit notice that it is the
+author of said modification and indicates the date of the creation thereof.
+
+
+      5.3 RIGHT OF DISTRIBUTION
+
+In particular, the right of distribution includes the right to publish,
+transmit and communicate the Software to the general public on any or
+all medium, and by any or all means, and the right to market, either in
+consideration of a fee, or free of charge, one or more copies of the
+Software by any means.
+
+The Licensee is further authorized to distribute copies of the modified
+or unmodified Software to third parties according to the terms and
+conditions set forth hereinafter.
+
+
+        5.3.1 DISTRIBUTION OF SOFTWARE WITHOUT MODIFICATION
+
+The Licensee is authorized to distribute true copies of the Software in
+Source Code or Object Code form, provided that said distribution
+complies with all the provisions of the Agreement and is accompanied by:
+
+   1. a copy of the Agreement,
+
+   2. a notice relating to the limitation of both the Licensor's
+      warranty and liability as set forth in Articles 8 and 9,
+
+and that, in the event that only the Object Code of the Software is
+redistributed, the Licensee allows effective access to the full Source
+Code of the Software at a minimum during the entire period of its
+distribution of the Software, it being understood that the additional
+cost of acquiring the Source Code shall not exceed the cost of
+transferring the data.
+
+
+        5.3.2 DISTRIBUTION OF MODIFIED SOFTWARE
+
+When the Licensee makes an Integrated Contribution to the Software, the
+terms and conditions for the distribution of the resulting Modified
+Software become subject to all the provisions of this Agreement.
+
+The Licensee is authorized to distribute the Modified Software, in
+source code or object code form, provided that said distribution
+complies with all the provisions of the Agreement and is accompanied by:
+
+   1. a copy of the Agreement,
+
+   2. a notice relating to the limitation of both the Licensor's
+      warranty and liability as set forth in Articles 8 and 9,
+
+and that, in the event that only the object code of the Modified
+Software is redistributed, the Licensee allows effective access to the
+full source code of the Modified Software at a minimum during the entire
+period of its distribution of the Modified Software, it being understood
+that the additional cost of acquiring the source code shall not exceed
+the cost of transferring the data.
+
+
+        5.3.3 DISTRIBUTION OF DERIVATIVE SOFTWARE
+
+When the Licensee creates Derivative Software, this Derivative Software
+may be distributed under a license agreement other than this Agreement,
+subject to compliance with the requirement to include a notice
+concerning the rights over the Software as defined in Article 6.4.
+In the event the creation of the Derivative Software required modification
+of the Source Code, the Licensee undertakes that:
+
+   1. the resulting Modified Software will be governed by this Agreement,
+   2. the Integrated Contributions in the resulting Modified Software
+      will be clearly identified and documented,
+   3. the Licensee will allow effective access to the source code of the
+      Modified Software, at a minimum during the entire period of
+      distribution of the Derivative Software, such that such
+      modifications may be carried over in a subsequent version of the
+      Software; it being understood that the additional cost of
+      purchasing the source code of the Modified Software shall not
+      exceed the cost of transferring the data.
+
+
+        5.3.4 COMPATIBILITY WITH THE CeCILL LICENSE
+
+When a Modified Software contains an Integrated Contribution subject to
+the CeCILL license agreement, or when a Derivative Software contains a
+Related Module subject to the CeCILL license agreement, the provisions
+set forth in the third item of Article 6.4 are optional.
+
+
+    Article 6 - INTELLECTUAL PROPERTY
+
+
+      6.1 OVER THE INITIAL SOFTWARE
+
+The Holder owns the economic rights over the Initial Software. Any or
+all use of the Initial Software is subject to compliance with the terms
+and conditions under which the Holder has elected to distribute its work
+and no one shall be entitled to modify the terms and conditions for the
+distribution of said Initial Software.
+
+The Holder undertakes that the Initial Software will remain ruled at
+least by this Agreement, for the duration set forth in Article 4.2.
+
+
+      6.2 OVER THE INTEGRATED CONTRIBUTIONS
+
+The Licensee who develops an Integrated Contribution is the owner of the
+intellectual property rights over this Contribution as defined by
+applicable law.
+
+
+      6.3 OVER THE RELATED MODULES
+
+The Licensee who develops a Related Module is the owner of the
+intellectual property rights over this Related Module as defined by
+applicable law and is free to choose the type of agreement that shall
+govern its distribution under the conditions defined in Article 5.3.3.
+
+
+      6.4 NOTICE OF RIGHTS
+
+The Licensee expressly undertakes:
+
+   1. not to remove, or modify, in any manner, the intellectual property
+      notices attached to the Software;
+
+   2. to reproduce said notices, in an identical manner, in the copies
+      of the Software modified or not;
+
+   3. to ensure that use of the Software, its intellectual property
+      notices and the fact that it is governed by the Agreement is
+      indicated in a text that is easily accessible, specifically from
+      the interface of any Derivative Software.
+
+The Licensee undertakes not to directly or indirectly infringe the
+intellectual property rights of the Holder and/or Contributors on the
+Software and to take, where applicable, vis-<2D>-vis its staff, any and all
+measures required to ensure respect of said intellectual property rights
+of the Holder and/or Contributors.
+
+
+    Article 7 - RELATED SERVICES
+
+7.1 Under no circumstances shall the Agreement oblige the Licensor to
+provide technical assistance or maintenance services for the Software.
+
+However, the Licensor is entitled to offer this type of services. The
+terms and conditions of such technical assistance, and/or such
+maintenance, shall be set forth in a separate instrument. Only the
+Licensor offering said maintenance and/or technical assistance services
+shall incur liability therefor.
+
+7.2 Similarly, any Licensor is entitled to offer to its licensees, under
+its sole responsibility, a warranty, that shall only be binding upon
+itself, for the redistribution of the Software and/or the Modified
+Software, under terms and conditions that it is free to decide. Said
+warranty, and the financial terms and conditions of its application,
+shall be subject of a separate instrument executed between the Licensor
+and the Licensee.
+
+
+    Article 8 - LIABILITY
+
+8.1 Subject to the provisions of Article 8.2, the Licensee shall be
+entitled to claim compensation for any direct loss it may have suffered
+from the Software as a result of a fault on the part of the relevant
+Licensor, subject to providing evidence thereof.
+
+8.2 The Licensor's liability is limited to the commitments made under
+this Agreement and shall not be incurred as a result of in particular:
+(i) loss due the Licensee's total or partial failure to fulfill its
+obligations, (ii) direct or consequential loss that is suffered by the
+Licensee due to the use or performance of the Software, and (iii) more
+generally, any consequential loss. In particular the Parties expressly
+agree that any or all pecuniary or business loss (i.e. loss of data,
+loss of profits, operating loss, loss of customers or orders,
+opportunity cost, any disturbance to business activities) or any or all
+legal proceedings instituted against the Licensee by a third party,
+shall constitute consequential loss and shall not provide entitlement to
+any or all compensation from the Licensor.
+
+
+    Article 9 - WARRANTY
+
+9.1 The Licensee acknowledges that the scientific and technical
+state-of-the-art when the Software was distributed did not enable all
+possible uses to be tested and verified, nor for the presence of
+possible defects to be detected. In this respect, the Licensee's
+attention has been drawn to the risks associated with loading, using,
+modifying and/or developing and reproducing the Software which are
+reserved for experienced users.
+
+The Licensee shall be responsible for verifying, by any or all means,
+the suitability of the product for its requirements, its good working
+order, and for ensuring that it shall not cause damage to either persons
+or properties.
+
+9.2 The Licensor hereby represents, in good faith, that it is entitled
+to grant all the rights over the Software (including in particular the
+rights set forth in Article 5).
+
+9.3 The Licensee acknowledges that the Software is supplied "as is" by
+the Licensor without any other express or tacit warranty, other than
+that provided for in Article 9.2 and, in particular, without any warranty
+as to its commercial value, its secured, safe, innovative or relevant
+nature.
+
+Specifically, the Licensor does not warrant that the Software is free
+from any error, that it will operate without interruption, that it will
+be compatible with the Licensee's own equipment and software
+configuration, nor that it will meet the Licensee's requirements.
+
+9.4 The Licensor does not either expressly or tacitly warrant that the
+Software does not infringe any third party intellectual property right
+relating to a patent, software or any other property right. Therefore,
+the Licensor disclaims any and all liability towards the Licensee
+arising out of any or all proceedings for infringement that may be
+instituted in respect of the use, modification and redistribution of the
+Software. Nevertheless, should such proceedings be instituted against
+the Licensee, the Licensor shall provide it with technical and legal
+assistance for its defense. Such technical and legal assistance shall be
+decided on a case-by-case basis between the relevant Licensor and the
+Licensee pursuant to a memorandum of understanding. The Licensor
+disclaims any and all liability as regards the Licensee's use of the
+name of the Software. No warranty is given as regards the existence of
+prior rights over the name of the Software or as regards the existence
+of a trademark.
+
+
+    Article 10 - TERMINATION
+
+10.1 In the event of a breach by the Licensee of its obligations
+hereunder, the Licensor may automatically terminate this Agreement
+thirty (30) days after notice has been sent to the Licensee and has
+remained ineffective.
+
+10.2 A Licensee whose Agreement is terminated shall no longer be
+authorized to use, modify or distribute the Software. However, any
+licenses that it may have granted prior to termination of the Agreement
+shall remain valid subject to their having been granted in compliance
+with the terms and conditions hereof.
+
+
+    Article 11 - MISCELLANEOUS
+
+
+      11.1 EXCUSABLE EVENTS
+
+Neither Party shall be liable for any or all delay, or failure to
+perform the Agreement, that may be attributable to an event of force
+majeure, an act of God or an outside cause, such as defective
+functioning or interruptions of the electricity or telecommunications
+networks, network paralysis following a virus attack, intervention by
+government authorities, natural disasters, water damage, earthquakes,
+fire, explosions, strikes and labor unrest, war, etc.
+
+11.2 Any failure by either Party, on one or more occasions, to invoke
+one or more of the provisions hereof, shall under no circumstances be
+interpreted as being a waiver by the interested Party of its right to
+invoke said provision(s) subsequently.
+
+11.3 The Agreement cancels and replaces any or all previous agreements,
+whether written or oral, between the Parties and having the same
+purpose, and constitutes the entirety of the agreement between said
+Parties concerning said purpose. No supplement or modification to the
+terms and conditions hereof shall be effective as between the Parties
+unless it is made in writing and signed by their duly authorized
+representatives.
+
+11.4 In the event that one or more of the provisions hereof were to
+conflict with a current or future applicable act or legislative text,
+said act or legislative text shall prevail, and the Parties shall make
+the necessary amendments so as to comply with said act or legislative
+text. All other provisions shall remain effective. Similarly, invalidity
+of a provision of the Agreement, for any reason whatsoever, shall not
+cause the Agreement as a whole to be invalid.
+
+
+      11.5 LANGUAGE
+
+The Agreement is drafted in both French and English and both versions
+are deemed authentic.
+
+
+    Article 12 - NEW VERSIONS OF THE AGREEMENT
+
+12.1 Any person is authorized to duplicate and distribute copies of this
+Agreement.
+
+12.2 So as to ensure coherence, the wording of this Agreement is
+protected and may only be modified by the authors of the License, who
+reserve the right to periodically publish updates or new versions of the
+Agreement, each with a separate number. These subsequent versions may
+address new issues encountered by Free Software.
+
+12.3 Any Software distributed under a given version of the Agreement may
+only be subsequently distributed under the same version of the Agreement
+or a subsequent version.
+
+
+    Article 13 - GOVERNING LAW AND JURISDICTION
+
+13.1 The Agreement is governed by French law. The Parties agree to
+endeavor to seek an amicable solution to any disagreements or disputes
+that may arise during the performance of the Agreement.
+
+13.2 Failing an amicable solution within two (2) months as from their
+occurrence, and unless emergency proceedings are necessary, the
+disagreements or disputes shall be referred to the Paris Courts having
+jurisdiction, by the more diligent Party.
+
+
+Version 1.0 dated 2006-09-05.

etc/tools/ParaView4Functions

@@ -1,487 +0,0 @@
-#---------------------------------*- sh -*-------------------------------------
-# =========                 |
-# \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
-#  \\    /   O peration     |
-#   \\  /    A nd           | Copyright (C) 2011-2015 OpenFOAM Foundation
-#    \\/     M anipulation  |
-#------------------------------------------------------------------------------
-# License
-#     This file is part of OpenFOAM.
-#
-#     OpenFOAM is free software: you can redistribute it and/or modify it
-#     under the terms of the GNU General Public License as published by
-#     the Free Software Foundation, either version 3 of the License, or
-#     (at your option) any later version.
-#
-#     OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
-#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-#     FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
-#     for more details.
-#
-#     You should have received a copy of the GNU General Public License
-#     along with OpenFOAM.  If not, see <http://www.gnu.org/licenses/>.
-#
-# File
-#     etc/tools/ParaViewFunctions
-#
-# Description
-#     ParaView make/install helper functions
-#
-#------------------------------------------------------------------------------
-
-# buildBASE, installBASE defined from tools/ThirdPartyFunctions
-
-#
-# where things are or should be put
-#   ParaView_VERSION and ParaView_MAJOR should already have been set
-#
-#   ParaView_SOURCE_DIR : location of the original sources
-#   ParaView_BINARY_DIR : location of the build
-#   ParaView_DIR        : location of the installed program
-#
-setDirs()
-{
-    ParaView_SOURCE_DIR=$WM_THIRD_PARTY_DIR/ParaView-$ParaView_VERSION
-
-    [ -d "$ParaView_SOURCE_DIR" ] || {
-        echo "did not find ParaView-$ParaView_VERSION in these directories:"
-        echo "  WM_THIRD_PARTY_DIR=$WM_THIRD_PARTY_DIR"
-        echo
-        echo "abort build"
-        exit 1
-    }
-
-    # ParaView_BINARY_DIR=$buildBASE/ParaView-$ParaView_VERSION-$OBJ_ADD
-    ParaView_BINARY_DIR=$buildBASE/ParaView-$ParaView_VERSION
-
-    # ParaView_DIR=$installBASE/ParaView-$ParaView_VERSION-$OBJ_ADD
-    ParaView_DIR=$installBASE/ParaView-$ParaView_VERSION
-
-    export ParaView_SOURCE_DIR ParaView_BINARY_DIR ParaView_DIR
-
-    echo
-    echo "ParaView_SOURCE_DIR=$ParaView_SOURCE_DIR"
-    echo "ParaView_BINARY_DIR=$ParaView_BINARY_DIR"
-    echo "ParaView_DIR=$ParaView_DIR"
-}
-
-
-#
-# set ParaView_VERSION and adjust ParaView_MAJOR accordingly
-#
-setVersion()
-{
-    [ "$#" -ge 1 ] && ParaView_VERSION="${1##paraview-}"
-
-    # the major version is "<digits>.<digits>"
-    ParaView_MAJOR=$(echo $ParaView_VERSION | \
-        sed -e 's/^\([0-9][0-9]*\.[0-9][0-9]*\).*$/\1/')
-
-    export ParaView_VERSION ParaView_MAJOR
-}
-
-
-#------------------------------------------------------------------------------
-
-#
-# extract and echo date stamp information from
-#     VTK/Utilities/kwsys/kwsysDateStamp.cmake
-# since the order of the entries is already correct, can use simple sed script
-#
-echoDateStamp()
-{
-    (
-        set -- $(
-            sed -ne 's/^SET(KWSYS_DATE_STAMP_[A-Z]*\([ 0-9]*\)).*$/\1/p' \
-            $ParaView_SOURCE_DIR/VTK/Utilities/kwsys/kwsysDateStamp.cmake
-        )
-
-        IFS='-'
-        echo "date-stamp: $*"
-    )
-}
-
-
-#
-# extract version information from
-#     CMakeLists.txt
-# since the order of the entries is already correct, can use simple sed script
-#
-getVersion()
-{
-    (
-        set -- $(
-            sed -ne 's/^SET(PARAVIEW_VERSION_[A-Z]*\([ 0-9]*\)).*$/\1/p' \
-            $ParaView_SOURCE_DIR/CMakeLists.txt
-        )
-
-        IFS='.'
-        echo "$*"
-    )
-}
-
-#
-# compare version information
-#
-checkVersion()
-{
-    local ver=$(getVersion)
-    if [ "$ParaView_VERSION" != "$ver" ]
-    then
-        echo "MISMATCH!"
-        echo "    specified $ParaView_VERSION"
-        echo "    found     $ver"
-    fi
-}
-
-#
-# set CMake cache variables
-#
-addCMakeVariable()
-{
-    while [ -n "$1" ]
-    do
-        CMAKE_VARIABLES="$CMAKE_VARIABLES -D$1"
-        shift
-    done
-}
-
-
-#
-# verbose makefiles
-#
-addVerbosity()
-{
-    [ "$withVERBOSE" = true ] && addCMakeVariable  "CMAKE_VERBOSE_MAKEFILE=TRUE"
-}
-
-
-#
-# define options for mpi support
-#
-addMpiSupport()
-{
-    [ "${withMPI:=false}" = true ] || return
-    OBJ_ADD="$OBJ_ADD-mpi"
-
-    addCMakeVariable  "PARAVIEW_USE_MPI=ON VTK_USE_MPI=ON"
-    addCMakeVariable  "VTK_MPI_MAX_NUMPROCS=$MPI_MAX_PROCS"
-}
-
-
-#
-# define options for python support
-#
-addPythonSupport()
-{
-    [ "${withPYTHON:=false}" = true ] || return
-    OBJ_ADD="$OBJ_ADD-py"
-
-    if pythonBin=$(which python 2>/dev/null)
-    then
-        if [ -n "$PYTHON_LIBRARY" ]
-        then
-            # check $PYTHON_LIBRARY if it has been set
-            if [ ! -e "$PYTHON_LIBRARY" ]
-            then
-                echo "*** Error: libpython not found at location specified " \
-                     "by -pythnon-lib input: PYTHON_LIBRARY=$PYTHON_LIBRARY"
-            fi
-        else
-            # Try to get $PYTHON_LIBRARY from dynamically linked binary
-            PYTHON_LIBRARY=$(ldd $pythonBin | \
-                sed -ne '/libpython/s/.* => \(.*\) (.*/\1/p')
-
-           [ -e "$PYTHON_LIBRARY" ] || {
-               echo "*** Error: Unable to determine path to python library."
-           }
-        fi
-
-        [ -e "$PYTHON_LIBRARY" ] || {
-            echo "    Please set the full path to the python library "
-            echo "    (including libpython) using the -python-lib option, "
-            echo "    or deactivate python support by not using the -python "
-            echo "    option"
-            exit 1
-        }
-
-        pythonMajor=$(echo $PYTHON_LIBRARY | sed 's/.*libpython\(.*\)\.so.*/\1/')
-        pythonInclude=/usr/include/python$pythonMajor
-
-        # note - we could also allow for a PYTHON_INCLUDE variable ...
-        [ -d "$pythonInclude" ] || {
-            echo "    No python headers found in $pythonInclude/"
-            echo "    Please install python headers or deactivate "
-            echo "    python support by not using the -python option"
-            exit 1
-        }
-
-        addCMakeVariable  "PARAVIEW_ENABLE_PYTHON=ON"
-        addCMakeVariable  "PYTHON_INCLUDE_PATH=$pythonInclude"
-        addCMakeVariable  "PYTHON_LIBRARY=$PYTHON_LIBRARY"
-
-        echo "----"
-        echo "Python information:"
-        echo "    executable     : $pythonBin"
-        echo "    version        : $pythonMajor"
-        echo "    include path   : $pythonInclude"
-        echo "    library        : $PYTHON_LIBRARY"
-
-        unset pythonBin pythonInclude pythonMajor
-    else
-        echo "*** Error: python not found"
-        echo "***        Deactivate python support by not using the -python "
-        echo "***        option"
-        exit 1
-    fi
-}
-
-
-#
-# define options for mesa support
-#
-addMesaSupport()
-{
-    [ "${withMESA:=false}" = true ] || return
-
-    if [ -d "$MESA_INCLUDE" -a -f "$MESA_LIBRARY" ]
-    then
-        OBJ_ADD="$OBJ_ADD-mesa"
-
-        addCMakeVariable  "VTK_OPENGL_HAS_OSMESA=ON"
-        addCMakeVariable  "OSMESA_INCLUDE_DIR=$MESA_INCLUDE"
-        addCMakeVariable  "OSMESA_LIBRARY=$MESA_LIBRARY"
-
-    else
-       echo "*** Error: no MESA information found"
-       echo "***        Deactivate MESA support by not using the -mesa option, "
-       echo "***        or set the correct paths for:"
-       echo "***        -mesa-include ($MESA_INCLUDE)"
-       echo "***        -mesa-lib ($MESA_LIBRARY)"
-       exit 1
-    fi
-}
-
-
-addQtSupport()
-{
-    QtVersion=none
-    [ "${withQT:=false}" = true ] || return
-
-    addCMakeVariable "PARAVIEW_BUILD_QT_GUI=ON"
-
-    unset qmakeExe
-    if [ -n "$QMAKE_PATH" ]
-    then
-        if [ -d "$QMAKE_PATH" ]
-        then
-            if [ -x "$QMAKE_PATH/qmake" ]
-            then
-                qmakeExe=$QMAKE_PATH/qmake
-            elif [ -x "$QMAKE_PATH/bin/qmake" ]
-            then
-                qmakeExe=$QMAKE_PATH/bin/qmake
-            fi
-        elif [ -x "$QMAKE_PATH" ]
-        then
-            qmakeExe=$QMAKE_PATH
-        fi
-
-        if [ -n "$qmakeExe" ]
-        then
-            # use absolute path
-            if [ "${qmakeExe#/}" = "$qmakeExe" ]
-            then
-                qmakeExe="$(cd ${qmakeExe%/qmake} 2>/dev/null && pwd)/qmake"
-            fi
-        else
-            echo
-            echo "qmake not found under specified QMAKE_PATH"
-            echo "    QMAKE_PATH=$QMAKE_PATH"
-            echo "leaving unspecified"
-            echo
-        fi
-    fi
-
-    # default to using qmake from the path
-    if [ -n "$qmakeExe" ]
-    then
-        addCMakeVariable "QT_QMAKE_EXECUTABLE:FILEPATH=$qmakeExe"
-    else
-        qmakeExe=qmake
-    fi
-
-
-    # Check qmake can be found
-    if type $qmakeExe >/dev/null 2>&1
-    then
-        # Check the Qt version selected
-        # parse -> "Using Qt version X.Y.Z in ..."
-        QtVersion=$($qmakeExe -query QT_VERSION)
-
-        # split Major.Minor.Revision - could also use IFS hacking
-        set -- $(echo "$QtVersion" | sed -e 's/\./ /g')
-
-        QtMajor=$1
-        QtMinor=$2
-
-        if [ $QtMajor -lt 4 ] || [ $QtMajor -eq 4 -a $QtMinor -lt 5 ]
-        then
-            echo "*** Error: Qt version provided < 4.5"
-            echo "***     Please use the -qmake option to specify the location of a version of Qt >= 4.5 "
-            echo "***     e.g."
-            echo "***         -qmake /usr/local/qt-4.6.2/bin/qmake"
-            echo "***         -qmake $installBASE/qt-4.6.2/bin/qmake"
-            exit 1
-        fi
-    else
-        echo "*** Error: cannot find qmake either at \$QMAKE_PATH or in current \$PATH"
-        exit 1
-    fi
-}
-
-
-#
-# configure via cmake, but don't actually build anything
-#
-configParaView()
-{
-    unset cmakeExe
-    if [ -n "$CMAKE_PATH" ]
-    then
-        if [ -d "$CMAKE_PATH" ]
-        then
-            if [ -x "$CMAKE_PATH/cmake" ]
-            then
-                cmakeExe=$CMAKE_PATH/cmake
-            elif [ -x "$CMAKE_PATH/bin/cmake" ]
-            then
-                cmakeExe=$CMAKE_PATH/bin/cmake
-            fi
-        elif [ -x "$CMAKE_PATH" ]
-        then
-            cmakeExe=$CMAKE_PATH
-        fi
-
-        if [ -n "$cmakeExe" ]
-        then
-            # use absolute path
-            if [ "${cmakeExe#/}" = "$cmakeExe" ]
-            then
-                cmakeExe="$(cd ${cmakeExe%/cmake} 2>/dev/null && pwd)/cmake"
-            fi
-        else
-            echo
-            echo "cmake not found under specified CMAKE_PATH"
-            echo "    CMAKE_PATH=$CMAKE_PATH"
-            echo "leaving unspecified"
-            echo
-        fi
-    fi
-
-    # default to using cmake from the path
-    [ -n "$cmakeExe" ] || cmakeExe=cmake
-
-    # remove any existing build folder and recreate
-    if [ -d $ParaView_BINARY_DIR ]
-    then
-        echo "removing old build directory"
-        echo "    $ParaView_BINARY_DIR"
-        rm -rf $ParaView_BINARY_DIR
-    fi
-    mkdir -p $ParaView_BINARY_DIR
-
-    addCMakeVariable  "CMAKE_BUILD_TYPE:STRING=$buildType"
-
-    cd $ParaView_BINARY_DIR || exit 1  # change to build folder
-
-    echo "----"
-    echo "Configuring paraview-$ParaView_VERSION (major version: $ParaView_MAJOR)"
-    echo "    MPI    support : ${withMPI:-false}"
-    echo "    Python support : ${withPYTHON:-false}"
-    echo "    MESA   support : ${withMESA:-false}"
-    echo "    Qt dev support : ${withQT:-false}"
-    echo "    Source         : $ParaView_SOURCE_DIR"
-    echo "    Build          : $ParaView_BINARY_DIR"
-    echo "    Target         : $ParaView_DIR"
-    echo "    Build type     : $buildType"
-    echo "----"
-    echo
-    echo "$cmakeExe" \
-        -DCMAKE_INSTALL_PREFIX:PATH=$ParaView_DIR \
-        $CMAKE_VARIABLES \
-        $ParaView_SOURCE_DIR
-    echo
-    echo "----"
-    echo
-
-    # run cmake to create Makefiles
-    $cmakeExe \
-        -DCMAKE_INSTALL_PREFIX:PATH=$ParaView_DIR \
-        $CMAKE_VARIABLES \
-        $ParaView_SOURCE_DIR
-}
-
-
-#
-# invoke make
-# also link bin/ to lib/paraview-* for development without installation
-#
-makeParaView()
-{
-    cd $ParaView_BINARY_DIR || exit 1  # change to build folder
-    echo "    Starting make"
-    time make -j $WM_NCOMPPROCS
-    echo "    Done make"
-
-    # remove lib if it is a link
-    # (how this was previously handled before 'make install' worked)
-    [ -L lib ] && rm lib 2>/dev/null
-}
-
-
-#
-# install the program
-#
-installParaView()
-{
-    cd $ParaView_BINARY_DIR || exit 1  # change to build folder
-    echo "    Installing ParaView to $ParaView_DIR"
-
-    make install
-
-cat<< INFO
-    ---
-    Installation complete for paraview-$ParaView_VERSION
-    Set environment variables:
-
-        export ParaView_DIR=$ParaView_DIR
-        export PATH=\$ParaView_DIR/bin:\$PATH
-        export PV_PLUGIN_PATH=\$FOAM_LIBBIN/paraview-$ParaView_MAJOR
-    ---
-INFO
-}
-
-
-#------------------------------------------------------------------------------
-
-# clear the referenced variables before using any of the functions
-unset withMPI  withVERBOSE
-unset withQT      QMAKE_PATH
-unset withMESA    MESA_INCLUDE    MESA_LIBRARY
-unset withPYTHON  PYTHON_INCLUDE  PYTHON_LIBRARY
-unset CMAKE_VARIABLES
-unset OBJ_ADD
-unset buildType
-
-# start with these general settings
-addCMakeVariable  "BUILD_SHARED_LIBS:BOOL=ON  VTK_USE_RPATH:BOOL=OFF"
-
-# include development files in "make install"
-addCMakeVariable  "PARAVIEW_INSTALL_DEVELOPMENT_FILES:BOOL=ON"
-
-# don't build test tree
-addCMakeVariable  "BUILD_TESTING:BOOL=OFF"
-
-
-# ----------------------------------------------------------------- end-of-file

etc/tools/ParaViewFunctions

@@ -2,7 +2,7 @@
 # =========                 |
 # \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
 #  \\    /   O peration     |
-#   \\  /    A nd           | Copyright (C) 2011-2015 OpenFOAM Foundation
+#   \\  /    A nd           | Copyright (C) 2011-2017 OpenFOAM Foundation
 #    \\/     M anipulation  |
 #------------------------------------------------------------------------------
 # License
@@ -32,7 +32,7 @@
 # buildBASE, installBASE defined from tools/ThirdPartyFunctions
 
 #
-# where things are or should be put
+# Where things are or should be put
 #   ParaView_VERSION and ParaView_MAJOR should already have been set
 #
 #   ParaView_SOURCE_DIR : location of the original sources
@@ -63,17 +63,23 @@ setDirs()
     echo "ParaView_SOURCE_DIR=$ParaView_SOURCE_DIR"
     echo "ParaView_BINARY_DIR=$ParaView_BINARY_DIR"
     echo "ParaView_DIR=$ParaView_DIR"
+
+    # Forcefully override the .git path for the ParaView source code directory
+    export GIT_DIR=$ParaView_SOURCE_DIR/.git
 }
 
 
 #
-# set ParaView_VERSION and adjust ParaView_MAJOR accordingly
+# Set ParaView_VERSION and adjust ParaView_MAJOR accordingly
 #
 setVersion()
 {
-    [ "$#" -ge 1 ] && ParaView_VERSION="${1##paraview-}"
+    if [ "$#" -ge 1 ]
+    then
+        ParaView_VERSION="${1##paraview-}"
+    fi
 
-    # the major version is "<digits>.<digits>"
+    # The major version is "<digits>.<digits>"
     ParaView_MAJOR=$(echo $ParaView_VERSION | \
         sed -e 's/^\([0-9][0-9]*\.[0-9][0-9]*\).*$/\1/')
 
@@ -84,7 +90,35 @@ setVersion()
 #------------------------------------------------------------------------------
 
 #
-# extract and echo date stamp information from
+# ParaView 5.0.1 required patches to sources to compile the OpenFOAM reader
+# module. The reader module compiles with ParaView 5.4.0 compiles without
+# changes.  So for ParaView versions beyond 5.0.1, we are downloading sources
+# directly using the following function
+#
+downloadParaView()
+{
+    # return if ParaView_VERSION=5.0.1 or older
+    [ "$(printf "5.0.1\n%s" \
+        "$ParaView_VERSION" | sort -V | tail -n1)" = "5.0.1" ] && \
+        echo "Not downloading ParaView (version <= 5.0.1)..." && \
+        return 0
+
+    # return if already downloaded
+    _dir="ParaView-${ParaView_VERSION}"
+    [ -d "$_dir" ] &&  echo "$_dir exists.  Not downloading..." && return 0
+
+    echo "Downloading $_dir"
+    _pack="ParaView-v${ParaView_VERSION}"
+    curl "https://www.paraview.org/files/v${ParaView_MAJOR}/${_pack}.tar.gz" | \
+        tar xz 2> /dev/null
+
+    # Testing successful download because ParaView repository is unreliable
+    [ "$?" -ne 0 ] && echo "Download unsuccessful" && return 1
+    mv "$_pack" "$_dir" && return 0
+}
+
+#
+# Extract and echo date stamp information from
 #     VTK/Utilities/kwsys/kwsysDateStamp.cmake
 # since the order of the entries is already correct, can use simple sed script
 #
@@ -101,9 +135,8 @@ echoDateStamp()
     )
 }
 
-
 #
-# extract version information from
+# Extract version information from
 #     CMakeLists.txt
 # since the order of the entries is already correct, can use simple sed script
 #
@@ -121,7 +154,7 @@ getVersion()
 }
 
 #
-# compare version information
+# Compare version information
 #
 checkVersion()
 {
@@ -135,33 +168,38 @@ checkVersion()
 }
 
 #
-# set CMake cache variables
+# Set CMake cache variables
 #
 addCMakeVariable()
 {
-    while [ -n "$1" ]
+    for var in $*
     do
-        CMAKE_VARIABLES="$CMAKE_VARIABLES -D$1"
-        shift
+	CMAKE_VARIABLES="$CMAKE_VARIABLES -D$var"
     done
 }
 
-
 #
-# verbose makefiles
+# Verbose makefiles
 #
 addVerbosity()
 {
-    [ "$withVERBOSE" = true ] && addCMakeVariable  "CMAKE_VERBOSE_MAKEFILE=TRUE"
+    if [ "${withVERBOSE:=false}" = true ]
+    then
+        addCMakeVariable  "CMAKE_VERBOSE_MAKEFILE=TRUE"
+    fi
 }
 
 
 #
-# define options for mpi support
+# Define options for mpi support
 #
 addMpiSupport()
 {
-    [ "${withMPI:=false}" = true ] || return
+    if [ "${withMPI:=false}" != true ]
+    then
+        return
+    fi
+
     OBJ_ADD="$OBJ_ADD-mpi"
 
     addCMakeVariable  "PARAVIEW_USE_MPI=ON VTK_USE_MPI=ON"
@@ -170,18 +208,22 @@ addMpiSupport()
 
 
 #
-# define options for python support
+# Define options for python support
 #
 addPythonSupport()
 {
-    [ "${withPYTHON:=false}" = true ] || return
+    if [ "${withPYTHON:=false}" != true ]
+    then
+        return
+    fi
+
     OBJ_ADD="$OBJ_ADD-py"
 
     if pythonBin=$(which python 2>/dev/null)
     then
         if [ -n "$PYTHON_LIBRARY" ]
         then
-            # check $PYTHON_LIBRARY if it has been set
+            # Check $PYTHON_LIBRARY if it has been set
             if [ ! -e "$PYTHON_LIBRARY" ]
             then
                 echo "*** Error: libpython not found at location specified " \
@@ -208,7 +250,7 @@ addPythonSupport()
         pythonMajor=$(echo $PYTHON_LIBRARY | sed 's/.*libpython\(.*\)\.so.*/\1/')
         pythonInclude=/usr/include/python$pythonMajor
 
-        # note - we could also allow for a PYTHON_INCLUDE variable ...
+        # Note - we could also allow for a PYTHON_INCLUDE variable ...
         [ -d "$pythonInclude" ] || {
             echo "    No python headers found in $pythonInclude/"
             echo "    Please install python headers or deactivate "
@@ -238,11 +280,14 @@ addPythonSupport()
 
 
 #
-# define options for mesa support
+# Define options for mesa support
 #
 addMesaSupport()
 {
-    [ "${withMESA:=false}" = true ] || return
+    if [ "${withMESA:=false}" != true ]
+    then
+       return
+    fi
 
     if [ -d "$MESA_INCLUDE" -a -f "$MESA_LIBRARY" ]
     then
@@ -266,7 +311,11 @@ addMesaSupport()
 addQtSupport()
 {
     QtVersion=none
-    [ "${withQT:=false}" = true ] || return
+
+    if [ "${withQT:=false}" != true ]
+    then
+        return
+    fi
 
     addCMakeVariable "PARAVIEW_BUILD_QT_GUI=ON"
 
@@ -289,7 +338,7 @@ addQtSupport()
 
         if [ -n "$qmakeExe" ]
         then
-            # use absolute path
+            # Use absolute path
             if [ "${qmakeExe#/}" = "$qmakeExe" ]
             then
                 qmakeExe="$(cd ${qmakeExe%/qmake} 2>/dev/null && pwd)/qmake"
@@ -303,7 +352,7 @@ addQtSupport()
         fi
     fi
 
-    # default to using qmake from the path
+    # Default to using qmake from the path
     if [ -n "$qmakeExe" ]
     then
         addCMakeVariable "QT_QMAKE_EXECUTABLE:FILEPATH=$qmakeExe"
@@ -319,16 +368,16 @@ addQtSupport()
         # parse -> "Using Qt version X.Y.Z in ..."
         QtVersion=$($qmakeExe -query QT_VERSION)
 
-        # split Major.Minor.Revision - could also use IFS hacking
+        # Split Major.Minor.Revision - could also use IFS hacking
         set -- $(echo "$QtVersion" | sed -e 's/\./ /g')
 
         QtMajor=$1
         QtMinor=$2
 
-        if [[ ($QtMajor -lt 4) || ($QtMajor -eq 4  && $QtMinor -lt 5) ]]
+        if [ $QtMajor -lt 4 -o $QtMajor -eq 4 -a $QtMinor -lt 5 ]
         then
             echo "*** Error: Qt version provided < 4.5"
-            echo "***     Please use the -qmake option to specify the location of a version of Qt >= 4.5 "
+            echo "***     Please use the -qmake option to specify the location of a version of Qt >= 4.5"
             echo "***     e.g."
             echo "***         -qmake /usr/local/qt-4.6.2/bin/qmake"
             echo "***         -qmake $installBASE/qt-4.6.2/bin/qmake"
@@ -342,7 +391,7 @@ addQtSupport()
 
 
 #
-# configure via cmake, but don't actually build anything
+# Configure via cmake, but don't actually build anything
 #
 configParaView()
 {
@@ -365,7 +414,7 @@ configParaView()
 
         if [ -n "$cmakeExe" ]
         then
-            # use absolute path
+            # Use absolute path
             if [ "${cmakeExe#/}" = "$cmakeExe" ]
             then
                 cmakeExe="$(cd ${cmakeExe%/cmake} 2>/dev/null && pwd)/cmake"
@@ -379,10 +428,13 @@ configParaView()
         fi
     fi
 
-    # default to using cmake from the path
-    [ -n "$cmakeExe" ] || cmakeExe=cmake
+    # Default to using cmake from the path
+    if [ -z "$cmakeExe" ]
+    then
+        cmakeExe=cmake
+    fi
 
-    # remove any existing build folder and recreate
+    # Remove any existing build folder and recreate
     if [ -d $ParaView_BINARY_DIR ]
     then
         echo "removing old build directory"
@@ -391,7 +443,9 @@ configParaView()
     fi
     mkdir -p $ParaView_BINARY_DIR
 
-    cd $ParaView_BINARY_DIR || exit 1  # change to build folder
+    addCMakeVariable  "CMAKE_BUILD_TYPE:STRING=$buildType"
+
+    cd $ParaView_BINARY_DIR || exit 1  # Change to build folder
 
     echo "----"
     echo "Configuring paraview-$ParaView_VERSION (major version: $ParaView_MAJOR)"
@@ -402,6 +456,7 @@ configParaView()
     echo "    Source         : $ParaView_SOURCE_DIR"
     echo "    Build          : $ParaView_BINARY_DIR"
     echo "    Target         : $ParaView_DIR"
+    echo "    Build type     : $buildType"
     echo "----"
     echo
     echo "$cmakeExe" \
@@ -412,7 +467,7 @@ configParaView()
     echo "----"
     echo
 
-    # run cmake to create Makefiles
+    # Run cmake to create Makefiles
     $cmakeExe \
         -DCMAKE_INSTALL_PREFIX:PATH=$ParaView_DIR \
         $CMAKE_VARIABLES \
@@ -421,53 +476,40 @@ configParaView()
 
 
 #
-# invoke make
+# Invoke make
 # also link bin/ to lib/paraview-* for development without installation
 #
 makeParaView()
 {
-    cd $ParaView_BINARY_DIR || exit 1  # change to build folder
+    cd $ParaView_BINARY_DIR || exit 1  # Change to build folder
     echo "    Starting make"
     time make -j $WM_NCOMPPROCS
     echo "    Done make"
 
-    # remove lib if it is a link
+    # Remove lib if it is a link
     # (how this was previously handled before 'make install' worked)
-    [ -L lib ] && rm lib 2>/dev/null
+    if [ -L lib ]
+    then
+        rm lib 2>/dev/null
+    fi
 }
 
 
 #
-# install the program
+# Install the program
 #
 installParaView()
 {
-    cd $ParaView_BINARY_DIR || exit 1  # change to build folder
+    cd $ParaView_BINARY_DIR || exit 1  # Change to build folder
     echo "    Installing ParaView to $ParaView_DIR"
 
     make install
 
-# hack for missing files after install of version 3.14.1
-    echo "Copying missing files to install folder"
-    CMAKE_SRC_DIR=$ParaView_SOURCE_DIR/CMake
-    CMAKE_INSTALL_DIR=$ParaView_DIR/lib/paraview-$ParaView_MAJOR/CMake
-    cp -f $ParaView_SOURCE_DIR/ParaViewUse.cmake $CMAKE_INSTALL_DIR
-    cp -f $CMAKE_SRC_DIR/generate_proxydocumentation.cmake $CMAKE_INSTALL_DIR
-    cp -f $CMAKE_SRC_DIR/smxml_to_xml.xsl $CMAKE_INSTALL_DIR
-    cp -f $CMAKE_SRC_DIR/xml_to_html.xsl $CMAKE_INSTALL_DIR
-    cp -f $CMAKE_SRC_DIR/xml_to_wiki.xsl.in $CMAKE_INSTALL_DIR
-    cp -f $CMAKE_SRC_DIR/generate_qhp.cmake $CMAKE_INSTALL_DIR
-    unset CMAKE_SRC_DIR CMAKE_INSTALL_DIR
-# --- end hack
-
 cat<< INFO
     ---
     Installation complete for paraview-$ParaView_VERSION
-    Set environment variables:
-
-        export ParaView_DIR=$ParaView_DIR
-        export PATH=\$ParaView_DIR/bin:\$PATH
-        export PV_PLUGIN_PATH=\$FOAM_LIBBIN/paraview-$ParaView_MAJOR
+    Now update the environment by running:
+        wmRefresh
     ---
 INFO
 }
@@ -475,27 +517,26 @@ INFO
 
 #------------------------------------------------------------------------------
 
-# clear the referenced variables before using any of the functions
-unset withMPI  withVERBOSE
-unset withQT      QMAKE_PATH
-unset withMESA    MESA_INCLUDE    MESA_LIBRARY
-unset withPYTHON  PYTHON_INCLUDE  PYTHON_LIBRARY
+# Clear the referenced variables before using any of the functions
+unset withMPI withVERBOSE
+unset withQT QMAKE_PATH
+unset withMESA MESA_INCLUDE MESA_LIBRARY
+unset withPYTHON PYTHON_INCLUDE PYTHON_LIBRARY
 unset CMAKE_VARIABLES
 unset OBJ_ADD
+unset buildType
 
-
-# start with these general settings
-addCMakeVariable  "VTK_USE_TK:BOOL=OFF"
+# Start with these general settings
 addCMakeVariable  "BUILD_SHARED_LIBS:BOOL=ON  VTK_USE_RPATH:BOOL=OFF"
-addCMakeVariable  "CMAKE_BUILD_TYPE:STRING=Release"
 
-# include development files in "make install"
-addCMakeVariable  "PARAVIEW_INSTALL_DEVELOPMENT:BOOL=ON"
+# Choose the new rendering engine
+addCMakeVariable  "VTK_RENDERING_BACKEND=OpenGL2"
 
-# don't build test tree
+# Include development files in "make install"
+addCMakeVariable  "PARAVIEW_INSTALL_DEVELOPMENT_FILES:BOOL=ON"
+
+# Don't build test tree
 addCMakeVariable  "BUILD_TESTING:BOOL=OFF"
 
-# remove dependency on WebKit
-# addCMakeVariable  VTK_QT_USE_WEBKIT:BOOL=OFF
 
-# ----------------------------------------------------------------- end-of-file
+#------------------------------------------------------------------------------

etc/tools/ThirdPartyFunctions

@@ -2,7 +2,7 @@
 # =========                 |
 # \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
 #  \\    /   O peration     |
-#   \\  /    A nd           | Copyright (C) 2011 OpenFOAM Foundation
+#   \\  /    A nd           | Copyright (C) 2011-2016 OpenFOAM Foundation
 #    \\/     M anipulation  |
 #------------------------------------------------------------------------------
 # License
@@ -31,12 +31,13 @@
 #     Define WM_NCOMPPROCS always.
 #------------------------------------------------------------------------------
 
-# define the normal build and prefix directories
+# Define the normal build and prefix directories
 buildBASE=$WM_THIRD_PARTY_DIR/build/$WM_ARCH$WM_COMPILER
 installBASE=$WM_THIRD_PARTY_DIR/platforms/$WM_ARCH$WM_COMPILER
 
+
 #
-# mostly building without wmake
+# Mostly building without wmake
 # - disable wmakeScheduler variables
 # - restrict WM_NCOMPPROCS to local number of cores
 #
@@ -53,7 +54,16 @@ fi
 
 
 #
-# download file $1 from url $2 into download/ directory
+# If WM_CONTINUE_ON_ERROR not set activate the shell option "stop on error"
+#
+if [ -z "${WM_CONTINUE_ON_ERROR}" ]
+then
+    set -e
+fi
+
+
+#
+# Download file $1 from url $2 into download/ directory
 #
 downloadFile()
 {
@@ -75,7 +85,7 @@ downloadFile()
 
 
 #
-# copy Make/{files,options} from wmakeFiles/PACKAGE
+# Copy Make/{files,options} from wmakeFiles/PACKAGE
 #
 # $1 = PACKAGE
 # $2 (optional) TARGET DIRECTORY
@@ -119,4 +129,4 @@ cpMakeFiles()
 }
 
 
-# ----------------------------------------------------------------- end-of-file
+#------------------------------------------------------------------------------

etc/wmakeFiles/libccmio/files

@@ -0,0 +1,27 @@
+/* NOTE: make any changes to this file in etc/wmakeFiles/ */
+
+adf = libadf
+$(adf)/ADF_fortran_2_c.c
+$(adf)/ADF_interface.c
+$(adf)/ADF_internals.c
+
+ccmio = libccmio
+$(ccmio)/ccmio.c
+$(ccmio)/ccmiocore.c
+$(ccmio)/ccmioprivate.c
+$(ccmio)/ccmioutility.c
+$(ccmio)/ccmioversion.c
+
+/*
+ * the cgns library is not used by ccmio
+ * retain for documentation purposes only
+ *
+ cgns = libcgns
+ $(cgns)/adf_cond.c
+ $(cgns)/adf_ftoc.c
+ $(cgns)/cgns_error.c
+ $(cgns)/cgns_internals.c
+ $(cgns)/cgnslib.c
+*/
+
+LIB = $(FOAM_EXT_LIBBIN)/libccmio

etc/wmakeFiles/libccmio/options

@@ -0,0 +1,3 @@
+/* NOTE: make any changes to this file in etc/wmakeFiles/ */
+
+/* EXE_INC = */

etc/wmakeFiles/scotch/Makefile.inc.i686_pc_linux2.shlib-OpenFOAM

@@ -0,0 +1,26 @@
+EXE		=
+LIB		= .so
+OBJ		= .o
+
+MAKE		= make
+AR		= gcc
+ARFLAGS		= $(WM_CFLAGS) -shared -o
+CAT		= cat
+CCS		= gcc
+CCP		= mpicc
+CCD		= mpicc
+CFLAGS		= $(WM_CFLAGS) -O3 -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_RENAME -Drestrict=__restrict
+
+ifeq ($(WM_LABEL_OPTION),Int64)
+CFLAGS		+= -DINTSIZE64
+endif
+
+CLIBFLAGS	= -shared
+LDFLAGS		= -Xlinker --no-as-needed $(WM_LDFLAGS) -lz -lm -lrt
+CP		= cp
+LEX		= flex -Pscotchyy -olex.yy.c
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= echo
+YACC		= bison -pscotchyy -y -b y

makeCGAL

@@ -3,7 +3,7 @@
 # =========                 |
 # \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
 #  \\    /   O peration     |
-#   \\  /    A nd           | Copyright (C) 2012-2014 OpenFOAM Foundation
+#   \\  /    A nd           | Copyright (C) 2012-2016 OpenFOAM Foundation
 #    \\/     M anipulation  |
 #------------------------------------------------------------------------------
 # License
@@ -37,15 +37,19 @@
 #     Mixing system and ThirdParty for gmp/mpfr is not supported.
 #
 #------------------------------------------------------------------------------
-set -x
 
-cgalPACKAGE=CGAL-4.7
-boostPACKAGE=boost-system
-gmpPACKAGE=gmp-system
-mpfrPACKAGE=mpfr-system
+# Get CGAL, boost and gmp/mpfr versions
+. $WM_PROJECT_DIR/etc/config.sh/functions
+_foamEval $($WM_PROJECT_DIR/bin/foamEtcFile config.sh/CGAL)
+_foamSource $($WM_PROJECT_DIR/bin/foamEtcFile config.sh/compiler)
+
+cgalPACKAGE=${cgal_version:-CGAL-4.8.1}
+boostPACKAGE=${boost_version:-boost-system}
+gmpPACKAGE=${gmp_version:-gmp-system}
+mpfrPACKAGE=${mpfr_version:-mpfr-system}
 
 #------------------------------------------------------------------------------
-# run from third-party directory only
+# Run from third-party directory only
 wmakeCheckPwd "$WM_THIRD_PARTY_DIR" || {
     echo "Error: Current directory is not \$WM_THIRD_PARTY_DIR"
     echo "    The environment variables are inconsistent with the installation."
@@ -83,11 +87,11 @@ USAGE
 }
 
 
-# ensure CMake gets the correct C++ compiler
+# Ensure CMake gets the correct C++ compiler
 [ -n "$WM_CXX" ] && export CXX="$WM_CXX"
 
 
-# parse options
+# Parse options
 while [ "$#" -gt 0 ]
 do
     case "$1" in
@@ -159,7 +163,7 @@ then
 else
     boostInc="/usr/include"
 
-    # for completeness:
+    # For completeness:
     # 64-bit needs lib64, but 32-bit needs lib (not lib32)
     if [ "$WM_ARCH_OPTION" = 64 ]
     then
@@ -170,7 +174,7 @@ else
 fi
 
 
-# retrieve boost version:
+# Retrieve boost version:
 if [ -f "$boostInc/boost/version.hpp" ]
 then
     BOOST_VERSION_NO=`sed -ne 's/^#define *BOOST_VERSION *\([0-9][0-9]*\).*$/\1/p' $boostInc/boost/version.hpp`
@@ -180,6 +184,11 @@ else
     exit 1
 fi
 
+if [ "$cgal_version" = "cgal-system" ]
+then
+    echo "Using system installation of CGAL"
+    exit 0
+fi
 
 #
 # Build CGAL
@@ -201,7 +210,7 @@ GMP_ARCH_PATH=$installBASE/$gmpPACKAGE
 MPFR_ARCH_PATH=$installBASE/$mpfrPACKAGE
 
 (
-    # remove any existing build folder and recreate
+    # Remove any existing build folder and recreate
     if [ -d $CGAL_BINARY_DIR ]
     then
         echo "removing old build directory"
@@ -246,13 +255,13 @@ CMAKE_OPTIONS
         echo "    ThirdParty     : gmp/mpfr"
         configGmpMpfr=$(cat <<CMAKE_OPTIONS
  -DGMP_INCLUDE_DIR=$GMP_ARCH_PATH/include
- -DGMP_LIBRARIES_DIR=$GMP_ARCH_PATH/lib
- -DGMP_LIBRARIES=$GMP_ARCH_PATH/lib/libgmp.so
+ -DGMP_LIBRARIES_DIR=$GMP_ARCH_PATH/lib$WM_COMPILER_LIB_ARCH
+ -DGMP_LIBRARIES=$GMP_ARCH_PATH/lib$WM_COMPILER_LIB_ARCH/libgmp.so
  -DGMPXX_INCLUDE_DIR=$GMP_ARCH_PATH/include
- -DGMPXX_LIBRARIES=$GMP_ARCH_PATH/lib/libgmpxx.so
+ -DGMPXX_LIBRARIES=$GMP_ARCH_PATH/lib$WM_COMPILER_LIB_ARCH/libgmpxx.so
  -DMPFR_INCLUDE_DIR=$MPFR_ARCH_PATH/include
- -DMPFR_LIBRARIES_DIR=$MPFR_ARCH_PATH/lib
- -DMPFR_LIBRARIES=$MPFR_ARCH_PATH/lib/libmpfr.so
+ -DMPFR_LIBRARIES_DIR=$MPFR_ARCH_PATH/lib$WM_COMPILER_LIB_ARCH
+ -DMPFR_LIBRARIES=$MPFR_ARCH_PATH/lib$WM_COMPILER_LIB_ARCH/libmpfr.so
 CMAKE_OPTIONS
 )
     else
@@ -264,6 +273,7 @@ CMAKE_OPTIONS
     cmake \
         -DCMAKE_INSTALL_PREFIX=$CGAL_ARCH_PATH \
         -DCMAKE_BUILD_TYPE=Release \
+        -DWITH_CGAL_Qt5=OFF \
         $configBoost $configGmpMpfr \
         $CGAL_SOURCE_DIR \
     && make -j $WM_NCOMPPROCS \
@@ -287,4 +297,4 @@ CMAKE_OPTIONS
     echo "Done CGAL"
 )
 
-# ----------------------------------------------------------------- end-of-file
+#------------------------------------------------------------------------------

makeCmake

@@ -120,4 +120,4 @@ else
 }
 fi
 
-# ----------------------------------------------------------------- end-of-file
+#------------------------------------------------------------------------------

makeGcc

@@ -3,7 +3,7 @@
 # =========                 |
 # \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
 #  \\    /   O peration     |
-#   \\  /    A nd           | Copyright (C) 2011-2015 OpenFOAM Foundation
+#   \\  /    A nd           | Copyright (C) 2011-2016 OpenFOAM Foundation
 #    \\/     M anipulation  |
 #------------------------------------------------------------------------------
 # License
@@ -29,10 +29,16 @@
 #     Build script for gmp, mpfr and gcc-[4-9].?.?
 #
 #------------------------------------------------------------------------------
-gmpPACKAGE=gmp-5.1.2
-mpfrPACKAGE=mpfr-3.1.2
-mpcPACKAGE=mpc-1.0.1
-gccPACKAGE=
+
+# get default GCC, mpfr, gmp and mpc versions
+. $WM_PROJECT_DIR/etc/config.sh/functions
+_foamSource $($WM_PROJECT_DIR/bin/foamEtcFile config.sh/compiler)
+
+gmpPACKAGE=${gmp_version:-gmp-5.1.2}
+mpfrPACKAGE=${mpfr_version:-mpfr-3.1.2}
+mpcPACKAGE=${mpc_version:-mpc-1.0.1}
+gccPACKAGE=$gcc_version
+
 
 #------------------------------------------------------------------------------
 # Run from third-party directory only
@@ -50,7 +56,10 @@ usage() {
     while [ "$#" -ge 1 ]; do echo "$1"; shift; done
     cat<<USAGE
 
-usage: ${0##*/} [gmp-VERSION] [mpfr-VERSION] [mpc-VERSION] <gcc-VERSION>
+usage: ${0##*/} [option] [gmp-VERSION] [mpfr-VERSION] [mpc-VERSION] <gcc-VERSION>
+options:
+  -no-multilib      for 64-bit systems that don't have 32-bit support
+  -help
 
 * build combinations of gmp, mpfr, mpc and gcc
       $gmpPACKAGE
@@ -62,6 +71,7 @@ USAGE
     exit 1
 }
 
+GCC_BUILD_OPTIONS=""
 
 # Parse options
 while [ "$#" -gt 0 ]
@@ -70,6 +80,10 @@ do
     -h | -help)
         usage
         ;;
+    -no-multilib)
+        GCC_BUILD_OPTIONS="--disable-multilib"
+        shift
+        ;;
     gmp-[4-9]*)
         gmpPACKAGE="${1%%/}"
         shift
@@ -120,13 +134,6 @@ GMP_ARCH_PATH=$installBASE/$gmpPACKAGE
 MPFR_ARCH_PATH=$installBASE/$mpfrPACKAGE
 MPC_ARCH_PATH=$installBASE/$mpcPACKAGE
 
-# mpc is not needed for gcc older than 4.5
-case "$gccPACKAGE" in
-gcc-4.[0-4].*)
-   mpcPACKAGE=false
-   ;;
-esac
-
 #
 # Build GMP
 #
@@ -151,6 +158,7 @@ else
     set -x
     $sourceDIR/configure ABI=$ABI \
         --prefix=$GMP_ARCH_PATH \
+        --libdir=$GMP_ARCH_PATH/lib$WM_COMPILER_LIB_ARCH \
         --enable-cxx \
     && make -j $WM_NCOMPPROCS \
     && make install \
@@ -187,7 +195,9 @@ else
     set -x
     $sourceDIR/configure ABI=$ABI \
        --prefix=$MPFR_ARCH_PATH \
-       --with-gmp=$GMP_ARCH_PATH \
+       --libdir=$MPFR_ARCH_PATH/lib$WM_COMPILER_LIB_ARCH \
+       --with-gmp-include=$GMP_ARCH_PATH/include \
+       --with-gmp-lib=$GMP_ARCH_PATH/lib$WM_COMPILER_LIB_ARCH \
     && make -j $WM_NCOMPPROCS \
     && make install \
     && echo "Built: $mpfrPACKAGE"
@@ -206,9 +216,6 @@ echo "---------------"
 if [ -d $MPC_ARCH_PATH ]
 then
     echo "Already built: $mpcPACKAGE"
-elif [ "$mpcPACKAGE" = false ]
-then
-    echo "Skip building mpc - not needed for older gcc versions"
 else
     echo "Starting build: $mpcPACKAGE"
     echo
@@ -226,8 +233,11 @@ else
     set -x
     $sourceDIR/configure ABI=$ABI \
         --prefix=$MPC_ARCH_PATH \
-        --with-gmp=$GMP_ARCH_PATH \
-        --with-mpfr=$MPFR_ARCH_PATH \
+        --libdir=$MPC_ARCH_PATH/lib$WM_COMPILER_LIB_ARCH \
+        --with-gmp-include=$GMP_ARCH_PATH/include \
+        --with-gmp-lib=$GMP_ARCH_PATH/lib$WM_COMPILER_LIB_ARCH \
+        --with-mpfr-include=$MPFR_ARCH_PATH/include \
+        --with-mpfr-lib=$MPFR_ARCH_PATH/lib$WM_COMPILER_LIB_ARCH \
     && make -j $WM_NCOMPPROCS \
     && make install \
     && echo "Built: $mpcPACKAGE"
@@ -263,9 +273,6 @@ else
     cd $sourceDIR || exit 1
     make distclean 2>/dev/null
 
-    unset withMpc
-    [ -d "$MPC_ARCH_PATH" ] && withMpc="--with-mpc=$MPC_ARCH_PATH"
-
     rm -rf $buildDIR
     mkdir -p $buildDIR
     cd $buildDIR
@@ -273,14 +280,18 @@ else
     set -x
     $sourceDIR/configure \
         --prefix=$GCC_ARCH_PATH \
-        --with-gmp=$GMP_ARCH_PATH \
-        --with-mpfr=$MPFR_ARCH_PATH \
-        $withMpc \
+        --with-gmp-include=$GMP_ARCH_PATH/include \
+        --with-gmp-lib=$GMP_ARCH_PATH/lib$WM_COMPILER_LIB_ARCH \
+        --with-mpfr-include=$MPFR_ARCH_PATH/include \
+        --with-mpfr-lib=$MPFR_ARCH_PATH/lib$WM_COMPILER_LIB_ARCH \
+        --with-mpc-include=$MPC_ARCH_PATH/include \
+        --with-mpc-lib=$MPC_ARCH_PATH/lib$WM_COMPILER_LIB_ARCH \
         --with-pkgversion=OpenFOAM \
         --enable-languages=c,c++ \
         --enable-__cxa_atexit \
         --enable-libstdcxx-allocator=new \
         --with-system-zlib \
+        $GCC_BUILD_OPTIONS \
         MAKEINFO=missing \
     && make -j $WM_NCOMPPROCS \
     && make install \
@@ -292,4 +303,4 @@ else
 fi
 
 
-# ----------------------------------------------------------------- end-of-file
+#------------------------------------------------------------------------------

makeGperftools

@@ -115,4 +115,4 @@ else
 }
 fi
 
-# ----------------------------------------------------------------- end-of-file
+#------------------------------------------------------------------------------

makeLLVM

@@ -3,7 +3,7 @@
 # =========                 |
 # \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
 #  \\    /   O peration     |
-#   \\  /    A nd           | Copyright (C) 2011 OpenFOAM Foundation
+#   \\  /    A nd           | Copyright (C) 2011-2016 OpenFOAM Foundation
 #    \\/     M anipulation  |
 #------------------------------------------------------------------------------
 # License
@@ -37,7 +37,12 @@
 #        cd -
 #
 #------------------------------------------------------------------------------
-llvmPACKAGE=llvm-3.6.0
+
+# get default llvm version
+. $WM_PROJECT_DIR/etc/config.sh/functions
+_foamSource $($WM_PROJECT_DIR/bin/foamEtcFile config.sh/compiler)
+
+llvmPACKAGE=${clang_version:-llvm-3.6.0}
 
 #------------------------------------------------------------------------------
 # run from third-party directory only
@@ -131,4 +136,4 @@ else
 }
 fi
 
-# ----------------------------------------------------------------- end-of-file
+#------------------------------------------------------------------------------

makeParaView

@@ -3,7 +3,7 @@
 # =========                 |
 # \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
 #  \\    /   O peration     |
-#   \\  /    A nd           | Copyright (C) 2011-2012 OpenFOAM Foundation
+#   \\  /    A nd           | Copyright (C) 2011-2017 OpenFOAM Foundation
 #    \\/     M anipulation  |
 #------------------------------------------------------------------------------
 # License
@@ -26,7 +26,7 @@
 #     makeParaView
 #
 # Description
-#     Make and install paraview for version 3.14.1 and higher
+#     Make and install paraview 4 or 5
 #     - place the paraview source under $WM_THIRD_PARTY_DIR/ParaView-VERSION
 #       (note capitalisation)
 #
@@ -107,8 +107,8 @@ The -no-FEATURE option can be disable these features (if not already disabled):
 
 CMake options start with a capital letter and contain an '='.
 For example,
-    $Script BUILD_TESTING=ON PARAVIEW_GENERATE_PROXY_DOCUMENTATION=OFF
-to add tests and avoid building documentation
+    $Script BUILD_TESTING=ON
+to add tests
 
 For finer control, the build stages can be selected or deselected individually:
   -config    -no-config
@@ -146,6 +146,7 @@ setVersion
 #
 unset runCONFIG runMAKE runINSTALL
 runDEFAULT=true
+buildType=Release
 
 # parse options
 while [ "$#" -gt 0 ]
@@ -270,13 +271,17 @@ do
         export ParaView_MAJOR="$2"
         shift 2
         ;;
+    -buildType)
+        [ "$#" -ge 2 ] || usage "'$1' option requires an argument"
+        buildType="$2"
+        shift 2
+        ;;
     *)
         usage "unknown option/argument: '$*'"
         ;;
     esac
 done
 
-
 if [ "$runDEFAULT" = true ]
 then
     : ${runCONFIG:=true}
@@ -284,6 +289,10 @@ then
     : ${runINSTALL:=true}
 fi
 
+# Download ParaView sources
+#~~~~~~~~~~~~~~~~~~~~~~~~~~
+downloadParaView || usage "ParaView download failed.  Re-run to retry download"
+
 
 # Set configure options
 #~~~~~~~~~~~~~~~~~~~~~~
@@ -317,6 +326,7 @@ Version information
     qt        ${QtVersion:-none}
     version   ${ParaView_VERSION:-unknown}
     major     ${ParaView_MAJOR:-unknown}
+    build     ${buildType:-Release}
 $(checkVersion)
 ---------------------
 SUMMARY

makeParaView4

@@ -1,337 +0,0 @@
-#!/bin/sh
-#------------------------------------------------------------------------------
-# =========                 |
-# \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
-#  \\    /   O peration     |
-#   \\  /    A nd           | Copyright (C) 2011-2012 OpenFOAM Foundation
-#    \\/     M anipulation  |
-#------------------------------------------------------------------------------
-# License
-#     This file is part of OpenFOAM.
-#
-#     OpenFOAM is free software: you can redistribute it and/or modify it
-#     under the terms of the GNU General Public License as published by
-#     the Free Software Foundation, either version 3 of the License, or
-#     (at your option) any later version.
-#
-#     OpenFOAM is distributed in the hope that it will be useful, but WITHOUT
-#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-#     FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
-#     for more details.
-#
-#     You should have received a copy of the GNU General Public License
-#     along with OpenFOAM.  If not, see <http://www.gnu.org/licenses/>.
-#
-# Script
-#     makeParaView
-#
-# Description
-#     Make and install paraview
-#     - place the paraview source under $WM_THIRD_PARTY_DIR/ParaView-VERSION
-#       (note capitalisation)
-#
-#------------------------------------------------------------------------------
-# run from third-party directory only
-cd ${0%/*} || exit 1
-wmakeCheckPwd "$WM_THIRD_PARTY_DIR" || {
-    echo "Error: Current directory is not \$WM_THIRD_PARTY_DIR"
-    echo "    The environment variables are inconsistent with the installation."
-    echo "    Check the OpenFOAM entries in your dot-files and source them."
-    exit 1
-}
-. etc/tools/ThirdPartyFunctions
-. etc/tools/ParaView4Functions
-#------------------------------------------------------------------------------
-#
-# USER OPTIONS:
-# ~~~~~~~~~~~~~
-
-# MPI support:
-withMPI=false
-MPI_MAX_PROCS=32
-
-# Python support:
-# note: script will try to determine the appropriate python library.
-#       If it fails, specify the path using the PYTHON_LIBRARY variable
-withPYTHON=false
-PYTHON_LIBRARY=""
-# PYTHON_LIBRARY="/usr/lib64/libpython2.6.so.1.0"
-
-# MESA graphics support:
-withMESA=false
-MESA_INCLUDE="/usr/include/GL"
-MESA_LIBRARY="/usr/lib64/libOSMesa.so"
-
-# extra QT gui support (useful for some third party apps)
-withQT=true
-
-# Set the path to the Qt-4.5 (or later) qmake if the system Qt is older
-QMAKE_PATH=""
-
-# Set the path to cmake
-CMAKE_PATH=""
-
-#
-# NO FURTHER EDITING BELOW THIS LINE
-#
-#-----------------------------------------------------------------------------
-Script=${0##*/}
-
-usage() {
-    while [ "$#" -ge 1 ]; do echo "$1"; shift; done
-    cat<<USAGE
-
-usage: $Script [OPTION] [CMAKE-OPTION]
-options:
-  -rebuild          for repeated builds (-make -install) *use with caution*
-  -mesa             with mesa (if not already enabled)
-  -mpi              with mpi (if not already enabled)
-  -python           with python (if not already enabled)
-  -cmake PATH       with the cmake version corresponding to the cmake path given
-  -qmake PATH       with the Qt version corresponding to the qmake path given
-  -qt               with extra Qt gui support (if not already enabled)
-  -qt-VER           with Qt version corresponding to
-                        \$WM_THIRD_PARTY_DIR/platforms/$WM_ARCH$WM_COMPILER/qt-VER/bin/qmake
-  -gcc              force g++ instead of the value from \$WM_CXX
-  -verbose          verbose output in Makefiles
-  -version VER      specify an alternative version (current value: $ParaView_VERSION)
-  -major   VER      specify an alternative major version for special builds
-  -mesa-include DIR
-                    location of mesa headers (current value: ${MESA_INCLUDE:-none})
-  -mesa-lib PATH    path to mesa library     (current value: ${MESA_LIBRARY:-none})
-  -python-lib PATH  path to python library   (current value: ${PYTHON_LIBRARY:-none})
-  -help
-
-The -no-FEATURE option can be disable these features (if not already disabled):
-  mesa mpi python qt
-
-CMake options start with a capital letter and contain an '='.
-For example,
-    $Script BUILD_TESTING=ON
-to add tests
-
-For finer control, the build stages can be selected or deselected individually:
-  -config    -no-config
-  -make      -no-make
-  -install   -no-install
-
-
-* Make and install paraview-$ParaView_VERSION located under
-      \$WM_THIRD_PARTY_DIR/ParaView-$ParaView_VERSION
-  ->  \$WM_THIRD_PARTY_DIR/platforms/$WM_ARCH$WM_COMPILER/paraview-$ParaView_VERSION
-
-USAGE
-    exit 1
-}
-
-#------------------------------------------------------------------------------
-
-# ensure CMake gets the correct C++ compiler
-[ -n "$WM_CXX" ] && export CXX="$WM_CXX"
-[ -n "$WM_CC" ] && export CC="$WM_CC"
-
-#
-# add options based on script name:
-#
-case "$Script" in *-mesa*)   withMESA=true;; esac
-case "$Script" in *-mpi*)    withMPI=true;; esac
-case "$Script" in *-python*) withPYTHON=true;; esac
-case "$Script" in *-qt*)     withQT=true;; esac
-
-# set ParaView_MAJOR based on current value of ParaView_VERSION
-setVersion
-
-#
-# various building stages
-#
-unset runCONFIG runMAKE runINSTALL
-runDEFAULT=true
-buildType=Release
-
-# parse options
-while [ "$#" -gt 0 ]
-do
-    case "$1" in
-    -h | -help)
-        usage
-        ;;
-    [A-Z]*=*)            # cmake variables
-        addCMakeVariable "$1"
-        shift
-        ;;
-    -gcc)
-        export CXX=g++   # use g++
-        shift
-        ;;
-    -config)             # stage 1: config only
-        runCONFIG=true
-        unset runDEFAULT
-        shift
-        ;;
-    -no-config)
-        runCONFIG=false
-        shift
-        ;;
-    -make)               # stage 2: make only
-        runMAKE=true
-        unset runDEFAULT
-        shift
-        ;;
-    -no-make)
-        runMAKE=false
-        shift
-        ;;
-    -install)            # stage 3: install only
-        runINSTALL=true
-        unset runDEFAULT
-        shift
-        ;;
-    -no-install)
-        runINSTALL=false
-        shift
-        ;;
-    -rebuild)            # shortcut for rebuilding
-        runMAKE=true
-        runINSTALL=true
-        unset runDEFAULT
-        shift
-        ;;
-    -mesa)
-        withMESA=true
-        shift
-        ;;
-    -no-mesa)
-        withMESA=false
-        shift
-        ;;
-    -mesa-include)
-        [ "$#" -ge 2 ] || usage "'$1' option requires an argument"
-        MESA_INCLUDE="$2"
-        shift 2
-        ;;
-    -mesa-lib)
-        [ "$#" -ge 2 ] || usage "'$1' option requires an argument"
-        MESA_LIBRARY="$2"
-        shift 2
-        ;;
-    -mpi)
-        withMPI=true
-        shift
-        ;;
-    -no-mpi)
-        withMPI=false
-        shift
-        ;;
-    -python)
-        withPYTHON=true
-        shift
-        ;;
-    -no-python)
-        withPYTHON=false
-        shift
-        ;;
-    -python-lib)
-        [ "$#" -ge 2 ] || usage "'$1' option requires an argument"
-        PYTHON_LIBRARY="$2"
-        shift 2
-        ;;
-    -cmake)
-        [ "$#" -ge 2 ] || usage "'$1' option requires an argument"
-        CMAKE_PATH=$2
-        shift 2
-        ;;
-    -qmake)
-        [ "$#" -ge 2 ] || usage "'$1' option requires an argument"
-        QMAKE_PATH=$2
-        shift 2
-        ;;
-    -qt)
-        withQT=true
-        shift
-        ;;
-    -no-qt)
-        withQT=false
-        shift
-        ;;
-    -qt-[1-9]*)
-        QMAKE_PATH="$installBASE/${1##-}"
-        shift
-        ;;
-    -verbose)
-        withVERBOSE=true
-        shift
-        ;;
-    -version)
-        [ "$#" -ge 2 ] || usage "'$1' option requires an argument"
-        setVersion "$2"
-        shift 2
-        ;;
-    -major)
-        [ "$#" -ge 2 ] || usage "'$1' option requires an argument"
-        export ParaView_MAJOR="$2"
-        shift 2
-        ;;
-    -buildType)
-        [ "$#" -ge 2 ] || usage "'$1' option requires an argument"
-        buildType="$2"
-        shift 2
-        ;;
-    *)
-        usage "unknown option/argument: '$*'"
-        ;;
-    esac
-done
-
-
-if [ "$runDEFAULT" = true ]
-then
-    : ${runCONFIG:=true}
-    : ${runMAKE:=true}
-    : ${runINSTALL:=true}
-fi
-
-
-# Set configure options
-#~~~~~~~~~~~~~~~~~~~~~~
-addVerbosity        # verbose makefiles
-addMpiSupport       # set MPI-specific options
-addPythonSupport    # set Python-specific options
-addMesaSupport      # set MESA-specific options
-addQtSupport        # add extra Qt support
-
-setDirs             # where things are or should be put
-echoDateStamp       # report kitware source code date-stamp
-
-
-# Build and install
-# ~~~~~~~~~~~~~~~~~
-cat<<SUMMARY
-
-Build stages selected
----------------------
-    -config   ${runCONFIG:-false}
-    -make     ${runMAKE:-false}
-    -install  ${runINSTALL:-false}
----------------------
-Features selected
-    mesa      ${withMESA:-false}
-    mpi       ${withMPI:-false}
-    python    ${withPYTHON:-false}
-    qt        ${withQT:-false}
----------------------
-Version information
-    qt        ${QtVersion:-none}
-    version   ${ParaView_VERSION:-unknown}
-    major     ${ParaView_MAJOR:-unknown}
-    build     ${buildType:-Release}
-$(checkVersion)
----------------------
-SUMMARY
-
-[ "$runCONFIG"  = true ] && configParaView
-[ "$runMAKE"    = true ] && makeParaView
-[ "$runINSTALL" = true ] && installParaView
-
-echo
-echo Done
-#------------------------------------------------------------------------------

scotch_6.0.3/INSTALL.txt

@@ -0,0 +1,561 @@
+Scotch 6.0 installation instructions
+====================================
+
+
+1) Mandatory tools
+==================
+
+In order for you to compile Scotch and/or PT-Scotch, you must have GNU
+Make installed on your system, as well as an implementation of the MPI
+message-passing library in the case of PT-Scotch. Lex and Yacc are
+optional. There is a possibility to install Scotch without having Lex
+or Yacc, but it may require the tuning of sample Flex and Bison (i.e.,
+the GNU equivalents of Lex and Yacc) outputs created on a Linux
+system, which may need some tricky work to compile on other systems,
+because of different C library implementations.
+
+To check if GNU Make is installed and is found first, please type:
+
+%prompt% make --version
+
+It should read:
+% GNU Make x.xx
+% Copyright (C) 20xx  Free Software Foundation, Inc.
+etc, etc.
+
+
+Alternatively, if GNU Make is installed but its directory does
+not appear first in the PATH variable that is searched for
+executables, you can try to locate it using the which command:
+
+%prompt% which make
+
+If several occurences of make are found, one might be GNU Make,
+so try to figure out which of them.
+
+To see if lex and yacc are present, type
+%prompt% which lex
+%prompt% which yacc    (or "bison", the GNU flavor of yacc)
+
+If some of these are missing, please:
+- check your path variable (just in case they are located in
+  some unusual place, such as /usr/local/bin, /opt/bin,
+  /opt/local/bin/, /opt/gnu/bin, etc). Tools such as "which",
+  "locate" or "find" may help you find them;
+- ask your system administrator (highly recommended);
+- install a copy of GNU Make of your own (less recommended,
+  please ask your system administrator first). GNU Make is
+  available from the FSF website, at:
+  http://www.gnu.org/software/make/ and
+  http://ftp.gnu.org/pub/gnu/make/ .
+  A GNU version of lex and yacc is also available from the
+  very same FSF website, at:
+  http://www.gnu.org/software/flex/
+  http://ftp.gnu.org/non-gnu/flex/
+  http://www.gnu.org/software/bison/
+  http://ftp.gnu.org/pub/gnu/bison/ ;
+- use the "last resort" files placed in a directory judiciously
+  called "last_resort", located in subdirectory "src/libscotch".
+  These files are:
+  . parser_ll.c
+  . parser_ly.h
+  . parser_yy.c .
+  They should be copied in the directory where object files are
+  created, and "touch"ed so that their modification date is more
+  recent than those of the corresponding "parser_ll.l" and
+  "parser_yy.y" files. Then cross your fingers and hope it
+  compiles properly on your system. Else, you will have to dig in
+  their code to have them compile properly...
+  The Makefile of the libScotch library has been designed so as
+  to copy the last_resort/* files automatically when the lex or
+  yacc tools are not found.
+  In this case, depending on your platform, you may also have to set
+  the "-DSCOTCH_RENAME_PARSER" flag in order for all symbols to be
+  properly redefined (see Section 2.2).
+
+
+2) Configuration
+================
+
+2.1) Creating the "Makefile.inc" file
+-------------------------------------
+
+Go to the "src/" directory.
+
+Look in the "Make.inc/" subdirectory for a configuration
+file which matches your system configuration. If there
+is none, build a proper one in the "Make.inc/" subdirectory,
+basing on the structure of existing ones.
+
+In particular, the Makefile.inc file contains three variables
+which specify which C compiler to use. Their semantic is as
+follows: the compiler command in variable CCS is used to compile
+the sequential (hence the "S" in "CCS") Scotch distribution. The
+compiler command in CCP is used to compile the parallel ("P")
+PT-Scotch distribution. The compiler command in CCD is used to compile
+the version of the "dummysizes" ("D") executable used for compiling
+PT-Scotch, as explained below.
+
+Create a symbolic link from the configuration file to the
+current "src/" working directory, renaming it as "Makefile.inc":
+
+%prompt% ln -s Make.inc/Makefile.inc.xxxx_xxx_xxx Makefile.inc
+
+If symbolic links are not available on your system, make a
+plain copy of the file to a file named "Makefile.inc" in the
+current "src/" working directory:
+
+%prompt% cp Make.inc/Makefile.inc.xxxx_xxx_xxx Makefile.inc
+
+Some additional scripts, designed to ease the installation of Scotch
+on specific platforms, are also present in subdirectories of the
+Make.inc directory. This is for instance the case for the mingw32
+platform.
+
+
+2.2) Parser symbol conflicts
+----------------------------
+
+Since Scotch uses a parser to analyze its strategy strings, it may
+happen that the symbols of this parser conflict with those of
+another parser used in a third-party library. All "Makefile.inc.*"
+platform configuration files which base on flex / bison are already
+tailored so as to prevent such conflicts. If you use other parsing
+tools, you may have to provide other options. Another solution is to
+use the pre-processed parser files of the "src/libscotch/last_resort"
+subdirectory (corresponding operation instructions are given in
+Section 1).
+
+
+2.3) Integer size issues
+------------------------
+
+By default, all integers used in Scotch and PT-Scotch are of the "int"
+C type, corresponding to the "INTEGER" type in Fortran. To coerce the
+size of the Scotch integer type to 32 or 64 bits, add the "-DINTSIZE32"
+or "-DINTSIZE64" flags, respectively, to the C compiler flags in the
+Makefile.inc configuration file. If you do so, make sure to use
+integer types of equivalent size to declare variables passed to Scotch
+routines from caller C and Fortran procedures. Also, when running on
+32_64-bit architectures (that is, integer types are 32-bit wide,
+while address types are 64-bit wide), some integer array indices
+returned by the Fortran interface have to be of a size equivalent to
+those of memory addresses, that is, 64 bits. The size of these
+variables is determined by the "-DIDXSIZE32" and "-DIDXSIZE64" flags,
+respectively. When none of them is provided, the size of the indices
+is assumed to be equivalent to that of the Scotch integer type.
+
+For instance, on a 32-bit architecture, you can use 64-bit integers in
+Scotch by just setting the "-DINTSIZE64" flag, because addresses will
+remain on 32 bits. On a 32_64 architecture, you can use either 32-bit
+or 64-bit integers in Scotch, by setting the "-DINTSIZE32" or
+"-DINTSIZE64" flags accordingly, but in all cases you must set the
+"-DIDXSIZE64" flag in order for some of the routines of the Fortran
+interface to operate properly, because the array indices returned by
+these routines have to be stored as 64-bit quantities.
+
+Of course, on 64-bit architectures, another possibility is to tune
+your C and Fortran compilers to make them interpret all "int" and
+"INTEGER" types as 64 bit values. This solution is the simplest one,
+as there is no need to use any of the aforementioned flags, nor to
+hard-code type lengths in user's code. Yet, it prevents mixing 32 and
+64-bit features, and may create problems when linking PT-Scotch if a
+corresponding MPI library is not available.
+
+Be careful not to mismatch the 32-bit and 64-bit versions of the
+"scotch.h" and "ptscotch.h" include files that are generated at
+compile time. When several versions of Scotch are simultaneously
+present on a system, Make sure to place the corresponding include and
+library files in separate directories. Most Scotch data structures
+will have different sizes, depending on integer or pointer
+sizes. Consequently, compiling a 64-bit executable with the 32-bit
+version of "scotch.h" may lead to unpredictable behavior because of
+memory overflow.
+
+
+2.4) Compression libraries
+--------------------------
+
+The binaries of the Scotch distribution can handle compressed
+graphs in input or output. Three compressed graph formats are
+currently supported: bzip2, gzip and lzma. In order for them to be
+actually activated, the proper libraries must be available on your
+system. On a Linux platform, they are called "zlib" for the gzip
+format, "libbz2" for the bzip2 format, and "liblzma" for the lzma
+format. Note that it is the "development" version (also called
+"devel", for short, within package names) of each of these libraries
+which is required for the compilation to succeed.
+According to the libraries installed on your system, you may set
+flags "-DCOMMON_FILE_COMPRESS_BZ2", "-DCOMMON_FILE_COMPRESS_GZ" and/or
+"-DCOMMON_FILE_COMPRESS_LZMA" in the CFLAGS variable of your
+Makefile.inc configuration file, to have these formats and their
+respective extensions ".bz2", ".gz" and ".lzma", recognized and
+handled by Scotch.
+
+Compression and decompression are handled either by extra threads
+or by fork'ed child processes if threads are not available. On
+systems which do not provide a functional fork() system call,
+compressed files cannot be handled when the "-DCOMMON_PTHREAD" flag
+is not set (see below).
+
+
+2.5) Multi-threading
+--------------------
+
+Scotch can also take advantage of Posix threads when they are
+available. They are used in several places:
+
+- to compress and uncompress file data. This can be done either
+  by launching a service thread, or else by creating a separate
+  process by means of a Posix fork() system call. This choice is
+  controlled by the "-DCOMMON_PTHREAD" flag: if it is set, threads
+  will be used, else fork() calls will be performed. For systems
+  which do not support the fork() system call, such as the MinGW32
+  platform, one can set the "-DCOMMON_STUB_FORK" flag, which creates
+  a stub fork() routine which always returns an error. Therefore,
+  without both fork() and threads, one must set the
+  "-DCOMMON_STUB_FORK" flag without setting "-DCOMMON_PTHREAD", so
+  that compilation will successfully complete; however, in this case,
+  compressed graphs shall not be handled in practice.
+
+- to create distributed graphs in parallel. Since this task involves
+  concurrent MPI communications, the MPI library must support the
+  MPI_THREAD_MULTIPLE level. The use of threads within Scotch itself
+  is controlled by the "-DSCOTCH_PTHREAD" flag, which is completely
+  independent from the "-DCOMMON_PTHREAD" flag. Any of them can be set
+  without setting the other.
+
+  Note that if you compile Scotch with the "-DSCOTCH_PTHREAD" flag,
+  you will have to initialize your communication subsystem by using
+  the MPI_Init_thread() MPI call, not MPI_Init(), and the provided
+  thread support level value returned by the routine must be
+  checked carefully.
+  If you have doubts on the stability of your MPI implementation, it
+  is better not to set "-DSCOTCH_PTHREAD". For instance, on Linux
+  platforms, concurrency problems have been experienced with MPICH2
+  versions prior to 1.0.7 using TCP; consequently, if the MPI
+  implementation on your platform is based on an older MPICH2 version,
+  do not set the "-DSCOTCH_PTHREAD" flag.
+
+  Note that since the Scotch and PT-Scotch libraries are distinct, you
+  can still compile Scotch with threads enabled, and compile PT-Scotch
+  with threads disabled. However, since PT-Scotch calls Scotch
+  routines when operating on a single process, threaded routines will
+  be used on each process, without interfering with MPI.
+
+- to run in a multi-threaded way several key algorithms of the Scotch
+  (no longer really) sequential library, such as graph coarsening and
+  k-way diffusion. More algorithms will be re-coded in a threaded way
+  in future versions.
+
+To date, thread management is performed in a very rudimentary way.
+The available number of threads can only be set at compile-time, and
+the assignment of threads to cores is performed in increasing order,
+starting from 0, which may not always prove to be the most efficient
+mapping in terms of memory affinity. We plan to add a mechanism for
+dynamic thread allocation in the near future, based upon the hwloc
+library.
+
+The compilation flags used to manage threads are the following:
+
+"-DCOMMON_PTHREAD" enables threads for algorithms not related to
+graph management, partitioning and/or ordering, e.g. compressed
+file handling.
+
+"-DCOMMON_PTHREAD_BARRIER" creates a replacement for missing
+pthread_barrier_t implementations, which unfortunately happens on some
+systems.
+
+"-DSCOTCH_PTHREAD" is necessary to enable multi-threaded algorithms
+in Scotch and/or PT-Scotch.
+
+"-DSCOTCH_PTHREAD_AFFINITY_LINUX" enables Linux extensions for
+handling thread affinity. As said above, this may not prove
+efficient in all cases. More options will be provided in the
+near future.
+
+"-DSCOTCH_PTHREAD_NUMBER=x" sets the overall number of threads to be
+used by multi-threaded algorithms. This number may not necessary be a
+power of two. Since some algorithms have had to be reformulated to
+accomodate for multi-threading, some algorithms will most probably be
+much more efficient than sequential processing only for a number of
+threads strictly greater than 2. Setting "-DSCOTCH_PTHREAD_NUMBER=1"
+allows one to run sequential algorithms instead of multi-threaded
+ones, while benefitting from multi-threading for file compression and
+distributed graph handling.
+
+When compiling under mingw32 on Windows systems, it is possible to
+benefit from multi-threading by including the "semaphore.h" and
+"pthread.h" files, included in the "src/misc" subdirectory, at compile
+time. These files have been kindly provided by Samuel Thibault, under
+a BSD 2-Clause License. These files will not work for Cygwin. This is
+not a problem, as Cygwin provides its own implementation of Posix
+threads.
+
+
+2.6) Monitoring memory allocation
+---------------------------------
+
+Some memory allocation information can be aggregated if PT-Scotch is
+compiled with the -DCOMMON_MEMORY_TRACE flag. When this flag is set,
+the "-va" option will make dgmap, dgord and dgpart output the minimum,
+maximum and average peak amount of memory used over all processes.
+
+Several API routines will also be made available to report the current
+and maximum amount of memory used by Scotch within the process they
+are called: SCOTCH_memCur() and SCOTCH_memMax(), respectively.
+
+A rudimentary memory checking mechanism is available for platforms
+that do not have efficient memory checking and debugging tools such as
+Valgrind or gdb. It can be activated through the
+"-DCOMMON_MEMORY_CHECK=x" flag. This is almost only for internal
+debugging purposes. The value of the "-DCOMMON_MEMORY_CHECK" is 1 if
+memory checking should be enabled by default, and 0 else. This
+mechanism is absolutely NOT thread-safe at the time being.
+
+
+2.7) Randomness
+---------------
+
+Many algorithms in Scotch and PT-Scotch are based on the random
+selection of vertices (e.g. seed vertices for graph growing
+algorithms, vertices to be mated for coarsening algorithms,
+etc.). This selection is performed by using integer pseudo-random
+generators to produce seemingly uncorrelated vertex indices.
+
+The advantage of pseudo-randomness over pure randomness is that the
+same pseudo-random seed will always yield the same sequence of
+pseudo-random numbers. Consequently, while using a different random
+seed for each run is likely to explore better the solution space,
+using a fixed random seed eases the debugging of programs, because
+algorithms behave identically across multiple runs (save for
+asynchronousness issues, see next section). By default, Scotch is
+compiled with the "-DCOMMON_RANDOM_FIXED_SEED" flag set, so that
+multiple executions of the same sequential programs will always yield
+the same results.
+
+Prior to version 6.0, Scotch relied on the operating system
+pseudo-random generator. While this posed no problem for most
+sequential programs, parallel runs of PT-Scotch were not reproducible
+on some systems, because the MPI implementation also used this
+pseudo-random generator for its own purposes. In order to avoid this
+problem, Scotch now uses its own pseudo-random generator. Users that
+want to go on using the operating system pseudo-random generator
+(e.g. for regression testing with respect to version 5.x) can still do
+so, by compiling with the "-DCOMMON_RANDOM_SYSTEM" flag set. In this
+case, the "-DCOMMON_RANDOM_RAND" flag allows one to use the srand()
+routine instead of the default srandom() routine.
+
+
+2.8) Deterministic behavior
+---------------------------
+
+When Scotch is compiled with the "-DCOMMON_RANDOM_FIXED_SEED"
+flag set, multiple executions of the same sequential programs
+will always yield the same results. Yet, non-deterministic
+multi-threaded and/or parallel algorithms may still introduce
+some variability in the produced results, due to operating system
+artifacts.
+
+To ease the tracking down of bugs, it is possible to coerce Scotch to
+exhibit a deterministic behavior by setting the
+"-DSCOTCH_DETERMINISTIC" flag. This option makes sure that two
+consecutive runs of Scotch on the same graph and same number of
+processes and/or threads will always yield the same result. However,
+it does not mean that two executions of Scotch on different numbers of
+processes and/or threads will always yield the same result. Indeed,
+changing the number of processes impacts graph data distribution and
+consequently the order in which vertices are processed. Consequently,
+coarsening algorithms are likely to produce different coarse graphs,
+leading to different partitions.
+
+This option is likely to have adverse impact on performance, since all
+non-deterministic multi-threaded algorithms will be disabled. In the
+case of Scotch, the multi-threaded matching algorithm for coarsening
+will be replaced by its sequential counterpart, whatever the available
+number of threads is. In the case of PT-Scotch, point-to-point
+messages will be received in a fixed order rather than being processed
+on a first-come, first-serve basis.
+
+Setting this flag automatically results in setting the
+"-DCOMMON_RANDOM_FIXED_SEED" flag. Users are also strongly advised to
+compile without setting the "-DCOMMON_RANDOM_SYSTEM" flag, in order to
+avoid any interference with third-party libraries that might use the
+operating system pseudo-random generator.
+
+
+2.9) Point-to-point or collective communications
+------------------------------------------------
+
+Since distributed graph vertices can have any initial distribution
+across processes, communication rounds are likely to involve all of
+the processes in an almost all-to-all scheme. In order to speed-up
+running time, most of these communications are performed by means of
+asynchronous sends and receives, which allows computations to overlap
+with communications. However, for large numbers of processes, this can
+lead to the saturation of the communication network of the target
+parallel machine. To avoid this, communication consuming routines also
+have a collective communication based version. The use of this version
+is enabled by default, as it greatly improves scalability for large
+numbers of processes. To disable it, set the "-DSCOTCH_PTOP" flag at
+compile time.
+
+
+2.10) MeTiS compatibility library
+---------------------------------
+
+In order to ease the adoption of Scotch/PT-Scotch by people who
+already developed code based on the MeTiS/ParMeTiS interface, a MeTiS
+V3 compatibility library is included in the Scotch package. It
+provides stubs for the graph partitioning and ordering routines of
+MeTiS/ParMeTiS, but not for the service routines that are comprised
+in this package. Consequently, for people willing to use both
+libraries, that is, experiment with the graph partitioning features of
+Scotch while using the service routines of the genuine MeTiS package,
+special measures have to be taken.
+
+A first solution can be to coerce the linker to pick partitioning
+routines from the libscotch, and service routines from the
+libmetis. This can be done by placing the library names in this
+order as arguments to the linker command. Yet, some linkers may still
+report an error, as some symbols are multiply defined.
+
+Alternately, the names of the compatibility routines can be changed so
+as to avoid conflicts. When the "-DSCOTCH_METIS_PREFIX" flag is set at
+compile time, all Scotch versions of the MeTiS routines are prefixed
+with "SCOTCH_". Of course, this will require an equivalent change in
+the user's application code.
+
+An advantage of the Scotch/PT-Scotch stubs over the genuine
+MeTiS/ParMeTiS V3 routines is that they can be available in a 64-bit
+version. In this case, all int's that were passed to MeTiS/ParMeTiS
+routines must be replaced by 64-bit integer values (even the option
+configuration values). However, in this case, one will not be able to
+link against the service routines of the genuine MeTiS/ParMeTiS V3
+library, as the latter is only available as a 32-bit implementation.
+
+
+3) Compilation
+==============
+
+Once you have performed the configuration of the "Makefile.inc" file,
+compile the Scotch distribution by typing "make scotch", or just
+"make", in the current "src/" working directory. To compile the
+PT-Scotch distribution, type "make ptscotch" in the same "src/"
+directory. This can be done in any order. Typing "make scotch
+ptscotch" to compile both is equivalent to typing "make ptscotch"
+alone, since PT-Scotch requires Scotch.
+
+The most common problem you may encounter when trying to compile
+PT-Scotch on a new platform relates to the "dummysizes" and
+"ptdummysizes" executables. The purpose of these programs is to
+determine, on the target platform, the sizes of the opaque data
+structures of Scotch and PT-Scotch, respectively. They have to be
+compiled and run before any library function can be compiled. The
+sequential case poses no specific problems, as "dummysizes" is always
+compiled with the same command as the one used to compile the
+sequential Scotch package (hence, "CCD=$(CCS)" when executing "make
+scotch"). In the parallel case, "ptdummysizes" has to take into
+account the sizes of some MPI data structures, such as MPI_Comm, and
+the most common way to have access to this information is to use some
+flavor of MPI-aware compilers such as "mpicc" which automatically
+refer to "mpi.h". Therefore, "CCD=mpicc" will work for most systems
+and MPI implementations. Yet, on some platforms, programs compiled for
+parallel execution cannot be run interactively. Moreover,
+"ptdummysizes" itself does not contain any MPI calls, as it just wants
+to know the sizes of the data structures, and the communication
+susbystem of the platform may not want to run it. In any of these
+cases, compilation will break. It is possible to solve this problem by
+specifying, in the CCD variable of "Makefile.inc", how to compile
+"ptdummysizes" sequentially but with knowledge of the location of the
+"mpi.h" include file, for instance with the following line: "CCD =
+my_sequential_cc -I/path/to/my/mpi/implementation/include/dir/".
+
+If no error occurs, all of the relevant header, library and executable
+files will be created and copied to the "../include/", "../lib/" and
+"../bin/" directories, relatively to your current "src/" working
+directory. Headers, libraries and binaries of Scotch and PT-Scotch can
+coexist in these directories without any interference.
+
+Then, typing "make install" will perform a GNU-like installation, with
+header, library, binary and man files copied to the "include", "lib",
+"bin" and "man" subdirectories of the path specified in the "prefix"
+variable, which is set by default to "/usr/local". For instance,
+typing "make prefix=/home/myself/usr/ install" will install the
+Scotch/PT-Scotch files in a subtree of directory "/home/myself/usr/".
+
+
+4) Checking 
+===========
+
+A set of test programs is available in the "src/check" directory. They
+serve as non-regression checks for both sequential and parallel
+features of Scotch and PT-Scotch. They can be launched by typing "make
+check" and/or "make ptcheck" in the "src/" directory.
+
+In the case of "ptcheck", programs will be run in debug mode; user
+action is required (by typing ENTER whenever necessary) for launching
+the parallel programs.
+
+One might look at these programs for examples of how to use the Scotch
+and PT-Scotch libraries. However, some of these programs test internal
+features, and interact with the library through non-standard and
+non-documented procedures. It is therefore recommended NOT to imitate
+these calling practices and rather to follow the guidelines provided in
+the Scotch and PT-Scotch user manuals.
+
+
+5) Use
+======
+
+Users willing to use the features of the sequential (but possibly
+threaded) libScotch library have to include "scotch.h" and to link
+against the "libscotch" library, plus an error handling package such
+as "libscotcherr" or "libscotcherrexit".
+
+Users willing to use the features of the distributed-memory parallel
+libPTScotch library have to include "ptscotch.h" (which itself
+includes "scotch.h") and to link against both the "libptscotch" and
+"libscotch" libraries (in this order whenever order is significant),
+plus an error handling package such as "libptscotcherr" or
+"libptscotcherrexit".
+
+In the case of complex programs, which may run as sequential programs
+but may also call parallel routines, it is necessary to link only once
+against a Scotch error handling routine, and this routine cannot call
+MPI routines. Hence, the "libscotcherr" or "libscotcherrexit"
+libraries must be used. This will not impact the behavior of the
+parallel routines, but process numbers will not be displayed in case
+of an error.
+
+
+6) Documentation and use
+========================
+
+The Scotch and PT-Scotch user's manuals are available in the "doc/"
+directory. They describe how to use the libscotch and libptscotch
+libraries, as well as the standalone programs of the Scotch and
+PT-Scotch distributions.
+
+
+7) Note to packagers
+====================
+
+Since version 6.0, the Scotch and PT-Scotch packages can be made
+independent. The libScotch will not be tied by any dependency against
+any MPI package, while the libPTScotch has to depend on the one with
+which it has been compiled, in addition to the libScotch package that
+it uses.
+
+In versions 5.x, the libPTScotch also contained a modified copy of the
+libScotch. It is no longer the case, which will result in lower disk
+footprint.
+
+Regarding the use of threads, since Scotch is at the time being  not
+dynamically configurable, one has to decide whether to compile it with
+threads enabled or not and, additionally, with which number of threads
+it will run. Based on the current processor market, I recommend to
+compile with -DSCOTCH_PTHREAD_NUMBER=2 (and, of course,
+-DSCOTCH_PTHREAD_AFFINITY_LINUX whenever possible). The penalty for
+single-thread CPUs will not be too high, while hyper-threaded and
+many-core CPUs will benefit from the extra thread.

scotch_6.0.3/LICENCE_fr.txt

@@ -0,0 +1,7 @@
+Cette copie de la distribution logicielle Scotch 6.0 est distribu<62>e
+selon les termes de la licence de logiciel libre CeCILL-C.
+
+Une copie du texte de cette licence se trouve dans le sous-r<>pertoire
+"doc", dans le fichier appel<65> "CeCILL-C_V1-fr.txt". Veuillez en lire
+attentivement les clauses. Vous ne pourrez utiliser cette copie de la
+distribution logicielle Scotch 6.0 que si vous les acceptez.

scotch_6.0.3/LICENSE_en.txt

@@ -0,0 +1,6 @@
+This copy of the Scotch 6.0 distribution is licensed to you under the
+terms of the CeCILL-C free/libre software license.
+
+A copy of this license is available in subdirectory "doc", in file
+named "CeCILL-C_V1-en.txt". Please read its terms carefully. Only if
+you accept them can you use this copy of the Scotch 6.0 distribution.

scotch_6.0.3/LISEZ-MOI.txt

@@ -0,0 +1,8 @@
+Les clauses selon lesquelles cette copie de la distribution logicielle
+Scotch 6.0 est mise <20> votre disposition sont d<>finies dans le fichier
+"LICENCE_fr.txt", situ<74> dans le m<>me r<>pertoire que le pr<70>sent
+fichier.
+
+Si vous les acceptez, veuillez vous r<>f<EFBFBD>rer au fichier "INSTALL.txt",
+<EFBFBD>galement situ<74> dans ce r<>pertoire, pour consulter les instructions
+d'installation.

scotch_6.0.3/README.txt

@@ -0,0 +1,6 @@
+The terms under which this copy of the Scotch 6.0 distribution
+is provided to you are described in file "LICENSE_en.txt", located
+in the same directory as this file.
+
+If you accept them, please refer to file "INSTALL.txt", also
+located in this directory, for the installation instructions.

scotch_6.0.3/doc/CeCILL-C_V1-en.txt

@@ -0,0 +1,517 @@
+
+CeCILL-C FREE SOFTWARE LICENSE AGREEMENT
+
+
+    Notice
+
+This Agreement is a Free Software license agreement that is the result
+of discussions between its authors in order to ensure compliance with
+the two main principles guiding its drafting:
+
+    * firstly, compliance with the principles governing the distribution
+      of Free Software: access to source code, broad rights granted to
+      users,
+    * secondly, the election of a governing law, French law, with which
+      it is conformant, both as regards the law of torts and
+      intellectual property law, and the protection that it offers to
+      both authors and holders of the economic rights over software.
+
+The authors of the CeCILL-C (for Ce[a] C[nrs] I[nria] L[ogiciel] L[ibre])
+license are:
+
+Commissariat <20> l'Energie Atomique - CEA, a public scientific, technical
+and industrial research establishment, having its principal place of
+business at 25 rue Leblanc, immeuble Le Ponant D, 75015 Paris, France.
+
+Centre National de la Recherche Scientifique - CNRS, a public scientific
+and technological establishment, having its principal place of business
+at 3 rue Michel-Ange, 75794 Paris cedex 16, France.
+
+Institut National de Recherche en Informatique et en Automatique -
+INRIA, a public scientific and technological establishment, having its
+principal place of business at Domaine de Voluceau, Rocquencourt, BP
+105, 78153 Le Chesnay cedex, France.
+
+
+    Preamble
+
+The purpose of this Free Software license agreement is to grant users
+the right to modify and re-use the software governed by this license.
+
+The exercising of this right is conditional upon the obligation to make
+available to the community the modifications made to the source code of
+the software so as to contribute to its evolution.
+
+In consideration of access to the source code and the rights to copy,
+modify and redistribute granted by the license, users are provided only
+with a limited warranty and the software's author, the holder of the
+economic rights, and the successive licensors only have limited liability.
+
+In this respect, the risks associated with loading, using, modifying
+and/or developing or reproducing the software by the user are brought to
+the user's attention, given its Free Software status, which may make it
+complicated to use, with the result that its use is reserved for
+developers and experienced professionals having in-depth computer
+knowledge. Users are therefore encouraged to load and test the
+suitability of the software as regards their requirements in conditions
+enabling the security of their systems and/or data to be ensured and,
+more generally, to use and operate it in the same conditions of
+security. This Agreement may be freely reproduced and published,
+provided it is not altered, and that no provisions are either added or
+removed herefrom.
+
+This Agreement may apply to any or all software for which the holder of
+the economic rights decides to submit the use thereof to its provisions.
+
+
+    Article 1 - DEFINITIONS
+
+For the purpose of this Agreement, when the following expressions
+commence with a capital letter, they shall have the following meaning:
+
+Agreement: means this license agreement, and its possible subsequent
+versions and annexes.
+
+Software: means the software in its Object Code and/or Source Code form
+and, where applicable, its documentation, "as is" when the Licensee
+accepts the Agreement.
+
+Initial Software: means the Software in its Source Code and possibly its
+Object Code form and, where applicable, its documentation, "as is" when
+it is first distributed under the terms and conditions of the Agreement.
+
+Modified Software: means the Software modified by at least one
+Integrated Contribution.
+
+Source Code: means all the Software's instructions and program lines to
+which access is required so as to modify the Software.
+
+Object Code: means the binary files originating from the compilation of
+the Source Code.
+
+Holder: means the holder(s) of the economic rights over the Initial
+Software.
+
+Licensee: means the Software user(s) having accepted the Agreement.
+
+Contributor: means a Licensee having made at least one Integrated
+Contribution.
+
+Licensor: means the Holder, or any other individual or legal entity, who
+distributes the Software under the Agreement.
+
+Integrated Contribution: means any or all modifications, corrections,
+translations, adaptations and/or new functions integrated into the
+Source Code by any or all Contributors.
+
+Related Module: means a set of sources files including their
+documentation that, without modification to the Source Code, enables
+supplementary functions or services in addition to those offered by the
+Software.
+
+Derivative Software: means any combination of the Software, modified or
+not, and of a Related Module.
+
+Parties: mean both the Licensee and the Licensor.
+
+These expressions may be used both in singular and plural form.
+
+
+    Article 2 - PURPOSE
+
+The purpose of the Agreement is the grant by the Licensor to the
+Licensee of a non-exclusive, transferable and worldwide license for the
+Software as set forth in Article 5 hereinafter for the whole term of the
+protection granted by the rights over said Software. 
+
+
+    Article 3 - ACCEPTANCE
+
+3.1 The Licensee shall be deemed as having accepted the terms and
+conditions of this Agreement upon the occurrence of the first of the
+following events:
+
+    * (i) loading the Software by any or all means, notably, by
+      downloading from a remote server, or by loading from a physical
+      medium;
+    * (ii) the first time the Licensee exercises any of the rights
+      granted hereunder.
+
+3.2 One copy of the Agreement, containing a notice relating to the
+characteristics of the Software, to the limited warranty, and to the
+fact that its use is restricted to experienced users has been provided
+to the Licensee prior to its acceptance as set forth in Article 3.1
+hereinabove, and the Licensee hereby acknowledges that it has read and
+understood it.
+
+
+    Article 4 - EFFECTIVE DATE AND TERM
+
+
+      4.1 EFFECTIVE DATE
+
+The Agreement shall become effective on the date when it is accepted by
+the Licensee as set forth in Article 3.1.
+
+
+      4.2 TERM
+
+The Agreement shall remain in force for the entire legal term of
+protection of the economic rights over the Software.
+
+
+    Article 5 - SCOPE OF RIGHTS GRANTED
+
+The Licensor hereby grants to the Licensee, who accepts, the following
+rights over the Software for any or all use, and for the term of the
+Agreement, on the basis of the terms and conditions set forth hereinafter.
+
+Besides, if the Licensor owns or comes to own one or more patents
+protecting all or part of the functions of the Software or of its
+components, the Licensor undertakes not to enforce the rights granted by
+these patents against successive Licensees using, exploiting or
+modifying the Software. If these patents are transferred, the Licensor
+undertakes to have the transferees subscribe to the obligations set
+forth in this paragraph.
+
+
+      5.1 RIGHT OF USE
+
+The Licensee is authorized to use the Software, without any limitation
+as to its fields of application, with it being hereinafter specified
+that this comprises:
+
+   1. permanent or temporary reproduction of all or part of the Software
+      by any or all means and in any or all form.
+
+   2. loading, displaying, running, or storing the Software on any or
+      all medium.
+
+   3. entitlement to observe, study or test its operation so as to
+      determine the ideas and principles behind any or all constituent
+      elements of said Software. This shall apply when the Licensee
+      carries out any or all loading, displaying, running, transmission
+      or storage operation as regards the Software, that it is entitled
+      to carry out hereunder.
+
+
+      5.2 RIGHT OF MODIFICATION
+
+The right of modification includes the right to translate, adapt,
+arrange, or make any or all modifications to the Software, and the right
+to reproduce the resulting software. It includes, in particular, the
+right to create a Derivative Software.
+
+The Licensee is authorized to make any or all modification to the
+Software provided that it includes an explicit notice that it is the
+author of said modification and indicates the date of the creation thereof.
+
+
+      5.3 RIGHT OF DISTRIBUTION
+
+In particular, the right of distribution includes the right to publish,
+transmit and communicate the Software to the general public on any or
+all medium, and by any or all means, and the right to market, either in
+consideration of a fee, or free of charge, one or more copies of the
+Software by any means.
+
+The Licensee is further authorized to distribute copies of the modified
+or unmodified Software to third parties according to the terms and
+conditions set forth hereinafter.
+
+
+        5.3.1 DISTRIBUTION OF SOFTWARE WITHOUT MODIFICATION
+
+The Licensee is authorized to distribute true copies of the Software in
+Source Code or Object Code form, provided that said distribution
+complies with all the provisions of the Agreement and is accompanied by:
+
+   1. a copy of the Agreement,
+
+   2. a notice relating to the limitation of both the Licensor's
+      warranty and liability as set forth in Articles 8 and 9,
+
+and that, in the event that only the Object Code of the Software is
+redistributed, the Licensee allows effective access to the full Source
+Code of the Software at a minimum during the entire period of its
+distribution of the Software, it being understood that the additional
+cost of acquiring the Source Code shall not exceed the cost of
+transferring the data.
+
+
+        5.3.2 DISTRIBUTION OF MODIFIED SOFTWARE
+
+When the Licensee makes an Integrated Contribution to the Software, the
+terms and conditions for the distribution of the resulting Modified
+Software become subject to all the provisions of this Agreement.
+
+The Licensee is authorized to distribute the Modified Software, in
+source code or object code form, provided that said distribution
+complies with all the provisions of the Agreement and is accompanied by:
+
+   1. a copy of the Agreement,
+
+   2. a notice relating to the limitation of both the Licensor's
+      warranty and liability as set forth in Articles 8 and 9,
+
+and that, in the event that only the object code of the Modified
+Software is redistributed, the Licensee allows effective access to the
+full source code of the Modified Software at a minimum during the entire
+period of its distribution of the Modified Software, it being understood
+that the additional cost of acquiring the source code shall not exceed
+the cost of transferring the data.
+
+
+        5.3.3 DISTRIBUTION OF DERIVATIVE SOFTWARE
+
+When the Licensee creates Derivative Software, this Derivative Software
+may be distributed under a license agreement other than this Agreement,
+subject to compliance with the requirement to include a notice
+concerning the rights over the Software as defined in Article 6.4.
+In the event the creation of the Derivative Software required modification 
+of the Source Code, the Licensee undertakes that:
+
+   1. the resulting Modified Software will be governed by this Agreement,
+   2. the Integrated Contributions in the resulting Modified Software
+      will be clearly identified and documented,
+   3. the Licensee will allow effective access to the source code of the
+      Modified Software, at a minimum during the entire period of
+      distribution of the Derivative Software, such that such
+      modifications may be carried over in a subsequent version of the
+      Software; it being understood that the additional cost of
+      purchasing the source code of the Modified Software shall not
+      exceed the cost of transferring the data.
+
+
+        5.3.4 COMPATIBILITY WITH THE CeCILL LICENSE
+
+When a Modified Software contains an Integrated Contribution subject to
+the CeCILL license agreement, or when a Derivative Software contains a
+Related Module subject to the CeCILL license agreement, the provisions
+set forth in the third item of Article 6.4 are optional.
+
+
+    Article 6 - INTELLECTUAL PROPERTY
+
+
+      6.1 OVER THE INITIAL SOFTWARE
+
+The Holder owns the economic rights over the Initial Software. Any or
+all use of the Initial Software is subject to compliance with the terms
+and conditions under which the Holder has elected to distribute its work
+and no one shall be entitled to modify the terms and conditions for the
+distribution of said Initial Software.
+
+The Holder undertakes that the Initial Software will remain ruled at
+least by this Agreement, for the duration set forth in Article 4.2.
+
+
+      6.2 OVER THE INTEGRATED CONTRIBUTIONS
+
+The Licensee who develops an Integrated Contribution is the owner of the
+intellectual property rights over this Contribution as defined by
+applicable law.
+
+
+      6.3 OVER THE RELATED MODULES
+
+The Licensee who develops a Related Module is the owner of the
+intellectual property rights over this Related Module as defined by
+applicable law and is free to choose the type of agreement that shall
+govern its distribution under the conditions defined in Article 5.3.3.
+
+
+      6.4 NOTICE OF RIGHTS
+
+The Licensee expressly undertakes:
+
+   1. not to remove, or modify, in any manner, the intellectual property
+      notices attached to the Software;
+
+   2. to reproduce said notices, in an identical manner, in the copies
+      of the Software modified or not;
+
+   3. to ensure that use of the Software, its intellectual property
+      notices and the fact that it is governed by the Agreement is
+      indicated in a text that is easily accessible, specifically from
+      the interface of any Derivative Software.
+
+The Licensee undertakes not to directly or indirectly infringe the
+intellectual property rights of the Holder and/or Contributors on the
+Software and to take, where applicable, vis-<2D>-vis its staff, any and all
+measures required to ensure respect of said intellectual property rights
+of the Holder and/or Contributors.
+
+
+    Article 7 - RELATED SERVICES
+
+7.1 Under no circumstances shall the Agreement oblige the Licensor to
+provide technical assistance or maintenance services for the Software.
+
+However, the Licensor is entitled to offer this type of services. The
+terms and conditions of such technical assistance, and/or such
+maintenance, shall be set forth in a separate instrument. Only the
+Licensor offering said maintenance and/or technical assistance services
+shall incur liability therefor.
+
+7.2 Similarly, any Licensor is entitled to offer to its licensees, under
+its sole responsibility, a warranty, that shall only be binding upon
+itself, for the redistribution of the Software and/or the Modified
+Software, under terms and conditions that it is free to decide. Said
+warranty, and the financial terms and conditions of its application,
+shall be subject of a separate instrument executed between the Licensor
+and the Licensee.
+
+
+    Article 8 - LIABILITY
+
+8.1 Subject to the provisions of Article 8.2, the Licensee shall be
+entitled to claim compensation for any direct loss it may have suffered
+from the Software as a result of a fault on the part of the relevant
+Licensor, subject to providing evidence thereof.
+
+8.2 The Licensor's liability is limited to the commitments made under
+this Agreement and shall not be incurred as a result of in particular:
+(i) loss due the Licensee's total or partial failure to fulfill its
+obligations, (ii) direct or consequential loss that is suffered by the
+Licensee due to the use or performance of the Software, and (iii) more
+generally, any consequential loss. In particular the Parties expressly
+agree that any or all pecuniary or business loss (i.e. loss of data,
+loss of profits, operating loss, loss of customers or orders,
+opportunity cost, any disturbance to business activities) or any or all
+legal proceedings instituted against the Licensee by a third party,
+shall constitute consequential loss and shall not provide entitlement to
+any or all compensation from the Licensor.
+
+
+    Article 9 - WARRANTY
+
+9.1 The Licensee acknowledges that the scientific and technical
+state-of-the-art when the Software was distributed did not enable all
+possible uses to be tested and verified, nor for the presence of
+possible defects to be detected. In this respect, the Licensee's
+attention has been drawn to the risks associated with loading, using,
+modifying and/or developing and reproducing the Software which are
+reserved for experienced users.
+
+The Licensee shall be responsible for verifying, by any or all means,
+the suitability of the product for its requirements, its good working
+order, and for ensuring that it shall not cause damage to either persons
+or properties.
+
+9.2 The Licensor hereby represents, in good faith, that it is entitled
+to grant all the rights over the Software (including in particular the
+rights set forth in Article 5).
+
+9.3 The Licensee acknowledges that the Software is supplied "as is" by
+the Licensor without any other express or tacit warranty, other than
+that provided for in Article 9.2 and, in particular, without any warranty
+as to its commercial value, its secured, safe, innovative or relevant
+nature.
+
+Specifically, the Licensor does not warrant that the Software is free
+from any error, that it will operate without interruption, that it will
+be compatible with the Licensee's own equipment and software
+configuration, nor that it will meet the Licensee's requirements.
+
+9.4 The Licensor does not either expressly or tacitly warrant that the
+Software does not infringe any third party intellectual property right
+relating to a patent, software or any other property right. Therefore,
+the Licensor disclaims any and all liability towards the Licensee
+arising out of any or all proceedings for infringement that may be
+instituted in respect of the use, modification and redistribution of the
+Software. Nevertheless, should such proceedings be instituted against
+the Licensee, the Licensor shall provide it with technical and legal
+assistance for its defense. Such technical and legal assistance shall be
+decided on a case-by-case basis between the relevant Licensor and the
+Licensee pursuant to a memorandum of understanding. The Licensor
+disclaims any and all liability as regards the Licensee's use of the
+name of the Software. No warranty is given as regards the existence of
+prior rights over the name of the Software or as regards the existence
+of a trademark.
+
+
+    Article 10 - TERMINATION
+
+10.1 In the event of a breach by the Licensee of its obligations
+hereunder, the Licensor may automatically terminate this Agreement
+thirty (30) days after notice has been sent to the Licensee and has
+remained ineffective.
+
+10.2 A Licensee whose Agreement is terminated shall no longer be
+authorized to use, modify or distribute the Software. However, any
+licenses that it may have granted prior to termination of the Agreement
+shall remain valid subject to their having been granted in compliance
+with the terms and conditions hereof.
+
+
+    Article 11 - MISCELLANEOUS
+
+
+      11.1 EXCUSABLE EVENTS
+
+Neither Party shall be liable for any or all delay, or failure to
+perform the Agreement, that may be attributable to an event of force
+majeure, an act of God or an outside cause, such as defective
+functioning or interruptions of the electricity or telecommunications
+networks, network paralysis following a virus attack, intervention by
+government authorities, natural disasters, water damage, earthquakes,
+fire, explosions, strikes and labor unrest, war, etc.
+
+11.2 Any failure by either Party, on one or more occasions, to invoke
+one or more of the provisions hereof, shall under no circumstances be
+interpreted as being a waiver by the interested Party of its right to
+invoke said provision(s) subsequently.
+
+11.3 The Agreement cancels and replaces any or all previous agreements,
+whether written or oral, between the Parties and having the same
+purpose, and constitutes the entirety of the agreement between said
+Parties concerning said purpose. No supplement or modification to the
+terms and conditions hereof shall be effective as between the Parties
+unless it is made in writing and signed by their duly authorized
+representatives.
+
+11.4 In the event that one or more of the provisions hereof were to
+conflict with a current or future applicable act or legislative text,
+said act or legislative text shall prevail, and the Parties shall make
+the necessary amendments so as to comply with said act or legislative
+text. All other provisions shall remain effective. Similarly, invalidity
+of a provision of the Agreement, for any reason whatsoever, shall not
+cause the Agreement as a whole to be invalid.
+
+
+      11.5 LANGUAGE
+
+The Agreement is drafted in both French and English and both versions
+are deemed authentic.
+
+
+    Article 12 - NEW VERSIONS OF THE AGREEMENT
+
+12.1 Any person is authorized to duplicate and distribute copies of this
+Agreement.
+
+12.2 So as to ensure coherence, the wording of this Agreement is
+protected and may only be modified by the authors of the License, who
+reserve the right to periodically publish updates or new versions of the
+Agreement, each with a separate number. These subsequent versions may
+address new issues encountered by Free Software.
+
+12.3 Any Software distributed under a given version of the Agreement may
+only be subsequently distributed under the same version of the Agreement
+or a subsequent version.
+
+
+    Article 13 - GOVERNING LAW AND JURISDICTION
+
+13.1 The Agreement is governed by French law. The Parties agree to
+endeavor to seek an amicable solution to any disagreements or disputes
+that may arise during the performance of the Agreement.
+
+13.2 Failing an amicable solution within two (2) months as from their
+occurrence, and unless emergency proceedings are necessary, the
+disagreements or disputes shall be referred to the Paris Courts having
+jurisdiction, by the more diligent Party.
+
+
+Version 1.0 dated 2006-09-05.

scotch_6.0.3/doc/CeCILL-C_V1-fr.txt

@@ -0,0 +1,521 @@
+
+CONTRAT DE LICENCE DE LOGICIEL LIBRE CeCILL-C
+
+
+    Avertissement
+
+Ce contrat est une licence de logiciel libre issue d'une concertation
+entre ses auteurs afin que le respect de deux grands principes pr<70>side <20>
+sa r<>daction:
+
+    * d'une part, le respect des principes de diffusion des logiciels
+      libres: acc<63>s au code source, droits <20>tendus conf<6E>r<EFBFBD>s aux
+      utilisateurs,
+    * d'autre part, la d<>signation d'un droit applicable, le droit
+      fran<61>ais, auquel elle est conforme, tant au regard du droit de la
+      responsabilit<69> civile que du droit de la propri<72>t<EFBFBD> intellectuelle
+      et de la protection qu'il offre aux auteurs et titulaires des
+      droits patrimoniaux sur un logiciel.
+
+Les auteurs de la licence CeCILL-C (pour Ce[a] C[nrs] I[nria] L[ogiciel]
+L[ibre]) sont:
+
+Commissariat <20> l'Energie Atomique - CEA, <20>tablissement public de
+recherche <20> caract<63>re scientifique, technique et industriel, dont le
+si<EFBFBD>ge est situ<74> 25 rue Leblanc, immeuble Le Ponant D, 75015 Paris.
+
+Centre National de la Recherche Scientifique - CNRS, <20>tablissement
+public <20> caract<63>re scientifique et technologique, dont le si<73>ge est
+situ<EFBFBD> 3 rue Michel-Ange, 75794 Paris cedex 16.
+
+Institut National de Recherche en Informatique et en Automatique -
+INRIA, <20>tablissement public <20> caract<63>re scientifique et technologique,
+dont le si<73>ge est situ<74> Domaine de Voluceau, Rocquencourt, BP 105, 78153
+Le Chesnay cedex.
+
+
+    Pr<50>ambule
+
+Ce contrat est une licence de logiciel libre dont l'objectif est de
+conf<EFBFBD>rer aux utilisateurs la libert<72> de modifier et de r<>utiliser le
+logiciel r<>gi par cette licence.
+
+L'exercice de cette libert<72> est assorti d'une obligation de remettre <20>
+la disposition de la communaut<75> les modifications apport<72>es au code
+source du logiciel afin de contribuer <20> son <20>volution.
+
+L'accessibilit<69> au code source et les droits de copie, de modification
+et de redistribution qui d<>coulent de ce contrat ont pour contrepartie
+de n'offrir aux utilisateurs qu'une garantie limit<69>e et de ne faire
+peser sur l'auteur du logiciel, le titulaire des droits patrimoniaux et
+les conc<6E>dants successifs qu'une responsabilit<69> restreinte.
+
+A cet <20>gard l'attention de l'utilisateur est attir<69>e sur les risques
+associ<EFBFBD>s au chargement, <20> l'utilisation, <20> la modification et/ou au
+d<EFBFBD>veloppement et <20> la reproduction du logiciel par l'utilisateur <20>tant
+donn<EFBFBD> sa sp<73>cificit<69> de logiciel libre, qui peut le rendre complexe <20>
+manipuler et qui le r<>serve donc <20> des d<>veloppeurs ou des
+professionnels avertis poss<73>dant des connaissances informatiques
+approfondies. Les utilisateurs sont donc invit<69>s <20> charger et tester
+l'ad<61>quation du logiciel <20> leurs besoins dans des conditions permettant
+d'assurer la s<>curit<69> de leurs syst<73>mes et/ou de leurs donn<6E>es et, plus
+g<EFBFBD>n<EFBFBD>ralement, <20> l'utiliser et l'exploiter dans les m<>mes conditions de
+s<EFBFBD>curit<EFBFBD>. Ce contrat peut <20>tre reproduit et diffus<75> librement, sous
+r<EFBFBD>serve de le conserver en l'<27>tat, sans ajout ni suppression de clauses.
+
+Ce contrat est susceptible de s'appliquer <20> tout logiciel dont le
+titulaire des droits patrimoniaux d<>cide de soumettre l'exploitation aux
+dispositions qu'il contient.
+
+
+    Article 1 - DEFINITIONS
+
+Dans ce contrat, les termes suivants, lorsqu'ils seront <20>crits avec une
+lettre capitale, auront la signification suivante:
+
+Contrat: d<>signe le pr<70>sent contrat de licence, ses <20>ventuelles versions
+post<EFBFBD>rieures et annexes.
+
+Logiciel: d<>signe le logiciel sous sa forme de Code Objet et/ou de Code
+Source et le cas <20>ch<63>ant sa documentation, dans leur <20>tat au moment de
+l'acceptation du Contrat par le Licenci<63>.
+
+Logiciel Initial: d<>signe le Logiciel sous sa forme de Code Source et
+<EFBFBD>ventuellement de Code Objet et le cas <20>ch<63>ant sa documentation, dans
+leur <20>tat au moment de leur premi<6D>re diffusion sous les termes du Contrat.
+
+Logiciel Modifi<66>: d<>signe le Logiciel modifi<66> par au moins une
+Contribution Int<6E>gr<67>e.
+
+Code Source: d<>signe l'ensemble des instructions et des lignes de
+programme du Logiciel et auquel l'acc<63>s est n<>cessaire en vue de
+modifier le Logiciel.
+
+Code Objet: d<>signe les fichiers binaires issus de la compilation du
+Code Source.
+
+Titulaire: d<>signe le ou les d<>tenteurs des droits patrimoniaux d'auteur
+sur le Logiciel Initial.
+
+Licenci<EFBFBD>: d<>signe le ou les utilisateurs du Logiciel ayant accept<70> le
+Contrat.
+
+Contributeur: d<>signe le Licenci<63> auteur d'au moins une Contribution
+Int<EFBFBD>gr<EFBFBD>e.
+
+Conc<EFBFBD>dant: d<>signe le Titulaire ou toute personne physique ou morale
+distribuant le Logiciel sous le Contrat.
+
+Contribution Int<6E>gr<67>e: d<>signe l'ensemble des modifications,
+corrections, traductions, adaptations et/ou nouvelles fonctionnalit<69>s
+int<EFBFBD>gr<EFBFBD>es dans le Code Source par tout Contributeur.
+
+Module Li<4C>: d<>signe un ensemble de fichiers sources y compris leur
+documentation qui, sans modification du Code Source, permet de r<>aliser
+des fonctionnalit<69>s ou services suppl<70>mentaires <20> ceux fournis par le
+Logiciel.
+
+Logiciel D<>riv<69>: d<>signe toute combinaison du Logiciel, modifi<66> ou non,
+et d'un Module Li<4C>.
+
+Parties: d<>signe collectivement le Licenci<63> et le Conc<6E>dant.
+
+Ces termes s'entendent au singulier comme au pluriel.
+
+
+    Article 2 - OBJET
+
+Le Contrat a pour objet la concession par le Conc<6E>dant au Licenci<63> d'une
+licence non exclusive, cessible et mondiale du Logiciel telle que
+d<EFBFBD>finie ci-apr<70>s <20> l'article 5 pour toute la dur<75>e de protection des droits
+portant sur ce Logiciel.
+
+
+    Article 3 - ACCEPTATION
+
+3.1 L'acceptation par le Licenci<63> des termes du Contrat est r<>put<75>e
+acquise du fait du premier des faits suivants:
+
+    * (i) le chargement du Logiciel par tout moyen notamment par
+      t<>l<EFBFBD>chargement <20> partir d'un serveur distant ou par chargement <20>
+      partir d'un support physique;
+    * (ii) le premier exercice par le Licenci<63> de l'un quelconque des
+      droits conc<6E>d<EFBFBD>s par le Contrat.
+
+3.2 Un exemplaire du Contrat, contenant notamment un avertissement
+relatif aux sp<73>cificit<69>s du Logiciel, <20> la restriction de garantie et <20>
+la limitation <20> un usage par des utilisateurs exp<78>riment<6E>s a <20>t<EFBFBD> mis <20>
+disposition du Licenci<63> pr<70>alablement <20> son acceptation telle que
+d<EFBFBD>finie <20> l'article 3.1 ci dessus et le Licenci<63> reconna<6E>t en avoir pris
+connaissance.
+
+
+    Article 4 - ENTREE EN VIGUEUR ET DUREE
+
+
+      4.1 ENTREE EN VIGUEUR
+
+Le Contrat entre en vigueur <20> la date de son acceptation par le Licenci<63>
+telle que d<>finie en 3.1.
+
+
+      4.2 DUREE
+
+Le Contrat produira ses effets pendant toute la dur<75>e l<>gale de
+protection des droits patrimoniaux portant sur le Logiciel.
+
+
+    Article 5 - ETENDUE DES DROITS CONCEDES
+
+Le Conc<6E>dant conc<6E>de au Licenci<63>, qui accepte, les droits suivants sur
+le Logiciel pour toutes destinations et pour la dur<75>e du Contrat dans
+les conditions ci-apr<70>s d<>taill<6C>es.
+
+Par ailleurs, si le Conc<6E>dant d<>tient ou venait <20> d<>tenir un ou
+plusieurs brevets d'invention prot<6F>geant tout ou partie des
+fonctionnalit<EFBFBD>s du Logiciel ou de ses composants, il s'engage <20> ne pas
+opposer les <20>ventuels droits conf<6E>r<EFBFBD>s par ces brevets aux Licenci<63>s
+successifs qui utiliseraient, exploiteraient ou modifieraient le
+Logiciel. En cas de cession de ces brevets, le Conc<6E>dant s'engage <20>
+faire reprendre les obligations du pr<70>sent alin<69>a aux cessionnaires.
+
+
+      5.1 DROIT D'UTILISATION
+
+Le Licenci<63> est autoris<69> <20> utiliser le Logiciel, sans restriction quant
+aux domaines d'application, <20>tant ci-apr<70>s pr<70>cis<69> que cela comporte:
+
+   1. la reproduction permanente ou provisoire du Logiciel en tout ou
+      partie par tout moyen et sous toute forme.
+
+   2. le chargement, l'affichage, l'ex<65>cution, ou le stockage du
+      Logiciel sur tout support.
+
+   3. la possibilit<69> d'en observer, d'en <20>tudier, ou d'en tester le
+      fonctionnement afin de d<>terminer les id<69>es et principes qui sont
+      <20> la base de n'importe quel <20>l<EFBFBD>ment de ce Logiciel; et ceci,
+      lorsque le Licenci<63> effectue toute op<6F>ration de chargement,
+      d'affichage, d'ex<65>cution, de transmission ou de stockage du
+      Logiciel qu'il est en droit d'effectuer en vertu du Contrat.
+
+
+      5.2 DROIT DE MODIFICATION
+
+Le droit de modification comporte le droit de traduire, d'adapter,
+d'arranger ou d'apporter toute autre modification au Logiciel et le
+droit de reproduire le logiciel en r<>sultant. Il comprend en particulier
+le droit de cr<63>er un Logiciel D<>riv<69>.
+
+Le Licenci<63> est autoris<69> <20> apporter toute modification au Logiciel sous
+r<EFBFBD>serve de mentionner, de fa<66>on explicite, son nom en tant qu'auteur de
+cette modification et la date de cr<63>ation de celle-ci.
+
+
+      5.3 DROIT DE DISTRIBUTION
+
+Le droit de distribution comporte notamment le droit de diffuser, de
+transmettre et de communiquer le Logiciel au public sur tout support et
+par tout moyen ainsi que le droit de mettre sur le march<63> <20> titre
+on<EFBFBD>reux ou gratuit, un ou des exemplaires du Logiciel par tout proc<6F>d<EFBFBD>.
+
+Le Licenci<63> est autoris<69> <20> distribuer des copies du Logiciel, modifi<66> ou
+non, <20> des tiers dans les conditions ci-apr<70>s d<>taill<6C>es.
+
+
+        5.3.1 DISTRIBUTION DU LOGICIEL SANS MODIFICATION
+
+Le Licenci<63> est autoris<69> <20> distribuer des copies conformes du Logiciel,
+sous forme de Code Source ou de Code Objet, <20> condition que cette
+distribution respecte les dispositions du Contrat dans leur totalit<69> et
+soit accompagn<67>e:
+
+   1. d'un exemplaire du Contrat,
+
+   2. d'un avertissement relatif <20> la restriction de garantie et de
+      responsabilit<69> du Conc<6E>dant telle que pr<70>vue aux articles 8
+      et 9,
+
+et que, dans le cas o<> seul le Code Objet du Logiciel est redistribu<62>,
+le Licenci<63> permette un acc<63>s effectif au Code Source complet du
+Logiciel pendant au moins toute la dur<75>e de sa distribution du Logiciel,
+<EFBFBD>tant entendu que le co<63>t additionnel d'acquisition du Code Source ne
+devra pas exc<78>der le simple co<63>t de transfert des donn<6E>es.
+
+
+        5.3.2 DISTRIBUTION DU LOGICIEL MODIFIE
+
+Lorsque le Licenci<63> apporte une Contribution Int<6E>gr<67>e au Logiciel, les
+conditions de distribution du Logiciel Modifi<66> en r<>sultant sont alors
+soumises <20> l'int<6E>gralit<69> des dispositions du Contrat.
+
+Le Licenci<63> est autoris<69> <20> distribuer le Logiciel Modifi<66> sous forme de
+code source ou de code objet, <20> condition que cette distribution
+respecte les dispositions du Contrat dans leur totalit<69> et soit
+accompagn<EFBFBD>e:
+
+   1. d'un exemplaire du Contrat,
+
+   2. d'un avertissement relatif <20> la restriction de garantie et de
+      responsabilit<69> du Conc<6E>dant telle que pr<70>vue aux articles 8
+      et 9,
+
+et que, dans le cas o<> seul le code objet du Logiciel Modifi<66> est
+redistribu<EFBFBD>, le Licenci<63> permette un acc<63>s effectif <20> son code source
+complet pendant au moins toute la dur<75>e de sa distribution du Logiciel
+Modifi<EFBFBD>, <20>tant entendu que le co<63>t additionnel d'acquisition du code
+source ne devra pas exc<78>der le simple co<63>t de transfert des donn<6E>es.
+
+
+        5.3.3 DISTRIBUTION DU LOGICIEL DERIVE
+
+Lorsque le Licenci<63> cr<63>e un Logiciel D<>riv<69>, ce Logiciel D<>riv<69> peut
+<EFBFBD>tre distribu<62> sous un contrat de licence autre que le pr<70>sent Contrat <20>
+condition de respecter les obligations de mention des droits sur le
+Logiciel telles que d<>finies <20> l'article 6.4. Dans le cas o<> la cr<63>ation du
+Logiciel D<>riv<69> a n<>cessit<69> une modification du Code Source le licenci<63>
+s'engage <20> ce que: 
+
+   1. le Logiciel Modifi<66> correspondant <20> cette modification soit r<>gi
+      par le pr<70>sent Contrat,
+   2. les Contributions Int<6E>gr<67>es dont le Logiciel Modifi<66> r<>sulte
+      soient clairement identifi<66>es et document<6E>es,
+   3. le Licenci<63> permette un acc<63>s effectif au code source du Logiciel
+      Modifi<66>, pendant au moins toute la dur<75>e de la distribution du
+      Logiciel D<>riv<69>, de telle sorte que ces modifications puissent
+      <20>tre reprises dans une version ult<6C>rieure du Logiciel, <20>tant
+      entendu que le co<63>t additionnel d'acquisition du code source du
+      Logiciel Modifi<66> ne devra pas exc<78>der le simple co<63>t du transfert
+      des donn<6E>es.
+
+
+        5.3.4 COMPATIBILITE AVEC LA LICENCE CeCILL
+
+Lorsqu'un Logiciel Modifi<66> contient une Contribution Int<6E>gr<67>e soumise au
+contrat de licence CeCILL, ou lorsqu'un Logiciel D<>riv<69> contient un
+Module Li<4C> soumis au contrat de licence CeCILL, les stipulations pr<70>vues
+au troisi<73>me item de l'article 6.4 sont facultatives.
+
+
+    Article 6 - PROPRIETE INTELLECTUELLE
+
+
+      6.1 SUR LE LOGICIEL INITIAL
+
+Le Titulaire est d<>tenteur des droits patrimoniaux sur le Logiciel
+Initial. Toute utilisation du Logiciel Initial est soumise au respect
+des conditions dans lesquelles le Titulaire a choisi de diffuser son
+oeuvre et nul autre n'a la facult<6C> de modifier les conditions de
+diffusion de ce Logiciel Initial.
+
+Le Titulaire s'engage <20> ce que le Logiciel Initial reste au moins r<>gi
+par le Contrat et ce, pour la dur<75>e vis<69>e <20> l'article 4.2.
+
+
+      6.2 SUR LES CONTRIBUTIONS INTEGREES
+
+Le Licenci<63> qui a d<>velopp<70> une Contribution Int<6E>gr<67>e est titulaire sur
+celle-ci des droits de propri<72>t<EFBFBD> intellectuelle dans les conditions
+d<EFBFBD>finies par la l<>gislation applicable.
+
+
+      6.3 SUR LES MODULES LIES
+
+Le Licenci<63> qui a d<>velopp<70> un Module Li<4C> est titulaire sur celui-ci des
+droits de propri<72>t<EFBFBD> intellectuelle dans les conditions d<>finies par la
+l<EFBFBD>gislation applicable et reste libre du choix du contrat r<>gissant sa
+diffusion dans les conditions d<>finies <20> l'article 5.3.3.
+
+
+      6.4 MENTIONS DES DROITS
+
+Le Licenci<63> s'engage express<73>ment:
+
+   1. <20> ne pas supprimer ou modifier de quelque mani<6E>re que ce soit les
+      mentions de propri<72>t<EFBFBD> intellectuelle appos<6F>es sur le Logiciel;
+
+   2. <20> reproduire <20> l'identique lesdites mentions de propri<72>t<EFBFBD>
+      intellectuelle sur les copies du Logiciel modifi<66> ou non;
+
+   3. <20> faire en sorte que l'utilisation du Logiciel, ses mentions de
+      propri<72>t<EFBFBD> intellectuelle et le fait qu'il est r<>gi par le Contrat
+      soient indiqu<71>s dans un texte facilement accessible notamment
+      depuis l'interface de tout Logiciel D<>riv<69>.
+
+Le Licenci<63> s'engage <20> ne pas porter atteinte, directement ou
+indirectement, aux droits de propri<72>t<EFBFBD> intellectuelle du Titulaire et/ou
+des Contributeurs sur le Logiciel et <20> prendre, le cas <20>ch<63>ant, <20>
+l'<27>gard de son personnel toutes les mesures n<>cessaires pour assurer le
+respect des dits droits de propri<72>t<EFBFBD> intellectuelle du Titulaire et/ou
+des Contributeurs.
+
+
+    Article 7 - SERVICES ASSOCIES
+
+7.1 Le Contrat n'oblige en aucun cas le Conc<6E>dant <20> la r<>alisation de
+prestations d'assistance technique ou de maintenance du Logiciel.
+
+Cependant le Conc<6E>dant reste libre de proposer ce type de services. Les
+termes et conditions d'une telle assistance technique et/ou d'une telle
+maintenance seront alors d<>termin<69>s dans un acte s<>par<61>. Ces actes de
+maintenance et/ou assistance technique n'engageront que la seule
+responsabilit<EFBFBD> du Conc<6E>dant qui les propose.
+
+7.2 De m<>me, tout Conc<6E>dant est libre de proposer, sous sa seule
+responsabilit<EFBFBD>, <20> ses licenci<63>s une garantie, qui n'engagera que lui,
+lors de la redistribution du Logiciel et/ou du Logiciel Modifi<66> et ce,
+dans les conditions qu'il souhaite. Cette garantie et les modalit<69>s
+financi<EFBFBD>res de son application feront l'objet d'un acte s<>par<61> entre le
+Conc<EFBFBD>dant et le Licenci<63>.
+
+
+    Article 8 - RESPONSABILITE
+
+8.1 Sous r<>serve des dispositions de l'article 8.2, le Licenci<63> a la 
+facult<EFBFBD>, sous r<>serve de prouver la faute du Conc<6E>dant concern<72>, de
+solliciter la r<>paration du pr<70>judice direct qu'il subirait du fait du
+Logiciel et dont il apportera la preuve.
+
+8.2 La responsabilit<69> du Conc<6E>dant est limit<69>e aux engagements pris en
+application du Contrat et ne saurait <20>tre engag<61>e en raison notamment:
+(i) des dommages dus <20> l'inex<65>cution, totale ou partielle, de ses
+obligations par le Licenci<63>, (ii) des dommages directs ou indirects
+d<EFBFBD>coulant de l'utilisation ou des performances du Logiciel subis par le
+Licenci<EFBFBD> et (iii) plus g<>n<EFBFBD>ralement d'un quelconque dommage indirect. En
+particulier, les Parties conviennent express<73>ment que tout pr<70>judice
+financier ou commercial (par exemple perte de donn<6E>es, perte de
+b<EFBFBD>n<EFBFBD>fices, perte d'exploitation, perte de client<6E>le ou de commandes,
+manque <20> gagner, trouble commercial quelconque) ou toute action dirig<69>e
+contre le Licenci<63> par un tiers, constitue un dommage indirect et
+n'ouvre pas droit <20> r<>paration par le Conc<6E>dant.
+
+
+    Article 9 - GARANTIE
+
+9.1 Le Licenci<63> reconna<6E>t que l'<27>tat actuel des connaissances
+scientifiques et techniques au moment de la mise en circulation du
+Logiciel ne permet pas d'en tester et d'en v<>rifier toutes les
+utilisations ni de d<>tecter l'existence d'<27>ventuels d<>fauts. L'attention
+du Licenci<63> a <20>t<EFBFBD> attir<69>e sur ce point sur les risques associ<63>s au
+chargement, <20> l'utilisation, la modification et/ou au d<>veloppement et <20>
+la reproduction du Logiciel qui sont r<>serv<72>s <20> des utilisateurs avertis.
+
+Il rel<65>ve de la responsabilit<69> du Licenci<63> de contr<74>ler, par tous
+moyens, l'ad<61>quation du produit <20> ses besoins, son bon fonctionnement et
+de s'assurer qu'il ne causera pas de dommages aux personnes et aux biens.
+
+9.2 Le Conc<6E>dant d<>clare de bonne foi <20>tre en droit de conc<6E>der
+l'ensemble des droits attach<63>s au Logiciel (comprenant notamment les
+droits vis<69>s <20> l'article 5).
+
+9.3 Le Licenci<63> reconna<6E>t que le Logiciel est fourni "en l'<27>tat" par le
+Conc<EFBFBD>dant sans autre garantie, expresse ou tacite, que celle pr<70>vue <20>
+l'article 9.2 et notamment sans aucune garantie sur sa valeur commerciale,
+son caract<63>re s<>curis<69>, innovant ou pertinent.
+
+En particulier, le Conc<6E>dant ne garantit pas que le Logiciel est exempt
+d'erreur, qu'il fonctionnera sans interruption, qu'il sera compatible
+avec l'<27>quipement du Licenci<63> et sa configuration logicielle ni qu'il
+remplira les besoins du Licenci<63>.
+
+9.4 Le Conc<6E>dant ne garantit pas, de mani<6E>re expresse ou tacite, que le
+Logiciel ne porte pas atteinte <20> un quelconque droit de propri<72>t<EFBFBD>
+intellectuelle d'un tiers portant sur un brevet, un logiciel ou sur tout
+autre droit de propri<72>t<EFBFBD>. Ainsi, le Conc<6E>dant exclut toute garantie au
+profit du Licenci<63> contre les actions en contrefa<66>on qui pourraient <20>tre
+diligent<EFBFBD>es au titre de l'utilisation, de la modification, et de la
+redistribution du Logiciel. N<>anmoins, si de telles actions sont
+exerc<EFBFBD>es contre le Licenci<63>, le Conc<6E>dant lui apportera son aide
+technique et juridique pour sa d<>fense. Cette aide technique et
+juridique est d<>termin<69>e au cas par cas entre le Conc<6E>dant concern<72> et
+le Licenci<63> dans le cadre d'un protocole d'accord. Le Conc<6E>dant d<>gage
+toute responsabilit<69> quant <20> l'utilisation de la d<>nomination du
+Logiciel par le Licenci<63>. Aucune garantie n'est apport<72>e quant <20>
+l'existence de droits ant<6E>rieurs sur le nom du Logiciel et sur
+l'existence d'une marque.
+
+
+    Article 10 - RESILIATION
+
+10.1 En cas de manquement par le Licenci<63> aux obligations mises <20> sa
+charge par le Contrat, le Conc<6E>dant pourra r<>silier de plein droit le
+Contrat trente (30) jours apr<70>s notification adress<73>e au Licenci<63> et
+rest<EFBFBD>e sans effet.
+
+10.2 Le Licenci<63> dont le Contrat est r<>sili<6C> n'est plus autoris<69> <20>
+utiliser, modifier ou distribuer le Logiciel. Cependant, toutes les
+licences qu'il aura conc<6E>d<EFBFBD>es ant<6E>rieurement <20> la r<>siliation du Contrat
+resteront valides sous r<>serve qu'elles aient <20>t<EFBFBD> effectu<74>es en
+conformit<EFBFBD> avec le Contrat.
+
+
+    Article 11 - DISPOSITIONS DIVERSES
+
+
+      11.1 CAUSE EXTERIEURE
+
+Aucune des Parties ne sera responsable d'un retard ou d'une d<>faillance
+d'ex<65>cution du Contrat qui serait d<> <20> un cas de force majeure, un cas
+fortuit ou une cause ext<78>rieure, telle que, notamment, le mauvais
+fonctionnement ou les interruptions du r<>seau <20>lectrique ou de
+t<EFBFBD>l<EFBFBD>communication, la paralysie du r<>seau li<6C>e <20> une attaque
+informatique, l'intervention des autorit<69>s gouvernementales, les
+catastrophes naturelles, les d<>g<EFBFBD>ts des eaux, les tremblements de terre,
+le feu, les explosions, les gr<67>ves et les conflits sociaux, l'<27>tat de
+guerre...
+
+11.2 Le fait, par l'une ou l'autre des Parties, d'omettre en une ou
+plusieurs occasions de se pr<70>valoir d'une ou plusieurs dispositions du
+Contrat, ne pourra en aucun cas impliquer renonciation par la Partie
+int<EFBFBD>ress<EFBFBD>e <20> s'en pr<70>valoir ult<6C>rieurement.
+
+11.3 Le Contrat annule et remplace toute convention ant<6E>rieure, <20>crite
+ou orale, entre les Parties sur le m<>me objet et constitue l'accord
+entier entre les Parties sur cet objet. Aucune addition ou modification
+aux termes du Contrat n'aura d'effet <20> l'<27>gard des Parties <20> moins
+d'<27>tre faite par <20>crit et sign<67>e par leurs repr<70>sentants d<>ment habilit<69>s.
+
+11.4 Dans l'hypoth<74>se o<> une ou plusieurs des dispositions du Contrat
+s'av<61>rerait contraire <20> une loi ou <20> un texte applicable, existants ou
+futurs, cette loi ou ce texte pr<70>vaudrait, et les Parties feraient les
+amendements n<>cessaires pour se conformer <20> cette loi ou <20> ce texte.
+Toutes les autres dispositions resteront en vigueur. De m<>me, la
+nullit<EFBFBD>, pour quelque raison que ce soit, d'une des dispositions du
+Contrat ne saurait entra<72>ner la nullit<69> de l'ensemble du Contrat.
+
+
+      11.5 LANGUE
+
+Le Contrat est r<>dig<69> en langue fran<61>aise et en langue anglaise, ces
+deux versions faisant <20>galement foi.
+
+
+    Article 12 - NOUVELLES VERSIONS DU CONTRAT
+
+12.1 Toute personne est autoris<69>e <20> copier et distribuer des copies de
+ce Contrat.
+
+12.2 Afin d'en pr<70>server la coh<6F>rence, le texte du Contrat est prot<6F>g<EFBFBD>
+et ne peut <20>tre modifi<66> que par les auteurs de la licence, lesquels se
+r<EFBFBD>servent le droit de publier p<>riodiquement des mises <20> jour ou de
+nouvelles versions du Contrat, qui poss<73>deront chacune un num<75>ro
+distinct. Ces versions ult<6C>rieures seront susceptibles de prendre en
+compte de nouvelles probl<62>matiques rencontr<74>es par les logiciels libres.
+
+12.3 Tout Logiciel diffus<75> sous une version donn<6E>e du Contrat ne pourra
+faire l'objet d'une diffusion ult<6C>rieure que sous la m<>me version du
+Contrat ou une version post<73>rieure.
+
+
+    Article 13 - LOI APPLICABLE ET COMPETENCE TERRITORIALE
+
+13.1 Le Contrat est r<>gi par la loi fran<61>aise. Les Parties conviennent
+de tenter de r<>gler <20> l'amiable les diff<66>rends ou litiges qui
+viendraient <20> se produire par suite ou <20> l'occasion du Contrat.
+
+13.2 A d<>faut d'accord amiable dans un d<>lai de deux (2) mois <20> compter
+de leur survenance et sauf situation relevant d'une proc<6F>dure d'urgence,
+les diff<66>rends ou litiges seront port<72>s par la Partie la plus diligente
+devant les Tribunaux comp<6D>tents de Paris.
+
+
+Version 1.0 du 2006-09-05.

scotch_6.0.3/doc/scotch_example.f

@@ -0,0 +1,121 @@
+************************************************************
+**                                                        **
+**   NAME       : scotch_example.f                        **
+**                                                        **
+**   AUTHOR     : Francois PELLEGRINI                     **
+**                                                        **
+**   FUNCTION   : FORTRAN testbed for the LibSCOTCH       **
+**                library routines.                       **
+**                                                        **
+**   DATES      : # Version 3.4  : from : 04 feb 2000     **
+**                                 to     07 feb 2000     **
+**                # Version 4.0  : from : 13 mar 2005     **
+**                                 to     13 mar 2005     **
+**                                                        **
+*234567*****************************************************
+
+        PROGRAM SCOTCH_TEST
+        IMPLICIT NONE
+        INCLUDE "scotchf.h"
+          DOUBLEPRECISION   SCOTCHGRAPH (SCOTCH_GRAPHDIM)
+          INTEGER           VERTNBR
+          DATA              VERTNBR / 3 /
+          INTEGER           EDGENBR
+          DATA              EDGENBR / 4 /
+          INTEGER           VERTTAB (4)
+          DATA              VERTTAB / 1, 2, 4, 5 /
+          INTEGER           EDGETAB (4)
+          DATA              EDGETAB / 2, 1, 3, 2 /
+          INTEGER           INDXTAB (1)
+          INTEGER           IDXVERTNBR
+          INTEGER           IDXVERTTABIDX, IDXVENDTABIDX
+          INTEGER           IDXVELOTABIDX, IDXVLBLTABIDX
+          INTEGER           IDXEDGENBR
+          INTEGER           IDXEDGETABIDX, IDXEDLOTABIDX
+          INTEGER           IDXBASEVAL, IDXFLAGVAL
+          INTEGER           IERR
+
+          PRINT *, 'Starting'
+
+          CALL SCOTCHFGRAPHINIT (SCOTCHGRAPH (1), IERR)
+          IF (IERR .NE. 0) THEN
+            PRINT *, 'ERROR : MAIN : Cannot initialize graph'
+            STOP
+          ENDIF
+
+          CALL SCOTCHFGRAPHBUILD (SCOTCHGRAPH (1), 1, VERTNBR,
+     *                            VERTTAB (1), VERTTAB (2),
+     *                            VERTTAB (1), VERTTAB (1),
+     *                            EDGENBR,
+     *                            EDGETAB (1), EDGETAB (1), IERR)
+          IF (IERR .NE. 0) THEN
+            PRINT *, 'ERROR : MAIN : Cannot build graph'
+            STOP
+          ENDIF
+
+          CALL SCOTCHFGRAPHCHECK (SCOTCHGRAPH (1), IERR)
+          IF (IERR .NE. 0) THEN
+            PRINT *, 'ERROR : MAIN : Invalid check'
+            STOP
+          ENDIF
+
+          PRINT *, 'Outputing original graph'
+
+          CALL SCOTCHFGRAPHSAVE (SCOTCHGRAPH (1), 1, IERR)
+          IF (IERR .NE. 0) THEN
+            PRINT *, 'ERROR : MAIN : Invalid graph output'
+            STOP
+          ENDIF
+
+          CALL SCOTCHFGRAPHDATA (SCOTCHGRAPH (1), INDXTAB (1),
+     *                           IDXBASEVAL, IDXVERTNBR,
+     *                           IDXVERTTABIDX, IDXVENDTABIDX,
+     *                           IDXVELOTABIDX, IDXVLBLTABIDX,
+     *                           IDXEDGENBR,
+     *                           IDXEDGETABIDX, IDXEDLOTABIDX,
+     *                           IDXFLAGVAL, IERR);
+          IF (IERR .NE. 0) THEN
+            PRINT *, 'ERROR : MAIN : Cannot get graph data'
+            STOP
+          ENDIF
+
+          PRINT *, 'Number of vertices : ', IDXVERTNBR
+          PRINT *, 'Index of verttab   : ', IDXVERTTABIDX
+          PRINT *, 'Index of vendtab   : ', IDXVENDTABIDX
+          PRINT *, 'Index of velotab   : ', IDXVELOTABIDX
+          PRINT *, 'Index of vlbltab   : ', IDXVLBLTABIDX
+          PRINT *, 'Number of edges    : ', IDXEDGENBR
+          PRINT *, 'Index of edgetab   : ', IDXEDGETABIDX
+          PRINT *, 'Index of edlotab   : ', IDXEDLOTABIDX
+
+          PRINT *, 'Updating vertex and edge arrays'
+          INDXTAB (IDXVERTTABIDX + 1) = 3
+          INDXTAB (IDXEDGETABIDX)     = 2
+          INDXTAB (IDXEDGETABIDX + 1) = 3
+          INDXTAB (IDXEDGETABIDX + 2) = 1
+          INDXTAB (IDXEDGETABIDX + 3) = 1
+
+          PRINT *, 'Outputting updated graph'
+
+          CALL SCOTCHFGRAPHCHECK (SCOTCHGRAPH (1), IERR)
+          IF (IERR .NE. 0) THEN
+            PRINT *, 'ERROR : MAIN : Invalid check'
+            STOP
+          ENDIF
+
+          CALL SCOTCHFGRAPHSAVE (SCOTCHGRAPH (1), 1, IERR)
+          IF (IERR .NE. 0) THEN
+            PRINT *, 'ERROR : MAIN : Invalid graph output'
+            STOP
+          ENDIF
+
+          CALL SCOTCHFGRAPHEXIT (SCOTCHGRAPH (1), IERR)
+          IF (IERR .NE. 0) THEN
+            PRINT *, 'ERROR : MAIN : Cannot destroy graph'
+            STOP
+          ENDIF
+
+          PRINT *, 'Test complete'
+
+          RETURN
+        END

scotch_6.0.3/man/man1/amk_ccc.1

@@ -0,0 +1,107 @@
+." Text automatically generated by txt2man
+.TH amk_ccc 1 "August 03, 2010" "" "Scotch user's manual"
+.SH NAME
+\fBamk_ccc, amk_fft2, amk_hy, amk_m2, amk_p2 \fP- create target architectures
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBamk_ccc\fP [\fIoptions\fP] \fIdim\fP [\fItfile\fP]
+.PP
+\fBamk_fft2\fP [\fIoptions\fP] \fIdim\fP [\fItfile\fP]
+.PP
+\fBamk_hy\fP [\fIoptions\fP] \fIdim\fP [\fItfile\fP]
+.PP
+\fBamk_m2\fP [\fIoptions\fP] \fIdimX\fP [\fIdimY\fP] [\fItfile\fP]
+.PP
+\fBamk_p2\fP [\fIoptions\fP] [\fIwght0\fP] [\fIwght1\fP] [\fItfile\fP]
+.fam T
+.fi
+.SH DESCRIPTION
+The amk_* programs create target architecture files for some common,
+regular topologies.
+.PP
+\fBamk_ccc\fP creates a decomposition-defined cube-connected-cycle
+topology of dimension \fIdim\fP. The decomposition is performed first by
+bisection along the dimensions of the hypercube, then along the
+remaining cycle graphs.
+.PP
+\fBamk_fft2\fP creates a decomposition-defined fast-Fourier-transform
+topology of dimension \fIdim\fP. The decomposition is performed by
+recursive bisection of the vertices, by descending dimension
+(that is, bit number in the labeling of the vertices).
+.PP
+\fBamk_hy\fP creates a decomposition-defined hypercube topology of
+dimension \fIdim\fP. The decomposition is performed by
+recursive bisection of the vertices, by descending dimension
+(that is, bit number in the labeling of the vertices). Save for
+experimentation purposes, this program is deprecated, as the
+algorithmically-defined 'hcub' target architecture is a more
+convenient and efficient way to represent hypercube architectures.
+.PP
+\fBamk_m2\fP creates a decomposition-defined 2D regular grid topology of
+dimensions \fIdimX\fP and \fIdimY\fP. The decomposition is performed by
+recursive splitting along the dimensions, either by cutting the
+longest one, or by one-way dissection, depending on the '\fB-m\fP' option
+flag. Save for experimentation purposes, this program is deprecated,
+as the algorithmically-defined 'mesh2D' and 'mesh3D' target
+architectures are a more convenient and efficient way to represent
+2D and 3D grid architectures.
+.PP
+\fBamk_p2\fP creates a weighted path graph topology comprising only two
+vertices of weights \fIwght0\fP and \fIwght1\fP. This is just a helper program,
+which builds a 'wcmplt' algorithmically-defined complete graph with
+two vertices. It may be used to compute weighted bisections of a
+graph.
+.SH OPTIONS
+.TP
+.B
+\fB-m\fP\fImeth\fP
+For \fBamk_m2\fP only. Perform either recursive dissection or
+one-way dissection, according to the given method flag:
+.RS
+.TP
+.B
+n
+perform nested dissection (default).
+.TP
+.B
+o
+perform one-way dissection (cut across Y, then X).
+.RE
+.TP
+.B
+\fB-h\fP
+Display some help.
+.TP
+.B
+\fB-V\fP
+Display program version and copyright.
+.SH EXAMPLE
+Create a cube-connected-cycle target architecture of dimension 4,
+and save it to file 'ccc4.tgt'.
+.PP
+.nf
+.fam C
+    $ amk_ccc 4 ccc4.tgt
+
+.fam T
+.fi
+Run gmap to compute a bisection, into two parts of respective weights
+3 and 5, of graph 'brol.grf' and save the resulting mapping to
+file 'brol.map'. The dash '-' standard file name is used so that the
+target architecture description is read from the standard input,
+through the pipe.
+.PP
+.nf
+.fam C
+    $ amk_p2 3 5 | gmap brol.grf - brol.map
+
+.fam T
+.fi
+.SH SEE ALSO
+\fBgmk_msh\fP(1), \fBgtst\fP(1), \fBgmap\fP(1), \fBgord\fP(1), \fBgout\fP(1), \fBamk_grf\fP(1).
+.PP
+Scotch user's manual.
+.SH AUTHOR
+Francois Pellegrini <francois.pellegrini@labri.fr>

scotch_6.0.3/man/man1/amk_fft2.1

@@ -0,0 +1 @@
+.so man1/amk_ccc.1

scotch_6.0.3/man/man1/amk_hy.1

@@ -0,0 +1 @@
+.so man1/amk_ccc.1

scotch_6.0.3/man/man1/amk_m2.1

@@ -0,0 +1 @@
+.so man1/amk_ccc.1

scotch_6.0.3/man/man1/amk_p2.1

@@ -0,0 +1 @@
+.so man1/amk_ccc.1

scotch_6.0.3/man/man1/atst.1

@@ -0,0 +1,56 @@
+." Text automatically generated by txt2man
+.TH atst 1 "August 03, 2010" "" "Scotch user's manual"
+.SH NAME
+\fBatst \fP- test the consistency of target architectures
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBatst\fP [\fIoptions\fP] [\fIafile\fP] [\fIlfile\fP]
+.fam T
+.fi
+.SH DESCRIPTION
+The \fBatst\fP program checks the consistency of a Scotch
+decomposition-defined target architecture and, in case of success,
+outputs some statistics regarding the number of target vertices and
+the length of paths linking them. Target architectures define the
+topology of the target graphs used by static mapping programs
+\fBgmap\fP(1) and \fBdgmap\fP(1).
+.PP
+The resulting statistics are stored in file \fIlfile\fP. When file names
+are not specified, data is read from standard input and written to
+standard output. Standard streams can also be explicitly represented
+by a dash '-'.
+.PP
+When the proper libraries have been included at compile time, \fBatst\fP
+can directly handle compressed files, both as input and output. A
+stream is treated as compressed whenever its name is postfixed with
+a compressed file extension, such as in 'brol.tgt.bz2' or '-.gz'. The
+compression formats which can be supported are the bzip2 format
+('.bz2'), the gzip format ('.gz'), and the lzma format ('.lzma', on
+input only).
+.SH OPTIONS
+.TP
+.B
+\fB-h\fP
+Display some help.
+.TP
+.B
+\fB-V\fP
+Display program version and copyright.
+.SH EXAMPLE
+Test the consistency of architecture arch.tgt:
+.PP
+.nf
+.fam C
+    $ atst arch.tgt
+
+.fam T
+.fi
+.SH SEE ALSO
+\fBamk_grf\fP(1), \fBamk_ccc\fP(1), \fBamk_fft2\fP(1), \fBamk_hy\fP(1), \fBamk_m2\fP(1),
+\fBamk_p2\fP(1), \fBgmap\fP(1), \fBdgmap\fP(1).
+.PP
+Scotch user's manual.
+.SH AUTHOR
+Francois Pellegrini <francois.pellegrini@labri.fr>

scotch_6.0.3/man/man1/dgmap.1

@@ -0,0 +1,141 @@
+." Text automatically generated by txt2man
+.TH dgmap 1 "August 03, 2010" "" "PT-Scotch user's manual"
+.SH NAME
+\fBdgmap, dgpart \fP- compute static mappings and partitions in parallel
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBdgmap\fP [\fIoptions\fP] [\fIgfile\fP] [\fItfile\fP] [\fImfile\fP] [\fIlfile\fP]
+.PP
+\fBdgpart\fP [\fIoptions\fP] [\fInparts\fP] [\fIgfile\fP] [\fImfile\fP] [\fIlfile\fP]
+.fam T
+.fi
+.SH DESCRIPTION
+The \fBdgmap\fP program computes, in a parallel way, a static mapping of a
+source graph onto a target graph.
+.PP
+The \fBdgpart\fP program is a shortcut of \fBdgmap\fP for computing partitions
+of a source graph.
+.PP
+Source graph file \fIgfile\fP is either a centralized graph file, or a set
+of files representing fragments of a distributed graph. For \fBdgmap\fP,
+the target architecture file \fItfile\fP describes either algorithmically-coded
+topologies such as meshes and hypercubes, or decomposition-defined
+architectures created by means of the \fBamk_grf\fP(1) program. See
+\fBgmap\fP(1) for a description of target architectures. The resulting
+mapping is stored in file \fImfile\fP. Eventual logging information (such
+as the one produced by option \fB-v\fP) is sent to file \fIlfile\fP. When file
+names are not specified, data is read from standard input and
+written to standard output. Standard streams can also be explicitely
+represented by a dash '-'.
+.PP
+When the proper libraries have been included at compile time, \fBdgmap\fP
+and \fBdgpart\fP can directly handle compressed graphs, both as input and
+output. A stream is treated as compressed whenever its name is
+postfixed with a compressed file extension, such as
+in 'brol.grf.bz2' or '-.gz'. The compression formats which can be
+supported are the bzip2 format ('.bz2'), the gzip format ('.gz'),
+and the lzma format ('.lzma', on input only).
+.PP
+\fBdgmap\fP and \fBdgpart\fP base on implementations of the MPI interface to
+spread work across the processing elements. They are therefore not
+likely to be run directly, but instead through some launcher command
+such as \fBmpirun\fP.
+.SH OPTIONS
+.TP
+.B
+\fB-c\fPopt
+Choose default mapping strategy according to one or
+several \fIoptions\fP among:
+.RS
+.TP
+.B
+b
+enforce load balance as much as possible.
+.TP
+.B
+q
+privilege quality over speed (default).
+.TP
+.B
+s
+privilege speed over quality.
+.TP
+.B
+t
+enforce safety.
+.TP
+.B
+x
+enforce scalability.
+.RE
+.TP
+.B
+\fB-h\fP
+Display some help.
+.TP
+.B
+\fB-m\fP\fIstrat\fP
+Use parallel mapping strategy \fIstrat\fP (see
+PT-Scotch user's manual for more information).
+.TP
+.B
+\fB-r\fP\fIpnum\fP
+Set root process for centralized files (default is 0).
+.TP
+.B
+\fB-V\fP
+Display program version and copyright.
+.TP
+.B
+\fB-v\fP\fIverb\fP
+Set verbose mode to \fIverb\fP. It is a set of one of more
+characters which can be:
+.RS
+.TP
+.B
+m
+mapping information.
+.TP
+.B
+s
+strategy information.
+.TP
+.B
+t
+timing information.
+.SH NOTE
+At the time being (version 5.1.0), \fBdgmap\fP cannot compute full static
+mappings as \fBgmap\fP(1) does, but only partitions (that is, mappings
+onto unweighted or weighted complete graphs). Target architectures
+other than the 'cmplt' and 'wcmplt' ones will lead to an error
+message.
+.SH EXAMPLES
+Run \fBdgpart\fP on 5 processing elements to compute a partition into 7
+parts of graph brol.grf and save the resulting ordering to file brol.map.
+.PP
+.nf
+.fam C
+    $ mpirun -np 5 dgpart 7 brol.grf brol.map
+
+.fam T
+.fi
+Run \fBdgpart\fP on 5 processing elements to partition into 7 parts the
+distributed graph stored on graph fragment files brol5-0.dgr to
+brol5-4.dgr, and save the resulting mapping to file brol.map (see
+\fBdgscat\fP(1) for an explanation of the '%p' and '%r' sequences in names
+of distributed graph fragments).
+.PP
+.nf
+.fam C
+    $ mpirun -np 5 dgpart 7 brol%p-%r.dgr brol.map
+
+.fam T
+.fi
+.SH SEE ALSO
+\fBdgtst\fP(1), \fBdgscat\fP(1), \fBamk_grf\fP(1), \fBacpl\fP(1), \fBgmap\fP(1), \fBgmtst\fP(1).
+.PP
+PT-Scotch user's manual.
+.SH AUTHOR
+Francois Pellegrini <francois.pellegrini@labri.fr>

scotch_6.0.3/man/man1/dgord.1

@@ -0,0 +1,138 @@
+." Text automatically generated by txt2man
+.TH dgord 1 "August 03, 2010" "" "PT-Scotch user's manual"
+.SH NAME
+\fBdgord \fP- compute sparse matrix orderings of graphs in parallel
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBdgord\fP [\fIoptions\fP] [\fIgfile\fP] [\fIofile\fP] [\fIlfile\fP]
+.fam T
+.fi
+.SH DESCRIPTION
+The \fBdgord\fP program computes, in a parallel way, an ordering of a
+Scotch source graph representing the pattern of some symmetric
+sparse matrix.
+.PP
+Source graph file \fIgfile\fP is either a centralized graph file, or a set
+of files representing fragments of a distributed graph. The resulting
+ordering is stored in file \fIofile\fP. Eventual logging information (such
+as the one produced by option \fB-v\fP) is sent to file \fIlfile\fP. When file
+names are not specified, data is read from standard input and
+written to standard output. Standard streams can also be explicitely
+represented by a dash '-'.
+.PP
+When the proper libraries have been included at compile time, \fBdgord\fP
+can directly handle compressed graphs, both as input and output. A
+stream is treated as compressed whenever its name is postfixed with
+a compressed file extension, such as in 'brol.grf.bz2' or '-.gz'. The
+compression formats which can be supported are the bzip2 format
+('.bz2'), the gzip format ('.gz'), and the lzma format ('.lzma', on
+input only).
+.PP
+\fBdgord\fP bases on implementations of the MPI interface to spread work
+across the processing elements. It is therefore not likely to be run
+directly, but instead through some launcher command such as \fBmpirun\fP.
+.SH OPTIONS
+.TP
+.B
+\fB-c\fPopt
+Choose default ordering strategy according to one or
+several \fIoptions\fP among:
+.RS
+.TP
+.B
+b
+enforce load balance as much as possible.
+.TP
+.B
+q
+privilege quality over speed (default).
+.TP
+.B
+s
+privilege speed over quality.
+.TP
+.B
+t
+enforce safety.
+.TP
+.B
+x
+enforce scalability.
+.RE
+.TP
+.B
+\fB-h\fP
+Display some help.
+.TP
+.B
+\fB-m\fP\fImfile\fP
+Save column block mapping data to file \fImfile\fP. Mapping
+data specifies, for each vertex, the index of the column
+block to which this vertex belongs.
+.TP
+.B
+\fB-o\fP\fIstrat\fP
+Use parallel graph ordering strategy \fIstrat\fP (see
+PT-Scotch user's manual for more information).
+.TP
+.B
+\fB-r\fP\fIpnum\fP
+Set root process for centralized files (default is 0).
+.TP
+.B
+\fB-t\fP\fItfile\fP
+Save partitioning tree data to file \fItfile\fP. Partitioning
+tree data specifies, for each vertex, the index of the
+first vertex of the parent block of the block to which
+the vertex belongs. Altogether with the mapping data
+provided in file \fImfile\fP, it allows one to rebuild the
+separator tree of the nested dissection process.
+.TP
+.B
+\fB-V\fP
+Display program version and copyright.
+.TP
+.B
+\fB-v\fP\fIverb\fP
+Set verbose mode to \fIverb\fP. It is a set of one of more
+characters which can be:
+.RS
+.TP
+.B
+s
+strategy information.
+.TP
+.B
+t
+timing information.
+.SH EXAMPLES
+Run \fBdgord\fP on 5 processing elements to reorder matrix graph brol.grf
+and save the resulting ordering to file brol.ord, using the default
+sequential graph ordering strategy:
+.PP
+.nf
+.fam C
+    $ mpirun -np 5 dgord brol.grf brol.ord
+
+.fam T
+.fi
+Run \fBdgord\fP on 5 processing elements to reorder the distributed matrix
+stored on graph fragment files brol5-0.dgr to brol5-4.dgr, and save
+the resulting ordering to file brol.ord (see \fBdgscat\fP(1) for an
+explanation of the '%p' and '%r' sequences in names of distributed
+graph fragments).
+.PP
+.nf
+.fam C
+    $ mpirun -np 5 dgord brol%p-%r.dgr brol.ord
+
+.fam T
+.fi
+.SH SEE ALSO
+\fBdgtst\fP(1), \fBdgscat\fP(1), \fBgmk_hy\fP(1), \fBgord\fP(1).
+.PP
+PT-Scotch user's manual.
+.SH AUTHOR
+Francois Pellegrini <francois.pellegrini@labri.fr>

scotch_6.0.3/man/man1/dgpart.1

@@ -0,0 +1 @@
+.so man1/dgmap.1

scotch_6.0.3/man/man1/dgscat.1

@@ -0,0 +1,117 @@
+." Text automatically generated by txt2man
+.TH dgscat 1 "August 03, 2010" "" "PT-Scotch user's manual"
+.SH NAME
+\fBdgscat \fP- build distributed source graph file fragments from a centralized source graph file
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBdgscat\fP [\fIoptions\fP] [\fIigfile\fP] [\fIogfile\fP]
+.fam T
+.fi
+.SH DESCRIPTION
+The \fBdgscat\fP program reads a centralized source graph \fIigfile\fP and
+writes it back on the form of a set of files \fIogfile\fP representing
+fragments of a distributed source graph.
+.PP
+When file names are not specified, data is read from standard input
+and written to standard output. Standard streams can also be
+explicitly represented by a dash '-'.
+.PP
+When the proper libraries have been included at compile time, dgord
+can directly handle compressed graphs, both as input and output. A
+stream is treated as compressed whenever its name is postfixed with
+a compressed file extension, such as in 'brol.grf.bz2' or '-.gz'. The
+compression formats which can be supported are the bzip2 format
+('.bz2'), the gzip format ('.gz'), and the lzma format ('.lzma', on
+input only).
+.PP
+dgord bases on implementations of the MPI interface to spread work
+across the processing elements. It is therefore not likely to be run
+directly, but instead through some launcher command such as \fBmpirun\fP.
+.SH DISTRIBUTED FILE NAMES
+In order to tell whether programs should read from, or write to, a
+single file located on only one processor, or to multiple instances
+of the same file on all of the processors, or else to distinct files
+on each of the processors, a special grammar has been designed,
+which is based on the '%' escape character. Four such escape
+sequences are defined, which are interpreted independently on every
+processor, prior to file opening. By default, when a filename is
+provided, it is assumed that the file is to be opened on only one of
+the processors, called the root processor, which is usually process
+0 of the communicator within which the program is run. The index
+of the root processor can be changed by means of the \fB-r\fP
+option. Using any of the first three escape sequences below will
+instruct programs to open in parallel a file of name equal to the
+interpreted filename, on every processor on which they are run.
+.TP
+.B
+%p
+Replaced by the number of processes in the global communicator in
+which the program is run. Leads to parallel opening.
+.TP
+.B
+%r
+Replaced on each process running the program by the rank of this
+process in the global communicator. Leads to parallel opening.
+.TP
+.B
+%-
+Discarded, but leads to parallel opening. This sequence is mainly
+used to instruct programs to open on every processor a file of
+identical name. The opened files can be, according whether the
+given path leads to a shared directory or to directories that
+are local to each processor, either to the opening of multiple
+instances of the same file, or to the opening of distinct files
+which may each have a different content, respectively (but in
+this latter case it is much recommended to identify files by
+means of the '%r' sequence).
+.TP
+.B
+%%
+Replaced by a single '%' character. File names using this escape
+sequence are not considered for parallel opening, unless one or
+several of the three other escape sequences are also present.
+.RE
+.PP
+For instance, filename 'brol' will lead to the opening of file 'brol'
+on the root processor only, filename '%\fB-brol\fP' (or even 'br%\fB-ol\fP') will
+lead to the parallel opening of files called 'brol' on every
+processor, and filename 'brol%p-%r' will lead to the opening of files
+'brol2-0' and 'brol2-1', respectively, on each of the two processors
+on which the program were to run.
+.SH OPTIONS
+.TP
+.B
+\fB-c\fP
+Check the consistency of the input source graph after
+loading it into memory.
+.TP
+.B
+\fB-h\fP
+Display some help.
+.TP
+.B
+\fB-r\fP\fIpnum\fP
+Set root process for centralized files (default is 0).
+.TP
+.B
+\fB-V\fP
+Display program version and copyright.
+.SH EXAMPLE
+Run \fBdgscat\fP on 5 processing elements to scatter centralized graph
+file brol.grf into 5 gzipped file fragments brol5-0.dgr.gz to
+brol5-4.dgr.gz.
+.PP
+.nf
+.fam C
+    $ mpirun -np 5 dgscat brol.grf brol%p-%r.dgr.gz
+
+.fam T
+.fi
+.SH SEE ALSO
+\fBdgtst\fP(1), \fBdgord\fP(1), \fBgmk_hy\fP(1).
+.PP
+PT-Scotch user's manual.
+.SH AUTHOR
+Francois Pellegrini <francois.pellegrini@labri.fr>

scotch_6.0.3/man/man1/dgtst.1

@@ -0,0 +1,78 @@
+." Text automatically generated by txt2man
+.TH dgtst 1 "August 03, 2010" "" "PT-Scotch user's manual"
+.SH NAME
+\fBdgtst \fP- test the consistency of source graphs in parallel
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBdgtst\fP [\fIoptions\fP] [\fIgfile\fP] [\fIlfile\fP]
+.fam T
+.fi
+.SH DESCRIPTION
+The \fBdgtst\fP program checks, in a parallel way, the consistency of a
+Scotch source graph and, in case of success, outputs some statistics
+regarding edge weights, vertex weights, and vertex degrees.
+.PP
+It produces the very same results as the \fBgtst\fP(1) program of the
+Scotch sequential distribution, but unlike this latter it can handle
+distributed graphs.
+.PP
+Source graph file \fIgfile\fP is either a centralized graph file, or a set
+of files representing fragments of a distributed graph. The
+resulting statistics are stored in file \fIlfile\fP. When file names are
+not specified, data is read from standard input and written to
+standard output. Standard streams can also be explicitly
+represented by a dash '-'.
+.PP
+When the proper libraries have been included at compile time, \fBdgtst\fP
+can directly handle compressed graphs, both as input and output. A
+stream is treated as compressed whenever its name is postfixed with
+a compressed file extension, such as in 'brol.grf.bz2' or '-.gz'. The
+compression formats which can be supported are the bzip2 format
+('.bz2'), the gzip format ('.gz'), and the lzma format ('.lzma', on
+input only).
+.PP
+\fBdgtst\fP bases on implementations of the MPI interface to spread work
+across the processing elements. It is therefore not likely to be run
+directly, but instead through some launcher command such as \fBmpirun\fP.
+.SH OPTIONS
+.TP
+.B
+\fB-h\fP
+Display some help.
+.TP
+.B
+\fB-r\fP\fIpnum\fP
+Set root process for centralized files (default is 0).
+.TP
+.B
+\fB-V\fP
+Display program version and copyright.
+.SH EXAMPLE
+Run \fBdgtst\fP on 5 processing elements to test the consistency of graph brol.grf
+.PP
+.nf
+.fam C
+    $ mpirun -np 5 dgtst brol.grf
+
+.fam T
+.fi
+Run dgord on 5 processing elements to test the consistency of a
+distributed graph stored on graph fragment files brol5-0.dgr to
+brol5-4.dgr, and save the resulting ordering to file brol.ord (see
+\fBdgscat\fP(1) for an explanation of the '%p' and '%r' sequences in names
+of distributed graph fragments).
+.PP
+.nf
+.fam C
+    $ mpirun -np 5 dgtst brol%p-%r.dgr brol.ord
+
+.fam T
+.fi
+.SH SEE ALSO
+\fBdgscat\fP(1), \fBgtst\fP(1), \fBdgord\fP(1).
+.PP
+PT-Scotch user's manual.
+.SH AUTHOR
+Francois Pellegrini <francois.pellegrini@labri.fr>

scotch_6.0.3/man/man1/gcv.1

@@ -0,0 +1,106 @@
+." Text automatically generated by txt2man
+.TH gcv 1 "August 03, 2010" "" "Scotch user's manual"
+.SH NAME
+\fBgcv \fP- graph file converter
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBgcv\fP [\fIoptions\fP] [\fIigfile\fP] [\fIogfile\fP] [\fIoxfile\fP]
+.fam T
+.fi
+.SH DESCRIPTION
+The \fBgcv\fP program converts Scotch graph files from and to other
+external file formats.
+.PP
+File \fIigfile\fP is converted into graph file \fIogfile\fP, with optional
+geometry data being put in geometry file \fIoxfile\fP, if it is
+available.
+.PP
+When file names are not specified, data is read from standard input
+and written to standard output. Standard streams can also be
+explicitly represented by a dash '-'.
+.PP
+When the proper libraries have been included at compile time, dgtst
+can directly handle compressed graphs, both as input and output. A
+stream is treated as compressed whenever its name is postfixed with
+a compressed file extension, such as in 'brol.grf.bz2' or '-.gz'. The
+compression formats which can be supported are the bzip2 format
+('.bz2'), the gzip format ('.gz'), and the lzma format ('.lzma', on
+input only).
+.SH OPTIONS
+.TP
+.B
+\fB-h\fP
+Display some help.
+.TP
+.B
+\fB-i\fP\fIifmt\fP
+Set format of input graph file, which can be:
+.RS
+.TP
+.B
+b\fInum\fP
+Boeing-Harwell format. This is a matrix format.
+Only square matrices are supported. Square matrices
+with unsymmetric pattern are symmetrized. In
+case the file contains several matrices, the \fInum\fP
+parameter allow the user to provide the index of
+the matrix to convert, starting from 0. When the \fInum\fP
+parameter is not set, it is assumed to be 0.
+.TP
+.B
+c
+Chaco format. This is an adjacency graph
+format, also used by MeTiS.
+.TP
+.B
+m
+Matrix Market format. This is a matrix format
+describing individual edges. Matrix pattern is
+symmetrized, such that rectangular matrices are
+eventually squared.
+.TP
+.B
+s
+Scotch graph format. This is an adjacency graph format.
+.RE
+.TP
+.B
+\fB-o\fP\fIofmt\fP
+Set format of output graph file, which can be:
+.RS
+.TP
+.B
+c
+Chaco format.
+.TP
+.B
+m
+Matrix Market symmetric pattern format.
+.TP
+.B
+s
+Scotch format. This is the default.
+.RE
+.TP
+.B
+\fB-V\fP
+Display program version and copyright.
+.SH EXAMPLE
+Convert a Matrix Market graph into a Scotch graph. Matrix Market
+files do not comprise geometry data, so no geometry file is needed
+on output:
+.PP
+.nf
+.fam C
+    $ gcv -im brol.mm brol.grf
+
+.fam T
+.fi
+.SH SEE ALSO
+\fBgtst\fP(1), \fBgmap\fP(1), \fBgord\fP(1), \fBgout\fP(1).
+.PP
+Scotch user's manual.
+.SH AUTHOR
+Francois Pellegrini <francois.pellegrini@labri.fr>

scotch_6.0.3/man/man1/gmap.1

@@ -0,0 +1,180 @@
+." Text automatically generated by txt2man
+.TH gmap 1 "August 03, 2010" "" "Scotch user's manual"
+.SH NAME
+\fBgmap, gpart \fP- compute static mappings and partitions sequentially
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBgmap\fP [\fIoptions\fP] [\fIgfile\fP] [\fItfile\fP] [\fImfile\fP] [\fIlfile\fP]
+.PP
+\fBgpart\fP [\fIoptions\fP] [\fInparts\fP] [\fIgfile\fP] [\fImfile\fP] [\fIlfile\fP]
+.fam T
+.fi
+.SH DESCRIPTION
+The \fBgmap\fP program computes, in a sequential way, a static mapping of a
+source graph onto a target graph.
+.PP
+The \fBgpart\fP program is a shortcut of \fBgmap\fP for computing unweighted
+partitions of a source graph.
+.PP
+Source graph file \fIgfile\fP can only be a centralized graph file. For \fBgmap\fP,
+the target architecture file \fItfile\fP describes either algorithmically-coded
+topologies such as meshes and hypercubes, or decomposition-defined
+architectures created by means of the \fBamk_grf\fP(1) program. The resulting
+mapping is stored in file \fImfile\fP. Eventual logging information (such
+as the one produced by option \fB-v\fP) is sent to file \fIlfile\fP. When file
+names are not specified, data is read from standard input and
+written to standard output. Standard streams can also be explicitely
+represented by a dash '-'.
+.PP
+When the proper libraries have been included at compile time, \fBgmap\fP
+and \fBgpart\fP can directly handle compressed graphs, both as input and
+output. A stream is treated as compressed whenever its name is
+postfixed with a compressed file extension, such as
+in 'brol.grf.bz2' or '-.gz'. The compression formats which can be
+supported are the bzip2 format ('.bz2'), the gzip format ('.gz'),
+and the lzma format ('.lzma', on input only).
+.SH OPTIONS
+.TP
+.B
+\fB-c\fPopt
+Choose default mapping strategy according to one or
+several \fIoptions\fP among:
+.RS
+.TP
+.B
+b
+enforce load balance as much as possible.
+.TP
+.B
+q
+privilege quality over speed (default).
+.TP
+.B
+s
+privilege speed over quality.
+.TP
+.B
+t
+enforce safety.
+.RE
+.TP
+.B
+\fB-h\fP
+Display some help.
+.TP
+.B
+\fB-m\fPstrat
+Use sequential mapping strategy strat (see
+Scotch user's manual for more information).
+.TP
+.B
+\fB-V\fP
+Display program version and copyright.
+.TP
+.B
+\fB-v\fPverb
+Set verbose mode to verb. It is a set of one of more
+characters which can be:
+.RS
+.TP
+.B
+m
+mapping information.
+.TP
+.B
+s
+strategy information.
+.TP
+.B
+t
+timing information.
+.SH TARGET ARCHITECTURES
+Target architectures represent graphs onto which source graphs are
+mapped. In order to speed-up the obtainment of target architecture
+topological properties during the computation of mappings, some
+classical topologies are algorithmically coded into the mapper
+itself. These topologies are consequently simply defined by their
+code name, followed by their dimensional parameters:
+.TP
+.B
+cmplt \fIdim\fP
+unweighted complete graph of size \fIdim\fP.
+.TP
+.B
+cmpltw \fIdim\fP \fIw0\fP \fIw1\fP \.\.\. \fIwdim-1\fP
+weighted complete graph of size
+size and of respective loads
+\fIw0\fP, \fIw1\fP, \.\.\., \fIwdim-1\fP.
+.TP
+.B
+hcub \fIdim\fP
+hypercube of dimension \fIdim\fP.
+.TP
+.B
+leaf \fIhgt\fP \fIn0\fP \fIw0\fP \.\.\. \fInhgt-1\fP \fIwhgt-1\fP
+tree-leaf graph of height \fIhgt\fP
+with (\fIn0\fP times \fIn1\fP times \.\.\. \fInhgt-1\fP)
+vertices, with inter-cluster link
+weights of \fIw0\fP, \fIw1\fP, \.\.\. \fIwhgt-1\fP.
+.TP
+.B
+mesh2D \fIdimX\fP \fIdimY\fP
+2D mesh of \fIdimX\fP times \fIdimY\fP nodes.
+.TP
+.B
+mesh3D \fIdimX\fP \fIdimY\fP \fIdimZ\fP
+23 mesh of \fIdimX\fP times \fIdimY\fP times \fIdimZ\fP nodes.
+.TP
+.B
+torus2D \fIdimX\fP \fIdimY\fP
+2D torus of \fIdimX\fP times \fIdimY\fP nodes.
+.TP
+.B
+torus3D \fIdimX\fP \fIdimY\fP \fIdimZ\fP
+3D torus of \fIdimX\fP times \fIdimY\fP times \fIdimZ\fP nodes.
+.PP
+Other target topologies can be created from their source graph
+description by using the \fBamk_grf\fP(1) command. In this case, the
+target description will begin with the code name \fBdeco\fP.
+.SH MAPPINGS
+Mappings are represented by as many lines as there are vertices in
+the source graph. Each of these lines is made of two figures: the
+number of the vertex (or its label if source graph vertices are
+labeled) and the index of the target vertex to which it has been
+assigned. Target vertex indices range from 0 to the number of
+vertices in the target architecture (that is, the number of parts)
+minus one.
+.PP
+This block of lines is always preceded by the number of such
+lines. In most cases, since full mappings are requested, the number
+of lines is equal to the number of vertices in the source graph.
+.SH EXAMPLES
+Run \fBgpart\fP to compute a partition into 7 parts of graph 'brol.grf' and
+save the resulting ordering to file 'brol.map'.
+.PP
+.nf
+.fam C
+    $ gpart 7 brol.grf brol.map
+
+.fam T
+.fi
+Run \fBgmap\fP to compute a partition, into 3 parts of respective weights
+1, 2 and 4, of graph 'brol.grf' and save the resulting mapping to
+file 'brol.map'. The dash '-' standard file name is used so that the
+target architecture description is read from the standard input,
+through the pipe, as provided by the 'echo' shell command.
+.PP
+.nf
+.fam C
+    $ echo "cmpltw 3 1 2 4" | gmap brol.grf - brol.map
+
+.fam T
+.fi
+.SH SEE ALSO
+\fBamk_grf\fP(1), \fBacpl\fP(1), \fBgmtst\fP(1), \fBdgmap\fP(1).
+.PP
+Scotch user's manual.
+.SH AUTHOR
+Francois Pellegrini <francois.pellegrini@labri.fr>

scotch_6.0.3/man/man1/gmk_hy.1

@@ -0,0 +1,74 @@
+." Text automatically generated by txt2man
+.TH gmk_hy 1 "August 03, 2010" "" "Scotch user's manual"
+.SH NAME
+\fBgmk_hy, gmk_m2, gmk_m3, gmk_ub2 \fP- create source graphs
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBgmk_hy\fP [\fIoptions\fP] \fIdim\fP [\fIofile\fP]
+.PP
+\fBgmk_m2\fP [\fIoptions\fP] [\fB-g\fP\fIcfile\fP] \fIdimX\fP \fIdimY\fP [\fIofile\fP]
+.PP
+\fBgmk_m3\fP [\fIoptions\fP] [\fB-g\fP\fIcfile\fP] \fIdimX\fP \fIdimY\fP \fIdimZ\fP [\fIofile\fP]
+.PP
+\fBgmk_ub2\fP [\fIoptions\fP] \fIdim\fP
+.fam T
+.fi
+.SH DESCRIPTION
+The \fBgmk_\fP* programs create source graph files for some common,
+regular topologies.
+.PP
+\fBgmk_hy\fP creates a hypercube of dimension \fIdim\fP.
+.PP
+\fBgmk_m2\fP creates a 2D regular grid of dimensions \fIdimX\fP and \fIdimY\fP.
+.PP
+\fBgmk_m3\fP creates a 3D regular grid of dimensions \fIdimX\fP, \fIdimY\fP and \fIdimZ\fP.
+.PP
+\fBgmk_ub2\fP creates an unoriented de Bruijn graph of dimension \fIdim\fP.
+.SH OPTIONS
+.TP
+.B
+\fB-b\fP base
+For \fBgmk_m2\fP and \fBgmk_m3\fP only. Output graphs with base
+value set to base. Default value is 0.
+.TP
+.B
+\fB-e\fP
+For \fBgmk_m2\fP only. Build a 8-neighbor grid rather than a
+4-neighbor grid.
+.TP
+.B
+\fB-g\fP\fIcfile\fP
+For \fBgmk_m2\fP and \fBgmk_m3\fP only. Output graph vertex
+coordinates (that is, geometry data to be used by
+\fBgout\fP(1)) in file \fIcfile\fP.
+.TP
+.B
+\fB-h\fP
+Display some help.
+.TP
+.B
+\fB-t\fP
+For \fBgmk_m2\fP and \fBgmk_m3\fP only. Create torus graphs, that
+is, graphs such that there exist loop edges between
+vertices of rank 0 and (\fIdim\fP-1) in every dimension.
+.TP
+.B
+\fB-V\fP
+Display program version and copyright.
+.SH EXAMPLE
+Create a 5x7 grid along with its geometry:
+.PP
+.nf
+.fam C
+    $ gmk_m2 5 7 -g/tmp/m5x7.xyz /tmp/m5x7.grf
+
+.fam T
+.fi
+.SH SEE ALSO
+\fBgmk_msh\fP(1), \fBgtst\fP(1), \fBgmap\fP(1), \fBgord\fP(1), \fBgout\fP(1), \fBamk_grf\fP(1).
+.PP
+Scotch user's manual.
+.SH AUTHOR
+Francois Pellegrini <francois.pellegrini@labri.fr>

scotch_6.0.3/man/man1/gmk_m2.1

@@ -0,0 +1 @@
+.so man1/gmk_hy.1

scotch_6.0.3/man/man1/gmk_m3.1

@@ -0,0 +1 @@
+.so man1/gmk_hy.1

scotch_6.0.3/man/man1/gmk_msh.1

@@ -0,0 +1,41 @@
+." Text automatically generated by txt2man
+.TH gmk_msh 1 "August 03, 2010" "" "Scotch user's manual"
+.SH NAME
+\fBgmk_msh \fP- create source graph from source mesh
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBgmk_msh\fP [\fIoptions\fP] [\fImfile\fP] [\fIgfile\fP]
+.fam T
+.fi
+.SH DESCRIPTION
+The \fBgmk_msh\fP program creates a source graph from a source mesh.
+The vertices of the graph are the nodes of the mesh, and all mesh
+elements are turned into cliques, that is, there exists an edge
+between two vertices in the graph if there exists at least an
+element in the mesh which comprises the two associated nodes.
+.SH OPTIONS
+.TP
+.B
+\fB-h\fP
+Display some help.
+.TP
+.B
+\fB-V\fP
+Display program version and copyright.
+.SH EXAMPLE
+Create a source graph brol.grf from a source mesh brol.msh:
+.PP
+.nf
+.fam C
+    $ gmk_msh brol.msh brol.grf
+
+.fam T
+.fi
+.SH SEE ALSO
+dgmap (1), \fBdgord\fP(1), \fBgmap\fP(1), \fBgord\fP(1), \fBgtst\fP(1), \fBmmk_m2\fP(1), \fBmord\fP(1), \fBmcv\fP(1), \fBmtst\fP(1).
+.PP
+Scotch user's manual.
+.SH AUTHOR
+Francois Pellegrini <francois.pellegrini@labri.fr>

scotch_6.0.3/man/man1/gmk_ub2.1

@@ -0,0 +1 @@
+.so man1/gmk_hy.1

scotch_6.0.3/man/man1/gmtst.1

@@ -0,0 +1,72 @@
+." Text automatically generated by txt2man
+.TH gmtst 1 "August 03, 2010" "" "Scotch user's manual"
+.SH NAME
+\fBgmtst \fP- compute statistics on mappings
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBgmtst\fP [\fIoptions\fP] [\fIgfile\fP] [\fItfile\fP] [\fImfile\fP] [\fIlfile\fP]
+.fam T
+.fi
+.SH DESCRIPTION
+The \fBgmtst\fP program computes, in a sequential way, statistics on a
+static mapping, such as load imbalance ratio, edge dilation
+distribution, etc. It yields the same results as the ones produced
+by the \fB-vm\fP option of the \fBgmap\fP(1) program.
+.PP
+Source graph file \fIgfile\fP can only be a centralized graph file. File
+\fItfile\fP represents the target architecture onto which \fIgfile\fP was
+mapped. If mapping file \fImfile\fP was produced by \fBgpart\fP(1), the target
+architecture file to provide \fBgmtst\fP should describe a complete graph
+with the same number of vertices as the requested number of parts,
+for instance by means of the '\fBcmplt\fP \fInum\fP' algorithmically-described
+architecture. The resulting statistics are stored in file
+\fIlfile\fP. When file names are not specified, data is read from standard
+input and written to standard output. Standard streams can also be
+explicitly represented by a dash '-'.
+.PP
+When the proper libraries have been included at compile time, gtst
+can directly handle compressed graphs, both as input and output. A
+stream is treated as compressed whenever its name is postfixed with
+a compressed file extension, such as in 'brol.grf.bz2' or '-.gz'. The
+compression formats which can be supported are the bzip2 format
+('.bz2'), the gzip format ('.gz'), and the lzma format ('.lzma', on
+input only).
+.SH OPTIONS
+.TP
+.B
+\fB-h\fP
+Display some help.
+.TP
+.B
+\fB-V\fP
+Display program version and copyright.
+.SH EXAMPLES
+Display statistics on mapping brol.map of graph brol.grf onto target
+architecture brol.tgt:
+.PP
+.nf
+.fam C
+    $ gmtst brol.grf brol.tgt brol.map
+
+.fam T
+.fi
+Display statistics on partitioning brol.map of graph brol.grf into
+\fInum\fP parts. Note the use of the complete graph
+algorithmically-described architecture and of the shell pipe command
+to provide the complete target architecture description on the
+standard input of the \fBgmtst\fP command:
+.PP
+.nf
+.fam C
+    $ echo "cmplt num" | gmtst brol.grf - brol.map
+
+.fam T
+.fi
+.SH SEE ALSO
+\fBgmap\fP(1), \fBgout\fP(1), \fBgtst\fP(1).
+.PP
+Scotch user's manual.
+.SH AUTHOR
+Francois Pellegrini <francois.pellegrini@labri.fr>

scotch_6.0.3/man/man1/gord.1

@@ -0,0 +1,112 @@
+." Text automatically generated by txt2man
+.TH gord 1 "August 03, 2010" "" "Scotch user's manual"
+.SH NAME
+\fBgord \fP- compute sparse matrix orderings of graphs
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBgord\fP [\fIoptions\fP] [\fIgfile\fP] [\fIofile\fP] [\fIlfile\fP]
+.fam T
+.fi
+.SH DESCRIPTION
+The \fBgord\fP program computes, in a sequential way, an ordering of a
+Scotch source graph representing the pattern of some symmetric
+sparse matrix.
+.PP
+Source graph file \fIgfile\fP can only be a centralized graph file. The
+resulting ordering is stored in file \fIofile\fP. Eventual logging
+information (such as the one produced by option \fB-v\fP) is sent to file
+\fIlfile\fP. When file names are not specified, data is read from standard
+input and written to standard output. Standard streams can also be
+explicitely represented by a dash '-'.
+.PP
+When the proper libraries have been included at compile time, \fBgord\fP
+can directly handle compressed graphs, both as input and output. A
+stream is treated as compressed whenever its name is postfixed with
+a compressed file extension, such as in 'brol.grf.bz2' or '-.gz'. The
+compression formats which can be supported are the bzip2 format
+('.bz2'), the gzip format ('.gz'), and the lzma format ('.lzma', on
+input only).
+.SH OPTIONS
+.TP
+.B
+\fB-c\fPopt
+Choose default ordering strategy according to one or
+several \fIoptions\fP among:
+.RS
+.TP
+.B
+b
+enforce load balance as much as possible.
+.TP
+.B
+q
+privilege quality over speed (default).
+.TP
+.B
+s
+privilege speed over quality.
+.TP
+.B
+t
+enforce safety.
+.RE
+.TP
+.B
+\fB-h\fP
+Display some help.
+.TP
+.B
+\fB-m\fP\fImfile\fP
+Save column block mapping data to file \fImfile\fP. Mapping
+data specifies, for each vertex, the index of the column
+block to which this vertex belongs.
+.TP
+.B
+\fB-o\fP\fIstrat\fP
+Use sequential graph ordering strategy \fIstrat\fP (see
+Scotch user's manual for more information).
+.TP
+.B
+\fB-t\fP\fItfile\fP
+Save partitioning tree data to file \fItfile\fP. Partitioning
+tree data specifies, for each vertex, the index of the
+first vertex of the parent block of the block to which
+the vertex belongs. Altogether with the mapping data
+provided in file \fImfile\fP, it allows one to rebuild the
+separator tree of the nested dissection process.
+.TP
+.B
+\fB-V\fP
+Display program version and copyright.
+.TP
+.B
+\fB-v\fP\fIverb\fP
+Set verbose mode to \fIverb\fP. It is a set of one of more
+characters which can be:
+.RS
+.TP
+.B
+s
+strategy information.
+.TP
+.B
+t
+timing information.
+.SH EXAMPLE
+Reorder matrix graph brol.grf and save the resulting ordering to
+file brol.ord using the default sequential graph ordering strategy:
+.PP
+.nf
+.fam C
+    $ gord brol.grf brol.ord
+
+.fam T
+.fi
+.SH SEE ALSO
+\fBdgord\fP(1), \fBgmk_hy\fP(1), \fBgtst\fP(1).
+.PP
+Scotch user's manual.
+.SH AUTHOR
+Francois Pellegrini <francois.pellegrini@labri.fr>

scotch_6.0.3/man/man1/gotst.1

@@ -0,0 +1,60 @@
+." Text automatically generated by txt2man
+.TH gotst 1 "August 03, 2010" "" "Scotch user's manual"
+.SH NAME
+\fBgomtst \fP- compute statistics on sparse matrix orderings
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBgotst\fP [\fIoptions\fP] [\fIgfile\fP] [\fIofile\fP] [\fIlfile\fP]
+.fam T
+.fi
+.SH DESCRIPTION
+The \fBgotst\fP program computes, in a sequential way, statistics on a
+sparse matrix ordering, such as fill-in, operation count, and
+separator tree parameters: minimum, maximum, average height and
+variance of its leaves.
+.PP
+Source graph file \fIgfile\fP can only be a centralized graph file. File
+\fIofile\fP represents the ordering of the symmetric sparse matrix the
+pattern of which is represented by \fIgfile\fP. The resulting statistics
+are stored in file \fIlfile\fP. When file names are not specified, data is
+read from standard input and written to standard output. Standard
+streams can also be explicitly represented by a dash '-'.
+.PP
+When the proper libraries have been included at compile time, gtst
+can directly handle compressed graphs, both as input and output. A
+stream is treated as compressed whenever its name is postfixed with
+a compressed file extension, such as in 'brol.grf.bz2' or '-.gz'. The
+compression formats which can be supported are the bzip2 format
+('.bz2'), the gzip format ('.gz'), and the lzma format ('.lzma', on
+input only).
+.PP
+Since \fBgotst\fP performs sequentially the symbolic factorization of
+matrix \fIgfile\fP in order to compute fill-in and operation count
+numbers, this program can take a long time or even run out of memory,
+when applied to very large graphs.
+.SH OPTIONS
+.TP
+.B
+\fB-h\fP
+Display some help.
+.TP
+.B
+\fB-V\fP
+Display program version and copyright.
+.SH EXAMPLE
+Display statistics on ordering brol.ord of graph brol.grf:
+.PP
+.nf
+.fam C
+    $ gotst brol.grf brol.ord
+
+.fam T
+.fi
+.SH SEE ALSO
+\fBgord\fP(1), \fBgtst\fP(1), \fBdgord\fP(1).
+.PP
+Scotch user's manual.
+.SH AUTHOR
+Francois Pellegrini <francois.pellegrini@labri.fr>

scotch_6.0.3/man/man1/gout.1

@@ -0,0 +1,268 @@
+." Text automatically generated by txt2man
+.TH gout 1 "August 03, 2010" "" "Scotch user's manual"
+.SH NAME
+\fBgout \fP- output graphics from matrices and graphs
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBgout\fP [\fIoptions\fP] [\fIgfile\fP] [\fIxfile\fP] [\fImfile\fP] [\fIvfile\fP]
+.fam T
+.fi
+.SH DESCRIPTION
+The \fBgout\fP program creates graphics files of various types,
+representing the Scotch graph and mapping data which is passed to it.
+.PP
+Source graph file \fIgfile\fP can only be a centralized graph file. File
+\fIxfile\fP stores its associated geometry, whenever necessary. File
+\fImfile\fP represents label information attached to each of the graph
+vertices, for instance the index of the part to which each vertex
+belongs in the case of a mapping file. File \fIvfile\fP is the output
+graphics file, the type of which may differ according to the input
+parameters. When file names are not specified, data is read from
+standard input and written to standard output. Standard streams can
+also be explicitly represented by a dash '-'.
+.PP
+When the proper libraries have been included at compile time, gtst
+can directly handle compressed graphs, both as input and output. A
+stream is treated as compressed whenever its name is postfixed with
+a compressed file extension, such as in 'brol.grf.bz2' or '-.gz'. The
+compression formats which can be supported are the bzip2 format
+('.bz2'), the gzip format ('.gz'), and the lzma format ('.lzma', on
+input only).
+.SH OPTIONS
+.TP
+.B
+\fB-h\fP
+Display some help.
+.TP
+.B
+\fB-g\fP\fIgeop\fP
+Geometry parameters, which can be an arbitrary
+combination of any of the following code letters:
+.RS
+.TP
+.B
+n
+Do not read geometry data, when it is not
+available or not required, such as when using
+the \fB-om\fP option.
+.TP
+.B
+p
+Permute Y and Z geometry dimensions.
+.TP
+.B
+r
+Rotate geometry by 90 degrees in the (X,Y) plane.
+.RE
+.TP
+.B
+\fB-h\fP
+Display some help.
+.TP
+.B
+\fB-mn\fP
+Do not read mapping data, when it is not available or
+not required.
+.TP
+.B
+\fB-o\fP\fIoutp\fP
+Select the output file type and allows to provide
+additional parameters between braces and separated
+by commas:
+.RS
+.TP
+.B
+i
+OpenInventor 3D mesh file, to be viewed by means of
+programs such as \fBivview\fP. Additional parameters for
+this output file type are:
+.RS
+.TP
+.B
+c
+Color output.
+.TP
+.B
+g
+Gray level output.
+.TP
+.B
+r
+Remove cut edges.
+.TP
+.B
+v
+View cut edges.
+.RE
+.TP
+.B
+m
+PostScript matrix pattern file. Additional parameters
+for this output file type are:
+.RS
+.TP
+.B
+e
+EPSF-type output.
+.TP
+.B
+f
+Full-page output.
+.RE
+.TP
+.B
+p
+PostScript 2D mesh file. This output module was
+intended for 2D meshes; as a fallback, the Z
+coordinate is projected according to isometric
+perspective rules, but drawings of full 3D objects
+are most likely to be unreadable. Additional parameters
+for this output file type are:
+.RS
+.TP
+.B
+c
+Color output.
+.TP
+.B
+g
+Gray level output.
+.TP
+.B
+e
+EPSF-type output.
+.TP
+.B
+f
+Full-page output.
+.TP
+.B
+s
+Short clipping (disks excluded).
+.TP
+.B
+l
+Large clipping (disks included).
+.TP
+.B
+a
+Avoid displaying disks.
+.TP
+.B
+d
+Display disks.
+.TP
+.B
+r
+Remove cut edges.
+.TP
+.B
+v
+View cut edges.
+.TP
+.B
+X=\fIrat\fP
+Maximum x clipping ratio (in [0.0;1.0]).
+.TP
+.B
+x=\fIrat\fP
+Minimum x clipping ratio.
+.TP
+.B
+Y=\fIrat\fP
+Maximum y clipping ratio.
+.TP
+.B
+y=\fIrat\fP
+Minimum y clipping ratio.
+.RE
+.TP
+.B
+t
+Tulip 3D mesh file. Additional parameters
+for this output file type are:
+.RS
+.TP
+.B
+b
+Black and white output.
+.TP
+.B
+c
+Color output.
+.TP
+.B
+a
+Avoid displaying disks.
+.TP
+.B
+d
+Display disks.
+.TP
+.B
+r
+Remove cut edges.
+.TP
+.B
+v
+View cut edges.
+.RE
+.RE
+.TP
+.B
+\fB-V\fP
+Display program version and copyright.
+.SH EXAMPLES
+Build an OpenInventor file of the mapping of graph brol.grf
+contained in file brol.map. Vertices with no mapping information
+attached to them will be rendered in white, while distinct colors
+will be used to represent the different parts. Cut edges will be
+removed:
+.PP
+.nf
+.fam C
+    $ gout '-oi{r}' brol.grf brol.xyz brol.map brol.iv
+    $ ivview brol.iv
+
+.fam T
+.fi
+Build an OpenInventor file of graph brol.grf without any vertex
+information associated to it. Mapping data are not required and
+will not be read, but a file name has to be provided, hence the
+'-':
+.PP
+.nf
+.fam C
+    $ gout -oi -mn brol.grf brol.xyz - brol.iv
+
+.fam T
+.fi
+Output the pattern of matrix brol.grf on the form of a PostScript
+flat drawing. Geometry and mapping data are not required and will
+not be read, but file names have to be provided, hence the
+two '-'s:
+.PP
+.nf
+.fam C
+    $ gout -om -gn -mn brol.grf - - brol.ps
+
+.fam T
+.fi
+Output a PostScript 2D drawing of a rectangular portion graph
+brol.grf, with disks representing mapping data:
+.PP
+.nf
+.fam C
+    $ gout '-op{c,e,d,x=0.3,X=0.6,y=0.2,Y=0.5}' brol.grf brol.xyz brol.map brol.ps
+
+
+.fam T
+.fi
+.SH SEE ALSO
+\fBgmap\fP(1), \fBgout\fP(1), \fBgtst\fP(1).
+.PP
+Scotch user's manual.
+.SH AUTHOR
+Francois Pellegrini <francois.pellegrini@labri.fr>

scotch_6.0.3/man/man1/gpart.1

@@ -0,0 +1 @@
+.so man1/gmap.1

scotch_6.0.3/man/man1/gtst.1

@@ -0,0 +1,57 @@
+." Text automatically generated by txt2man
+.TH gtst 1 "August 03, 2010" "" "Scotch user's manual"
+.SH NAME
+\fBgtst \fP- test the consistency of source graphs
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBgtst\fP [\fIoptions\fP] [\fIgfile\fP] [\fIlfile\fP]
+.fam T
+.fi
+.SH DESCRIPTION
+The \fBgtst\fP program checks, in a sequential way, the consistency of a
+Scotch source graph and, in case of success, outputs some statistics
+regarding edge weights, vertex weights, and vertex degrees.
+.PP
+It produces the very same results as the \fBdgtst\fP(1) program of the
+PT-Scotch parallel distribution, but unlike this latter it cannot
+handle distributed graphs.
+.PP
+Source graph file \fIgfile\fP can only be a centralized graph file. The
+resulting statistics are stored in file \fIlfile\fP. When file names are
+not specified, data is read from standard input and written to
+standard output. Standard streams can also be explicitly
+represented by a dash '-'.
+.PP
+When the proper libraries have been included at compile time, \fBgtst\fP
+can directly handle compressed graphs, both as input and output. A
+stream is treated as compressed whenever its name is postfixed with
+a compressed file extension, such as in 'brol.grf.bz2' or '-.gz'. The
+compression formats which can be supported are the bzip2 format
+('.bz2'), the gzip format ('.gz'), and the lzma format ('.lzma', on
+input only).
+.SH OPTIONS
+.TP
+.B
+\fB-h\fP
+Display some help.
+.TP
+.B
+\fB-V\fP
+Display program version and copyright.
+.SH EXAMPLE
+Test the consistency of graph brol.grf:
+.PP
+.nf
+.fam C
+    $ gtst brol.grf
+
+.fam T
+.fi
+.SH SEE ALSO
+\fBdgtst\fP(1), \fBgmap\fP(1), \fBgord\fP(1), \fBgout\fP(1).
+.PP
+Scotch user's manual.
+.SH AUTHOR
+Francois Pellegrini <francois.pellegrini@labri.fr>

scotch_6.0.3/man/man1/mmk_m2.1

@@ -0,0 +1,55 @@
+." Text automatically generated by txt2man
+.TH mmk_m2 1 "August 03, 2010" "" "Scotch user's manual"
+.SH NAME
+\fBmmk_m2, mmk_m3 \fP- create source meshes
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBmmk_m2\fP [\fIoptions\fP] [\fB-g\fP\fIcfile\fP] \fIdimX\fP \fIdimY\fP [\fIofile\fP]
+.PP
+\fBmmk_m3\fP [\fIoptions\fP] [\fB-g\fP\fIcfile\fP] \fIdimX\fP \fIdimY\fP \fIdimZ\fP [\fIofile\fP]
+.fam T
+.fi
+.SH DESCRIPTION
+The \fBmmk_\fP* programs create source mesh files for some common,
+regular topologies.
+.PP
+\fBmmk_m2\fP creates a 2D regular mesh of \fIdimX\fP times \fIdimY\fP elements and
+(\fIdimX\fP+1) times (\fIdimY\fP+1) nodes, such that element (i,j) is
+connected to nodes (i,j), (i,j+1), (i+1,j) and (i+1,j+1).
+.PP
+\fBmmk_m3\fP creates a 3D regular mesh of \fIdimX\fP times \fIdimY\fP times \fIdimZ\fP
+elements and (\fIdimX\fP+1) times (\fIdimY\fP+1) times (\fIdimZ\fP+1) nodes,
+such that element (i,j,k) is connected to nodes (i,j,k), (i,j,k+1),
+(i,j+1,k), (i,j+1,k+1), (i+1,j,k), (i+1,j,k+1), (i+1,j+1,k) and
+(i+1,j+1,k+1).
+.SH OPTIONS
+.TP
+.B
+\fB-g\fP\fIcfile\fP
+Output graph vertex coordinates (that is, geometry data to be used by
+\fBgout\fP(1)) in file \fIcfile\fP.
+.TP
+.B
+\fB-h\fP
+Display some help.
+.TP
+.B
+\fB-V\fP
+Display program version and copyright.
+.SH EXAMPLE
+Create a mesh of 5x7 elements, along with its geometry:
+.PP
+.nf
+.fam C
+    $ mmk_m2 5 7 -g/tmp/m5x7.xyz /tmp/m5x7.msh
+
+.fam T
+.fi
+.SH SEE ALSO
+\fBmord\fP(1), \fBmtst\fP(1), \fBgmk_msh\fP(1).
+.PP
+Scotch user's manual.
+.SH AUTHOR
+Francois Pellegrini <francois.pellegrini@labri.fr>

scotch_6.0.3/man/man1/mmk_m3.1

@@ -0,0 +1 @@
+.so man1/mmk_m2.1

scotch_6.0.3/man/man1/mord.1

@@ -0,0 +1,115 @@
+." Text automatically generated by txt2man
+.TH mord 1 "August 03, 2010" "" "Scotch user's manual"
+.SH NAME
+\fBmord \fP- compute sparse matrix orderings of meshes
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBmord\fP [\fIoptions\fP] [\fImfile\fP] [\fIofile\fP] [\fIlfile\fP]
+.fam T
+.fi
+.SH DESCRIPTION
+The \fBmord\fP program computes, in a sequential way, an ordering of a
+Scotch source mesh representing the pattern of some symmetric sparse
+matrix. Only nodes of the mesh are effectively ordered. Elements
+provide connectivity information, such that every node is considered
+to be linked to all of the nodes which share at least an element
+with it.
+.PP
+Source mesh file \fImfile\fP can only be a centralized mesh file. The
+resulting ordering is stored in file \fIofile\fP. Eventual logging
+information (such as the one produced by option \fB-v\fP) is sent to file
+\fIlfile\fP. When file names are not specified, data is read from standard
+input and written to standard output. Standard streams can also be
+explicitely represented by a dash '-'.
+.PP
+When the proper libraries have been included at compile time, gord
+can directly handle compressed meshes, both as input and output. A
+stream is treated as compressed whenever its name is postfixed with
+a compressed file extension, such as in 'brol.msh.bz2' or '-.gz'. The
+compression formats which can be supported are the bzip2 format
+('.bz2'), the gzip format ('.gz'), and the lzma format ('.lzma', on
+input only).
+.SH OPTIONS
+.TP
+.B
+\fB-c\fPopt
+Choose default ordering strategy according to one or
+several \fIoptions\fP among:
+.RS
+.TP
+.B
+b
+enforce load balance as much as possible.
+.TP
+.B
+q
+privilege quality over speed (default).
+.TP
+.B
+s
+privilege speed over quality.
+.TP
+.B
+t
+enforce safety.
+.RE
+.TP
+.B
+\fB-h\fP
+Display some help.
+.TP
+.B
+\fB-m\fP\fImfile\fP
+Save column block mapping data to file \fImfile\fP. Mapping data
+specifies, for each node vertex, the index of the column
+block to which this node vertex belongs.
+.TP
+.B
+\fB-o\fP\fIstrat\fP
+Use sequential mesh ordering strategy \fIstrat\fP (see
+Scotch user's manual for more information).
+.TP
+.B
+\fB-t\fP\fItfile\fP
+Save partitioning tree data to file \fItfile\fP. Partitioning
+tree data specifies, for each node vertex, the index of the
+first node vertex of the parent block of the block to which
+the node vertex belongs. Altogether with the mapping data
+provided in file \fImfile\fP, it allows one to rebuild the
+separator tree of the nested dissection process.
+.TP
+.B
+\fB-V\fP
+Display program version and copyright.
+.TP
+.B
+\fB-v\fP\fIverb\fP
+Set verbose mode to \fIverb\fP. It is a set of one of more
+characters which can be:
+.RS
+.TP
+.B
+s
+strategy information.
+.TP
+.B
+t
+timing information.
+.SH EXAMPLE
+Reorder matrix mesh brol.msh and save the resulting ordering to
+file brol.ord using the default sequential mesh ordering strategy:
+.PP
+.nf
+.fam C
+    $ mord brol.msh brol.ord
+
+.fam T
+.fi
+.SH SEE ALSO
+\fBgmk_msh\fP(1), \fBgotst\fP(1), \fBmtst\fP(1).
+.PP
+Scotch user's manual.
+.SH AUTHOR
+Francois Pellegrini <francois.pellegrini@labri.fr>

scotch_6.0.3/man/man1/mtst.1

@@ -0,0 +1,54 @@
+." Text automatically generated by txt2man
+.TH mtst 1 "August 03, 2010" "" "Scotch user's manual"
+.SH NAME
+\fBmtst \fP- test the consistency of source meshes
+\fB
+.SH SYNOPSIS
+.nf
+.fam C
+\fBmtst\fP [\fIoptions\fP] [\fImfile\fP] [\fIlfile\fP]
+.fam T
+.fi
+.SH DESCRIPTION
+The \fBmtst\fP program checks, in a sequential way, the consistency of a
+Scotch source mesh and, in case of success, outputs some statistics
+regarding edge weights, node and element vertex weights, and node
+and element vertex degrees.
+.PP
+Source mesh file \fImfile\fP can only be a centralized mesh file. The
+resulting statistics are stored in file \fIlfile\fP. When file names are
+not specified, data is read from standard input and written to
+standard output. Standard streams can also be explicitly
+represented by a dash '-'.
+.PP
+When the proper libraries have been included at compile time, \fBmtst\fP
+can directly handle compressed meshes, both as input and output. A
+stream is treated as compressed whenever its name is postfixed with
+a compressed file extension, such as in 'brol.msh.bz2' or '-.gz'. The
+compression formats which can be supported are the bzip2 format
+('.bz2'), the gzip format ('.gz'), and the lzma format ('.lzma', on
+input only).
+.SH OPTIONS
+.TP
+.B
+\fB-h\fP
+Display some help.
+.TP
+.B
+\fB-V\fP
+Display program version and copyright.
+.SH EXAMPLE
+Test the consistency of mesh brol.msh:
+.PP
+.nf
+.fam C
+    $ mtst brol.msh
+
+.fam T
+.fi
+.SH SEE ALSO
+\fBmord\fP(1), \fBgrf_msh\fP(1).
+.PP
+Scotch user's manual.
+.SH AUTHOR
+Francois Pellegrini <francois.pellegrini@labri.fr>

scotch_6.0.3/src/Make.inc/Makefile.inc.alpha_dec_osf1

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= gmake
+AR		= ar
+ARFLAGS		= ruv
+CAT		= cat
+CCS		= cc
+CCP		= mpicc
+CCD		= mpicc
+CFLAGS		= -v -O3 -omp -ansi_alias -ansi_args -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_PTHREAD -DSCOTCH_RENAME
+CLIBFLAGS	=
+LDFLAGS		= -lm
+CP		= cp
+LEX		= lex
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= yacc

scotch_6.0.3/src/Make.inc/Makefile.inc.i686_mac_darwin10

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= make
+AR		= ar
+ARFLAGS		= -ruv
+CAT		= cat
+CCS		= gcc
+CCP		= mpicc
+CCD		= gcc
+CFLAGS		= -O3 -Drestrict=__restrict -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_PTHREAD -DCOMMON_PTHREAD_BARRIER -DCOMMON_RANDOM_FIXED_SEED -DCOMMON_TIMING_OLD -DSCOTCH_PTHREAD -DSCOTCH_RENAME
+CLIBFLAGS	=
+LDFLAGS		= -lz -lm -lpthread
+CP		= cp
+LEX		= flex -Pscotchyy -olex.yy.c
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= bison -pscotchyy -y -b y

scotch_6.0.3/src/Make.inc/Makefile.inc.i686_mac_darwin10.icc

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= make
+AR		= ar
+ARFLAGS		= -ruv
+CAT		= cat
+CCS		= icc
+CCP		= mpicc
+CCD		= icc
+CFLAGS		= -O3 -restrict -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_PTHREAD -DCOMMON_PTHREAD_BARRIER -DCOMMON_RANDOM_FIXED_SEED -DCOMMON_TIMING_OLD -DSCOTCH_PTHREAD -DSCOTCH_RENAME
+CLIBFLAGS	=
+LDFLAGS		= -lz -lm
+CP		= cp
+LEX		= flex -Pscotchyy -olex.yy.c
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= bison -pscotchyy -y -b y

scotch_6.0.3/src/Make.inc/Makefile.inc.i686_mac_darwin8

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= make
+AR		= ar
+ARFLAGS		= -ruv
+CAT		= cat
+CCS		= gcc
+CCP		= mpicc
+CCD		= mpicc
+CFLAGS		= -O3 -Drestrict=__restrict -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DCOMMON_TIMING_OLD -DSCOTCH_PTHREAD -DSCOTCH_RENAME
+CLIBFLAGS	=
+LDFLAGS		= -lm
+CP		= cp
+LEX		= flex -Pscotchyy -olex.yy.c
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= bison -pscotchyy -y -b y

scotch_6.0.3/src/Make.inc/Makefile.inc.i686_pc_freebsd

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= gmake
+AR		= ar
+ARFLAGS		= -ruv
+CAT		= cat
+CCS		= cc
+CCP		= mpicc
+CCD		= mpicc
+CFLAGS		+= -std=c99 -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_PTHREAD -DSCOTCH_RENAME -DSCOTCH_RENAME_PARSER
+CLIBFLAGS	=
+LDFLAGS		+= -lz -lm -lpthread
+CP		= cp
+LEX		= flex -Pscotchyy -olex.yy.c
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= bison -pscotchyy -y -b y

scotch_6.0.3/src/Make.inc/Makefile.inc.i686_pc_linux2

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= make
+AR		= ar
+ARFLAGS		= -ruv
+CAT		= cat
+CCS		= gcc
+CCP		= mpicc
+CCD		= gcc
+CFLAGS		= -O3 -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_RENAME -DSCOTCH_PTHREAD -Drestrict=__restrict
+CLIBFLAGS	=
+LDFLAGS		= -lz -lm -pthread
+CP		= cp
+LEX		= flex -Pscotchyy -olex.yy.c
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= bison -pscotchyy -y -b y

scotch_6.0.3/src/Make.inc/Makefile.inc.i686_pc_linux2.c99

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= make
+AR		= ar
+ARFLAGS		= -ruv
+CAT		= cat
+CCS		= gcc
+CCP		= mpicc
+CCD		= gcc
+CFLAGS		= -std=c99 -O3 -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_RENAME -DSCOTCH_RENAME_PARSER -DSCOTCH_PTHREAD
+CLIBFLAGS	=
+LDFLAGS		= -lz -lm -pthread
+CP		= cp
+LEX		= flex -Pscotchyy -D_XOPEN_SOURCE=600 -olex.yy.c
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= bison -pscotchyy -y -b y

scotch_6.0.3/src/Make.inc/Makefile.inc.i686_pc_linux2.debug

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= make
+AR		= ar
+ARFLAGS		= -ruv
+CAT		= cat
+CCS		= gcc
+CCP		= mpicc
+CCD		= gcc
+CFLAGS		= -g -O0 -Drestrict=__restrict -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_PTHREAD -DSCOTCH_DEBUG_ALL -DSCOTCH_DETERMINISTIC -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_RENAME
+CLIBFLAGS	=
+LDFLAGS		= -g -lz -lm -pthread
+CP		= cp
+LEX		= flex -Pscotchyy -olex.yy.c
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= bison -pscotchyy -y -b y

scotch_6.0.3/src/Make.inc/Makefile.inc.i686_pc_linux2.nothreads

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= make
+AR		= ar
+ARFLAGS		= -ruv
+CAT		= cat
+CCS		= gcc
+CCP		= mpicc
+CCD		= gcc
+CFLAGS		= -O3 -Drestrict=__restrict -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_RENAME
+CLIBFLAGS	=
+LDFLAGS		= -lz -lm -pthread
+CP		= cp
+LEX		= flex -Pscotchyy -olex.yy.c
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= bison -pscotchyy -y -b y

scotch_6.0.3/src/Make.inc/Makefile.inc.i686_pc_linux2.prof

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= make
+AR		= ar
+ARFLAGS		= -ruv
+CAT		= cat
+CCS		= gcc
+CCP		= mpicc
+CCD		= gcc
+CFLAGS		= -pg -O3 -Drestrict=__restrict -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_PTHREAD -DSCOTCH_RENAME
+CLIBFLAGS	=
+LDFLAGS		= -lz -lm -pthread
+CP		= cp
+LEX		= flex -Pscotchyy -olex.yy.c
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= bison -pscotchyy -y -b y

scotch_6.0.3/src/Make.inc/Makefile.inc.i686_pc_linux2.shlib

@@ -8,10 +8,10 @@ ARFLAGS		= -shared -o
 CAT		= cat
 CCS		= gcc
 CCP		= mpicc
-CCD		= mpicc
-CFLAGS		= -O3 -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_RENAME -Drestrict=__restrict
+CCD		= gcc
+CFLAGS		= -O3 -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_RENAME -DSCOTCH_PTHREAD -Drestrict=__restrict
 CLIBFLAGS	= -shared -fPIC
-LDFLAGS		= -Xlinker --no-as-needed -lz -lm -lrt
+LDFLAGS		= -lz -lm -pthread
 CP		= cp
 LEX		= flex -Pscotchyy -olex.yy.c
 LN		= ln

scotch_6.0.3/src/Make.inc/Makefile.inc.i686_pc_linux2.shlib.debug

@@ -4,14 +4,14 @@ OBJ		= .o
 
 MAKE		= make
 AR		= gcc
-ARFLAGS		= -m32 -shared -o
+ARFLAGS		= -shared -o
 CAT		= cat
 CCS		= gcc
 CCP		= mpicc
-CCD		= mpicc
-CFLAGS		= -m32 -O3 -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_RENAME -Drestrict=__restrict
+CCD		= gcc
+CFLAGS		= -g -O0 -Drestrict=__restrict -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_PTHREAD -DSCOTCH_DEBUG_ALL -DSCOTCH_DETERMINISTIC -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_RENAME
 CLIBFLAGS	= -shared -fPIC
-LDFLAGS		= -Xlinker --no-as-needed -L$MPI_ARCH_PATH/lib -m32 -lz -lm -lrt
+LDFLAGS		= -g -lz -lm -pthread
 CP		= cp
 LEX		= flex -Pscotchyy -olex.yy.c
 LN		= ln

scotch_6.0.3/src/Make.inc/Makefile.inc.i686_pc_linux3

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= make
+AR		= ar
+ARFLAGS		= -ruv
+CAT		= cat
+CCS		= gcc
+CCP		= mpicc
+CCD		= gcc
+CFLAGS		= -O3 -Drestrict=__restrict -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_RENAME -DSCOTCH_RENAME_PARSER -DSCOTCH_PTHREAD
+CLIBFLAGS	=
+LDFLAGS		= -lz -lpthread -lm -pthread
+CP		= cp
+LEX		= flex -Pscotchyy -olex.yy.c
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= bison -pscotchyy -y -b y

scotch_6.0.3/src/Make.inc/Makefile.inc.i686_pc_mingw32

@@ -0,0 +1,69 @@
+# This make include file is intended for building under MinGW32. As is,
+# it relies on :
+#   - pthread-win32 (http://sourceware.org/pthreads-win32/),
+#   - zlib (http://www.zlib.net/)
+#   - mpich2 (http://www.mcs.anl.gov/research/projects/mpich2/).
+# It must be adapted to reflect your environment, in particular
+# installation root directories, include path and library name.
+# Since all files are linked with the MPI libraries, this file is
+# for compiling PT-Scotch only. To compile Scotch, remove the
+# -DSCOTCH_PTSCOTCH flag, as well as all references to MPI in the
+# CFLAGS and CLIBFLAGS	=
+LDFLAGS variables.
+
+EXE			=
+LIB			= .a
+OBJ			= .o
+
+MAKE			= make
+AR			= ar
+ARFLAGS			= -ruv
+CAT			= cat
+CCS			= gcc
+CCP			= gcc
+CCD			= gcc
+
+#--- Compiler/loader flags
+CFLAGS_CPL		= -O0 -g3
+CFLAGS_INC		= 
+CFLAGS_DEF		= -DCOMMON_RANDOM_FIXED_SEED -DCOMMON_STUB_FORK -DSCOTCH_PTSCOTCH -DSCOTCH_RENAME -D'pipe(pfds)=_pipe(pfds,1024,0x8000)'
+CLIBFLAGS	=
+LDFLAGS   		= 
+
+PGMFILES=$(PROGRAMFILES)
+
+#--- MPI
+MPI_ROOTDIR		= $(PGMFILES)/MPICH2
+CFLAGS_INC	+= -I$(MPI_ROOTDIR)/include
+#--- Comment/Uncomment for threaded MPI
+CLIBFLAGS	=
+LDFLAGS    	+= -L$(MPI_ROOTDIR)/lib -lm -lmpi
+#CLIBFLAGS	=
+LDFLAGS    	+= -L$(MPI_ROOTDIR)/lib -lm -lmpich2mt
+
+#--- Pthread : Uncomment for pthread support
+#PTHREAD_ROOTDIR		= $(PGMFILES)/pthread-win32
+#CFLAGS_INC		+= -I$(PTHREAD_ROOTDIR)/include
+#CLIBFLAGS	=
+LDFLAGS		+= -L$(PTHREAD_ROOTDIR)/lib -lpthreadGC2
+
+#--- zlib: Uncomment for compressed files
+#ZLIB_ROOTDIR		= $(PGMFILES)/zlib-1.2.3
+#CFLAGS_INC	+= -I$(ZLIB_ROOTDIR)/include
+#CLIBFLAGS	=
+LDFLAGS	+= -L$(ZLIB_ROOTDIR)/lib -lzdll
+
+#--- COMMON_PTHREAD: Uncomment for compressed files
+#CFLAGS_DEF	+= -DCOMMON_PTHREAD -DCOMMON_FILE_COMPRESS_GZ
+
+#--- SCOTCH_PTHREAD: Uncomment for threaded MPI
+#CFLAGS_DEF	+= -DSCOTCH_PTHREAD
+
+CFLAGS		= $(CFLAGS_CPL) $(CFLAGS_INC) $(CFLAGS_DEF)
+CP			= cp
+LEX			= flex -Pscotchyy -olex.yy.c
+LN			= cp
+MKDIR			= mkdir
+MV			= mv
+RANLIB			= ranlib
+YACC			= bison -pscotchyy -y -b y

scotch_6.0.3/src/Make.inc/Makefile.inc.i686_sun_solaris5

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= make
+AR		= ar
+ARFLAGS		= -ruv
+CAT		= cat
+CCS		= cc
+CCP		= mpicc
+CCD		= mpicc
+CFLAGS		= -m64 -O3 -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_PTHREAD -DSCOTCH_RENAME -Du_int32_t=uint32_t -Du_int64_t=uint64_t
+CLIBFLAGS	=
+LDFLAGS		= -lz -lm -lrt
+CP		= cp
+LEX		= flex -Pscotchyy -olex.yy.c
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= yacc

scotch_6.0.3/src/Make.inc/Makefile.inc.mips_sgi_irix6

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= gmake
+AR		= ar
+ARFLAGS		= ruv
+CAT		= cat
+CCS		= xlc
+CCP		= mpicc
+CCD		= mpicc
+CFLAGS		= -n32 -xansi -fullwarn -O2 -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_PTHREAD -DSCOTCH_RENAME
+CLIBFLAGS	=
+LDFLAGS		= -lm
+CP		= cp
+LEX		= lex
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= yacc

scotch_6.0.3/src/Make.inc/Makefile.inc.pa11_hp_ux10

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= gmake
+AR		= ar
+ARFLAGS		= ruv
+CAT		= cat
+CCS		= cc
+CCP		= mpicc
+CCD		= mpicc
+CFLAGS		= -Aa -z +DA1.1 +w1 +O4 +Onoinitcheck +Onolimit -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_PTHREAD -DSCOTCH_RENAME
+CLIBFLAGS	=
+LDFLAGS		= -lm
+CP		= cp
+LEX		= lex
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= yacc

scotch_6.0.3/src/Make.inc/Makefile.inc.power3_ibm_aix5

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= gmake
+AR		= ar
+ARFLAGS		= -X64 -ruv
+CAT		= cat
+CCS		= xlc_r
+CCP		= mpcc_r
+CCD		= xlc_r -I/usr/lpp/ppe.poe/include
+CFLAGS		= -ma -q64 -qarch=auto -O3 -qstrict -qtune=pwr3 -qlanglvl=extc99 -s -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_PTHREAD -DSCOTCH_RENAME -D_ALL_SOURCE
+CLIBFLAGS	=
+LDFLAGS		= -bmaxdata:0x80000000 -lpthread -lm
+CP		= cp
+LEX		= lex
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= yacc

scotch_6.0.3/src/Make.inc/Makefile.inc.power6_ibm_aix5

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= gmake
+AR		= ar
+ARFLAGS		= -X64 -ruv
+CAT		= cat
+CCS		= xlc_r
+CCP		= mpcc_r
+CCD		= xlc_r -I/usr/lpp/ppe.poe/include
+CFLAGS		= -ma -q64 -qarch=auto -O3 -qstrict -qtune=pwr6 -qlanglvl=extc99 -s -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_PTHREAD -DSCOTCH_RENAME -D_ALL_SOURCE
+CLIBFLAGS	=
+LDFLAGS		= -lpthread -lm
+CP		= cp
+LEX		= lex
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= yacc

scotch_6.0.3/src/Make.inc/Makefile.inc.ppc450_ibm_bgp

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= gmake
+AR		= ar
+ARFLAGS		= -ruv
+CAT		= cat
+CCS		= /bgsys/drivers/ppcfloor/comm/bin/mpixlc_r
+CCP		= /bgsys/drivers/ppcfloor/comm/bin/mpixlc_r
+CCD		= xlc_r -I/bgsys/drivers/ppcfloor/comm/include
+CFLAGS		= -O3 -qstrict -qlanglvl=extc99 -qarch=450d -qtune=450 -s -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_RENAME -DSCOTCH_DETERMINISTIC -D_ALL_SOURCE
+CLIBFLAGS	=
+LDFLAGS		= -lpthread -lm
+CP		= cp
+LEX		= lex
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= yacc

scotch_6.0.3/src/Make.inc/Makefile.inc.ppca2_ibm_bgq

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= gmake
+AR		= ar
+ARFLAGS		= -ruv
+CAT		= cat
+CCS		= /bgsys/drivers/ppcfloor/comm/xl/bin/mpixlc_r
+CCP		= /bgsys/drivers/ppcfloor/comm/xl/bin/mpixlc_r
+CCD		= xlc_r -I/bgsys/drivers/ppcfloor/comm/xl/include
+CFLAGS		= -O3 -qstrict -qlanglvl=extc99 -s -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_RENAME -DSCOTCH_DETERMINISTIC -D_ALL_SOURCE
+CLIBFLAGS	=
+LDFLAGS		= -lpthread -lm
+CP		= cp
+LEX		= flex -Pscotchyy -olex.yy.c
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= bison -pscotchyy -y -b y

scotch_6.0.3/src/Make.inc/Makefile.inc.x86-64_cray-xt4_linux2

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= gmake
+AR		= ar
+ARFLAGS		= -ruv
+CAT		= cat
+CCS		= cc
+CCP		= cc
+CCD		= cc
+CFLAGS		= -O3 -c99 -fast -fastsse -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_PTHREAD -DSCOTCH_RENAME -DIDXSIZE64
+CLIBFLAGS	=
+LDFLAGS		= -lm -lrt
+CP		= cp
+LEX		= flex -Pscotchyy -olex.yy.c
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= bison -pscotchyy -y -b y

scotch_6.0.3/src/Make.inc/Makefile.inc.x86-64_pc_freebsd

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= gmake
+AR		= ar
+ARFLAGS		= -ruv
+CAT		= cat
+CCS		= cc
+CCP		= mpicc
+CCD		= cc
+CFLAGS		+= -std -fPIC -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_RENAME -DSCOTCH_RENAME_PARSER -DSCOTCH_PTHREAD -Drestrict=__restrict -DIDXSIZE64
+CLIBFLAGS	=
+LDFLAGS		+= -lz -lm -lthread
+CP		= cp
+LEX		= flex -Pscotchyy -olex.yy.c
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= bison -pscotchyy -y -b y

scotch_6.0.3/src/Make.inc/Makefile.inc.x86-64_pc_linux2

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= make
+AR		= ar
+ARFLAGS		= -ruv
+CAT		= cat
+CCS		= gcc
+CCP		= mpicc
+CCD		= gcc
+CFLAGS		= -O3 -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_RENAME -DSCOTCH_PTHREAD -Drestrict=__restrict -DIDXSIZE64
+CLIBFLAGS	=
+LDFLAGS		= -lz -lm -lrt -pthread
+CP		= cp
+LEX		= flex -Pscotchyy -olex.yy.c
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= bison -pscotchyy -y -b y

scotch_6.0.3/src/Make.inc/Makefile.inc.x86-64_pc_linux2.icc

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= make
+AR		= ar
+ARFLAGS		= -ruv
+CAT		= cat
+CCS		= icc
+CCP		= mpicc
+CCD		= icc
+CFLAGS		= -O3 -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_RENAME -DSCOTCH_PTHREAD -restrict -DIDXSIZE64
+CLIBFLAGS	=
+LDFLAGS		= -lz -lm -lrt -pthread
+CP		= cp
+LEX		= flex -Pscotchyy -olex.yy.c
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= bison -pscotchyy -y -b y

scotch_6.0.3/src/Make.inc/Makefile.inc.x86-64_pc_linux2.icc.debug

@@ -0,0 +1,21 @@
+EXE		=
+LIB		= .a
+OBJ		= .o
+
+MAKE		= make
+AR		= ar
+ARFLAGS		= -ruv
+CAT		= cat
+CCS		= icc
+CCP		= mpicc
+CCD		= icc
+CFLAGS		= -g -O0 -fp-model strict -traceback -check-uninit -fp-stack-check -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_DEBUG_ALL -DSCOTCH_DETERMINISTIC -DSCOTCH_RENAME -restrict -DIDXSIZE64
+CLIBFLAGS	=
+LDFLAGS		= -g -lz -lm -lrt -pthread
+CP		= cp
+LEX		= flex -Pscotchyy -olex.yy.c
+LN		= ln
+MKDIR		= mkdir
+MV		= mv
+RANLIB		= ranlib
+YACC		= bison -pscotchyy -y -b y

scotch_6.0.3/src/Make.inc/Makefile.inc.x86-64_pc_linux2.shlib

@@ -8,10 +8,10 @@ ARFLAGS		= -shared -o
 CAT		= cat
 CCS		= gcc
 CCP		= mpicc
-CCD		= mpicc
-CFLAGS		= -O3 -DINTSIZE64 -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_RENAME -Drestrict=__restrict
+CCD		= gcc
+CFLAGS		= -O3 -DCOMMON_FILE_COMPRESS_GZ -DCOMMON_PTHREAD -DCOMMON_RANDOM_FIXED_SEED -DSCOTCH_RENAME -DSCOTCH_PTHREAD -Drestrict=__restrict -DIDXSIZE64
 CLIBFLAGS	= -shared -fPIC
-LDFLAGS		= -Xlinker --no-as-needed -lz -lm -lrt
+LDFLAGS		= -lz -lm -lrt -pthread
 CP		= cp
 LEX		= flex -Pscotchyy -olex.yy.c
 LN		= ln

scotch_6.0.3/src/Make.inc/mingw32/README.txt

@@ -0,0 +1,13 @@
+These three script files can be used to create a Windows DLL from the
+PT-Scotch library on a MinGW32 system. They are intended to be called 
+directly from the src/Make.inc/mingw32 directory and produce results
+in the lib directory.
+
+The first two ones must be called from a Unix-like shell window.
+The last one must be called from a MSDOS-like command window.
+
+These scripts are intended only as examples. They must be adapted to
+reflect your environment, in particular library path and library name.
+
+They have been provided by Yves Secretan (yves.secretan@ete.inrs.ca)
+and are licensed under the CeCILL-C libre/free license.

scotch_6.0.3/src/Make.inc/mingw32/gendll_0.sh

@@ -0,0 +1,20 @@
+#! /bin/sh
+# (C) 2008 Yves Secretan (yves.secretan@ete.inrs.ca)
+# This software is governed by the CeCILL-C license under French law
+# and abiding by the rules of distribution of free software. You can
+# use, modify and/or redistribute the software under the terms of the
+# CeCILL-C license as circulated by CEA, CNRS and INRIA at the following
+# URL: "http://www.cecill.info".
+#
+# To be executed in a MSYS window.
+#
+# This file will link the PT-Scotch DLL. It must be adapted to reflect
+# your environment, in particular library path and library name.
+
+export OBJS="../../libscotch/lib*.o"
+export LDFLAGS="--shared -Wl,--allow-multiple-definition"
+export PGMFILES="/l"
+export LDPATH="-L../../../lib -L$PGMFILES/MPICH2/lib -L$PGMFILES/pthread-win32/lib"
+export LDLIBS="-lptscotch -lptscotcherr -lmpi -lpthreadGC2"
+
+gcc --output ../../../lib/libptscotch.dll $LDFLAGS $LDPATH $OBJS $LDLIBS

scotch_6.0.3/src/Make.inc/mingw32/gendll_1.sh

@@ -0,0 +1,16 @@
+#! /bin/sh
+# (C) 2008 Yves Secretan (yves.secretan@ete.inrs.ca)
+# This software is governed by the CeCILL-C license under French law
+# and abiding by the rules of distribution of free software. You can
+# use, modify and/or redistribute the software under the terms of the
+# CeCILL-C license as circulated by CEA, CNRS and INRIA at the following
+# URL: "http://www.cecill.info".
+#
+# To be executed in a MSYS window.
+#
+# This file creates the Exports definition file from the PT-Scotch DLL.
+# It must be adapted to reflect your environment, in particular library
+# path and library name.
+
+echo EXPORTS > ../../../lib/libptscotch.def
+nm ../../../lib/libptscotch.a | grep ' T _SCOTCH_' | sed 's/.* T _//' >> ../../../lib/libptscotch.def

scotch_6.0.3/src/Make.inc/mingw32/gendll_2.bat

@@ -0,0 +1,14 @@
+REM   (C) 2008 Yves Secretan (yves.secretan@ete.inrs.ca)
+REM   This software is governed by the CeCILL-C license under French law
+REM   and abiding by the rules of distribution of free software. You can
+REM   use, modify and/or redistribute the software under the terms of the
+REM   CeCILL-C license as circulated by CEA, CNRS and INRIA at the following
+REM   URL: "http://www.cecill.info".
+REM
+REM   To be executed in a DOS window.
+REM
+REM   This file will create the PT-Scotch DLL. It must be adapted to reflect
+REM   your environment, in particular library path and library name.
+REM
+set VC_PATH="C:\Program Files\Microsoft Visual Studio .NET\VC7\BIN"
+%VC_PATH%\vcvars32.bat && %VC_PATH%\lib.exe /def:..\..\..\lib\libptscotch.def /out:..\..\..\lib\libptscotch.dll

scotch_6.0.3/src/Makefile

@@ -0,0 +1,134 @@
+## Copyright 2004,2007,2008,2010-2012,2014 IPB, Universite de Bordeaux, INRIA & CNRS
+##
+## This file is part of the Scotch software package for static mapping,
+## graph partitioning and sparse matrix ordering.
+##
+## This software is governed by the CeCILL-C license under French law
+## and abiding by the rules of distribution of free software. You can
+## use, modify and/or redistribute the software under the terms of the
+## CeCILL-C license as circulated by CEA, CNRS and INRIA at the following
+## URL: "http://www.cecill.info".
+## 
+## As a counterpart to the access to the source code and rights to copy,
+## modify and redistribute granted by the license, users are provided
+## only with a limited warranty and the software's author, the holder of
+## the economic rights, and the successive licensors have only limited
+## liability.
+## 
+## In this respect, the user's attention is drawn to the risks associated
+## with loading, using, modifying and/or developing or reproducing the
+## software by the user in light of its specific status of free software,
+## that may mean that it is complicated to manipulate, and that also
+## therefore means that it is reserved for developers and experienced
+## professionals having in-depth computer knowledge. Users are therefore
+## encouraged to load and test the software's suitability as regards
+## their requirements in conditions enabling the security of their
+## systems and/or data to be ensured and, more generally, to use and
+## operate it in the same conditions as regards security.
+## 
+## The fact that you are presently reading this means that you have had
+## knowledge of the CeCILL-C license and that you accept its terms.
+##
+
+VERSION	= 6
+RELEASE = 0
+PATCHLEVEL = 3
+
+.PHONY				:	clean	default	install	ptscotch	realclean	required	scotch
+
+default				:	scotch
+
+required			:	Makefile.inc	../bin	../include	../lib
+
+Makefile.inc			:
+					@echo "#####################################################################"
+			        	@echo "BEFORE COMPILING Scotch OR PT-Scotch, YOU SHOULD HAVE AN APPROPRIATE"
+					@echo "Makefile.inc FILE IN THIS DIRECTORY. PLEASE LOOK INTO DIRECTORY"
+	        			@echo " ./Make.inc FOR AN EXISTING Makefile.inc FILE THAT FITS YOUR NEED, OR"
+		        		@echo "USE THEM AS MODELS IN CASE YOU NEED TO BUILD A NEW ONE FOR YOUR"
+		        		@echo "PARTICULAR PLATFORM."
+			        	@echo "#####################################################################"
+			        	@echo "Then, type \"make scotch\" (default) for the sequential library"
+			        	@echo "and software, or \"make ptscotch\" for the parallel library and"
+			        	@echo "software."
+					@exit 1
+
+include Makefile.inc
+
+prefix		?= /usr/local
+bindir		?= $(prefix)/bin
+includedir	?= $(prefix)/include
+libdir		?= $(prefix)/lib
+datarootdir	?= $(prefix)/share
+mandir		?= $(datarootdir)/man
+
+../bin				:
+					-$(MKDIR) ../bin
+
+../include			:
+					-$(MKDIR) ../include
+
+../lib				:
+					-$(MKDIR) ../lib
+
+$(bindir)			:
+					-$(MKDIR) $(bindir)
+
+$(datarootdir)			:
+					-$(MKDIR) $(datarootdir)
+
+$(includedir)			:
+					-$(MKDIR) $(includedir)
+
+$(libdir)			:
+					-$(MKDIR) $(libdir)
+
+$(mandir)			:	$(datarootdir)
+					-$(MKDIR) $(mandir)
+
+$(mandir)/man1			:	$(mandir)
+					-$(MKDIR) $(mandir)/man1
+
+scotch				:	required
+					(cd libscotch ;      $(MAKE) VERSION=$(VERSION) RELEASE=$(RELEASE) PATCHLEVEL=$(PATCHLEVEL) scotch && $(MAKE) install)
+					(cd scotch ;         $(MAKE) VERSION=$(VERSION) RELEASE=$(RELEASE) PATCHLEVEL=$(PATCHLEVEL) scotch && $(MAKE) install)
+					(cd libscotchmetis ; $(MAKE)                                                                scotch && $(MAKE) install)
+
+ptscotch			:	required
+					(cd libscotch ;      $(MAKE) VERSION=$(VERSION) RELEASE=$(RELEASE) PATCHLEVEL=$(PATCHLEVEL) ptscotch && $(MAKE) ptinstall)
+					(cd scotch ;         $(MAKE) VERSION=$(VERSION) RELEASE=$(RELEASE) PATCHLEVEL=$(PATCHLEVEL) ptscotch && $(MAKE) ptinstall)
+					(cd libscotchmetis ; $(MAKE)                                                                ptscotch && $(MAKE) ptinstall)
+
+check				:	scotch
+					(cd check ; $(MAKE) check)
+
+ptcheck				:	ptscotch
+					(cd check ; $(MAKE) ptcheck)
+
+esmumps				:	scotch
+					(cd esmumps ; $(MAKE) scotch && $(MAKE) install)
+
+ptesmumps			:	ptscotch
+					(cd esmumps ; $(MAKE) ptscotch && $(MAKE) ptinstall)
+
+install				:	required	$(bindir)	$(includedir)	$(libdir)	$(mandir)/man1
+					-$(CP) -f ../bin/[agm]*$(EXE) $(bindir)
+					-$(CP) -f ../bin/d[agm]*$(EXE) $(bindir)
+					-$(CP) -f ../include/*scotch*.h $(includedir)
+					-$(CP) -f ../lib/*scotch*$(LIB) $(libdir)
+					-$(CP) -Rf ../man/* $(mandir)
+
+clean				:	required
+					(cd libscotch ;      $(MAKE) clean)
+					(cd scotch ;         $(MAKE) clean)
+					(cd libscotchmetis ; $(MAKE) clean)
+					(cd check ;          $(MAKE) clean)
+					(cd esmumps ;        $(MAKE) clean)
+
+realclean			:	required
+					(cd libscotch ;      $(MAKE) realclean)
+					(cd scotch ;         $(MAKE) realclean)
+					(cd libscotchmetis ; $(MAKE) realclean)
+					(cd check ;          $(MAKE) realclean)
+					(cd esmumps ;        $(MAKE) realclean)
+					-$(RM) ../bin/* ../include/* ../lib/*