mabxsi / ice-cache-explorer

ICE Explorer - Lets you view a sequence of ICE cache files in 3D
http://bilzlee.blogspot.ca/
GNU General Public License v3.0
0 stars 0 forks source link

ICE Explorer

A 3D application written in python for viewing and reading Softimage ICE Cache files such as particle data. The application provides interactive tools for viewing the particles (playback, orbit, zoom, etc...), browsing cache data in a tree window and converting to ascii and HDF5 files.

License

GNY General Public License v3 (see the LICENSE.txt file for details) All files in the ice-cache-explorer repository are also covered.

Documentation and usage

Instructions how to get going with ICE Explorer (beta 1)

Requirements

These items are required by ICE Explorer and need to be installed first:

Note: to avoid compiling these modules you can download precompiled versions from this site:

http://www.lfd.uci.edu/~gohlke/pythonlibs/

How to download the code

git clone https://github.com/mabxsi/ice-cache-explorer 

How To Run

From the installation folder: python main.py

Loading ICECache Data

You can either load a folder containing a sequence of .icecache or .siH5 files (HDF5 format):

Or one or multiple .icecache/.siH5 files.

Drag and Drop

.icecache/.siH5 file(s) or folder can also be drag and dropped on the 3D view as an alternative for loading files.

Export To Text

Cache files can be exported to ascii files:

Export To .siH5

Cache files can be exported to HDF5 file format (.siH5):

note: The target folder defaults to 'c:\temp' or \var\tmp on linux. The default can be changed from the Preferences dialog (Edit|Preferences)

You can also export caches from the Browser window: right-click on a Cache or Attribute item.

Cancel operation

File load and export operations can be stopped by clicking on the Cancel button located in the File toolbar or by selecting the File|Cancel menu item.

Viewing

You can navigate in the 3D view with one of these tools: pan, orbit and zoom. They are all located in the 'Tools' toolbar. You can use presets to set the 3D view: perspective, top, front, right. These presets can be selected from the 'View' toolbar.

Browser

The Browser window contains a tree widget for listing loaded files information. The widget is updated when the cache files are being loaded. Note: Expanding the Attribute Data item can be long depending of the size of the data.

Playback

The play back window allows you to animate a sequence of cache files.

Controls

Preferences

This dialog is used for setting default values. The default export folder and number of processes is currently supported. More preferences are planned in a future release.

Limitations

  1. The 3D viewer supports these attributes only: PointPosition, Color