diff --git a/.gitignore b/.gitignore index 2f27963a..da02d502 100644 --- a/.gitignore +++ b/.gitignore @@ -9,3 +9,4 @@ pages/Integrating New Platforms to EarthCODE/.DS_Store pages/public/img/.DS_Store pages/public/img/platforms/.DS_Store pages/public/img/terms/.DS_Store +.vscode diff --git a/pages/Community and Collaboration/Getting Started With The EarthCODE Discourse/Code of Conduct.md b/pages/Community and Collaboration/Getting Started With The EarthCODE Discourse/Code of Conduct.md index f529f87b..41fdbc1d 100644 --- a/pages/Community and Collaboration/Getting Started With The EarthCODE Discourse/Code of Conduct.md +++ b/pages/Community and Collaboration/Getting Started With The EarthCODE Discourse/Code of Conduct.md @@ -91,7 +91,7 @@ Help us maintain an organized forum by: Use the EarthCODE portal to find and access published experiments, products, data or workflows and join discussions. From there, you have the ability to either contribute to the existing topic about the item or start a new one. -When using the EarthCODE Catalog: +When using the Open Science Catalog: * Use the "Discuss This" feature to start forum discussions directly from catalog items * Topics created this way will be automatically tagged with relevant metadata diff --git a/pages/Community and Collaboration/Getting Started With The EarthCODE Discourse/EarthCODE Discourse Basics.md b/pages/Community and Collaboration/Getting Started With The EarthCODE Discourse/EarthCODE Discourse Basics.md index 043c3965..9e0052d9 100644 --- a/pages/Community and Collaboration/Getting Started With The EarthCODE Discourse/EarthCODE Discourse Basics.md +++ b/pages/Community and Collaboration/Getting Started With The EarthCODE Discourse/EarthCODE Discourse Basics.md @@ -42,7 +42,7 @@ When you log in, you’ll find the following categories in Discourse: | **EarthCODE Architecture** | Technical standards and development | | **Technical Support** | Technical support for EarthCODE and platforms | | **Training and Resources** | Tutorials and best practices | -| **Data & Workflows** | Dataset and workflow discussions (autogenerated from the EarthCODE Catalog) | +| **Data & Workflows** | Dataset and workflow discussions (autogenerated from the Open Science Catalog) | | **Community Engagement** | Events and recognition | | **Feedback and Suggestions**| Feedback on how to improve EarthCODE | diff --git a/pages/Community and Collaboration/Getting Started With The EarthCODE Discourse/Join the Conversation.md b/pages/Community and Collaboration/Getting Started With The EarthCODE Discourse/Join the Conversation.md index 3f00c428..0e4a5da4 100644 --- a/pages/Community and Collaboration/Getting Started With The EarthCODE Discourse/Join the Conversation.md +++ b/pages/Community and Collaboration/Getting Started With The EarthCODE Discourse/Join the Conversation.md @@ -7,7 +7,7 @@ order: 2 Finding content on the **EarthCODE Discourse forum** is key to making the most of the platform and avoiding duplication of the same questions. Before posting about a topic, follow these three steps: -## 1. Use the EarthCODE Catalog +## 1. Use the Open Science Catalog If you are looking for a discussion about a particular item on the Open Science Catalog, you can see all the linked topics about that particular item on its open science catalog webpage. @@ -92,7 +92,7 @@ For more formatting tips, [try this 10-minute markdown tutorial](https://commonm Posting on the **EarthCODE Discourse forum** is straightforward, but following a few best practices ensures discussions remain relevant and organized. You can start discussions about a variety of topics such as: -- Sharing datasets from Open Science Data Catalogue, discussing yours or others' project’s results and new ideas. +- Sharing datasets from Open Science Catalogue, discussing yours or others' project’s results and new ideas. - Discussing platforms which will be integrated to EarthCODE, their features, and how to make the most out of them. - Ask a question, share a resource (training, blog, article), or just share something relevant you’re passionate about - Discuss an event, gathering or other community engagement @@ -100,7 +100,7 @@ You can start discussions about a variety of topics such as: - Ask for technical support and post about issues you're facing -When posting about a dataset, workflow, or experiment in the EarthCODE Catalog, you can make contributions to improve reusability, quality or share constructive ideas to start a conversation about the item. You could start discussions about: +When posting about a dataset, workflow, or experiment in the Open Science Catalog, you can make contributions to improve reusability, quality or share constructive ideas to start a conversation about the item. You could start discussions about: - Missing or incomplete metadata (e.g. missing spatial/temporal coverage, provenance details, variable definitions) - Feedback on data quality (e.g. unexpected values, data gaps, inconsistencies) - Questions about the methodology used to generate the product @@ -130,9 +130,9 @@ When no relevant discussion exists, create a new topic. Follow these steps: By following these guidelines, you help keep the forum organized, useful, and welcoming for all users. -**Starting a Discussion About an Item in the EarthCODE Catalog** +**Starting a Discussion About an Item in the Open Science Catalog** -If your discussion relates to an item in the **EarthCODE 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/Data/Discovering%20Resources%20in%20The%20EarthCODE%20Catalog.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. @@ -153,7 +153,7 @@ Discourse includes a **chat feature** that allows you to connect directly with o 2. Start a chat directly from their profile on a post. ![onebox-paste-link](/img/discourse/chatfrompost.gif) -For example, you could find an interesting item in the EarthCODE catalog and want to ask the researcher who published it some questions. If they are registered on Discourse, you can search for them by name and send them a direct message. +For example, you could find an interesting item in the Open Science catalog and want to ask the researcher who published it some questions. If they are registered on Discourse, you can search for them by name and send them a direct message. ## Chat Etiquette diff --git a/pages/Getting started with EarthCODE/10 minutes to EarthCODE.md b/pages/Getting started with EarthCODE/10 minutes to EarthCODE.md index 782bc181..face5986 100644 --- a/pages/Getting started with EarthCODE/10 minutes to EarthCODE.md +++ b/pages/Getting started with EarthCODE/10 minutes to EarthCODE.md @@ -66,7 +66,7 @@ Go to the [**Open Science Catalog**](https://opensciencedata.esa.int/) to start ## Choosing a Platform EarthCODE provides you *single‑sign‑on* access to a growing number of EO platforms that host EO data, development tools and compute. Once you log in with your EarthCODE account, you carry the same identity across the **EarthCODE Portal**, the **EarthCODE Forum**, each **integrated platform**, and the **Open Science Catalog**. -For all of the EarthCODE integrated platforms, you can apply for Network‑of‑Resources (NoR) sponsorship to cover compute costs. Every platform comes with FAIR tooling that lets you publish results to the Open Science Catalog in an automated manner. Additionally, some platforms support creating and executing several types of workflows, which means that if you develop a workflow on them, it will be cross-compatible with other platforms. +For all of the EarthCODE integrated platforms, you can apply for Network‑of‑Resources (NoR) sponsorship to cover compute costs. Every platform comes with FAIR tooling that lets you publish results to the Open Science Catalog in an automated manner. Additionally, some platforms support creating and executing several types of workflows, which means that if you develop a workflow on them, it will be cross-compatible with other platforms supporting the same type of workflow. ![EarthCODE Platform](/img/terms/earthcode-platfrom-generic.svg) @@ -86,12 +86,12 @@ Each platform provides a variety of EO data stored on the cloud and expose acces --- ### Workflow Development -EarthCODE platforms differ in interface and how you build and run algorithms: some offer visual process designers, others provide Jupyter Notebooks with extensions, and several combine both. For example OpenEO provides both the OpenEO API and a graphical interface. Many platforms also ship pre‑configured machine‑learning environments and ready‑made domain algorithms. Pick the platform whose tooling matches the tools you already use and project goals; cloud execution keeps everything reproducible and scalable without local setup hassles. By using platforms to develop code you can directly publish end-to-end FAIR workflows that enable users to reproduce and reuse result datasets and code. +EarthCODE platforms differ in interface and how you build and run workflows: some offer visual process designers, others provide Jupyter Notebooks with extensions, and several combine both. For example OpenEO provides an API, a set of client libraries, supporting modern programming languages such as Python, and a graphical interface. Many platforms also ship pre‑configured machine‑learning environments and ready‑made domain workflows. Pick the platform whose tooling matches the tools you already use and project goals; cloud execution keeps everything reproducible and scalable without local setup hassles. By using platforms to develop code you can directly publish end-to-end FAIR workflows that enable users to reproduce and reuse result datasets and code. -![OpenEO Editor](/img/terms/open_eo_save_process.png) -*Open EO Process Editor GUI* +![OpenEO Web Editor](/img/terms/open_eo_save_process.png) +*OpenEO Web Editor GUI* --- @@ -137,11 +137,12 @@ Platforms differ in how they let you visualize published results from others and Visit the [Working with Platforms](../Technical%20Documentation/Platforms/) page to explore EarthCODE platform and for help to choose the platform that best suits your research objectives. -## Exploring the EarthCODE Open Science Catalog -After completing your research and preparing your final results for journal publication, your validated data products and code can be published in the EarthCODE Catalog — the [Open Science Catalog](https://opensciencedata.esa.int/). Only finalized outputs that are ready for publication and long-term storage should be submitted. The catalog includes datasets, workflows, and software that follow EarthCODE best practices, most of which originate from integrated platforms. It's your gateway to a wide range of reusable scientific resources, from environmental data to executable workflows.ß +## Exploring the Open Science Catalog +After completing your research and preparing your final results for journal publication, your validated data products and code can be published in the [Open Science Catalog](https://opensciencedata.esa.int/). Only finalized outputs that are ready for publication and long-term storage should be submitted. The catalog includes datasets, workflows, and software that follow EarthCODE best practices, most of which originate from integrated platforms. It's your gateway to a wide range of reusable scientific resources, from environmental data to executable workflows. + ### Validating and Publishing Data to the Catalog {#publishing-anchor} -EarthCODE allows you to validate products and experiments, ensuring they meet reproducibility and scientific standards. If you have an ESA-funded project, you can contribute to the platform by publishing your datasets, software, or experiments, making your work available for the broader community to use. +EarthCODE allows you to validate products, workflows and experiments, ensuring they meet reproducibility and scientific standards. If you have an ESA-funded project, you can contribute to the platform by publishing your datasets, workflows, or experiments, making your work available for the broader community to use. #### How data is published The [Open Science Catalog](https://opensciencedata.esa.int/) is built on the [SpatioTemporal Asset Catalog (STAC)](https://stacspec.org/en), a standardised format for describing geospatial data. To contribute your research, you need to create valid STAC objects and commit them to the [`open-science-catalog-metadata-staging`](https://github.com/EOEPCA/open-science-catalog-metadata-staging) repository on GitHub. These STAC objects, stored as JSON files, will be automatically processed and rendered in the catalog. @@ -166,7 +167,7 @@ You can read more on how to publish data in the [Uploading Your Data](../Technic #### Best Practices EarthCODE makes FAIR publishing the default. Scientists are expected to: -- Deliver publication‑ready outputs: final datasets, workflows, and models, kept in persistent cloud storage with open, clearly stated licences. +- Deliver publication‑ready outputs: final datasets, workflows, and models, kept in persistent cloud storage with open, clearly stated licenses. - Attach rich, standards‑based metadata: STAC/ISO 19115 descriptions with DOIs, spatial‑temporal extents, provenance, and links to source data and code. - Maintain reproducibility: specify software environments, parameters, and lineage, ensuring others can rerun and verify results. @@ -174,7 +175,7 @@ These practices align with the FAIR pillars: | Findable | Accessible | Interoperable | Reusable | |----------|------------|---------------|----------| -| DOIs, indexed metadata | HTTPS, STAC & OGC APIs | NetCDF, GeoTIFF, Zarr, CF vocabularies | Open licences, provenance, community standards | +| DOIs, indexed metadata | HTTPS, STAC & OGC APIs | NetCDF, GeoTIFF, Zarr, CF vocabularies | Open licenses, provenance, community standards | For detailed guide on best practices refer to the [Best Practices Page](../Community%20and%20Best%20Practices/). @@ -191,7 +192,7 @@ EarthCODE integrates FAIR tools and standards at every stage of the research lif | **Development** | EarthCODE provides integrated platforms that provide different options for developing scientific workflows | | **Data, Workflows and Platforms** | EarthCODE describes Data, workflows and platforms as FAIR objects. All items published on the Open Science Catalog follow EarthCODE metadata standards (STAC, OGC) for consistency across platforms and tools. | | **EarthCODE Standard Variable Dictionary** | Shared [vocabulary](https://opensciencedata.esa.int/variables/catalog) for EO variables to ensure semantic consistency across datasets and workflows. | -| **Publishing Automation** | EarthCODE platforms provide automation to support publishing of finalized data and workflows to the EarthCODE catalog | +| **Publishing Automation** | EarthCODE platforms provide automation to support publishing of finalized data and workflows to the Open Science Catalog | | **Publishing and Maintenance**| Users can maintain (or publish) FAIR data and workflows through the EarthCODE publishing GUI. | | **Data Storage** | EarthCODE provides persistent cloud storage via ESA PRR which ensures accessibility and long-term preservation. | | **Finding Products and Workflows** | The Open Science Catalog makes metadata discoverable via STAC API and its webpage search. | @@ -202,9 +203,9 @@ EarthCODE integrates FAIR tools and standards at every stage of the research lif | **Re-Using Workflows** | Users can directly re-use published workflows on the platform used to develop them, compatible platforms (or locally). | | **Code Quality** | Automated pipelines integrate linting, code quality checking and recommendation, and security scanning to ensure code is robust and reusable. | | **Reproducibility** | Published workflows are described in full as experiments, where you have information about inputs and configurations. EarthCODE provides the means to directly execute these experiments and reproduce data products. | -| **Intraoperability** | Shared metadata schemas and API protocols ensure you can execute worklows across platforms and published daat on EarthCODE follows common standards (Zarr, NetCDF) with standard variables (e.g. CF-Conventions). | +| **Intraoperability** | Shared metadata schemas and API protocols ensure you can execute workflows across platforms and published data on EarthCODE follows common standards (Zarr, NetCDF) with standard variables (e.g. CF-Conventions). | | **Visualisation and Findability** | Dashboards and linked visual previews make datasets easier to interpret and explore. | -| **Contacts and Communication**| Published items have contact details in the metadata, EarthCODE additionally provides a chat functionallity in Discourse to connect and discuss. | +| **Contacts and Communication**| Published items have contact details in the metadata, EarthCODE additionally provides a chat functionality in Discourse to connect and discuss. | | **Community** | Discourse forum, with published items linked directly to posts, and best practice documentation foster open collaboration. | diff --git a/pages/Getting started with EarthCODE/Troubleshooting and Support.md b/pages/Getting started with EarthCODE/Troubleshooting and Support.md index 4bcd70d2..935c5cd1 100644 --- a/pages/Getting started with EarthCODE/Troubleshooting and Support.md +++ b/pages/Getting started with EarthCODE/Troubleshooting and Support.md @@ -16,9 +16,9 @@ Google Earth Engine is not yet one of the integrated EarthCODE platforms, and th
-Can I publish pretrained models or anonymised data? +Can I publish pre-trained models or anonymized data? -Yes. The FAIR principles do **not** require assets to be fully open, so you may publish pretrained models or anonymised datasets. Wherever possible, include a small sample dataset to help others reproduce and validate your workflow. +Yes. The FAIR principles do **not** require assets to be fully open, so you may publish pre-trained models or anonymized datasets. Wherever possible, include a small sample dataset to help others reproduce and validate your workflow.
diff --git a/pages/Getting started with EarthCODE/index.md b/pages/Getting started with EarthCODE/index.md index 87f95ca1..85db72da 100644 --- a/pages/Getting started with EarthCODE/index.md +++ b/pages/Getting started with EarthCODE/index.md @@ -64,31 +64,31 @@ Here's how it works: 1. You access services via the [**EarthCODE Portal**](https://earthcode.esa.int). 2. You access necessary data, and develop your workflows, **run your experiments** on integrated EO platforms (with NoR sponsored compute), or locally. 3. You **store results** in the ESA PRR and **publish metadata** to the Open Science Catalog. -4. Anyone can browse the Open Science Catog, find your published data and workflows, reuse and *reproduce them. +4. Anyone can browse the Open Science Catalog, find your published data and workflows, reuse and reproduce them. 5. The community engages via the **EarthCODE Forum**, which is directly connected to the catalog. ::: tip Reusability of Workflows Across Platforms -Users can reproduce, reuse and run your workflows through EarthCODE if they are published via an EarthCODE integrated platform and If the user has sufficient resources through self-sponsorship or sponsorship from the Network of Resources. This is why it is important to consider what tooling/platforms one uses so as to ensure reuse-ability from the start of the project. +Users can reproduce, reuse and run your workflows through EarthCODE if they are published via an EarthCODE integrated platform and if the user has sufficient resources through self-sponsorship or sponsorship from the Network of Resources. This is why it is important to consider what tooling/platforms one uses so as to ensure reuse-ability from the start of the project. ::: ![EarthCODE Components](/img/gettingstarted/earthcode-components.png) The **EarthCODE Portal** ([earthcode.esa.int](https://earthcode.esa.int)), is where users access all EarthCODE services. Through this portal, researchers can explore integrated platforms, access the Open Science Catalog, and engage with peers via the Discourse community forum. The portal also hosts general information about EarthCODE, including updates, events, and documentation. -EarthCODE provides access to a set of **integrated EO cloud platforms**, each offering unique tools and datasets. As an EarthCODE integrated platform they provide common capabilities: logging in with your EarthCODE account, accessing EO data (with variations in data offerings across platforms), a method for developing algorithms (referred to as **workflows** in EarthCODE), an automated way of publishing data and workflows to the EarthCODE Catalog and finally, the means of running EarthCODE published experiments. Access to computing resources and storage on these platforms is sponsored by ESA through the [Network of Resources (NoR)](https://nor-discover.org/). +EarthCODE provides access to a set of **integrated EO cloud platforms**, each offering unique tools and datasets. As an EarthCODE integrated platform they provide common capabilities: logging in with your EarthCODE account, accessing EO data (with variations in data offerings across platforms), a method for developing algorithms (referred to as **workflows** in EarthCODE), an automated way of publishing data and workflows to the Open Science Catalog and finally, the means of running EarthCODE published experiments. Access to computing resources and storage on these platforms is sponsored by ESA through the [Network of Resources (NoR)](https://nor-discover.org/). For those who prefer to work on their own systems—whether personal computers or institutional infrastructure—EarthCODE also supports manual publishing of data and workflows. When your research is complete, you: -- (Optionally) Upload **Your datasets and workflows** to the **ESA Project Results Repository (PRR)**. -- Create and upload **Metadata describing your results** to the **Open Science Catalog**, which link to your data. +- (Optionally) Upload **your datasets and workflows** to the **ESA Project Results Repository (PRR)**. +- Create and upload **metadata describing your results** to the **Open Science Catalog**, which link to your data. :::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 [**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 EarthCODE 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. +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. :::tip The Open Science Catalog only holds the metadata which points to the persistent storage repository with your dataset. ::: @@ -197,8 +197,8 @@ code and documentation of other contributing researchers. -->

Part of a ESA-Funded Research Project

Projects funded by ESA use EarthCODE to discover, develop and publish scientific data and workflows using integrated platforms and FAIR tools. They are supported throughout the full open science lifecycle. They would be interested exploring: