lamindb.curators.AnnDataCurator

class lamindb.curators.AnnDataCurator(dataset, schema)

Bases: SlotsCurator

Curator for AnnData.

Parameters:

  • dataset (AnnData | Artifact) – The AnnData-like object to validate & annotate.

  • schema (Schema) – A Schema object that defines the validation constraints.

Example

curate_anndata_flexible.py
import lamindb as ln

ln.core.datasets.mini_immuno.define_features_labels()
adata = ln.core.datasets.mini_immuno.get_dataset1(otype="AnnData")
schema = ln.examples.schemas.anndata_ensembl_gene_ids_and_valid_features_in_obs()
artifact = ln.Artifact.from_anndata(
    adata, key="examples/mini_immuno.h5ad", schema=schema
).save()
artifact.describe()

See also

from_anndata().

Attributes

property slots: dict[str, DataFrameCurator]

Access sub curators by slot.

Methods

save_artifact(*, key=None, description=None, revises=None, run=None)

Save an annotated artifact.

Parameters:

  • key (str | None, default: None) – A path-like key to reference artifact in default storage, e.g., "myfolder/myfile.fcs". Artifacts with the same key form a version family.

  • description (str | None, default: None) – A description.

  • revises (Artifact | None, default: None) – Previous version of the artifact. Is an alternative way to passing key to trigger a new version.

  • run (Run | None, default: None) – The run that creates the artifact.

Return type:

Artifact

Returns:

A saved artifact record.

validate()

Validate dataset against Schema.

Raises:

lamindb.errors.ValidationError – If validation fails.

Return type:

None