Metadata-Version: 2.1
Name: apscale
Version: 1.0.5
Summary: Advanced Pipeline for Simple yet Comprehensive AnaLysEs of DNA metabarcoding data
Home-page: https://github.com/DominikBuchner/apscale
Author: Dominik Buchner
Author-email: dominik.buchner524@googlemail.com
License: MIT
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: openpyxl (>=3.0.6)
Requires-Dist: psutil (>=5.8.0)
Requires-Dist: pandas (>=1.2.1)
Requires-Dist: demultiplexer (>=1.1.0)
Requires-Dist: joblib (>=1.0.0)
Requires-Dist: biopython (>=1.78)
Requires-Dist: cutadapt (>=3.5)

# apscale
Advanced Piepline for Simple yet Comprehensive AnaLysEs of DNA metabarcoding data

## Introduction
Apscale is a metabarcoding pipeline that handles the most common tasks in in metabarcoding
pipelines like paired-end merging, primer trimming, quality filtering, otu clustering and
denoising. It uses a simple command line interface and is configured via a single configuration file.
It automatically uses the available ressources on the machine it runs on while still providing the option
to use less if desired.

## Installation

Apscale can be installed on all common operating systems (Windows, Linux, MacOS).
Apscale requires Python 3.7 or higher and can be easily installed via pip in any command line:

`pip install apscale`

To update apscale run:

`pip install --upgrade apscale`

### Further dependencies

Apscale calls vsearch for multiple modules. It should be installed and be in PATH to be executed
from anywhere on the system.

Check the vsearch Github page for further info:

https://github.com/torognes/vsearch

Support for compressed files with zlib is necessary. For Unix based systems this is shipped with
vsearch, for Windows the zlib.dll can be downloaded via:

[zlib for Windows](https://sourceforge.net/projects/mingw-w64/files/External%20binary%20packages%20%28Win64%20hosted%29/Binaries%20%2864-bit%29/zlib-1.2.5-bin-x64.zip/download)

The dll has to be in the same folder as the vsearch executable. If you need help with adding a folder to PATH in windows
please take a look at the first answer on this stackoverflow issue:

[How to add a folder to PATH Windows](https://stackoverflow.com/questions/44272416/how-to-add-a-folder-to-path-environment-variable-in-windows-10-with-screensho)

To check if everything is correctly set up please type this into your command line:

`vsearch --version`

It should return a message similar to this:

```
vsearch v2.19.0_win_x86_64, 31.9GB RAM, 24 cores
https://github.com/torognes/vsearch

Rognes T, Flouri T, Nichols B, Quince C, Mahe F (2016)
VSEARCH: a versatile open source tool for metagenomics
PeerJ 4:e2584 doi: 10.7717/peerj.2584 https://doi.org/10.7717/peerj.2584

Compiled with support for gzip-compressed files, and the library is loaded.
zlib version 1.2.5, compile flags 65
Compiled with support for bzip2-compressed files, but the library was not found.
```

## How to use

### Create a new apscale project

Apscale is oranized in projects with the following structure:

<pre>
C:\USERS\DOMINIK\DESKTOP\EXAMPLE_PROJECT
â”œâ”€â”€â”€1_raw data
â”‚   â””â”€â”€â”€data
â”œâ”€â”€â”€2_demultiplexing
â”‚   â””â”€â”€â”€data
â”œâ”€â”€â”€3_PE_merging
â”‚   â””â”€â”€â”€data
â”œâ”€â”€â”€4_primer_trimming
â”‚   â””â”€â”€â”€data
â”œâ”€â”€â”€5_quality_filtering
â”‚   â””â”€â”€â”€data
â”œâ”€â”€â”€6_dereplication_pooling
â”‚   â””â”€â”€â”€data
â”‚       â”œâ”€â”€â”€dereplication
â”‚       â””â”€â”€â”€pooling
â”œâ”€â”€â”€7_otu_clustering
â”‚   â””â”€â”€â”€data
â””â”€â”€â”€8_denoising
    â””â”€â”€â”€data
</pre>

A new project can be initialized with the command:

`apscale --create_project NAME`

If you prefer to have your data all in one place you can paste the raw data into 1_raw_data/data.
Demultiplexing won't be handled by Apscale because there are to many different tagging systems out there at the moment.
If you are using inline barcodes you can take a look at https://github.com/DominikBuchner/demultiplexer.
If you are already starting with **demultiplexed** data please paste them into 2_demultiplexing/data.

### Configuring the settings

Associated with every project Apscale with generate an Excel sheet in the project folder called "Settings.xlsx".
It is divided into a seperate sheet for every module and a 0_general_settings tab.


