Skip to content

Commit f045f26

Browse files
committed
icg: updated definitions based on v4.1
1 parent a7c79b4 commit f045f26

File tree

1 file changed

+50
-20
lines changed

1 file changed

+50
-20
lines changed

interoperability/definitions.qmd

Lines changed: 50 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -47,35 +47,33 @@ analytics procedures to perform an application-specific processing task.
4747

4848
For the sake of simplicity in the context of APEx, we refer to these simply as (EO) “algorithms”.
4949

50-
### Algorithm Service Implementation
50+
### Application Algorithm Definition
5151

52-
The algorithm definition refers to a representation of the algorithm modules and interfaces that can be exposed by an
53-
API and/or processing platform. Typically, it includes a general description of the algorithm along with detailed
52+
The application algorithm definition refers to a representation of the algorithm modules and interfaces that can be exposed
53+
by an API and/or processing platform. Typically, it includes a general description of the algorithm along with detailed
5454
information on its parameters, expected output, scientific method, and an overview of the different steps executed
5555
within the algorithm. Examples of algorithm definitions include openEO’s User Defined Processes (UDP) [@udp] and OGC
5656
Application Package [@ap], using the Common Workflow Language (CWL) [@cwl].
5757

58-
### Algorithm Catalogue
58+
To increase uptake and interoperability, APEx aims to enable the execution of application algorithm definitions via
59+
standardised web service APIs. This transitions algorithms from being rather arbitrary pieces of software with potentially
60+
complex requirements, in terms of execution environment, usage, inputs, …, into on-demand services that can readily be
61+
invoked by stakeholders. This transformation primarily involves making the application algorithm definition available as
62+
a service on an algorithm hosting platform. The transition process into a hosted on-demand algorithm service is supported
63+
by the APEx Algorithm Support.
5964

60-
The [APEx Algorithm Catalogue](https://algorithm-catalogue.apex.esa.int/) is a central register of algorithm
65+
An important boundary condition for hosted algorithms is that they can be executed at a predictable cost for a given set
66+
of inputs. This predictability allows a service user to accurately estimate and determine the cost associated with the
67+
execution of the final deployed service instance.
68+
69+
### Algorithm Services Catalogue
70+
71+
The [APEx Algorithm Services Catalogue](https://algorithm-catalogue.apex.esa.int/) is a central register of algorithm
6172
definitions and the corresponding algorithm service instances that can be executed on APEx-compliant algorithm hosting
6273
platforms. Curated by APEx, the catalogue relies on automated checks to ensure that advertised algorithms service
6374
instances are available and functional. Whenever a malfunction is detected, this is reported to ESA and the EO project
6475
consortium, allowing them to determine a proper course of action.
6576

66-
### Hosted Algorithm
67-
68-
To increase uptake and interoperability, APEx aims to enable the execution of algorithms via standardised web service
69-
APIs. This transitions algorithms from being rather arbitrary pieces of software with potentially complex requirements,
70-
in terms of execution environment, usage, inputs, …, into on-demand services that can readily be invoked by
71-
stakeholders. This transformation primarily involves converting a given algorithm into an APEx-compliant algorithm
72-
definition and making it available as a service on an algorithm hosting platform. The transition process into a hosted
73-
on-demand algorithm service is supported by the [APEx Algorithm Support](../propagation/index.qmd).
74-
75-
An important boundary condition for hosted algorithms is that they can be executed at a predictable cost for a given set
76-
of inputs. This predictability allows a service user to accurately estimate and determine the cost associated with the
77-
execution of the final deployed service instance.
78-
7977
### Algorithm Hosting Platform
8078

8179
An EO algorithm hosting platform enables the execution of a standardised algorithm, represented by an algorithm
@@ -96,6 +94,38 @@ affects properties such as cost, performance, stability, and the amount of compu
9694
algorithm. Compliance with these requirements does not necessarily imply a high overall quality level across all
9795
aspects, ensuring that EO projects retain a sufficient degree of freedom in selecting their preferred platform.
9896

97+
### Last Mile Applications
98+
99+
A ‘last mile’ application, as seen from the EO perspective, bridges the final gap between the user at the end of the
100+
value chain, and the web service APIs that offer EO-derived information. This could, for instance, be the integration
101+
of parcel statistics into the field management software of a farmer. In the ESA context, Green Transition Information
102+
Factories can be considered examples of last mile applications.
103+
104+
Typically, each user group and domain will have its own set of purpose-built tools. The IT integrator or vendor building
105+
these tools will retrieve EO algorithm results via web service APIs based on open standards. These results can then be
106+
further processed as needed, depending on the application. Note that these applications are not necessarily EO-centric
107+
or even geospatial but could be using an EO algorithm as a small part or in the background.
108+
109+
The APEx Algorithm Services Catalogue acts as a discovery tool for last mile application builders. It shows various
110+
technical parameters, the cost and potential limitations for specific use cases. This speeds up the discovery and selection
111+
process. Application builders will be required to create an account on the hosting platforms and ensure the necessary
112+
funds are available, if they want to test or use the API.
113+
114+
APEx currently offers two main options for projects to develop their on-demand services:
115+
116+
* OpenEO-based services [@openeo], implemented in line with openEO’s User Defined Processes (UDP) [@udp]
117+
* OGC API - Processes-based services [@apiprocess], implemented in line with the OGC Application Package Best
118+
Practice [@ap]
119+
120+
These APEx-compliant technologies allow algorithms to be hosted on an APEx-compliant algorithm hosting platform and make
121+
them available for execution through web services. These technologies promote seamless reuse and integration of existing
122+
EO algorithms. Additionally, by leveraging web services and cloud-based approaches, these technologies simplify the execution
123+
of EO algorithms, shielding users from underlying complexities, such as data access, data processing optimisation, and other
124+
technical challenges.
125+
126+
APEx remains committed to future innovation and is open to integrating additional specifications, provided they align with
127+
FAIR principles and facilitate algorithm execution through web services.
128+
99129
## Actors
100130

101131
### EO Project & Algorithm PI
@@ -104,9 +134,9 @@ An EO project refers to the consortium that is responsible for building the EO a
104134
Algorithm PI (principal investigator). In certain ESA EOP procurement and ITTs, there is now a requirement included to
105135
comply with APEx [Interoperability and Compliance Guidelines](../interoperability/index.md). When compliance is
106136
required, the consortium can utilise various services offered by APEx. Specifically, the
107-
[APEx Algorithm Support](../propagation/index.qmd) aims tosupport the enhancement of algorithms on a technical and
137+
[APEx Algorithm Support](../propagation/index.qmd) aims to support the enhancement of algorithms on a technical and
108138
software level and facilitate the transition to hosted algorithms that can be included in the
109-
[APEx Algorithm Catalogue](https://algorithm-catalogue.apex.esa.int/).
139+
[APEx Algorithm Services Catalogue](https://algorithm-catalogue.apex.esa.int/).
110140

111141
ESA EO projects that do not have an explicit compliance requirement are also eligible to receive support. The APEx
112142
support can boost project impact, so projects are encouraged to inquire with their ESA technical officer about the

0 commit comments

Comments
 (0)