Skip to main content

Oyster

Oyster is a glass-box neural network for genomic sequence-to-function modeling. It learns the effects of k-mer composition and position while intentionally excluding k-mer associations (interactions among k-mers). The position-specific k-mer contributions can be read directly from the learned model weights.

See the paper: Oyster: A Neural Network for Modeling Genomic Sequences with Exact Position-Specific k-mer Contributions. The paper compares Oyster with models that learn k-mer associations. Those models can achieve better predictive performance, while Oyster predictions remain in strong agreement and can serve as interpretable proxies.

Installation

Requires Python 3.12 or newer. Install from PyPI with:

python -m pip install poseigen_oyster

Package

  • model provides Oyster and Dual_Oyster. Dual_Oyster combines two Oyster models, allowing each branch to use different inputs, k-mer sizes, position-pooling settings, and chunking.
  • analysis provides tools for inspecting Oyster models, including sequence and k-mer contributions, PWM-derived contributions, clustering, and cluster refinement.
  • Oyster_BaseDict and Dual_Oyster_BaseDict define hyperparameter search spaces for Oyster and Dual_Oyster to use with poseigen_compass.
  • Oyster is built using poseigen_trident.

Case studies

Oyster has been exemplified in the following case studies:

Metadata

Release files for poseigen-oyster 2.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for poseigen-oyster 2.0.0
File Size Uploaded Provenance Actions
poseigen_oyster-2.0.0.tar.gz 15.9 kB With provenance Details for poseigen_oyster-2.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for poseigen-oyster 2.0.0
File Interpreter ABI Platform Actions
poseigen_oyster-2.0.0-py3-none-any.whl Python 3 none any Details for poseigen_oyster-2.0.0-py3-none-any.whl

Total release size: 31.2 kB

Release files / poseigen_oyster-2.0.0.tar.gz

Download URL poseigen_oyster-2.0.0.tar.gz
Size 15.9 kB
Tags Source
SHA-256 checksum
How to use checksums
e54bfc20b21316f28320a9df86efe224321f5bccdaca14432b720d79d5b5cd56
BLAKE2b-256 checksum
How to use checksums
e190565481cebb5fc9de58b98f5aff51539d0205ec915f291ad0a8126239679e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.

Transparency log

Release files / poseigen_oyster-2.0.0-py3-none-any.whl

Download URL poseigen_oyster-2.0.0-py3-none-any.whl
Size 15.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
25164f93bb40facd4364946511f80207c71082a01d9d186bfb416f7f89b085b6
BLAKE2b-256 checksum
How to use checksums
cb3b03ef7211ca481e0610a2760b521e2f4419f7a2f0c6450b03eee51d6b4f2f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.

Transparency log

Security for poseigen-oyster 2.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for poseigen_oyster-2.0.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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