printableversion

Requirements: (Windows/Linux/OSX)

Java 1.6
Internet connection (for first use)

Table of Contents

1.      Getting Started
2.      Key Functions & Commands
3.      How-to Guide - FAQ
4.      Terms & Definitions
5.      Quick Reference Guide

1 - GETTING STARTED

1.      To begin, create a NewRadial file folder
2.      Download the latest executable .jar file from sourceforge to folder or update using svn.

Fig.1 – Sourceforge (http://sourceforge.net/projects/newradial/)

3. Run the program. Note: Upon first use, images will be downloaded. Depending on connection speed, download time may vary.
4. Once all images appear in the radial configuration, click anywhere on the screen to enable navigation.

2 - KEY FUNCTIONS AND COMMANDS

Navigation/Browsing Instructions (Mouse & Keyboard)

Mouse/Keyboard Key(s)	Function
Left -Click on a Node	Selects a node
Left-Click (hold) & Drag	Move single node to another area
Left-Click on single side-pane image	Enlarges image
Right-Click on a Node	Start/Complete a connection between Nodes
Left-Click & Drag	Make a box for grouping
Right-Click & Drag	Panning
Ctrl + Right-Click + Drag	Zoom (move mouse forward to zoom in, and backwards to zoom out)
Number Keys 1-4	Select default visualization categories
Reset View button	Adjusts the current visualization to fit & fill any remaining blank space

ZOOM FUNCTION

To enable the Zoom function, press and hold the “Ctrl” key while simultaneously employing the right-click mouse function. To zoom in, hold the “Ctrl” key and right-click, and move the mouse forward. To zoom out, also hold the “Ctrl” key and right-click, and move the mouse back towards you.

EXPLORING

Exploring existing edges:

1.      Click on edge (connecting line between two nodes)
Note: The thicker the line, the more associations have been made and saved by users
2.      The sidepane will show images of both nodes and list of titles associated with that edge.
3.      If there are a number of connections, use arrow buttons to navigate through titles.
Click on entry title to see comments and URL references from other users
4.      If you are the original contributor, you can edit or remove your connection/edge and its associated commentary by clicking on the appropriate buttons in the sidepane after viewing the commentary related to your contribution.
5.      Click “back” to return to the list of connections/edges.
6.      Click anywhere outside the sidepane to hide the sidepane.

Fig. 2 - Clicking on a Node (1) brings up a larger image in the Sidepane (2) and links to more                 information (3) at the Blake Archive website.

Exploring Existing Groups:

1.      Click on a node - Sidepane will show groups associated with that node
2.      Click on the group title in the sidepane to see other nodes associated with the group (these will be highlighted in the visualisation) and group commentary
3.      Click on any node in the list to explore that node in the sidepane

OR

1.      Click on the menu bar to the left of the “Group Selected” button - A list of groups will appear
2.      Select a group and the commentary and node list will appear in the sidepane. Associated nodes will also be highlighted in the visualisation.
3.      Click anywhere outside the sidepane to hide the sidepane.

Fig. 3 – By selecting the group from the bottom toolbar menu (1), more information is provided in             the Sidepane (2).
groups

VIEWING NODES

To view the nodes, there are five different options:

Number Key	Viewing Mode
1	Nodes organized by the British Museum Collection
2	Nodes organized into two categories: Songs of Innocence and Songs of Experience
3	Nodes organized according to publication year
4	Nodes arranged into complete collection
5	Alternative copy of Songs

Fig. 4 – Number key 1 - British Museum Collection

view2

Fig. 5 - Number key 2 - Songs of Innocence and Songs of Experience

view3

Fig. 6 - Number key 3 - Publication Date

view4

Fig. 7 - Number key 4 - Entire collection

view5

Fig. 8 - Number key 5 - Alternative copy of the Songs

Note: These views can also be manually selected from the bottom toolbar menu.
While using specific viewing modes, you will still be able to see groups. Clicking on a Node belonging to a group will show the entire group.

*Clicking the reset view button resizes the node map to fit the available screen space.

USING THE SEARCH FUNCTION

1.      Use the toolbar on the bottom right of the screen to input your query.
2.      The corresponding results will appear larger than the rest of the Nodes, with bolded edges. The other nodes will be reduced in size.

Fig. 9 - In typing the letter “A”, the interface has identified results in both groups. To exit the search         view, clear the search toolbar and press “reset view”.
searchfunction

CONTRIBUTING

Creating links (Edges) between nodes:

1.      Right click on first node
2.      Right click on associated node
Note: If this is your first contribution during the session, you will be asked to enter a username and given a password. Remember this password for future sessions. If you have already contributed connections and commentary using this username during previous sessions, you will be prompted for the password.
3.      Enter connection title
4.      Enter commentary
5.      Enter associated web URL (either http:// or www.)
6.      Click submit to submit entry to database
7.      Click cancel to cancel entry
8.      After making all contributions for a specific session, click “Save” button in bottom right hand corner of the interface to permanently save the linked edged and commentary to the database.

Fig. 10 – The connection between “The Chimney Sweep” and “The Fly” appears as a line (1)         connecting the two nodes. More information on the connection is available in the sidepane (2), as well as the total number of connections made between those particular nodes.

Note: A connection may only be edited or removed by its creator.

Creating Groups

1.      Move/drag the nodes that you want to group together to a space in the visualisation field.
2.      Left-click + drag to draw a box around the group of nodes
3.      Click “Group Selected” button at the bottom of the interface
4.      Enter group name in sidepane
5.      Enter comments in sidepane
6.      Click submit to submit entry to database
7.      Click cancel to cancel entry
8.      After making all contributions for a specific session, click “Save” button in bottom right hand corner of the interface to permanently save the linked edged and commentary to the database.
Note: Once a group has been saved, it can be accessed through the bottom toolbar through the drop-down menu beside the “Group Selected” button.

Fig. 11 – After selecting the desired Nodes (1), click “Group Selected” (2) and add a name and comments (3) in the sidepane. Click Save to keep your work on file.
Naming Groups 2 - Copy.jpg

DATA SETS

NewRadial is a customisable and open source tool, capable of working with different data sets. The desired data set may be selected either at start-up, or by loading new sets via the Menu bar (select “File,” then “Open”) while the program is running.

Fig. 12 - The radial arrangement uses data from Blake's Songs of Innocence
and Experience.
main

SAVING AND ENDING A SESSION

There are 3 different ways to save your work:

1)      Click on the “X” at the top right-hand corner of the screen. You will be prompted to save before the program exits.
2)      Use the toolbar at the bottom right-hand corner and click “Save”.
3)      Use the Menu bar at the top left-hand corner, and select “Save”.

3 - HOW-TO GUIDE: FAQ

Q: How do I save my work?
A: You have three options:
    1) Click on the "X" at the top right-hand corner of the screen. You will be prompted to save.
    2) Use the toolbar on the bottom right-hand corner of the screen, and select "save".
    3) Click "File" in the upper left-hand corner of the screen, and select "save".

Q: How do I get the latest version of Newradial?
A: Check Sourceforge for updates, and download the latest version.

Q: How do I get help while using the program?
A: Click "Help" in the upper left-hand corner of the screen, and select "How To Use...". This brings you directly to the Newradial User Guide.

Q: What happens when a node is in more than one group?
A: When the node is selected, all groups it is part of will appear in the sidepane. You can select a particular group to explore from that list.

Q: What is the Blake Archive?
A: A freely accessible digital collection of reproductions of William Blake's works. The Blake Archive is unique in its hypermedia environment, uniting pictures and literature in an interactive format. For more information, visit the Blake Archive online.

Q: What is the difference between browsing and contributing?
A: Browsing does not involve any contributions to the interface, whereas contributing means that the user has made a connection or created a group etc. Any contributions will have a save option.

Q: Do I create my own password when saving?
A: No, you will be provided with a password once you have saved your work or contributed (by making a connection or group). Remember your username and password for future logins.

4 - TERMS & DEFINITIONS

Term	Definition
Node	Pages of Blake’s Songs of Innocence and Experience, containing images and text
Side Pane	Box on the right-hand side of screen. Clicking on a Node brings a magnified view here, with a link to Copy Information.
Edge	Lines surrounding each Node
Browse	Explore NewRadial without adding information or making connections
Contribute	Add information to the NewRadial interface through saved connections and comments
Connection	Link between two or more Nodes, created by the User
Copy Information	Link to the Blake Archive website
Data Set	Determines the Data to be used within the interface

5 - QUICK REFERENCE GUIDE

quickstart

MAIN TOOLBAR: "File" prompts either a "Save" option or "Open" (a data set) option. "Help" prompts a "How to Use" option (link to user guide) and an "About" option (creator information).
RADIAL CONFIGURATION WITH NODES (individual copies of Blake's songs).
RESET VIEW: enables user to re-center radial configuration to fit the window.
SIDEPANE: magnified view of selected node. "Number of Connections" shows total number of connections made by users. "Copy Information" links to the Blake Archive website for detailed information. Also lists groups that include Node.
WINDOW OPTIONS: Minimize, Restore down, Close. Selecting "X" (close) prompts the "Save" option.
SAVE OPTION.
SEARCH FUNCTION: Type in search characters, and select designated search field by using adjacent drop-down menu.
GROUP LIST: Saved groups appear in this drop-down menu. To view a group, select from list and click "Group Selected".
VISUALISATION CATEGORIES: 5 different viewing options available by selection through the drop-down menu. Default visualisation set to "All". Shortcut with number keys 1-5.

Commands Summary

Mouse/Keyboard Key(s)	Function
Left -Click on a Node	Selects a node
Left-Click (hold) & Drag	Move single node to another area
Left-Click on single side-pane image	Enlarges image
Right-Click on a Node	Start/Complete a connection between Nodes
Left-Click & Drag	Make a box for grouping
Right-Click & Drag	Panning
Ctrl + Right-Click + Drag	Zoom (move mouse forward to zoom in, and backwards to zoom out)
Number Keys 1-4	Select default visualization categories
Reset View button	Adjusts the current visualization to fit & fill any remaining blank space

Back to Table of Contents

Documentation and Help Files Created by Alix Shield