Analyze the collection and save a result

import lamindb as ln
import bionty as bt

ln.track("zzJzdgJ763Dy0000")

→ connected lamindb: testuser1/test-facs

→ created Transform('zzJzdgJ763Dy0000'), started new Run('ScOiMPWc...') at 2025-09-14 14:12:07 UTC

→ notebook imports: bionty==1.7.0 lamindb==1.11.0 scanpy==1.11.4

ln.Collection.to_dataframe()

Show code cell output Hide code cell output

	uid	key	description	hash	reference	reference_type	space_id	meta_artifact_id	version	is_latest	run_id	created_at	created_by_id	_aux	branch_id
id
2	chzDu7nkSFwzSQJc0001	My versioned cytometry collection	None	eNSQbRNsjg278G1RwXmqCw	None	None	1	None	2	True	2	2025-09-14 14:11:59.899000+00:00	1	None	1
1	chzDu7nkSFwzSQJc0000	My versioned cytometry collection	None	jZ8YvUdZGRwPgfoBQbOg_Q	None	None	1	None	1	False	1	2025-09-14 14:11:49.794000+00:00	1	None	1

collection = ln.Collection.get(key="My versioned cytometry collection", version="2")

adata = collection.load(join="inner")

Show code cell output Hide code cell output

/opt/hostedtoolcache/Python/3.12.11/x64/lib/python3.12/site-packages/anndata/_core/anndata.py:1774: UserWarning: Observation names are not unique. To make them unique, call `.obs_names_make_unique`.
  utils.warn_names_duplicates("obs")

The AnnData has the reference to the individual files in the .obs annotations:

adata.obs.artifact_uid.cat.categories

Show code cell output Hide code cell output

Index(['BxeIn6mNwRk8xFAR0000', '9gCQS0UIEtNSTe7s0000'], dtype='object')

By default, the intersection of features is used:

adata.var.index

Show code cell output Hide code cell output

Index(['CD8', 'CD27', 'Ccr7', 'Cd4', 'CD45RA', 'CD3'], dtype='object')

Let us create a plot:

markers = bt.CellMarker.lookup()

import scanpy as sc

sc.pp.pca(adata)
sc.pl.pca(adata, color=markers.cd8.name, save="_cd8")

Show code cell output Hide code cell output

WARNING: saving figure to file figures/pca_cd8.pdf

artifact = ln.Artifact("./figures/pca_cd8.pdf", description="My result on CD8").save()
artifact.view_lineage()

Given the image is part of the notebook, there isn’t an actual need to save it and you can also rely on the report that you’ll create when saving the notebook:

ln.finish()

# clean up test instance
!rm -r test-flow
!lamin delete --force test-facs

Show code cell output Hide code cell output

rm: cannot remove 'test-flow': No such file or directory

╭─ Error ──────────────────────────────────────────────────────────────────────╮
│ '/home/runner/work/lamin-usecases/lamin-usecases/docs/test-facs/.lamindb'    │
│ contains 3 objects - delete them prior to deleting the storage location      │
╰──────────────────────────────────────────────────────────────────────────────╯