Skip to main content

Support package for Alevin tools. Updated and repackaged version of k3yavi/vpolo

Project description

fingerling

The output of salmon alevin is a binary sparse matrix. fingerling is a python module for reading that output into a pandas dataframe suitable for downstream analysis.

Code is derived from k3yavi/vpolo, updated to use maturin for Python/Rust integration.

Installation

Requirements:

fingerling requires Python 3.10 (or greater) as well as:

pandas
numpy
scipy

Additionally, since fingerling contains a submodule written in Rust, a working installation of Rust is required. See instructions for installing Rust here.

Install fingerling from this repository using:

pip install git+https://github.com/milescsmith/fingerling

If you wish to download the source and build it locally, you will also need maturin. Prior to installing the local files, you will need to run maturin build followed by pip install .target/wheels/fingerling-X.X.X-cp3XX-cp3XX-OS_VERSION_PLATFORM.whl, where X.X.X corresponds to the package version, cp3XX the python version, and OS_VERSION_PLATFORM your operating system and version. The actual name and location for the wheel should be given by maturin at the end of the build.

Basic Usage

Currently, fingerling is not setup to be used as a standalone executable, but instead used as part of an analysis pipeline in something like a Jupyter notebook. The read_quants_bin function returns a sample-by-feature dataframe with an index corresponding to the cell barcodes and column names corresponding to the feature names and is suitable for use in creating an AnnData object:

import scanpy as sc
from fingerling import read_quants_bin

cite_df = read_quants_bin("/PATH/TO/ALEVIN_OUTPUT")

adata = sc.Anndata(X=cite_df)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fingerling-1.0.0.tar.gz (43.3 kB view details)

Uploaded Source

Built Distribution

fingerling-1.0.0-cp311-cp311-manylinux_2_34_x86_64.whl (295.2 kB view details)

Uploaded CPython 3.11 manylinux: glibc 2.34+ x86-64

File details

Details for the file fingerling-1.0.0.tar.gz.

File metadata

  • Download URL: fingerling-1.0.0.tar.gz
  • Upload date:
  • Size: 43.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: maturin/1.7.0

File hashes

Hashes for fingerling-1.0.0.tar.gz
Algorithm Hash digest
SHA256 4d78539ae059a9d0a87d7b6587f54c5d186a0d5dbd7d866fc5a9786807853796
MD5 1b76fb2390f0dca5476938429515ef39
BLAKE2b-256 c12c4bbae050ed5e23661b100e337ab83ef442affa1932972a8c94b4b2f66bf6

See more details on using hashes here.

File details

Details for the file fingerling-1.0.0-cp311-cp311-manylinux_2_34_x86_64.whl.

File metadata

File hashes

Hashes for fingerling-1.0.0-cp311-cp311-manylinux_2_34_x86_64.whl
Algorithm Hash digest
SHA256 16ccd5e13ed7a17e0f2c63f371437f34259ef2c19ef1c7eb4875e753e445c284
MD5 06b1cc00e80d7fe6f46e8173d8a5ebcc
BLAKE2b-256 40616b0c120a3da3f8902cb3d1ab3f13a62abc81f16effcc1ce00d8e998de4d0

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page