The NIH/NIGMS
Center for Integrative Biomedical Computing

ImageVis3D is the leading open source volume renderer for rendering large scale data on commodity workstations. It is available on all popular operating systems. ImageVis3D can read in a wide variety of file formats common to the medical imaging field such as DICOMs, image stacks, Analyze 7.5, Kitware MHD files, BOV meshes, and NRRDs, in addition to a variety of formats from other domains. It can be downloaded and used completely free of charge for any purpose.

 

The first place to turn to is the documentation. We supply multiple documents that cover the full gamut of use cases, from loading up your first data set to adding support for your custom file format.

pdf button The ImageVis3D User's Manual takes you through every aspect of the ImageVis3D user interface, and how you can use ImageVis3D to visualize your data today!
pdf button The Getting Data Into ImageVis3D documentation is your one-stop shop to learning everything about file formats, from which ones ImageVis3D supports -- including recommendations on what to build your pipeline around -- to how you can take advantage of the streamlined support for adding new file formats.
pdf button The ImageVis3D Mobile 2.0 User's Guide teaches you how to visualize your data wherever you are, from your next meeting to the next international conference.

 

Tutorials
Compiling ImageVis3D from Source
New File Formats
Dev Builds

Source Code Acquisition

The ImageVis3D source code is on github:

https://github.com/SCIInstitute/ImageVis3D

The ImageVis3D repo uses git submodules for handling its primary dependency, Tuvok. If you are cloning the repository from the command line, be sure to issue the appropriate submodule init and submodule update commands:

git submodule init
git submodule update


Building

Building the source code differs per platform.


Linux/Mac

You'll need Qt development packages installed, including qmake. We do not support any version of Qt earlier than 4.6 at present, though ImageVis3D might work with earlier versions.

Building on Unix-like systems is fairly easy: cd to the directory you've checked out, and then run "qmake -recursive". Then run "make".

Qmake is a bit annoying for projects composed of many pieces. If you change anything in Tuvok, make sure to rm Tuvok/Build/libTuvok.a before you re-run 'make', as otherwise the system will not relink the main 'imagevis3d' binary with the new 'libTuvok.a'


Debian/Ubuntu Packages

If you're on Debian or Ubuntu, you can obtain all the prerequisites for building with:

sudo apt-get install qt4-dev-tools qt4-qmake libqt4-dbg libqt4-dev \
libqt4-opengl-dev libqt4-opengl libqtcore4 build-essential libstdc++6-4.6-dbg \
zlib1g zlib1g-dbg zlib1g-dev flex bison

 

Mac Caveat

Do note that you need to compile Qt from source yourself. We supply scripts for this under Scripts/ in the main 'imagevis3d' repository.


Windows

Project files are included for both VS 2008 and VS 2010. VS 2008 requires the "feature pack" to be installed as well. VS 2008 support will be dropped in the near future.

The one issue with windows support: you must use a Qt which was compiled using the version of Visual Studio you'll use for developing ImageVis3D. Allow me to repeat that: you must use a Qt which was compiled using the version of Visual Studio you'll use for developing ImageVis3D. You cannot use the officially-provided Qt binaries.

We supply a script, available under Scripts/Win-StaticQt-version.bat, which will compile Qt for you in the method required for ImageVis3D (in particular, it must be a static build).

 

ImageVis3D supports (potentially) anisotropic volume ("raster") data, as well as mesh information, as might be generated by BioMesh3D.

There is extensive documentation on how to add your own file format into ImageVis3D in the Getting Data Into ImageVis3D manual; see section 4 in particular.

 

The ImageVis3D teams makes a series of "developer builds" available for early adopters. These builds typically have cutting edge features, but are not formally deemed ready for public release. Your feedback is welcome!