How to Run a Reference Pipeline using Local Input Files

Download & Install the Pipeline from NGC

Please refer to Setup section to install this Pipeline.

Note down the pipeline ID during the pipeline installation as it would be used in a later section to trigger a job with input files.

Trigger Pipeline

A pipeline can be triggered via Clara CLI. To trigger this pipeline, you will need to have a set of relevant images that can be used as source input data.

For this created pipeline, sample input files are available within the SDK in /png subfolder of the zipped test data file. Let's say that the path of the unzipped test data folder is TEST_DATA_FOLDER.

Open a terminal and go to the directory which contains the reference pipeline.

cd ~/.clara/pipelines/clara_ai_breast_pipeline

Trigger the pipeline (upload input png files to Clara API Server) with the pipeline ID in the previous section.

clara create jobs -n breast-test -p <pipeline ID> -f <TEST_DATA_FOLDER>/png/

When the above step is completed, you should be able to see the following result in the terminal (UUID of Job and Payload will be different).

JOB_ID: daa5aea74d1446a8a24b9d3990bfef67
PAYLOAD_ID: 79aa5500e6134cf888f1d6d89f2e249e

Note down this job ID and payload ID as they would be used in a later section to access output files.

Then, start the job:

clara start job -j <JOB ID>

Check Job Status and Download/View Payloads in Clara Console/Dashboard

With Clara Orchestrator (API version >= 0.4.0)

Go to the Clara Management Console using a web browser: The URL is: <IP of the machine>:32002
Go to the JOBS view. You should see a job with a name that includes the name of the job you specified
You can inspect the status of each operator inside that job

Please check Clara Management Console to see the web application in detail.

With Argo Orchestrator (API version <= 0.3.0)

Go to the Clara dashboard UI using a web browser: The URL is <machine-ip>:8000.

You should see a job with a name that includes the name of the pipeline you created.
You can inspect the status of each operator inside that job

Download and Verify the Outputs

Once the job has completed successfully, we can download output payload by using clara download command.

Output payload files are located under /operators/<operator name defined in the pipeline definition>/ folder. Since we triggered a pipeline whose AI operator's name is ai-app-breast, we can use the following command to download output files:

clara download <Job ID>:/operators/ai-app-breast/*

Then, you can see the output files using the following command:

eog *.png # View image output using `eog` which is an image viewer available in Ubuntu

If you are working with the server machine, the payload folder is directly accessible at the default payload folder /clara/payloads/<Payload ID>/.