Amplicon Suite Aggregator
Description
Aggregates results from AmpliconSuite-pipeline runs.
- Accepts compressed input files (
.tar.gz,.zip) of individual or grouped AmpliconSuite results, or plain directories. - Aggregates and packages results into a new
.tar.gzfile, along with an aggregated.csvand.htmlsummary. - The output
.tar.gzcan be directly uploaded to AmpliconRepository.org. - Supports batch sample renaming via a name map file.
- Can include auxiliary files alongside the upload; place them in a directory containing a file named
AUX_DIR.
Installation
Option 1 — pip
pip install AmpliconSuiteAggregator
Option 2 — Git clone
git clone https://github.com/AmpliconSuite/AmpliconSuiteAggregator.git
cd AmpliconSuiteAggregator
pip install -r requirements.txt
Dependencies
Python packages: pandas, requests
Usage
python src/AmpliconSuiteAggregator.py -flist <input_list.txt> -o <project_name> [options]
input_list.txt is a plain text file with one input path per line (.tar.gz, .zip, or directory).
Aggregation options
| Flag | Description |
|---|---|
-flist FILE |
Text file listing input paths, one per line |
--files PATH [PATH ...] |
Input files or directories directly on the command line |
-o NAME |
Output prefix / project name (required) |
--name_map FILE |
Two-column file: col 1 = current sample name, col 2 = replacement name. Applies a deep rename throughout all output files and tables. |
-c {Yes,No} |
Re-run Amplicon Classifier on inputs (Yes/No) |
--ref GENOME |
Reference genome: hg19, GRCh37, GRCh38, GRCh38_viral, or mm10 |
AmpliconRepository upload options
| Flag | Description |
|---|---|
-u EMAIL |
AmpliconRepository username (email). If provided, triggers upload after aggregation. |
--upload_only {Yes,No} |
Skip aggregation and upload an existing .tar.gz directly |
-s {prod,dev} |
Target server (prod for most users) |
Examples
Aggregate a set of results:
python src/AmpliconSuiteAggregator.py -flist input_list.txt -o MyProject
Aggregate and upload to AmpliconRepository:
python src/AmpliconSuiteAggregator.py -flist input_list.txt -o MyProject -u you@email.com -s prod
Upload an already-aggregated file without re-aggregating:
python src/AmpliconSuiteAggregator.py --files MyProject.tar.gz -o MyProject -u you@email.com --upload_only Yes -s prod
Input files
For a breakdown of which per-sample files make up a classification project — which are essential, which are strongly recommended, and the naming patterns the Aggregator expects — see INPUT_FILES.md.
Authors
- Jens Luebeck (main contact)
- Thorin Tabor
- Edwin Huang
Issues
Bug reports and feature requests: GitHub Issues
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ampliconsuiteaggregator-8.1.0.tar.gz.
File metadata
- Download URL: ampliconsuiteaggregator-8.1.0.tar.gz
- Upload date:
- Size: 43.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
27f9940b1108354f11d696c399eea12a57265c2f0c8f2b53aea025f5438eca0d
|
|
| MD5 |
0f220880126a8328c15632456b8e6984
|
|
| BLAKE2b-256 |
4d5bdeb095d17c68704c9bbc60c4cef73ec62bd3a6a16ae97aa61ad779d56661
|
File details
Details for the file ampliconsuiteaggregator-8.1.0-py3-none-any.whl.
File metadata
- Download URL: ampliconsuiteaggregator-8.1.0-py3-none-any.whl
- Upload date:
- Size: 46.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4c7b9cb64ced2fd7696e8ac050c00e6e052b7653b0b7092005ad49f25dc9712e
|
|
| MD5 |
b600cb42c9390ae7689ba951d0f3fb89
|
|
| BLAKE2b-256 |
009f0bb354cdf69877f29350fef1dedb6c237a05dae0066c0f7892c1d806042f
|
