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, a sample chest x-ray file in 16-bit png format is available within the SDK in /png subfolder of the zipped test data file (app_chestxray-input_v1.zip). Let's say that the path of the unzipped test data folder is TEST_DATA_FOLDER.

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

cd ~/.clara/pipelines/clara_ai_chestxray_pipeline

2. Trigger the pipeline (push an input png file to Clara API Server) with the pipeline ID in the previous section.

clara create jobs -n chestxray-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 may be different).

JOB ID:f3170b457f5c41879951e6da8f37341e
PAYLOAD ID:12bb398cb54844d5958d51e66e10713a

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>

Verify the Pipeline Execution in Dashboard

• Go to the Clara dashboard UI using a web browser: The URL is: <IP of the machine>:8000
• You should see a job with a name that includes the name of the job you specified (chestxray-test)
• You can inspect the status of each operator inside that job
• Viewing status on a UI for Pipeline Jobs executed using the Clara orchestrator option is currently not available. See: orchestrator

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-chestxray, we can use the following command to download output files:

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

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

cat output-AA0007572607123433_v2.csv # View text output
eog output-AA0007572607123433_v2.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>/.