[Ves] HowTo: add third-party data to KiwiViewer 0.02

[Stoner, Richard]

Hi,

Thanks to guidance from Pat Marion and the rest of the VES team, I've been able to build and use the PNL-SPL brain atlas (http://www.spl.harvard.edu/publications/item/view/1265) on iOS 5.0 as seen in the youtube video and pictured at http://www.vtk.org/Wiki/File:KiwiViewer_BrainAtlas.png

Below is a basic walk through.

==0. Install dependencies==

I recommend using homebrew to install these packages on OSX. To install, follow the instructions at http://mxcl.github.com/homebrew/.  Homebrew is a package manager for OSX (similar to apt/aptitude/yum/etc).

'''Dependencies'''

* cmake
:: brew install cmake

* git
:: brew install git

* xcode
:: http://itunes.apple.com/us/app/xcode/id448457090?mt=12

==1. Clone the code from the git repository==

:: git clone git://vtk.org/VES.git<http://vtk.org/VES.git>

==2. Configure iOS superbuild==

:: cd VES/Apps/iOS/CMakeBuild

:: cmake -P configure.cmake

==3. Build iOS superbuild

:: cd build

:: make -j4

This will take some time. It will download vtkmodular and the Eigen mathematics library

==4. Adding extra datasets==

* In the folder VES/src/vtkVES, open the file 'vesKiwiViewerApp.cpp' in your favorite editor.
* Uncomment lines 160-161 and lines 592-602
* Save the file.

==5. Rebuilding with updating code

* Return to the build directory (should be VES/Apps/iOS/CMakeBuild/build)
* Rebuild the modular VES for iOS device and simulator

:: make ves-ios-device
:: make ves-ios-simulator

==6. Copy external data to data folder==

The external data is hosted on Midas at http://midas.kitware.com/item/view/726

:: [http://midas.kitware.com/bitstream/view/17407 kiwiviewer_spl_pnl_brain_atlas.tgz]
:: [http://midas.kitware.com/bitstream/view/17408 kiwiviewer_can_data.tgz<http://midas.kitware.com/bitstream/view/17408%20kiwiviewer_can_data.tgz>]

The SPL Brain Atlas is licensed under the following:

''Please note that the data is being distributed under the Slicer license. By downloading these data, you agree to acknowledge our contribution in any of your publications that result form the use of this atlas. Please acknowledge the following grants: P41 RR13218, R01 MH050740.''

* Download and extract the SPL brain atlas and Can simulation to the folder VES/Apps/iOS/Kiwi/Kiwi/Data (each vtp file should be the Data folder, not a subfolder)

==7. Add data to project==

* Open the Kiwi Xcode project located at VES/Apps/iOS/Kiwi/Kiwi.xcodeproj

* Drag & drop the new files in the VES/Apps/iOS/Kiwi/Kiwi/Data into the 'Data" folder in the Xcode project.

[cid:6299E867-043C-4FA2-A9CB-779438478A41 at ucsd.edu]

* Tap "Run"

The KiwiViewer application should launch in the iOS simulator. Tap on the folder in the lower right corner to select the SPL Brain or Can dataset.

With the SPL Brain view loaded, a single tap toggles between different views. Tap on the clip plane manipulator to rotate the plane. Tap on the clip plane and drag to adjust its position.


Let me know if I missed something. Good luck'


Rich Stoner
Postdoctoral Fellow
UCSD Autism Center of Excellence
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://public.kitware.com/pipermail/ves/attachments/20120124/92a9dc40/attachment-0001.htm>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: kiwi-add_external_data.png
Type: image/png
Size: 74465 bytes
Desc: kiwi-add_external_data.png
URL: <http://public.kitware.com/pipermail/ves/attachments/20120124/92a9dc40/attachment-0001.png>