>Contributing Data

Contributing Data


HESTIA is an open-source data platform that makes food production and environmental impact data freely available. Contributing data increases the volume and representativeness of the dataset.

This section provides step-by-step instructions for uploading datasets to the HESTIA platform and managing your uploads.

We recommend contacting us at community@hestia.earth before uploading public data, so we can discuss the dataset and review process with you in advance. However, this is not required — data can be uploaded directly and will be reviewed by a member of the HESTIA team before indexing.

Data can also be uploaded privately (see Uploading your file). Private uploads allow use of HESTIA's models without requiring review.

Topics

Getting Started

To upload data to HESTIA, you first need to create an account. Click "Sign In" in the top navigation bar and follow the registration process. Accounts can be created using Google, ORCID, or LinkedIn credentials.

Key Concepts

The following concepts underpin data upload on HESTIA. For a broader overview, see The HESTIA Data Standard.

Preparing a Dataset

The following information and short videos describe how to prepare a dataset for uploading.

Uploading Your File

From your dashboard, click on the Data Upload option in the left-hand navigation menu. This will take you to the file upload interface, where you can choose to add new data or update existing files.

The Upload Pipeline

All uploads pass through HESTIA's upload pipeline, where a series of checks are performed to ensure the data are correctly formatted.

Special Upload Cases

The following sections describe how to handle non-standard upload scenarios.

Managing Your Files

This section describes how to organise, filter, and manage uploaded datasets.

Using the HESTIA API

The HESTIA API allows programmatic interaction with user accounts and uploaded files.

Validation Tools

HESTIA provides command-line tools to validate your data before uploading. These tools check that your file uses the correct terms, follows the schema, and contains consistent data.

Example Uploads

Example uploads demonstrating the data preparation and upload process for different types of agricultural data.