NCBImeta 0.4.1

Efficient and comprehensive metadata acquisition from the NCBI databases (includes SRA).

[](https://github.com/ktmeaton/NCBImeta/releases/tag/v0.4.2) [](https://github.com/ktmeaton/NCBImeta/blob/master/LICENSE) [](https://github.com/ktmeaton/NCBImeta/issues) [](https://travis-ci.org/ktmeaton/NCBImeta)

# NCBImeta Efficient and comprehensive metadata acquisition from the NCBI databases (includes SRA).

NCBImeta is a Python application that retrieves and organizes metadata from the National Centre for Biotechnology Information (NCBI). While the NCBI web browser experience allows filtered searches, the output does not facilitate inter-record comparison or bulk record retrieval. NCBImeta tackles this issue by creating a local database of NCBI metadata constructed by user-defined search criteria and customizable metadata columns. The output of NCBImeta, optionally a SQLite database or text files, can then be used by computational biologists for applications such as record filtering, project discovery, sample interpretation, or meta-analyses of published work.

## Installation From PyPI ` pip install ncbimeta NCBImeta.py --version `

## Installation From Source

` git clone https://github.com/ktmeaton/NCBImeta.git cd NCBImeta python setup.py install NCBImeta.py --version ` Or download the latest release as a zip/tar archive: [Version 0.4.2](https://github.com/ktmeaton/NCBImeta/releases/tag/v0.4.2) Proceed with Installation from Source instructions.

## Requirements NCBImeta is written in Python 3 and supported on Linux and macOS. Python 3 dependencies include BioPython, PyYAML, and NumPy which can be installed with: ` pip3 install --user -r requirements.txt ` [Check all Python versions and OS with verified build status](https://travis-ci.org/ktmeaton/NCBImeta)

## Quick Start Example

### Run the program Download genomic metadata pertaining to the plague pathogen Yersinia pestis. ` src/NCBImeta.py --flat --config example/config.yaml `

Example output of the command-line interface (v0.4.0): <img src=”images/NCBImetaCLI.gif” alt=”NCBImetaCLI” width=”700px”/>

### Annotate the database with tab-separated text files of metadata ` src/NCBImetaAnnotateReplace.py --database example/yersinia_pestis_db.sqlite --annotfile example/annot.txt --table BioSample `

Note that the first column of your annotation file MUST be a column that is unique to each record. An Accession number or ID is highly recommended. The column headers in your annotation file must also exactly match the names of your columns in the database.

`NCBImetaAnnotateReplace.py`, as the name implies, replaces the existing annotation with the data in your custom metadata file. Alternatively, the script `NCBImetaAnnotateConcatenate.py` will concatenate your custom metadata with the pre-existing value in the database cell (separated by a semi-colon). ` src/NCBImetaAnnotateConcatenate.py --database example/yersinia_pestis_db.sqlite --annotfile example/annot.txt --table BioSample ` ### Join NCBI tables into a unified master table ` src/NCBImetaJoin.py --database example/yersinia_pestis_db.sqlite --final Master --anchor BioSample --accessory "BioProject Assembly SRA Nucleotide" --unique "BioSampleAccession BioSampleAccessionSecondary BioSampleBioProjectAccession" ` The rows of the output “Master” table will be from the anchor table “BioSample”, with additional columns added in from the accessory tables “BioProject”, “Assembly”, “SRA”, and “Nucleotide”. Unique accession numbers for BioSample (both primary and secondary) and BioProject allow this join to be unambiguous.

### Export the database to tab-separated text files by table. ` src/NCBImetaExport.py --database example/yersinia_pestis_db.sqlite --outputdir example/ ` Each table within the database will be exported to its own tab-separated .txt file in the specified output directory.

### Explore! 1. Explore your database text files using a spreadsheet viewer (Microsoft Excel, Google Sheets, etc.) 2. Browse your SQLite database using DB Browser for SQLite (https://sqlitebrowser.org/) 3. Use the columns with FTP links to download your data files of interest.

Example database output (a subset of the Assembly table) <img src=”images/NCBImetaDBsmall.gif” alt=”NCBImetaDB” width=”700px”/>

## Currently Supported NCBI Tables Assembly BioProject BioSample Nucleotide SRA Pubmed

## Documentation To get started with customizing the search terms, database, and metadata fields, please read: 1. [Config File README](config/README_config.md) 2. [Schema File README](schema/README_schema.md)

## Issues, Questions, and Suggestions

Please submit your questions, suggestions, and bug reports to the [Issue Tracker](https://github.com/ktmeaton/NCBImeta/issues)

## Contributing

1. Fork it!

2. Create your feature branch: git checkout -b my-new-feature

3. Commit your changes: git commit -am ‘Add some feature’

4. Push to the branch: git push origin my-new-feature

5. Submit a pull request!

## Credits

Author: [Katherine Eaton](https://github.com/ktmeaton) ([e-mail])

[](https://www.python.org/)