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

Step-by-step guide

1

Click create

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. Prefilled fields for the selected dataset kind are automatically added. Common fields for time series can be found here. Support for STAC-compatible datasets is coming soon.

3

Fill in 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.
4

Fill in the fields

Common fields for each dataset kind are added automatically. Click “Add field” to add more fields.

Each field has these properties:

  • Name is the name of the field (it should be snake_case).
  • Type and Array let you specify the field data type and whether it’s an array. See below for an explanation of the available data.
  • 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.
5

Create the dataset

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

The next steps are to create at least one collection and ingest data into it.

It might then resemble this:

Editing a dataset

You can edit the dataset by clicking the edit pencil button on the dataset overview page.

On this page, you can change the dataset name, description, add new fields, and edit both description and example for existing fields.

If you don’t see the edit pencil button, you don’t have the required permissions to edit the documentation.

Adding documentation

In addition to the auto-generated overview page, you can add custom documentation to your dataset. This documentation is displayed on the dataset page and can be used to provide more context and details about the data.

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.