tiledbsoma.io.ExperimentAmbientLabelMapping.prepare_experiment

ExperimentAmbientLabelMapping.prepare_experiment(experiment_uri: str, context: SOMATileDBContext | None = None) → None

Prepare experiment for ingestion.

Currently performs two operations: 1. Resize experiment to a shape sufficient to contain all registered AnnData/H5AD inputs 2. Evolve schema on all dict/enum/categorical columns to include any new values defined in registered AnnData (e.g., Pandas Categoricals with additional categories).

This makes subsequent data writes race safe, for workflows using concurrent dataset writers (ie., parallel calls to to_anndata or from_h5ad).

This operation must be performed after the experiment is created, and before any writes to the experiment.

Parameters:

• experiment_uri – the Experiment to prepare for ingestion.

• context – a SOMA context

Returns:

None