Documentation

KiwiViewer is a visualization app for exploration of scientific and medical datasets on mobile devices.

KiwiViewer supports the following touch interactions:

  • 3D rotation : 1-finger pan gesture
  • Pan camera : 2-finger pan gesture
  • Dolly (zoom): 2-finger pinch gesture
  • Roll camera : 2-finger rotate gesture

All 2-finger gestures are recognized simultaneously.

KiwiViewer supports the following data formats:

  • Wavefront .obj
  • Stereolithography (.stl)
  • Polygon (.ply)
  • MOVIE.BYU geometry file (.g)
  • Protien Data Bank (.pdb)
  • VTK (.vtp, vtu, vti, vtk)
  • MetaImage (.mha)

If provided, scalar data at vertices will be used to color the data. A blue to red color map is used to display the full scalar range. For images with scalar data, a gray scale color map is used.

KiwiViewer supports the following geometric primitive types:

  • Polygons
  • Triangle strips
  • Lines
  • Points

3D image data is displayed using orthogonal slice planes. Unstructured data with 3D cells will be converted to polygonal surface geometry. KiwiViewer is unable to open datasets that have polygonal primitive types and have more than 65,000 points.

To load data from DropBox:
  • Open the data file (with supported file extension) in the DropBox app
  • On iOS, tap the action icon and "Open in…KiwiViewer"

To load data from email attachments on iOS:

  • Open the mail app and navigate to your message
  • Tap the file attachment and "Open in…KiwiViewer"

To load multiple datasets at once:

KiwiViewer can load scenes consisting of multiple datasets. The datasets can be opened from the device's internal storage, or downloaded from URLs. The scene is described using a simple comma-separated-value file. Visit the wiki for a description of the file format.

To connect to ParaViewWeb:

KiwiViewer can join a live ParaViewWeb session and download the remote scene for local rendering. Visit the ParaViewWeb website for more information. The instructions for connecting KiwiViewer to ParaViewWeb are available on the wiki.

Mailing Lists

The KiwiViewer mailing list is the principal means of communications among users and developers. Please go here to subscribe to the list. Instructions are given to receive an archive version of the list, as well as to manage and unsubscribe from the list. The mailing list archives can be searched using the search tool provided above. You may want to search for a previously posted answer to your question before posting to the mailing list.

Bug Tracker

The KiwiViewer bug tracker is located here.