Holistics Docs - End-to-End Business Intelligence Platform

Holistics Documentation

Welcome to the Holistics Documentation page. You'll find comprehensive guides and documentation to help you start working with Holistics as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started

Geo Map (Beta)

Map concept

A map is the best way to analyze your data geographically and answer spatial questions.

You might want to resort to a map when you're asking: "What's the landscape like near the stores with the highest revenue?" or "Which states of the US have the highest number of COVID-19 cases?"

Number of COVID-19 cases in the US - Data source: The New York Times

Holistics map components

In Holistics, a map comprises of 2 components:

  • A base map: A base map is a layer with basic geographical information (streets, lakes, buildings...) that serves as a background setting for your analytical data. The base map alone does not provide any analytical information. Holistics uses OpenStreetMap as our base map.
  • A data layer: A data layer is the visualization of your raw data that sits on top of the base map and creates a full picture to answer your spatial questions. For example, we have the world map below as the base map, and each country has a different color based on its population (those with population >50m will be red). The colored shape (that aligns the country border) is the data layer in this case. Holistics uses LeafletJS to draw these data layers.

Required and optional fields

To create a map, the compulsory field is the Location field. This field will accept your location field's value as input.

Your location data can be in the form of full name or code (read more: Supported location formats). We are working to support more formats like longitude-latitude (for Point Map and Heat Map)

Under the Location field, you might see Add location settings. Clicking on this will present you with a Location type field where you assign a geographical role to the current location data (read more: How to improve map precision in Holistics)

Other fields are required or optional based on the type of map you are setting:

  • Legend (only required for Distribution map): Provide more dimensional information for a location. Legend accepts a dimension's value as its input. The best scenario is when your dataset has one unique legend per location. If your dataset has more legends per location, Holistics will display the first one in the generated table data, which might not correctly convey the map's meaning.
  • Value (only required for Choropleth map): Provide a statistical meaning to your map. Value accepts a measure's value as its input.
  • Condition (optional): Help you filter your data and only see the locations that match the conditions (i.e. only see countries from continent Europe)

Map settings

Holistics supported map

In Holistics we support 2 main types of map:

  • Filled Map (Beta)
  • Point Map: (Coming soon)

Also, we will be supporting Combined Map (where you can use both Filled Map and Point Map at the same time) in the near future.

1. Filled Map

Filled Maps are maps that have polygon shapes often defined by the geographical borders (i.e. country's border, state's border), and each shape will contain a different color based on the value it carries.

In Holistics we support 2 sub-categories of Filled Map based on the fields required to set up those maps: Choropleth and Distribution Map.

Choropleth Map (Beta)

Choropleth Maps are Filled maps but the regions are colored based on a numerical value, most typically ratio data like per-capita income or population density.

More specifically, choropleth maps use color progression to represent the spatial difference, most common of which is a single hue progression (as in the image below) or a transition from a color to another.

Choropleth Maps require at least one Location field and one Value field. Learn how to set up Choropleth Maps here.

Creating a Choropleth Map in Holistics

Distribution Map (Coming soon)

Distribution Maps are Filled maps but the regions are colored based on the presence of a subject such as a living species (i.e. the habitat of the Rusty Blackbird - image a), or human (i.e. supporters of Trump and Hilary - image b)

In Distribution Maps, each subject will carry a differentiated color.

Distribution Maps require at least one Location field and one Legend field. The Legend field has the data of the subjects.

2. Point Map (Coming soon)

Point maps plot geographic latitude/longitude data to visualize the location of data on a map. The point is identified by either a value or a subject, and depending on the visualization of the point we divide Point Map into 2 sub-categories: Bubble Map and Heat Map.

Bubble Map (Coming soon)

Bubble Maps are Point Maps where points on the map are visualized by circles (or bubbles). The bubbles can communicate information using both their size and color.

Heat Map (Released)

Heat Maps are Point Map where points on the map are not visualized by concrete circles, but rather areas of color. The color reflects the concentration of data clusters in a given area.

Learn more about how to create a Heat Map here.

Updated on 11th August 2020: We are revamping the current Heat Map to be more powerful, customizable, and fit to the new map design. If you are already using Holistics Heat Map, you might see some changes in the upcoming weeks.

Updated about a month ago

Geo Map (Beta)


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.