Adds return value schemas for child processes

CHANGELOG.md

@@ -10,6 +10,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Processes:
     - `is_infinity`
     - `nan`
+- Added return value details (property `returns`) for the schemas with the subtype `process-graph`. [API#350](https://github.com/Open-EO/openeo-api/issues/350)
+- `apply_neighborhood`: Clarify behavior for data cubes returned by the child processes and for that add the exception `DataCubePropertiesImmutable`.
 
 ### Changed
 - Added `proposals` folder for experimental processes. Experimental processes are not covered by the CHANGELOG!

aggregate_spatial.json

@@ -49,7 +49,13 @@
                         "optional": true,
                         "default": null
                     }
-                ]
+                ],
+                "returns": {
+                    "description": "Return the value that should be stored in the data cube.",
+                    "schema": {
+                        "description": "Any data type."
+                    }
+                }
             }
         },
         {

aggregate_temporal.json

@@ -112,7 +112,13 @@
                         "optional": true,
                         "default": null
                     }
-                ]
+                ],
+                "returns": {
+                    "description": "Return the value that should be stored in the data cube.",
+                    "schema": {
+                        "description": "Any data type."
+                    }
+                }
             }
         },
         {

aggregate_temporal_period.json

@@ -62,7 +62,13 @@
                         "optional": true,
                         "default": null
                     }
-                ]
+                ],
+                "returns": {
+                    "description": "Return the value that should be stored in the data cube.",
+                    "schema": {
+                        "description": "Any data type."
+                    }
+                }
             }
         },
         {

apply.json

@@ -37,7 +37,13 @@
                         "optional": true,
                         "default": null
                     }
-                ]
+                ],
+                "returns": {
+                    "description": "Return the value that should be stored in the data cube.",
+                    "schema": {
+                        "description": "Any data type."
+                    }
+                }
             }
         },
         {

apply_dimension.json

@@ -41,7 +41,13 @@
                         "optional": true,
                         "default": null
                     }
-                ]
+                ],
+                "returns": {
+                    "description": "Return the value that should be stored in the data cube.",
+                    "schema": {
+                        "description": "Any data type."
+                    }
+                }
             }
         },
         {

apply_neighborhood.json

@@ -38,7 +38,14 @@
                         "optional": true,
                         "default": null
                     }
-                ]
+                ],
+                "returns": {
+                    "description": "Return the data cube with the newly computed values and the same dimensions. The dimension properties (name, type, labels, reference system and resolution) must remain unchanged, otherwise a `DataCubePropertiesImmutable` exception will be thrown.",
+                    "schema": {
+                        "type": "object",
+                        "subtype": "raster-cube"
+                    }
+                }
             }
         },
         {
@@ -214,6 +221,9 @@
     "exceptions": {
         "DimensionNotAvailable": {
             "message": "A dimension with the specified name does not exist."
+        },
+        "DataCubePropertiesImmutable": {
+            "message": "The dimension properties (name, type, labels, reference system and resolution) must remain unchanged."
         }
     }
 }

array_apply.json

@@ -63,7 +63,13 @@
                         "optional": true,
                         "default": null
                     }
-                ]
+                ],
+                "returns": {
+                    "description": "Return the value that should be stored in the data cube.",
+                    "schema": {
+                        "description": "Any data type."
+                    }
+                }
             }
         },
         {

array_filter.json

@@ -64,7 +64,13 @@
                         "optional": true,
                         "default": null
                     }
-                ]
+                ],
+                "returns": {
+                    "description": "Return `true` if the value should be kept in the array, otherwise return `false`.",
+                    "schema": {
+                        "type": "boolean"
+                    }
+                }
             }
         },
         {

count.json

@@ -43,7 +43,13 @@
                             "optional": true,
                             "default": null
                         }
-                    ]
+                    ],
+                    "returns": {
+                        "description": "Return `true` if the element should increase the counter, otherwise return `false`.",
+                        "schema": {
+                            "type": "boolean"
+                        }
+                    }
                 },
                 {
                     "title": "All elements",

filter_labels.json

@@ -43,7 +43,13 @@
                         "optional": true,
                         "default": null
                     }
-                ]
+                ],
+                "returns": {
+                    "description": "Return `true` if the dimension label should be kept in the data cube, otherwise return `false`.",
+                    "schema": {
+                        "type": "boolean"
+                    }
+                }
             }
         },
         {

load_collection.json

@@ -194,7 +194,13 @@
                                     "description": "Any data type."
                                 }
                             }
-                        ]
+                        ],
+                        "returns": {
+                            "description": "Return `true` if the data should be loaded into the data cube, otherwise return `false`.",
+                            "schema": {
+                                "type": "boolean"
+                            }
+                        }
                     }
                 },
                 {

merge_cubes.json

@@ -52,7 +52,13 @@
                         "optional": true,
                         "default": null
                     }
-                ]
+                ],
+                "returns": {
+                    "description": "Return the value that should be stored in the data cube.",
+                    "schema": {
+                        "description": "Any data type."
+                    }
+                }
             },
             "default": null,
             "optional": true

meta/subtype-schemas.json

@@ -222,7 +222,13 @@
                             "description": "Any data type."
                         }
                     }
-                ]
+                ],
+                "returns": {
+                    "description": "Return `true` if the data should be used, otherwise return `false`.",
+                    "schema": {
+                        "type": "boolean"
+                    }
+                }
             }
         },
         "output-format": {

proposals/aggregate_spatial_binary.json

@@ -54,7 +54,13 @@
                         "optional": true,
                         "default": null
                     }
-                ]
+                ],
+                "returns": {
+                    "description": "Return the value that should be stored in the data cube.",
+                    "schema": {
+                        "description": "Any data type."
+                    }
+                }
             }
         },
         {

proposals/aggregate_spatial_window.json

@@ -42,7 +42,13 @@
                         "optional": true,
                         "default": null
                     }
-                ]
+                ],
+                "returns": {
+                    "description": "Return the value that should be stored in the data cube.",
+                    "schema": {
+                        "description": "Any data type."
+                    }
+                }
             }
         },
         {

proposals/reduce_dimension_binary.json

@@ -46,7 +46,13 @@
                         "optional": true,
                         "default": null
                     }
-                ]
+                ],
+                "returns": {
+                    "description": "Return the value that should be stored in the data cube.",
+                    "schema": {
+                        "description": "Any data type."
+                    }
+                }
             }
         },
         {

reduce_dimension.json

@@ -42,7 +42,13 @@
                         "optional": true,
                         "default": null
                     }
-                ]
+                ],
+                "returns": {
+                    "description": "Return the value that should be stored in the data cube.",
+                    "schema": {
+                        "description": "Any data type."
+                    }
+                }
             }
         },
         {

resample_cube_temporal.json

@@ -50,7 +50,13 @@
                         "optional": true,
                         "default": null
                     }
-                ]
+                ],
+                "returns": {
+                    "description": "Return the value that should be stored in the data cube.",
+                    "schema": {
+                        "description": "Any data type."
+                    }
+                }
             }
         },
         {