Unit tests

SummarizedExperiment

This package provides containers to represent genomic experimental data as 2-dimensional matrices, follows Bioconductor's SummarizedExperiment. In these matrices, the rows typically denote features or genomic regions of interest, while columns represent samples or cells.

The package currently includes representations for both SummarizedExperiment and RangedSummarizedExperiment. A distinction lies in the fact RangedSummarizedExperiment object provides an additional slot to store genomic regions for each feature and is expected to be GenomicRanges (more here).

Install

To get started, Install the package from PyPI,

pip install summarizedexperiment

Usage

A SummarizedExperiment contains three key attributes,

assays: A dictionary of matrices with assay names as keys, e.g. counts, logcounts etc.
row_data: Feature information e.g. genes, transcripts, exons, etc.
column_data: Sample information about the columns of the matrices.

First lets mock feature and sample data:

from random import random
import pandas as pd
import numpy as np
from biocframe import BiocFrame

nrows = 200
ncols = 6
counts = np.random.rand(nrows, ncols)
row_data = BiocFrame(
    {
        "seqnames": [
            "chr1",
            "chr2",
            "chr2",
            "chr2",
            "chr1",
            "chr1",
            "chr3",
            "chr3",
            "chr3",
            "chr3",
        ]
        * 20,
        "starts": range(100, 300),
        "ends": range(110, 310),
        "strand": ["-", "+", "+", "*", "*", "+", "+", "+", "-", "-"] * 20,
        "score": range(0, 200),
        "GC": [random() for _ in range(10)] * 20,
    }
)

col_data = pd.DataFrame(
    {
        "treatment": ["ChIP", "Input"] * 3,
    }
)

To create a SummarizedExperiment,

from summarizedexperiment import SummarizedExperiment

tse = SummarizedExperiment(
    assays={"counts": counts}, row_data=row_data, column_data=col_data,
    metadata={"seq_platform": "Illumina NovaSeq 6000"},
)

## output
class: SummarizedExperiment
dimensions: (200, 6)
assays(1): ['counts']
row_data columns(6): ['seqnames', 'starts', 'ends', 'strand', 'score', 'GC']
row_names(0):
column_data columns(1): ['treatment']
column_names(0):
metadata(1): seq_platform

To create a RangedSummarizedExperiment

from summarizedexperiment import RangedSummarizedExperiment
from genomicranges import GenomicRanges

trse = RangedSummarizedExperiment(
    assays={"counts": counts}, row_data=row_data,
    row_ranges=GenomicRanges.from_pandas(row_data.to_pandas()), column_data=col_data
)

## output
class: RangedSummarizedExperiment
dimensions: (200, 6)
assays(1): ['counts']
row_data columns(6): ['seqnames', 'starts', 'ends', 'strand', 'score', 'GC']
row_names(0):
column_data columns(1): ['treatment']
column_names(0):
metadata(0):

For more examples, checkout the documentation.

Note

This project has been set up using PyScaffold 4.5. For details and usage information on PyScaffold see https://pyscaffold.org/.

Release files for summarizedexperiment 0.8.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 summarizedexperiment 0.8.0
File	Size	Uploaded
summarizedexperiment-0.8.0.tar.gz	1.0 MB	Sep 15, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for summarizedexperiment 0.8.0
File	Interpreter	ABI	Platform	Reset
summarizedexperiment-0.8.0-py3-none-any.whl 24.3 kB Sep 15, 2026	Python 3	none	any	Details

Total release size: 1.0 MB

Release files / summarizedexperiment-0.8.0.tar.gz

Download URL	summarizedexperiment-0.8.0.tar.gz
Size	1.0 MB
Tags	Source
SHA-256 checksum How to use checksums	`0440701e5ffcdf89a0b6051222b2e03900bc1d43263b748a0e5751e66f098d49`
BLAKE2b-256 checksum How to use checksums	`f99201f450a3fc7c07a8a1717dfe5481d9c0c16424350b518b6f0ad72d330057`
Upload date	Sep 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/BiocPy/summarizedexperiment
Publishing commit: github.com/BiocPy/summarizedexperiment/tree/d0a26d80612102107b1b76c6ee9ab34ef526affb

Workflow

Publishing configuration: github.com/BiocPy/summarizedexperiment/blob/d0a26d80612102107b1b76c6ee9ab34ef526affb/.github/workflows/publish-pypi.yml
Publishing logs: github.com/BiocPy/summarizedexperiment/actions/runs/34936987179/attempts/1

Artifact

Subject: summarizedexperiment-0.8.0.tar.gz
SHA-256 checksum: 0440701e5ffcdf89a0b6051222b2e03900bc1d43263b748a0e5751e66f098d49 Verifying attestations

Release files / summarizedexperiment-0.8.0-py3-none-any.whl

Download URL	summarizedexperiment-0.8.0-py3-none-any.whl
Size	24.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`50ce2fae12ac778f2678e2ce88182dbf3830cbcbec98720719e8c07c8e85be45`
BLAKE2b-256 checksum How to use checksums	`b37e7874bb3ac84b9299cc9f2346b44685ff22d9f2b456a5c7df984fa621f003`
Upload date	Sep 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/BiocPy/summarizedexperiment
Publishing commit: github.com/BiocPy/summarizedexperiment/tree/d0a26d80612102107b1b76c6ee9ab34ef526affb

Workflow

Publishing configuration: github.com/BiocPy/summarizedexperiment/blob/d0a26d80612102107b1b76c6ee9ab34ef526affb/.github/workflows/publish-pypi.yml
Publishing logs: github.com/BiocPy/summarizedexperiment/actions/runs/34936987179/attempts/1

Artifact

Subject: summarizedexperiment-0.8.0-py3-none-any.whl
SHA-256 checksum: 50ce2fae12ac778f2678e2ce88182dbf3830cbcbec98720719e8c07c8e85be45 Verifying attestations