README
author Christos Mantoulidis <cmad@stanford.edu>
Tue, 04 Aug 2009 13:23:16 -0700 (2009-08-04)
branchdev
changeset 156 f75fb57d2831
parent 115 a3410b6ba79c
child 235 07b3070cea74
permissions -rw-r--r--
Changed implementation of WeightedRips to store simplex values (max distance between simplices' vertices) as an invisible layer on top of each simplex object, so that the data() field of WeightedRips has been freed for use by the users again.
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>