Skip to content

Commit 830c0bd

Browse files
JanssenBrmJanssenBrm
authored
Merge pull request #201 from ESA-APEx/sor3_fr_updates
Sor3 fr updates
2 parents 844dcc3 + 40d1372 commit 830c0bd

13 files changed

Lines changed: 75 additions & 73 deletions

‎instantiation/app_code_server.md‎

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -146,9 +146,12 @@ manual testing overhead and accelerates the rollout of new features or updates.
146146

147147
It is important to note that a valid APEx account and permissions from the project are required to access an environment.
148148

149-
| Project | URL |
150-
| :------------------------------ | :----------------------------------------------------------------------------------------- |
151-
| APEx (Demo) | [https://apphub.demo.apex.esa.int/](https://apphub.demo.apex.esa.int/) |
149+
| Project | URL |
150+
| :-------------------- | :--------------------------------------------------------------------------------- |
151+
| APEx (Demo) | [https://apphub.demo.apex.esa.int/](https://apphub.demo.apex.esa.int/) |
152+
| EO4CM | [https://apphub.eo4cm.apex.esa.int/](https://apphub.eo4cm.apex.esa.int/) |
153+
| EO4SEM | [https://apphub.eo4sem.apex.esa.int/](https://apphub.eo4sem.apex.esa.int/) |
154+
| Information Factories | [https://apphub.info-factories.apex.esa.int/](https://apphub.eo4sem.apex.esa.int/) |
152155

153156
: APEx Code Server IDE - Project Examples {#tbl-ide-examples}{tbl-colwidths="[20,80]"}
154157

‎instantiation/app_jupyterlab.md‎

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -89,9 +89,12 @@ working with notebooks, with its native support for data science, data visualisa
8989

9090
It is important to note that a valid APEx account and permissions from the project are required to access an environment.
9191

92-
| Project | URL |
93-
| :------------------------------ | :----------------------------------------------------------------------------------------- |
94-
| APEx (Demo) | [https://apphub.demo.apex.esa.int/](https://apphub.demo.apex.esa.int/) |
92+
| Project | URL |
93+
| :-------------------- | :--------------------------------------------------------------------------------- |
94+
| APEx (Demo) | [https://apphub.demo.apex.esa.int/](https://apphub.demo.apex.esa.int/) |
95+
| EO4CM | [https://apphub.eo4cm.apex.esa.int/](https://apphub.eo4cm.apex.esa.int/) |
96+
| EO4SEM | [https://apphub.eo4sem.apex.esa.int/](https://apphub.eo4sem.apex.esa.int/) |
97+
| Information Factories | [https://apphub.info-factories.apex.esa.int/](https://apphub.eo4sem.apex.esa.int/) |
9598

9699
: APEx JuyterLab IDE - Project Examples {#tbl-ide-examples}{tbl-colwidths="[20,80]"}
97100

‎instantiation/app_qgis.md‎

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -54,9 +54,12 @@ of data scientists might collaboratively develop crop yields scenario maps based
5454

5555
Several examples are under development and will be added on this page.
5656

57-
| Project | URL |
58-
| :------------------------------ | :----------------------------------------------------------------------------------------- |
59-
| APEx (Demo) | [https://apphub.demo.apex.esa.int/](https://apphub.demo.apex.esa.int/) |
57+
| Project | URL |
58+
| :-------------------- | :--------------------------------------------------------------------------------- |
59+
| APEx (Demo) | [https://apphub.demo.apex.esa.int/](https://apphub.demo.apex.esa.int/) |
60+
| EO4CM | [https://apphub.eo4cm.apex.esa.int/](https://apphub.eo4cm.apex.esa.int/) |
61+
| EO4SEM | [https://apphub.eo4sem.apex.esa.int/](https://apphub.eo4sem.apex.esa.int/) |
62+
| Information Factories | [https://apphub.info-factories.apex.esa.int/](https://apphub.eo4sem.apex.esa.int/) |
6063

6164
: APEx QGIS - Project Examples {#tbl-qgis-examples}{tbl-colwidths="[20,80]"}
6265

‎instantiation/catalog.qmd‎

Lines changed: 2 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -126,20 +126,5 @@ The following guides showcase how you can interact with the catalogue API:
126126

127127
## Examples
128128

129-
@tbl-catalogue-examples showcases example projects that use the APEx Product Catalogue:
130-
131-
| Project | URL |
132-
| :------------------------------------- | :----------------------------------------------------------------------------------- |
133-
| APEx | [https://browser.apex.esa.int](https://browser.apex.esa.int/?.language=en) |
134-
| APEx (Demo) | [https://browser.demo.apex.esa.int](https://browser.demo.apex.esa.int/?.language=en) |
135-
| World Ecosystem Extent Dynamics (WEED) | [https://browser.weed.apex.esa.int](https://browser.weed.apex.esa.int/?.language=en) |
136-
| EO4SEM | [https://browser.eo4sem.apex.esa.int](https://browser.eo4sem.apex.esa.int) |
137-
138-
: APEx Product Catalogue - Project Examples {#tbl-catalogue-examples}{tbl-colwidths="[30,70]"}
139-
140-
:::{.callout-tip}
141-
142-
## Stay Tuned
143-
144-
Additional information will be shared on this page as the project progresses.
145-
:::
129+
Explore the different Product Catalogue examples through our
130+
[Solutions Gallery](https://apex.esa.int/resources/solutions-gallery?field_services=Product+Catalogue).

‎instantiation/geospatial_explorer.md‎

Lines changed: 30 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -18,22 +18,38 @@ support for features such as cursor inspection, queries, distance measurements a
1818
integrated charts and graphs. The UI will also provide access to metadata records associated with the data that is
1919
rendered in the Explorer.
2020

21-
## Examples
22-
23-
@tbl-explorer-examples showcases example projects that use the APEx Geospatial Explorer:
21+
## Geospatial Explorer Configuration Builder
22+
23+
Maintenance of the Geospatial Explorer JSON configuration files can be undertaken using the GE Configuration Builder,
24+
a web based application that allows in browser JSON editing via bespoke User Interface, thereby negating the need for
25+
configuration “authors” to learn how to produce valid JSON, or understand the specifics of the GE schema.
26+
27+
The GE Configuration Builder development is done in parallel to the GE, with Configuration Builder feature kept in line
28+
with the schema of the latest GE release, and potentially multiple Configuration Builder enhancements being undertaken
29+
between GE releases.
30+
31+
![APEx Geospatial Explorer Configuation Builder](images/ge_config_builder.png)
32+
33+
Features of the configuration builder include:
34+
35+
* Compose an APEx Geospatial Explorer configuration from data sources and services (WMTS, WMS, WFS, COG, XYZ, GeoJSON,
36+
FlatGeoBuf, CSV) using layers organised into interface groups
37+
* Define the background maps that are available
38+
* Style raster layers with categories and colormaps, build RGB composites and style vector layers with rule-based filters
39+
and stops.
40+
* Define statistics and constraint layers
41+
* Author charts from CSV, COG pixel values, or vector feature properties.
42+
* Configure specific functional controls for each layer - e.g opacity slider, download links
43+
* Browse remote catalogues with the STAC and S3 browsers.
44+
* Inspect the metadata of data sources to understand their content
45+
* Validate every URL in your config with the Run Healthcheck tool and see data-access plus performance scores at a glance.
46+
* Define specific branding and navigation defaults (e.g. projection; start location and scale)
47+
* Preview the resulting APEx Geospatial Explorer inline using GE Preview before exporting JSON.
2448

25-
| Project | URL |
26-
| :------------------------------ | :--------------------------------------------------------------------------------------------- |
27-
| APEx (Demo) | [https://explorer.demo.apex.esa.int/](https://explorer.demo.apex.esa.int/) |
28-
| SEF - Food Systems | [https://explorer.sef-food.apex.esa.int/](https://explorer.sef-foodsystems.apex.esa.int/) |
29-
| SEF - Ecosystems & Biodiversity | [https://explorer.sef-ecosystems.apex.esa.int/](https://explorer.sef-ecosystems.apex.esa.int/) |
30-
| SEF - Urban | [https://explorer.sef-urban.apex.esa.int/](https://explorer.sef-urban.apex.esa.int/) |
31-
| EOBPs – Road and Railway | [https://explorer.eobp-transport.apex.esa.int/](https://explorer.eobp-transport.apex.esa.int/) |
32-
| EOBPs – Solar Energy | [https://explorer.eobp-energy.apex.esa.int/](https://explorer.eobp-energy.apex.esa.int/) |
33-
| EOBPs – Health | [https://explorer.eobp-health.apex.esa.int/](https://explorer.eobp-health.apex.esa.int/) |
34-
| EO4SEM | [https://explorer.eo4sem.apex.esa.int/](https://explorer.eo4sem.apex.esa.int/) |
49+
## Examples
3550

36-
: APEx Geospatial Explorer - Project Examples {#tbl-explorer-examples}{tbl-colwidths="[20,80]"}
51+
Explore the different Geospatial Explorer examples through our
52+
[Solutions Gallery](https://apex.esa.int/resources/solutions-gallery?field_services=Geospatial+Explorer).
3753

3854
## User Guide
3955

@@ -48,10 +64,3 @@ refer to the our [APEx Geospatial Explorer Recommendations](../interoperability/
4864

4965
Numerous example configurations can be found in the
5066
[APEx Geospatial Explorer Configurations](https://github.com/ESA-APEx/apex_geospatial_explorer_configs) repository on GitHub.
51-
52-
:::{.callout-tip}
53-
54-
## Stay Tuned
55-
56-
Additional information will be shared on this page as the project progresses.
57-
:::

‎instantiation/images/ge_config_builder.png‎

137 KB
Loading

‎instantiation/project_portal.md‎

Lines changed: 2 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -113,20 +113,8 @@ the EO community without requiring dedicated hosting resources.
113113

114114
## Examples
115115

116-
@tbl-portal-examples showcases example projects that use the APEx Project Web Portal:
117-
118-
| Project | URL |
119-
| :------------------------------ | :----------------------------------------------------------------------------------- |
120-
| APEx | [https://apex.esa.int/](https://apex.esa.int/) |
121-
| APEx (Demo) | [https://demo.apex.esa.int/](https://demo.apex.esa.int/) |
122-
| World Ecosystem Extent Dynamics | [https://esa-worldecosystems.org/](https://esa-worldecosystems.org/) |
123-
| EO4SEM | [https://eo4sem.apex.esa.int/en](https://eo4sem.apex.esa.int/en) |
124-
| EOBPs – Solar Energy | [https://eobp-energy.apex.esa.int/en](https://eobp-energy.apex.esa.int/en) |
125-
| EOBPs – Health | [https://eobp-health.apex.esa.int/en/home](https://eobp-health.apex.esa.int/en/home) |
126-
| EOBPs- Road and Rail | [https://eobp-transport.apex.esa.int/en](https://eobp-transport.apex.esa.int/en) |
127-
| RAVE | [https://rave.apex.esa.int/en](https://rave.apex.esa.int/en) |
128-
129-
: APEx Project Web Portal - Project Examples {#tbl-portal-examples}{tbl-colwidths="[30,70]"}
116+
Explore the different Project Web Portal examples through our
117+
[Solutions Gallery](https://apex.esa.int/resources/solutions-gallery?field_services=Web+Portal).
130118

131119
## User Documentation
132120

‎interoperability/datahosting.qmd‎

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,10 @@ the produced data can reach a broad audience beyond the earth observation commun
7070
extra guidance, we refer to the [cloud native geospatial guide](https://guide.cloudnativegeo.org/) for a comprehensive
7171
comparison.
7272

73+
Next to the use of cloud native formats, accompanying metadata is crucial for describing the content of the data. This
74+
ensures that datasets can be easily integrated into various tools and processed by cloud platforms. In the case of
75+
metadata, APEx recommends using STAC, as described in our [STAC section](#stac).
76+
7377
| Scenario | Formats | Builds on |
7478
| :--- | :--- | :--- |
7579
| 1 – Cloud-based Processing | COG, GeoZarr, NetCDF\ GeoParquet, FlatGeobuf, GeoJSON | (baseline) |
@@ -78,7 +82,7 @@ comparison.
7882

7983
:File Format Scenarios
8084

81-
### STAC Metadata Recommendations
85+
### STAC
8286

8387
The STAC specification provides a comprehensive and interoperable framework for describing geospatial datasets. Within
8488
APEx, STAC serves as the foundation to enhance the discoverability, interoperability, and integration of data across a
@@ -169,11 +173,12 @@ where columnar access patterns are beneficial.
169173

170174
#### STAC Metadata
171175

172-
When sharing geospatial datasets in cloud-optimised formats, such as Cloud Optimised GeoTIFF (COG), NetCDF, Zarr and
173-
FlatGeobuf, it is essential to embed as much relevant metadata as possible directly within the files. Although these
174-
formats are designed for efficient cloud access, their interoperability potential is enhanced when the files carry rich,
175-
standardised metadata aligned with their respective specifications. Doing so not only improves data reuse by third-party
176-
tools but also enables more reliable automatic inference of STAC metadata during cataloguing or dataset publication.
176+
When sharing geospatial datasets in cloud-optimised formats such as Cloud Optimised GeoTIFF (COG), NetCDF, Zarr, and
177+
FlatGeobuf, it’s essential to embed as much relevant metadata as possible directly within the files. While these formats
178+
are designed for efficient cloud access, their interoperability is further enhanced when accompanied by a separate,
179+
standardised STAC metadata file that aligns with their respective specifications. This not only improves data reuse by
180+
third-party tools but also facilitates more reliable automatic inference of STAC metadata during cataloguing or dataset
181+
publication.
177182

178183
@tbl-processing-stac offers an overview of the general STAC recommendations for cloud-based processing. For more
179184
details and examples on adding this additional metadata to your results, please consult the specific tools (e.g.

‎propagation/images/catalogue.png‎

1.93 MB
Loading

‎propagation/images/catalogue_details.png‎

430 KB
Loading

0 commit comments

Comments
 (0)