Difference between revisions of "VOX and Virvo"

From Immersive Visualization Lab Wiki
Jump to: navigation, search
(New page: ---- <center><font size="7">VOX - Volume Explorer</font></center> ---- <br /> {| | "VOX" is an acronym for <u>VO</u>lume e<u>X</u>plorer, and it describes the volume rendering frameworks...)
 
(Movie Scripts)
 
(28 intermediate revisions by one user not shown)
Line 1: Line 1:
----
+
==Overview==
<center><font size="7">VOX - Volume Explorer</font></center>
+
----
+
  
<br />
 
 
{|
 
|
 
 
"VOX" is an acronym for <u>VO</u>lume e<u>X</u>plorer, and it describes the volume rendering frameworks for the desktop (DeskVOX) and CAVE-like virtual environments (CaveVOX). VOX uses the volume rendering library Virvo. "Virvo" is an acronym for <u>VI</u>rtual <u>R</u>eality <u>VO</u>lume Rendering.
 
"VOX" is an acronym for <u>VO</u>lume e<u>X</u>plorer, and it describes the volume rendering frameworks for the desktop (DeskVOX) and CAVE-like virtual environments (CaveVOX). VOX uses the volume rendering library Virvo. "Virvo" is an acronym for <u>VI</u>rtual <u>R</u>eality <u>VO</u>lume Rendering.
  
The goal of the VOX and Virvo projects is to provide interactive direct volume rendering on desktop computers and in virtual environments. VOX and Virvo have been developed in the [http://www.ccv.brown.edu/cave.html Cave at Brown University], and in the CUBE in the [http://www.hlrs.de/organization/vis/velab/ Virtual Environments Lab] at the High Performance Computing Center of the University of Stuttgart.
+
The goal of the VOX and Virvo projects is to provide interactive direct volume rendering on desktop computers and in virtual environments. VOX and Virvo have been developed in the [http://www.brown.edu/Departments/CCV/visualization/ Cave at Brown University], and in the CUBE in the [http://visserv.hlrs.de/velab/ Virtual Environments Lab] at the High Performance Computing Center of the University of Stuttgart.
  
You can view a [screenshot.htm screen shot] of DeskVOX or read a more [description.htm detailed description], or you can download an [movies/virvo-in-cube.mpg MPEG movie (28 MB)] of the Virvo virtual reality viewer as it is used in the CUBE. There is also a video of the VR transfer function editor, which is related to the IPTW/EGVE publication. The following movie formats are available for download: [movies/TFE-Demo.mpg 22MB MPEG-1], [movies/TFE-Demo.avi 15MB AVI], [movies/TFE-Demo-mpeg4.avi 6 MB MPEG-4].
+
You can view a [http://www.calit2.net/~jschulze/projects/vox/img/deskvox.jpg screen shot] of DeskVOX or read a more [description.htm detailed description], or you can download an [http://www.calit2.net/~jschulze/projects/vox/movies/virvo-in-cube.mpg MPEG movie (28 MB)] of the Virvo virtual reality viewer as it is used in the CUBE. There is also a video of the VR transfer function editor, which is related to the IPTW/EGVE publication. The following movie formats are available for download: [http://www.calit2.net/~jschulze/projects/vox/movies/TFE-Demo.mpg 22MB MPEG-1], [http://www.calit2.net/~jschulze/projects/vox/movies/TFE-Demo.avi 15MB AVI], [http://www.calit2.net/~jschulze/projects/vox/movies/TFE-Demo-mpeg4.avi 6 MB MPEG-4].
 +
 
 +
A video from the Brown Cave can be found [http://www.calit2.net/~jschulze/projects/doe-pnn./VolVisProgram.mp4 here (MPEG4 w/audio, 20MB)].
  
A more recent video from the Brown Cave can be found [../doe-pnnl/VolVisProgram.mp4 here (MPEG4 w/audio, 20MB)].
 
| valign="TOP" |
 
 
[[Image:cave-2-users-small.jpg]]
 
[[Image:cave-2-users-small.jpg]]
|}
 
  
----
+
==How to Download==
  
 
DeskVOX is open source software available for Windows, Linux, and Mac operating systems. The source code can be downloaded from the [http://sourceforge.net/projects/deskvox/ Deskvox page at Sourceforge]. Its GUI uses the [http://www.fox-toolkit.org FOX Toolkit] API. The Windows version auto-installs thanks to [http://nsis.sourceforge.net NSIS].
 
DeskVOX is open source software available for Windows, Linux, and Mac operating systems. The source code can be downloaded from the [http://sourceforge.net/projects/deskvox/ Deskvox page at Sourceforge]. Its GUI uses the [http://www.fox-toolkit.org FOX Toolkit] API. The Windows version auto-installs thanks to [http://nsis.sourceforge.net NSIS].
  
 
In order to download the source code from the version control system (SVN) you need to do the following from a Cygwin or Unix command line:
 
In order to download the source code from the version control system (SVN) you need to do the following from a Cygwin or Unix command line:
 
 
   
 
   
 
   svn co https://deskvox.svn.sourceforge.net/svnroot/deskvox/trunk deskvox
 
   svn co https://deskvox.svn.sourceforge.net/svnroot/deskvox/trunk deskvox
  
 
CaveVOX is based on Brown's in-house Cave framework and cannot be downloaded here. Permission to use CaveVOX may be granted on a case-by-case basis; please contact the [http://www.calit2.net/~jschulze/ author].
 
CaveVOX is based on Brown's in-house Cave framework and cannot be downloaded here. Permission to use CaveVOX may be granted on a case-by-case basis; please contact the [http://www.calit2.net/~jschulze/ author].
 
An older version of Deskvox, which used a Java AWT/Swing GUI and the Java Native Interface to call Virvo's C routines is available [release/Java-Deskvox.zip here].
 
  
 
----
 
----
Line 43: Line 33:
 
! Release Date
 
! Release Date
 
|-
 
|-
| 2.01b
+
| 2.1
 
|
 
|
[release/DeskVOX2_01b.exe DeskVOX2_01b.exe (1.7MB)]
+
[http://www.calit2.net/~jschulze/projects/vox/release/DeskVOX2_11.exe DeskVOX2_11.exe (2.3MB)]
 
|
 
|
 
|
 
|
[deskvox-mac/install.htm Deskvox4Mac]
 
 
|
 
|
[release/deskvox2_01b.txt info]
+
[http://www.calit2.net/~jschulze/projects/vox/release/deskvox2_01b.txt info]
 
|
 
|
2006-04-22[[Image:new.gif]]
+
2012-02-21
 
|-
 
|-
 
| 2.01b
 
| 2.01b
 
|
 
|
 +
[http://www.calit2.net/~jschulze/projects/vox/release/DeskVOX2_01b.exe DeskVOX2_01b.exe (1.7MB)]
 
|
 
|
[release/deskvox2_01b.tar.gz deskvox2_01b.tar.gz (1.6MB)]
+
[http://www.calit2.net/~jschulze/projects/vox/release/deskvox2_01b.tar.gz deskvox2_01b.tar.gz (1.6MB)]
 
|
 
|
 +
[http://www.calit2.net/~jschulze/projects/vox/deskvox-mac/install.htm Deskvox4Mac]
 
|
 
|
[release/deskvox2_01b.txt info]
+
[http://www.calit2.net/~jschulze/projects/vox/release/deskvox2_01b.txt info]
| 2005-05-13
+
|-
+
| 2.00b
+
 
|
 
|
[release/DeskVOX2_00b.exe DeskVOX2_00b.exe (2.4MB)]
+
2006-04-22
|
+
[release/deskvox2_00b.tar.gz deskvox2_00b.tar.gz (1.4MB)]
+
|
+
|
+
[release/deskvox2_00b.txt info]
+
| 2005-01-05
+
 
|}
 
|}
  
Line 78: Line 60:
 
Here's a tip for the Windows version of DeskVOX: Volume files can be passed to the program by drag-and-drop on the program icon. Or, for even greater convenience, you can create an entry in the Explorer's View/Options/FileType list, so that you can display volume files with a double-click on the file.
 
Here's a tip for the Windows version of DeskVOX: Volume files can be passed to the program by drag-and-drop on the program icon. Or, for even greater convenience, you can create an entry in the Explorer's View/Options/FileType list, so that you can display volume files with a double-click on the file.
  
----
+
==Sample Volume Files==
  
Here are a few [volumes.zip example volume files (1.4 MB)] to start with.
+
Here are a few [http://www.calit2.net/~jschulze/projects/vox/volumes.zip example volume files (1.4 MB)] to start with.
  
You will find more on the [http://www.gris.uni-tuebingen.de/areas/scivis/volren/datasets/datasets.html Tübingen Volume Visualization page]<nowiki>: either rename the files from '.raw' to '.dat' and use VConv to convert them to Virvo files, or you can dowload them in Virvo format here:</nowiki><br />[volvis/aneurism.zip aneurism.zip (309 KB)], [volvis/bonsai.zip bonsai.zip (3296 KB)], [volvis/engine.zip engine.zip (3138 KB)], [volvis/foot.zip foot.zip (4413 KB)], [volvis/fuel.zip fuel.zip (6 KB)], [volvis/hydrogen-atom.zip hydrogen-atom.zip (98 KB)], [volvis/lobster.zip lobster.zip (1923 KB)], [volvis/marschnerlobb.zip marschnerlobb.zip (36 KB)], [volvis/neghip.zip neghip.zip (78 KB)], [volvis/nucleon.zip nucleon.zip (18 KB)], [volvis/shockwave.zip shockwave.zip (70 KB)], [volvis/silicium.zip silicium.zip (35 KB)], [volvis/skull.zip skull.zip (9917 KB)], [volvis/statue-leg.zip statue-leg.zip (1750 KB)].
+
You will find more on the [http://www.gris.uni-tuebingen.de/areas/scivis/volren/datasets/datasets.html T&uuml;bingen Volume Visualization page]<nowiki>: either rename the files from '.raw' to '.dat' and use VConv to convert them to Virvo files, or you can dowload them in Virvo format here:</nowiki><br />[http://www.calit2.net/~jschulze/projects/vox/volvis/aneurism.zip aneurism.zip (309 KB)], [http://www.calit2.net/~jschulze/projects/vox/volvis/bonsai.zip bonsai.zip (3296 KB)], [http://www.calit2.net/~jschulze/projects/vox/volvis/engine.zip engine.zip (3138 KB)], [http://www.calit2.net/~jschulze/projects/vox/volvis/foot.zip foot.zip (4413 KB)], [http://www.calit2.net/~jschulze/projects/vox/volvis/fuel.zip fuel.zip (6 KB)], [http://www.calit2.net/~jschulze/projects/vox/volvis/hydrogen-atom.zip hydrogen-atom.zip (98 KB)], [http://www.calit2.net/~jschulze/projects/vox/volvis/lobster.zip lobster.zip (1923 KB)], [http://www.calit2.net/~jschulze/projects/vox/volvis/marschnerlobb.zip marschnerlobb.zip (36 KB)], [http://www.calit2.net/~jschulze/projects/vox/volvis/neghip.zip neghip.zip (78 KB)], [http://www.calit2.net/~jschulze/projects/vox/volvis/nucleon.zip nucleon.zip (18 KB)], [http://www.calit2.net/~jschulze/projects/vox/volvis/shockwave.zip shockwave.zip (70 KB)], [http://www.calit2.net/~jschulze/projects/vox/volvis/silicium.zip silicium.zip (35 KB)], [http://www.calit2.net/~jschulze/projects/vox/volvis/skull.zip skull.zip (9917 KB)], [http://www.calit2.net/~jschulze/projects/vox/volvis/statue-leg.zip statue-leg.zip (1750 KB)].
  
----
+
==Movie Scripts==
  
 
To write a script and create images which can later be merged to a movie clip, here are [moviescripts.zip two example Virvo movie script files (.vms) (1 KB)]<nowiki>: </nowiki>
 
To write a script and create images which can later be merged to a movie clip, here are [moviescripts.zip two example Virvo movie script files (.vms) (1 KB)]<nowiki>: </nowiki>
Line 91: Line 73:
 
* ''timesteps.vms'' switches through 8 time steps of a volume animation.
 
* ''timesteps.vms'' switches through 8 time steps of a volume animation.
  
----
+
To merge the images files into a movie clip [http://hamelot.io/visualization/using-ffmpeg-to-convert-a-set-of-images-into-a-video/ use ffmpeg]:
  
DISCLAIMER: ALL SOFTWARE ON MY HOMEPAGE IS PROVIDED "AS IS" AND WITHOUT WARRANTY OF ANY KIND, EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
+
To take a list of images that are padded with zeros (image00001.tif, image00002.tif, etc) use the following command:
  
----
+
<pre>ffmpeg -r 30 -f image2 -s 1280x720 -i image%05d.tif -vcodec libx264 -crf 25  -pix_fmt yuv420p animation.mp4</pre>
 +
 
 +
where the %04d means that zeros will be padded until the length of the string is 4 i.e 0001…0020…0030…2000 and so on. If no padding is needed use something similar to pic%d.png or %d.png.
 +
 
 +
    -r is the framerate (fps)
 +
    -crf is the quality, lower means better quality, 15-25 is usually good
 +
    -s is the resolution
 +
    -pix_fmt yuv420p specifies the pixel format, change this as needed
 +
 
 +
the file will be output (in this case) to: animation.mp4
 +
 
 +
==Disclaimer==
 +
 
 +
This software is provided "as is" and without warranty of any kind, express, implied or otherwise, including without limitation, any warranty of merchantability or fitness for a particular purpose.

Latest revision as of 18:33, 15 March 2017

Contents

Overview

"VOX" is an acronym for VOlume eXplorer, and it describes the volume rendering frameworks for the desktop (DeskVOX) and CAVE-like virtual environments (CaveVOX). VOX uses the volume rendering library Virvo. "Virvo" is an acronym for VIrtual Reality VOlume Rendering.

The goal of the VOX and Virvo projects is to provide interactive direct volume rendering on desktop computers and in virtual environments. VOX and Virvo have been developed in the Cave at Brown University, and in the CUBE in the Virtual Environments Lab at the High Performance Computing Center of the University of Stuttgart.

You can view a screen shot of DeskVOX or read a more [description.htm detailed description], or you can download an MPEG movie (28 MB) of the Virvo virtual reality viewer as it is used in the CUBE. There is also a video of the VR transfer function editor, which is related to the IPTW/EGVE publication. The following movie formats are available for download: 22MB MPEG-1, 15MB AVI, 6 MB MPEG-4.

A video from the Brown Cave can be found here (MPEG4 w/audio, 20MB).

Cave-2-users-small.jpg

How to Download

DeskVOX is open source software available for Windows, Linux, and Mac operating systems. The source code can be downloaded from the Deskvox page at Sourceforge. Its GUI uses the FOX Toolkit API. The Windows version auto-installs thanks to NSIS.

In order to download the source code from the version control system (SVN) you need to do the following from a Cygwin or Unix command line:

  svn co https://deskvox.svn.sourceforge.net/svnroot/deskvox/trunk deskvox

CaveVOX is based on Brown's in-house Cave framework and cannot be downloaded here. Permission to use CaveVOX may be granted on a case-by-case basis; please contact the author.


Here you can download the latest releases of DeskVOX:

Version Windows Linux Apple Info Release Date
2.1

DeskVOX2_11.exe (2.3MB)

info

2012-02-21

2.01b

DeskVOX2_01b.exe (1.7MB)

deskvox2_01b.tar.gz (1.6MB)

Deskvox4Mac

info

2006-04-22


Here's a tip for the Windows version of DeskVOX: Volume files can be passed to the program by drag-and-drop on the program icon. Or, for even greater convenience, you can create an entry in the Explorer's View/Options/FileType list, so that you can display volume files with a double-click on the file.

Sample Volume Files

Here are a few example volume files (1.4 MB) to start with.

You will find more on the Tübingen Volume Visualization page: either rename the files from '.raw' to '.dat' and use VConv to convert them to Virvo files, or you can dowload them in Virvo format here:
aneurism.zip (309 KB), bonsai.zip (3296 KB), engine.zip (3138 KB), foot.zip (4413 KB), fuel.zip (6 KB), hydrogen-atom.zip (98 KB), lobster.zip (1923 KB), marschnerlobb.zip (36 KB), neghip.zip (78 KB), nucleon.zip (18 KB), shockwave.zip (70 KB), silicium.zip (35 KB), skull.zip (9917 KB), statue-leg.zip (1750 KB).

Movie Scripts

To write a script and create images which can later be merged to a movie clip, here are [moviescripts.zip two example Virvo movie script files (.vms) (1 KB)]:

  • fullrot180.vms rotates the data set by 360 degrees in 180 time steps.
  • timesteps.vms switches through 8 time steps of a volume animation.

To merge the images files into a movie clip use ffmpeg:

To take a list of images that are padded with zeros (image00001.tif, image00002.tif, etc) use the following command:

ffmpeg -r 30 -f image2 -s 1280x720 -i image%05d.tif -vcodec libx264 -crf 25  -pix_fmt yuv420p animation.mp4

where the %04d means that zeros will be padded until the length of the string is 4 i.e 0001…0020…0030…2000 and so on. If no padding is needed use something similar to pic%d.png or %d.png.

   -r is the framerate (fps)
   -crf is the quality, lower means better quality, 15-25 is usually good
   -s is the resolution
   -pix_fmt yuv420p specifies the pixel format, change this as needed

the file will be output (in this case) to: animation.mp4

Disclaimer

This software is provided "as is" and without warranty of any kind, express, implied or otherwise, including without limitation, any warranty of merchantability or fitness for a particular purpose.