This article only applies to points data

This article is only relevant when working with points data, not when working with other (movement, time series, …​) data.

You can read more about the differences between the different data types in this article.

Overview

Uploading your points data files is a multistep process:

  1. Create a data set: a data set is the resource in which the platform saves your data

  2. Define the structure of your data: the platform needs to know how your data files will be structured. For example where the longitude and latitude values are stored and which other properties are important.

  3. Define the processing settings: before the platform can process your data, you need to tell how you want your data to be processed.

  4. Upload data: now that the platform has all the information, you can start uploading your data and the platform engine will process it.

New to data uploads ? Follow the tutorial !

There is a tutorial available where you go through the whole process of uploading your data to the platform. That is the best starting point for people trying to upload data for the first time. The tutorial describes how to upload movement data, but most of the steps to follow apply to points data as well.

The article you are currently reading and the articles it refers to provide more in-depth information compared to the tutorial, but they won’t guide you through the whole process.

Supported file types

The platform supports .csv and .parquet files for points data sets.

Creating a points data set

Before you can upload your files to a data set containing points data, you need to create an empty data set. How to do this is explained in this article.

Defining the structure of your data

The platform needs to know the structure of the files you are going to upload.

The data files only contain data, but don’t tell you anything about the format of the data. They don’t specify:

  • Which columns contain the location information

  • Which column contains the timestamp

  • Which columns contain properties you are interested in

  • Which columns contain information that can be ignored

  • CSV files don’t even contain information about how the data is stored: are it numbers or are it strings ?

  • …​

You will have to provide this information so that the platform knows how to interpret the data in the files. This is explained in the Configure data properties article.

Defining the processing settings: spatial resolution

To keep the platform responsive during analysis of your data, your original data gets processed.

One of the steps during processing is to divide the whole spatial range of your data set into different bins, and aggregate your data records in those bins.

The ideal size of those bins depends on both your accuracy needs during analysis and the accuracy with which the location data was recorded.

More details on these bins and how to configure them is available in the Configure the spatial resolution article.

Uploading your data files

Once everything is configured, uploading data is as straightforward as drag-and-dropping your files onto a widget. The data upload will start, and when the platform has received the files it will start processing them.

The upload data article provides more details on this.