Skip to content

Small ingestion docs fixes #42

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
lukasbindreiter merged 1 commit into from
Mar 31, 2025
Merged

Small ingestion docs fixes #42

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion datasets/ingest.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Ingesting Data
sidebarTitle: Ingest
description: Learn how to delete data points from Tilebox datasets.
description: Learn how to ingest data into a Tilebox dataset.
icon: up-from-bracket
---

Expand All @@ -24,8 +24,10 @@ Check out the examples below for common scenarios of ingesting data into a colle
## Dataset schema

Tilebox Datasets are strongly-typed. This means you can only ingest data that matches the schema of a dataset. The schema is defined during dataset creation time.

The examples on this page assume that you have access to a [Timeseries dataset](/datasets/types/timeseries) that has the following schema:

<Accordion title="MyCustomDataset schema">
<Tip>
Check out the [Creating a dataset](/guides/datasets/create) guide for an example of how to create such a dataset.
</Tip>
Expand All @@ -45,6 +47,7 @@ The examples on this page assume that you have access to a [Timeseries dataset](
<Tip>
A full overview of available data types can be found in the [here](/datasets/concepts/datasets#field-types).
</Tip>
</Accordion>

Once we've defined the schema and created a dataset, we can access it and create a collection to ingest data into.

Expand Down
23 changes: 17 additions & 6 deletions guides/datasets/create.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,24 @@ description: Learn how to create a dataset
icon: database
---

This page guides you through the process of creating a dataset in Tilebox.
This page guides you through the process of creating a dataset in Tilebox using the [Tilebox Console](/console).

## Step-by-step guide
## Related documentation

<CardGroup cols={2}>
<Card title="Datasets" icon="database" href="/datasets/concepts/datasets" horizontal>
Learn about Tilebox datasets and how to use them.
</Card>
<Card title="Timeseries Datasets" icon="diamonds-4" href="/datasets/types/timeseries" horizontal>
Learn about Timeseries datasets, which link each data point to a specific point in time.
</Card>
</CardGroup>

## Creating a dataset in the Console

<Steps>
<Step title="Click create">
Create a dataset in Tilebox by going to [My datasets](https://console.tilebox.com/datasets/my-datasets) and clicking the "Create dataset" button.
<Step title="Navigate to the Create dataset form">
Create a dataset in Tilebox by going to [My datasets](https://console.tilebox.com/datasets/my-datasets) and clicking the `Create dataset` button.
</Step>
<Step title="Select a dataset kind">
Choose a [dataset kind](/datasets/concepts/datasets#dataset-types) from the dropdown menu. Required fields for the selected dataset kind are automatically added.
Expand Down Expand Up @@ -46,8 +57,8 @@ This page guides you through the process of creating a dataset in Tilebox.
<img src="/assets/console/datasets-create-temporal-dark.png" alt="Tilebox Console" className="hidden dark:block" />
</Frame>
</Step>
<Step title="Create the dataset">
Once you're done completing the fields, click "Create" to create the dataset. You are redirected to your newly created dataset.
<Step title="Save">
Once you're done completing the fields, click "Create" to create and save the dataset. You are redirected to your newly created dataset.
</Step>
</Steps>

Expand Down
21 changes: 16 additions & 5 deletions guides/datasets/ingest.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,18 +1,29 @@
---
title: Ingesting data
description: Learn how to ingest data into a Tilebox dataset
icon: up-from-bracket
description: Learn how to ingest an existing dataset into Tilebox
icon: folder-arrow-up
---

import { CodeOutputHeader } from '/snippets/components.mdx';

<CardGroup cols={1}>
<Card title="Open as Notebook" icon="book" href="https://colab.research.google.com/drive/1QS-srlWPMJg4csc0ycn36yCX9U6mvIpW" horizontal>
This guide is also available as a Google Colab notebook. Click here for an interactive version.
</Card>
</CardGroup>

This page guides you through the process of ingesting data into a Tilebox dataset. Starting from an existing
dataset available as file in the [GeoParquet](https://geoparquet.org/) format, we'll walk you through the process of
ingestion that data into Tilebox as a [Timeseries](/datasets/types/timeseries) dataset.

<CardGroup cols={1}>
<Card title="Open as Notebook" icon="book" href="https://colab.research.google.com/drive/1QS-srlWPMJg4csc0ycn36yCX9U6mvIpW" horizontal>
This example is also available as a Google Colab notebook. Click here to navigate to an interactive example.
## Related documentation

<CardGroup cols={2}>
<Card title="Datasets" icon="database" href="/datasets/concepts/datasets" horizontal>
Learn about Tilebox datasets and how to use them.
</Card>
<Card title="Ingest" icon="up-from-bracket" href="/datasets/ingest" horizontal>
Learn how to ingest data into a Tilebox dataset.
</Card>
</CardGroup>

Expand Down