Query individual files

Here, we’ll query individual files and inspect their metadata.

This guide can be skipped if you are only interested in how to leverage the overall dataset.

import lamindb as ln
import lnschema_bionty as lb
import anndata as ad

💡 lamindb instance: testuser1/test-scrna

ln.track()

💡 notebook imports: anndata==0.9.2 lamindb==0.61.0 lnschema_bionty==0.35.0

💡 saved: Transform(uid='agayZTonayqAz8', name='Query individual files', short_name='scrna3', version='0', type=notebook, updated_at=2023-11-15 15:54:40 UTC, created_by_id=1)

💡 saved: Run(uid='3sRcNCRY5H4ynejhdHjD', run_at=2023-11-15 15:54:40 UTC, transform_id=3, created_by_id=1)

Query files by provenance metadata

users = ln.User.lookup()

ln.Transform.filter(created_by=users.testuser1).search("scrna")

	uid	score
name
scRNA-seq	Nv48yAceNSh8z8	90.0
Append a new batch of data	ManDYgmftZ8Cz8	36.0
Query individual files	agayZTonayqAz8	36.0

transform = ln.Transform.filter(uid="Nv48yAceNSh8z8").one()

ln.File.filter(transform=transform).df()

	uid	storage_id	key	suffix	accessor	description	version	size	hash	hash_type	transform_id	run_id	initial_version_id	visibility	key_is_virtual	updated_at	created_by_id
id
1	AD4Jf0OScrLIRUaagLca	1	scrna/conde22.h5ad	.h5ad	AnnData	Human immune cells from Conde22	None	57612943	9sXda5E7BYiVoDOQkTC0KB	sha1-fl	1	1	None	0	True	2023-11-15 15:54:03.287284+00:00	1

Query files by biological metadata

assays = lb.ExperimentalFactor.lookup()
organism = lb.Organism.lookup()
cell_types = lb.CellType.lookup()

query = ln.File.filter(
    experimental_factors=assays.single_cell_rna_sequencing,
    organism=organism.human,
    cell_types=cell_types.gamma_delta_t_cell,
)

query.df()

	uid	storage_id	key	suffix	accessor	description	version	size	hash	hash_type	transform_id	run_id	initial_version_id	visibility	key_is_virtual	updated_at	created_by_id
id
1	AD4Jf0OScrLIRUaagLca	1	scrna/conde22.h5ad	.h5ad	AnnData	Human immune cells from Conde22	None	57612943	9sXda5E7BYiVoDOQkTC0KB	sha1-fl	1	1	None	0	True	2023-11-15 15:54:03.287284+00:00	1

Inspect file metadata

query_set = ln.File.filter().all()

file1, file2 = query_set[0], query_set[1]

file1.describe()

File(uid='AD4Jf0OScrLIRUaagLca', key='scrna/conde22.h5ad', suffix='.h5ad', accessor='AnnData', description='Human immune cells from Conde22', size=57612943, hash='9sXda5E7BYiVoDOQkTC0KB', hash_type='sha1-fl', visibility=0, key_is_virtual=True, updated_at=2023-11-15 15:54:03 UTC)

Provenance:
  🗃️ storage: Storage(uid='tepC1cqV', root='/home/runner/work/lamin-usecases/lamin-usecases/docs/test-scrna', type='local', updated_at=2023-11-15 15:53:42 UTC, created_by_id=1)
  📔 transform: Transform(uid='Nv48yAceNSh8z8', name='scRNA-seq', short_name='scrna', version='0', type='notebook', updated_at=2023-11-15 15:53:46 UTC, created_by_id=1)
  👣 run: Run(uid='wJ8UkcwgTLhNtYhwyqUq', run_at=2023-11-15 15:53:46 UTC, transform_id=1, created_by_id=1)
  👤 created_by: User(uid='DzTjkKse', handle='testuser1', name='Test User1', updated_at=2023-11-15 15:53:42 UTC)
  ⬇️ input_of (core.Run): ['2023-11-15 15:54:09 UTC']
Features:
  var: FeatureSet(uid='enycx8fsVuyvZmkq1niN', n=36390, type='number', registry='bionty.Gene', hash='rMZltwoBCMdVPVR8x6nJ', updated_at=2023-11-15 15:54:00 UTC, created_by_id=1)
    'MIR1302-2HG', 'FAM138A', 'OR4F5', 'None', 'None', 'None', 'None', 'None', 'None', 'None', 'OR4F29', 'None', 'OR4F16', 'None', 'LINC01409', 'FAM87B', 'LINC01128', 'LINC00115', 'FAM41C', 'None', ...
  obs: FeatureSet(uid='j0zgP6S31bbxpJ5xHYLG', n=4, registry='core.Feature', hash='Hnai46W4iYuYNMPk5Kq4', updated_at=2023-11-15 15:54:01 UTC, created_by_id=1)
    🔗 cell_type (32, bionty.CellType): 'classical monocyte', 'T follicular helper cell', 'memory B cell', 'alveolar macrophage', 'naive thymus-derived CD4-positive, alpha-beta T cell', 'effector memory CD8-positive, alpha-beta T cell, terminally differentiated', 'alpha-beta T cell', 'CD4-positive helper T cell', 'naive thymus-derived CD8-positive, alpha-beta T cell', 'macrophage', ...
    🔗 assay (4, bionty.ExperimentalFactor): 'single-cell RNA sequencing', '10x 3' v3', '10x 5' v2', '10x 5' v1'
    🔗 tissue (17, bionty.Tissue): 'blood', 'thoracic lymph node', 'spleen', 'lung', 'mesenteric lymph node', 'lamina propria', 'liver', 'jejunal epithelium', 'omentum', 'bone marrow', ...
    🔗 donor (12, core.ULabel): 'D496', '621B', 'A29', 'A36', 'A35', '637C', 'A52', 'A37', 'D503', '640C', ...
Labels:
  🏷️ organism (1, bionty.Organism): 'human'
  🏷️ tissues (17, bionty.Tissue): 'blood', 'thoracic lymph node', 'spleen', 'lung', 'mesenteric lymph node', 'lamina propria', 'liver', 'jejunal epithelium', 'omentum', 'bone marrow', ...
  🏷️ cell_types (32, bionty.CellType): 'classical monocyte', 'T follicular helper cell', 'memory B cell', 'alveolar macrophage', 'naive thymus-derived CD4-positive, alpha-beta T cell', 'effector memory CD8-positive, alpha-beta T cell, terminally differentiated', 'alpha-beta T cell', 'CD4-positive helper T cell', 'naive thymus-derived CD8-positive, alpha-beta T cell', 'macrophage', ...
  🏷️ experimental_factors (4, bionty.ExperimentalFactor): 'single-cell RNA sequencing', '10x 3' v3', '10x 5' v2', '10x 5' v1'
  🏷️ ulabels (12, core.ULabel): 'D496', '621B', 'A29', 'A36', 'A35', '637C', 'A52', 'A37', 'D503', '640C', ...

file1.view_flow()

file2.describe()

File(uid='I7LLQqoPPNCbBFn9gkaf', suffix='.h5ad', accessor='AnnData', description='10x reference adata', size=857752, hash='CGXMK8_zCD-MIwR0jMEhNw', hash_type='md5', visibility=0, key_is_virtual=True, updated_at=2023-11-15 15:54:32 UTC)

Provenance:
  🗃️ storage: Storage(uid='tepC1cqV', root='/home/runner/work/lamin-usecases/lamin-usecases/docs/test-scrna', type='local', updated_at=2023-11-15 15:53:42 UTC, created_by_id=1)
  📔 transform: Transform(uid='ManDYgmftZ8Cz8', name='Append a new batch of data', short_name='scrna2', version='0', type='notebook', updated_at=2023-11-15 15:54:09 UTC, created_by_id=1)
  👣 run: Run(uid='c9Szmnx2uco6yNj2i01M', run_at=2023-11-15 15:54:09 UTC, transform_id=2, created_by_id=1)
  👤 created_by: User(uid='DzTjkKse', handle='testuser1', name='Test User1', updated_at=2023-11-15 15:53:42 UTC)
Features:
  var: FeatureSet(uid='v46rqffipF5TXojsJDh1', n=754, type='number', registry='bionty.Gene', hash='WMDxN7253SdzGwmznV5d', updated_at=2023-11-15 15:54:32 UTC, created_by_id=1)
    'IL18', 'NPM3', 'S100A9', 'S100A8', 'CNN2', 'ARHGAP45', 'RNF34', 'GPX4', 'S100A6', 'ADISSP', 'S100A4', 'FAM174C', 'SIT1', 'CCDC107', 'RSL1D1', 'TLN1', 'HES4', 'TNFRSF17', 'PCNA', 'RAB13', ...
  obs: FeatureSet(uid='uq3D6jvAZFKe9Fqh3WJF', n=1, registry='core.Feature', hash='TYp7KwVCMBulRPB_glDo', updated_at=2023-11-15 15:54:32 UTC, created_by_id=1)
    🔗 cell_type (9, bionty.CellType): 'dendritic cell', 'B cell, CD19-positive', 'effector memory CD4-positive, alpha-beta T cell, terminally differentiated', 'cytotoxic T cell', 'mature T cell', 'CD16-positive, CD56-dim natural killer cell, human', 'CD8-positive, CD25-positive, alpha-beta regulatory T cell', 'CD14-positive, CD16-negative classical monocyte', 'CD38-negative naive B cell'
  external: FeatureSet(uid='KDswq1HZN4o4RQtQf24V', n=2, registry='core.Feature', hash='DedKx95slTWHqqkFrvXQ', updated_at=2023-11-15 15:54:32 UTC, created_by_id=1)
    🔗 assay (1, bionty.ExperimentalFactor): 'single-cell RNA sequencing'
    🔗 organism (1, bionty.Organism): 'human'
Labels:
  🏷️ organism (1, bionty.Organism): 'human'
  🏷️ cell_types (9, bionty.CellType): 'dendritic cell', 'B cell, CD19-positive', 'effector memory CD4-positive, alpha-beta T cell, terminally differentiated', 'cytotoxic T cell', 'mature T cell', 'CD16-positive, CD56-dim natural killer cell, human', 'CD8-positive, CD25-positive, alpha-beta regulatory T cell', 'CD14-positive, CD16-negative classical monocyte', 'CD38-negative naive B cell'
  🏷️ experimental_factors (1, bionty.ExperimentalFactor): 'single-cell RNA sequencing'

file2.view_flow()

Compare features

Here we compute shared genes without loading files:

file1_genes = file1.features["var"]
file2_genes = file2.features["var"]

shared_genes = file1_genes & file2_genes
len(shared_genes)

749

shared_genes.list("symbol")[:10]

['HES4',
 'TNFRSF4',
 'SSU72',
 'PARK7',
 'RBP7',
 'SRM',
 'MAD2L2',
 'AGTRAP',
 'TNFRSF1B',
 'EFHD2']

Compare cell types

file1_celltypes = file1.cell_types.all()
file2_celltypes = file2.cell_types.all()

shared_celltypes = file1_celltypes & file2_celltypes
shared_celltypes_names = shared_celltypes.list("name")
shared_celltypes_names

['CD16-positive, CD56-dim natural killer cell, human']

Load the individual files

We could either load the files into memory or access them in backed mode through .backed() to lazily load their content from the cloud or the disk.display_markdown

Let’s load them into memory:

adata1 = file1.load()
adata2 = file2.load()

We can now subset the two datasets by shared cell types:

adata1_subset = adata1[adata1.obs["cell_type"].isin(shared_celltypes_names)]

adata2_subset = adata2[adata2.obs["cell_type"].isin(shared_celltypes_names)]