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:

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.
Creating a widget

-
Go to the Dashboards tab.
-
Select the required dashboard.
-
Click
icon.
-
Click
icon next to the required layer and select Create widget.
-
Specify the required parameters:
- Layer: data layer that is used to build a graph on the widget.
- Grouping attribute: attribute that is used to group data.
- Step size: fixed size of data ranges.
-
Set the remaining widget parameters if necessary.
-
Click Create.
Note
When working with the uploaded data, make sure that at least one attribute is specified in it to build a graph on the widget.
Parameters
General widget settings
Parameter |
Description |
---|---|
Widget name | Widget name. |
Layer | Data layer that is used to build a graph on the widget. |
Description | Text description of the widget. You can format the text: customize headings; make the text bold, italic, or underline the text; add a link; select the text color from the palette or specify it in RGB, HSL, or HEX format. |
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 that is used to group data on the graph. Displayed on the X-axis. |
Step size | Fixed size of data ranges. |
Number of values | For text grouping attributes only (for this attribute type you can use a column chart instead of histogram). The number of vertical bars that are displayed on the graph: the top 5 or top 10 values from the sample. The top values are calculated based on the aggregation attribute. |
Show other | For text grouping attributes only (for this attribute type you can use a column chart instead of histogram). The last bar on the graph shows the sum of the last value in the top and the remaining values in the sample below this position. The top values are calculated based on the aggregation attribute. |
Color
Parameter |
Description |
---|---|
Color | Different color settings are available, depending on the type of grouping attribute (text or numeric):
|
Legend
Parameter |
Description |
---|---|
Show legend | For text grouping attributes (for this attribute type you can use a column chart instead of histogram). Shows the values of the grouping attribute and the corresponding values of the aggregation attribute. |
Values in percentage | For text grouping attributes (for this attribute type you can use a column chart instead of histogram). Shows the values of the aggregation attribute as a percentage. |
Appearance of the graph
Parameter |
Description |
---|---|
Labels | Labels of attribute values on the X and Y axes. |
Axes | Axes on the graph. |
Grid | Grid on the graph. |
Additional settings
Parameter |
Description |
---|---|
Show source | Name of the data layer and the aggregation attribute. |
Show empty ranges | For numeric grouping attributes only. Shows on the graph the ranges of values without data. |
Total objects in the asset | Number of objects in the sample that is used to calculate the values. |
What's next?
- Get to know more about other Widgets types.
- See available Operations with widgets.
- Quick start.
- Get to know how to work with Data and Data visualization.
- Get to know more about Layers and Dashboards.
- Get to know prepared Analytics presets.