Skip to main content

GENIAL : GENes Identification with Abricate for Lucky biologists

Authors : Barbet Pauline, Felten Arnaud

Affiliation: Food Safety Laboratory - ANSES Maisons Alfort (France)

You can find the latest version of the tool at https://github.com/p-barbet/GENIAL

GENIAL

GENIAL aims to identify antimicrobial resistance and virulence genes from bacterial genomes matching them to a database gathering genes of interest using ABRicate.

Databases

Default databases available are (Resfinder, CARD, ARG-ANNOT, NCBI, EcOH, PlasmidFinder, Ecoli_VF and VFDB)

As well as this databes, it's posible to use your own database.

The tool is divided into two scripts.

GENIALanalysis

GENIALanalysis aims to run ABricate. It takes in input a tsv file containing genomes fasta files paths and IDs.If you want to use your own database you also need to provide a multifasta whith genes IDs as headers. Then the script run ABricate and produce in output one ABRicate result file per genome, corresponding to a tsv file including genes found in each sample.

GENIALresults

GENIALresults aims to conditionning ABRicate results in the form of matrixes and heatmaps of presence/absence. It takes in input a temporary file produced by the Abricate analysis containing the genomes Abricate results paths and IDs. In the case of vfdb database a file containing the virulence factors names, their family and species is automticaly included in the script.

The output depending on the database used :

  • In any cases a matrix in tsv format and a heatmap in png format with all genes found are created

On top of that:

  • If you use one of the default databases Resfinder or VFDB news matrix and heatmap by gene type are produced with a correspondace table between the gene name, its family and its number in all genomes.

  • If you don't use one of the two previous databases or if you use your own database, only a corespondance table between the gene name and its number in all genomes is produced in addition.

Dependencies

The script has been developed with python 3.6 (tested with 3.6.6)

External dependencies

Parameters

Command line options

Options Description Required Default
-f tsv file with FASTA files paths ans strains IDs Yes
-dbp Path to ABRicate databases repertory. Implies -dbf and --privatedb Yes if --privatedb
-dbf Multifasta containing the private database sequences. Implies -dbp and --privatedb Yes if --privatedb
-T Number of thread to use No 1
-w Working directory No .
-r Results directory name No ABRicate_results
--defaultdb default databases available : resfinder, card, argannot, acoh, ecoli_vf, plasmidfinder, vfdb or ncbi. Incompatible with --privatedb Yes if not --privatedb
--privatedb Private database name. Implies -dbp and -dbf. Incompatible with --defaultdb Yes if not --defaultdb
--mincov Minimum proportion of gene covered No 80
--minid Minimum proportion of exact nucleotide matches No 90
--R Remove genes present in all genomes from the matrix No False

Test

After installing ABRicate and Pandas and seaborn you can test the script with the command line :

Default database

python AntiViruce.py -f input_file.tsv --defaultdb vfdb -r results_directory --minid 90 --mincov 80

Private database

python AntiViruce.py -f input_file.tsv  --privatedb private_db_name -T 10 -r results_directory --minid 90 --mincov 80 -dbp path_to_abricate_databases_repertory -dbf private_db_multifasta_path

Metadata

Release files for GENIALbiologists 0.9.0

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

Source distribution (sdist)

Source distribution for GENIALbiologists 0.9.0
File Size Uploaded Provenance
GENIALbiologists-0.9.0.tar.gz 12.8 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for GENIALbiologists 0.9.0
File Interpreter ABI Platform
GENIALbiologists-0.9.0-py3-none-any.whl Python 3 none any Details

Total release size: 39.8 kB

Release files / GENIALbiologists-0.9.0.tar.gz

Download URL GENIALbiologists-0.9.0.tar.gz
Size 12.8 kB
Tags Source
SHA-256 checksum
How to use checksums
9376d696e78349e342ea88eb6b391eb05dea0e2d0e51cdfe3f352cff64586eb4
BLAKE2b-256 checksum
How to use checksums
7565042d99504140e45fae8e24004d93dc3db862bd8a83063ce7452ac1b3200b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.8

Release files / GENIALbiologists-0.9.0-py3-none-any.whl

Download URL GENIALbiologists-0.9.0-py3-none-any.whl
Size 27.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
20cb8d33ebef6a8240b4d61edd89ffa384c9eb422cfe0c3a9bf767039bd3b9b6
BLAKE2b-256 checksum
How to use checksums
3f2123a3db9ceef6171f0a4fe3744c25ef87e24c71291a40a3e3c88ed6f9c813
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.8

Security for GENIALbiologists 0.9.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.9.0 This release

2 release files No provenance

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