Nodechart Help (v1.0.0)

Getting Started

Begin charting (exploring your network) by dragging and dropping nodes to desired locations. Clicking on a node will display a Node Menu - which will allow various operations relevant to that node to be performed (such as expanding or collapsing it). Which in turn, will enable you to explore its network neighbors and so on. Your chart is automatically saved as you navigate the network. Additional nodes can be searched for and added to the chart by the use of the "Add Node" option. As your chart grows in size you may find it necessary to start to use the Expansion/Search Filter Settings, perhaps the zoom and navigate functionality, and maybe also to increase the size of the displayed image canvas. All of these aspects are discussed in more detail throughout this help page.

Network nodes are represented either by their name label or by an image (icon). If there is an icon displayed for a node, then the node name label will be displayed below the node. Above each node two numbers are displayed - for example; (2,10). The first number, (2) in this case, represents the number of network neighbors to this node that satisfy the Expansion/Search Filter Settings. The second number, (10) in this case, represents the total number of network neighbors. Links that start and end with the same node are not displayed in the chart nor represented in the node neighbor counts. In a special case, if no Expansion/Search Filter Settings are defined then the two numbers shown will be the same.

Network links are represented by a single line between two nodes. Either the network link name label, or a count of the number of network links, will be displayed slightly above each line (depending upon the network definition). That is, in the case where there is one network link between two nodes, either the link name or the number (1) will be shown. Where there are multiple network links between two nodes only the count of the number of links is displayed, for example; (3). For undirected networks the link name label/count is displayed at the line midpoint, whereas for directed networks the name label/count is shown slightly closer to the starting node. Temporary chart links have a small link handle (?) displayed below the line.

[Top]

Chart Menu

Clicking on the chart image canvas will reveal the Chart Menu. This menu is for general chart operations and has the following options;

Menu Option Description
Add Node Invokes a popup window that facilitates adding new nodes to the chart. Enter a node name search term. Two search options are provided, either "Search (filter)" or "Search ALL". "Search (filter)" will search for nodes that satisfy the search term and also satisfy any Expansion/Search Filter Settings that are relevant to nodes, whereas "Search ALL" will search all network nodes for the specified search term. Multiple nodes can be added to the chart and the "Disperse" option will radially disperse the new nodes otherwise they will be overlayed at the same spot.
Refresh Refreshes the displayed chart without reloading the entire page.
New Chart Clears the chart canvas and creates a new, initially empty, chart utilizing the same network as the current chart.
List Charts Returns to the Chart listing screen.
Undo (and refresh) Will undo the previous charting operation and refreshes the displayed chart.
Zoom In Zoom in current chart image. The zoom level will be reset upon either a chart refresh or a page reload.
Zoom Out Zoom out current chart image. The zoom level will be reset upon either a chart refresh or a page reload.
Navigate Enables the entire chart to be panned by dragging the background image canvas. The current panned position will be reset upon either a chart refresh or a page reload.
Original View Resets any zoomed level and panned position without refreshing the chart.
Status Box Turns the chart status box on or off. The chart status box is displayed in the upper left hand corner of the chart image.
Improve Layout Will attempt to improve the layout of the chart to a more aesthetically pleasing view. Best suited to small charts of approximately 100 nodes or less.
Settings Invokes the chart settings screen to allow those settings to be altered. Such settings are described below as; General Chart settings and Expansion/Search Filter Settings.
Help Displays this page.
About Displays the current Nodechart version information.

[Top]

Node Menu

Clicking on a chart node will reveal the Node Menu. This menu is for operations pertaining to that node and has the following options;

Menu Option Description
Expand (filter) Reveals neighboring network nodes to the selected node that also satisfy any Expansion/Search Filter Settings. Neighboring nodes are those connected to the selected node by a network link. The Expansion/Search Filter Settings may apply filtering conditions to the network nodes and/or the network links connecting those nodes. In the special case where there are no Expansion/Search Filter Settings defined, the "Expand (filter)" will have the same effect as "Expand ALL".
Expand ALL Reveals all neighboring network nodes to the selected node. Neighboring nodes are those connected to the selected node by a network link.
Remove (from chart) Removes the selected node from the chart. Does not delete the node from the underlying network.
Collapse Removes neighboring nodes from the chart provided they are not linked to any other chart nodes. Does not delete nodes, or links, from the underlying network.
Collapse ALL Removes neighboring nodes from the chart. Does not delete nodes, or links, from the underlying network.
Add Temp Link Enables a temporary link to another chart node to be added to the chart. Has no affect on the underlying network.

[Top]

Temp Link Menu

Clicking on a temp link handle, the (?) displayed below the link, will reveal the Temp Link Menu. This menu is for operations pertaining to that temporary link and has the following options;

Menu Option Description
Remove Removes the temporary link from the chart. In the current version, this is the only supported operation pertaining to temporary chart links.

[Top]

General Chart Settings

This section is found in the chart settings screen. General Chart Settings pertain to the overall characteristics of the chart and are described as follows;

Setting Description
CHART TITLE This is an arbitrary name that will be assigned to the chart. Simply used for the Chart name in the listing page and also as a the title of the Chart itself.
CHART SIZE Enables the chart image canvas size to be specified in pixel dimensions. The "Fit to current Window" option will resize the image to that of the current Browser window, whereas the "Use Default" option will return the image size to the Default page size. It may be necessary to adjust the image size as charts grow in size, or perhaps to suit different print page sizes and layouts.
BACKGROUND COLOR Specifies the background color of the chart image canvas from a select list. Charts initially have a background color of white.
BORDER COLOR Specifies the outline color of the chart image canvas from a select list. Charts initially have an outline color of black.
ALIGNMENT ON REFRESH Specifies how the chart objects themselves will be aligned to the image canvas whenever the chart is refreshed. "As-Is" will not perform any alignment. "Top Left" will align the left most chart object to the left of the image canvas and the uppermost chart object to the top of the image canvas. "Center" will align the center of the chart objects to the center of the image canvas.
ICON SIZE Specifies the size of chart node images (icons) if they are being used. The setting of "32x32 px" will size all icons as 32x32 pixels regardless of the actual image size. The "actual size" setting does not resize chart node images. This setting has no effect on nodes that are represented by the name label - that is, nodes that are not using images.
LINK LABEL ORIENTATION Specifies the orientation of the link labels. "Aligned" means that the name label/count will be aligned to the line representing the link, whereas horizontal will always display the name label/count horizontally.

[Top]

Expansion/Search Filter Settings

This section is found in the chart settings screen. Expansion/Search Filter Settings pertain to filtering criteria that may be applied to; 1) chart node expansion operations "Expand (filter)" and 2) the Add Node search screen "Search (filter)" functions. The various filtering criteria are described as follows;

Setting Description
NODE TYPES Only network nodes having the selected NODE TYPE(S) will be considered during an "Expand (filter)" or a "Search (filter)" operation. This option is only displayed if a NODE TYPE has been defined for the underlying network.
NODE COST Only network nodes having COSTS within the specified range will be considered during an "Expand (filter)" or a "Search (filter)" operation. This option is only displayed if a NODE COST has been defined for the underlying network.
LINK TYPES Only network links having the selected LINK TYPE(S) will be followed during an "Expand (filter)" operation. This option is only displayed if a LINK TYPE has been defined for the underlying network.
LINK COST Only network links having COSTS within the specified range will be considered during an "Expand (filter)" operation. This option is only displayed if a LINK COST has been defined for the underlying network.
LINK DIRECTION Only network links having the specified direction will be followed during an "Expand (filter)" operation. This option is only displayed for DIRECTED networks.

[Top]


© 2007 Nodechart
Oracle is a trademark of the Oracle Corporation