gtax


Namegtax JSON
Version 0.0.11 PyPI version JSON
download
home_pagehttps://github.com/ncbi/gtax
SummaryGtax generate a taxonomy sequence database by genomes
upload_time2024-02-16 15:17:20
maintainerVera Alvarez, Roberto
docs_urlNone
authorVera Alvarez, Roberto
requires_python
licensePublic Domain
keywords biocontainers
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            GTax
====

**GTax** python package provides tools for the creation of the GTax sequence-based database. This database includes
one assembly per organism deposited in the NCBI Genomes database. The sequences are organized by 19 taxonomic levels
from *superkindom* to *clades*. Python pickle files are also provided with a graph data structure for the taxonomic 
tree.

Read the Docs at: https://gtax.readthedocs.io/

Current version
---------------

The current public version is available in GCP for download. You need to use your GCP project as this bucket uses Requester Pays option.

https://console.cloud.google.com/storage/browser/gtax-database/

```
gsutil -u <you-GCP-project> -m cp -r gs://gtax-database/<latest_version> .
```
    
The database is comprised of two folder: **blastdb** and **fasta**. The **blastdb** folder include the BLAST 
indexes for BLAST searches. The **fasta** folder includes the FASTA files for the taxonomy groups and two 
Python Objects in pickle files (**taxonomy.pickle** and **taxonomy_groups.pickle**) which are used to load
all GTax metadata into the [Taxonomy class](https://github.com/ncbi/gtax/blob/main/src/gtax/taxonomy.py#L37)

```python
from gtax.taxonomy import Taxonomy
taxonomy = Taxonomy(tax_pickle_file='taxonomy.pickle', group_pickle_file = 'taxonomy_groups.pickle')
```
Output:

```text
2464341 taxonomies loaded
bacteria Node: 537498 Sequences: 19435
archaea Node: 14266 Sequences: 798
liliopsida Node: 48464 Sequences: 317
eudicotyledons Node: 153108 Sequences: 1077
viridiplantae Node: 48003 Sequences: 185
fungi Node: 186994 Sequences: 914
arthropoda Node: 912789 Sequences: 2596
neoteleostei Node: 31205 Sequences: 1610
actinopterygii Node: 22514 Sequences: 1258
glires Node: 5490 Sequences: 2346
primates Node: 1101 Sequences: 673
carnivora Node: 783 Sequences: 437
artiodactyla Node: 1200 Sequences: 487
amphibia Node: 13009 Sequences: 122
sauropsida Node: 32051 Sequences: 1476
sarcopterygii Node: 4941 Sequences: 376
chordata Node: 4122 Sequences: 400
eukaryota Node: 194114 Sequences: 896
viruses Node: 234108 Sequences: 14233
```


Public Domain notice
====================

National Center for Biotechnology Information.

This software is a "United States Government Work" under the terms of the United States
Copyright Act. It was written as part of the authors' official duties as United States
Government employees and thus cannot be copyrighted. This software is freely available
to the public for use. The National Library of Medicine and the U.S. Government have not
 placed any restriction on its use or reproduction.

Although all reasonable efforts have been taken to ensure the accuracy and reliability
of the software and data, the NLM and the U.S. Government do not and cannot warrant the
performance or results that may be obtained by using this software or data. The NLM and
the U.S. Government disclaim all warranties, express or implied, including warranties
of performance, merchantability or fitness for any particular purpose.

Please cite NCBI in any work or product based on this material.
    

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/ncbi/gtax",
    "name": "gtax",
    "maintainer": "Vera Alvarez, Roberto",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "veraalva@ncbi.nlm.nih.gov",
    "keywords": "Biocontainers",
    "author": "Vera Alvarez, Roberto",
    "author_email": "veraalva@ncbi.nlm.nih.gov",
    "download_url": "https://files.pythonhosted.org/packages/10/3b/9ae94cb794f8f395ce80e0b64ba98112ff4a4865452deab20ce17361435c/gtax-0.0.11.tar.gz",
    "platform": null,
    "description": "GTax\n====\n\n**GTax** python package provides tools for the creation of the GTax sequence-based database. This database includes\none assembly per organism deposited in the NCBI Genomes database. The sequences are organized by 19 taxonomic levels\nfrom *superkindom* to *clades*. Python pickle files are also provided with a graph data structure for the taxonomic \ntree.\n\nRead the Docs at: https://gtax.readthedocs.io/\n\nCurrent version\n---------------\n\nThe current public version is available in GCP for download. You need to use your GCP project as this bucket uses Requester Pays option.\n\nhttps://console.cloud.google.com/storage/browser/gtax-database/\n\n```\ngsutil -u <you-GCP-project> -m cp -r gs://gtax-database/<latest_version> .\n```\n    \nThe database is comprised of two folder: **blastdb** and **fasta**. The **blastdb** folder include the BLAST \nindexes for BLAST searches. The **fasta** folder includes the FASTA files for the taxonomy groups and two \nPython Objects in pickle files (**taxonomy.pickle** and **taxonomy_groups.pickle**) which are used to load\nall GTax metadata into the [Taxonomy class](https://github.com/ncbi/gtax/blob/main/src/gtax/taxonomy.py#L37)\n\n```python\nfrom gtax.taxonomy import Taxonomy\ntaxonomy = Taxonomy(tax_pickle_file='taxonomy.pickle', group_pickle_file = 'taxonomy_groups.pickle')\n```\nOutput:\n\n```text\n2464341 taxonomies loaded\nbacteria Node: 537498 Sequences: 19435\narchaea Node: 14266 Sequences: 798\nliliopsida Node: 48464 Sequences: 317\neudicotyledons Node: 153108 Sequences: 1077\nviridiplantae Node: 48003 Sequences: 185\nfungi Node: 186994 Sequences: 914\narthropoda Node: 912789 Sequences: 2596\nneoteleostei Node: 31205 Sequences: 1610\nactinopterygii Node: 22514 Sequences: 1258\nglires Node: 5490 Sequences: 2346\nprimates Node: 1101 Sequences: 673\ncarnivora Node: 783 Sequences: 437\nartiodactyla Node: 1200 Sequences: 487\namphibia Node: 13009 Sequences: 122\nsauropsida Node: 32051 Sequences: 1476\nsarcopterygii Node: 4941 Sequences: 376\nchordata Node: 4122 Sequences: 400\neukaryota Node: 194114 Sequences: 896\nviruses Node: 234108 Sequences: 14233\n```\n\n\nPublic Domain notice\n====================\n\nNational Center for Biotechnology Information.\n\nThis software is a \"United States Government Work\" under the terms of the United States\nCopyright Act. It was written as part of the authors' official duties as United States\nGovernment employees and thus cannot be copyrighted. This software is freely available\nto the public for use. The National Library of Medicine and the U.S. Government have not\n placed any restriction on its use or reproduction.\n\nAlthough all reasonable efforts have been taken to ensure the accuracy and reliability\nof the software and data, the NLM and the U.S. Government do not and cannot warrant the\nperformance or results that may be obtained by using this software or data. The NLM and\nthe U.S. Government disclaim all warranties, express or implied, including warranties\nof performance, merchantability or fitness for any particular purpose.\n\nPlease cite NCBI in any work or product based on this material.\n    \n",
    "bugtrack_url": null,
    "license": "Public Domain",
    "summary": "Gtax generate a taxonomy sequence database by genomes",
    "version": "0.0.11",
    "project_urls": {
        "Documentation": "https://gtax.readthedocs.io/",
        "Homepage": "https://github.com/ncbi/gtax",
        "Source": "https://github.com/ncbi/gtax",
        "Tracker": "https://github.com/ncbi/gtax/issues"
    },
    "split_keywords": [
        "biocontainers"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "51e34bf20775364e2111b264e1a71ff9cc96da84208a9438a9c651ebf868b3d7",
                "md5": "9e2e34e8f19f75f5210104645bb5c6d1",
                "sha256": "6187299cd097df3f1d835a82667cc532a61a7574d71e7616f481bdd969516f7a"
            },
            "downloads": -1,
            "filename": "gtax-0.0.11-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "9e2e34e8f19f75f5210104645bb5c6d1",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 16989,
            "upload_time": "2024-02-16T15:17:18",
            "upload_time_iso_8601": "2024-02-16T15:17:18.506547Z",
            "url": "https://files.pythonhosted.org/packages/51/e3/4bf20775364e2111b264e1a71ff9cc96da84208a9438a9c651ebf868b3d7/gtax-0.0.11-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "103b9ae94cb794f8f395ce80e0b64ba98112ff4a4865452deab20ce17361435c",
                "md5": "da6dbe67750c0d099aa0fe0cf0091bef",
                "sha256": "900cb937d712f38bd17abffe1d46d4d04525934da5fd5018a46716f55316eea7"
            },
            "downloads": -1,
            "filename": "gtax-0.0.11.tar.gz",
            "has_sig": false,
            "md5_digest": "da6dbe67750c0d099aa0fe0cf0091bef",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 80347,
            "upload_time": "2024-02-16T15:17:20",
            "upload_time_iso_8601": "2024-02-16T15:17:20.653985Z",
            "url": "https://files.pythonhosted.org/packages/10/3b/9ae94cb794f8f395ce80e0b64ba98112ff4a4865452deab20ce17361435c/gtax-0.0.11.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-02-16 15:17:20",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "ncbi",
    "github_project": "gtax",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "tox": true,
    "lcname": "gtax"
}
        
Elapsed time: 0.45627s