{#- vim: set ft=htmldjango : -#} {% from 'docs/vis-documentation-macros.html' import full_documentation_link with context %} {% if show_figures %}
The religion hierarchy in its default state. At the top are the controls to revert the filter, the switch between simple and advanced filter mode, and the apply button. The religions are visualized as an indented tree, and are filtered by enabling the respective checkbox.
{% endif %}

This view shows all religious groups contained in the database and allows for selecting and filtering the data according to religion.

Content

The list of religious groups is hierarchical and represented by a tree visualization: each religious group occupies a line, which is indented according to its rank in the hierarchy. In technical terms, the higher level is conceptualized as parent, the respective lower levels as children.

Each line consists of an abbreviation for the religious group, a node, displayed as a bar, with the color associated with the group, and a checkbox used for filtering. Hovering with the mouse over the line displays a tooltip with the full name of the religious group and the number of pieces of evidence for the group based on the currently applied filters.

The general religious affiliation (e.g., Christianity) is on the first level of the hierarchy. For other religions beside Christianity, Islam, and Judaism, we made the pragmatic choice to group them under the category Other.

The religious groups each have a distinct color. For Christianity (red), Islam (green), and Judaism (blue), religious groups belonging to these general religious affiliations have hues of the same color. However, the difference between colors is limited because of the number of religious groups. In confidence mode (cf. the pane {{ full_documentation_link('settings-display-mode', 'Settings') }}), the bars of the groups are colored based on the average confidence of the represented data.

Details Regarding Coloring and Saturation

Depending on the options show filtered data (all data or only active) as well as display mode (religion or confidence mode) in the settings, the coloring of the bars changes:

Only active, religion mode
A bar has only one color. If any data related to a religious group is active, the bar has saturated colors; if all data related to a religious group is filtered out, the bar is shown in a less saturated color.
All data, religion mode
A bar can be divided into two parts, a saturated and a less saturated part. The less saturated part represents the relative amount of data currently filtered out.
Only active, confidence mode
A bar can be divided into several sections. Each section represents the relative amount of data with a certain level of confidence.
All data, confidence mode
A bar can be divided into two general parts: a saturated and a less saturated part, representing the data currently active or filtered out, respectively. Each part can have several sections, which each represent the relative amount of data with a certain level of confidence.

The aspect of confidence used for the visualization can be selected in the confidence view. There, the currently used aspect is indicated with an eye symbol below the column.

Interaction

Selection

Clicking on a line will select the religious group. This group will be highlighted, and other groups will be displayed in less saturated colors. The data represented by the selection will be brushed, and is linked to related data in all views. For instance, map glyphs in the map representing pieces of evidence with the selected religion will be highlighted, other locations will be represented by less saturated colors.

Filtering

The checkbox of a religious group can be unchecked, which leads to filtering out this group throughout the entire visualization. Depending on whether only active or all data mode is selected in the settings, data that has been filtered out is either hidden or displayed in less saturated colors.

There are two basic modes for filtering by religion (more details further below): In Simple mode, pieces of evidence matching any of the checked religions are shown. In Advanced mode, only pieces of evidence from places are shown, where checked combinations of religions were present. Note that, in both modes, the selection is not applied until the Apply button is clicked, which is enabled once there are changes to the filter.

Simple Mode

In simple mode, data is filtered simply according to the checked or unchecked religions. Initially, all religions are checked. To filter out a religion, it can be unchecked in the checkbox column.

Advanced Mode
{% if show_figures %}
The religion hierarchy in advanced mode. The filter limits pieces of evidence to those from places where two or more of the Syriac Orthodox Church (SYR), the Armenian Church (ARM), and the Church of the East (COE) are present.
{% endif %}

In advanced mode, it is possible to filter not individual religions but different combinations of religions. For instance, analysis may require to show places where two or more of the following three religious groups exist together: the Syriac Orthodox Church (SYR), the Armenian Church (ARM), and the Church of the East (COE) — but not those places where only one of the three is present. In this case, pieces of evidence are active if, for any combination, all religions of that combination are present at a place.

Different from simple mode, there are multiple columns of checkboxes. Each column represents a set of religious groups as described above. To control the filters in advanced mode, columns can be added by using the plus button above each column. Every column (except the last remaining one) can be deleted by pressing the delete button above the column.

The following procedure creates a filter corresponding to the analysis described above (see also {{ full_documentation_link('fig-religion-hierarchy-2', 'this figure') }}):

Note: If only places should match the filter where all of these three religious groups are present, only one column in advanced mode is necessary with all three groups checked. This must be understood as pieces of evidence with COE and ARM and SYR. In turn, this differs from checking the three religious groups in simple mode, which equals pieces of evidence with COE or ARM or SYR.

Filter Controls

A few additional utilities are available for managing the checkbox columns. The controls for adding ( plus button) and removing ( delete button) are already described in the {{ full_documentation_link('religion-view-advanced-mode', 'advanced mode description', true) }}. Importantly, columns can only be added in advanced mode, and the last remaining column cannot be removed. The additional controls in the view are:

Revert filters
This button is found in the top left corner of the view. Clicking it reverts the filters back to the state that is currently shown in the visualization; that is, all changes that are not applied yet are discarded.
Uncheck all boxes in this column
This button is found at the top of each checkbox column. Clicking it will uncheck all boxes in the column.
Invert all boxes in this column
This button is found at the top of each checkbox column. Clicking it will invert all boxes in the column; that is, boxes that were checked are unchecked, and vice versa.
Check all boxes in this column
This button is found at the top of each checkbox column. Clicking it will check all boxes in the column.
Toggle subtree
This button is present to the left of some of the checkboxes in each column; namely regarding religions that have children in the hierarchy. Clicking the button will check or uncheck this religion and all its children in the respective column. Whether clicking checks or unchecks depends on whether the majority of checkboxes in the subtree are checked.