Release openEO processes v1.1.0

[m-mohr]

Background

We've collected improvements and useful new processes for almost a year. This publishes clarifications and improvements to the public so that we don't need to work on the draft any longer.

You can review the changes at https://github.com/Open-EO/openeo-processes/pull/262.

Please note that some of the changes were already approved in PSC vote #8.

The following changes have been made to the processes:

[1.1.0] - 2021-07-02

Added

• New processes in proposal state
  • array_append
  • array_concat
  • array_create
  • array_create_labeled
  • array_find_label
  • array_interpolate_linear #173
  • array_modify
  • date_shift
  • is_infinite
  • nan
  • reduce_spatial
• Added return value details (property returns) for the schemas with the subtype process-graph. API#350
• apply_neighborhood: Clarify behavior for data cubes returned by the child processes and for that add the exception DataCubePropertiesImmutable.
• Added a guide for implementors that describes numerours implementation details for processes that could not be covered in the specifications itself, for example a recommended implementation for the if process. #246

Changed

• Added proposals folder for experimental processes. Experimental processes are not covered by the CHANGELOG and MAY include breaking changes! #196, #207, PSC#8
  • Moved the experimental process run_udf_externally to the proposals.
  • Moved the rarely used and implemented processes cummax, cummin, cumproduct, cumsum, debug, filter_labels, load_result, load_uploaded_files, resample_cube_temporal to the proposals.
• Exception messages have been aligned always use ` instead of '. Tooling could render it with CommonMark.
• load_collection and mask_polygon: Also support multi polygons instead of just polygons. #237
• run_udf and run_udf_externally: Specify specific (extensible) protocols for UDF URIs.
• resample_cube_spatial and resample_spatial: Aligned with GDAL and added rms and sum options to methods. Also added better descriptions.
• resample_cube_temporal: Process has been simplified and only offers the nearest neighbor method now. The process parameter has been removed, the dimension parameter was made less restrictive, the parameter valid_within was added. #194

Deprecated

• GeometryCollections are discouraged in all relevant processes.

Removed

• Removed the experimental processes aggregate_spatial_binary and reduce_dimension_binary. #258

Fixed

• Clarify that the user workspace is server-side. #225
• Clarify that the condition parameter for array_filter works also on indices and labels.
• Clarify contradicting statements in filter_temporal for the default value of the dimension parameter. By default all temporal dimensions are affected by the process. #203
• Clarify how the parameters passed to the overlap resolver correspond to the data cubes. #184
• Improve and clarify specifications for is_nan, is_nodata, is_valid. #189
• Improve and clarify specifications for all and any. #189
• array_element: Clarify that ArrayNotLabeled exception is thrown when parameter label is specified and the given array is not labeled.
• array_apply, array_element, array_filter: Added the minimum: 0 constraint to all schemas describing zero-based indices (parameter index).
• array_labels: Clarified the accepted data type for array elements passed to the parameter data.
• merge_cubes: Clarified the dimension label order after the merge. #212
• merge_cubes: Clarified the fourth example. #266
• Fixed typos, grammar issues and other spelling-related issues in many of the processes.
• Fixed the examples array_contains_nodata and array_find_nodata.
• Fixed links to openEO glossary and added links to data cube introduction. #216
• Fixed description of apply_dimension with regards to reference systems. Made description easier to understand, too. #234
• Clarified disallowed characters in subtype file-path.
• Clarified that UDF source code must contain a newline/line-break (affects run_udf).
• aggregate_spatial, aggregate_spatial_binary: Clarified that Features, Geometries and GeometryCollections are a single entity in computations. Only FeatureCollections are multiple entities. #252
• aggregate_spatial: Clarified that the values have no predefined order and reducers such as first and last return unpredictable results. #260
• load_collection, parameter spatial_extent: Clarified that all pixels that are inside the bounding box of the given polygons but do not intersect with any polygon have to be set to no-data (null). #256
• load_collection: Clarified that the parameters are recommended to be used in favor of filter_* processes.
• aggregate_temporal and aggregate_temporal_period: Clarified that reducers are also executed for intervals/periods with no data. #263
• dimension_labels: Clarified that the process fails with a DimensionNotAvailable exception, if a dimension with the specified name does not exist.

Proposal

I'm proposing to release openEO processes 1.1.0 on 2nd of July.

This release took quite some time, but I'd aim to do make smaller chunks in more frequent releases in the future so that for example the linear interpolation and curve fitting could also be integrated as a separate release rather quickly.

I'll inform you here if any additional changes come in until we approved the release here.

Additional context

Deadline: July 2, 2021

[m-mohr]

I've updated the post above with all the latest changes. All PRs have been merged now and it would be great to get the votes in for the release now.

[mkadunc]

+1

[edzer]

+1

[aljacob]

+1

[m-mohr]

+1

We are at +4 right now, which means this would get accepted tomorrow afternoon if no one objects with a -1 vote.

[neteler]

+1

[jdries]

+1

[m-mohr]

Accepted (+8), thanks.