Differences between revisions 3 and 10 (spanning 7 versions)

3D Renderer (In Beta)

This is a plugin for Cytoscape 3 that attempts to render networks in 3D and integrate itself with VizMapper. Currently, it is still under development.

Current Features

Camera movement, rotation
Network rendering
Bird's eye view that can be clicked on to navigate the main camera
Node and edge manipulation (node dragging, selection, addition, removal)
Basic node shapes (spheres, cubes, tetrahedrons)
Node label text rendering

Download

(Link coming soon)

Installation

Windows users: Extract the .zip file and run cytoscape.bat.

Mac, Linux, UNIX OS users: Extract the .tar.gz file and run cytoscape.sh.

Camera Controls

Movement:

W	Move up
A	Move left
S	Move down
D	Move right
E	Move forward
Q	Move backward

Rotation:

Z	Roll camera clockwise
X	Roll camera counter-clockwise
Shift + Left	Rotate about Y-Axis, towards the left
Shift + Right	Rotate about Y-Axis, towards the right
Shift + Up	Rotate about X-Axis, upwards
Shift + Down	Rotate about X-Axis, downwards

First-person camera turning:

Left	Turn camera left
Right	Turn camera right
Up	Tilt camera upwards
Down	Tilt camera downwards

Network Manipulation Controls

Node, edge addition and removal:

N	Creates a new node under the mouse cursor
J	Creates a new edge between currently selected nodes and the node currently under the mouse cursor
Delete	Removes currently selected nodes and edges

Selection: Drag the mouse to select objects, or click on nodes to select them.

Node dragging: Hold CTRL and drag the mouse to move currently selected nodes.

Bird's eye view

Under the Network tab to the left, click or drag the mouse on the bird's eye view display to move the main camera

Notes about Visual Properties

For node shapes, the following settings in VizMapper will give the following results:

VizMapper setting	3D result
Ellipse	Sphere
Diamond	Cube
Triangle	Tetrahedron

Currently Supported Visual Properties

Nodes:

Node fill color
Node shape
Node label

Edges:

Edge fill color

Planned Features

More complete set of supported visual properties
Integration with VizMapper's default style previewer/editor

Source Code

The source code for the 3D renderer plugin may be found at the following SVN repository: http://chianti.ucsd.edu/svn/csplugins/trunk/toronto/yuedong/paperwing-impl

Known Issues

Currently may crash if switching between networks when more than one network is opened at the same time.
May crash if a network viewing window is resized such that the width:height ratio becomes less than 1.
Node labels may not edit properly when attempting to change them through VizMapper.
Node labels do not always directly face the camera.

Version History

January 24, 2012

v0.5: Initial beta release

-  ← Revision 3 as of 2012-01-24 21:13:40 →
  Size: 1784
  Editor: 192
  Comment:
+  ← Revision 10 as of 2012-01-24 21:37:25 →
  Size: 3177
  Editor: 192
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 1:
-== 3D Renderer ==
+= 3D Renderer (In Beta) =
 Line 5:
-=== Current Features ===
+== Current Features ==
 Line 8:
+ * Network rendering
-Line 13:
+Line 14:
-=== Download ===
+== Download ==
-Line 16:
+Line 17:
+== Installation ==



Windows users: Extract the .zip file and run cytoscape.bat.



Mac, Linux, UNIX OS users: Extract the .tar.gz file and run cytoscape.sh.
-Line 32:
+Line 39:
-|| Shift + Up/Down || Rotate about X-Axis ||

|| Shift + Left/Right || Rotate about Y-Axis ||
+|| Shift + Left || Rotate about Y-Axis, towards the left ||

|| Shift + Right || Rotate about Y-Axis, towards the right ||

|| Shift + Up || Rotate about X-Axis, upwards ||

|| Shift + Down || Rotate about X-Axis, downwards ||
-Line 35:
+Line 44:
-Bird's eye view:

 * Under the Network tab to the left, click or drag the mouse on the bird's eye view to move the main camera
+First-person camera turning:



|| Left || Turn camera left ||

|| Right || Turn camera right ||

|| Up || Tilt camera upwards ||

|| Down || Tilt camera downwards ||
-Line 40:
+Line 53:
-Selection:

 * Drag the mouse to select objects, or click on nodes to select them.
-Line 45:
+Line 55:
-|| J || Creates a new edge between currently selected nodes and the node currently under the mouse cursor
+|| J || Creates a new edge between currently selected nodes and the node currently under the mouse cursor ||

|| Delete || Removes currently selected nodes and edges ||
-Line 47:
+Line 58:
-Node dragging:

 * Hold CTRL and drag the mouse to move currently selected nodes.
+'''Selection''': Drag the mouse to select objects, or click on nodes to select them.
-Line 50:
+Line 60:
-=== Currently Supported Visual Properties ===
+'''Node dragging''': Hold CTRL and drag the mouse to move currently selected nodes.



== Bird's eye view ==



Under the Network tab to the left, click or drag the mouse on the bird's eye view display to move the main camera



== Notes about Visual Properties ==



For node shapes, the following settings in VizMapper will give the following results:



|| '''VizMapper setting''' || '''3D result''' ||

|| Ellipse || Sphere ||

|| Diamond || Cube ||

|| Triangle || Tetrahedron ||



== Currently Supported Visual Properties ==
-Line 60:
+Line 85:
-=== Planned Features ===
+== Planned Features ==
-Line 65:
+Line 90:
-=== Version History ===
+== Source Code ==
-Line 67:
+Line 92:
-==== January 24, 2012 ====
+The source code for the 3D renderer plugin may be found at the following SVN repository: http://chianti.ucsd.edu/svn/csplugins/trunk/toronto/yuedong/paperwing-impl



== Known Issues ==



 * Currently may crash if switching between networks when more than one network is opened at the same time.

 * May crash if a network viewing window is resized such that the width:height ratio becomes less than 1.

 * Node labels may not edit properly when attempting to change them through VizMapper.

 * Node labels do not always directly face the camera.



== Version History ==



=== January 24, 2012 ===

Diff for "Cytoscape_3/3D_Renderer"