Skip to content

Commit a618eb4

Browse files
m-mohrm-mohr
committed
Merge remote-tracking branch 'origin/1.0.0-rc.1'
2 parents 2c53841 + 6edc629 commit a618eb4

File tree

130 files changed

+6435
-3376
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

130 files changed

+6435
-3376
lines changed

‎.travis.yml

+4-2
Original file line numberDiff line numberDiff line change
@@ -44,15 +44,17 @@ deploy:
4444
github-token: $GITHUB_TOKEN
4545
local-dir: gh-pages
4646
keep-history: true
47-
committer-from-gh: true
47+
name: openEO CI
48+
email: openeo.ci@uni-muenster.de
4849
on:
4950
tags: true
5051
- provider: pages
5152
skip-cleanup: true
5253
github-token: $GITHUB_TOKEN
5354
local-dir: gh-pages
5455
keep-history: true
55-
committer-from-gh: true
56+
name: openEO CI
57+
email: openeo.ci@uni-muenster.de
5658
on:
5759
all_branches: true
5860
condition: $TRAVIS_BRANCH =~ ^(master|draft)$

‎CHANGELOG.md

+93-1
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,98 @@ All notable changes to this project will be documented in this file.
44
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
55
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
66

7+
## Unreleased
8+
9+
## 1.0.0-rc.1 - 2020-01-31
10+
11+
### Added
12+
- Processes:
13+
- `add`
14+
- `aggregate_spatial`
15+
- `aggregate_spatial_binary`
16+
- `all`
17+
- `any`
18+
- `array_apply`
19+
- `array_contains`
20+
- `array_filter`
21+
- `array_find`
22+
- `array_labels`
23+
- `dimension_labels`
24+
- `drop_dimension`
25+
- `filter_labels`
26+
- `filter_spatial`
27+
- `load_uploaded_files`
28+
- `mask_polygon`
29+
- `reduce_dimension`
30+
- `reduce_dimension_binary`
31+
- `rename_labels`
32+
- Support for labeled arrays. [API#245](https://github.com/Open-EO/openeo-api/issues/245)
33+
- Process graphs for processes that can be implemented using other pre-defined processes. [#137](https://github.com/Open-EO/openeo-processes/issues/137)
34+
- `context` parameters to all processes which support passing process graphs (callbacks) as parameters. [#25](https://github.com/Open-EO/openeo-processes/issues/25)
35+
- Added further examples.
36+
37+
### Changed
38+
- The JSON Schema keyword `format` has been replaced with the custom keyword `subtype`.
39+
- Schema format/subtype `callback` has been renamed to `process-graph`.
40+
- Default values are now specified on the parameter-level, not in the JSON schemas.
41+
- Parameters are now required by default.
42+
- Parameters are defined as array. `parameter_order` is therefore removed and the name is part of the parameter object. [API#239](https://github.com/Open-EO/openeo-api/issues/239)
43+
- Callback parameters have a new, more advanced schema, allowing to define more aspects of the callback parameters. [API#239](https://github.com/Open-EO/openeo-api/issues/239)
44+
- Processes supporting multiple data types in parameters or return values with `anyOf` are now listing the data types directly as array. `anyOf` is discouraged.
45+
- Comparison processes `eq`, `gt`, `gte`, `lt`, `lte`, `neq` and `between` accept all data types as input for the operands.
46+
- `add_dimension`: Parameter `value` renamed to `label`.
47+
- `aggregate_polygon`, `aggregate_temporal`, `apply_dimension`, `array_element` and `resample_cube_temporal`: Support labeled arrays. [API#245](https://github.com/Open-EO/openeo-api/issues/245)
48+
- `aggregate_polygon`: The data cube implicitly gets restricted to the bounds of the polygons as if `filter_polygon` would have been used beforehand. [#101](https://github.com/Open-EO/openeo-processes/issues/101)
49+
- `aggregate_temporal`: Parameter `labels` is optional. [#19](https://github.com/Open-EO/openeo-processes/issues/19)
50+
- `apply_dimension`: Replaced with a completely new definition. [#73](https://github.com/Open-EO/openeo-processes/issues/73)
51+
- `apply_kernel`: Only supported 2D kernels on the horizontal spatial dimensions. [#69](https://github.com/Open-EO/openeo-processes/issues/69)
52+
- `clip`: Works on a single value instead on arrays (replaced parameter `data` with `x`). [#75](https://github.com/Open-EO/openeo-processes/issues/75)
53+
- `count`: Renamed parameter `expression` to `condition`.
54+
- `debug`: Replaced with a completely new definition. [#82](https://github.com/Open-EO/openeo-processes/issues/71), [API#100](https://github.com/Open-EO/openeo-api/issues/100), [API#214](https://github.com/Open-EO/openeo-api/issues/214)
55+
- `filter_bands`: Merged parameters `bands` and `common_names`. [#77](https://github.com/Open-EO/openeo-processes/issues/77)
56+
- `if`:
57+
- Doesn't pass through `null`, but instead `null` leads to rejecting the condition.
58+
- Parameter `expression` renamed to `value`.
59+
- Parameter `accept` is required.
60+
- Parameter `reject` defaults to `null`.
61+
- `load_collection`:
62+
- Parameter `bands` accepts common band names. [#77](https://github.com/Open-EO/openeo-processes/issues/77)
63+
- Parameter `properties`: Callback parameter `value` renamed to `x`.
64+
- `mask`: Clarifies behavior for missing dimensions in the mask. [#55](https://github.com/Open-EO/openeo-processes/issues/55)
65+
- `merge_cubes` works with binary reduction operators instead of list-based reducers. [#94](https://github.com/Open-EO/openeo-processes/issues/94)
66+
- `ndvi` and `normalized_difference`: Rewrite of the processes with a completely new behavior. [#60](https://github.com/Open-EO/openeo-processes/issues/60)
67+
- `not`: Parameter `expression` renamed to `x`.
68+
- `resample_spatial`: Default value of parameter `align` changed from `lower-left` to `upper-left`. [#61](https://github.com/Open-EO/openeo-processes/issues/61)
69+
- The following operations work on two values instead on a sequence of values: `and`, `divide`, `multiply`, `or`, `subtract`, `xor`. [#85](https://github.com/Open-EO/openeo-processes/issues/85)
70+
- `product` works as before, but is not an alias of `multiply` any longer. [#85](https://github.com/Open-EO/openeo-processes/issues/85)
71+
- `text_begins`, `text_contains`, `text_ends`: `null` values are supported and get passed through.
72+
- `trim`: Renamed to `trim_cube`.
73+
74+
### Deprecated
75+
- `filter_bbox`, `load_collection`, `resample_spatial`: PROJ definitions are deprecated in favor of EPSG codes and WKT2. [#58](https://github.com/Open-EO/openeo-processes/issues/58)
76+
77+
### Removed
78+
- The following processes don't support `ignore_nodata` any longer: `and`, `divide`, `multiply`, `or`, `subtract`, `xor`. [#85](https://github.com/Open-EO/openeo-processes/issues/85)
79+
- The following processes don't support `binary` any longer: `aggregate_temporal`, `merge_cubes`, `resample_cube_temporal`. [#94](https://github.com/Open-EO/openeo-processes/issues/94)
80+
- Support for vector data cubes, except for the processes `aggregate_poylgon` and `save_result`. [#68](https://github.com/Open-EO/openeo-processes/issues/68)
81+
- `filter_temporal` and `load_collection`: Temporal extents don't support time-only intervals any longer. [#88](https://github.com/Open-EO/openeo-processes/issues/88)
82+
- `mask`: The mask parameter doesn't accept vectors (polygons) any longer. Use process `mask_polygon` instead. [#110](https://github.com/Open-EO/openeo-processes/issues/110)
83+
- Processes:
84+
- `aggregate_polygon`. Use `aggregate_spatial` or `aggregate_spatial_binary` instead. [#62](https://github.com/Open-EO/openeo-processes/issues/62)
85+
- `find_collections`: Use `load_collection` and manual data discovery through the clients. [API#52](https://github.com/Open-EO/openeo-api/issues/52)
86+
- `filter`: Use `filter_labels` instead.
87+
- `filter_polygon`. Use `filter_spatial` instead. [#37](https://github.com/Open-EO/openeo-processes/issues/37)
88+
- `output`: Use `debug` instead.
89+
- `property` [#84](https://github.com/Open-EO/openeo-processes/issues/84)
90+
- `reduce`: Use `reduce_dimension` or `drop_dimension` instead.
91+
- `run_process_graph`: Use user-defined processes directly in the process graph instead.
92+
93+
### Fixed
94+
- Several clarifications in written texts. [#86](https://github.com/Open-EO/openeo-processes/issues/86)
95+
- `between` may return a `null` value.
96+
- `filter_bbox`, `load_collection`: The schema for the property `crs` in the parameters `extent`/`spatial_extent` contained invalid JSON Schema.
97+
- `merge_cubes`: Clarified merging behavior with several examples.
98+
799
## [0.4.2] - 2019-06-11
8100

9101
### Added
@@ -25,4 +117,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
25117
First version which is separated from the openEO API. Complete rework of all processes.
26118

27119
## Legacy versions
28-
Older versions of the processes were released as part of the openEO API, see the corresponding changelog for more information.
120+
Older versions of the processes were released as part of the openEO API, see the corresponding changelog for more information.

‎README.md

+19-2
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,19 @@
1-
# openeo-processes
2-
Repository for openEO process descriptions
1+
# openEO processes
2+
3+
openEO develops interoperable processes for big Earth observation cloud processing. This repository contains the process specifications. Each process is specified in a separate JSON file, which conforms to the corresponding API process schema.
4+
5+
## Versions
6+
7+
The openEO processes are currently released as version [**1.0.0 RC1**](http://processes.openeo.org).
8+
9+
| Version / Branch | Status | openEO API versions |
10+
| ------------------------------------------------------------ | ------------------------- | ------------------- |
11+
| [unreleased / draft](https://processes.openeo.org/draft) | in development | next |
12+
| [**1.0.0 RC1** / master](https://processes.openeo.org) | **latest stable version** | 1.0.x |
13+
| [0.4.2](https://processes.openeo.org/0.4.2/) | legacy version | 0.4.x |
14+
| [0.4.1](https://processes.openeo.org/0.4.1/) | legacy version | 0.4.x |
15+
| [0.4.0](https://processes.openeo.org/0.4.0/) | legacy version | 0.4.x |
16+
17+
**Note:** https://processes.openeo.org always points to the latest stable version.
18+
19+
See also the [changelog](CHANGELOG.md) for the changes between versions and the [milestones](https://github.com/Open-EO/openeo-api/milestones) for a rough roadmap based on GitHub issues.

‎absolute.json

+41-6
Original file line numberDiff line numberDiff line change
@@ -5,18 +5,18 @@
55
"categories": [
66
"math"
77
],
8-
"parameters": {
9-
"x": {
8+
"parameters": [
9+
{
10+
"name": "x",
1011
"description": "A number.",
1112
"schema": {
1213
"type": [
1314
"number",
1415
"null"
1516
]
16-
},
17-
"required": true
17+
}
1818
}
19-
},
19+
],
2020
"returns": {
2121
"description": "The computed absolute value.",
2222
"schema": {
@@ -59,5 +59,40 @@
5959
"href": "http://mathworld.wolfram.com/AbsoluteValue.html",
6060
"title": "Absolute value explained by Wolfram MathWorld"
6161
}
62-
]
62+
],
63+
"process_graph": {
64+
"lt": {
65+
"process_id": "lt",
66+
"arguments": {
67+
"x": {
68+
"from_parameter": "x"
69+
},
70+
"y": 0
71+
}
72+
},
73+
"multiply": {
74+
"process_id": "multiply",
75+
"arguments": {
76+
"x": {
77+
"from_parameter": "x"
78+
},
79+
"y": -1
80+
}
81+
},
82+
"if": {
83+
"process_id": "if",
84+
"arguments": {
85+
"value": {
86+
"from_node": "lt"
87+
},
88+
"accept": {
89+
"from_node": "multiply"
90+
},
91+
"reject": {
92+
"from_parameter": "x"
93+
}
94+
},
95+
"result": true
96+
}
97+
}
6398
}

‎add.json

+91
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
{
2+
"id": "add",
3+
"summary": "Addition of two numbers",
4+
"description": "Sums up the two numbers `x` and `y` (*x + y*) and returns the computed sum.\n\nNo-data values are taken into account so that `null` is returned if any element is such a value.\n\nThe computations follow [IEEE Standard 754](https://ieeexplore.ieee.org/document/8766229) whenever the processing environment supports it.",
5+
"categories": [
6+
"math"
7+
],
8+
"parameters": [
9+
{
10+
"name": "x",
11+
"description": "The first summand.",
12+
"schema": {
13+
"type": [
14+
"number",
15+
"null"
16+
]
17+
}
18+
},
19+
{
20+
"name": "y",
21+
"description": "The second summand.",
22+
"schema": {
23+
"type": [
24+
"number",
25+
"null"
26+
]
27+
}
28+
}
29+
],
30+
"returns": {
31+
"description": "The computed sum of the two numbers.",
32+
"schema": {
33+
"type": [
34+
"number",
35+
"null"
36+
]
37+
}
38+
},
39+
"examples": [
40+
{
41+
"arguments": {
42+
"x": 5,
43+
"y": 2.5
44+
},
45+
"returns": 7.5
46+
},
47+
{
48+
"arguments": {
49+
"x": -2,
50+
"y": -4
51+
},
52+
"returns": -6
53+
},
54+
{
55+
"arguments": {
56+
"x": 1,
57+
"y": null
58+
},
59+
"returns": null
60+
}
61+
],
62+
"links": [
63+
{
64+
"rel": "about",
65+
"href": "http://mathworld.wolfram.com/Sum.html",
66+
"title": "Sum explained by Wolfram MathWorld"
67+
},
68+
{
69+
"rel": "about",
70+
"href": "https://ieeexplore.ieee.org/document/8766229",
71+
"title": "IEEE Standard 754-2019 for Floating-Point Arithmetic"
72+
}
73+
],
74+
"process_graph": {
75+
"sum": {
76+
"process_id": "sum",
77+
"arguments": {
78+
"data": [
79+
{
80+
"from_parameter": "x"
81+
},
82+
{
83+
"from_parameter": "y"
84+
}
85+
],
86+
"ignore_nodata": false
87+
},
88+
"result": true
89+
}
90+
}
91+
}

0 commit comments

Comments
 (0)