Visualize Query Feature

The Visualize page allows the user render Solr queries in the form of charts and graphs using the Highcharts javascript library. Chart parameters are passed RESTfully by URL parameters, making it possible to bookmark and share charts over the web. This page is accessed one of two ways: by clicking on the charts icon under Data Options on the Browse page or by clicking the Visualize Queries link in the top navigation menu, if the option has been enabled in the Numishare configuration file.

If Visualize has been accessed via the Browse page, the current query from that page has been supplied for visualization. If accessed directly through the navigation menu, queries for visualization must be added under “Step 4: Compare Queries,” discussed in further detail below.

Usage Instructions

Step 1: Select Numeric Response Type

Two user must select one of two radio buttons: percentage or count. The percentage option renders results according to their percentage out of the whole query, while count displays raw numbers. The former option is generally more useful for comparative analysis, and is set by default.

Step 2: Select Chart Type

The user may select one a handful of chart types supported by Highcharts. Pie charts are disabled as they require a different underlying data structure than other types of graphs.

Step 3: Select Categories for Analysis

The user can select one or many predefined Solr facets for visualization. Each checkbox selected will be rendered in its own chart (i.e., charts showing distribution of deities or denominations cannot be overlayed at this point). The user has the option to add custom queries to the visualization. Custom queries are generally only useful when used in conjunction with Step 4 (comparisons). Clicking under “Add Query” under the Add Custom Queries heading will lauch a popup window with the same options as the Search page. The user can select between a variety of drop down menus or keyword searches and compile categories to form complex queries. See image below:

Step 4: Compare Queries

Selecting queries for visualization is a requirement if the user has entered the page directly through the navigation menu. Clicking on “Add Query” lauches a popup window with search options, as detailed in Step 3. The drop-down menus for facets (e.g., denomination and material) dynamically respond to query options previously set in the popup windows. That is to say, if “snake” is entered as a search phrase for the “type” field, when the user selects “denomination” as the next query option, only denominations for which a snake appears will be listed in the associated menu. There is no limit to the number of queries that can be compared for visualization, but the charts may grow unwieldy after 5 or 6 queries.

After queries are added, they can be removed by clicking the “Remove Query” link.

Optional Settings

Optional calculation and view settings can be selected under this section.

Stacking

Stacking options only apply to comparisons.

Cumulative: stack raw percentages or counts upon a single bar or column. It does not apply to cumulative percentages for dates. Percentage: all bars and columns are represented on a scale of 0 to 100%, divided by percentage of results for each comparison.

Examples

Example 1

Percentage of a selection of denominations issued by the emperors ranging from Augustus to Antoninus Pius in OCRE. Hadrian issued nearly 60% of all cistophori; Claudius issued about 40% of all didrachms and Nero issued nearly half.

http://bit.ly/11xQMvH

Example 2

Comparison of Augustan coins which reference the Parthian settlement with Augustan references to Actium.

tip: to compare numeric counts for complex queries, set to custom query to '*' for keyword (gathers all coins)

http://bit.ly/TLJPRh

numishare/visualize.txt · Last modified: 2013/02/11 16:19 by egruber
 
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 3.0 Unported
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki