Catalyst Build

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

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>

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

cd <paraview_repo>
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 contain a shell script called cmake.sh that contains 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.