Weave Beta 1.0 Release User Guide

2011

Table of ContentsIntroduction.............................................................................................................................4Weave Menu Bar.....................................................................................................................5

Data............................................................................................................................................7Refresh Data Source Hierarchies.............................................................................................7Import New Dataset................................................................................................................7

Session........................................................................................................................................9Import Session State...............................................................................................................9Export Session State................................................................................................................9

Export.......................................................................................................................................12Save or Print Application Screenshot....................................................................................12

Tools..........................................................................................................................................14Color Controller....................................................................................................................15Equation Editor.....................................................................................................................15Attribute Selector..................................................................................................................32Probe Tool Editor...................................................................................................................34Data Table.............................................................................................................................37Color Legend.........................................................................................................................43Color Histogram....................................................................................................................45Map.......................................................................................................................................47Bar Chart...............................................................................................................................50Scatterplot............................................................................................................................63Histogram..............................................................................................................................69Line Chart..............................................................................................................................73Gauge....................................................................................................................................76Thermometer........................................................................................................................78Pie Chart...............................................................................................................................81Pie Chart Histogram..............................................................................................................84Time Slider............................................................................................................................88Dimension Slider...................................................................................................................93R Script Editor (See attached ppt)...........................................................................................?New User Wizard (being done by Sebastien)..........................................................................?

Selections.....................................................................................................................................97

2 | P a g e

Subsets.........................................................................................................................................99Session........................................................................................................................................101

Import Session State...........................................................................................................102Export Session State............................................................................................................102

User Interface Preferences ........................................................................................................104Appearance.........................................................................................................................104Menus.................................................................................................................................105Interactivity.........................................................................................................................106Probing................................................................................................................................106Selection.............................................................................................................................107

Window......................................................................................................................................107Weave Features and Other Tools...............................................................................................108

Attribute Selector................................................................................................................108Minimizing and restoring windows.....................................................................................111Visualization Tray ...............................................................................................................111Working with Data Subsets.................................................................................................112Right-click functions............................................................................................................113Moving, Resizing, Minimizing, and Closing Visualization Windows ....................................113

Creating a Point Shapefile .........................................................................................................116

3 | P a g e

Introduction

Weave represents a new generation of software tools for the analysis and visualization of

data. This new software system has been designed to enable any user to visualize any

available data anywhere. By selecting from the wide variety of Weave visualizations,

users can customize a webpage to present data in the way that best suits the intended

audience. Weave was specifically designed to handle large quantities of data from

different sources and can geographically map that data using any shape files. Where

shape files are available, any boundary may be used, whether political, census tract,

environmental, economic, neighborhood, lot or nation. Any boundary shape can be added

to the system to allow customization of data analysis and display. Being web-based,

Weave uses a browser to access the user interface. In addition to providing immediate

familiarity to the user, this makes the resulting visualizations available to an array of

users from novice to expert, including those who are working collaboratively but may not

be centrally located. In summary, this product is designed to:

Provide meaningful visualizations of measures and indicators with an open-

source (for non-profit and public agencies), web-based system

Support multiple types of users (from novice to expert, analyst to developer)

Provide high degrees of interactivity, performance, usability and security

4 | P a g e

2. Weave Menu Bar

The menu bar at the top of the Weave instance window looks like this:

Under "Data" the options available are: Refresh All Data Source Hierarchies Refresh Import New Dataset Import Add New Data Source Add New Data Source Edit Data Sources

Under "Export" the options available are: Save or Print Application Screenshot Export

Under "Tools" Weave Tools the options available are: Show Color Controller Color Controller Show Equation Editor Show Attribute selector Show Probe Tool Editor Add Data Table Add Color Legend Add Color Histogram Add Map Add Time Slider Add Bar Chart Add Line Chart Add Scatterplot Add Gauge Add Thermometer Add Pie chart Add Pie Chart Histogram Add Histogram Add Dimension slider Dimension Slider Add R script editor R Script Editor New user wizard

Under "Selections", the options available are: Save Current Selection Clear Current Selection Manage Saved Selections

Under "Subsets", the available options are: Create Subset from Selected Records Remove Selected Records from Subset Show All Records Save Current Subset Manage Saved Subsets

Under "Window", the available selections are (in addition to a list titles of windows included in the session):

5 | P a g e

Minimize This Window Minimize All Windows Maximize This Window Close This Window Go Fullscreen

Under "About" there is a link to openindicators.org and the designation of the Weave Version.

6 | P a g e

Data

Refresh all Data Source Hierarchies

This feature allows the user to refresh data referenced in Weave if, for instance, new datasets are added.

Import New Dataset

Things to Know Before Importing Data

The file to be uploaded must be saved as a comma-separated (CSV) or as a single-spreadsheet Microsoft Excel (XLS) file.

Each column must have a name.The first row of each column is treated as that column's name.A unique key, such as a FIPS code for US states, counties, etc., which matches the

key field of the geographic dataset being used, must be chosen in order for the divisions to show up on the map visualization.

How to Import a Dataset

To import a Dataset, click "Data" in the menu bar at the top left of the screen, and select "Import new dataset…", from the drop down menu.

A window will open outside of the Weave application from which a file containing the dataset can be selected. Once the dataset has been selected, a new window will open within the Weave application.

7 | P a g e

A unique record identifier and key type can be selected using the drop down menus at the top of the window.

The data can be saved to the Weave application by clicking the 'Load Data into Weave' icon. The data can now be accessed from the attribute selector.

8 | P a g e

Session

Import Session State

Importing a session state makes it possible to take a session state that has been previously saved and reload it into a particular Weave instance.

To import a session state, click 'Session' in the menu bar at the top of the screen and select 'Import session state…' from the drop down menu.

A window will open from which previously-saved session states can be selected. Once the session state has been selected, the Weave application's appearance will return to that of the previously-saved session state.

9 | P a g e

Export Session State

Exporting the session state makes it possible to save the session state so that it can be opened later.

To export a session state, click 'Session' in the menu bar at the top of the screen and select 'Export session state…' from the drop down menu.

The export session state window will open.

The two boxes in the window make it possible to change how the exported session state looks. If the 'Show Menubar' box is selected, the saved session state will have a visible menu bar, if not the menu bar will be removed. Selecting the 'Enable dashboard mode'

10 | P a g e

box saves the session state in dashboard mode meaning all tools borders will not be visible and they will not be able to be dragged or closed.

Clicking the 'Export' icon saves the session state to the client machine.

11 | P a g e

Export

Save or Print Application Screen Shot

The save or print application screen shot option makes it possible to take a screen shot of a particular application instance and save it or print it.

To take the screen shot, click 'Export' in the menu bar at the top of the screen and select 'Save or Print Application Screen Shot…' from the drop down menu.

A window showing the screen capture will open.

12 | P a g e

Clicking the 'Print' icon will open a window from which the screen shot can be printed.

Clicking 'Save as Image' will open a window from which the screen shot can be saved to the client's machine. To specify the image format, simply type the extension when saving the image (e.g. “screenshot1.jpeg/png/jpg”).

13 | P a g e

ToolsColor ControllerEquation EditorAttribute SelectorProbe Tool EditorData TableColor LegendColor HistogramMapBar ChartLine ChartScatterplotGaugeThermometerPie ChartPie Chart HistogramHistogramTime SliderDimension SliderR Script EditorNew User Wizard

14 | P a g e

Color Controller

The color controller is used to edit the colors of all the visualization tools open at any given time.

Click ‘Tools,’ in the menu bar at the top left of the screen and select ‘Show Color Controller’ from the drop down menu to open the color controller.

The user can choose from a variety of color schemes, including “linear gray” for the color blind.

Equation Editor

The equation editor is used to create custom data attribute columns. The columns are created using a variety of math equations, constants, and existing data. The equation editor gives the user the ability to choose a name for the newly created column and retrieve it later for use in any of the visualizations available in Weave.

To access the equation editor:Click “Tools”, located in the menu bar at the top of Weave, and select “Show Equation Editor” from the resulting drop-down menu.

Resulting equation editor interface:

15 | P a g e

Using the Equation Editor:

The first step to creating your own custom attribute column is selecting all of the original existing data attributes (variables) that you expect to use in to create it. To do so, click the “Open Selector...” button in the upper right hand corner of the Equation Editor Interface.

Resulting Interface:

16 | P a g e

Find the data tables in which your desired attribute columns (variables) reside using either the “Search categories” feature or by expanding the menu on the left and selecting the appropriate data table. Clicking any folder will cause it to expand or collapse, displaying or hiding its contents respectively . Clicking data table name will display its attributes columns on the right.

Below: by typing “obesit” into the “Search Categories” box, all data tables with the sub string “obesit” (case insensitive) in the “Data Tables” file are shown.

17 | P a g e

*Note: For the tables to be displayed whose titles contain the specified substring, the user must select the directory in which her or his data tables reside (see image below). “Data” is selected in the list (highlighted in blue) rather than “Data Tables”.

Once you have located the desired table and clicked to display its variables, the next step is to add the desired variables (attribute columns) to the equation editor.

To add a variable:Click on the desired variable in the list of attribute columns on the right hand side of the Attribute Selector for Variables” screen, then click “add selected attribute”. The attribute will appear in the “Variables” box in the lower half of the Attribute Selector for Variables.

18 | P a g e

Alternatively, the attribute column can be dragged directly from the list of attribute columns into the Variables list.

Removing a Variable:

19 | P a g e

To remove a variable that was erroneously added or is no longer needed from the variable list, locate the variable you wish to remove in the list on the bottom half of the window (Variables list), and click it. Once a variable is selected (highlighted in blue), the “Remove Attribute(s)” button will become active. Clicking “Remove Attribute(s)” will remove all selected variables from the Variables list. The system supports shift+clicking to select a continuous range of variables in the list, or ctrl+clicking to select several variables at once that are not consecutively listed.

Below: Several variables are removed from the list by holding down ctrl and selecting the ones that should be deleted, and then clicking “Remove Attribute(s)”; the result is shown.

result:

Exiting the Attribute Selector for Variables:

20 | P a g e

Cancel: Exits the Attribute Selector for Variables (closes this window) *without* saving first . The variables list will be returned to the last saved state. All changes made (adds and deletes of variables) since the last save action will be lost.

Save & Close: Exits the Attribute Selector for Variables (closes the window) and saves changes to the variables list (reordering, adds, and deletes of variables)

Undoing/saving

Revert: Returns the variables list the the last saved state without closing the Attribute Selector for Variables window. All changes (reordering, adds or deletes of variables) made after the last save will be lost.

Save: Saves the current state of the variables list - including order, adds, and deletes. This will not close the Attribute Selector for Variables window.

After saving and closing, your selected variables will appear in the variables list, demonstrated below.

Creating an Equation Column

21 | P a g e

The following instructions will walk through creating a column called OB_MAX that contains the maximum of two values, one taken from “Percent Obese (BMI >=

30) (1995)...” and the other taken from “Percent Obese (BMI >= 30) (1996)...”

The equation editor is an advanced feature and in order to successfully use the functions, the user is expected to understand the math and the concept of order of operations. Functions and variables from the “Available Functions” list in the middle of the UI can be added both by double clicking or by dragging and dropping, but note that double clicking applies the function to the outermost level of the equation. We will start by adding the “max(Number, Number)” function to the equation editor. This function can be found in the “Available functions” list under the ”Math” tab.

Below: double clicking “max(Number, Number)” function adds it to the equation workspace on the left , creating two blank place holders for variables. Alternatively the user can drag the “max(Number, Number)” function into the equation; dropping it in different places will apply the function to different parts of the equation (this feature will be used/shown later in this tutorial). *Note: The variables in the function will read “undefined” until the user has changed them to read a variable or a constant.

Using drag and drop, the Variables can be added to the equation from the list of variables on the right .

Below: Dragging “Percent Obese (BMI >= 30) (1995)...”and “Percent Obese (BMI >= 30) (1996)...” into the desired spots in the equation. *Note that when the variable is dragged into the equation, the part of the equation it is

22 | P a g e

being dragged over is outlined in red - dropping the variable will cause the variable to bind with that placeholder in the equation. *Note that the variables appear in the equation as ReferencedColumnX where X is some integer. This name corresponds to the order that your variables appear within the variables list, so “ReferencedColumn” refers to the first variable in the list (in this case “Percent Obese (BMI >= 30) (1995)...”), “ReferencedColumn2” refers to the second variable in the list (“Percent Obese (BMI >= 30) (1996)...”, and so on.

In addition to variables from your variable list, the user can enter any constant into the equation or can use one of the constants from “Available functions” -> “Constants” by: Dragging and dropping(shown below)

23 | P a g e

Clicking on the text of the equation and editing it by hand(shown Below, typed 1234567)

Or by typing the variable into the appropriate box in the equations visual representation.(Shown Below, typed 2468 and hit “enter”)

24 | P a g e

Removing parts of an equation can be done one of two ways by:

1. Editing the text of the equation deleting text in the equation will delete the associated parts in the visual representation of the equation.

2. Using the “x” icon associated with the function or variable that you wish to remove (see below)

Using getNumber25 | P a g e

At this point we have added the max function to the equation editor and have added the two columns as the variables in that function. If we were to use the data table tool to view the column as it currently exists, we would see that we’re getting Nan for all of our values, instead of the max of two values, one from each column. This is because the equation editor is reading in the values from each column as a string. To get the equation editor to treat those values like numbers, the getNumber(Object, IQualifiedKey) function, which is found in EquationColumnLibLib in the Available functions list, needs to be applied to each variable. To do this, drag the function onto the variable that you wish to convert.

Below: The results before and after applying getNumber to each variable in the equation

Below: applying getNumber to each variable in the equation

26 | P a g e

Naming Your New Column

By default, any column created in the equation editor will be named “Equation Column”. Ideally the user will pick a descriptive, unique name that will make the column easy to identify and use later. To change the name of the column, type the desired name into the box in the upper left of the equation editor.

Below: renaming a column, with change reflected in data table tool.

27 | P a g e

Finding Your New Column

Once you have created and named a new column, it can be found in the “Equations” category in the attribute selector of any of the Weave tools. Equation columns can be used like any other column.

Below: OB_MAX (which we just created) is found in equations.

28 | P a g e

Functions In The Equation Editor:

Mathabs(Number)acos(Number)asin(Number)atan(Number)atan2(Number)cell(Number)cos(Number)exp(Number)floor(Number)log(Number)max(Number,Number)min(Number,Number)pow(Number,Number)random()round(Number)sin(Number)sqrt(Number)tan(Number)

MathLibadd(Number,Number)constrain(Number,Number,Number)div(Number,Number)filterRange(Number,Number,Number)getNiceNumbers(Number,Number,int)inRange(Number,Number,Number)interpolateColor(Number,int,int)mod(Number,Number)mul(Number,Number)neg(Number)

29 | P a g e

normalize(Number,Number,Number)roundSignificant(Number,uint)scale(Number,Number,Number,Number,Number)sign(Number)sub(Number,Number)toNumber(*)

StringUtil

isWhitespace(String)substitute(String)trim(String)trimArrayElements(String,String)

trStringLib

concat(String)formatNumber(Number, Object)lower(String)lpad(String,uint,String)replace(String,String,String)rpad(String,uint,String)stringSearch(String,*)strlen(String)substr(String, Number, Number)toBase(Number,int,int)toString(*)upper(String)

BooleanLibequals(*,*)greaterThan(*,*)greaterThanEqualTo(*,*)iif(*,*,*)isDefined(*,*)isUndefined(*)lessThan(*,*)lessThanEqualTo(*,*)

30 | P a g e

not(*)toBoolean(*)

ArrayLibarrayLength(Array)getItem(Array,int)getItemIndex(Array,*,*)join(Array,*)split(String,String,int)

StatisticsCachegetCount(IAttributeColumn)getMax(IAttributeColumn)getMean(IAttributeColumn)getMin(IAttributeColumn)getRunningTotals(IAttributeColumn)getStandardDeviation(IAttributeColumn)getSum(IAttributeColumn)getVariance(IAttributeColumn)

CSVParserconvertRecordsToRows(Array,Array,Boolean)convertRowsToRecords(Array)createCSVfromArrays(Array)createCSVToken(String)getRecordFieldNames(Array,Boolean)parseCSV(String,Boolean,Array)parseCSVToken(String)

QKeyManagerGetAllKeyTypes()getAllQKeys(String)getQKey(String,String)getQKeys(String,Array)

G

EquationColumnLib

31 | P a g e

applyColorRamp(ColorRamp,*)applyMethod(Object, String)cast(*,*)getBoolean(Object,IQualifiedKey)getInternalObject(ILinkableDynamicObject)getNormal(Object,IQualifiedKey)getProperty(Object,String)getReferencedColumn(IColumnReference)getRunningTotal(IAttributeColumn,IQualifiedKey)getString(Object,IQualifiedKey)getValue(Object,*)getValueFromKey(IAttributeColumn,IQualifiedKey,*)

ConstantsELN10LN2LOG10ELOG2EPISQRT1_2SQRT2

Attribute Selector

The attribute selection box allows the user to assign a particular indicator to a display dimension (parameter): x-axis, y-axis, color, point size, bar-height, etc. The attribute selector box is accessed under the “Tools” tab in the menu bar, by clicking on any indicator label that is displayed on the x or y axis, by clicking on the legend, or by

clicking on the folder icon when editing any tool ( ).

32 | P a g e

Selecting Data

To select the category of the data reflected in the visualization, use the folders on the left side of the attribute selector window.

Different categories of data can also be found by using the search categories box located above the displayed category list.

Once the data table has been selected from the list on the left, select the specific data to

33 | P a g e

be indicated from the list on the right side of the window.

Data can also be found using the search menu located above the different indicator options.

Probe Tool Editor

The probe tool editor is used to select different attributes to be made visible when a cursor is passed over a data indicator.

Example of a probed indicator

To open the probe tool editor window click ‘Tools,’ in the menu bar at the top left of the screen and select ‘Show Probe ToolTip Editor’ from the drop down menu.

34 | P a g e

This will open the Probe ToolTip Editor.

The first tab (Header Columns) in the window is used to select data that will be at the top of the probed data, this usually will be a title or some category appropriate for the other data, for example a state name. The second tab (Probed Columns) is used to select the rest of the data that will be visible during a probe. To select data for either tab, click the icon that reads 'Open Selector…' this will open the attribute selector.

Clicking the 'Remove Attribute(s) will make the selected attribute(s) no longer visible

35 | P a g e

while probing.

36 | P a g e

Data Table

The data table provides a tabular view of the data that is currently being shown in the visualization windows.

To open the data table window click ‘Tools,’ in the menu bar at the top of the screen and select ‘Add Data Table’ from the drop down menu.

The order in which the data is shown can be adjusted by clicking any of the boxes that label each column. The column title will then have an arrow next to it, if the arrow points up the data is sorted in a ascending fashion either numerically with the lowest numerical value at the top and the highest at the bottom or alphabetically from a to z. This can be reversed by clicking the column's title again causing the arrow to point down. All other

37 | P a g e

columns will adjust to the chosen column's order.

Numerical data sorted with arrow pointed up.

Alphabetical data with arrow pointed down.

Tool Icon for the Data Table

Open the tool menu by clicking the tool icon in the upper left corner of the visualization window.

This will open the 'Attributes for Data Table' tab, where the data visible in the data table can be selected.

38 | P a g e

Clicking the 'Open Selector…' icon opens the attribute selector where the data shown on the data table can be selected. Different attributes can be removed by selecting them and clicking the 'Remove Attribute(s)' icon.

The user has the option to add buttons to the table that allow data export, adding/removing columns, and moving rows within the table.

The buttons will be added to the frame of the data table:

39 | P a g e

Clicking the 'Export Data…' icon opens a window where the data table can be saved to the user's computer as a file.

Clicking the 'Move Selected Items to top' icon moves a selected row of data to the top of the table, making it possible to sort the data to the user's preference rather than by the values of a particular column.

Adding image-columns:

To add an image-column such as those used in scorecards, the user will need to specifies the name of the file in the original dataset (prior to import). For example, the image referenced in the following screenshot is “up.png” on our server. To view an image

column, the user clicks on the tool icon to edit the data table, then clicks on “Add

40 | P a g e

Image Column” to specify the column in the dataset that contains the images:

This will open the “Selector” so the column can be specified.

Window Settings

'Window Settings' is a common tab within the tool icon. To open it click the tool icon in the upper-left of any visualization tool and click the tab labeled 'Window Settings.' For some visualization tools this will be the only option after clicking the tool icon.

41 | P a g e

Use the bar at the top of the tab labeled 'Window Title' to enter a new title for the visualization window. The new title will appear instantly as it is typed into the bar.

The list below the window title bar presents several options for the appearance and options for controlling the visualization window.

42 | P a g e

'Show Borders' controls the presence of borders around the visualization window. 'Allow Resizing' controls whether the visualization window can be re-sized. 'Allow Closing' controls the 'X' in the upper right corner of the visualization window that closes the window. 'Allow Minimization' controls the presence of the horizontal line in the upper right of the visualization window that sends the window to the visualization tray. 'Allow Maximization' controls the presence of the box in the upper right of the visualization window that maximizes the window to take up the whole application. 'Allow Dragging' controls the option to move the visualization window manually around the application by clicking the upper boarder. The 'Border Color' icon presents multiple options for the color of the border at the top of the visualization. The 'Visualization Background Color' presents multiple options for the background color of the visualization.

43 | P a g e

Color Legend

The color legend depicts the colors that correspond to certain indicator values. These are the colors that will be used in the other visualization tools.

Click ‘Tools,’ in the menu bar at the top of the screen and select ‘Add Color Legend’ from the drop down menu to open the color legend window.

Click the title of the legend to open the attribute selector to choose different files for display.

44 | P a g e

Hovering over any of the color range labels will show the particular indicators that fall within that range.

Tool Icon for the Color Legend

Open the tool menu by clicking the tool icon in the upper left corner of the visualization window.

This will open the following window:

45 | P a g e

In this window, the user can choose a color scale to represent data values and reverse the color scale to determine how progression in the data (low to high) is represented within the chosen color scale. Additionally, the user can determine the size of the bubbles on the legend.

Color Histogram

The Color Histogram is a tool for showing the frequency with which a certain value occurs within a dataset.

Click ‘Tools,’ in the menu bar at the top left of the screen and select ‘Add Color

46 | P a g e

Histogram’ from the drop down menu to open the Color Histogram window.

The data reflected in the histogram is edited by clicking on the graph's x-axis label, located below the histogram. This will open the attribute selector where data for the tool is selected.

Hovering over any bin will pop up a text box showing the data that falls within that range.

Tool Icon for the Color Histogram

Clicking the tool in the upper left corner of the screen opens the visualization controls and window settings window for the Color Histogram.

47 | P a g e

TheVisualization Controls tab allows the user to select the number of ranges or bins into which the data will be separated. The data to be displayed is listed at the top of the box next to “bin data”. To change the displayed data, remove the data listed by selecting the trash can icon. Then select a new data attribute by selecting the folder icon. This will open the attribute selector box.

The manner in which the attribute is separated into ranges, or binned, can be selected by choosing one of the 5 possible binning types on the left of the box. If “simple binning” is selected, the number of bins can be adjusted with the up and down arrows to the right. If a “custom split” is selected, the minimum and maximum values and each break point between are entered directly in the boxes to the right. Ranges can also be set using quantiles, equal intervals or standard deviations. When the desired binning ranges have been entered, the Apply button is used to update the display.

Window Settings:

Refer to “Window Settings” above.

Map

A map visualization is a geographic representation of the fundamental indicator data that is being analyzed. The types of geographic information that the map can reflect include any geographic area for which shape files are available, including census tract, neighborhood, county, state or country data. By using the map visualization Weave users

48 | P a g e

can see the data at flexible levels of granularity and use simple, but powerful tools to further view and explore the data.

Click ‘Tools,’ in the menu bar at the top of the screen and select ‘Add Map’ from the drop down menu in order to open the map window.

The data reflected on the map is edited by clicking on the tool icon in the upper left of the visualization window.

This opens the 'Attributes for Map' tab. This tab is used to select files for visualization.49 | P a g e

Click the 'Add Geometry Layer' button to add the first level of visualization. The particular data indicator that will be visualized is selected by clicking the 'Undefined' icon.

This will open the attribute selector, where particular data indicators and geometry collections are selected.

50 | P a g e

Multiple layers can be added by clicking the 'Add Geometry Layer'

'Add WMS Layer': This button adds a satellite image layer of the world provided by NASA. The user can reference a different source for different imagery if desired.

'Add Label Layer': the user can add a layer that labels the geography components on the map. The labels are drawn from a column specified by the user. To specify the label

column, click on 'settings':

In the settings window, the user can specify the size and color of the labels, the source

column, and the source geometry collection. Clicking on the folder icon will open the attribute selector.

51 | P a g e

In this example, we are selecting the column “State” from our dataset, and the geometry collection “States”:

Checking the box labeled 'Visible' makes the indicated data visible on the map visualization. Checking the box labeled 'Selectable' allows that geographic layer to be probed. Only one indicator can be the probe indicator at one time.

Clicking the X icon removes the data from the visualization.

52 | P a g e

Settings

Clicking the 'Settings' icon opens a panel that enables the altering of the appearance of the visualized data. . The user can adjust the thickness, opacity and color of the boundary lines and can change the background (fill) color.

When dealing with point-layers, the utility of the “default color” box for example is clear as in the following screenshot, showing Massachusetts towns colored by the number of females, with the points representing the locations of public libraries:

Interacting with the Map Visualization

53 | P a g e

There are three methods for interacting with the map data: selecting, panning and zooming. This is an image of the tool bar, located in the lower right hand corner of the screen used for these functions:

Selecting

Selecting allows users to choose specific regions of the map to analyze. Clicking the icon in the lower-right side of the map tool initiates select mode.

One map division (city, county, state, etc.) is selected by clicking on it.

There are two methods for selecting more than one division on the map. Adjacent map divisions are selected by clicking on the first division and dragging the mouse. This creates a rectangular box which contacts some portion of each map division.

54 | P a g e

The second method of allows users to select map divisions that do not border each other. To do this, hold down the control key while clicking on each map division.

The two methods can be used in conjunction by selecting bordering data via dragging and then selecting non-bordering data through the control-click method described above.

Panning

Panning allows users to change what is shown in the visualization window. Panning is enabled by selecting this icon in the lower right hand corner of the window.

Once panning mode is enabled, what is shown in the window is moved by clicking on any part of the map (a small white hand will appear) and moving the mouse in the opposite direction of the portion of the map the user wants to see. For example if the users would like to see something north of what is currently visible the user should move their mouse down.

This can also be accomplished when panning is not enabled by clicking on this icon:

This makes it possible to move the map in any direction simply by clicking any of the icons (N-North, S-South, E- East, W-West).

Zooming

Zooming allows users to see a larger or smaller area of the map than is presently visible. It is automatically enabled. When using the plus (+) and minus (-) signs users click either sign until the desired amount of the map is visible. Clicking plus decreases the visible area on the map and clicking minus increases the visible area on the map. Pressing the plus and minus signs moves between different levels of visibility. The arrow can be dragged up or down the line to view intermediate levels of visibility.

55 | P a g e

Tool Icon

Open the tool menu by clicking the tool icon in the upper left corner of the visualization window.

Attributes for Map

The main function of this tab is to choose data for the different levels of the map visualization. This is described above.

The 'Zoom to full extent' icon allows users to set the visualization window to show everything included within it. The coordinates next to the icon indicate where the map is centered. This can be altered using the panning function.

The box labeled “color” enables selecting a data indicator by which the map is colored.

Clicking the folder icon opens the attribute selector so this data can be selected.

Clicking the trash icon removes any data from the box.

56 | P a g e

Window Settings:

Refer to “Window Settings” above.

Bar Chart

The bar chart shows data for a set of indicators. The height of each bar is determined by the value of the indicator. The data indicated by the bars can be sorted by another indicator, meaning that the individual bars will ascend or descend from left to right relative to the value of the chosen indicator.

Click ‘Tools,’ in the menu bar at the top left of the screen and select ‘Add Bar Chart’ from the drop down menu in order to open the bar chart window.

57 | P a g e

Clicking on either the X or Y axis will open up the attribute selector where the data can be selected.

Tool Icon for the Barchart:

Open the tool menu by clicking the tool icon in the upper left corner of the visualization window.

Attributes

The box next to the 'Color Column' label is used to select a data indicator that sets the color order for the bars. The box next to 'Label Column' is used to select an indicator to label each bar. The 'Bars Sorted By' box is used to select an indicator by which bars of the chart will be sorted. Attributes are selected by clicking the folder icon to the right, which opens the attribute selector. A file can be removed by clicking the trash can icon.

58 | P a g e

The lower box shows all attributes which are visualized in the bar chart. New attributes can be opened by clicking the 'Open Selector…' icon, which opens the attribute selector. Items can be removed by selecting any indicator and clicking the 'Remove Attribute(s)' icon at the bottom. If the user selects more than one “height attribute”, the bar-chart will stack the different attributes, assigning a color to each attribute (“stack”) independent from the color scheme of the map:

59 | P a g e

The legend explaining the color segments of the stacked barchart can be added in the tab explained in what follows (Bar Properties)

Bar Properties

The legend icon at the top of this tab adds a legend to the bar chart showing what the different colors indicate.

Clicking the box labeled 'Horizontal Bars' changes the bars in the visualization from being oriented vertically to being oriented horizontally.

The following are examples of, respectively, a grouped barchart, a horizontal stacked barchart, and a normal horizontal barchart:

60 | P a g e

61 | P a g e

Sliding the arrow labeled 'Bar Spacing' from left to right increases the amount of space between each bar. The fractions indicate the size of the space relative to the size of the bars. Therefore, 1:4 indicates that the spaces are 1/4 the size of the bar and 1:1 indicates that the size of the spaces are equal to the size of the bars.

The following is an example of a barchart with a1:4 bar spacing:

62 | P a g e

The user has the option of showing all the labels on the bars (see below), or a few labels as the example above shows.

Here we can see all the labels on the bars:

63 | P a g e

Advanced:The color scale box, found under the “Advanced” tab, presents multiple options for the range of colors that will be used for the bar chart.

Checking the reverse color scale icon reverses the direction of that the color scale changes colors (for example switching from blue to red to red to blue.

Window Settings:

Refer to “Window Settings” above.

64 | P a g e

Scatterplot

A scatterplot is a useful tool for showing the relationship between two sets of indicator data.

Click ‘Tools,’ in the menu bar at the top of the screen and select ‘Add Scatterplot’ from the drop down menu to open the scatterplot window.

65 | P a g e

Clicking on the label of either the X (bottom of window) or Y axis (left side of window) opens the attribute selector where the data reflected on the scatterplot it selected.

Tool Icon

66 | P a g e

Clicking the tool in the upper left corner of the screen opens the visualization controls and window settings window.

Visualization Controls

Selecting visualization controls from the menu bar allows users to select different visual cues to further reflect indicated data.

Point Opacity

The point opacity slider allows users to adjust the transparency and opacity of the scatter plot points.

The slider tool can then be moved by clicking and holding the arrow located on the line next to ‘Point opacity’.

67 | P a g e

Sliding the arrow to the right increases the opacity and decreases the transparency of the points, while sliding the arrow to the left decreases the opacity and increases the transparency of the points.

Size By

The size by slider makes it possible to indicate a third set of data (in addition to the data on the x and y axis) using the relative sizes of the points on the scatterplot.

This option is turned on by checking the box labeled ‘Size by’, located above the size by slider.

The data by which the points will be sized is selected by clicking the folder to the left on the box labeled ‘size.’ The data is selected using the attribute selector.

To get a legend for the size of the points, click on the button “Legend” on the top-left corner of the panel:

68 | P a g e

The point size slider has two arrows that can be set to several different locations on the line. The arrow to the right sets the maximum point size and the arrow to the left sets the minimum.

Advanced

This tab allows the user to ass a regression line1 to the scatterplot tool, showing the relationship between the variables on the X and Y axes – the size variable is not included in the equation.

1 See http://en.wikipedia.org/wiki/Linear_regression 69 | P a g e

To enable the regression line, check the box “Enable regression line” under the “Advanced” tab.

The line is automatically drawn and redrawn when variables on the axes are changed (unless the user checks off the box). The user can also control the color of the regression line, its opacity and thickness.

70 | P a g e

Window Settings:

Refer to “Window Settings” above.Histogram

The histogram visualization window makes it possible to view how many individual data records conform to a certain set of parameters for a data value.

71 | P a g e

Click ‘Tools,’ in the menu bar at the top left of the screen and select ‘Add Histogram’ from the drop down menu in order to open the histogram window.

72 | P a g e

The data reflected in the histogram can be edited by clicking on the graph's label, located below the histogram. This opens the attribute selector.

Tool Icon

Clicking the tool in the upper left corner of the screen opens the visualization controls and display preferences window.

Visualization Controls

73 | P a g e

The manner in which the attribute is separated into ranges, or binned, can be selected by choosing one of the 5 possible binning types on the left of the box. If “simple binning” is selected, the number of bins can be adjusted with the up and down arrows to the right. If a “custom split” is selected, the minimum and maximum values and each break point between are entered directly in the boxes to the right. Ranges can also be set using quantiles, equal intervals or standard deviations. When the desired binning ranges have been entered, the Apply button is used to update the display.

Window Settings:

Refer to “Window Settings” above.

Advanced:In this window, the user can choose a color scale to represent data values and reverse the color scale to determine how progression in the data (low to high) is represented within the chosen color scale. Additionally, the user can determine the size of the bubbles on the legend.

74 | P a g e

Line Chart

The line chart is a useful tool for showing how multiple indicators are related (parallel coordinates) as well as how data has changed over time (time series).

Click ‘Tools,’ in the menu bar at the top left of the screen and select ‘Add Line Chart' from the drop down menu to open the line chart window.

Click one of the labels at the bottom of the line chart or the tool icon to select new indicators to be shown on the line chart. This opens the attribute selector.

or then

75 | P a g e

Open the tool menu by clicking the tool icon in the upper left corner of the visualization window.

ATTRIBUTES FOR LINE CHART

The bar labeled 'Color' is used to select an indicator that will set the line colors and the bar labeled 'Label' is used to select a unique label for each line. The labels are visible at the right end of the line.

To change the indicator for ‘Color’ or ‘Label’ click the folder icon, which will open the attribute selector where different files can be selected.

To remove the current indicator for the ‘Color’ or ‘Label’ click the trash icon.

The slider labeled 'Label Text Size' can be used to determine the size of the label

76 | P a g e

The box labeled 'Label Text Color' selects colors for the label.

Attributes can be removed by selecting an indicator and then pressing the 'Remove Attribute(s)' icon at the bottom of the panel. Multiple attributes can be selected by holding the shift or control key and selecting various indicators.

VISUALIZATION CONTROLSSelecting the visualization controls tab allows users to select different visual cues to further reflect indicated data.

The drop-down menu labeled 'Shape' selects the shape used to represent each data point along a given on the line chart.

The slider labeled 'Gap Size' sets the distance between line segments at the data points.

The box labeled 'Border Color' selects the color of the border around the shapes used to indicate different data points.

The slider labeled 'Border Thickness' sets how thick the shape borders are.

77 | P a g e

The slider labeled 'Line Opacity' sets the relative transparency of the lines on the chart. The farther the slider is to the left the more transparent the line are and the farther the line is to the right the more opaque the lines are.

The circles labeled 'Line Curvature' allow the curvature of the line between data points to be altered for visual appeal.

The circles labeled 'Line Thickness' allow for four different thickness levels for the lines on the chart.

Checking the box labeled 'Show selection and probe only' makes the lines only visible when moused over.

Window Settings:

Refer to “Window Settings” above.

Gauge

The gauge tool is used along with other visualization tools to show the performance of a particular indicator against a planned or expected outcome.

To open the data table window click ‘Tools,’ in the menu bar at the top left of the screen and select ‘Add Gauge Tool’ from the drop down menu.

78 | P a g e

To select the indicator value that will be indicated by the tool, click the tool icon in the upper left of the window.

This will open the 'Attributes for Gauge' tab. Clicking the folder icon will open the attribute selector where the desired attribute can be chosen.

Click the trash can icon to remove an attribute.

Once the attribute has been selected, if another visualization tool containing that attribute is hovered over, a line will appear on the gauge indicating the value of that data.

79 | P a g e

Gauge indicating percent obese in 2007

Tool Icon

Clicking the tool in the upper left corner of the screen opens the visualization controls and window settings window.

Window Settings:

Refer to “Window Settings” above.Thermometer

The thermometer tool is used to the relationship of a particular attribute to the maximum value for that attribute.

80 | P a g e

To open the data table window click ‘Tools,’ in the menu bar at the top of the screen and select ‘Add Thermometer Tool’ from the drop down menu.

81 | P a g e

To select the indicator value that will be displayed on the tool, click the tool icon in the upper left of the window.

This will open the 'Attributes for Thermometer' tab. Clicking the folder icon will open the attribute selector where the desired attribute can be chosen.

Click the trash can icon to remove an attribute.

Once the attribute has been selected, if another visualization tool containing that attribute is hovered over, the level of the thermometer will change to indicate the value of that data.

82 | P a g e

Thermometer indicating percent of the New York population categorized as obese in 2007

Tool Icon

Clicking the tool in the upper left corner of the screen opens the visualization controls and window settings window.

Window Settings:

Refer to “Window Settings” above.Pie Chart

The Pie Chart is a useful tool for showing particular indicators as portions of a whole.

83 | P a g e

Click ‘Tools,’ in the menu bar at the top left of the screen and select ‘Add Pie Chart’ from the drop down menu to open the Pie Chart window.

84 | P a g e

Hovering over any wedge will open a text box showing the data in that range and highlighting that same data in other visualization tools.

85 | P a g e

Tool Icon

Open the tool menu by clicking the tool icon in the upper left corner of the visualization window.

Attributes for Pie Chart

This section sets the data indicated by both the wedge size and their colors.

86 | P a g e

To select a file for either color or size click the folder icon to the right of the bar. This opens the attribute selector.

A file can be removed by clicking the trash can icon next to the folder icon.

Window Settings:

Refer to “Window Settings” above.

Pie Chart Histogram

The pie chart histogram is a useful tool for showing the proportions of particular indicators, particularly percentages.

87 | P a g e

Click ‘Tools,’ in the menu bar at the top left of the screen and select ‘Add Pie Chart Histogram’ from the drop down menu to open the Pie Chart Histogram window.

88 | P a g e

Tool Icon

Clicking the tool in the upper left corner of the screen opens the visualization controls and window settings window.

Attributes for Pie Chart Histogram

Click the folder icon in the bar labeled data to select the indicators for the pie chart histogram. This will open the attribute selector.

89 | P a g e

Click the trash can icon to remove the selected indicator.

Pie Properties

The color scale box, located under the “Advanced” tab, presents multiple options for the range of colors that will be used for the bar chart.

Checking the reverse color scale icon reverses the direction of that the color scale changes colors (for example switching from blue to red to red to blue).

Window Settings:

Refer to “Window Settings” above.

Time Slider

The time slider feature allows users to view how the uploaded data changes over time. The changes in data are visible in all visualization windows. To implement this feature, the uploaded data must have a time value (ex. data from 1995, from 1996, etc.).

90 | P a g e

Scatterplot with time-dependent data

Click ‘Tools,’ in the menu bar at the top left of the screen and select ‘Add Time Slider tool’ from the drop down menu in order to open the map window.

A time slider window should then appear on the screen, indicating the different time values in the indicator data.

In order to manually scroll through each time interval, slide the arrow on the horizontal slider tool to each time interval (indicated by a line). The changes in indicator data will be reflected on each visualization window.

91 | P a g e

The time slider can scroll automatically by clicking ‘Play’ on the time slider tool. The speed of the time slider can be set using the drag-button below the play sign.

Once the time slider begins playing it will continue on a continuous loop until the user clicks ‘stop,’ to the left of the time slider.

Tool Icon

Clicking the tool in the upper left corner of the screen opens the visualization controls and window settings window.

Attributes for Time Slider Tool:

Here, the user can determine the units of the time slider (comma separated) either by

92 | P a g e

entering them manually or by specifying a column to pull the units from.

Time Slider Data Setup

The Time Slider tool is used for representing longitudinal datasets, wherein the same indicator(s) is available throughout a time dimension (year, month etc.). The following will explain the steps needed before opening the Time Slider tool in WEAVE.Change the indicator names and add year, min and max values

Go to Admin Console/Data tables tab and select the table with time series data that you want to use. 

o In the Table view, you’ll see the indicators that were created for this table.  The Admin Console creates indicators that look like this: name: ‘Obesity 1995’ name: ‘Obesity 1996’

o Edit these values in the Table View.  Change name:  Edit the name value to e.g. “Obesity” so that you have

many indicators with the same name, but different year values.  Add year:  Scroll to the right and you’ll see a year column.  Type in

the appropriate year for that indicator.  Add min and max: For all the indicators with the same name, you

should also enter a min and max that is the same so that the visualization axes stay the same as the user slides over time. 

93 | P a g e

o   You now have something like this name: ‘Obesity’ year: ‘1995’ min: 0 max: 60 name: ‘Obesity’ year: ‘1996’ min: 0 max: 60 …

94 | P a g e

 Time Slider User Interface-          In Weave, set up your visualization tools with the data you want to see.  -          Add a time slider tool by clicking on ‘Tools’ and choosing ‘Add Time Slider Tool’:

 When you add a time slider tool to a Weave instance, it looks through the visualization tools that are currently on the Weave desktop and checks the indicators they are using for year values.  It gets the slider (year) values from an indicator that is currently on the

95 | P a g e

Weave desktop and has year values.  So, you should add all your other visualizations and choose the appropriate data before adding the Time Slider tool.

Window Settings:

Refer to “Window Settings” above.

Dimension Slider

If your data has a column with the time value (e.g.  State, Year, Percent Obese, Percent Overweight…) then you should use the Dimension Slider. In the time slider, each column in your data-table is a data-value and a year-value column, where is in the dimension slider, each column is a data-value only, and years are in one column:Data table for a Time Slider:

96 | P a g e

Data table for a Dimension Slider:

Dimension Slider Data SetupAdd a secondary key to the sqlQuery

Go to Admin Console/Data tables tab and select the table with time series data that you want to use.

In the Table view, you’ll see the indicators that were created for this table. e.g. `State’, ‘Year’, ‘Percent Obese’, ‘Percent Overweight’

97 | P a g e

If you scroll to the right, you’ll see the sqlQuery column. 

To add a secondary key to the sqlQuery, you can edit the sqlQuery right in this table.  For Percent Obese, change the sqlQuery from

“SELECT `State`,`Percent Obese` FROM table” To “SELECT `State`,`Percent Obese`, `Year` FROM table”

 Dimension Slider User Interface

In Weave, set up your visualization tools with the data you want to see.  Add a dimension slider tool:

98 | P a g e

  The Dimension Slider Tool setup searches the indicators that are currently on the Weave desktop to find a list of those that have a secondary key.  It puts the unique secondary key values into the labels on the slider.  In the latest nightly build (dated 3/8/2011), you can choose which of these indicators supply the labels by clicking on the wrench in the upper right corner of the dimension slider tool.  You can also edit the dimension slider labels there.  Note: if there are no labels in the slider, it means that it did not find an indicator with a secondary key in any of the indicators currently on the Weave desktop. 

Window Settings:

Refer to “Window Settings” above.

99 | P a g e

Selections

This feature makes it possible to save selections of different data indicators to be reopened at another point in time.

There are a few ways to make a selection:

Hold the control key and select the desired indicators on any of the visualization tools. A selection on one tool will show up on the others. Clicking and dragging can also be used to select indicators that are adjacent to each other.

These two methods can be used in conjunction with one another.

Selected indicators on multiple visualization tools.

Once the selections have been made they can be saved by clicking ‘Selections,’ in the menu bar at the top of the screen and selecting ‘Save Current Selection…’ from the drop down menu.

100 | P a g e

This will open a window where a name can be entered for the selections. After entering the name click the 'OK' icon to save it.

To reselect these saved selections click 'Selections' in the menu bar at the top of the screen and select any of the saved selections from the drop down menu.

Clicking on 'Selections' and selecting 'Manage saved selections…' opens a window listing all the saved selections.

101 | P a g e

Selections can be renamed or deleted using the two icons at the bottom of the window.

Subsets

A subset is a set of individual indicators selected from a larger group of indicators.

There are two methods for selecting different indicators. Adjacent divisions within avisualization are selected by clicking on the first division and dragging the mouse. This creates a rectangular box which contacts some portion of each division.

102 | P a g e

The second method allows users to select divisions that do not border each other. To do this, hold down the control key while clicking on each division. The two methods can be used in conjunction by selecting bordering data via dragging and then selecting non-bordering data through the control-click method described above.

Once the divisions have been selected, to create a subset, click ‘Subsets,’ in the menu bar at the top of the screen and select ‘Create subsets from selected records’ from the drop down menu. To save the created subset select 'Save current subset…' from the same drop-down menu.

To save the created subset select 'Save current subset…' from the same drop-down menu. A window will appear allowing the subset to be named.

103 | P a g e

Saved subsets can be deleted or renamed by selecting 'Manage saved subsets' from the drop down menu.

Session

Using sessioning it is possible to view the currently visualized data as an object code. This makes it possible to add/delete visualizations, change attributes, resize/move windows, among other features.

To save a session state for later use click 'Session' in the menu bar at the top of the window and select 'Save session state to server' from the same drop-down menu.

To view and select saved session states select 'Show saved session sates' from the 'Session' menu option. This will open a window showing all saved session states, their default name is 'Weave Session State' along with the number that they were saved ( for example, the initial session state is automatically saved as 'Weave Session State 1). Using this window a particular session state can be returned to by selecting the 'Apply State' icon or removed by selecting the 'Remove State' icon.

104 | P a g e

Importing a Session State

To import a session state, click 'Session' in the menu bar at the top left of the screen and select 'Import Session State…' from the drop down menu.

A window will open from which a previously saved session state can be selected. Once the session state has been selected, the Weave application's appearance will return to that of the previously saved session state.

Exporting a Session State

Exporting the session state makes it possible to save the session so that it can be re-opened later.

To export a session state, click 'Session' in the menu bar at the top left of the screen and select 'Export Session State…' from the drop down menu.

The 'Export Session State' window will open.

105 | P a g e

The two boxes in the window make it possible to change how the exported session state looks. If the 'Show Menubar' box is selected the saved session state will have a visible menu bar. If not, the menu bar will be removed. Selecting the 'Enable dashboard mode' box saves the session state in dashboard mode -- meaning all tool borders will not be visible and they will not be able to be dragged or closed.

Clicking the 'Export' icon saves the session state to the client machine.

106 | P a g e

User Interface Preferences

User interface preferences allow the user to control various aspects of the Weave application's appearance and interactivity. To open the User interface preferences window click ‘Session,’ in the menu bar at the top of the screen and select ‘User interface preferences’ from the drop down menu.

Appearance

The box labeled 'background color' opens a color selector from which the background

107 | P a g e

color of the Weave application can be selected.

The 'Default Font Properties' box sets different appearances for the font within the Weave visualization labels. This includes font styles, size, color and the option to make the font bold, italicized or underlined.

The 'Default Axis Font Properties' box sets the font appearance for the axis labels within the Weave visualization. This includes options for font size, color and the option to underline the labels.

Checking the box labeled 'Enable dashboard mode' removes the menu bar at the top of the application and the line at the top of each visualization.

Menus

The 'Show menu bar' box is used to remove the toolbar from the Weave application (by selection off).

The different tabs at the bottom of the menus option correspond to different options within the main tool bar. Removing the check from any of the top box removes that

108 | P a g e

particular option from the tool bar and unchecking any box below the main box removes that option.

Interactivity

Use this tab to turn on or off selecting, probing and the right-click function.

Probing

109 | P a g e

This tab provides different options for the color and strength of color presented when probing different indicators.

Selection

This tab provides options for both the color and shadow strength when selections are made.

Window

The window option can be accessed from the main menu on the top of the screen. This allows different visualization windows to be selected based on their name and for those windows to be minimized, maximized or closed or to make the entire application go full screen.

110 | P a g e

111 | P a g e

Weave Features and Other Tools

Attribute SelectorClient-Side Menu BarLoading a CSV/XLS file into Weave from the BrowserExport/Print ToolSessioningWindow Menu OptionsVisualization TrayCreate Data SubsetsRight Click FunctionsUser movable/resizable/minimizable/closeable windowingWeave ReportsOther Features

Attribute Selector

The attribute selection box allows the user to assign a particular indicator to a display dimension (parameter): x-axis, y-axis, color, point size, bar-height, etc. The attribute selector box can be accessed by clicking on the x or y axis label in any visualization or by clicking on “Tools” in the menu bar and choosing “Attribute Selector”.

Selecting Data

To select the category of the data reflected in the visualization, use the folders on the left side of the attribute selector window.

112 | P a g e

Different categories of data can also be found using the box located above the category drop down menu.

Select the specific data to be indicated from the options on the rightof the window.

Data can also be found using the search menu located above the different indicator options.

Window Settings

'Window Settings' is a common tab within the tool icon. To open it click the tool icon in the upper-left of any visualization tool and click the tab labeled 'Window Settings.' For some visualization tools this will be the only option after clicking the tool icon.

113 | P a g e

Use the bar at the top of the tab labeled 'Window Title' to enter a new title for the visualization window. The new title will appear instantly as it is typed into the bar.

The list below the window title bar presents several options for the appearance and options for controlling the visualization window.

114 | P a g e

'Show Borders' controls the presence of borders around the visualization window. 'Allow Resizing' controls whether the visualization window can be re-sized. 'Allow Closing' controls the 'X' in the upper right corner of the visualization window that closes the window. 'Allow Minimization' controls the presence of the horizontal line in the upper right of the visualization window that sends the window to the visualization tray. 'Allow Maximization' controls the presence of the box in the upper right of the visualization window that maximizes the window to take up the whole application. 'Allow Dragging' controls the option to move the visualization window manually around the application by clicking the upper boarder. The 'Border Color' icon presents multiple options for the color of the border at the top of the visualization. The 'Visualization Background Color' presents multiple options for the background color of the visualization.

Minimizing and restoring windows

Users can minimize or restore each visualization by using the minimize/restore box in the upper right hand corner of the panel, or by using the “window” command on the menu bar located at the top of the screen. To use the “window” command, click on a particular visualization panel, then select “window” from the tool bar. A drop-down menu will allow the user to minimize, maximize or close the window. If the visualization tray has been enabled by the administrator, small screenshots of each minimized panel will be displayed at the bottom of the screen. If the visualization tray has not been enabled, minimized panels will be displayed as horizontal bars at the bottom of the screen.

Visualization Tray

An optional visualization tray sits at the bottom of the weave application. By using the minimize box in the upper right corner of each panel, visualizations can be minimized to and restored from the tray. When a tool is minimized to or restored from this task bar, there is an animation effect that allows the user to follow the location of the window.

115 | P a g e

The visualization tray shows small screenshots of the minimized visualizations, and displays the title of the window when the user hovers over it, aiding the user in seeing which tool is there before restoring it. If the visualization tray is not used, windows will minimize in the normal way of becoming a thin (height-wise) bar of the same width that can be restored. Tools can also be closed if they are no longer needed.

Working with Data Subsets

A subset is a group of datapoints in any of the Weave panels, geographic regions on a map, points on a scatterplot, or bars on a bar chart. If desired, selected datapoints can be grouped together into a subset. The subset can then either be removed from the original dataset and the visualization recalculated, or, the rest of the data can be removed and the subset recalculated to become the whole. There are various ways to select one or more datapoints: they can be selected by dragging a bounding box around the datapoints, or by control-clicking datapoints in any panel. Clicking the right mouse button brings up a menu which includes Create Subset from Selected, Add Selected to Subset or Remove Selected from Subset.

Create Subset from Selected: this choice will include only selected values when it recalculates the visualizations. For example, to learn more about a group of outlying datapoints at the extreme end of a range of values, select them with a bounding box and then choose Create a Subset from Selected. Only data points in the selected group will be included in the recalculation.

Remove Selected from Subset: this choice will remove any selected (highlighted) data points from the original dataset and recalculate the visualizations.

Show All Records: Once the user is done investigating a part of the data set, he or she can always restore the full original dataset by right clicking and selecting “Show All Records”.

The screenshot on the right shows a bounding box that has been used to create a subset of data from a bar chart. Once the data is selected, it can either be removed from the original dataset, or all data not in the grouping of datapoints can be removed from the dataset leaving only the data for the selected datapoints. Create Data Subset Using the right mouse button, select the desired subset operation. The new graph, map or chart will reflect only the specified data.

116 | P a g e

At this point, the original dataset can be regained by using the Show All Records menu item, and the results will revert to the original dataset.

Further refine the subset for an additional narrowing of the data using the Add Selected to Subset menu item.

Right-click functions

The right mouse button can be configured to offer additional tools for understanding data. When the user right-clicks over a visualization, Weave presents a drop-down menu with several options. From this menu the user may choose to:

117 | P a g e

Create and remove subsets from probed record(s). Show all records Show data for probed record Add and Edit Annotation. Search for records about particular data using Wikipedia, Google, Google Images and Google Maps. Save or print selected visualization tool or application image. Show help page.

Moving, Resizing, Minimizing, and Closing Visualization Windows

The Weave administrator has the ability to enable users to move, resize, minimize and close visualization windows. If disabled, users will be unable to resize their windows, other than the grid cell size of the visualizations.

Moving Windows:

Windows can be moved by clicking and holding the darkened bar at the top of the window and moving the cursor until the window is in its desired location.

Resizing Windows:

Windows can be resized by hovering the mouse cursor over the top, bottom, corners or either side of the window and clicking and dragging the portion of the window until it reaches the desired size.

118 | P a g e

Minimizing and Restoring Windows:

Visualization windows can be minimized and restored from a task bar at the bottom of the Weave application. A window is minimized by clicking the horizontal line in the upper-right hand corner of the window. A window is restored by clicking the minimized view of the window in the task bar at the bottom of the Weave application. An animation indicates where the window when it is restored or minimized. Both the task bar and the animation effect are enabled by the administrator.

The task bar shows a small screenshot of the minimized visualization and displays the title of the window when the user’s mouse hovers over it, aiding the user in seeing what tool is there before restoring it.

Closing Windows:

Windows can be closed if they are no longer needed by clicking the red X in the upper right hand corner of the tool.

119 | P a g e

Creating a Point Shapefile

For this section, you need a data file (.csv) that contains longitude and latitudes for the points that will make up the shapefile.

Download a program to assign these coordinates to a shapefile. A popular one 'Quantum GIS' can be downloaded here: external link: http://www.qgis.org/en/download/current-software.html.

One the program has been downloaded and opened, click this icon in the upper panel within the program window.

This window will open.

120 | P a g e

Click the '…' icon to select the CSV file. The delimiter string should be a comma (,), the X field should be 'bg_long' and the Y field should be 'bg_lat.'

After saving, this shapefile can be uploaded for further use by the Administration Console.

121 | P a g e