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
118 changes: 43 additions & 75 deletions pages/Getting started with EarthCODE/10 minutes to EarthCODE.md

Large diffs are not rendered by default.

59 changes: 50 additions & 9 deletions pages/Getting started with EarthCODE/Accessing EarthCODE.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,16 +2,57 @@
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 workspace

## 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](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:
- [Open Science catalog (OSC)](../Technical%20Documentation/Open%20Science%20Catalog/Discovering%20Resources.md)
- [ESA Projects Results Repository (PRR)](../Technical%20Documentation/ESA%20Project%20Results%20Repository/)
- [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/Contributing%20to%20the%20Open%20Science%20Catalog.md)
- [ESA PRR](../Technical%20Documentation/ESA%20Project%20Results%20Repository/Uploading%20To%20PRR.md)
- [EarthCODE Forum](../Community%20and%20Collaboration/Getting%20Started%20With%20The%20EarthCODE%20Discourse/)
- [Integrated Platforms](../Technical%20Documentation/Platforms/)

## 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 Workspace
As with other EarthCODE features, you must use a GitHub account to log in to the portal.

### Navigating the Workspace

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.
2 changes: 1 addition & 1 deletion pages/Getting started with EarthCODE/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ EarthCODE (Earth Science Collaborative Open Development Environment) provides th
<ol>
<li>
You can <strong>access data, and develop your workflows, run your experiments</strong> on
<a href="https://testing.earthcode.eox.at/computational-research" target="_blank">integrated EO platforms</a> with
<a href="https://earthcode.esa.int/computational-research" target="_blank">integrated EO platforms</a> with
<a href="https://nor-discover.org/" target="_blank">Network of Resources (NoR)</a> sponsored compute.
</li>
<li>
Expand Down
43 changes: 0 additions & 43 deletions pages/Training and Resources/TrainingResources.md

This file was deleted.

63 changes: 31 additions & 32 deletions pages/Training and Resources/Tutorials and Learning Pathways.md
Original file line number Diff line number Diff line change
@@ -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)
8 changes: 0 additions & 8 deletions pages/Training and Resources/Videos and Webinars.md

This file was deleted.

2 changes: 0 additions & 2 deletions pages/Training and Resources/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/)
Loading