How to do on-demand processing
Access processing service panel
In the ESA Charter Mapper on-demand processors can be found by opening the
Processing services panel located in the right of the interface.
Services tab contains the list of available Processing Services which can be quickly filtered by tags.
Find more information about the service tag filter here.
Jobs tab contains the list of the jobs submitted by the users.
More information about the
Jobs tabs of the processing services panel can be found here.
More details about each of the physical meaning or visual products of the ESA Charter Mapper can be found in the specifications of each service.
How to submit an on-demand job
Once you identified the on-demand processor to use, click on the service icon to access the
Service details. This view includes a description of the selected service (title, version, caption), followed by a form of all the input parameters to be filled-in.
Fill the parameters and run the job
Users can fill the form manually, by feature dragging (if available for the input) or by the geobrowser clipboard. Is also possible to import and export parameters set in a json format.
Find more information about the drag and drop of features here.
Once all mandatory fields have been correctly inserted, the user can submit the job by clicking on the button Run Job located in the bottom of the service details tab.
A description of the tools or functions that can be employed in the Service details can be found here.
Checking for job duplicates
After the click on
Run Job the platform firstly checks if a job with exactly the same params already exists. This is made by looking at the jobs of the user or the ones shared by the others. In this step the message in the Run Job button changes to
Checking for job duplicates... If one or more duplicates are found a warning will appear under the button. This check is required to avoid duplicates of the same job. In case a job with the very same parameters must be re-submitted the user can click on the Button
Run Job (force) and trigger the processing again.
Validation of input parameters
After the check for job duplicates, the system validates the parameters inserted by the user with an assertion. At this stage the message in the Run Job button turns to
Validating the job... In case of error the assertion will provide a warning explaining why a parameter is not correctly defined.
Monitor the running job
After the job submission, it is possible to monitor job progress through the progress bar. Running jobs have
Running as status the running percentage status can seen in the Job Details as well as in Jobs tab.
The progress bar will evolve as following:
0%processing not started yet,
50%processing is running,
99%the processing is accomplished but the result still needs to be published.
Edit job name
Users can edit the default name of a job by clicking on the pencil icon next. Adding a different name to the job could help to easily retrieve a particular job when searching for multiple results made with the same processor or similar params.
The editing of a job name is possible ONLY when the job is running.
Once a job is completed it is not anymore possible to edit the name of a job.
The publication of the result from an on-demand processor is triggered immediately when the user checks the job status.
The publication of a result from a job is not automatically triggered when the user is not connected because it needs a valid user session token. Thus, the job status will remain at 99% until the user does not check the job status once back into the workspace.
Once the job is accomplished the status will change from
How to find the result
The final status of the job can be either
Failed. If successful the user can access the result in the workspace, show output single band or overview assets in the map, and download the needed single band or overview assets for visualization and further processing outside the platform.
After the successful run of an on-demand job, users can access the job result by clicking on the
Show results or
Show input and results buttons located in the bottom of the service details.
Users can visualize the result in the map by clicking on the
Show results button located in the bottom of the service details.
When clicking on
Show results one or more features will appear in the left panel under the Results tab representing the output of the job.
For each selected feature the geobrowser will show the default asset in the map. This default asset is usually an overview derived from one or more single band assets generated by the service.
Show Result button to quickly visualize the result in the map.
Link input Dataset to job result
When evaluating a product derived from on demand processing, it is often useful to retrieve input data. From the job details available in the job results panel, a dedicated button
Show Input and Results next to the
Show Result one, is available for this scope. The
Show input and results button allows users to quickly add in the Feature Basket the job input Datasets and the generated results.
When clicking on the
Show input and results a list of features will appear in the left panel under the Features Basket tab, representing both input and output of the job.
Show input and results button to compare the result with the input.
Show Input and Results button is meant to let users analyse input images together with the service output. The Feature Basket is used because it is the area in the platform designed to allow handling in the same place items of different nature.
Find more information about the features basket here.
Job name under the result feature title
Under the feature titles of results from on-demand processing include an information tag with the name that the user has assigned to the job.
This is particularly useful to quickly retrieve a job of interest when searching under the Results panel the features from the Results data context.
Change job visibility
By default the visibility of the job is set to
Private which means that the job is visible only to the owner of the job.
When needed the job can be shared with other users. This is possible by clicking on the
(share) button. After that the visibility of the job will change to
Shared. Once shared the job is visible to the other users that have access to the activation workspace.
It is also possible to change the visibility of a Shared job to Private by clicking on the
Delete a job
If needed the user can delete a failed or successful job by clicking on the
x icon located in the upper left corner of a job feature in the list.
It is not possible to delete or kill a running job. Only jobs having status as
Failed can be deleted from the list.
Contact the support in case of failure
In case of failure of a job the user can contact the support team by clicking on the
Contact Support button.
A popup with a pre-filled form providing essential information about the job will appear. The user must insert the email address where he/she wants to receive the ticket updates. The user can also edit the subject and the body of the message before sending it to the help-desk.
For any other issues in the usage of the processing services of ESA Charter Mapper please send an e-mail to: email@example.com
08:00 to 16:00 UTC
07:00 to 15:00 UTC (end March - end October, daylight saving time period)
and (outside above hours and days) also to: firstname.lastname@example.org