Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
4 changes: 2 additions & 2 deletions datasets/concepts/collections.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -188,8 +188,8 @@ if err != nil {

## Next steps

<CardGroup cols={2}>
<Columns cols={2}>
<Card title="Query Data" icon="server" href="/datasets/query" horizontal>
Learn how to query data from a collection.
</Card>
</CardGroup>
</Columns>
8 changes: 4 additions & 4 deletions datasets/concepts/datasets.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,14 +10,14 @@ icon: database

## Related Guides

<CardGroup cols={2}>
<Columns cols={2}>
<Card title="Creating a dataset" icon="database" href="/guides/datasets/create" horizontal>
Learn how to create a Timeseries dataset using the Tilebox Console.
</Card>
<Card title="Ingesting data" icon="up-from-bracket" href="/guides/datasets/ingest" horizontal>
Learn how to ingest an existing CSV dataset into a Timeseries dataset collection.
</Card>
</CardGroup>
</Columns>

## Dataset types

Expand All @@ -28,7 +28,7 @@ or additionally also spatially filtered queries.
To find out which fields are required for each dataset type check out the documentation for the available dataset types
below.

<CardGroup cols={2}>
<Columns cols={2}>
<Card title="Timeseries Data" icon="diamonds-4" href="/datasets/types/timeseries" horizontal>
Each data point is linked to a specific point in time. Common for satellite telemetry, or other time-based data.
Supports efficient time-based queries.
Expand All @@ -37,7 +37,7 @@ below.
Each data point is linked to a specific point in time and a location on the Earth's surface. Common for satellite
imagery. Supports efficient time-based and spatially filtered queries.
</Card>
</CardGroup>
</Columns>

## Dataset specific fields

Expand Down
8 changes: 4 additions & 4 deletions datasets/introduction.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ explore any of the wide range of [available public open data datasets](/datasets

Learn more about datasets by exploring the following sections:

<CardGroup cols={2}>
<Columns cols={2}>
<Card title="Datasets" icon="database" href="/datasets/concepts/datasets" horizontal>
Learn what dataset types are available on Tilebox and how to create, list and access them.
</Card>
Expand All @@ -25,7 +25,7 @@ Learn more about datasets by exploring the following sections:
<Card title="Ingesting Data" icon="up-from-bracket" href="/datasets/ingest" horizontal>
Learn how to ingest data into a collection.
</Card>
</CardGroup>
</Columns>

<Note>
For a quick reference to API methods or specific parameter meanings, [check out the complete datasets API Reference](/api-reference/python/tilebox.datasets/Client).
Expand Down Expand Up @@ -169,8 +169,8 @@ func main() {

## Next steps

<CardGroup cols={2}>
<Columns cols={2}>
<Card title="Accessing datasets" icon="database" href="/datasets/concepts/datasets" horizontal />
<Card title="Async support" icon="rotate" href="/sdks/python/async" horizontal />
<Card title="Working with Xarray" icon="chart-bar" href="/sdks/python/xarray" horizontal />
</CardGroup>
</Columns>
4 changes: 2 additions & 2 deletions guides/datasets/create.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,14 +8,14 @@ This page guides you through the process of creating a dataset in Tilebox using

## Related documentation

<CardGroup cols={2}>
<Columns 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>
</Columns>

## Creating a dataset in the Console

Expand Down
12 changes: 6 additions & 6 deletions guides/datasets/ingest.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,11 @@ description: Learn how to ingest an existing dataset into Tilebox
icon: up-from-bracket
---

<CardGroup cols={1}>
<Columns 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>
</Columns>

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, you'll go through the process of
Expand All @@ -20,14 +20,14 @@ ingesting that data into Tilebox as a [Timeseries](/datasets/types/timeseries) d

## Related documentation

<CardGroup cols={2}>
<Columns 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>
</Columns>

## Downloading the example dataset

Expand Down Expand Up @@ -234,7 +234,7 @@ on one of the data points.
Congrats. You've successfully ingested data into Tilebox. You can now explore the data in the console and use it for
further processing and analysis.

<CardGroup cols={2}>
<Columns cols={2}>
<Card title="Query Data" icon="server" href="/datasets/query" horizontal>
Learn all about [querying your newly created dataset](https://docs.tilebox.com/datasets/query)
</Card>
Expand All @@ -244,4 +244,4 @@ further processing and analysis.
<Card title="Open Data" icon="star" href="/datasets/open-data" horizontal>
Check out a growing number of publicly available open data datasets on Tilebox
</Card>
</CardGroup>
</Columns>
8 changes: 4 additions & 4 deletions guides/workflows/multi-language.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,11 @@ description: Learn how to create workflows that use tasks written in different l
icon: diagram-project
---

<CardGroup cols={1}>
<Columns cols={1}>
<Card title="Open in GitHub" icon="github" href="https://github.com/tilebox/examples/tree/main/workflows-multilang" horizontal>
The code for this guide is available on GitHub.
</Card>
</CardGroup>
</Columns>

## Tilebox languages and SDKs

Expand Down Expand Up @@ -205,11 +205,11 @@ Image captured for [40.75, -73.98] with 30m resolution and bands [489, 560.6, 66

## Next Steps

<CardGroup cols={1}>
<Columns cols={1}>
<Card title="Open in GitHub" icon="github" href="https://github.com/tilebox/examples/tree/main/workflows-multilang" horizontal>
The code for this guide is available on GitHub.
</Card>
</CardGroup>
</Columns>

As a learning exercise, you can try to change the [News API Workflow](/workflows/concepts/tasks#dependencies-example) to replace the `FetchNews` task with a Go task and keep all the other tasks in Python.
You'll learn how to submit a subtask in another language than what the current task is executed in.
14 changes: 7 additions & 7 deletions introduction.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,13 +9,13 @@ mode: wide

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

Tilebox is a space data native distributed computing tool. It provides a framework that simplifies access, processing, and distribution of space data across different environments enabling efficient multi-language, multi-cluster workflows. Tilebox integrates seamlessly with your existing infrastructure, ensuring that you maintain complete control over your data and algorithms.
Tilebox is a lightweight space data management and orchestration software - on ground and in orbit. It provides a framework that simplifies access, processing, and distribution of space data across different environments enabling efficient multi-language, multi-cluster workflows. Tilebox integrates seamlessly with your existing infrastructure, ensuring that you maintain complete control over your data and algorithms.

## Modules

Tilebox consists of two primary modules:

<CardGroup cols={3}>
<Columns cols={3}>
<HeroCard
title="Datasets"
description="A data access module with upstream integrations to space service providers, enabling instant data access for scientists through high-performance APIs and easy-to-use client SDKs."
Expand All @@ -30,13 +30,13 @@ Tilebox consists of two primary modules:
>
<img src="/assets/tilebox-workflows-hero.svg" alt="Workflows" />
</HeroCard>
</CardGroup>
</Columns>

## Getting Started

To get started, check out some of the following resources:

<CardGroup cols={3}>
<Columns cols={3}>
<Card
title="Tilebox Console"
icon="terminal"
Expand All @@ -55,13 +55,13 @@ To get started, check out some of the following resources:
href="/quickstart"
horizontal
/>
</CardGroup>
</Columns>

## Guides

You can also start by looking through these guides:

<CardGroup cols={2}>
<Columns cols={2}>
<Card
title="Timeseries Datasets"
icon="database"
Expand Down Expand Up @@ -89,4 +89,4 @@ You can also start by looking through these guides:
href="/workflows/concepts/task-runners">
Find out how to deploy Task Runners to run workflows in a parallel, distributed manner.
</Card>
</CardGroup>
</Columns>
8 changes: 4 additions & 4 deletions quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -101,14 +101,14 @@ If you prefer to work locally, follow these steps to get started.
<Step title="Explore Further">
Review the following guides to learn more about the modules that make up Tilebox:

<CardGroup cols={2}>
<Columns cols={2}>
<Card title="Creating a dataset" icon="database" href="/guides/datasets/create" horizontal>
Learn how to create a Timeseries dataset using the Tilebox Console.
</Card>
<Card title="Ingesting data" icon="up-from-bracket" href="/guides/datasets/ingest" horizontal>
Learn how to ingest an existing CSV dataset into a Timeseries dataset collection.
</Card>
</CardGroup>
</Columns>
</Step>

</Steps>
Expand Down Expand Up @@ -304,14 +304,14 @@ If you prefer to work locally, follow these steps to get started.
<Step title="Explore Further">
Review the following guides to learn more about the modules that make up Tilebox:

<CardGroup cols={2}>
<Columns cols={2}>
<Card title="Creating a dataset" icon="database" href="/guides/datasets/create" horizontal>
Learn how to create a Timeseries dataset using the Tilebox Console.
</Card>
<Card title="Ingesting data" icon="up-from-bracket" href="/guides/datasets/ingest" horizontal>
Learn how to ingest an existing CSV dataset into a Timeseries dataset collection.
</Card>
</CardGroup>
</Columns>
</Step>

</Steps>
Expand Down
8 changes: 4 additions & 4 deletions sdks/go/examples.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ More examples can be found throughout the docs.

## Workflows examples

<CardGroup cols={2}>
<Columns cols={2}>
<Card title="Hello World" icon="hand-wave" href="https://github.com/tilebox/tilebox-go/tree/main/examples/workflows/helloworld" horizontal>
How to use Tilebox Workflows to submit and execute a simple task.
</Card>
Expand All @@ -24,15 +24,15 @@ More examples can be found throughout the docs.
<Card title="OpenTelemetry Observability" icon="eye" href="https://github.com/tilebox/tilebox-go/blob/main/examples/workflows/opentelemetry" horizontal>
How to set up tracing and logging for workflows using OpenTelemetry.
</Card>
</CardGroup>
</Columns>

## Datasets examples

<CardGroup cols={2}>
<Columns cols={2}>
<Card title="Query" icon="server" href="https://github.com/tilebox/tilebox-go/blob/main/examples/datasets/query/main.go" horizontal>
How to query datapoints from a Tilebox dataset.
</Card>
<Card title="Ingest and delete" icon="up-from-bracket" href="https://github.com/tilebox/tilebox-go/blob/main/examples/datasets/ingest/main.go" horizontal>
How to create a collection, ingest datapoints, and then delete them.
</Card>
</CardGroup>
</Columns>
4 changes: 2 additions & 2 deletions sdks/go/install.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,14 +8,14 @@ icon: download

Tilebox offers a Go SDK for accessing Tilebox services. It additionally includes a command-line tool (tilebox-generate) that can be installed separately.

<CardGroup cols={2}>
<Columns cols={2}>
<Card title="tilebox-go" icon="golang" href="https://github.com/tilebox/tilebox-go" horizontal>
Datasets and workflows client for Tilebox
</Card>
<Card title="tilebox-generate" icon="terminal" href="https://github.com/tilebox/tilebox-generate" horizontal>
Command-line tool to generate Tilebox datasets types for Go
</Card>
</CardGroup>
</Columns>

## Installation

Expand Down
4 changes: 2 additions & 2 deletions sdks/introduction.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ import { HeroCard } from '/snippets/components.mdx';

The following language SDKs are currently available for Tilebox. Select one to learn more.

<CardGroup cols={3}>
<Columns cols={3}>
<HeroCard
title="Tilebox Python"
description="The Tilebox Python SDK includes full support for datasets, storage and workflows. Use it together with your favorite Python libraries to access and process data."
Expand All @@ -24,4 +24,4 @@ The following language SDKs are currently available for Tilebox. Select one to l
>
<img src="/assets/tilebox-banner-go.svg" alt="Tilebox Go" />
</HeroCard>
</CardGroup>
</Columns>
4 changes: 2 additions & 2 deletions sdks/python/install.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,14 +8,14 @@ icon: download

Tilebox offers a Python SDK for accessing Tilebox services. The SDK includes separate packages that can be installed individually based on the services you wish to use, or all together for a comprehensive experience.

<CardGroup cols={2}>
<Columns cols={2}>
<Card title="tilebox-datasets" icon="database" href="https://pypi.org/project/tilebox-datasets/" horizontal>
Access Tilebox datasets from Python
</Card>
<Card title="tilebox-workflows" icon="network-wired" href="https://pypi.org/project/tilebox-workflows/" horizontal>
Workflow client and task runner for Tilebox
</Card>
</CardGroup>
</Columns>

## Installation

Expand Down
4 changes: 2 additions & 2 deletions sdks/python/xarray.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -346,7 +346,7 @@ This section covers only a few common use cases for Xarray. The library offers m

Some useful capabilities not covered in this section include:

<CardGroup cols={2}>
<Columns cols={2}>
<Card
title="Grouping data"
icon="layer-group"
Expand Down Expand Up @@ -377,4 +377,4 @@ Some useful capabilities not covered in this section include:
href="https://docs.xarray.dev/en/latest/user-guide/plotting.html"
horizontal
/>
</CardGroup>
</Columns>
2 changes: 1 addition & 1 deletion snippets/components.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ export const HeroCard = ({ children, title, description, href }) => {
>
{children}
<h1 className="mt-4 font-semibold text-gray-900 dark:text-white">{title}</h1>
<h2 className="mt-1 text-gray-600 dark:text-gray-400 text-sm leading-6">{description}</h2>
<p className="mt-1 text-gray-600 dark:text-gray-400 text-sm leading-6">{description}</p>
</a>
);
};
Expand Down
4 changes: 2 additions & 2 deletions storage/clients.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -164,7 +164,7 @@ Contents:

### Further Reading

<CardGroup cols={2}>
<Columns cols={2}>
<Card
title="Getting Started with ASF"
icon="arrow-up-right-from-square"
Expand All @@ -177,7 +177,7 @@ Contents:
href="https://asf.alaska.edu/information/data-formats/data-formats-in-depth/"
horizontal
/>
</CardGroup>
</Columns>

## Umbra Space

Expand Down
4 changes: 2 additions & 2 deletions workflows/caches.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -38,12 +38,12 @@ attribute that can be used to [store and retrieve data](#storing-and-retrieving-

Tilebox Workflows comes with four cache implementations out of the box, each backed by a different storage system.

<CardGroup cols={2}>
<Columns cols={2}>
<Card title="Google Cloud Storage" icon="google" href="#google-storage-cache" horizontal />
<Card title="Amazon S3" icon="aws" href="#amazon-s3-cache" horizontal />
<Card title="Local File System" icon="folder-open" href="#local-file-system-cache" horizontal />
<Card title="In-Memory" icon="memory" href="#in-memory-cache" horizontal />
</CardGroup>
</Columns>

### Google Storage Cache

Expand Down
Loading