Skip to main content

genoio

genoio reads VCF/BCF, PLINK1, PLINK2, and BGEN genotype sources into Python matrices. The public API is Python; the file readers are Rust. This pairing keeps the interface simple while moving parsing and matrix construction into compiled, efficient code.

It is built for downstream genetics tools that need stable matrix contracts: samples on rows, variants on columns, and metadata aligned to returned matrices, blocks, or regions.

Install

To install the most recent release:

pip install genoio

Or the latest:

pip install git+https://github.com/mancusolab/genoio.git

Documentation

For complete documentation and examples, see the documentation site.

Quick Example

import genoio

ds = genoio.pfile("data/chr22_hg38")
samples = ds.samples()
y = load_phenotype_vector(samples["iid"])
C = load_covariates(samples["iid"])

with ds.iter_blocks(10_000, return_variants=True) as blocks:
    for X, variants in blocks:
        # X has shape (samples, variants_in_this_block).
        # `y` and `C` must be aligned to the rows described by `samples`.
        association_scan(X, y, C, variants=variants)

Use read(...) for one matrix, iter_blocks(...) for streaming scans, and iter_regions(...) for interval-based workflows.

License

MIT. See LICENSE.


Notes

genoio was developed by members of the Mancuso Lab with assistance from Codex, following the practices described in the scientific-software-playbook and coding-skills repositories.

Download files

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

Source Distribution

genoio-0.4.1.tar.gz (264.6 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

genoio-0.4.1-cp314-cp314-manylinux_2_28_x86_64.whl (5.2 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.28+ x86-64

genoio-0.4.1-cp314-cp314-macosx_11_0_arm64.whl (4.3 MB view details)

Uploaded CPython 3.14macOS 11.0+ ARM64

genoio-0.4.1-cp313-cp313-manylinux_2_28_x86_64.whl (5.2 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.28+ x86-64

genoio-0.4.1-cp313-cp313-macosx_11_0_arm64.whl (4.3 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

genoio-0.4.1-cp312-cp312-manylinux_2_28_x86_64.whl (5.2 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.28+ x86-64

genoio-0.4.1-cp312-cp312-macosx_11_0_arm64.whl (4.3 MB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

genoio-0.4.1-cp311-cp311-manylinux_2_28_x86_64.whl (5.2 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.28+ x86-64

genoio-0.4.1-cp311-cp311-macosx_11_0_arm64.whl (4.3 MB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

File details

Details for the file genoio-0.4.1.tar.gz.

File metadata

  • Download URL: genoio-0.4.1.tar.gz
  • Upload date:
  • Size: 264.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for genoio-0.4.1.tar.gz
Algorithm Hash digest
SHA256 1e24e9be3dab475db519b5fdf873cfa54fb2755e52b30f71d67c666646714f1d
MD5 ca5563159c518224a43b48094c5a9328
BLAKE2b-256 e5bd97c5246411c9511c9a56db30b0d46357c516e00b55fed0256145116a80a0

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.4.1.tar.gz:

Publisher: release.yml on mancusolab/genoio

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file genoio-0.4.1-cp314-cp314-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for genoio-0.4.1-cp314-cp314-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 7bd593b155aff3c5a301dff2d73d4af0fc77a2238bb1c77af4024f823b587cb8
MD5 dd97c342596e3587ce958b21536c99b3
BLAKE2b-256 260f6a901e8b99447a98c8a31071b579c864a6592a75db2976d7ef06641d45d4

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.4.1-cp314-cp314-manylinux_2_28_x86_64.whl:

Publisher: release.yml on mancusolab/genoio

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file genoio-0.4.1-cp314-cp314-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for genoio-0.4.1-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 2e1a15fc55df0216ff137416cec0e99bbf0f403ced4555e3e1f6d826e579ab8e
MD5 fd5c1f2064ffbbcce6d91125bd514faf
BLAKE2b-256 e4aa81efcd77a7711a3e70385c81f53960542110f1e6cf1779b9eadc8226b874

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.4.1-cp314-cp314-macosx_11_0_arm64.whl:

Publisher: release.yml on mancusolab/genoio

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file genoio-0.4.1-cp313-cp313-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for genoio-0.4.1-cp313-cp313-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 2e2178beb53d49df9d0ad53fc736fc00c5be1e3af0d28afe1900f0c0d183be75
MD5 cc72ac135fa4c130bd5db703c2cc4fe0
BLAKE2b-256 8b948c3eed57c308761f5b8fd0e74c1983c76b17f3cd9bd32591fad07967f690

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.4.1-cp313-cp313-manylinux_2_28_x86_64.whl:

Publisher: release.yml on mancusolab/genoio

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file genoio-0.4.1-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for genoio-0.4.1-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 e3e173ab13f4de299e6d27ec19e88fff6fde28f49f31476f5df221190c63391b
MD5 5fa1908cdb79bb3e84643528f63977ac
BLAKE2b-256 bc94811ce96eaddaaf331a0e3fc3732854c0d5cbf573405f364a13e2ff2c679c

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.4.1-cp313-cp313-macosx_11_0_arm64.whl:

Publisher: release.yml on mancusolab/genoio

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file genoio-0.4.1-cp312-cp312-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for genoio-0.4.1-cp312-cp312-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 c868cdf6c725d507e21b92a59c9757a6083d5140476132353d62d6198d8a0aba
MD5 cd74577ac01cf3969c389e231782119d
BLAKE2b-256 e368831bc61aa336ed79c3ac0d48f8893a3f2064dff3377726727867e65d283d

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.4.1-cp312-cp312-manylinux_2_28_x86_64.whl:

Publisher: release.yml on mancusolab/genoio

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file genoio-0.4.1-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for genoio-0.4.1-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 4f81f0157ea17eda1a4c06743e5ff3c296eacc54c071f49c4262cce5dc06187f
MD5 d7bc760e3eb9d8bd9af80e6112dfcc19
BLAKE2b-256 3b02653d387d7c14b4d4fcfab2b4f7b8b12973ae59649779689b96c0d105b017

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.4.1-cp312-cp312-macosx_11_0_arm64.whl:

Publisher: release.yml on mancusolab/genoio

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file genoio-0.4.1-cp311-cp311-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for genoio-0.4.1-cp311-cp311-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 284fede0075a479999b9bd737779067cf56daed3e899015d3bb817127663f96a
MD5 492ee042c5fa57076fd7e75bedc2cbe0
BLAKE2b-256 d4d1fbaa2881eeb88676c54115fefcb9d9b9b226ce083a7ff16e3d440d232e3c

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.4.1-cp311-cp311-manylinux_2_28_x86_64.whl:

Publisher: release.yml on mancusolab/genoio

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file genoio-0.4.1-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for genoio-0.4.1-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 22c1289d6a1b2634814719263f1af61baa235f341ad930336ed39337046cbbe5
MD5 3461b05e473e030aecd0532547153b07
BLAKE2b-256 9b29ba9f943b24f756b1f2810fa80cc5b4712e3d5039d20697fbf03f2e61d8fd

See more details on using hashes here.

Provenance

The following attestation bundles were made for genoio-0.4.1-cp311-cp311-macosx_11_0_arm64.whl:

Publisher: release.yml on mancusolab/genoio

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.4.1 This release

9 files

0.4.0

9 files

0.3.0

9 files

0.2.0

9 files

0.1.0

9 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page