Skip to content

Commit 1776533

Browse files
authored
Merge pull request #132 from u3ks/main
access page
2 parents 52b8736 + b84a6c1 commit 1776533

File tree

7 files changed

+125
-170
lines changed

7 files changed

+125
-170
lines changed

pages/Getting started with EarthCODE/10 minutes to EarthCODE.md

Lines changed: 43 additions & 75 deletions
Large diffs are not rendered by default.

pages/Getting started with EarthCODE/Accessing EarthCODE.md

Lines changed: 50 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,57 @@
22
order: 3
33
---
44
# Accessing EarthCODE
5-
:::warning 🛠️ Page Under Development
6-
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.
7-
:::
85

9-
## Creating an Account
10-
Step-by-step instructions for creating an EarthCODE user account.
6+
This subsection explains how to access the core EarthCODE features:
117

12-
## Logging In
13-
Instructions on how to log in to the EarthCODE Portal and manage your user profile.
8+
1. The integrated platforms
9+
2. The ESA Project Results Repository
10+
3. The Open Science Catalog
11+
4. The EarthCODE Forum
12+
5. The EarthCODE workspace
1413

15-
## Navigating the Portal
16-
An overview of the user interface and how to access key features like data discovery, tool access, and community forums.
14+
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).
1715

16+
17+
## Open access functions
18+
19+
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.
20+
21+
For detailed instructions, see the guides and example pages for each:
22+
- [Open Science catalog (OSC)](../Technical%20Documentation/Open%20Science%20Catalog/Discovering%20Resources.md)
23+
- [ESA Projects Results Repository (PRR)](../Technical%20Documentation/ESA%20Project%20Results%20Repository/)
24+
- [EarthCODE forum](../Community%20and%20Collaboration/Getting%20Started%20With%20The%20EarthCODE%20Discourse/)
25+
26+
## Authenticated Options
27+
28+
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.
29+
30+
Similarly, an account is required to access the EarthCODE portal and the integrated platform features.
31+
32+
### Creating an Account
33+
You can use a GitHub account to log in to all of these features.
34+
35+
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.
36+
37+
### Accessing funcitons
38+
39+
After creating an account and logging in, your next steps depend on the feature you want to use:
40+
41+
- [Open Science Catalog](../Technical%20Documentation/Open%20Science%20Catalog/Contributing%20to%20the%20Open%20Science%20Catalog.md)
42+
- [ESA PRR](../Technical%20Documentation/ESA%20Project%20Results%20Repository/Uploading%20To%20PRR.md)
43+
- [EarthCODE Forum](../Community%20and%20Collaboration/Getting%20Started%20With%20The%20EarthCODE%20Discourse/)
44+
- [Integrated Platforms](../Technical%20Documentation/Platforms/)
45+
46+
## EarthCODE workspace
47+
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/).
48+
49+
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.
50+
51+
### Accessing the Workspace
52+
As with other EarthCODE features, you must use a GitHub account to log in to the portal.
53+
54+
### Navigating the Workspace
55+
56+
Once you are logged in, you can access all features directly through the portal or find links to them.
57+
58+
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.

pages/Getting started with EarthCODE/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ EarthCODE (Earth Science Collaborative Open Development Environment) provides th
1010
<ol>
1111
<li>
1212
You can <strong>access data, and develop your workflows, run your experiments</strong> on
13-
<a href="https://testing.earthcode.eox.at/computational-research" target="_blank">integrated EO platforms</a> with
13+
<a href="https://earthcode.esa.int/computational-research" target="_blank">integrated EO platforms</a> with
1414
<a href="https://nor-discover.org/" target="_blank">Network of Resources (NoR)</a> sponsored compute.
1515
</li>
1616
<li>

pages/Training and Resources/TrainingResources.md

Lines changed: 0 additions & 43 deletions
This file was deleted.
Lines changed: 31 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -1,47 +1,46 @@
11
# Tutorials and Learning Pathways
2-
:::warning 🛠️ Page Under Development
3-
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.
4-
:::
5-
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.
62

7-
## Start Simple
8-
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:
3+
In this section, we highlight tutorials, learning pathways, and resources designed to help you progressively build the skills needed to master EarthCODE capabilities.
94

10-
- Accessing public datasets from Earth observation platforms.
11-
- Browsing data using simple queries.
12-
- Executing basic analysis and visualizing results.
13-
- [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.
5+
## Starting Point
146

15-
## Grow Your Skills
16-
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:
7+
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.
178

18-
- Setting up and executing more complex workflows using different platforms.
19-
- Collaborative data sharing and version control.
20-
- Publishing results and workflows to the Open Science Catalog.
9+
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.
2110

22-
You'll also work with Jupyter Notebooks for more advanced tasks like analyzing geospatial data and automating workflows.
11+
## Next Steps
2312

24-
## Excel with EarthCODE
25-
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:
2613

27-
- Data preprocessing and advanced analytics.
28-
- Creating and managing large-scale scientific workflows.
29-
- Publishing and sharing results in collaborative research environments.
14+
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.
3015

31-
For real-world examples, check out these case studies:
16+
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.
3217

33-
- 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.
34-
- 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.
18+
Furthermore, you can explore the following advanced materials:
3519

36-
Explore more case studies in the [EarthCODE Gallery](./Gallery) to see how other users are applying EarthCODE in various fields of research.
20+
## Recommended Materials and Training
3721

38-
## NoR Training: A Key to Collaborative Research and Resource Management
39-
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:
22+
### Courses
4023

41-
- Facilitates efficient resource management by helping you access and share datasets, workflows, and research outputs.
42-
- Provides the foundation for seamless collaboration within the EarthCODE community, making it easier to contribute to joint research projects and innovations.
43-
- Teaches you how to connect your workflows to external resources, increasing the scope and scalability of your research.
24+
- **[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.
4425

45-
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.
26+
- **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.
4627

47-
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.
28+
### Examples
29+
30+
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.
31+
32+
All examples are runnable directly through the [EarthCODE workspace](https://workspace.earthcode.eox.at).
33+
34+
### Documentation
35+
36+
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).
37+
38+
### Training, News, and Updates
39+
40+
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).
41+
42+
You can request custom training through the NoR page by contacting the platform providers directly.
43+
44+
### Videos and Webinars
45+
46+
- [FOSS4G:UK South West 2024 | Richard Conway & Garin Smith | EarthCODE and EOEPCA+](https://www.youtube.com/watch?v=JUL-lDt3vM4)

pages/Training and Resources/Videos and Webinars.md

Lines changed: 0 additions & 8 deletions
This file was deleted.

pages/Training and Resources/index.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,5 @@ order: 4
66
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.
77

88
- [Tutorials](./Tutorials%20and%20Learning%20Pathways.md)
9-
- [Network of Resources Sponsorship](./NoR.md)
10-
- [Videos and Webinars](./Videos%20and%20Webinars.md)
119
- [Gallery](./Gallery.md)
1210
- [Examples](https://esa-earthcode.github.io/examples/)

0 commit comments

Comments
 (0)