All Products
Search
Document Center

DataV:The ECharts Heatmap

Last Updated:Nov 06, 2023

This topic describes the chart style and configuration panel of the Echarts heatmap.

Chart Style

image

Configuration Panel image

  • Search Configuration: Click Search Configuration in the upper-right corner of the Configuration panel. In the Search Configuration panel, enter the name of the configuration items that you want to search for to quickly locate the configuration items. Fuzzy match is supported. For more information, see Search for asset configurations.

  • Size: indicates the size of a widget, including its pixel width and height. You can click the 锁定长宽比按键icon to lock the aspect ratio of the widget and modify the width and height of the widget in equal proportion. After you click this icon again, you can adjust the width and height as needed.

  • Position: the position of a widget, which is indicated by pixel X and Y coordinates. X-coordinate indicates the pixel distance between the upper-left corner of the widget and the left border of the canvas. Y-coordinate indicates the pixel distance between the upper-left corner of the widget and the upper border of the canvas.

  • Rotation Angle: the angle of a rotation that uses the center point of a widget as the rotation point. The unit is degrees (°). You can use one of the following methods to control the rotation angle of a widget:

    • Directly enter the degrees in the Rotation Angle spin box or click the plus sign (+) or minus sign (-) to increase or decrease the value in the Rotation Angle spin box.

    • Drag the 圆圈旋转控制图标black dot in the icon to control the rotation angle of the widget.

    • Click the 左右翻转图标icon to flip the widget style.

    • Click the 上下翻转图标icon to flip the widget style.

  • Opacity: Valid values: 0 to 1. If this parameter is set to 0, the widget is hidden. If this parameter is set to 1, the widget is completely displayed. Default value: 1.

  • Grid: Click the Eye icon on the right to display the grid style. 网格

    • Left: the distance between the grid and the left border of the widget. Default value: 3%. The following types of input are supported:

      • The specific pixel value, for example, 20.

      • Percentage relative to the height and width of the container, such as 20%.

      • left, center or right, the components are automatically aligned according to the corresponding position.

    • Top: the distance between the grid and the upper border of the widget. Default value: 60. The following types of input are supported:

      • The specific pixel value, for example, 20.

      • Percentage relative to the height and width of the container, such as 20%.

      • left, center or right, the components are automatically aligned according to the corresponding position.

    • Right: the distance between the grid and the right border of the widget. Default value: 4%. The following types of input are supported:

      • The specific pixel value, for example, 20.

      • Percentage relative to the height and width of the container, such as 20%.

      • left, center or right, the components are automatically aligned according to the corresponding position.

    • Bottom: the distance between the grid and the lower boundary of the widget. Default value: 3%. The following types of input are supported:

      • The specific pixel value, for example, 20.

      • Percentage relative to the height and width of the container, such as 20%.

      • left, center or right, the components are automatically aligned according to the corresponding position.

    • Width: the width of the grid. Default value: auto. The width is adaptive.

    • Height: the height of the grid. Default value: auto.

    • Adaptive Layout: If you select this check box, the histogram is used to adapt the layout. If you clear this check box, the histogram is used to adapt the layout.

    • Background Color: Modify the background color of the mesh. By default, the background color is transparent. For more information, see the color picker description.

    • Border Color: Modify the border color of the grid. The default color is transparent. For more information, see color picker description.

    • Border Size: Click + or-, or enter a value to adjust the border size.

  • X Axis: Click the Eye icon to display the X axis. x轴

    • Displacement: the offset of the x-axis from the default position. The default value is 0.

    • Name: the name of the x-axis.

    • Position: the position of the name on the x-axis. You can select Start, Center, or End. Default value: End.

    • Name Style

      • Color: Modify the color of the name text on the x-axis. For more information, see color picker description.

      • Font Style: the font style of the name on the x-axis.

      • Font weight: the font weight of the name on the x-axis.

      • Font: the font family of the name on the x-axis.

      • Font Size: Click + or-, or enter a value to modify the font size of the name on the x-axis.

    • Name Interval: Click the + or-sign or enter a value to change the distance between the axis and the axis.

    • Rotate Name: Click the + or-sign or enter a value to change the rotation angle of the axis name.

    • Reverse: If you select this check box, the axes are displayed in the reverse direction. If you clear this check box, the axes are displayed in the forward direction.

    • Minimum Value: the minimum value of the axis scale. The default value is Minimum Data Value, which indicates that the minimum value of data on the axis is used as the minimum scale. If you do not set this parameter, the minimum value is automatically calculated to ensure the even distribution of the scale of the axis.

    • Maximum Value: the maximum value of the scale on an axis. The default value is Maximum Data Value. This value indicates that the maximum value of data on the axis is used as the maximum scale. If you do not set this value, the maximum value is automatically calculated to ensure the even distribution of the axis scale.

    • auto scaling: When selected, the coordinate scale does not forcibly include a zero scale. This parameter is valid only in the value axis. This configuration items is invalid after the maximum and minimum values are set.

    • segments: Click the + or-sign, or enter a value to set the segments of the axis. If you do not set this parameter, the minimum value is automatically calculated to ensure the even distribution of the scale of the axis. It should be noted that this segments is only an estimated value, and the number of segments actually displayed will be adjusted on this basis according to the legisibility of the axis scale display after segmentation. The error message is invalid in the category axis.

    • Minimum Interval Size: Click + or-, or enter a value to specify the minimum interval between axes. For example, it can be set to 1 ensure that the coordinate axis division scale is displayed as an integer. Valid only in the value axis or time axis.

    • Axis: Click the eye icon on the right to display the x-axis.

      • On Zero: indicates whether the axis of the x-axis or y-axis is on the zero scale of the other axis. This field is valid only when the other axis is a value axis and contains the zero scale.

      • Axis Style

        • Color: Modify the color of the x-axis line by referring to the color picker description.

        • Width: Click + or-, or enter a value to modify the width of the x-axis.

        • Type: the type of the x-axis line separator axis. Optional. Valid values: Solid lines and Dashed lines.

        • Opacity: Click the + or-sign or enter a value to modify the transparency of the x-axis. The range is [0,1].

    • Scale: Click the Eye icon on the right to display the scale on the x-axis.

      • Align with Labels: If you select this check box, the tick marks are aligned with the labels. If you select Leave blank in the category axis, this field takes effect.

      • interval: Click the + or-sign, or enter a number manually to modify the display interval of the axis scale. This is valid in category axes.

      • Internal: If you select this check box, the axis scale faces inward. If you clear this check box, the axis scale faces outward.

      • Length: Click the + or-sign or enter a number to modify the length of the scale.

      • Axis Style

        • Color: Modify the color of the tick marks by referring to the color picker description.

        • Width: Click the + or-sign or enter a value to modify the width of the tick mark.

        • Type: the type of the axis. Optional. Valid values: Solid lines and Dashed lines.

        • Transparency: Click the + or-sign or enter a value to modify the transparency of the tick marks. The range is [0,1].

    • Scale Labels: Click the Eye icon on the right to display the scale labels on the x-axis.

      • interval: The display interval of the scale labels on the axis. This parameter is valid in the category axis. By default, labels are displayed at intervals that do not overlap with each other. You can set it to 0 force all labels to be displayed. If you set this parameter to 1, one label is displayed every other label. If you set this parameter to 2, one label is displayed every other label.

      • Internal: If you select this check box, the axis labels face inward. If you clear this check box, the axis labels face outward.

      • Rotate: the rotation angle of the scale labels. If the category labels on the category axis cannot be displayed, you can rotate the scale labels to prevent them from overlapping. The angle of rotation ranges from -90 degrees to 90 degrees.

      • Outer Spacing: the distance between the scale label and the axis.

      • Show Minimum Label: If you select this option, the smallest scale label is displayed. By default, it is automatically determined that if the labels overlap, the smallest scale label will not be displayed.

      • Show Max Labels: If you select this option, the largest scale label is displayed. By default, the maximum scale label is not displayed if the labels overlap.

      • Text Style

        • Color: Modify the color of the scale labels for the axes. For more information, see color picker description.

        • Font Style: the font style of the axis labels.

        • Font weight: the font weight of the axis label text.

        • Font: the font family of the axis label text.

        • Font Size: the font size of the axis scale label text.

        • Alignment: the horizontal alignment of the scale label text on the axis. Default value: Auto. Optional. Auto, Left Alignment, Center Alignment, and Right Alignment are supported.

        • Alignment: Optional. Valid values: Top Alignment, Center Alignment, and Bottom Alignment.

    • line separator: Click the eye icon on the right to display the line separator.

      • interval: Click the + or-sign, or enter a number manually to modify the display interval of the axis separation line. This parameter is valid in the category axis. By default, the line separator is displayed at line separator non-overlapping policy intervals. You can set 0 to force all line separator to be displayed. A value of 1 indicates that every line separator displays a line separator. A value of 2 indicates that every two line separator displays a line separator.

      • Axis Style

        • Width: Click the + or-sign or enter a value to modify the width of the line in the x-axis line separator.

        • Type: the type of the x-axis line separator axis. Optional. Valid values: Solid lines and Dashed lines.

        • Transparency: Click the + or-sign or enter a value to modify the transparency of the line separator on the x-axis. The value ranges from 0 to 1.

    • Split Area: Click the Eye icon on the right to display the split area.

      • interval: Click the + or-sign, or enter a number manually to modify the display interval of the axis separation area. This parameter is valid in the category axis. By default, the split area is displayed at a non-overlapping interval. It can be set to 0 force all the divided regions to be displayed. If the value is set to 1, one split region is displayed every other split region. If the value is set to 2, one split region is displayed every two split regions.

      • Area Style

        • Transparency: Click the + or-sign or enter a value to modify the transparency of the split area. Valid values: 0 to 1.

    • Axis Indicator: Click the Eye icon to display the axis indicator.

      • Type: the type of the indicator. Valid values: Line Indicator and Shadow Indicator.

      • Automatic Adsorption: If you select this check box, the axis indicator is automatically adsorbed to the point. This function is more meaningful on the numerical axis and the time axis, and can automatically find small numerical points.

      • Initial Value: the initial position of the axis indicator. The default value is 0.

      • Status: the current status of the axis indicator. If you select the check box, the indicator is displayed. If you clear the check box, the indicator is hidden.

      • Label: Click the Eye icon on the right to display the label of the axis indicator.

        • precision: the decimal point precision of the value in the text label. By default, the value is automatically determined based on the value of the current axis. You can also specify an integer value, such as 2, which indicates that two decimal places are retained.

        • Outer Spacing: If you select this option, there is a certain distance between the axis indicator label and the axis. If you clear the check box, there is no spacing between the axis indicator label and the axis.

        • Text Style

          • Color: Modify the color of the axis indicator label text. For more information, see color picker description.

          • Font Style: the font style of the axis indicator label text.

          • Font weight: the font weight of the axis indicator label text.

          • Font: the font family of the axis indicator label text.

          • Font Size: the font size of the axis indicator label text.

        • Background Color: the background color of the axis indicator text label.

        • Border Color: the border color of the axis indicator text label.

        • Border Width: the border thickness of the axis indicator's text label.

      • Axis Style

        • Color: Modify the color of the axis by referring to the color picker description.

        • Width: Click the + or-sign or enter a value to modify the width of the axis line.

        • Type: the type of the axis. Optional. Valid values: Solid lines and Dashed lines.

        • Opacity: Click the + or-sign or enter a value to modify the transparency of the axis. The range is [0,1].

      • Drag Handle: Click the Eye icon on the right to display the drag handle.

        • Size: Click the + or-sign or enter a value to modify the size of the drag handle.

        • Outer Spacing: Click the + or-sign or enter a value to change the distance between the center point and the axis of the drag handle.

        • Color: the color of the drag handle.

        • Refresh Frequency: The update cycle of the large screen is triggered when the handle is dragged. Unit: milliseconds. If you increase the value, the performance is improved but the experience is reduced.

  • Y Axis: For more information, see X Axis.

  • Visual Mapping: Click the Eye icon on the right to display visual mappings. 视觉映射

    • Minimum Value: Enter a value or select Minimum Value to change the minimum value of the visual mapping.

    • Maximum Value: Enter a value or select Maximum Value to modify the maximum value of the visual mapping.

    • Visual Elements: Click the 加号图标or 垃圾桶图标icon on the right to add or remove a color style. Click the 横排列图标or 竖排列图标icon to configure the arrangement style of multiple color styles. Click the 复制图标icon to copy the selected color style configuration and add a new color style.

    • Drag Handle: Click Eye to display the drag handle style.

    • Real-time: If you select this check box, the real-time display is displayed. If you clear this check box, the real-time display is not displayed.

    • Reverse: If you select this check box, the image is displayed in the reverse direction. If you remove this check box, the image is displayed in the forward direction.

    • precision: You can enter a value or click the + or-sign to change the value of the visual mapping precision.

    • Width: Enter a value or click the + or-sign to change the width of the graphic.

    • Graphic Height: You can enter a value or click the + or-sign to change the height of the graphic.

    • Alignment: Select an alignment mode from the drop-down list. The following options are available: Auto, Align Left, Align Center, and Align Right.

    • Hover Link: If you select this check box, the hover link is displayed. If you clear this check box, the hover link is not displayed.

    • Left: specifies the percentage of data on the left side of the visual map. Default value: auto.

    • Top: You can automatically enter the specific data percentage at the top of the visual map. The default value is auto.

    • Right: specifies the percentage of data on the right side of the visual map. Default value: auto.

    • Bottom: You can automatically enter the specific data percentage at the bottom of the visual map. The default value is auto.

    • Orientation: Select an orientation style from the drop-down list. Valuable values include Horizontal and Vertical.

    • Pin: You can enter a value or click the + or-sign to change the value of the inner margin of the visual mapping.

    • Background Color: Modify the background color of the visual map. For more information, see color picker description.

    • Border Color: Modify the border color of the visual map. For more information, see color picker description.

    • Border Size: Click + or-, or enter a value to modify the border thickness of the visual map.

    • Text Style

      • Color: Modify the color of the visual mapping text style by referring to the color picker description.

      • Font Style: The font style of the visual mapping. Default value: normal.

      • Font weight: You can enter the font weight of the visual mapping. Default value: normal.

      • Font: You can automatically enter the specific content of the visual mapping font. Default value: sans-serif.

      • Font Size: You can enter a value or click + or-to change the font size of the visual mapping text.

  • dialog box: Click the eye icon on the right to display the dialog box. 提示框

    • Trigger Condition: the type of the trigger. This parameter is optional. You can select Mouse Move Trigger, Mouse Click Trigger, and Mouse Move and Click Trigger.

    • Background Color: Change the background color of the dialog box. For more information, see color picker description.

    • Border Color: Modify the border color of the dialog box. For more information, see color picker description.

    • Border Size: Click + or-, or enter a value to modify the border thickness of the background frame.

    • Pin: Click the + or-sign, or enter a number manually to modify the inner margin of the background frame. Unit: pixels. The default inner margin is 5.

    • Text Style

      • Color: Modify the color of the dialog box text. For more information, see color picker description.

      • Font Style: dialog box the font style of the text.

      • Font weight: dialog box the font weight of the text.

      • Font: dialog box the font family of the text.

      • Font Size: dialog box the font size of the text.

  • Graphic Elements 图形元素

    • Blur Size: Click the + or-sign or enter a value to modify the blur size of the graphic element.

    • Minimum Transparency: Click the + or-sign or enter a value to modify the minimum transparency of the graphic element.

    • Maximum Transparency: Click the + or-sign or enter a value to modify the maximum transparency of the graphic element.

    • Static: If you select this check box, static tags cannot be used.

    • Labels

      • Normal Items: Click the Eye icon on the right to display the label text of normal items (columns that do not respond to mouse events).

        • Text Style

          • Color: Modify the color of the common item label text. For more information, see color picker description.

          • Font Style: the font style of the label text.

          • Font weight: the font weight of the label text.

          • Font: the font family of the label text.

          • Font Size: the font size of the label text.

      • Key Items: Click the Eye icon on the right to display the label text of the key item (the column that responds to mouse events).

        • Text Style

          • Color: Modify the color of the major item label text. For more information, see color picker description.

          • Font Style: the font style of the key item label.

          • Font weight: the font weight of the highlight label text.

          • Font: the font family of the highlight label text.

          • Font Size: the font size of the key item label.

Data tab

数据

Configuration field description

Column

Description

x

Used to configure the category of each x-axis in the heat map, that is, the value of the x-axis.

y

Used to configure the category of each y-axis in the heat map, that is, the value of the y-axis.

value

Used to configure values for each heatmap in the heatmap.

Interaction tab

No interaction event is configured for this widget.

Configure interactions in Blueprint Editor

  1. In Canvas Editor, right-click a widget and select Export to Blueprint Editor.

  2. Click the 蓝图图标icon in the upper-left corner.

  3. In Blueprint Editor, click heatmap in the Added Nodes pane. You can view the heatmap parameters in the canvas, as shown in the following figure. image

    • Events

      Events

      Description

      When the data interface request is completed

      The event is triggered with the processed JSON data after a data interface request is responded and processed by a filter. For more information about specific data examples, see the Data Response Result section of the Data tab in the right-side configuration panel of the canvas editor.

      When a data interface request fails

      The event that is returned when a data interface request fails (such as network problems or interface errors) and is processed by the filter. The event also throws the processed JSON data. For more information about specific data examples, see the Data Response Result section of the Data tab in the right-side configuration panel of the canvas editor.

      When a data item is clicked

      The event that is raised when the heatmap graph is clicked, along with the corresponding data item.

      When the visual mapping changes

      The event that is raised when a heatmap visual map is clicked, along with the corresponding data item.

    • action

      Action

      Description

      Request Data Interface

      This action is performed to request the server data again. The data sent by an upstream data processing node or layer node is used as a parameter. For example, heatmap the API data source is https://api.test and the data transferred to the request data interface is { id: '1'}, the final request interface is https://api.test?id=1.

      Import data

      After data of a widget is processed in accordance with its drawing format, the widget is imported for redrawing. You do not need to request server data again. For more information about specific data examples, see the Data Response Result section of the Data tab in the right-side configuration panel of the canvas editor.

      Highlight

      The input data of the action is of the object type. The parameters include seriesName (series name), seriesIndex (series index), dataIndex (data index), and name (data name). Sample data:

      {  
          "seriesName": "",  
          "seriesIndex": 1,  
          "dataIndex": 1,  
          "name": ""
      }

      Unhighlight

      The input data of the action is of the object type. The parameters include seriesName (series name), seriesIndex (series index), dataIndex (data index), and name (data name). Sample data:

      {  
          "seriesName": "",  
          "seriesIndex": 1,  
          "dataIndex": 1,  
          "name": ""
      }

      Display dialog box

      The input data of the action is of the object type. The parameters include dataindex (data index), name (data name), x (x-axis position), and y (y-axis position). Sample data:

      { 
          "dataIndex": 1,  
          "name": "",  
          "x": 1,  
          "y": 1
      }

      Hide dialog box

      Hide dialog box, no parameters required.

      Visual Mapping Range

      The input data of the action is of the object type, and the parameter is selected (segmented object).

      Note

      The continuous type is an array that represents a range of values; the discrete type is an object, and the key value is the index of the category or segment.

      Update component configurations

      Style configurations of widgets are dynamically updated. In the Configuration panel, click Copy Configuration to Clipboard to obtain the configuration data of the component. After that, change the style field for the data processing node in Blueprint Editor.

      Display

      The following example shows the widget.

      return{
        "animationType": "",
        "animationDuration": 1000,
        "animationEasing": "linear"
      }

      Hide

      The following example shows how to hide a widget:

      return{
        "animationType": "",
        "animationDuration": 1000,
        "animationEasing": "linear"
      }

      Switch to the implicit state

      The following example shows whether to show or hide a widget.

      return {
        "animationIn": {
          "animationType": "",
          "animationDuration": 1000,
          "animationEasing": "linear"
        },
        "animationOut": {
          "animationType": "",
          "animationDuration": 1000,
          "animationEasing": "linear"
        }
      }

      Move

      Move a widget to a specified location. The following example shows the reference data.

          return{      
            // The positioning type. to indicates absolute positioning, whereas by indicates relative positioning. The default value is to. 
              "positionType": "to",
            // The location, which is indicated by the x and y coordinates. 
            "attr": {
              "x": 0,
              "y": 0
            },
            // The animation type. 
            "animation": {
              "enable": false,
              // The duration in which animation is displayed. 
              "animationDuration": 1000,
              // The animation curve, which can be set to linear|easeInOutQuad|easeInOutExpo. 
              "animationEasing": "linear"
            }
          }