From 82b0f05e69fe7db70da5ef218996e669960acb1a Mon Sep 17 00:00:00 2001 From: Krasen Samardzhiev Date: Fri, 15 Aug 2025 11:31:50 +0100 Subject: [PATCH 1/3] access page --- .../Accessing EarthCODE.md | 58 ++++++++++++++++--- 1 file changed, 49 insertions(+), 9 deletions(-) diff --git a/pages/Getting started with EarthCODE/Accessing EarthCODE.md b/pages/Getting started with EarthCODE/Accessing EarthCODE.md index e65e4275..e7b03226 100644 --- a/pages/Getting started with EarthCODE/Accessing EarthCODE.md +++ b/pages/Getting started with EarthCODE/Accessing EarthCODE.md @@ -2,16 +2,56 @@ order: 3 --- # Accessing EarthCODE -:::warning 🛠️ Page Under Development -Content is being actively developed and updated for this page. EarthCODE's documentation is a living document and will be continuously updated with detailed reviews. -::: -## Creating an Account -Step-by-step instructions for creating an EarthCODE user account. +This subsection explains how to access the core EarthCODE features: -## Logging In -Instructions on how to log in to the EarthCODE Portal and manage your user profile. +1. The integrated platforms +2. The ESA Project Results Repository +3. The Open Science Catalog +4. The EarthCODE Forum +5. The EarthCODE portal -## Navigating the Portal -An overview of the user interface and how to access key features like data discovery, tool access, and community forums. +The access requirements and options depend on each feature and the type of action you wish to perform. Additionally, some access options can be managed indirectly through the EarthCODE portal. + +## Open access functions +Browsing and exploring the Open Science Catalog, the ESA Project Results Repository (ESA PRR), and the EarthCODE Forum are freely accessible to anyone via their respective websites. Furthermore, no login is required for downloading data from the Open Science Catalog or the ESA PRR. + +For detailed instructions, see the guides and example pages for each: +- [Open Science catalog (OSC)](../Technical%20Documentation/Open%20Science%20Catalog%20(OSC)/Discovering%20Resources.md>) +- [ESA Projects Results Repository (PRR)](../Technical%20Documentation/ESA%20Project%20Results%20Repository%20(PRR)/) +- [EarthCODE forum](../Community%20and%20Collaboration/Getting%20Started%20With%20The%20EarthCODE%20Discourse/) + +## Authenticated Options + +If you wish to add, remove, or update information in the Open Science Catalog, the ESA PRR, or the EarthCODE Forum, you must create an account. + +Similarly, an account is required to access the EarthCODE portal and the integrated platform features. + +### Creating an Account +You can use a GitHub account to log in to all of these features. + +To create a GitHub account, follow the [GitHUB user guide](https://docs.github.com/en/get-started/start-your-journey/creating-an-account-on-github). Once created, you can use the same account to log in to all EarthCODE features. + +### Accessing funcitons + +After creating an account and logging in, your next steps depend on the feature you want to use: + +- [Open Science Catalog](../Technical%20Documentation/Open%20Science%20Catalog%20(OSC)/Contributing%20to%20the%20Open%20Science%20Catalog.md) +- [ESA PRR](../Technical%20Documentation/ESA%20Project%20Results%20Repository%20(PRR)/Uploading%20To%20PRR.md) +- [EarthCODE Forum](../Community%20and%20Collaboration/Getting%20Started%20With%20The%20EarthCODE%20Discourse/) +- [Integrated Platforms](../Technical%20Documentation/Platforms/) + +## EarthCODE portal +The [EarthCODE portal](https://earthcode.esa.int) allows you to access to an integrated Jupyter Lab environment, in order for you to quickly get started with scientific research and experiments. You can also you it to access this documentation page and interactively run all [OSC and PRR examples](https://esa-earthcode.github.io/examples/). + +Furthermore, the EarthCODE workspace offers you access to the Open Science Catalog Editor, a user-friendly tool which can be used to add, modify and delete the contents of the Open Science Catalog. It is a convenient helper which abstracts the complexity of working with the file structure of STAC catalogs. + +### Accessing the Portal +As with other EarthCODE features, you must use a GitHub account to log in to the portal. + +### Navigating the Portal + +Once you are logged in, you can access all features directly through the portal or find links to them. + +When you log in, you will find the navigation bar on the left-hand side, containing links to all available resources and tasks, while the middle pane serves as the main interactive area, changing depending on the option you select. \ No newline at end of file From 2b4ae30b3e5b7c9d3eddae3205523aa6e1fef8e6 Mon Sep 17 00:00:00 2001 From: Krasen Samardzhiev Date: Fri, 15 Aug 2025 16:08:11 +0100 Subject: [PATCH 2/3] 10minutes --- .../10 minutes to EarthCODE.md | 131 ++++++------------ .../Accessing EarthCODE.md | 13 +- pages/Getting started with EarthCODE/index.md | 2 +- 3 files changed, 53 insertions(+), 93 deletions(-) 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 22bb8792..d19b0f8d 100644 --- a/pages/Getting started with EarthCODE/10 minutes to EarthCODE.md +++ b/pages/Getting started with EarthCODE/10 minutes to EarthCODE.md @@ -3,40 +3,51 @@ order: 2 --- # 10 minutes to EarthCODE -This quick-start guide is designed to help you begin working with EarthCODE in just a few minutes. Whether you're new to Earth Science, a researcher, or a developer, EarthCODE provides a collaborative, open development environment for efficient access to Earth observation data, workflows, and computational platforms. +This quick-start guide is designed to help you begin working with EarthCODE in just a few minutes. 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 and then go into more detail about the core functionality of EarthCODE. + ## What is EarthCODE? -EarthCODE is a strategic initiative by the **European Space Agency (ESA)** designed to empower researchers in Earth System Science with FAIR tools and infrastructure, sponsored EO cloud platforms, cloud services. +EarthCODE is a strategic initiative by the **European Space Agency (ESA)** designed to empower researchers in Earth System Science with FAIR tools and infrastructure, sponsored EO cloud platforms and cloud services: +1. You can **access data, develop your workflows and run your experiments** on [integrated EO platforms](https://testing.earthcode.eox.at/computational-research). [Network of Resources (NoR)](https://nor-discover.org/) sponsored compute is also available. +2. You can **store results** in the [ESA Project Results repository (PRR)](https://esa-earthcode.github.io/examples/index-1/). +3. You can **explore state-of-the-art data, workflows, and project information** available on the [Open Science Catalog](https://opensciencedata.esa.int/). You can also [publish](../Technical%20Documentation/Open%20Science%20Catalog%20(OSC)/Contributing%20to%20the%20Open%20Science%20Catalog.md) your own data, workflows, and project information to it. +5. You can **engage** the EarthCODE and broader EO community [EarthCODE Forum](https://discourse-earthcode.eox.at/), which is directly connected to the catalog. + + +## Accessing EarthCODE resources + +Browsing and exploring the Open Science Catalog, the ESA Project Results Repository (ESA PRR), and the EarthCODE Forum are freely accessible to anyone via their respective websites. Furthermore, no login is required for downloading data from the Open Science Catalog or the ESA PRR. -## Accessing EarthCODE -To get started, sign in using your [GitHub](https://github.com/) account. EarthCODE provides secure authentication for accessing resources across platforms, including the [EarthCODE Forum](https://discourse-earthcode.eox.at). Once authenticated, you'll have access to all the tools, discussions, and data you need across EarthCODE’s integrated platforms. +If you wish to add, remove, or update information in the Open Science Catalog, the ESA PRR, or EarthCODE Forum, you must create a GitHub account. -Anyone can explore the [EarthCODE Portal](https://earthcode.esa.int), the [Open Science Catalog](https://opensciencedata.esa.int/catalog) or the [EarthCODE Forum](https://discourse-earthcode.eox.at) without signing in—just open the EarthCODE Portal and browse. +Similarly, you need an account to access the integrated platforms or the EarthCODE portal. + +There is not authentication required to explore or download information from the [EarthCODE Portal](https://earthcode.esa.int), the [Open Science Catalog](https://opensciencedata.esa.int/catalog), the [EarthCODE Forum](https://discourse-earthcode.eox.at), or the [ESA Project Results Repository (PRR)](https://eoresults.esa.int/). + +If you want to publish workflows and code, contribute to the forum, use integrated platforms, the EarthCODE workspace you need a GitHub account. + +See [Accessing EarthCODE](../Getting%20started%20with%20EarthCODE/Accessing%20EarthCODE.md) for more information. -If you want to publish workflows and code, contribute to the forum, or use integrated platforms you need to sign in to the portal with your GitHub account. To publish scientific data to EarthCODE your project must be sponsored by ESA. :::tip New to GitHub? First [create an account](https://github.com/join), then follow the Creating an Account and Logging In steps below to connect it to EarthCODE and start contributing. ::: -See [Accessing EarthCODE](../Getting%20started%20with%20EarthCODE/Accessing%20EarthCODE.md) for more information. ## Suggested Paths -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 looking to contribute to the Open Science Catalog +### Researchers looking to contribute to the Open Science Catalog -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)). +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**]. ### 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)). +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 +### New Researchers Starting a Project / Looking for a Platform -If you're just starting a new research project, it’s important to choose the **right platform and tools** from the beginning. Your path depends on several factors, including: +If you're just starting a new research project, it’s important to choose the **right EarthCODE platform and tools** from the beginning. Your path depends on several factors, including: - The **type of data** you intend to use. - Your **workflow preferences** (e.g., no-code platforms vs. Jupyter Notebooks). - Whether you need **machine learning capabilities**. @@ -48,16 +59,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. -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 - -If you’re here to **explore existing research outputs**, the Open Science Catalog is your primary destination. The catalog allows you to: -- **Search for projects** by area, variable, theme, and more. -- Access **datasets, workflows, and documentation** directly from published research. -- View detailed **metadata and provenance information** for each project. - -Go to the [**Open Science Catalog**](https://opensciencedata.esa.int/) to start browsing and discovering data relevant to your interests. Whether you're looking for specific datasets, workflows, or scientific results, the catalog provides a centralized and well-organized resource. +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. ## Choosing a Platform @@ -134,82 +136,39 @@ 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 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, 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. - -Each STAC object should include all necessary references to ensure the reproducibility of your research, such as: -- **Result data** - hosted on open-access data storage provided by ESA -- **Input data** - with full specification about spatial and temporal extent, bands, format, etc. This can also be part of the workflow. -- **Workflows** - executable processes that, when combined with input data, reproduce the results. - -To improve discoverability, STAC objects also include metadata fields such as: -- Associated project -- Geospatial extent -- Variables -- Themes -- Earth Observation (EO) Mission (e.g. Sentinel, Landsat) -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. +## Publishing to the Open Science Catalog -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/). +To publish your scientific results to the Open Science Catalog, you must: +1. Host your **datasets**, **code** and **documentation** online. -#### 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 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. - -These practices align with the FAIR pillars: - -| Findable | Accessible | Interoperable | Reusable | -|----------|------------|---------------|----------| -| 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/). +::: details Proprietary data +Sometimes parts of the data and workflows are protected or private. Although not open, these experiments can still become FAIR and added to the catalogue. The process for adding the entries is the same, until the review, when the EarthCODE team will reach out with specific questions regarding your data. +::: -### FAIR-enabling tools in EarthCODE +2. Create entries (STAC Collections) that describe the **dataset files**, **code** and their relationships to existing items in the catalog. These entries follow the [OSC STAC specification](https://github.com/stac-extensions/osc). -EarthCODE integrates FAIR tools and standards at every stage of the research lifecycle to make FAIR the default—without extra effort from scientists. +3. Request to add them to the PRR via one of the three options described below. +See the [Contributing guide](../Technical%20Documentation/Open%20Science%20Catalog%20(OSC)/Contributing%20to%20the%20Open%20Science%20Catalog.md) for a detailed exaplanation or go directly to the [examples](https://esa-earthcode.github.io/examples/index-2/). - -| FAIR Tools | Description | -|-------------------------------|-------------| -| **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 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. | -| **DOI Assignment** | EarthCODE generates DOIs for published data on the Open Science Catalog (in development). | -| **Data Access** | EarthCODE published items provide data access. Data is served over HTTPS; metadata remains accessible even if access is restricted. | -| **Accessing Products** | Published products are indexed in catalogs and linked to source storage for direct download or API access. | -| **Accessing Workflows** | Workflows are versioned and stored in GitHub, linked with executable environments (platforms) for reproducibility. | -| **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 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 functionality in Discourse to connect and discuss. | -| **Community** | Discourse forum, with published items linked directly to posts, and best practice documentation foster open collaboration. | +## Storing data in the ESA Project Results Repository +The [ESA Project Results Repository (PRR)](https://eoresults.esa.int/) provides long term storage for research outcomes. It provides access to data, workflows, experiments and documentation from ESA Projects organised across Collections, accessible via the STAC API. To upload you have to: +1. Generate a STAC Collection that is associated to your files. The STAC Collection provides metadata about your files and makes them searchable and machine readable. +2. Contact the [EarthCODE team](earthcode@esa.int) to request the upload. +3. Transfer the data and metadata to the EarthCODE team, who will upload it to the PRR. +Head to the [PRR guide](../Technical%20Documentation/ESA%20Project%20Results%20Repository%20(PRR)/) to see more details and examples how to generate metadata and upload it . -## Who Can Publish? +## Exploring the Open Science Catalog -Anyone with an ESA-funded project is encouraged to publish in EarthCODE. We especially welcome contributions from those part of the ESA Science Clusters, as collaboration among these projects helps promote sharing and innovation in Earth Science research. If you are not ESA-funded and would like to publish your workflows or data to EarthCODE, contact us at: +The [Open Science Catalog](https://opensciencedata.esa.int/) 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 earth observation data to executable workflows. +You can head directly to the website to explore the portal, there is no login required. +You can find more information about the OSC functionality in the [Discovering OSC Resources guide](../Technical%20Documentation/Open%20Science%20Catalog%20(OSC)/Discovering%20Resources.md). diff --git a/pages/Getting started with EarthCODE/Accessing EarthCODE.md b/pages/Getting started with EarthCODE/Accessing EarthCODE.md index e7b03226..27dc7451 100644 --- a/pages/Getting started with EarthCODE/Accessing EarthCODE.md +++ b/pages/Getting started with EarthCODE/Accessing EarthCODE.md @@ -9,12 +9,13 @@ This subsection explains how to access the core EarthCODE features: 2. The ESA Project Results Repository 3. The Open Science Catalog 4. The EarthCODE Forum -5. The EarthCODE portal +5. The EarthCODE workspace -The access requirements and options depend on each feature and the type of action you wish to perform. Additionally, some access options can be managed indirectly through the EarthCODE portal. +The access requirements and options depend on each feature and the type of action you wish to perform. Additionally, some access options can be managed indirectly through the [EarthCODE portal](https://earthcode.esa.int). ## Open access functions + Browsing and exploring the Open Science Catalog, the ESA Project Results Repository (ESA PRR), and the EarthCODE Forum are freely accessible to anyone via their respective websites. Furthermore, no login is required for downloading data from the Open Science Catalog or the ESA PRR. For detailed instructions, see the guides and example pages for each: @@ -42,15 +43,15 @@ After creating an account and logging in, your next steps depend on the feature - [EarthCODE Forum](../Community%20and%20Collaboration/Getting%20Started%20With%20The%20EarthCODE%20Discourse/) - [Integrated Platforms](../Technical%20Documentation/Platforms/) -## EarthCODE portal -The [EarthCODE portal](https://earthcode.esa.int) allows you to access to an integrated Jupyter Lab environment, in order for you to quickly get started with scientific research and experiments. You can also you it to access this documentation page and interactively run all [OSC and PRR examples](https://esa-earthcode.github.io/examples/). +## EarthCODE workspace +The [EarthCODE workspace](https://workspace.earthcode.eox.at) allows you to access to an integrated Jupyter Lab environment, in order for you to quickly get started with scientific research and experiments. You can also you it to access this documentation page and interactively run all [OSC and PRR examples](https://esa-earthcode.github.io/examples/). Furthermore, the EarthCODE workspace offers you access to the Open Science Catalog Editor, a user-friendly tool which can be used to add, modify and delete the contents of the Open Science Catalog. It is a convenient helper which abstracts the complexity of working with the file structure of STAC catalogs. -### Accessing the Portal +### Accessing the Workspace As with other EarthCODE features, you must use a GitHub account to log in to the portal. -### Navigating the Portal +### Navigating the Workspace Once you are logged in, you can access all features directly through the portal or find links to them. diff --git a/pages/Getting started with EarthCODE/index.md b/pages/Getting started with EarthCODE/index.md index 64df486a..258639e1 100644 --- a/pages/Getting started with EarthCODE/index.md +++ b/pages/Getting started with EarthCODE/index.md @@ -10,7 +10,7 @@ EarthCODE (Earth Science Collaborative Open Development Environment) provides th
  1. You can access data, and develop your workflows, run your experiments on - integrated EO platforms with + integrated EO platforms with Network of Resources (NoR) sponsored compute.
  2. From 4ab68719df1494ebc30ecea1a768e9da8d571923 Mon Sep 17 00:00:00 2001 From: Krasen Samardzhiev Date: Fri, 15 Aug 2025 17:51:15 +0100 Subject: [PATCH 3/3] training --- .../TrainingResources.md | 43 ------------- .../Tutorials and Learning Pathways.md | 63 +++++++++---------- .../Videos and Webinars.md | 8 --- pages/Training and Resources/index.md | 2 - 4 files changed, 31 insertions(+), 85 deletions(-) delete mode 100644 pages/Training and Resources/TrainingResources.md delete mode 100644 pages/Training and Resources/Videos and Webinars.md diff --git a/pages/Training and Resources/TrainingResources.md b/pages/Training and Resources/TrainingResources.md deleted file mode 100644 index e5aaf335..00000000 --- a/pages/Training and Resources/TrainingResources.md +++ /dev/null @@ -1,43 +0,0 @@ ---- -order: 0 ---- - -# EarthCODE and Recommended Materials - -At EarthCODE, we provide high-quality, accessible training materials to help users maximize the potential of our platform. Our goal is to offer a comprehensive learning experience that supports researchers at every stage of their journey—whether you’re just beginning or aiming to master advanced features. - -## EarthCODE Training Materials -We offer a curated collection of training materials developed and maintained by EarthCODE, designed to guide you through using our platform effectively. These materials are hosted on our **EarthCODE Training Portal**, available via GitHub. They include: - -- **Step-by-step tutorials**: These cover everything from setting up your environment to working with Earth observation data, creating workflows, and publishing research. These tutorials are ideal for beginners and provide foundational knowledge. -- **Jupyter Notebooks**: Interactive, hands-on notebooks that enable you to apply what you've learned in real-time. These include exercises on accessing and analyzing Earth observation data and building custom workflows. -- **Case studies and practical examples**: Real-world examples that show how EarthCODE can be used to solve specific scientific challenges. These case studies cover topics like climate science, geospatial analysis, and data-driven decision-making. - -In addition to these, we also offer **NoR Training**, a specialized resource designed to help you leverage the **Network of Resources (NoR)** within EarthCODE. The NoR is a key part of our collaborative research infrastructure, enabling users to access, manage, and share datasets, workflows, and results across different platforms. Through **NoR Training**, you will learn how to: - -- Efficiently manage and access resources within EarthCODE's ecosystem. -- Integrate external resources and data sources into your workflows. -- Connect with other researchers and collaborate effectively using EarthCODE’s tools. - -NoR Training is a critical part of understanding how to maximize EarthCODE's potential for collaborative and scalable research. You can find **NoR Training materials** in the **EarthCODE Training Portal**, where we provide detailed guides and practical examples on how to use the NoR network. - -## Recommended External Resources -While EarthCODE offers comprehensive training specific to our platform, we also acknowledge the importance of supplementary materials. Several excellent external resources cover topics like data cubes, Earth observation, and open science, which complement the training provided by EarthCODE. While not directly maintained by EarthCODE, these resources are recommended for users seeking to expand their knowledge. - -Some of the key external resources include: -- **[Cubes & Clouds](https://eo-college.org/courses/cubes-and-clouds/)**: A course focused on data cubes, cloud computing, and open science in Earth observation. This aligns well with EarthCODE’s mission to promote open access to scientific data. -- **External Platforms and Tools**: We also highlight other platforms like the Copernicus Data Space Ecosystem (CDSE) and Euro Data Cube (EDC), which offer additional learning materials that integrate with EarthCODE. - -## Where to Find the Materials -- **EarthCODE Training Materials**: All of the EarthCODE-developed training materials, including NoR Training, are available on our **GitHub repository**. You can explore tutorials, case studies, Jupyter Notebooks, and NoR Training materials here: [EarthCODE Training Portal](#). -- **External Training Resources**: Links to recommended external training materials like "Cubes & Clouds" and others can be found in the **Training Materials Section** of the EarthCODE documentation under "Recommended External Resources." - -By combining EarthCODE’s training materials with these trusted external resources, you will be equipped to tackle complex research tasks, collaborate with others, and contribute to impactful scientific work. Whether you’re learning the basics or diving into advanced workflows, these materials are designed to provide flexible, comprehensive support for your learning journey. - -## Upcoming Training Events and Recordings of Past Sessions -Stay updated on upcoming training events, webinars, and workshops hosted by EarthCODE. These events are designed to provide deeper insights into the platform, showcase new features, and help users enhance their skills. - -For access to past training sessions, we provide recordings and other relevant materials, allowing you to learn at your own pace, even if you missed a live session. - -For the latest news on upcoming training events and to access past session recordings, visit the **EarthCODE News and Updates** section on our [EarthCODE website](https://earthcode.esa.int/#latest-news-updates). Be sure to check back regularly for updates on upcoming sessions that may interest you. - diff --git a/pages/Training and Resources/Tutorials and Learning Pathways.md b/pages/Training and Resources/Tutorials and Learning Pathways.md index 304e4e75..444f8a5d 100644 --- a/pages/Training and Resources/Tutorials and Learning Pathways.md +++ b/pages/Training and Resources/Tutorials and Learning Pathways.md @@ -1,47 +1,46 @@ # Tutorials and Learning Pathways -:::warning 🛠️ Page Under Development -Content is being actively developed and updated for this page. EarthCODE's documentation is a living document and will be continuously updated with detailed reviews. -::: -In this section, we group tutorials into different learning pathways to help you progressively build the skills needed to master EarthCODE. Whether you're just starting or aiming to become an expert, each pathway is designed to guide you through key concepts and features of EarthCODE. You’ll gain practical, hands-on experience as you move from basic to advanced topics, ensuring that you can apply your learning effectively in real-world research projects. -## Start Simple -For those new to EarthCODE, this pathway covers the basics to get you up and running quickly. Learn the fundamental features, how to set up your environment, and perform simple tasks that are essential for beginning your EarthCODE journey. You’ll start with simple tasks like accessing and browsing data, and gradually move toward publishing data and workflows. Example tutorials may include Jupyter Notebooks for tasks such as: +In this section, we highlight tutorials, learning pathways, and resources designed to help you progressively build the skills needed to master EarthCODE capabilities. -- Accessing public datasets from Earth observation platforms. -- Browsing data using simple queries. -- Executing basic analysis and visualizing results. -- [Cubes & Clouds](https://eo-college.org/courses/cubes-and-clouds/): This course teaches the concepts of data cubes, cloud platforms, and open science in the context of earth observation. +## Starting Point -## Grow Your Skills -Once you're familiar with the basics, this pathway takes you deeper into EarthCODE. Explore more advanced functionalities, such as configuring workflows, working with larger datasets, and collaborating with other researchers. You’ll gain practical experience in applying EarthCODE’s tools to enhance your research projects. Example tutorials may include: +The fastest way to gain value from EarthCODE is to first become familiar with its core capabilities by following the [Getting Started with EarthCODE guide](../Getting%20started%20with%20EarthCODE/). Once you understand your role and what EarthCODE can offer, you can explore the relevant guide or go directly to the [Examples Bank](https://esa-earthcode.github.io/examples/). Finding an example that closely matches your data, workflow, or problem is often the best starting point, as most examples are drawn from real-world projects. -- Setting up and executing more complex workflows using different platforms. -- Collaborative data sharing and version control. -- Publishing results and workflows to the Open Science Catalog. +At any point during this process, you can engage in the forum and ask for help. If you are using a platform, you can also contact them directly. -You'll also work with Jupyter Notebooks for more advanced tasks like analyzing geospatial data and automating workflows. +## Next Steps -## Excel with EarthCODE -This pathway is for advanced users looking to maximize the potential of EarthCODE. Learn best practices for optimizing workflows, managing large datasets, and contributing to the EarthCODE community. You’ll also explore expert-level features to take your research to the next level, fostering innovation and collaboration. End-to-end workflows will be demonstrated using a set of Jupyter Notebooks across different platforms (e.g., Copernicus Data Space, Euro Data Cube) to execute comprehensive experiments, including: -- Data preprocessing and advanced analytics. -- Creating and managing large-scale scientific workflows. -- Publishing and sharing results in collaborative research environments. +After learning the basics, you can explore EarthCODE in greater depth. This includes reviewing the [Best Practices guide](../Community%20and%20Best%20Practices/) and gaining a thorough understanding of the FAIR principles. Based on what you learn from the guide and your use case, you may want to update your data or workflows to align more closely to FAIR principles. -For real-world examples, check out these case studies: +At this stage, you can also explore other existing projects to learn from their approaches. In addition, you can examine more advanced examples to discover how others are applying EarthCODE capabilities. -- Case Study 1 - [Sentinel-1 for Science Amazonas](https://project.gisat.cz/s14scienceAmazonas/): In this ESA-funded project, EarthCODE and openEO were used to assess how Sentinel-1 imagery can estimate forest carbon losses and gains due to land use and land cover changes in the Amazon basin. This project emphasizes EarthCODE's integration with external platforms to process and analyze large geospatial datasets. -- Case Study 2 - [SARwave](https://www.sarwave.org/): This case study demonstrates the use of EarthCODE in creating and refining S1L1B and S1L2 products. By collocating data from the WW3 model with Sentinel-1 (S1L1B) products, researchers can generate S1L1C and ultimately refined wind and wave products. These advanced processing steps are essential for analyzing sea state conditions, such as wave height and period, through data sources like SARwave and the Euro Data Cube platform. +Furthermore, you can explore the following advanced materials: -Explore more case studies in the [EarthCODE Gallery](./Gallery) to see how other users are applying EarthCODE in various fields of research. +## Recommended Materials and Training -## NoR Training: A Key to Collaborative Research and Resource Management -As part of your journey with EarthCODE, NoR Training is an essential component to learn how to fully leverage the Network of Resources (NoR). The NoR network enables users to connect with various data resources, tools, and services within EarthCODE, as well as collaborate effectively with other researchers across platforms. Understanding NoR is critical because it: +### Courses -- Facilitates efficient resource management by helping you access and share datasets, workflows, and research outputs. -- Provides the foundation for seamless collaboration within the EarthCODE community, making it easier to contribute to joint research projects and innovations. -- Teaches you how to connect your workflows to external resources, increasing the scope and scalability of your research. +- **[Cubes & Clouds](https://eo-college.org/courses/cubes-and-clouds/)**: A course focused on data cubes, cloud computing, and open science in Earth observation. This aligns well with EarthCODE’s mission to promote open access to scientific data. -This training will guide you through the process of utilizing NoR to access and manage resources, connect with other researchers, and publish your findings. By learning how to integrate NoR with other EarthCODE tools, you will be equipped to conduct high-impact, collaborative research. +- **External Platforms and Tools**: We also recommend exploring platforms such as the Copernicus Data Space Ecosystem (CDSE) and Euro Data Cube (EDC), which provide additional learning materials that integrate with EarthCODE. -Watch this short [YouTube video](https://youtu.be/IJEZRSac6EE?feature=shared) to learn more about the NoR application process and how to apply for sponsorship, including up to €5,000 in funding to spend on Earth Observation services. +### Examples + +The [Examples Bank](https://esa-earthcode.github.io/examples/) will show you how to carry out a variety of tasks. All examples are based on actual use cases from other ESA projects and demonstrate how they are using EarthCODE. Currently, the focus is on publishing to the Open Science Catalog and uploading data to the ESA PRR, but the examples are continuously expanding. + +All examples are runnable directly through the [EarthCODE workspace](https://workspace.earthcode.eox.at). + +### Documentation + +You can use the documentation provided on this website to learn more about EarthCODE. For deeper insight into the technical aspects of the project, visit the GitHub repositories of the underlying components, such as the [OSC Technical Design](https://github.com/ESA-EarthCODE/open-science-catalog-metadata/wiki/System-Design-Document-%E2%80%90-v1.0.0). + +### Training, News, and Updates + +For the latest news on upcoming training events and to access past session recordings, visit the **EarthCODE News and Updates** section on our [EarthCODE website](https://earthcode.esa.int/#latest-news-updates) and the [Community Engagement section on the forum](https://discourse-earthcode.eox.at/c/community-engagement/11). + +You can request custom training through the NoR page by contacting the platform providers directly. + +### Videos and Webinars + +- [FOSS4G:UK South West 2024 | Richard Conway & Garin Smith | EarthCODE and EOEPCA+](https://www.youtube.com/watch?v=JUL-lDt3vM4) diff --git a/pages/Training and Resources/Videos and Webinars.md b/pages/Training and Resources/Videos and Webinars.md deleted file mode 100644 index f592b014..00000000 --- a/pages/Training and Resources/Videos and Webinars.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -order: 1 ---- -# Videos and Webinars -:::warning 🛠️ Page Under Development -Content is being actively developed and updated for this page. EarthCODE's documentation is a living document and will be continuously updated with detailed reviews. -::: -A collection of training videos and recorded sessions. diff --git a/pages/Training and Resources/index.md b/pages/Training and Resources/index.md index 2efcfd5f..b70681a0 100644 --- a/pages/Training and Resources/index.md +++ b/pages/Training and Resources/index.md @@ -6,7 +6,5 @@ order: 4 In the "Training and Resources" section, users will find everything they need to deepen their understanding and make the most of EarthCODE. This includes step-by-step tutorials, engaging video guides, a gallery of interactive Jupyter notebooks showcasing real-world use cases, and information about upcoming training events and webinars. Whether you're new to EarthCODE or looking to refine your skills, this section provides practical tools and learning opportunities to help you master the platform and advance your research. - [Tutorials](./Tutorials%20and%20Learning%20Pathways.md) -- [Network of Resources Sponsorship](./NoR.md) -- [Videos and Webinars](./Videos%20and%20Webinars.md) - [Gallery](./Gallery.md) - [Examples](https://esa-earthcode.github.io/examples/)