Catalyst Build

From KitwarePublic
Revision as of 20:08, 7 November 2012 by Cjh1 (talk | contribs)
Jump to navigationJump to search

Prerequisites

  • Python is required for generation of the source tree and the wrapping code [1].
  • The Catalyst build process requires CMake version 2.8.8 or higher, a working compiler and make.
  • MPI [2], [3] is also required.

Generating Catalyst Source Tree

A tarball of the Catalyst source can be downloaded from the Catalyst Website. However, the Catalyst source tree can also be generate manually from a ParaView source tree. The Catalyst source tree is generated using a Python script located in the ParaView source tree (Catalyst/catalyze.py). The script takes a JSON manifest file (manifest.json) that describes what files are copied and transformed from ParaView to produce the Catalyst source tree. For example the following segment of JSON indicates that the VTK module vtkCommonMath should be included (excluding the Testing directory) and it should be Python wrapped:

<source lang="javascript">

   {
     "name":"vtkCommonMath",
     "path":"VTK/Common/Math",
     "exclude":[
       {
         "path":"Testing"
       }
     ],
     "pythonwrap":true
   }

</source> The full manifest for the "Base" edition can be found here (Catayst/Editions/Base/manifest.json) in the ParaView source tree.

To generate the source tree for the "Base" Catalyst edition. The following commands should be run:

cd <paraview_repo>/Catalyst
python catalyze.py -i Editions/Base/ -o <catalyst_output>

Where <paraview_repo> is the root directory of the ParaView source tree and <catalyst_output> is the target output directory. This will produce a source tree that can then be build using the steps described in Build Directions

Build Directions

A tarball of the Catalyst source can be downloaded from the Catalyst Website or a source tree can be generated from a ParaView source tree using the steps describe in Generating Catalyst Source Tree. The Catalyst source tree contains a shell script called cmake.sh that provides the appropriate cmake command to configure Catalyst. To run configure Catalyst the following command should be run:

cd <catalyst_build_dir>
<catalyst_source_dir>/cmake.sh <catalyst_source_dir> 

Where <catalyst_build_dir> is the target build directory for Catalyst and <catalyst_source_dir> is the source tree. Note other CMake options can be passed to the script, for example a generator could be specified using the -G option.

Once the cmake.sh script has been run Catalyst can be build by running the following command (assuming the default generator is used):

cd <catalyst_build_dir>
make

Where <catalyst_build_dir> is the target build directory for Catalyst.