Isosurface layer (v2.x)

Updated at:

The Isosurface Layer is a sub-component of the Basic Flat Map. It generates a raster area map from vector point data for display on a large screen. For example, you can use this component to interpolate a real-time air quality map for a country, meeting the visualization needs of industries like meteorology. This document describes the configuration parameters for the Isosurface Layer.

Important

This document describes the Isosurface Layer sub-component v2.x. For information about v1.x, see Isosurface Layer (v1.x).

Click Isosurface Layer under Sub-component Management to go to the configuration panel and configure the style and data of the Isosurface Layer.

Note

If the Isosurface Layer is not displayed in the Sub-components panel, it means you have not added the Isosurface Layer sub-component. See Map Container (v2.x) to add it.

Configuration

配置

  • Search for Configurations: In the right-side panel of Canvas Editor, click the Settings tab, and click Search for Configurations in the upper-right corner. Enter the required configuration item in the search box, and click the search icon to quickly locate the configuration item. Fuzzy match is supported. For more information, see Search for Configurations.
  • Visible level: Sets the zoom level range in which the Isosurface Layer is visible. The layer is hidden outside this range.

  • Opacity: Sets the opacity of the Isosurface Layer.

  • Pixel size: The size of each grid cell in the raster area map, in pixels. The value can range from 1 to 10. A smaller size creates a sharper layer but increases rendering time. A larger size creates a more blurred layer but reduces rendering time.

  • Weight: The influence of an interpolated point on its surroundings. The value can range from 0.5 to 3. A higher weight creates a stronger influence and better rendering quality, but increases rendering time.

  • Rendering method: Specifies the rendering method of the Isosurface Layer. The system provides two methods: linear rendering and staged rendering.

    • Linear rendering

      Parameter

      Description

      Break value

      The break value for linear rendering. Based on the break value that you set and the range of the value parameter, DataV obtains the interpolated point that corresponds to an intermediate value. The color of this point is the Middle Color that you set.

      Fill color

      The fill color includes Minimum color, Intermediate color, and Maximum color.

      • Minimum color: The color for interpolated points with the minimum value. For more information, see Color picker description.

      • Intermediate color: The color for interpolated points whose value is between the minimum and maximum values.

      • Maximum color: The color for interpolated points with the maximum value.

      Number of categories

      Specifies the number of categories for the interpolated points. DataV divides the interpolated points into multiple categories based on the Number of Categories that you set and the range of the value parameter. Each category is assigned a different color. A greater Number of Categories results in a better interpolation effect, but increases the rendering time.

    • Staged rendering

      Parameter

      Description

      Break value

      The break value for linear rendering. DataV combines the break value that you set with the range of the value parameter to obtain the interpolated point that corresponds to an intermediate value. The color of this point is the Middle Color that you set.

      Default color

      This color applies to points whose value falls outside the configured segment ranges.

      Color by segment

      Click the 加号图标 or 垃圾桶图标 icon to add or delete a segment. Click the 横排列图标 or 竖排列图标 icon to reorder the segments.

      • Segment range: The value range for the segment. You can adjust this based on the range of the value field in your data.

      • Segment color: The color for interpolated points whose value falls within the specified Segment Range.

Data

  • Interpolated point data API等值面层插值点数据V2.X For an example, see the Sample JSON code.

    Table 1. Field descriptions

    Field

    Description

    lng

    The longitude of the interpolated point.

    lat

    The latitude of the interpolated point.

    value

    The value of the interpolated point. DataV uses this value and the configured rendering parameters to adjust the layer's rendering effect.

  • Clip boundary data API等值面层裁剪面数据v2.x

    For an example, see the Sample JSON code.

    The clip boundary defines the rendering area for the interpolated points. For example, the clip boundary data can define the map of China as the rendering area.

Parameter

Description

Controlled mode

When enabled, the component does not request data upon initialization. Data requests must be triggered by callback IDs or methods configured in the Blueprint Editor. When disabled, you can use automatic update requests. This option is disabled by default.

Automatic update request

Enables dynamic polling and lets you set the polling frequency. If disabled, data is not updated automatically. You must manually refresh the page or trigger an update by using the Blueprint Editor or a callback ID event.

Data source

Click Configure Data Source to open the Set Data Source panel. In this panel, you can change the data source type and query code, preview the returned data, and view the data response. For more information, see Configure asset data.

Data filter

A data filter lets you transform the data structure, filter data, and perform simple calculations. Click Add Filter to configure a data filter script in the Set Data Source panel. For more information, see Use data filters.

Data response

Displays the response from the data request. When the data source changes, click the 刷新图标 icon on the right to view the real-time data response.

Interaction

This component does not have interactive events.

Blueprint editor interactions

  1. In the Canvas Editor, click the 导出到蓝图编辑器 icon to the right of Isosurface Layer in the sub-component list under Basic Flat Map.

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

  3. On the Blueprint Editor page, click the Isosurface Layer component in the import node pane. The component's Blueprint Editor parameters appear on the canvas, as shown in the following figure.等值面层蓝图编辑器参数 v2.x

    • Events

      Event

      Description

      When the interpolated point data API request is successful

      Triggered after the response to an interpolated point data request is received and processed by a data filter. It emits the processed data in JSON format. For a data sample, see the Data response section on the Data tab of the component's configuration panel in the Canvas Editor.

      When the clip boundary data API request is successful

      Triggered after the response to a clip boundary data request is received and processed by a data filter. It emits the processed data in JSON format. For a data sample, see the Data response section on the Data tab of the component's configuration panel in the Canvas Editor.

      When the interpolated point data API request fails

      If a data API request for interpolated points fails (for example, due to network issues or API errors), an event is thrown after the response is processed by a filter, returning the processed data in JSON format. For a data sample, see the Data tab in the Data Response area of the configuration panel to the right of the component in the Canvas Editor.

      When the clip boundary data API request fails

      This event is thrown when a data interface request for the clip boundary fails, for example, due to network issues or interface errors. The event is triggered after the failed response is processed by a filter and provides the processed data in JSON format. For a specific data example, see the Data Response Result area on the Data tab of the configuration panel in the Canvas Editor.

    • Actions

      Action

      Description

      Request interpolated point data

      Resends a request to the server. Data from an upstream data processing node or layer node is appended to the request as parameters. For example, if the API data source is configured as http://api.test and the data { id: '1'} is passed to the Request interpolated point data action, the final request URL will be http://api.test?id=1.

      Request clip boundary data

      Resends a request to the server. Data from an upstream data processing node or layer node is appended to the request as parameters. For example, if the API data source is configured as http://api.test and the data { id: '1'} is passed to the Request clip boundary data action, the final request URL will be http://api.test?id=1.

      Import interpolated point data

      Imports and processes data to redraw the layer without sending a server request. For a data sample, see the Data response section on the Data tab of the component's configuration panel in the Canvas Editor.

      Import clip boundary data

      Imports and processes data to redraw the layer without sending a server request. For a data sample, see the Data response section on the Data tab of the component's configuration panel in the Canvas Editor.

      Show

      Shows the component.

      Hide

      Hides the component.