How Do I Run A DPS Job?

There are 3 ways to do this: guided through popups, via the Jobs Main Widget UI, and via a call to the maap-py Python library.

Option 1: Guided Popups

Open the DPS/MAS Operations menu and select Execute DPS Job.

Then select the algorithm you wish to run from the dropdown of what is currently available and click OK.

If the chosen algorithm requires inputs, a new popup will ask for inputs to each field the algorithm takes. If it doesn’t take inputs, the popup will say so. Click OK again to view the ID for the job you just submitted. If you didn’t get to save it, just click DPS UI -> Refresh Job List, and the latest job will appear at the top of the Jobs side panel.

Option 2: Jobs UI

Open the UI if you haven’t already done so (DPS UI Menu -> DPS Jobs UI).

Under the Run Jobs tab and under Algorithms List, click on the algorithm you wish to run. To the side, you will see the stored algorithm description, and the Execute Job column will automatically update for required inputs. Fill out those fields and click the Execute Job button. Your submitted job’s ID will appear below the button.

Option 3: Python Call

From within a Jupyter Notebook running Python, or inside a Python script, you can use the maap-py library. This is already installed on all ADE workspaces. To import/set it up, you can click the small MAAP button at the top left of the Jupyter toolbar, or you can add these lines before your script:

from maap.maap import MAAP
maap = MAAP()

You are then required to pass your algorithm’s name, version, required inputs, and username to the function maap.submitJob (identifier is job-algo_name:algo_version):

# Add some search results to create a list of granules
granules = []
mit_result = maap.submitJob(
    identifier="jobplot_analysis_demo_ubuntu:master",
    algo_id="plot_analysis_demo_ubuntu",
    version="master",
    username="bsatoriu",
    granules=[]
)