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
Original file line number Diff line number Diff line change
Expand Up @@ -132,7 +132,7 @@ By following these guidelines, you help keep the forum organized, useful, and we

**Starting a Discussion About an Item in the Open Science Catalog**

If your discussion relates to an item in the **Open Science Catalog**, it's best to use the [integrated features on the catalog](../../Technical%20Documentation/Data/Discovering%20Resources%20in%20The%20EarthCODE%20Catalog.md#start-discussions-directly-from-the-catalog):
If your discussion relates to an item in the **Open Science Catalog**, it's best to use the [integrated features on the catalog](../../Technical%20Documentation/Open%20Science%20Catalog%20(OSC)/Discovering%20Resources.md#start-discussions-directly-from-the-catalog):
1. Navigate to the catalog and locate the item.
2. Use the **"Start a new topic on the EarthCODE forum"** button.

Expand Down
15 changes: 6 additions & 9 deletions pages/Getting started with EarthCODE/10 minutes to EarthCODE.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,17 +25,14 @@ See [Accessing EarthCODE](../Getting%20started%20with%20EarthCODE/Accessing%20Ea

Different users of EarthCODE have different needs and goals. To help you find the most relevant information quickly, we've outlined suggested paths based on your role and intentions.

### Researchers Ready to Upload Their Data
### Researchers looking to contribute to the Open Science Catalog

If you've completed your research and are looking to **publish your data to the Open Science Catalog (OSC)**, your main priority is to ensure your data is **persistent, properly formatted and publicly available**.
If you have 1) completed your research; 2) have your data/workflow prepared in a persitent online repository; and 3) are looking to ** contribute to the Open Science Catalog (OSC)**, head to the [**Contributing to the OSC section**](../Technical%20Documentation/Open%20Science%20Catalog%20(OSC)/Contributing%20to%20the%20Open%20Science%20Catalog.md)).

Head directly to the [**Uploading Data**](../Technical%20Documentation/Data/Contributing%20to%20the%20EarthCODE%20Catalog.md) section to learn how to:
- Prepare your data for publication.
- Create valid STAC objects and metadata.
- Publish data products to the Open Science Catalog.

This section will guide you through the entire upload process, including validating your metadata and ensuring your data assets are accessible.
### Researchers looking for persistent storage

If you've 1) completed your research; and 2) want to store your data/workflow prepared in a persitent online repository you can use the ESA Project Results Repository to do so. Head to the [**ESA Project Results Repository (PRR) section**](../Technical%20Documentation/ESA%20Project%20Results%20Repository%20(PRR)/index.md)) to for instructions how to do this. After you have stored your data/workflow in the PRR, add an entry for it in the [Open Science Catalog](../Technical%20Documentation/Open%20Science%20Catalog%20(OSC)/Contributing%20to%20the%20Open%20Science%20Catalog.md)).

### New Researchers Starting a Project

Expand All @@ -51,7 +48,7 @@ Visit the [**Platform Selection**](../Technical%20Documentation/Platforms/) sect
- Understanding which tools will streamline your workflow.
- Setting up your environment for collaborative or individual work.

If you plan to publish your results later, it’s a good idea to also familiarize yourself with the [**Uploading Data**](../Technical%20Documentation/Data/Contributing%20to%20the%20EarthCODE%20Catalog.md) section to understand the requirements early on.
It’s also a good idea to also familiarize yourself with the [**Contributing to the OSC section**](../Technical%20Documentation/Open%20Science%20Catalog%20(OSC)/Contributing%20to%20the%20Open%20Science%20Catalog.md)) to understand the requirements early on.

### Users Exploring Published Research

Expand Down Expand Up @@ -161,7 +158,7 @@ To improve discoverability, STAC objects also include metadata fields such as:

Because these objects must follow a strict predefined schema, ensuring compliance can be complex. However, EarthCODE provides example guides to help you structure your data correctly. Additionally, there are automated tools that simplify the creation of STAC objects, reducing manual effort.

You can read more on how to publish data in the [Uploading Your Data](../Technical%20Documentation/Data/Contributing%20to%20the%20EarthCODE%20Catalog.md) section, and check out our [examples](https://esa-earthcode.github.io/examples/).
You can read more on how to publish entities in the [Contributing to the Open Science Catalog](../Technical%20Documentation/Open%20Science%20Catalog%20(OSC)/Contributing%20to%20the%20Open%20Science%20Catalog.md) section, and check out our [examples](https://esa-earthcode.github.io/examples/).


#### Best Practices
Expand Down
6 changes: 3 additions & 3 deletions pages/Getting started with EarthCODE/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,7 @@ When your research is complete, you:
:::tip *Only ESA-funded projects can publish to EarthCODE.*
:::

The **ESA Project Results Repository (ESA PRR)** is a long-term storage service provided by ESA to persistently host results from ESA-funded projects. Once users have completed their work, they can upload their datasets and workflows to the PRR to ensure they remain accessible and preserved over time. While publishing to the PRR is optional, it is strongly recommended for long-term availability and compliance with FAIR principles. A detailed guide to this process is available in the [publication section](../Technical%20Documentation/Data/Contributing%20to%20the%20EarthCODE%20Catalog.md).
The **ESA Project Results Repository (ESA PRR)** is a long-term storage service provided by ESA to persistently host results from ESA-funded projects. Once users have completed their work, they can upload their datasets and workflows to the PRR to ensure they remain accessible and preserved over time. While publishing to the PRR is optional, it is strongly recommended for long-term availability and compliance with FAIR principles. A detailed guide to this process is available in the [publication section](../Technical%20Documentation/ESA%20Project%20Results%20Repository%20(PRR)/index.md).

The [**Open Science Catalog (OSC)**](https://opensciencedata.esa.int/catalog) is a public, web-based application that allows users to explore and access scientific datasets, workflows, and documentation produced through ESA-funded Earth Observation research. Researchers publish metadata describing their outputs to the Open Science Catalog, and after review, this metadata is made discoverable through the OSC. The catalog uses STAC to describe datasets and OGC API - Records for workflows. Through this rich metadata on the Open Science Catalog, resources are made FAIR. Additionally, the open science catalog is integrated with the EarthCODE platforms and allows users to reproduce experiments (run workflows that produce products) that they find on the catalog.

Expand All @@ -106,9 +106,9 @@ Each published item in the OSC can be linked to a discussion thread, enabling ex
This step will help you become familiar with the platform's tools and resources, and how they integrate to support your research. The best way to follow our tutorials and learn about EarthCODE is by using one of the EarthCODE platforms. We recommend visiting the page where we explain how [to choose the right tools and platforms for your work](../Technical%20Documentation/Platforms/).

EarthCODE offers a variety of features, in the portal you will be able to find:
- [Datasets](../Technical%20Documentation/Data/): Access a variety of datasets available for your research needs and discovery.
- [Datasets](../Technical%20Documentation/Open%20Science%20Catalog%20(OSC)/): Access a variety of datasets available for your research needs and discovery.
- [Computational Research](../Technical%20Documentation/Platforms/): Use EarthCODE integrated platforms with advanced computational tools for Earth System Science on collaborative research environment
- [Workflows](../Technical%20Documentation/Workflows/) : Easily find, publish and re-use FAIR workflows to enhance reproducibility and collaboration in research
- [Workflows](../Technical%20Documentation/Workflows%20and%20Experiments/index.md) : Easily find, publish and re-use FAIR workflows to enhance reproducibility and collaboration in research
- [Community](../Community%20and%20Collaboration/Getting%20Started%20With%20The%20EarthCODE%20Discourse/): Fostering a collaborative community dedicated to FAIR Open Science and sustainable innovation

By exploring these sections, you’ll better understand how to leverage EarthCODE’s resources and tools to support your research.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -189,7 +189,7 @@ For some examples of what these might look like in practice, refer to the [10 mi

Usage of these platforms, and the data, compute and storage resources on these platforms can be funded through the [ESA Network of Resources (NoR)](https://eo4society.esa.int/network-of-resources/), depending on the project type and eligibility.

Users can also decide to use their own local environments instead of the platforms. For users working outside the integrated platforms—such as on institutional infrastructure or personal systems—EarthCODE supports **manual publishing** of datasets and workflows to the catalog, through the EarthCODE publishing GUI or manually via git pull requests (see more at [Working with Data](../Technical%20Documentation/Data/)).
Users can also decide to use their own local environments instead of the platforms. For users working outside the integrated platforms—such as on institutional infrastructure or personal systems—EarthCODE supports **manual publishing** of datasets and workflows to the catalog, through the EarthCODE publishing GUI or manually via git pull requests (see more in the [**Contributing to the OSC section**](../Technical%20Documentation/Open%20Science%20Catalog%20(OSC)/Contributing%20to%20the%20Open%20Science%20Catalog.md)).


### Network of Resources
Expand Down Expand Up @@ -255,7 +255,7 @@ The EarthCODE project runs standard best practice procurement cycles on esa-star
More information about how integrating with EarthCODE works, where and how to apply, can be found at the [Integrating New Platforms Page](../Integrating%20New%20Platforms%20to%20EarthCODE/).

### Publishing Experiments Data and Workflows
Once a research activity is complete, the results can be published to the EarthCODE ecosystem, making them findable, reproducible, and reusable by the broader scientific community. If you are working on an integrated platform, publishing is typically automated. When the experiment is finalized, the platform can generate the appropriate metadata and push it to the Open Science Catalog. If you're working outside of an integrated platform—on institutional infrastructure or locally—you can still publish your results manually by following the Open Science Catalog submission guidelines [Working with Data](../Technical%20Documentation/Data/index.md).
Once a research activity is complete, the results can be published to the EarthCODE ecosystem, making them findable, reproducible, and reusable by the broader scientific community. If you are working on an integrated platform, publishing is typically automated. When the experiment is finalized, the platform can generate the appropriate metadata and push it to the Open Science Catalog. If you're working outside of an integrated platform—on institutional infrastructure or locally—you can still publish your results manually by following the [Open Science Catalog submission guidelines](../Technical%20Documentation/Open%20Science%20Catalog%20(OSC)/Contributing%20to%20the%20Open%20Science%20Catalog.md).

At the time of publishing, it is expected that the outputs have been finalized and, where applicable, reviewed and approved by the ESA project’s Technical Officer. When you're ready to publish you:
1. (Optional) Upload your **datasets and workflows** to the **ESA Project Results Repository (PRR)** for long-term preservation.
Expand All @@ -273,7 +273,7 @@ The core units of publication in EarthCODE are data and workflows (combined in e

In EarthCODE, the final outputs of your research—referred to as **Products** or data products—are stored, described, and published in a way that ensures long-term FAIRness and availability.

These data products can be hosted on the ESA Project Results Repository (PRR) or an external repository of your choice. The PRR is ESA’s dedicated long-term storage service for project results. Uploading to the PRR is optional but recommended, especially for ensuring compliance with FAIR principles and facilitating persistent access to your work. You simply provide a link to the data location as part of the product’s metadata. For detailed instructions on uploading to the PRR, refer to the [Contributing to the Open Science Catalog guide](../Technical%20Documentation/Data/Contributing%20to%20the%20EarthCODE%20Catalog.md).
These data products can be hosted on the ESA Project Results Repository (PRR) or an external repository of your choice. The PRR is ESA’s dedicated long-term storage service for project results. Uploading to the PRR is optional but recommended, especially for ensuring compliance with FAIR principles and facilitating persistent access to your work. You simply provide a link to the data location as part of the product’s metadata. For detailed instructions on uploading to the PRR, refer to the [**ESA Project Results Repository (PRR) section **](../Technical%20Documentation/ESA%20Project%20Results%20Repository%20(PRR)/index.md).

Each product is described using **STAC (SpatioTemporal Asset Catalog) metadata**, specifically through a `Collection` that captures key attributes like the spatial and temporal extent, scientific context, provenance, and more.

Expand Down Expand Up @@ -340,7 +340,7 @@ The [Open Science Catalog (OSC)](https://opensciencedata.esa.int/catalog) is the

Metadata describing datasets (Products) is published using the **SpatioTemporal Asset Catalog (STAC)** specification. Workflows and experiments are described using the **OGC API - Records** standard. These two metadata models are connected by references. The Open Science Catalog is also integrated with EarthCODE's computing infrastructure. Users with appropriate access—such as NoR-sponsored compute—can reproduce experiments directly from the catalog. This means running the same workflow with the same input and configuration on a compatible platform, enabling reproducible results.

The catalog acts as both a registry of published research artifacts and an operational gateway for executing FAIR experiments across federated EO platforms. More information about the catalog and how it works can be found at [Data - Discovering Resources in The Open Science Catalog)](../Technical%20Documentation/Data/Discovering%20Resources%20in%20The%20EarthCODE%20Catalog)
The catalog acts as both a registry of published research artifacts and an operational gateway for executing FAIR experiments across federated EO platforms. More information about the catalog and how it works can be found at [Data - Discovering Resources in The Open Science Catalog)](../Technical%20Documentation/Open%20Science%20Catalog%20(OSC)/Discovering%20Resources)

<!-- One such component developed on top of EOEPCA open-
source building blocks and which will be integrated in
Expand Down
Loading