Metadata-Version: 2.1
Name: CPACqc
Version: 0.2.16
Summary: A BIDS QC report generator
Author-Email: Biraj Shrestha <birajstha@gmail.com>
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Project-URL: Homepage, https://github.com/birajstha/bids_qc
Requires-Python: >=3.12
Requires-Dist: anyio==4.9.0
Requires-Dist: art==6.5
Requires-Dist: attrs==25.3.0
Requires-Dist: bids2table==2.0.0
Requires-Dist: bidsschematools==1.0.3
Requires-Dist: blinker==1.9.0
Requires-Dist: cachetools==5.5.2
Requires-Dist: certifi==2025.1.31
Requires-Dist: cffi==1.17.1
Requires-Dist: chardet==5.2.0
Requires-Dist: charset-normalizer==3.4.1
Requires-Dist: click==8.2.0
Requires-Dist: colorama==0.4.6
Requires-Dist: contourpy==1.3.1
Requires-Dist: cryptography==44.0.1
Requires-Dist: css-html-js-minify==2.5.5
Requires-Dist: cssselect==1.3.0
Requires-Dist: cssutils==2.11.1
Requires-Dist: cycler==0.12.1
Requires-Dist: DateTime==5.5
Requires-Dist: docutils==0.21.2
Requires-Dist: elbow==0.1.1
Requires-Dist: filelock==3.18.0
Requires-Dist: fonttools==4.56.0
Requires-Dist: h11==0.16.0
Requires-Dist: hishel==0.1.2
Requires-Dist: htmlmin==0.1.12
Requires-Dist: httpcore==1.0.9
Requires-Dist: httpx==0.28.1
Requires-Dist: idna==3.10
Requires-Dist: Jinja2==3.1.6
Requires-Dist: joblib==1.4.2
Requires-Dist: jsonschema==4.23.0
Requires-Dist: kaleido==0.2.1
Requires-Dist: kiwisolver==1.4.8
Requires-Dist: lxml==5.3.1
Requires-Dist: markdown-it-py==3.0.0
Requires-Dist: MarkupSafe==3.0.2
Requires-Dist: matplotlib==3.10.0
Requires-Dist: mdurl==0.1.2
Requires-Dist: msgpack==1.1.0
Requires-Dist: nh3==0.2.21
Requires-Dist: nibabel==5.3.2
Requires-Dist: nilearn==0.11.1
Requires-Dist: numpy==2.2.3
Requires-Dist: packaging==24.2
Requires-Dist: pandas==2.2.3
Requires-Dist: pillow==11.1.0
Requires-Dist: plotly==6.1.0
Requires-Dist: premailer==3.10.0
Requires-Dist: pyarrow==19.0.0
Requires-Dist: pycparser==2.22
Requires-Dist: Pygments==2.19.1
Requires-Dist: pyparsing==3.2.1
Requires-Dist: python-dateutil==2.9.0.post0
Requires-Dist: python-dotenv==1.1.0
Requires-Dist: pytz==2025.1
Requires-Dist: PyYAML==6.0.2
Requires-Dist: reportlab==4.3.1
Requires-Dist: requests==2.32.3
Requires-Dist: scikit-learn==1.6.1
Requires-Dist: scipy==1.15.2
Requires-Dist: six==1.17.0
Requires-Dist: sniffio==1.3.1
Requires-Dist: socksio==1.0.0
Requires-Dist: threadpoolctl==3.5.0
Requires-Dist: tomlkit==0.13.2
Requires-Dist: tqdm==4.67.1
Requires-Dist: typing_extensions==4.12.2
Requires-Dist: tzdata==2025.1
Requires-Dist: urllib3==2.3.0
Requires-Dist: zope.interface==7.2
Description-Content-Type: text/markdown

[![PyPI Downloads](https://static.pepy.tech/badge/cpacqc)](https://pepy.tech/projects/cpacqc)
[![PyPI Version](https://img.shields.io/pypi/v/cpacqc.svg)](https://pypi.org/project/cpacqc/)
[![Build Status](https://github.com/birajstha/bids_qc/actions/workflows/workflow.yml/badge.svg)](https://github.com/birajstha/bids_qc/actions)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python Versions](https://img.shields.io/pypi/pyversions/cpacqc.svg)](https://pypi.org/project/cpacqc/)
# CPAC-QC Plotting App

### PDF Report
![PDF report](https://raw.githubusercontent.com/birajstha/bids_qc/main/static/cpac-qc_pdf.png)
example PDF report here: [PDF REPORT](https://github.com/birajstha/bids_qc/raw/main/static/sub-A00040524_ses-NFB3_qc_report.pdf)


## Overview

The CPAC-qc Plotting App is a tool designed to generate quality control plots for the CPAC (Configurable Pipeline for the Analysis of Connectomes) outputs. This app helps in visualizing and assessing the quality of neuroimaging data processed through CPAC.

## Updates
- Outputs only PDF report now.
- [Default config](https://github.com/birajstha/bids_qc/raw/main/static/overlay.csv) has overlays.
- Images on PDF report will follow the order mentioned in overlay.csv provided or default.
- Added Bookmarks on PDF report for easy navigation.

## Features
- Generate bulk or subject specific plots and reports.

## Requirements

- BIDS dir with `.nii.gz` images in it.
- PDF viewer

## Installation

```bash
pip install CPACqc
```

## Usage


1. **Minimal code**

```bash
cpacqc -d bids_dir
```

This will output a pdf report `report.pdf` in your current directory.

2. **Providing output dir**

```bash
cpacqc -d bids_dir -o output_dir
```
output_dir will be created if not available. Make sure to have write permissions.

3. **Running single/multiple Subjects**

```bash
cpacqc -d bids_dir -s subject-id_1 subject-id_2
```

You can hand pick a single or a multiple subjects with `-s` flag


4. **With defined number of procs**

```bash
cpacqc -d bids_dir  -n number-of-procs
```

Note: if -n is not provided default is 8


5. **Providing custom Overlays config**

```bash
cpacqc -d path/to/bids_dir -c ./overlay.csv
```

where overlay.csv can be in format

```csv
output,underlay,datatype
desc-preproc_bold,desc-preproc_T1w,func
```

and so on.
If not provided a [default config](https://github.com/birajstha/bids_qc/raw/main/static/overlay.csv) will be used.

## Viewing

Use any PDF viewer to view `*report.pdf` file.

If `-html` enabled, Use any `.html` viewer extension to view `index.html` in the `results` dir.