OTB.LSMSSegmentation: This application performs the second step of the exact Large-Scale Mean-Shift segmentation workflow (LSMS) [1].

This application will produce a labeled image where neighbor pixels whose range distance is below range radius (and optionally spatial distance below spatial radius) will be grouped together into the same cluster. For large images one can use the tilesizex and tilesizey parameters for tile-wise processing, with the guarantees of identical results.Filtered range image and spatial image should be created with the MeanShiftSmoothing application outputs (fout and foutpos) [2], with modesearch parameter disabled. If spatial image is not set, the application will only process the range image and spatial radius parameter will not be taken into account.Please note that this application will generate a lot of temporary files (as many as the number of tiles), and will therefore require twice the size of the final result in term of disk space. The cleanup option (activated by default) allows removing all temporary file as soon as they are not needed anymore (if cleanup is activated, tmpdir set and tmpdir does not exists before running the application, it will be removed as well during cleanup). The tmpdir option allows defining a directory where to write the temporary files.Please also note that the output image type should be set to uint32 to ensure that there are enough labels available.The output of this application can be passed to the LSMSSmallRegionMerging [3] or LSMSVectorization [4] applications to complete the LSMS workflow.

Inputs

The filtered image, corresponding to the fout output parameter of the MeanShiftSmoothing application.

format
href
Please set a value for in.

The filtered position image, corresponding to the foutpos output parameter of the MeanShiftSmoothing application.

format
href
Please set a value for inpos.

This output contains the segmented image, where each pixel value is the unique integer label of the segment it belongs to. It is recommended to set the pixel type to uint32.

string
Please set a value for out.

Threshold on Spatial distance to consider pixels in the same segment. A good value is half the spatial radius used in the MeanShiftSmoothing application (spatialr parameter).

number

Threshold on spectral signature euclidean distance (expressed in radiometry unit) to consider pixels in the same segment. A good value is half the range radius used in the MeanShiftSmoothing application (ranger parameter).

number

Minimum Segment Size. If, after the segmentation, a segment is of size lower than this criterion, the segment is discarded.

integer

Size of tiles along the X-axis for tile-wise processing.

integer
Please set a value for tilesizex.

Size of tiles along the Y-axis for tile-wise processing.

integer
Please set a value for tilesizey.

This applications need to write temporary files for each tile. This parameter allows choosing the path where to write those files. If disabled, the current path will be used.

string

If activated, the application will try to remove all temporary files it created.

boolean
Please set a value for cleanup.

Outputs

This output contains the segmented image, where each pixel value is the unique integer label of the segment it belongs to. It is recommended to set the pixel type to uint32.

format
transmission

Execution options

successUri
inProgressUri
failedUri

format

mode

Execute End Point

View the execution endpoint of a process.

View the alternative version in HTML.

{"id": "OTB.LSMSSegmentation", "title": "This application performs the second step of the exact Large-Scale Mean-Shift segmentation workflow (LSMS) [1].", "description": "This application will produce a labeled image where neighbor pixels whose range distance is below range radius (and optionally spatial distance below spatial radius) will be grouped together into the same cluster. For large images one can use the tilesizex and tilesizey parameters for tile-wise processing, with the guarantees of identical results.Filtered range image and spatial image should be created with the MeanShiftSmoothing application outputs (fout and foutpos) [2], with modesearch parameter disabled. If spatial image is not set, the application will only process the range image and spatial radius parameter will not be taken into account.Please note that this application will generate a lot of temporary files (as many as the number of tiles), and will therefore require twice the size of the final result in term of disk space. The cleanup option (activated by default) allows removing all temporary file as soon as they are not needed anymore (if cleanup is activated, tmpdir set and tmpdir does not exists before running the application, it will be removed as well during cleanup). The tmpdir option allows defining a directory where to write the temporary files.Please also note that the output image type should be set to uint32 to ensure that there are enough labels available.The output of this application can be passed to the LSMSSmallRegionMerging [3] or LSMSVectorization [4] applications to complete the LSMS workflow.", "version": "1.0.0", "jobControlOptions": ["sync-execute", "async-execute", "dismiss"], "outputTransmission": ["value", "reference"], "links": [{"rel": "http://www.opengis.net/def/rel/ogc/1.0/execute", "type": "application/json", "title": "Execute End Point", "href": "http://tb17.geolabs.fr:8119/ogc-api/processes/OTB.LSMSSegmentation/execution"}, {"rel": "alternate", "type": "text/html", "title": "Execute End Point", "href": "http://tb17.geolabs.fr:8119/ogc-api/processes/OTB.LSMSSegmentation/execution.html"}], "inputs": {"in": {"title": "The filtered image, corresponding to the fout output parameter of the MeanShiftSmoothing application.", "description": "The filtered image, corresponding to the fout output parameter of the MeanShiftSmoothing application.", "extended-schema": {"oneOf": [{"allOf": [{"$ref": "http://zoo-project.org/dl/link.json"}, {"type": "object", "properties": {"type": {"enum": ["image/tiff", "image/jpeg", "image/png"]}}}]}, {"type": "object", "required": ["value"], "properties": {"value": {"oneOf": [{"type": "string", "contentEncoding": "base64", "contentMediaType": "image/tiff"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "image/jpeg"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "image/png"}]}}}]}, "schema": {"oneOf": [{"type": "string", "contentEncoding": "base64", "contentMediaType": "image/tiff"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "image/jpeg"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "image/png"}]}, "id": "in"}, "inpos": {"title": "The filtered position image, corresponding to the foutpos output parameter of the MeanShiftSmoothing application.", "description": "The filtered position image, corresponding to the foutpos output parameter of the MeanShiftSmoothing application.", "extended-schema": {"oneOf": [{"allOf": [{"$ref": "http://zoo-project.org/dl/link.json"}, {"type": "object", "properties": {"type": {"enum": ["image/tiff", "image/jpeg", "image/png"]}}}]}, {"type": "object", "required": ["value"], "properties": {"value": {"oneOf": [{"type": "string", "contentEncoding": "base64", "contentMediaType": "image/tiff"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "image/jpeg"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "image/png"}]}}}], "nullable": true}, "schema": {"oneOf": [{"type": "string", "contentEncoding": "base64", "contentMediaType": "image/tiff"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "image/jpeg"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "image/png"}]}, "id": "inpos"}, "out": {"title": "This output contains the segmented image, where each pixel value is the unique integer label of the segment it belongs to. It is recommended to set the pixel type to uint32.", "description": "This output contains the segmented image, where each pixel value is the unique integer label of the segment it belongs to. It is recommended to set the pixel type to uint32.", "schema": {"type": "string", "default": "uint8", "enum": ["uint8", "uint16", "int16", "int32", "int32", "float", "double"]}, "id": "out"}, "spatialr": {"title": "Threshold on Spatial distance to consider pixels in the same segment. A good value is half the spatial radius used in the MeanShiftSmoothing application (spatialr parameter).", "description": "Threshold on Spatial distance to consider pixels in the same segment. A good value is half the spatial radius used in the MeanShiftSmoothing application (spatialr parameter).", "schema": {"type": "number", "default": 5, "format": "double", "nullable": true}, "id": "spatialr"}, "ranger": {"title": "Threshold on spectral signature euclidean distance (expressed in radiometry unit) to consider pixels in the same segment. A good value is half the range radius used in the MeanShiftSmoothing application (ranger parameter).", "description": "Threshold on spectral signature euclidean distance (expressed in radiometry unit) to consider pixels in the same segment. A good value is half the range radius used in the MeanShiftSmoothing application (ranger parameter).", "schema": {"type": "number", "default": 15, "format": "double", "nullable": true}, "id": "ranger"}, "minsize": {"title": "Minimum Segment Size. If, after the segmentation, a segment is of size lower than this criterion, the segment is discarded.", "description": "Minimum Segment Size. If, after the segmentation, a segment is of size lower than this criterion, the segment is discarded.", "schema": {"type": "integer", "default": 0, "nullable": true}, "id": "minsize"}, "tilesizex": {"title": "Size of tiles along the X-axis for tile-wise processing.", "description": "Size of tiles along the X-axis for tile-wise processing.", "schema": {"type": "integer", "default": 500}, "id": "tilesizex"}, "tilesizey": {"title": "Size of tiles along the Y-axis for tile-wise processing.", "description": "Size of tiles along the Y-axis for tile-wise processing.", "schema": {"type": "integer", "default": 500}, "id": "tilesizey"}, "tmpdir": {"title": "This applications need to write temporary files for each tile. This parameter allows choosing the path where to write those files. If disabled, the current path will be used.", "description": "This applications need to write temporary files for each tile. This parameter allows choosing the path where to write those files. If disabled, the current path will be used.", "schema": {"type": "string", "nullable": true}, "id": "tmpdir"}, "cleanup": {"title": "If activated, the application will try to remove all temporary files it created.", "description": "If activated, the application will try to remove all temporary files it created.", "schema": {"type": "boolean", "default": false}, "id": "cleanup"}}, "outputs": {"out": {"title": "This output contains the segmented image, where each pixel value is the unique integer label of the segment it belongs to. It is recommended to set the pixel type to uint32.", "description": "This output contains the segmented image, where each pixel value is the unique integer label of the segment it belongs to. It is recommended to set the pixel type to uint32.", "extended-schema": {"oneOf": [{"allOf": [{"$ref": "http://zoo-project.org/dl/link.json"}, {"type": "object", "properties": {"type": {"enum": ["image/tiff", "image/jpeg", "image/png"]}}}]}, {"type": "object", "required": ["value"], "properties": {"value": {"oneOf": [{"type": "string", "contentEncoding": "base64", "contentMediaType": "image/tiff"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "image/jpeg"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "image/png"}]}}}]}, "schema": {"oneOf": [{"type": "string", "contentEncoding": "base64", "contentMediaType": "image/tiff"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "image/jpeg"}, {"type": "string", "contentEncoding": "base64", "contentMediaType": "image/png"}]}, "id": "out"}}}

http://tb17.geolabs.fr:8119/ogc-api/processes/OTB.LSMSSegmentation.html
Last modified: Sat Feb 19 15:43:34 CET 2022