Skip to main content

arg_ranker

arg_ranker evaluates the risk of ARGs in genomes and metagenomes

Install

pip install arg_ranker

Requirement

  • python 3
  • kraken2: conda install -c bioconda kraken2
    download kraken2 database: kraken2-build --standard --db $KRAKENDB
    where $krakenDB is your preferred database name/location\
  • diamond: conda install -c bioconda diamond\
  • blast+: conda install -c bioconda blast

How to use it

  • put all your genomes (.fa or .fasta) and metagenomes (.fq or .fastq) into one folder ($INPUT)
  • run arg_ranker -i $INPUT --kkdb $KRAKENDB
  • run sh arg_ranking/script_output/arg_ranker.sh

Output

  • Sample_ranking_results.txt (Table 1)

    Sample Rank_I_abu Rank_II_abu Rank_III_abu Rank_IV_abu Unassessed_abu Total_abu Rank_code Rank_I_risk Rank_II_risk Rank_III_risk Rank_IV_risk ARGs_unassessed_risk note1
    WEE300_all-trimmed-decont_1.fastq 2.9E-02 0.0E+00 7.4E-02 7.8E-01 1.2E-01 4.2E-04 1.0-0.0-0.5-1.7-0.3 1.0 0.0 0.5 1.7 0.3 hospital_metagenome
    EsCo_genome.fasta 0.0E+00 0.0E+00 0.0E+00 1.0E+00 0.0E+00 2.0E+00 0.0-0.0-0.0-2.2-0.0 0.0 0.0 0.0 2.2 0.0 E.coli_genome
  1. We compute the abundance of ARGs as the copy number of ARGs divided by the 16S copy number in a sample
    Rank_I - Unassessed_abu: total abundance of ARGs of a risk rank
    Total_abu: total abundance of all ARGs
  2. We compute the risk of ARGs as the average abundance of ARGs of a risk rank divided the average abundance of all ARGs
    Rank_I_risk - Unassessed_risk: the risk of ARGs of a risk rank
    Rank_code: a code of ARG risk from Rank I to Unassessed
  • Sample_ARGpresence.txt:
    The abundance, the gene family, and the antibiotic of resistance of ARGs detected in the input samples

Test

run arg_ranker -i example --kkdb $KRAKENDB
run sh arg_ranking/script_output/arg_ranker.sh
The arg_ranking/Sample_ranking_results.txt should look like Table 1

Metadata for your samples (optional)

arg_ranker can merge your sample metadata into the results of ARG ranking (i.e. note1 in Table 1).
Simply put all information you would like to include into a tab-delimited table
Make sure that your sample names are listed as the first column (check example/metadata.txt).

Copyright

Dr. An-Ni Zhang (MIT), Prof. Eric Alm (MIT), Prof. Tong Zhang* (University of Hong Kong)

Citation

  1. Zhang AN, ..., Alm EJ, Zhang T: Choosing Your Battles: Which Resistance Genes Warrant Global Action? (bioRxiv coming soon)
  2. Yang Y, ..., Tiedje JM, Zhang T: ARGs-OAP: online analysis pipeline for antibiotic resistance genes detection from metagenomic data using an integrated structured ARG-database. Bioinformatics 2016.

Contact

anniz44@mit.edu or caozhichongchong@gmail.com

Release files for arg-ranker 2.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for arg-ranker 2.6
File Size Uploaded
arg_ranker-2.6.tar.gz 6.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for arg-ranker 2.6
File Interpreter ABI Platform
arg_ranker-2.6-py3.6.egg Legacy Egg format - - Details

Total release size: 90.9 MB

Release files / arg_ranker-2.6.tar.gz

Download URL arg_ranker-2.6.tar.gz
Size 6.3 kB
Tags Source
SHA-256 checksum
How to use checksums
ed17a0e717bd7f6cd1176364bf5c466054af05384c34858e06f10a65d8795590
BLAKE2b-256 checksum
How to use checksums
021e09254fb449bb2e9443da742a23589a19508a4d67a8e778e059ff417c6b53
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.8.0 tqdm/4.32.2 CPython/3.6.7

Release files / arg_ranker-2.6-py3.6.egg

Download URL arg_ranker-2.6-py3.6.egg
Size 90.9 MB
Tags Egg
SHA-256 checksum
How to use checksums
8a357e3b01e61b12b04ede81777e0c12911447d4487fd0ec604ce63563bfef0d
BLAKE2b-256 checksum
How to use checksums
e623c149f82990df1013820775336e27dd0bca3c8eb90d394e56f8f96e8b1a98
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.8.0 tqdm/4.32.2 CPython/3.6.7

Release history Release notifications | RSS feed

3.7.2

2 release files

3.7.1

2 release files

3.7

2 release files

3.6

2 release files

3.5

2 release files

3.4

2 release files

3.3

2 release files

3.2

2 release files

3.1

2 release files

3.0.2

2 release files

3.0.1

2 release files

3.0

2 release files

2.8.8

2 release files

2.8.7

2 release files

2.8.6

2 release files

2.8.5

2 release files

2.8.4

2 release files

2.8.3

2 release files

2.8.2

2 release files

2.8.1

2 release files

2.8

2 release files

2.7

2 release files

This release

2.6 This release

2 release files

2.5

2 release files

2.4

2 release files

2.3

2 release files

2.2

2 release files

2.1

2 release files

2.0

1 release file

1.0.5

2 release files

1.0.4

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page