source: orange/orange/doc/widgets/Unsupervised/NetExplorer.htm @ 9399:6bbe263e8bcf

Revision 9399:6bbe263e8bcf, 7.1 KB checked in by mitar, 2 years ago (diff)

Renaming widgets catalog.

Line 
1<html>
2<head>
3<title>Net Explorer</title>
4<link rel=stylesheet href="../../../style.css" type="text/css" media=screen>
5<link rel=stylesheet href="../../../style-print.css" type="text/css" media=print></link>
6</head>
7
8<body>
9
10<h1>Net Explorer</h1>
11<img class="screenshot" src="../icons/NetExplorer.png">
12<p>Interactive network exploration widget.</p>
13
14<h2>Channels</h2>
15
16<h3>Inputs</h3>
17<DL class=attributes>
18<DT>Network (Network)</DT>
19<DD>Network object to plot.</DD>
20<DT>Items (ExampleTable)</DT>
21<DD>Alternative meta data to associate with network.</DD>
22<DT>Items to Mark (ExampleTable)</DT>
23<DD>A subset from items instances to mark.</DD>
24<DT>Items Subset (ExampleTable)</DT>
25<DD>A subset from items instances to hide.</DD>
26<DT>Vertex Distance (SymMatrix)</DT>
27<DD>Distance matrix containing distances between all vertices.</DD>
28</dl>
29
30<h3>Outputs</h3>
31<DL class=attributes>
32<DT>Selected Network (Network)</DT>
33<DD>Subnetwork of all selected nodes.</DD>
34<DT>Selected Examples (ExampleTable)</DT>
35<DD>Instances from items ExampleTable that corresponds to selected vertices.</DD>
36<DT>Unselected Examples (ExampleTable)</DT>
37<DD>Instances from items ExampleTable that corresponds to unselected vertices.</DD>
38<DT>Marked Examples (ExampleTable)</DT>
39<DD>Instances from items ExampleTable that corresponds to marked vertices.</DD>
40</dl>
41
42<h2>Description</h2>
43<p>Net Explorer is used to visualize graphs, let the user explore them by selecting their
44individual parts and transmit the corresponding data to other widgets. It is currently available
45only in latest (Qt4) version of Orange.</p>
46
47<p>To use Net Explorer from a python script one should also read <a href="../../../modules/orngNetwork.htm">
48orngNetwork Orange module</a> documentation.</p>
49
50<a href="NetExplorer.png"><img class="screenshot"
51src="NetExplorer-S.png" alt="Classification Tree Graph
52- Node Tab" border=0></a></center>
53
54<h3>Navigation</h3>
55<p>Four navigation buttons are located in the upper right corner in control area.</p>
56
57<p><i>Zooming:</i></p>
58<p>Zooming mode is selected by default. User can zoom in a rectangle by pressing and holding the
59left mouse button and dragging the mouse to draw a rectangle to zoom in to. Zoom out (one level)
60command can then be executed by pressing right mouse button.</p>
61
62<p><i>Zoom to extent:</i></p>
63<p>By pressing this button the zoom is automatically set to show all visible nodes in the network.</p>
64
65<p><i>Zoom selection:</i></p>
66<p>By pressing this button the zoom is automatically set to show all selected nodes in the network.</p>
67
68<p><i>Panning:</i></p>
69<p>Use this mode to drag the network around the canvas.</p>
70
71<h3>Marking and Selecting</h3>
72<p>The widget features a two-stage procedure for selection of vertices, which allows for a very flexible
73manipulation of subsets of vertices. Vertices can be marked and/or selected. Marked vertices are presented
74by filled circled and selected vertices are highlighted with a yellow border.</p>
75
76<p>Vertices can be selected manually by clicking or by drawing selection rectangle. Selection mode is
77enabled by pressing fifth button from the top in the upper right corner in control area. Another way to
78select vertices is to add or remove the marked vertices to or from the selection, or to replace the
79current selection with the marked vertices (buttons seven to nine).</p>
80
81<p>The vertices can be marked based upon values of the attributes of the corresponding objects. Most marking
82options are available in the Mark Tab.</p>
83
84<h3>Vertices Tab</h3>
85<p>Parameters in vertices tab govern the appearance of network vertices and data associated with them.
86User can select optimization method, vertex color and size attribute, set the labels and tooltips and
87other rendering options.</p>
88
89<p><i>Optimization methods:</i></p>
90<ul>
91<li>no optimization;</li>
92<li>random;</li>
93<li>Fruchterman-Reingold;</li>
94<li>Fruchterman-Reingold Weighted;</li>
95<li>Fruchterman-Reingold Radial;</li>
96<li>circular crossing reduction;</li>
97<li>circular original;</li>
98<li>circular random;</li>
99</ul>
100<p>The user can specify the number of iterations of the optimization procedure where applicable.</p>
101<p><i>Labels & tooltips</i></p>
102<p>A number of attributes can be chosen to form vertex labels or tooltips. Font size can also be set.</p>
103<p><i>Show labels on marked vertices only</i></p>
104<p>When selected, only labels on marked nodes are displayed.</p>
105<p><i>Inside view</i></p>
106<p>In this special mode, only selected vertex and vertices closer to it than specified distance are shown.</p>
107<p><i>Show missing values</i></p>
108<p>Indicates whether missing values should be displayed ad questionmarks.</p>
109
110<h3>Edges Tab</h3>
111<p>Parameters in edges tab are used to specify the appearance of edges. One can set edges color, width and
112whether weights are displayed.</p>
113<p><i>Explore vertex distances:</i></p>
114<p>When selected, user can examine the distance between vertices that can be given through "Vertex Distance" signal.
115To display the distance, one must first select a vertex. When hovering over an arbitrary vertex, the distance between
116selected and the vertex under mouse pointer is displayed as a popup.</p>
117
118<h3>Mark Tab</h3>
119<p>Most options for interactive network exploration are gathered here. User can search for nodes by value in items meta
120data, mark neighbours of selected vertices or mark vertices by number of connections.</p>
121
122<p><i>Complete list of marking features:</i></p>
123<ul>
124<li>mark neighbours of focused vertex,</li>
125<li>mark neighbours of selected vertex,</li>
126<li>mark vertices with at list N connections,</li>
127<li>mark vertices with at most N connections,</li>
128<li>mark vertices with more connections than any neighbour,</li>
129<li>mark vertices with more connections than average neighbour,</li>
130<li>find hubs (vertices with the most connections),</li>
131<li>mark vertices specified in input signal (Items to Mark signal).</li>
132</ul>
133
134<h3>Info Tab</h3>
135<p>General information (such as: number of vertices, number of edges, diameter, clustering coefficient) about network are
136displayed here. To calculate and display degree distribution, click "Degree Distribution" button. Network can be saved in
137<a href="http://pajek.imfm.si/doku.php">Pajek</a> format clicking on "Save network" button.</p>
138
139<h2>Examples</h2>
140<p>The best way to get to know how to use this widget is by playing with it. Try some of the following network data sets:</p>
141
142<ul>
143<li><a href="NetExplorer-K2K4.net">K2K4</a>, a network containing two full graphs (one with 2 vertices, other with 4);</li>
144<li><a href="NetExplorer-K8.net">K8</a>, ful graph with 8 vertices;</li>
145<li><a href="NetExplorer-Cube.net">cube</a>, a cube;</li>
146<li><a href="NetExplorer-Star.net">star</a>, a star with 6 vertices;</li>
147<li><a href="NetExplorer-Rose.net">rose</a>, a rose like graph with 19 vertices;</li>
148<li><a href="NetExplorer-Lattice.net">lattice</a>, a lattice with 100 vertices;</li>
149<li><a href="NetExplorer-lastfm_artists.net">last.fm network</a> and <a href="NetExplorer-lastfm_artists.tab">last.fm items</a>, a network where similar artists are connected. Data was aquired from the <a href="http://www.last.fm/">last.fm web site</a>.</li>
150</ul>
151
152<p>More comprehensive list of examples will be available soon.</p>
153
154</body>
155</html>
Note: See TracBrowser for help on using the repository browser.