| | 1 | #summary How to install 3d Brain Atlas Reconstructor on Ubuntu? |
| | 2 | |
| | 3 | = 3d Brain Atlas Reconstructor Installation (Ubuntu) = |
| | 4 | |
| | 5 | ---- |
| | 6 | *Note*: This procedure is valid for _Ubuntu 9.04_ and _Ubuntu 10.04 LTS_ and was tested on 4.08.2010. |
| | 7 | For guides related to _Ubuntu 8.04_ see [InstallationUbuntu804 here]. |
| | 8 | Installation on other Ubuntu versions or other Linux distributions is simmilar, however not yet described. |
| | 9 | ---- |
| | 10 | <wiki:toc max_depth="3" /> |
| | 11 | |
| | 12 | ==Installing required packages== |
| | 13 | |
| | 14 | Installation consists of following steps (just paste code blocks into terminal it should be fine (Ubuntu 9.10). |
| | 15 | # Installing Visualization Toolkit and other graphic libraries: |
| | 16 | {{{ |
| | 17 | sudo apt-get install \ |
| | 18 | libvtk5.2 libvtk5-dev libvtk5.2-qt4 libvtk5-qt4-dev \ |
| | 19 | tk8.5 tk8.5-dev \ |
| | 20 | python-vtk libgtkgl2.0-1 libgtkgl2.0-dev libgtkglext1 librsvg2-2 python-nifti |
| | 21 | }}} |
| | 22 | # Installing python-related packages: |
| | 23 | {{{ |
| | 24 | sudo apt-get install \ |
| | 25 | python-gtkglext1 python-rsvg python-opengl python-numpy python-scipy python-wxgtk2.6 |
| | 26 | }}} |
| | 27 | # Other packages: |
| | 28 | {{{ |
| | 29 | sudo apt-get install \ |
| | 30 | potrace pstoedit python-setuptools subversion python-epydoc |
| | 31 | }}} |
| | 32 | |
| | 33 | If You are developer, you may also want to install optional packages with documentation: |
| | 34 | {{{ |
| | 35 | sudo apt-get install vtkdata vtk-doc vtk-examples |
| | 36 | }}} |
| | 37 | |
| | 38 | If you use Ubuntu 10.04 install following packages: |
| | 39 | {{{ |
| | 40 | sudo apt-get install \ |
| | 41 | libvtk5.2 libvtk5-dev libvtk5.2-qt4 libvtk5-qt4-dev \ |
| | 42 | tk8.5 tk8.5-dev \ |
| | 43 | python-vtk libgtkgl2.0-1 libgtkgl2.0-dev libgtkglext1 librsvg2-2 python-nifti |
| | 44 | }}} |
| | 45 | {{{ |
| | 46 | sudo apt-get install \ |
| | 47 | python-gtkglext1 python-rsvg python-opengl python-numpy python-scipy python-wxgtk2.6 |
| | 48 | }}} |
| | 49 | {{{ |
| | 50 | sudo apt-get install \ |
| | 51 | potrace pstoedit python-setuptools subversion python-epydoc |
| | 52 | }}} |
| | 53 | |
| | 54 | If you use Ubuntu 10.10 install following packages: |
| | 55 | {{{ |
| | 56 | sudo apt-get install \ |
| | 57 | libvtk5.4 libvtk5-dev libvtk5.4-qt4 libvtk5-qt4-dev \ |
| | 58 | tk8.5 tk8.5-dev \ |
| | 59 | python-vtk libgtkgl2.0-1 libgtkgl2.0-dev libgtkglext1 librsvg2-2 python-nifti |
| | 60 | }}} |
| | 61 | {{{ |
| | 62 | sudo apt-get install \ |
| | 63 | python-gtkglext1 python-rsvg python-opengl python-numpy python-scipy python-wxgtk2.8 |
| | 64 | }}} |
| | 65 | {{{ |
| | 66 | sudo apt-get install \ |
| | 67 | potrace pstoedit python-setuptools subversion python-epydoc |
| | 68 | }}} |
| | 69 | |
| | 70 | Once all packages are installed, it's time to create directory structure: |
| | 71 | ==Getting code== |
| | 72 | It is assumed that main directory dedicated for software is `/home/$USERNAME/3dbar`. |
| | 73 | if You want to install to another directory, please replace `3dbar` with desired path. |
| | 74 | |
| | 75 | In order to get latest stable version use following command: |
| | 76 | {{{ |
| | 77 | svn checkout http://3dbrainatlasreconstructor.googlecode.com/svn/tags/latest/ |
| | 78 | }}} |
| | 79 | |
| | 80 | or get working code snapshot: |
| | 81 | {{{ |
| | 82 | svn checkout http://3dbrainatlasreconstructor.googlecode.com/svn/trunk/ /home/$USERNAME/3dbar |
| | 83 | }}} |
| | 84 | |
| | 85 | then create directory where datasets will be stored: |
| | 86 | {{{ |
| | 87 | mkdir -p /home/$USERNAME/3dbar/atlases |
| | 88 | }}} |
| | 89 | |
| | 90 | Created directories have following purposes: |
| | 91 | * *bin*: Holds all executable files, atlas parsers and auxiliary scripts |
| | 92 | * *lib*: Holds 3dBAR api |
| | 93 | * *atlases*: Directory, where source data, _CAF_ _datasets_ and reconstructed models are stored. Each dataset (denoted as DATASET_NAME) contains following subdirectories: |
| | 94 | * atlases/DATASET_NAME/src : Here source data is located. It may be put manually by user or ie. downloaded from internet depending on particular parser. |
| | 95 | * atlases/DATASET_NAME/caf : Is the directory where CAF dataset is generated by particular parsers. |
| | 96 | * atlases/DATASET_NAME/reconstructions : Here performed reconstruction are generated using 3dBAR GUI. |
| | 97 | |
| | 98 | <wiki:comment> |
| | 99 | ==Initial build== |
| | 100 | In order create initial CAF datasets, generate documentation use following command in /home/$USERNAME/3dbar/ directory: |
| | 101 | {{{ |
| | 102 | make -B -j N all |
| | 103 | }}} |
| | 104 | |
| | 105 | where N is number of parallel processes You want to use. If everything is installed correctly processing should be performed without any errors. Then 3dBAR GUI should be launched |
| | 106 | {{{ |
| | 107 | ./3dbar.sh |
| | 108 | }}} |
| | 109 | and used to perform reconstructions. If everything went fine, You may proceed to : |
| | 110 | |
| | 111 | |
| | 112 | ==Getting parsers for additional datasets== |
| | 113 | |
| | 114 | </wiki:comment> |