README
author Dmitriy Morozov <dmitriy@mrzv.org>
Thu, 07 May 2009 14:53:13 -0700 (2009-05-07)
branchdev
changeset 133 7ccecc57688d
parent 115 a3410b6ba79c
child 235 07b3070cea74
permissions -rw-r--r--
Touch up to compile with GCC 4.4
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
96
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
     1
% Dionysus README
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
     2
% Dmitriy Morozov
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
     3
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
     4
## Dependencies
5
ee9052408c40 Switched to a new architecture (Vineyard is a visitor for Filtration),
Dmitriy Morozov <morozov@cs.duke.edu>
parents:
diff changeset
     5
111
958dec48d946 Switched to CGAL 3.4 (native CMake configuration): for now only alphashapes
Dmitriy Morozov <dmitriy@mrzv.org>
parents: 96
diff changeset
     6
  * [CGAL]-3.4 ---  for alpha-shapes and kinetic data structures
96
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
     7
  * [DSR-PDB] ---   for reading in PDB files (if use_dsrpdb is turned on in cmake)
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
     8
  * [CMake] ---     for controlling the build process
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
     9
  * [boost] ---     great set of C++ libraries
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    10
  * [Doxygen] ---   for building documentation
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    11
  * [rlog] ---      for logging only (is not needed by default)
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    12
  * [SYNAPS] ---    for solving polynomials (for kinetic kernel), which in turn requires GMP
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    13
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    14
[CGAL]:         http://www.cgal.org
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    15
[DSR-PDB]:      http://www.salilab.org/~drussel/pdb/
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    16
[CMake]:        http://www.cmake.org
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    17
[boost]:        http://www.boost.org
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    18
[Doxygen]:      http://www.stack.nl/~dimitri/doxygen/
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    19
[rlog]:         http://www.arg0.net/rlog
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    20
[SYNAPS]:       http://www-sop.inria.fr/galaad/synaps/
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    21
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    22
## Building
15
ef3bf83302ca Switched to CMake
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 7
diff changeset
    23
  To build examples, create a directory build (to keep everything in one place),
ef3bf83302ca Switched to CMake
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 7
diff changeset
    24
  go to that directory and run cmake and make:
96
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    25
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    26
    mkdir build
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    27
    cd build
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    28
    cmake ..   (or "ccmake .." if you want a curses interface)
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    29
    make
15
ef3bf83302ca Switched to CMake
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 7
diff changeset
    30
  
96
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    31
  In the cmake line you can provide `-Ddebug:bool=on` to turn on debugging,
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    32
  `-Dcounters:bool=on` to turn on counters, `-Doptimize:bool=on` to turn on
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    33
  optimization, `-Duse_dsrpdb:bool=on` to turn on reading PDB files.  Depending on
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    34
  the combination of debugging and optimization, a particular `CMAKE_CXX_FLAGS*`
50
264e05b89875 Added ability to disable the use of DSR-PDB (disabled by default)
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 33
diff changeset
    35
  is chosen.  All of this can be set using a text user interface by running
96
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    36
  `ccmake` instead of `cmake`.
5
ee9052408c40 Switched to a new architecture (Vineyard is a visitor for Filtration),
Dmitriy Morozov <morozov@cs.duke.edu>
parents:
diff changeset
    37
96
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    38
  When compiling on a 64 bit platform (with Boost 1.34) add
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    39
  `-DBOOST_NO_INTRINSIC_INT64_T` to `CMAKE_CXX_FLAGS`.
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    40
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    41
## Author
f283106e8124 Switching README to PanDoc
Dmitriy Morozov <morozov@cs.duke.edu>
parents: 50
diff changeset
    42
  Dmitriy Morozov <dmitriy@mrzv.org>