Building OverView
From InfovisWiki
Note: Due to changes in Paraview, Overview no longer builds in Paraview CVS. Future plans include integrating Overview features into Paraview itself instead of managing a separate application.
Contents |
Building OverView
OverView is now part of the ParaView source tree, so you will need to obtain ParaView and configure it properly to build OverView.
- I tried building with Microsoft Visual Studio .NET 2003, and had build errors that we suspect were associated with an old compiler. I then updated to Microsoft Visual Studio 2008, and was successful getting an Overview build. You do need to use at least version 4.4.1 of Qt with Microsoft Visual Studio 2008.
- You will need CMake to build ParaView / OverView. We strongly recommend the latest version (2.6.2 as of this writing), which you can obtain from CMake Downloads.
- Get the current ParaView sources from CVS. You will need to obtain the trunk of the source tree:
$ cd ~ $ cvs -d :pserver:anoncvs@www.paraview.org:/cvsroot/ParaView3 login # (respond with empty password) # Follow this command by checking out the source code: $ cvs -d :pserver:anoncvs@www.paraview.org:/cvsroot/ParaView3 co ParaView3
- You will probably want to get and install BOOST.
- Go to www.boostpro.com/products/free
- Get a copy of BoostPro_XX_Installer. I know that version 1.36.0 works.
- You will probably want to get and install MySQL.
- Go to www.mysql.com.
- You download the zip file, unzip it, and click on the setup.exe.
- Completely optional: Building POSTGRES.
- Go to http://www.postgresql.org/.
- Downloads, Choose your package type (binary Windows for me), Download the one click installer, Windows.
- Run the download file.exe.
- ParaView requires an out-of-source build, so create a new build directory somewhere outside the sources you just downloaded:
$ mkdir ParaView3-Build
- Run CMake from within the build directory, pointing it to the source directory:
$ cd ParaView3-Build $ ccmake ~/ParaView3
- Note that slashes below are forward slashes only, not back shashes. If you cut and paste from Windows, they will be wrong - and will cause you problems later.
- Hit the 'c' key to begin configuration. CMake will begin creating the ParaView build, and present a list of options that you can modify. There are several that will have to be set to build OverView. You may have to hit the 't' key to show all the available options.
- Set the QT_QMAKE_EXECUTABLE to your ../qt/4.3.3/bin/qmake.exe.
- Hit the 'c' key to continue configuration.
- Required: Set BUILD_SHARED_LIBS "ON".
- Hit the 'c' key to continue configuration.
- Required: Set PARAVIEW_BUILD_OverView "ON".
- Hit the 'c' key to continue configuration.
- Recommended: Set VTK_USE_BOOST "ON".
- Recommended: Set VTK_USE_MYSQL "ON". This is necessary to connect to MySQL databases and assumes you have the MySQL client libraries and headers on your host.
- Recommended: Set VTK_USE_N_WAY_ARRAYS "ON".
- Optional: Set VTK_USE_POSTGRES "ON". This is necessary to connect to PostgreSQL database and assumes you have the PostgreSQL client libraries and headers on your host.
- Hit the 'c' key to continue configuration. CMake will update the list of available options based on your changes.
- Set Boost_INCLUDE_DIR to C:/Program Files/boost/boost_1_36_0 (or whaterver your version is). Note that the include directory is actually the top of the install.
- Set MYSQL_INCLUDE_DIRECTORIES to "C:/Program Files/MySQL/MySQL Server *.*/include
- Set MYSQL_LIBRARY to "C:/Program Files/MySQL/MySQL Server *.*/lib/debug/libmysql.lib"
- Set POSTGRES_INCLUDE_DIRECTORIES to "C:/Program Files/PostgreSQL/8.3/include" (or whatever version you have)
- Set POSTGRES_LIBRARIES to "C:/Program Files/PostgreSQL/8.3/lib/libpq.lib" (or whatever version you have)
- There will be a new set of of PARAVIEW_BUILD_PLUGIN_xxxx options that control whether individual plugins are built or not. You may wish to enable or disable specific plugins to suit your needs. (I didn't need to turn anything else on.)
- Note that some plugins are required when building OverView, and cannot be disabled.
- Hit the 'c' key to continue configuration. CMake will update the list of available options based on your changes.
- Note that some plugins may have their own build requirements beyond OverView's. If so, you will see appropriate error messages. You can either provide the requirements or disable the corresponding plugin.
- Continue hitting the 'c' key until the configuration succeeds without error and includes the features you require.
- Hit the 'g' key to generate the build.
- Build the software:
$ make
Running OverView
- Linux: you can run OverView from the build tree using the command-line:
$ bin/OverView
- OSX: you can run OverView from the build tree, but it is located within a "bundle":
$ bin/OverView.app/Contents/MacOS/OverView
- Win32: you can run OverView from the build tree by double-clicking its icon.
- Optional: Set the PV_PLUGIN_PATH environment variable if you want to automatically-load plugins that aren't part of the normal ParaView / OverView build.
Installing OverView
- Win32: there are two custom targets, "Install-OverView-Debug" and "Install-OverView-Release" that will install OverView and its supporting files (but without the ParaView client and other unused resources) to C:\Program Files\OverView-Debug or C:\Program Files\OverView-Release, respectively. These targets are useful mainly for troubleshooting packaging problems.
Packaging OverView
- Win32: you can create NSIS installers using the "Package-OverView-Debug" and "Package-OverView-Release" targets. These targets will create NSIS installers containing OverView and all its dependencies (Qt, database drivers, etc), ready for immediate distribution.
- The installer packages will be located in <ParaView build directory>/Applications/OverView once they're built.
