# STEP 5: Launching the QuNex container for MRSession(s)

Containers can be launched in bulk or individually. From the Project Page, navigate to MR Session Tab, **→** Click on **_Processing Dashboard_**. This will lead you to the page allowing container selection.

![Processing Dashboard](../Images/image_14.png)

**Step 5A:** **_Select MRSessions_** **→** Click on **_Session_** you wish to process.

![MRSessions](../Images/image_15.png)

![Session](../Images/image_15b.png)

**STEP 5B**: Set input arguments for the batch.

![Input arguments](../Images/image_16.png)

![Input arguments 2](../Images/image_16b.png)

**STEP 5C**: All input parameters would already be populated. → Click on **_Run Containers_**.

![Run Containers](../Images/image_16c.png)

## Monitoring workflow progress and stopping a submitted job

As the container executes, a workflow entry is created and this is updated after execution of each step. The workflow status changes from **_Created_** to **_Preparing_** to **_Queued_** to **_Running_** to **_Complete_** (or **_Failed_**). One can view the stdout and stderr as the container executes. Open the Processing Dashboard to view the workflow progress and the log files.

![Monitoring](../Images/image_18.png)

If for some reason, a container job is to be stopped/killed, click on **Terminate container.**

![Terminate container](../Images/image_19.png)

## Examining results of the QuNex pipeline

The **_QuNex Pipeline_** takes ~24-36h to complete per session. The pipeline time to completion is heavily dependent on the time taken by the hcp_freesurfer script (anywhere from 12-24h depending on the solution) and how many fMRI scans have been acquired (~1-2h per BOLD scan), which affects the hcp_fmri_volume step.

Note: The hcp_fmri_volume portion of the QuNex Pipeline can be parallelized where each of the BOLD scans is ran on a single core of a multi-core server using the **_--parsessions_** flag. This dramatically speeds up the time taken to completion. This would be done by setting the variable _parsessions in the batch parameters file. For details see: [HCPPreprocessing](../UsageDocs/HCPPreprocessing)

Once the pipeline completes, the following resources are generated within the XNAT system at the **_MRSession_** level:

* **_hcp_**: This folder contains all the files generated by the QuNex Pipeline

* **_INFO_**: This folder contains the parameter files which were used and were generated by the QuNex code. It also contains the relevant log files in **_runlogs_** and **_comlogs_** subfolders.

* **_QC_**: This folder contains the QC images of T1w, T2w (if applicable), myelin (if applicable), BOLD and DWI processing steps.

* **_<resource_name>_**: By the same logic XNAT can integrate any arbitrary resource as part of its output and attach it at the **_MRSession _**level. This is relevant for future pipeline development.

## Accessing the QuNex pipeline output

Navigate to the **_MRSession_** for which the QuNex pipeline has been completed, click on Actions -> Manage Files.

![Manage files](../Images/image_20.png)

![Manage files 2](../Images/image_20b.png)

## Downloading the QuNex processed data

If the file(s) to be downloaded do not add up to a lot of bytes, select the required files and click on Download (see above). For this exemplar the **_hcp_** resource contains about 148GB of data. This size can vary substantially depending on the number of BOLD runs and the intermediate processing steps that are retained. The final processed results are contained in:

~/hcp/<session_id>/MNINonLinear* **# Final location of the HCP results*

## Viewing details of the QuNex pipeline

To see the detailed information on the steps executed for each of the QuNex Pipelines navigate to the **MRSession** report page and expand the **History** listing. Then click on the relevant sections to inspect history.

![History](../Images/image_21.png)

Note: This will display the relevant **Workflow Details** of the selected **History**, such as the location of the XNAP Pipeline that was executed (*Pipeline*), the directory where the data is processed (*builddir*), the path to the XML parameter file that is specific to this Action (*Parameter file path*), as well as the batch parameter file name (*batch_parameters_filename*) and the mapping file name (*scan_mapping_filename*).

## QuNex pipeline workflow details output

![Output](../Images/image_22.png)

## Viewing the QC images and the pipeline logs

To view the QC image results, navigate to the **MRSession** report page. If the **MRSession** has the **_hcp_** resource, links to view the QC images are available after the scan listing.

![QC images](../Images/image_23.png)

![QC images 2](../Images/image_23b.png)

To examine detailed workflow output logs, navigate to the **→ MRSession** report page and examine the attached files. If the **MRSession** has the **_INFO_** resource, the relevant log files in **_runlogs_** and **_comlogs_** subfolder.

![Log files](../Images/image_24.png)