HEAVY.AI Docs
v8.1.0
v8.1.0
  • Welcome to HEAVY.AI Documentation
  • Overview
    • Overview
    • Release Notes
  • Installation and Configuration
    • System Requirements
      • Hardware Reference
      • Software Requirements
      • Licensing
    • Installation
      • Free Version
      • Installing on Docker
        • HEAVY.AI Installation using Docker on Ubuntu
      • Installing on Ubuntu
        • HEAVY.AI Installation on Ubuntu
        • Install NVIDIA Drivers and Vulkan on Ubuntu
      • Installing on Rocky Linux / RHEL
        • HEAVY.AI Installation on RHEL
        • Install NVIDIA Drivers and Vulkan on Rocky Linux and RHEL
      • Getting Started on AWS
      • Getting Started on GCP
      • Getting Started on Azure
      • Getting Started on Kubernetes (BETA)
      • Upgrading
        • Upgrading HEAVY.AI
        • Upgrading from Omnisci to HEAVY.AI 6.0
        • CUDA Compatibility Drivers
      • Uninstalling
      • Ports
    • Services and Utilities
      • Using Services
      • Using Utilities
    • Executor Resource Manager
    • Configuration Parameters
      • Overview
      • Configuration Parameters for HeavyDB
      • Configuration Parameters for HEAVY.AI Web Server
      • Configuration Parameters for HeavyIQ
    • Security
      • Roles and Privileges
        • Column-Level Security
      • Connecting Using SAML
      • Implementing a Secure Binary Interface
      • Encrypted Credentials in Custom Applications
      • LDAP Integration
    • Distributed Configuration
  • Loading and Exporting Data
    • Supported Data Sources
      • Kafka
      • Using HeavyImmerse Data Manager
      • Importing Geospatial Data
    • Command Line
      • Loading Data with SQL
      • Exporting Data
  • SQL
    • Data Definition (DDL)
      • Datatypes
      • Users and Databases
      • Tables
      • System Tables
      • Views
      • Policies
      • Comment
    • Data Manipulation (DML)
      • SQL Capabilities
        • ALTER SESSION SET
        • ALTER SYSTEM CLEAR
        • DELETE
        • EXPLAIN
        • INSERT
        • KILL QUERY
        • LIKELY/UNLIKELY
        • SELECT
        • SHOW
        • UPDATE
        • Arrays
        • Logical Operators and Conditional and Subquery Expressions
        • Table Expression and Join Support
        • Type Casts
      • Geospatial Capabilities
        • Uber H3 Hexagonal Modeling
      • Functions and Operators
      • System Table Functions
        • generate_random_strings
        • generate_series
        • tf_compute_dwell_times
        • tf_feature_self_similarity
        • tf_feature_similarity
        • tf_geo_rasterize
        • tf_geo_rasterize_slope
        • tf_graph_shortest_path
        • tf_graph_shortest_paths_distances
        • tf_load_point_cloud
        • tf_mandelbrot*
        • tf_point_cloud_metadata
        • tf_raster_contour_lines; tf_raster_contour_polygons
        • tf_raster_graph_shortest_slope_weighted_path
        • tf_rf_prop_max_signal (Directional Antennas)
        • ts_rf_prop_max_signal (Isotropic Antennas)
        • tf_rf_prop
      • Window Functions
      • Reserved Words
      • SQL Extensions
      • HeavyIQ LLM_TRANSFORM
  • HeavyImmerse
    • Introduction to HeavyImmerse
    • Admin Portal
    • Control Panel
    • Working with Dashboards
      • Dashboard List
      • Creating a Dashboard
      • Configuring a Dashboard
      • Duplicating and Sharing Dashboards
    • Measures and Dimensions
    • Using Parameters
    • Using Filters
    • Using Cross-link
    • Chart Animation
    • Multilayer Charts
    • SQL Editor
    • Customization
    • Joins (Beta)
    • Chart Types
      • Overview
      • Bubble
      • Choropleth
      • Combo
      • Contour
      • Cross-Section
      • Gauge
      • Geo Heatmap
      • Heatmap
      • Linemap
      • Number
      • Pie
      • Pointmap
      • Scatter Plot
      • Skew-T
      • Table
      • Text Widget
      • Wind Barb
    • Deprecated Charts
      • Bar
      • Combo - Original
      • Histogram
      • Line
      • Stacked Bar
    • HeavyIQ SQL Notebook
  • HEAVYIQ Conversational Analytics
    • HeavyIQ Overview
      • HeavyIQ Guidance
  • HeavyRF
    • Introduction to HeavyRF
    • Getting Started
    • HeavyRF Table Functions
  • HeavyConnect
    • HeavyConnect Release Overview
    • Getting Started
    • Best Practices
    • Examples
    • Command Reference
    • Parquet Data Wrapper Reference
    • ODBC Data Wrapper Reference
    • Raster Data Wrapper Reference
  • HeavyML (BETA)
    • HeavyML Overview
    • Clustering Algorithms
    • Regression Algorithms
      • Linear Regression
      • Random Forest Regression
      • Decision Tree Regression
      • Gradient Boosting Tree Regression
    • Principal Components Analysis
  • Python / Data Science
    • Data Science Foundation
    • JupyterLab Installation and Configuration
    • Using HEAVY.AI with JupyterLab
    • Python User-Defined Functions (UDFs) with the Remote Backend Compiler (RBC)
      • Installation
      • Registering and Using a Function
      • User-Defined Table Functions
      • RBC UDF/UDTF Example Notebooks
      • General UDF/UDTF Tutorial Notebooks
      • RBC API Reference
    • Ibis
    • Interactive Data Exploration with Altair
    • Additional Examples
      • Forecasting with HEAVY.AI and Prophet
  • APIs and Interfaces
    • Overview
    • heavysql
    • Thrift
    • JDBC
    • ODBC
    • Vega
      • Vega Tutorials
        • Vega at a Glance
        • Getting Started with Vega
        • Getting More from Your Data
        • Creating More Advanced Charts
        • Using Polys Marks Type
        • Vega Accumulator
        • Using Transform Aggregation
        • Improving Rendering with SQL Extensions
      • Vega Reference Overview
        • data Property
        • projections Property
        • scales Property
        • marks Property
      • Migration
        • Migrating Vega Code to Dynamic Poly Rendering
      • Try Vega
    • RJDBC
    • SQuirreL SQL
    • heavyai-connector
  • Tutorials and Demos
    • Loading Data
    • Using Heavy Immerse
    • Hello World
    • Creating a Kafka Streaming Application
    • Getting Started with Open Source
    • Try Vega
  • Troubleshooting and Special Topics
    • FAQs
    • Troubleshooting
    • Vulkan Renderer
    • Optimizing
    • Known Issues and Limitations
    • Logs and Monitoring
    • Archived Release Notes
      • Release 6.x
      • Release 5.x
      • Release 4.x
      • Release 3.x
Powered by GitBook
On this page
  • Size Domain
  • Size Range
  • Mark Shape
  • Density Gradient
  • Chart Popup Information
  • Pointmap Example
  • Multilayer Geospatial Maps
  • Using Dimensions to Aggregate Results
  • Zoom and Select
  • Select
Export as PDF
  1. HeavyImmerse
  2. Chart Types

Pointmap

PreviousPieNextScatter Plot

Last updated 8 months ago

To learn more about pointmap charts and how to create one, please view this .

The Pointmap plots geographic latitude/longitude data to visualize the location of data on a map.

Features

Quantity

Notes

0

Dimensions are optional.

0-5

Longitude and latitude (or POINT defined by longitude and latitude) are required. Point size, color, and angle are optional. OmniSci stores POINT data as longitude first, and then latitude.

The Pointmap, by default, presents each record as an individual point on the map.

Size Domain

Size Domain sets the minimum and maximum bounds for the size measure. The size domain does not exclude values outside of those bounds from the dataset. The minimum value sets the smallest point size: any values lower than the minimum value uses the same point size. Maximum value sets the size of the largest point. For example, if you set the maximum Size Domain to 5,000, any value 5,000 or greater is shown the same size.

The practical effect of Size Domain is to reduce the impact of outliers and create a more informative map for the most meaningful range of values.

Size Range

Size Range represents sizes of the smallest and largest points on the map, measured in pixels. Points can range in size from 1 to 20 pixels. Note that if you set very large pixel values for the top of the range (for example, 20), the largest points might cover smaller points beneath them. Setting the size range is a balance between making it easy to spot large values while still displaying all significant information.

When POINT AUTOSIZE is turned on, when you zoom in to focus on an area of the map, the points become smaller, and can be difficult to see. If you turn off POINT AUTOSIZE and manually increase the POINT SIZE setting, you can enhance the visibility of the points on your map.

Mark Shape

Mark Shape lets you choose from a variety of shapes to use as data point markers in your Pointmap. Choosing the correct shape can make data values stand out more clearly, and help to differentiate values on layered charts.

Density Gradient

Chart Popup Information

When you hover over a Pointmap chart, a popup box appears that contains the column information for the highlighted area. You can copy this information to the clipboard. If the column information includes a URL, you can click the URL to open it in a browser.

Pointmap Example

Set the Lon measure to longitude and Lat measure to latitude. Set the Size measure to duration_seconds.

You can also use POINT data (generated from longitude/latitude) for LON and LAT; for example, column_9 contains point data:

When you select data of type POINT, Lon and Lat are both populated with the values for the point data:

Keep the defaults for THEME, # OF POINTS, SIZE DOMAIN, SIZE RANGE, and MARK SHAPE . Change the LAYER OPACITY to 75, and under POPUP BOX, click + ADD COLUMN and choose shape. Then, click Apply.

On the dashboard, you can compare the Pointmap, which can display detailed information for each sighting, versus a Choropleth, which displays only aggregate values (for example, total sightings) for a geographic region (for example, a state).

Multilayer Geospatial Maps

Using Dimensions to Aggregate Results

Instead of plotting every individual point in a dataset, you can aggregate your results using a dimension setting.

For example, the Pointmap chart below shows the location of hundreds of tweets in Santa Clara County, California.

When you add the dimension county_state, the map displays a single point representing the average of all the points in Santa Clara County and the total number of “tweets”. When you hover over the point, a pop-up box shows the average longitude and latitude, with a summary of the results. In the POPUP BOX section on the right side, you can adjust the popup box contents to change the formatting, and you can change the order that the measures appear by dragging them to the desired location in the measures list.

You can also filter the results of your aggregation. When you add a Dimension to your chart, the Filter On Aggregate field displays. Choose a field on which to filter your data (or create a custom dimension), then add the filter criteria. Only the records that meet your criteria are plotted on the chart.

For example, this Pointmap shows the origin points of flights that experienced a weather delay.

If you are not concerned with trivial delays, you can filter the aggregated results to show only the delays greater than 30 minutes.

Zoom and Select

Pointmap charts have additional features for zooming in and selecting details.

You can zoom in and out of a Pointmap chart in the following ways:

  • Using the mouse scrolling wheel.

  • Selecting an area by holding down the Shift key and using the mouse to select the zoom area.

  • Using the Zoom To box in the upper right of the map.

You can type the name of a geographic location (address, city, state, or country) and optional zoom level. For example, Denver, CO, !8 zooms to Denver, Colorado, with a zoom level of 8.

You can also enter latitude and longitude coordinates, and optional zoom level. For example, 39.26911, -76.54068, !9 takes you to Baltimore, MD, at zoom level 9.

Select

You can select geographic regions based on proximity or defined boundaries using the Circle, Polygon, and Lasso selection tools.

Circle Selector

Use the Circle tool to select an area around a specific central point. Click the Circle tool icon, then click anywhere on the map to create a circular selection.

To move the circle, click anywhere inside the selected area to select the circle. Drag the circle to the new location.

To resize the circle, click anywhere inside the selected area, then drag any of the white squares to scale the circle up or down.

Due to the distortion inherent in Mercator map projections, the circumference of the selection is reduced as you get closer to the equator, and increased as you approach the poles. In the example below, all of the areas are the same number of meters in diameter, with the size of the selection circle adjusted to allow for Mercator distortion.

Polygon Selector

Use the Polygon tool to select an area with noncomplex angles. Click to set each point. As you draw the selection, you can hold the Shift key to contrain each line to 45° angle increments relative to the previous line.

To complete the selection, do one of the following:

  • Double-click

  • Click the starting point a second time

  • Press Enter

To change the size of the selection, click anywhere in the selected region. Drag any of the white corner dots to resize the selection. Hold the Shift key to constrain the relative proportions of the selection. Hold the Alt key to scale the selection from the center.

To rotate the selection, mouse hover over any corner to display a curved arrow. Click and drag to rotate. Hold the Shift key to rotate in 45° increments.

To edit the endpoints in the selection, double-click anywhere in the region. Drag the white endpoints to new locations. To add an endpoint, click one of the small orange dots in the middle of a line segment; it becomes a new endpoint that you can drag to your desired position. To delete an endpoint, hold the Alt key and click the endpoint.

Note that if you create a selection where lines intersect the behavior is undefined and has unpredictable results.

Lasso Selector

Use the Lasso tool to trace around an area with curves or complex angles. Click to start, drag to draw the outline of your desired area, then release the mouse at any time to complete the selection with a straight line.

Once you have created your selection, the selection points are simplified, and the selection becomes effectively the same as a selection made with the Polygon tool.

Required

Required

Use Density Gradient to toggle density accumulation on and off. Density accumulation performs a count aggregation by pixel and allows you to color a pixel by normalizing the count and applying a color to it. For more information about density accumulation, see Density Mode in .

Create a new Pointmap. For the Data Source, use the official database of .

Pointmap and Geo Heatmap charts can be layered on top of one another to allow visual comparison of datasets. See .

video
Example: Vega Accumulator
UFO sightings
Creating Multi-layer Geospatial Charts
Dimensions
Measures