Comparison | Urbi Pro | Urbi Documentation
Urbi Pro

Comparison

A Comparison widget displays a summary table with the values ​​of the selected data attributes in different groups.

Use the widget to compare multiple values ​​from different categories within a single widget. For example, you can compare the average bill in restaurants from different areas of the city.

Case example: compare the average number of floors in residential buildings across different administrative districts:

Comparison widget
  • The values of comparison attributes ​​are grouped in the widget by columns. As groups, you can use:

    • Territories:

      • Standard territories: regions, districts, settlements, and others.
      • Custom territories: first upload your own dataset with polygons and create a territory filter.
      • Territories specified in geofilters for the current dashboard scene.

      For more information on territory types, see the Geofilters section.

    • Data visualization elements in layers: H3, Contour, or Polygon. You can select elements by clicking them on the map. Example:

      Selecting a group by clicking on the map
  • Each column contains the values ​​of the selected comparison attributes. The attributes can belong to different data layers. As comparison attributes, you can use:

    • Numeric attributes: to count the number of values ​​in the sample or to count values of the attributes using aggregation functions: total, mean, minimum, maximum value, median, and percentile.
    • Text attributes, logical attributes, or number of objects: to count the number of values ​​in the sample.
  • The maximum number of groups (columns) in the widget is 100. The maximum number of comparison attributes is 100.

  • If necessary, you can edit the names of the comparison attributes displayed in the widget. The attribute names in the dataset will not change.

  • Changes in layer data are automatically reflected in the widget.

  • If the filtering by territories or data attributes is applied on a dashboard scene, only the values ​​that match the filters are displayed in the widget. For more information, see the Filtering data on a dashboard instruction.

Example of creating a Comparison widget
  1. Go to the Dashboards tab.

  2. Open the required dashboard.

  3. Open the scene using the arrows Left arrow and Right arrow. If the dashboard has only one scene, it will open automatically.

  4. In the top menu of the dashboard, click the Widgets icon.

  5. Select the Comparison widget type.

  6. Specify the required parameters:

    • Groups: territories or visualization elements for which attribute values ​​are calculated.
    • Comparison Attributes: values ​displayed in the widget:
      • Layer: data layer containing the required attribute.
      • Aggregation attribute: attribute used to aggregate data and calculate the value.
      • Aggregation type: function used to calculate the attribute value.
  7. Set the remaining widget parameters if necessary.

  8. Click Create.

The new widget is automatically added to the selected dashboard scene.

Note

When working with the uploaded data, make sure it contains at least one attribute to display a value in the widget.

Parameter
Description
Widget name Widget name.
Parameter
Description
Territory Selecting territories as groups for comparison. You can select:
  • Standard territories: regions, districts, settlements, and others. In the Find the territory field, search by names. You can specify search filters (for example, search only for regions).
  • Custom territories: first upload your own dataset with polygons and create a territory filter. In the Find the territory field, search by territory names that you specified in the properties when uploading the dataset.
  • Territories specified in geofilters for the current dashboard scene. To use them, click Synchronously with geofilters. When geofilters in the scene are changed, the groups in the widget are also changed automatically.
On the map Selecting data visualization elements (H3, Contour, or Polygon) as groups for comparison. Select a layer with data visualization and click the required elements on the map.
Groups To change the order of groups (columns) in the widget, hold Drag and drop icon for the required group and drag it.

The feature is not available if you use the Synchronously with geofilters option for groups.
Parameter
Description
Layer Data layer containing the required comparison attributes.

To add another data layer, click Add layer. The feature is not available if you use the On the map option for groups.

To change the order of layers and the corresponding attributes in the widget, hold Drag and drop icon for the required layer and drag it. To delete a layer, click Cross icon.

The maximum number of layers is 100.
Aggregation attribute Attribute, which value is aggregated and displayed in the widget:
  • Text attribute. You can select any attribute values ​​from the data sample. When you modify the sample, the available attribute values are also changed.
  • Numeric attribute.
  • Logical attribute. Available values are Yes and No/Unknown.
  • Number of objects.

When the data value changes, the value in the widget is also updated automatically.

To add another data attribute, click Add attribute. To change the order of attributes (rows) of one layer in the widget, hold Drag and drop icon for the required attribute and drag it. To delete an attribute, click Trash icon.

The maximum number of attributes for each layer is 100.
Aggregation type Function used to calculate comparison attribute value.

For numeric attributes:
  • Sum: the sum of the values.
  • Mean: the mean value.
  • Min: the minimum value.
  • Max: the maximum value.
  • Median: the median value that is equal to or greater than 50% of the values ​​in the group.
  • 80th percentile: the value that is equal to or greater than 80% of the values ​​in the group.
  • 95th percentile: the value that is equal to or greater than 95% of the values ​​in the group.
  • 99th percentile: the value that is equal to or greater than 99% of the values ​​in the group.
  • Quantity: number of objects in the sample.

For text attributes, logical attributes, and number of objects:
  • Quantity: number of objects in the sample.
Edit To rename a comparison attribute displayed in the widget, click Edit icon and enter a new value. The comparison attribute name in the dataset will not change.