README.md 3.71 KB
Newer Older
1
# OpenWalnut
2 3 4 5 6 7 8 9 10 11 12 13 14

OpenWalnut is an open source tool for multi-modal medical and brain data
visualization. Its universality allows it to be easily extended and used in a
large variety of application cases. It is both, a tool for the scientific user
and a powerful framework for the visualization researcher.  OpenWalnut is
licensed under the terms of the GNU Lesser General Public License. Written
entirely in Standard C++ and using a number of portable libraries (e.g.
OpenSceneGraph and  Qt), it runs on all Windows platforms, OSX, and
GNU/Linux operating systems.

- please refer to http://www.openwalnut.org for extensive documentation 
  and information.

15
# AUTHORS AND CONTRIBUTORS
16 17 18

See the files "AUTHORS" and "CONTRIBUTORS".

19
# LICENSE
20

Alexander Wiebel committed
21
OpenWalnut is licensed under the terms of the LGPLv3.
22
See "COPYING" and "COPYING.LESSER".
23

24
# CONTACT
25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40

If you have questions, comments, problems or find Bugs, contact us using:
 
* Mailing list: openwalnut@lists.informatik.uni-leipzig.de
 * Very low traffic at the moment ( < 1 mail per month), you might want to try
   the developer mailing list below.
 * To join the list visit 
   http://lists.informatik.uni-leipzig.de/mailman/listinfo/openwalnut and follow
   the instructions.
* Developer Mailing list: openwalnut-dev@lists.informatik.uni-leipzig.de
 * Medium traffic ( < 10 mails per week).
 * To join the list visit
   http://lists.informatik.uni-leipzig.de/mailman/listinfo/openwalnut-dev and
   follow the instructions.
* IRC: Occasionally you can contact us at irc.freenode.net #ow.

41
# INSTALLING
42 43 44 45 46 47 48 49 50 51

You have several options for installing OpenWalnut.
 * Build it -> see next section
 * Download a binary archive from our website and extract it
    * Inside the extracted directory, run bin/openwalnut
 * Download one of our binary packages for your distribution
 * Check the NeuroDebian repository
    * We are currently working on a OpenWalnut package which is intended to be
      released in NeuroDebian (http://neuro.debian.net/)

52
# BUILDING
53

54 55 56 57
As you currently read this README, we presume that you already have the source.
If not, check http://www.openwalnut.org. There, you can download source archives
and get the URL to our mercurial repository.

58
## Required Dependencies:
59

Sebastian Eichelbaum committed
60
* Qt4 (>= 4.6)
61
* OpenSceneGraph (>= 2.8.0)
Sebastian Eichelbaum committed
62
* Boost (>= 1.42.0)
63

64
## Compilation on Unix-like systems:
65 66 67 68

If you have installed all required third party libs, you can compile OpenWalnut
by using the common routine:

69
```sh
70 71 72
cd build
cmake ../src
make
73
make install -- this is optional and installs everything.
74
```
75 76 77

After that, OpenWalnut can be used inside the build directory.

78 79
If you want to install only a part of OpenWalnut, you can issue

80
```sh
81
make list_install_tarets
82
```
83 84 85

The listed targets will then only install the specified part.

86
## Compilation on Windows and Mac:
87 88 89 90

This is a little bit more complicated. We give you a step-by-step explanation
on http://www.openwalnut.org.

91
# BINARY DISTRIBUTION
Sebastian Eichelbaum committed
92 93 94 95

If you have received OpenWalnut in binary form, you can always acquire the
code at http://www.openwalnut.org or from your distributor. In the binary
packages we provide, we might include open source, third-party libraries. 
Alexander Wiebel committed
96
If so, the licenses are re-distributed along the libraries. We did not modify
Sebastian Eichelbaum committed
97 98 99
the sources. However, you can get the sources of these libraries by contacting
us.

100
# USING
101 102 103 104

After starting OpenWalnut, press F1 to get an introductory help. More 
information is available online at http://www.openwalnut.org

105
# DEVELOPING
106 107 108

If you want to develop modules for OpenWalnut, have a look at 
src/modules/template, which contains an extensively documented example module.
109 110 111
More information is available online. The wiki, especially the development
section, is very helpful. Besides this, an online API documentation is available
at http://api.openwalnut.org.