Line graph | Urbi Pro | Urbi Documentation
Urbi Pro

Line graph

A line graph displays the change in a data attribute value depending on a certain parameter as a polygonal chain. The values ​​are displayed as dots and connected by line segments.

Use a line graph to show the dynamics of the value change.

Case example: show the change in the car traffic per hour during the day:

Line graph showing car traffic
  • The X-axis displays groups of data values. As a grouping attribute, you can select:

    • Text attributes: for example, firm category, building purpose, and others.
    • Numeric attributes: for example, number of reviews, building area, and others. To display data as a polygonal chain, specify the number of ranges and their limits in the Number of ranges field when creating a widget or editing it. You can set up ranges of different sizes. The specified upper (right) limit is not included in the range.
  • The Y-axis displays aggregated values ​​for each group. Aggregation is performed within one group or range. As an aggregation attribute, you can select:

    • Number of objects: to count the number of values ​​in a group or range.
    • Numeric attributes: to count the value of this attribute within each group using aggregation functions: total, mean, minimum, maximum value, median, and percentile.
  • Instead of a line graph, you can use an area chart that contains a filled area below the graph.

  • 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 line graph
  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 Line graph widget type.

  6. Specify the required parameters:

    • Layer: data layer used to build a graph in 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 data 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).
    • Aggregation attribute: attribute used to aggregate data and calculate the values. If you want to display only the number of values, select Number of objects.
    • Aggregation type: function used to calculate aggregation attribute values. Aggregation is performed within each group or range of data.
  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 build a graph.

Parameter
Description
Widget name Widget name.
Layer Data layer used to build a graph in the widget.
Change widget type Click to select another widget type from the list. The configured widget parameters are saved.
Parameter
Description
Grouping attribute Attribute used to group data on the graph. Displayed on the X-axis.
Grouping attribute value The number of dots that are displayed on the graph. As values, you can select the following:
  • Any attribute values ​​from the data sample. When you modify the sample, the available attribute values are also changed. You can change the order of the dots on the graph if necessary.
  • The top 5 or top 10 values ​​from the data sample that are automatically calculated based on the aggregation attribute. To display the sum of the last value in the top and the remaining values ​​in the sample below this position in the last dot on the graph, select the Show other checkbox.

For text grouping attributes only.
Number of ranges The number of ranges (dots) that are displayed on the graph. The available number of ranges depends on the data, the maximum number is 10. Ranges are calculated automatically, but you can set them manually by entering the required range limits. The specified upper (right) limit is not included in the range.

To add a range, click Plus icon. To delete a range, click Trash icon. To recalculate ranges after configuration, click Recalculate ranges.

For numeric grouping attributes only.
Parameter
Description
Aggregation attribute Number of objects or a numeric attribute used to aggregate data on the graph. Aggregation is performed within each group or range of data. Displayed on the Y-axis.
Aggregation type Function used to calculate aggregation attribute values in each group or range of data:
  • 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.
Parameter
Description
Color Selecting a color according to which dots and a line of the graph are colored. You can select a color from the palette or specify it in HEX format.
Parameter
Description
Text Text displayed in the widget above the graph. 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.
Parameter
Description
Show axis titles Shows the labels of the X and the Y axes on the graph. 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 graph.
Grid Shows a grid on the graph.
Parameter
Description
Type of scale Distribution type used to calculate data ranges in the widget:
  • 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 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 graph the ranges of values ​without data.
For numeric grouping attributes only.
Total value Shows the sum of the values ​​of the aggregation attribute in the sample.
Mean value Shows the mean value of the aggregation attribute in the sample.
Minimum value Shows the minimum value of the aggregation attribute in the sample.
Maximum value Shows the maximum value of the aggregation attribute in the sample.
Median value Shows the median value of the aggregation attribute in the sample.
80th percentile Shows the 80th percentile value of the aggregation attribute in the sample.
95th percentile Shows the 95th percentile value of the aggregation attribute in the sample.
99th percentile Shows the 99th percentile value of the aggregation attribute in the sample.
Total objects in the asset Shows the number of objects in the sample used to calculate the values.