|
|
| (213 intermediate revisions by 26 users not shown) |
| Line 1: |
Line 1: |
| =Introduction= | | =Introduction= |
|
| |
|
| This page describes how to build and install ParaView. It covers both the release and the development version. Also, it covers both Unix type systems (Linux, HP-UX, Solaris), as well as Windows. | | '''<font color="red">This page has been replaced by [https://gitlab.kitware.com/paraview/paraview/blob/master/Documentation/dev/build.md build documentation in the paraview repository]. |
|
| |
|
| =Pre-requisites=
| | '''To build ParaView complete with all the dependencies it needs and to package it, use the [https://gitlab.kitware.com/paraview/paraview-superbuild/-/blob/master/README.md?ref_type=heads paraview superbuild instructions].</font> |
|
| |
|
| ParaView build process requires [http://www.cmake.org CMake] and working compiler. On Unix like operating systems it also requires Make, while on Windows it requires Visual Studio (6, 7, or 7.1).
| |
|
| |
|
| In order to run ParaView in parallel, MPI [http://www-unix.mcs.anl.gov/mpi/], [http://www.lam-mpi.org/] is also required.
| | {{ParaView/Template/Footer}} |
| | |
| ==Download And Install Cmake==
| |
| | |
| CMake is a tool that makes cross platform building simple. On several systems it will probably be already installed. If it is not, please use the following instructions to install it.
| |
| | |
| ===Use Binaries===
| |
| | |
| There are several precompiled binaries available at [http://www.cmake.org/HTML/Download.html CMake download page]. On Unix like operating systems, let say on Linux, download the appropriate version and follow these instructions:
| |
| | |
| * Download http://www.cmake.org/files/v2.0/cmake-2.0.6-x86-linux.tar.gz
| |
| | |
| <pre>
| |
| cd $HOME
| |
| wget http://www.cmake.org/files/v2.0/cmake-2.0.6-x86-linux.tar.gz
| |
| mkdir software
| |
| cd software
| |
| tar xvfz ../cmake-2.0.6-x86-linux.tar.gz
| |
| ls
| |
| tar xvf cmake-2.0.6-x86-linux-files.tar
| |
| </pre>
| |
| | |
| * Now you have directory '''$HOME/software/bin''' and inside there are executables '''cmake''' and '''ccmake'''.
| |
| * You can also install CMake in the '''/usr/local''' or '''/opt''' by untaring into different directory. The rest of instructions will assume it is in '''$HOME/software/bin'''.
| |
| | |
| ===Build Your Own CMake===
| |
| | |
| {| cellspacing="3" | |
| |- valign="top"
| |
| |width="55%" class="MainPageBG" style="border: 1px solid #ffc9c9; color: #000; background-color: #fff3f3"|
| |
| <div style="padding: .4em .9em .9em">
| |
| ====On Unix like operating system====
| |
| Download the source code http://www.cmake.org/files/v2.0/cmake-2.0.6.tar.gz
| |
| | |
| <pre>
| |
| cd $HOME
| |
| wget http://www.cmake.org/files/v2.0/cmake-2.0.6.tar.gz
| |
| tar xvfz cmake-2.0.6.tar.gz
| |
| mkdir cmake-2.0.6-bin
| |
| cd cmake-2.0.6-bin
| |
| ../cmake-2.0.6/bootstrap --prefix=$HOME/software
| |
| make
| |
| make install
| |
| </pre>
| |
| | |
| * Again, you can install it in '''/usr/local''' or '''/opt''' by changing the prefix.
| |
| </div>
| |
| |width="45%" class="MainPageBG" style="border: 1px solid #c6c9ff; color: #000; background-color: #f0f0ff"|
| |
| <div style="clear: right; text-align: left; float: right; padding: .4em .9em .9em">
| |
| ====On Windows====
| |
| To build CMake on windows, previous version of CMake is required. This can be downloaded from [http://www.cmake.org/HTML/Download.html CMake download page].
| |
| | |
| </div>
| |
| |}
| |
| | |
| =Build ParaView=
| |
| | |
| ==Download And Build ParaView==
| |
| | |
| If you are trying to build ParaView release, download it from the release page. For development version, please follow instructions for checking out from CVS.
| |
| | |
| ===Download the source code===
| |
| | |
| You can always download the binaries from [http://www.paraview.org/HTML/Download.html ParaView download page]. This page contains binaries for several platforms and the source code for the releases.
| |
| | |
| ===Checkout From CVS===
| |
| * Download from CVS:
| |
| | |
| <pre>
| |
| mkdir $HOME/projects
| |
| cd $HOME/projects
| |
| | |
| cvs -d:pserver:anoncvs@www.paraview.org:/cvsroot/ParaView login
| |
| <nowiki><enter></nowiki>
| |
| cvs -d:pserver:anoncvs@www.paraview.org:/cvsroot/ParaView co ParaView
| |
| </pre>
| |
| | |
| ==Configure ParaView With CMake==
| |
| * Always use separate build directory. Do not build in the source directory
| |
| | |
| {| cellspacing="3" | |
| |- valign="top"
| |
| |width="55%" class="MainPageBG" style="border: 1px solid #ffc9c9; color: #000; background-color: #fff3f3"|
| |
| <div style="padding: .4em .9em .9em">
| |
| ===On Unix like system===
| |
| * Use ccmake (Curses CMake GUI) from the CMake installed location.
| |
| | |
| <pre>
| |
| mkdir $HOME/projects/ParaView-bin
| |
| cd $HOME/projects/ParaView-bin
| |
| | |
| $HOME/software/bin/ccmake $HOME/projects/ParaView
| |
| </pre>
| |
| [[Image:Brpv ccmake.png|400px]]
| |
| ===About CCMake (Curses CMake GUI)===
| |
| | |
| * Iterative process
| |
| ** Select values, run configure (c key)
| |
| ** Set the settings, run configure, set the settings run configure etc.
| |
| * Repeat until all values are set and generate option is available (g key)
| |
| * Some variables (advanced variables) are not visible right away
| |
| * To see advanced varables, toggle to advanced mode (t key)
| |
| * To set variable, move cursor to the variable and press enter
| |
| ** If it is a boolean (ON/OFF) it will flip the value
| |
| ** If it is string or file, it will allow editing of the string
| |
| ** For file and directories, <nowiki><tab></nowiki> key can be used to complete
| |
| * To search for the variable press '/' key and for repeat search, press 'n' key.
| |
| </div>
| |
| |width="45%" class="MainPageBG" style="border: 1px solid #c6c9ff; color: #000; background-color: #f0f0ff"|
| |
| <div style="clear: right; text-align: left; float: right; padding: .4em .9em .9em">
| |
| ===On Windows===
| |
| * Use CMakeSetup from the CMake install location.
| |
| * Make sure to select the apropriate source and the build directory
| |
| * Also, make sure to pick the apropriate generator (on Visual Studio 6, pick ''Visual Studio 6'' generator).
| |
| [[Image:Brpv cmakesetup.png|400px]]
| |
| | |
| ===About CMakeSetup (Windows CMake GUI)===
| |
| | |
| * Iterative process
| |
| ** Select values, press Configure button
| |
| ** Set the settings, run configure, set the settings run configure etc.
| |
| * Repeat until all values are set and Ok button becomes available.
| |
| * Some variables (advanced variables) are not visible right away
| |
| * To see advanced varables, toggle to advanced mode ("Show Advanced Values" toggle).
| |
| * To set value of a variable, click on that value.
| |
| ** If it is boolean (ON/OFF), it will change the value
| |
| ** If it is file or directory, it will popup the apropriate dialog
| |
| ** If it is a string, it will become editable string
| |
| </div>
| |
| |}
| |
| | |
| ===ParaView Settings===
| |
| | |
| {| border="0" cellpadding="4" cellspacing="4"
| |
| |-
| |
| | bgcolor="#abcdef" height="8" | '''Variable'''
| |
| | bgcolor="#abcdef" height="8" | '''Description'''
| |
| |-
| |
| | BUILD_SHARED_LIBS || If ON, use shared libraries. This way executables are smaller, but you have to make sure the shared libraries are on every system on the cluster.
| |
| |-
| |
| | VTK_USE_MPI || Turn this to ON to enable MPI. Other MPI options will not be availabel until you turn this on.
| |
| |-
| |
| | MPI_LIBRARY || Path to the MPI library (such as /usr/lib/libmpi.so). Should be found by default, but you may have to set it.
| |
| |-
| |
| | MPI_EXTRA_LIBRARY || Path to extra MPI library (such as /usr/lib/libmpi++.so). Again, should be found by default.
| |
| |-
| |
| | MPI_INCLUDE_PATH || Path to MPI includes (such as /usr/include/mpi). Again, should be found by default.
| |
| |-
| |
| |}
| |
| | |
| ===Finish Configuring ParaView===
| |
| | |
| * Once all configuration options are set, you should be able to just run <nowiki><generate></nowiki> (g key).
| |
| | |
| ==Build ParaView==
| |
| | |
| {| cellspacing="3"
| |
| |- valign="top"
| |
| |width="55%" class="MainPageBG" style="border: 1px solid #ffc9c9; color: #000; background-color: #fff3f3"|
| |
| <div style="padding: .4em .9em .9em">
| |
| ===Using Make===
| |
| * CMake will now generate Make files.
| |
| * You should be able to just type:
| |
| | |
| make
| |
| | |
| * If you are on multi-processor system (let say 4 procesor), you can type:
| |
| | |
| make -j 4
| |
| | |
| [[Image:Brpv make.png|400px]]
| |
| | |
| </div>
| |
| |width="45%" class="MainPageBG" style="border: 1px solid #c6c9ff; color: #000; background-color: #f0f0ff"|
| |
| <div style="clear: right; text-align: left; float: right; padding: .4em .9em .9em">
| |
| ===Using Visual Studio===
| |
| * CMake will now create Visual Studio project files
| |
| * You should be able to open '''ParaView''' project file
| |
| * Build the '''ALL_BUILD''' target
| |
| | |
| [[Image:Brpv visualstudio71.png|400px]]
| |
| </div>
| |
| |}
| |
| | |
| =Install ParaView=
| |
| | |
| ParaView can be run directly from the build directory. That said, for production environments, it should be installed on some system location. On Windows, this locations is something like ''c:\Program Files'', where as on Unix like operating systems it is ''/usr'', ''/usr/local'', ''/opt'', or something similar.
| |
| | |
| To install ParaView, simply run ''INSTALL'' target within the build system.
| |
