This page guides you through the process of creating a dataset in Tilebox using the Tilebox Console.

Datasets

Learn about Tilebox datasets and how to use them.

Timeseries Datasets

Learn about Timeseries datasets, which link each data point to a specific point in time.

​
Creating a dataset in the Console

1

Navigate to the Create dataset form

Create a dataset in Tilebox by going to My datasets and clicking the Create dataset button.
2

Select a dataset kind

Choose a dataset kind from the dropdown menu. Required fields for the selected dataset kind are automatically added.
Tilebox Console
3

Specify a name, code name, and description

Complete these fields:
  • Name is the name of your dataset.
  • Code name is a unique identifier for the dataset within your team. It’s automatically generated, but you can adjust it if needed.
  • Description is a brief description of the dataset purpose.
Tilebox Console
4

Define the dataset schema

Specify the fields for your dataset.Each field has these properties:
  • Name is the name of the field (by convention it is recommended to be in snake_case).
  • Type is the data type of the field.
  • Array can be set to indicate that the field contains multiple values of the specified type.
  • Description is an optional brief description of the field. You can use it to provide more context and details about the data.
  • Example value is an optional example for this field. It can be useful for documentation purposes.
Tilebox Console
5

Save

Once you’re done completing the fields, click “Create” to create and save the dataset. You are redirected to your newly created dataset.

​
Automatic dataset schema documentation

By specifying the fields for your dataset, including the data type, description, and an example value for each one, Tilebox is capable of automatically generating a documentation page for your dataset schema.
Dataset schema overview

​
Adding extra documentation

You can also add custom documentation to your dataset, providing more context and details about the data included data. This documentation supports rich formatting, including links, tables, code snippets, and more.
Tilebox Console
To add documentation, click the edit pencil button on the dataset page to open the documentation editor. You can use Markdown to format your documentation; you can include links, tables, code snippets, and other Markdown features.
If you don’t see the edit pencil button, you don’t have the required permissions to edit the documentation.
Once you are done editing the documentation, click the Save button to save your changes.

​
Changing the dataset schema

You can always add new fields to a dataset. If you want to remove or edit existing fields, you’ll first need to empty all collections in the dataset, to ensure that no existing data points relying on those fields exist. Then, you can freely edit the dataset schema in the console.