Data

Tools

Indexes

Applications

Experiments

Open Source Science

https://github.com/bigdatabiology/spirepy

https://github.com/bigdatabiology/spirepy

Science Score: 39.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ○
    CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ✓
    DOI references
    Found 2 DOI reference(s) in README
  • ○
    Academic publication links
  • ○
    Academic email domains
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (13.0%) to scientific vocabulary
Last synced: 10 months ago · JSON representation

Repository

Basic Info
  • Host: GitHub
  • Owner: BigDataBiology
  • License: mit
  • Language: Python
  • Default Branch: main
  • Size: 92.8 KB
Statistics
  • Stars: 0
  • Watchers: 1
  • Forks: 2
  • Open Issues: 1
  • Releases: 0
Created about 1 year ago · Last pushed 12 months ago
Metadata Files
Readme License

README.md

PyPI Install Test Status Documentation Status License: MIT

SPIREpy

SPIREpy is a Python package and command-line tool that allows users to interact with the SPIRE database in a more convinient way.

Installation

SPIREpy is available on PyPI and can be installed via

{bash} pip install spirepy

Quickstart

Python package

The Python package encapsulates the study and samples types from SPIRE into classes with properties that allow you to access and interact with their data. To load a study, we do:

```{python} from spirepy import Study

study = Study("Lloyd-Price2019HMP2IBD") ```

We can then obtain the list of samples that belong to this study.

{python} study.get_samples()

The study's metadata:

{python} study.get_metadata()

Or even the assembled genomes:

{python} study.get_mags()

Likewise, many of these attributes and operations are parallel to samples (Sample class) as well. For the full documentation and how to interact with them, see here

Command-line tool

The command-line interface tool allows the interaction with data from SPIRE directly in the terminal. It possesses 2 main interfaces:

  • view
  • download

These 2 sub-commands allows us to print tables and download data from both studies and samples. For more information on the available commands use:

{bash} spire --help

To view a study's metadata we can use:

{bash} spire --study view metadata Lloyd-Price_2019_HMP2IBD

And to download the same table as a .csv file we can instead:

{bash} spire --study download metadata Lloyd-Price_2019_HMP2IBD -o study/

Documentation

Documentation for the Python package and CLI tool can be found here.

Credits

These tools have been developed by the Big Data Biology Lab at the Centre for Microbiome Research at the Queensland University of Technology (Brisbane, Australia). It is part of the SPIRE: a Searchable, Planetary-scale mIcrobiome REsource project.

SPIRE is published in

{} Thomas S B Schmidt, Anthony Fullam, Pamela Ferretti, Askarbek Orakov, Oleksandr M Maistrenko, Hans-Joachim Ruscheweyh, Ivica Letunic, Yiqian Duan, Thea Van Rossum, Shinichi Sunagawa, Daniel R Mende, Robert D Finn, Michael Kuhn, Luis Pedro Coelho, Peer Bork, SPIRE: a Searchable, Planetary-scale mIcrobiome REsource, Nucleic Acids Research, Volume 52, Issue D1, 5 January 2024, Pages D777–D783 https://doi.org/10.1093/nar/gkad943

Please cite this publication when referencing SPIREpy.

Owner

  • Name: Big Data Biology Lab
  • Login: BigDataBiology
  • Kind: organization
  • Email: luis@luispedro.org

GitHub Events

Total
  • Issues event: 1
  • Push event: 24
  • Pull request event: 30
  • Fork event: 1
Last Year
  • Issues event: 1
  • Push event: 24
  • Pull request event: 30
  • Fork event: 1

Dependencies

pyproject.toml pypi
requirements.txt pypi