Weave

Beta

2011
1.0
Releas
e User
Guide
 Table of Contents
Introduction..................................................................................4
Weave Menu Bar............................................................................5
Data.............................................................................................................7
Refresh Data Source Hierarchies................................................................7
Import New Dataset...................................................................................7
Session........................................................................................................9
Import Session State..................................................................................9
Export Session State..................................................................................9
Export........................................................................................................12
Save or Print Application Screenshot.......................................................12
Tools...........................................................................................................14
Color Controller........................................................................................15
Equation Editor........................................................................................15
Attribute Selector.....................................................................................32
Probe Tool Editor......................................................................................34
Data Table................................................................................................37
Color Legend............................................................................................43
Color Histogram.......................................................................................45
Map..........................................................................................................47
Bar Chart..................................................................................................50
Scatterplot...............................................................................................63
Histogram................................................................................................69
Line Chart................................................................................................73
Gauge......................................................................................................76
Thermometer...........................................................................................78
Pie Chart..................................................................................................81
Pie Chart Histogram.................................................................................84
Time Slider...............................................................................................88
Dimension Slider......................................................................................93
R Script Editor (See attached ppt)..............................................................?
New User Wizard (being done by Sebastien)..............................................?
Selections.....................................................................................................97
Subsets.........................................................................................................99
Session.......................................................................................................101

2|Page
 Import Session State..............................................................................102
Export Session State..............................................................................102
User Interface Preferences ....................................................................104
Appearance............................................................................................104
Menus....................................................................................................105
Interactivity............................................................................................106
Probing...................................................................................................106
Selection................................................................................................107
Window.......................................................................................................107
Weave Features and Other Tools............................................................108
Attribute Selector...................................................................................108
Minimizing and restoring windows.........................................................111
Visualization Tray ..................................................................................111
Working with Data Subsets....................................................................112
Right-click functions...............................................................................113
Moving, Resizing, Minimizing, and Closing Visualization Windows ........113
Creating a Point Shapefile .....................................................................116

3|Page
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|Page
 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
5|Page
 Under "Window", the available selections are (in addition to a list titles of
windows included in the session):
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|Page
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|Page
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|Page
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|Page
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
Tools
Color Controller
Equation Editor
Attribute Selector
Probe Tool Editor
Data Table
Color Legend
Color Histogram
Map
Bar Chart
Line Chart
Scatterplot
Gauge
Thermometer
Pie Chart
Pie Chart Histogram
Histogram
Time Slider
Dimension Slider
R Script Editor
New 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 getNumber
25 | 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:

Math
abs(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)

MathLib
add(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)
tr
StringLib
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)

BooleanLib
equals(*,*)
greaterThan(*,*)
greaterThanEqualTo(*,*)
iif(*,*,*)
isDefined(*,*)
isUndefined(*)
lessThan(*,*)
lessThanEqualTo(*,*)

30 | P a g e
 not(*)
toBoolean(*)

ArrayLib
arrayLength(Array)
getItem(Array,int)
getItemIndex(Array,*,*)
join(Array,*)
split(String,String,int)

StatisticsCache
getCount(IAttributeColumn)
getMax(IAttributeColumn)
getMean(IAttributeColumn)
getMin(IAttributeColumn)
getRunningTotals(IAttributeColumn)
getStandardDeviation(IAttributeColumn)
getSum(IAttributeColumn)
getVariance(IAttributeColumn)

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

QKeyManager
GetAllKeyTypes()
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,*)

Constants
E
LN10
LN2
LOG10E
LOG2E
PI
SQRT1_2
SQRT2

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
be indicated from the list on the right side of the window.
33 | P a g e
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
Image Column” to specify the column in the dataset that contains the images:
40 | P a g e
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
Histogram’ from the drop down menu to open the Color Histogram window.
46 | P a g e
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
can see the data at flexible levels of granularity and use simple, but powerful tools to
further view and explore the data.

48 | P a g e
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

There are three methods for interacting with the map data: selecting, panning and
53 | P a g e
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.

The second method of allows users to select map divisions that do not border each other.
54 | P a g e
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.

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
56 | P a g e
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.

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

57 | P a g e
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 CONTROLS
Selecting 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 Setup

Add 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
color of the Weave application can be selected.
107 | P a g e
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
particular option from the tool bar and unchecking any box below the main box removes
108 | P a g e
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 Selector
Client-Side Menu Bar
Loading a CSV/XLS file into Weave from the Browser
Export/Print Tool
Sessioning
Window Menu Options
Visualization Tray
Create Data Subsets
Right Click Functions
User movable/resizable/minimizable/closeable windowing
Weave Reports
Other 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