PyNCBI

Simple API for Python Integration with NCBI .
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

• About the Project
• Usage
• Roadmap
• Contributing
• License
• Contact

About The Project

Here's Why PyNCBI 🧬 :

When working with methylation data, NCBI might be one of the most extensive open source databases that provide the methylation data and the information around it. When working with NCBI on a day-to-day basis, searching, querying, and extracting information may prove to be a time-consuming and headache-producing challenge. PyNCBI strives to answer all needs a researcher might need when communicating with NCBI using a straightforward python API that allows to quickly test, extract, analyze and download relevant data.

Installation

pip install PyNCBI

Usage

GSE Wise Info Retrival

from PyNCBI import GEOReader
# Create Reader Instance
reader= GEOReader()
# Extact all GSM info associated to GSE99624 (Saved csv will appear in your downloads folder)
reader.extract_gse_sample_info('GSE99624')

GSE Wise Data Retrival

from PyNCBI import GEOReader
# Create Reader Instance
reader= GEOReader()
# Extact all GSM methylation data associated to GSE142512 (Saved files will appear in your downloads folder per GSM depending on page data status)
reader.download_gse_data('GSE142512')

Single GSM Data Retrival

from PyNCBI import GEOReader
# Create Reader Instance
reader= GEOReader()
# Extact GSM methylation data associated to GSE142512 (Saved file will appear in your downloads folder per GSM depending on page data status)
reader.download_gsm_data('GSM1518180')

Parsing IDAT files

from PyNCBI import parse_idat_files

# Beta Values will be stored in a parquet file in path
parse_idat_files("Path_To_IDAT_FILES/", 'array_type')

Single GSM API

The GSM API extract all info from a GSM card as well as download the methylation data and render the beta values ready for work

from PyNCBI import GSM

# Build and populate with data an instance of a GSM container
example_gsm = GSM('GSM1518180')
print(example_gsm)

Output:

GSM: GSM1518180 | GSE: GSE62003
tissue:  Whole blood
Sex:  Male
age:  77

Currently Supported Data Features

• GSE Wise Card Information Extraction
• GSM Card Information Extraction
• GSE Wise Methylation Data Extraction
• GSM Card Methylation Data Extraction
• IDAT File Parsing Management Based on methylprep
• Single GSM API

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open-source community such a powerful place to create new ideas, inspire, and make progress. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT license. See LICENSE for more information.

Contact

Thomas Konstantinovsky - [email protected]

Project Link: https://github.com/MuteJester/PyNCBI