Repository navigation
Add more example expression objects #31
Description
I think that (at least) 3 common definitions should be provided for https://github.com/stac-extensions/processing#expression-object to better guide users.
-
a generic "python script entry points" similar to what
setup(entry_point=...)orpoetry.scriptsexpect
(e.g.:my_package.my_module:some_functionormy_package.my_module:SomeClass.a_method) -
a URI based reference to a script or executable
(somewhat relates to Add aSoftwareobject #29 about thehrefrequirement)
(for this, I would suggest that"expression": {"href": "<uri>", "type"; "<media-type>"}is used, sinceexpressionallows anything) -
some
dockercontainer or similar, using an expression likeghcr.io/NAMESPACE/IMAGE_NAME:latest(or a more explicitdocker runcall)
Activity
emmanuelmathot commentedon Apr 4, 2024
The processing extension initially aims at tracing the processing lineage of the item. I understand you want to specify possible processing on the item? The expression object is left free to add any data structure that would represent the processing applied. If you want to provide with more processing
formatand related convention, feel free to provide them with examples.fmigneault commentedon Apr 4, 2024
I agree. If the above suggestions are valid, I can open a PR to add the examples.
Users are always free to define whichever
formatthat suits their needs, but if we push them toward a common strategy with good examples, it can help "standardizing" some work later on.Also related, once the Machine Learning Model (MLM) extension will be released, I plan to suggest another example similar to the following for STAC Items representing a derived product resulting from model predictions (eg: land-cover).
{ "processing:level": "L4", "processing:expression": { "format": "stac-mlm", "expression": { "href": "<URI-to-MLM-STAC-Item>", "type": "application/geo+json" } } }As described in https://github.com/crim-ca/dlm-extension/blob/validate/best-practices.md#processing-extension
add more processing:expression examples for python, docker and generi…