Filter Scope

Published on June 29, 2016

Developing effective applications with Arcadia Data

Developing Applications with Arcadia Data became easier with the onset of our 3.1 release. One key feature enables ease of filter usage. We will demonstrate this below for visuals belonging to the same datasets and for apps placed in an appgroup. We will first walk through the behavior of a built out appgroup, and then walk through how filters were used effectively within it.

rtaimage

Figure I: Sample application developed with filter settings at dataset and application scope level

Appgroup Summary:

Our sample appgroup, as shown in Figure I in its final form, is based on the US Census and Police Fatalities dataset. The population appgroup showcases population breakdown by state and age groups for five continuous years. It allows filtering by both year and state. Additional information from a different dataset shows police incidents across the United States. The current population visual in the left corner is used as a reference point and stays constant as other visualizations in the application change based on input from the user. Additional details by State and Gender breakdown are available in the “Population Details” tab.

Appgroup Behavior:

Changing the Year filter to a different value as shown in Figure II, applies to all visuals in the application. Note that the input dataset in this case represents year as a number between 1 & 5.

From the perspective of filter applicability, note that the Current US population visual remains unchanged as does the visual for Police Incidents. However, other visuals do change to reflect the filter. This showcases the capability of filtering to be fine-grained.

rtaimage01
Figure II: Filter settings for year (2011 – 2015)

Changing the State filter updates “Police Incidents Involving Fatalities” Geo Visual only and highlights incidents in the selected states.

rtaimage02
Figure III: Filter settings for states

rtaimage03
Figure IV: Filter settings for state and showing impact on Geo Visual

Navigating to the Populations details tab shows the Year filter. Note that the State filter is not shown here. This showcases the capability of filtering to be enabled selectively between apps in an appgroup.

rtaimage04
Figure V: Year filter automatically being applied to “Population Details” tab

Building the Application

Individual visuals and filters are populated using the standard building technique. Check online help on http://docs.arcadiadata.com/visualize.html#/visualize/visual.html to see how to build visuals and apps. Our focus in this section will be on how to utilize filters appropriately for this use case. Specifically, filters have a notion of scope that make it easier to control the visuals they impact, and we will walk through the scopes used here.

Dataset Scope:

This setting is available on a filter at the Application level, as shown in Figure VI below. It enables the filter to be set across all participating visuals belonging to the same dataset in an application.

In this example, one of the geo based visuals belongs to Population Application. It shows the number of police fatalities across the United States. This visual connects to a different dataset as compared to the rest. The State filter and Geo visual belong to the “Police incidents” dataset and allows focusing on fatalities in the selected states.

rtaimage05
Figure VI: Dataset Scope set for State filter enabling “Police Incidents” visual.

Explicit Scope:

This setting is available for a visual. The US Current Population Visual as shown in Figure VII does not participate in the Dataset Scope because its Explicit Scope setting is checked. This enables the current population to remain constant when the Year filter is changed at the application level.

rtaimage06
Figure VII: Individual Visual not participating in parent Application’s Data Scope with Explicit Scope checked.

App Group Scope:

This setting is available on a filter at the Application level. It enables the filter to be available across all participating Applications in an AppGroup. In the example in Figure VIII below the “year” filter has App Group Scope checked, allowing it to be available on all applications within the “Population” App Group enabling the filter to show on all tabs of that AppGroup. Dataset Scope is also set allowing it to impact all visuals belonging to that same dataset.

rtaimage07
Figure VIII: Year Filter having App Group Scope set to enable it across all applications.

Summary:

In general with the release of Arcadia Data 3.1 one is able to easily expand filter scope at the App Group and Dataset level. This makes app development much simpler as it is now unnecessary to add filter scopes on a per visual basis. There is fine grained control to select whether a visual participates in a given filter scope.

Terminology:

App Group Scope: Checking this option in Filter Settings enables a particular filter to apply to all apps within the App Group.

Dataset Scope: Checking this option in Application Filter Settings enables this filter to apply to all visuals using the same dataset, except for those visuals that have ‘Explicit Scope’ enabled (see below).

Explicit Scope: Checking this option in Visual Settings for a particular visual disables Dataset Scope filter for this visual.

References:

  1. United States Census: www.census.gov Population Estimates: Datasets for all Geographies.
  2. data.gov: Police Incidents for all cities.