Building the FacetsComposer

Package Diagram

FacetsComposer will build on Linux, Mac, and Windows systems, but the specific instructions (and requirements) depend on the operating system. Each process uses the Bilder tool. The Bilder tool builds all the dependent packages (see graph to the right) that are needed by the FacetsComposer. See the  Bilder Wiki for more information about the build tool itself; however, below are details of the prerequisites and specific commands needed to build the FacetsComposer.


The builds time will vary, but estimates from a i386 Mac 10.6.0 are: 

    cmake           6:04
    mesa-os         2:01
    mesa-mgl        1:50
    qt            131:15  (2 hours 11 min)
    vtk            46:58
    hdf             5:56
    hdf-par         6:47
    Imaging         1:08
    visit          73:49  (1 hour 13 min)
    QScintilla      6:51
    composertoolkit 2:47
    facetscomposer  0:17
       ------------------------
               total   4 hours 46 min

You can reduce this by downloading the binary Qt development environment from ( http://qt.nokia.com).


Building on Linux

PREREQUISITES:

  • The GNU Compiler Collection (builds have been tested with version 4.2 and later)
  • For Ubuntu extra system libraries should be installed ( see list at VisIt site)

BUILD INSTRUCTIONS:

Check out source using SVN and build using Bilder system... 

$ svn co https://ice.txcorp.com/svnrepos/code/fccpall/trunk fccpall
$ cd fccpall
$ ./mkfccpall.sh -i <INSTALL_DIR>

The last line invokes the  Bilder system. The <INSTALL_DIR> is often /internal, but can be set to be any directory where the built software is to be installed. The script has  various options. For example, if you are building on a system that other build on, then you can use -k <CONTRIB_DIR> to pick up contributed builds from other to speed up the build.

RUN INSTRUCTIONS:

After running bilder, the executable will be in <INSTALL_DIR>/facetscomposer-r###-ser, where <INSTALL_DIR> is what was passed to the mkfccpall.sh script. If you did not specify the -i option, then <INSTALL_DIR> will be the <HOME>/software directory, where <HOME> is your home directory. The -r### will be the SVN revision number of the facetscomposer package. You can find this out by either just seeing what was built the install directory appears, or by executing the svnversion command in the fccpall/facetscomposer directory. If for example you are building revision 65 of FacetsComposer then to run the application you would do... 

$ cd <INSTALL_DIR>/facetscomposer-r65-ser
$ ./FacetsComposer



Building on Mac

PREREQUISITES:

BUILD INSTRUCTIONS:

Check out source using SVN and build using  'Bilder' script system... 

$ svn co https://ice.txcorp.com/svnrepos/code/fccpall/trunk fccpall
$ cd fccpall
$ ./mkfccpall.sh -i <INSTALL_DIR>

The last line invokes the  'Bilder' system. The <INSTALL_DIR> is often /internal, but can be set to be any directory where the built software is to be installed. The script has  various options. For example, if you are building on a system that other build on, then you can use -k <CONTRIB_DIR> to pick up contributed builds from other to speed up the build.

RUN INSTRUCTIONS:

After running bilder, the executable will be in <INSTALL_DIR>/facetscomposer-r###-ser. If you did not specify the "-i" option, then <INSTALL_DIR> will be the <HOME>/software directory, where <HOME> is your home directory. The -r### will be the SVN revision number that you checked out. You can find this out by either just seeing what was built the install directory, or by executing the svnversion - c command in the fccpall/facetscomposer directory. If you are building revision 85 of the FacetsComposer on a Mac, then to run FacetsComposer you would do... 

$ cd <INSTALL_DIR>/facetscomposer-r85-ser
$ open ./FacetsComposer.app

or you can simply double-click on the application (FacetsComposer) in a Finder window.



Building on Windows

PREREQUISITES:

BUILD INSTRUCTIONS:

From the bash command line use the following command to check out the code: 

svn co https://ice.txcorp.com/svnrepos/code/fccpall/trunk fccpall

MAKE SURE that you are using the cygwin svn in the above command.

RUN INSTRUCTIONS:

Start a Visual Studio command prompt, then run cygwin as detailed in the  Bilder on Windows page. Next, run the top-level bilder script in the fccpall directory, e.g., 

 cd fccpall
 mkfccpall.sh -aru -j 2 -m cygwin.vs9 -b /winsame/builds/fccpall -k /winsame/contrib -i /winsame/volatile -e myemail@mydomain.org

You should then be able to navigate to C:\winsame\volatile\facetscomposer-r### directory, where ### is the svn revision number of the facetscomposer project that was built, and the double-click on FacetsComposer.exe executable.

Attachments