Metadata-Version: 2.1
Name: bam2plot
Version: 0.2.7
Summary: Plot of coverage from bam file
Home-page: https://github.com/willros/bam2plot
Author: William Rosenbaum
Author-email: william.rosenbaum@gmail.com
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pandas ==2.2.1
Requires-Dist: pysam ==0.22.0
Requires-Dist: seaborn ==0.13.2

# BAM2PLOT

Plot your bam files!

bam2plot generates coverage plots:
![plot](example/example.png)

... and cumulative coverage plots for each reference (*e.g.* chromosomes) for each sample:
![plot](example/cumplot.png)


## Dependencies
`bam2plot` depends on `perbase`, which you can install via:
```bash
cargo install perbase 
# or
conda install -c bioconda perbase
```
## Installation

You can install `bam2plot` using the following pip command:

```bash
pip install bam2plot
```

## Usage
Once installed, you can use the `bam2plot` command to perform coverage analysis on BAM files and generate coverage plots. Here's how to use it:

```bash
usage: bam2plot [-h] -b BAM [-o OUTPATH] [-w WHITELIST] [-t THRESHOLD] [-r ROLLING_WINDOW] [-i | --index | --no-index]
                [-s | --sort_and_index | --no-sort_and_index] [-z ZOOM] [-l | --log_scale | --no-log_scale]
                [-c | --cum_plot | --no-cum_plot]

Plot your bam files!

options:
  -h, --help            show this help message and exit
  -b BAM, --bam BAM     bam file
  -o OUTPATH, --outpath OUTPATH
                        Where to save the plots.
  -w WHITELIST, --whitelist WHITELIST
                        Only include these references/chromosomes.
  -t THRESHOLD, --threshold THRESHOLD
                        Threshold of mean coverage depth
  -r ROLLING_WINDOW, --rolling_window ROLLING_WINDOW
                        Rolling window size
  -i, --index, --no-index
                        Index bam file (default: False)
  -s, --sort_and_index, --no-sort_and_index
                        Index and sort bam file (default: False)
  -z ZOOM, --zoom ZOOM  Zoom into this region. Example: -z='100 2000'
  -l, --log_scale, --no-log_scale
                        Log scale of Y axis (default: False)
  -c, --cum_plot, --no-cum_plot
                        Generate cumulative plots of all chromosomes (default: False)
```

## Outputs

The BAM2Plot package generates coverage plots for each reference sequence in the BAM file. The plots are saved as SVG and PNG files in the specified output path or the default location.

## Examples

Here's an example of how to use the BAM2Plot package:

```bash
bam2plot --bam input.bam --outpath output_folder --rolling_window 50 --threshold 5 -s -c
```
