---
title: "Run a pipeline as a batch process"
canonical: "https://help.vicon.com/space/Nexus220/897713698/Run%20a%20pipeline%20as%20a%20batch%20process"
format: markdown
---
If necessary, for example, if you are working with large numbers of files, you can set up and run automated operations as batch processes, using the controls in the **Batch Processing** pane in the **Tools** panel.

> ⚠️ **Trials batch processed in Nexus 2.17**  
> ⚠️ Trials that were batch-processed with Nexus 2.17 may produce erroneous results that can be difficult to detect. For information on this issue and what action to take, see [Known issues](https://vicon-help.atlassian.net/wiki/spaces/Nexus220/pages/897712326) in *What’s new in Nexus 2.20?*

## Batch process multiple trials

You can automatically process any number of trials from the current motion capture database using the **Batch Processing** button at the top of the **Tools** pane.

> ![RunAsBatch.png](media://9bf3b078-32ec-48f3-b691-e6dbb567ac46)

Batch processing is optional. It is useful for processing large numbers of files simultaneously or for automating frequently used processing operations.

> ⚠️ **Important**   
> ⚠️ Before batch processing trial data, ensure that you have already:  
> ⚠️ ▪️ Captured trial data  
> ⚠️ ▪️ Created any pipelines you intend to run

> Macro (scroll-pagebreak)

**To batch process trial data:**

1. In **Data Management**, mark the nodes (select nodes, right-click and click **Mark** or press **M**) containing the files you wish to batch process.
2. If the **Batch Processing** panel is not already displayed, at the top of the **Tools** pane, click the **Batch Processing** button > Macro (inline-media-image)

.   
The marked nodes are displayed in the **Trial** column.  
:check_mark: **Tip**: To remove nodes from batch processing, on the **Data Management** tab, unmark the nodes (right-click marked nodes and click **Clear Marks**).
3. From the drop-down menu at the bottom of the **Batch Processing** panel, select the pipeline to be run on the listed trial files and click the **Start Processing** button to start the batch process.
  During the batch processing, the **Progress** column in the trials list indicates the overall status of the processing:
  - Blank: Batch processing idle.
  - Yellow moving bar: Batch processing in progress.
  - Green static bar: Batch processing successfully completed.
  - Red static bar: Batch processing failed or canceled.  
After the pipeline is run on each trial, you are given the option to save changes (Yes/No) or cancel the operation for that trial and move on to the next marked trial.   
:check_mark: **Tip**: To stop the processing for all trials, click the Stop button  at the bottom right of the Batch Processing panel. Processing continues for the current trial but stops before any other trials are processed.

> ✅ **Tip**  
> ✅ Hover the mouse pointer over a progress bar to view details of the batch processing operations.