Histogram | Urbi Pro | Urbi Documentation
Urbi Pro
Maps
Search
Navigation
Urbi Pro
CityLens
Account
On‑Premise

Histogram

A histogram displays as vertical bars how often a value occurs in specified ranges, and also displays the type of distribution of values. The higher the histogram bar is, the more values ​​of the data attribute are included in the corresponding range.

Use a histogram to show the distribution of data by fixed ranges that are set using a step size.

Case example: show the distribution of working population:

Histogram showing the distribution of working population

Main features

  • The X-axis displays ranges of data values. As a grouping attribute, you can select:

    • Numeric attributes: for example, number of reviews, building area, and others.
    • Text attributes: for example, firm category, building purpose, and others. For this attribute type, a column chart with the number of objects in data groups is built instead of a histogram. You can build an extended column chart and select an aggregation attribute and function.

  • You can set a fixed range size (step size), such as 10, 20, 50, 100, or others. For example, to estimate the distribution of the average bill, use steps of 10 or 20 dollars. To estimate a distribution of age or the number of floors in buildings, use steps of 1 or 5. If you want to set up ranges of different sizes manually, use a bar or column chart.

  • By default, the histogram displays only the first 100 ranges. To see all the data, increase the range in the Step size field when creating a widget or editing it.

  • You can click the chart bars to filter data by the selected attribute without editing the data sample. For more information, see the Filtering through widgets section.

  • 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.

Creating a widget

Example of creating a histogram

  1. Go to the Dashboards tab.

  2. Open the required dashboard.

  3. Open a scene using the arrows Left arrow and Right arrow. If there is only one scene in the dashboard, it opens automatically when you open the dashboard.

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

  5. Select the Histogram widget type.

  6. Specify the required parameters:

    • Layer: data layer used to build a chart on the widget.
    • Grouping attribute: attribute used to group data.
    • Grouping attribute value: if you select a text grouping attribute, specify its values. You can select particular values ​​from the sample in the drop-down list or generate the top 5 or top 10 values ​​from the sample (the top values ​​are automatically calculated based on the aggregation attribute).
    • Step size: fixed size of data ranges.

  7. Set the remaining widget parameters if necessary.

  8. Click Create.

A new widget is created and automatically added to the selected dashboard scene.

Note

When working with the uploaded data, make sure it contains at least one attribute to build a chart.

Parameters

General widget settings

Parameter
 Description
Widget name Widget name.
Layer Data layer used to build a chart on the widget.
Change widget type Click to select another widget type from the list. The configured widget parameters are saved.

X and Y axes

Parameter
 Description
Grouping attribute Attribute used to group data on the chart. Displayed on the X-axis.
Step size Fixed size of data ranges.
Grouping attribute value The number of vertical bars that are displayed on the chart. As values, you can select the following:
  • Any attribute values ​​from the sample in the drop-down list. You can change the order of the bars on the chart if necessary.
  • The top 5 or top 10 values ​​from the sample that are automatically calculated based on the count of objects in the group. To display the sum of the last value in the top and the remaining values ​​in the sample below this position in the last bar, select the Show other checkbox.

For text grouping attributes only (for this attribute type you can use a column chart instead of histogram).

Color

Parameter
 Description
Color Different color settings are available, depending on the type of grouping attribute (text or numeric):
  • For numeric grouping attributes: selecting a color according to which elements on the chart are colored. You can select a color from the palette or specify it in HEX format.
  • For text grouping attributes (for this attribute type you can use a column chart instead of histogram): selecting a color scale (a set of prepared color samples) according to which elements on the chart are colored.

Description

Parameter
 Description
Text Text displayed on the widget above the chart. The maximum number of characters is 5000.
H1 Title (heading 1).
H2 Heading 2.
H3 Heading 3.
B Bold.
I Italic.
U Underline.
Link Inserting a link.
Color Text color. You can select a color from the palette or specify it in HEX format.

Appearance of the graph

Parameter
 Description
Show axis titles Shows the labels of the X and the Y axes on the chart. By default, names of the selected attribute values ​​are shown. To change the axes labels, enter new values in the X-axis and the Y-axis fields. The maximum number of characters is 50.
Labels Shows the attribute values ​​on the X and the Y axes.
Axes Shows the axes on the chart.
Grid Shows a grid on the chart.

Additional settings

Parameter
 Description
Type of scale Distribution type used to calculate data ranges on the chart:
  • Logarithmic - logarithmic distribution. Suitable for displaying data that changes over a wide range or differs by several orders of magnitude.
  • Linear - uniform distribution. Suitable for displaying values ​​of the same order.
  • Exponential - exponential distribution. Suitable if you need to highlight small values and ignore large ones, and also for displaying data that changes quickly.
  • Quadratic - quadratic distribution. Suitable if you need to show differences between small values.
Show legend Shows the values ​​of the grouping attribute and the corresponding count of objects in the group.
For text grouping attributes only (for this attribute type you can use a column chart instead of histogram).
Values ​​in percentage Shows the count of objects in the group as a percentage.
For text grouping attributes only (for this attribute type you can use a column chart instead of histogram).
Show source Shows the name of the data layer, the grouping attribute and the aggregation attribute with the corresponding axes, and also the aggregation type.
Show empty ranges Shows on the chart the ranges of values ​without data.
For numeric grouping attributes only.
Total objects in the asset Shows the number of objects in the sample used to calculate the values.

What's next?