#!/usr/bin/env python # coding: utf-8 # # Myeloid cell clustering and markers # # In this notebook, we use marker gene detection to select clusters that contain Myeloid cells, then subset our dataset and perform a round of iterative clustering at multiple resolutions. At each resolution we identify marker genes, then generate plots that we can use to assess cell type identity. # # The outputs of this analysis are used by our domain experts to assign cell type identities to our reference. # ## Load packages # In[1]: import warnings warnings.simplefilter(action='ignore', category=FutureWarning) import concurrent.futures from concurrent.futures import ProcessPoolExecutor import copy from datetime import date import hisepy import os import pandas as pd import re import scanpy as sc import scanpy.external as sce # ## Helper functions # # These functions will help with subsetting and performing leiden clustering at multiple resolutions in parallel. # # `select_clusters_by_gene_frac()` allows us to compute the fraction of cells in each cluster that express the provided gene (> 0 UMIs). This fraction is provided by `scanpy`'s dotplot function, which calculates these fractions for use in display. We then filter clusters based on the cutoff provided as a parameter to this function. # # `run_leiden()` and `run_leiden_parallel()` enable parallel computation of multiple resolutions of leiden clustering. # In[ ]: def select_clusters_by_gene_frac(adata, gene, cutoff, clusters = 'leiden'): gene_cl_frac = sc.pl.dotplot( adata, groupby = clusters, var_names = gene, return_fig = True ).dot_size_df select_cl = gene_cl_frac.index[gene_cl_frac[gene] > cutoff].tolist() return select_cl def run_leiden(adata, resolution, key_added): # Make a copy of adata for thread safety adata_copy = copy.deepcopy(adata) adata_clustering = sc.tl.leiden( adata_copy, resolution = resolution, key_added = key_added, copy = True) return adata_clustering.obs def run_leiden_parallel(adata, tasks): with ProcessPoolExecutor(max_workers = 5) as executor: # Make deep copies of adata for each task to ensure thread safety futures = [executor.submit(run_leiden, copy.deepcopy(adata), resolution, key_added) for resolution, key_added in tasks] results = [future.result() for future in futures] # Assign the results back to the original AnnData object for result, (_, key_added) in zip(results, tasks): adata.obs[key_added] = result[key_added] return adata # ## Read full dataset from HISE # In[2]: cell_class = 'myeloid-cells' # In[3]: h5ad_uuid = '9db48bed-cd91-49ae-abd2-447ae478ca96' h5ad_path = '/home/jupyter/cache/{u}'.format(u = h5ad_uuid) # In[5]: if not os.path.isdir(h5ad_path): hise_res = hisepy.reader.cache_files([h5ad_uuid]) # In[6]: h5ad_filename = os.listdir(h5ad_path)[0] h5ad_file = '{p}/{f}'.format(p = h5ad_path, f = h5ad_filename) # In[7]: adata = sc.read_h5ad(h5ad_file) # In[8]: adata # ## Plot major cell class markers # # To get an overview of cluster identity, we'll use a set of marker genes that are expressed in major classes of PBMC cell types: # In[9]: markers = [ 'MS4A1', # B cells 'CD3D', # T cells 'NCAM1', # NK cells 'FCN1', # Myeloid cells 'HBB', # Erythrocytes 'PPBP', # Platelets 'MKI67', # Proliferating cells 'IL3RA', # pDCs 'PRSS57' # HSPCs ] # In[10]: sc.pl.dotplot( adata, groupby = 'leiden', var_names = markers, swap_axes = True ) # ## Select clusters to retain # # To select clusters, we'll use `select_clusters_by_gene_frac()` to select clusters for our desired cell type. We can also select clusters that express off-target genes (like HBB and PPBP), and use these to filter our list of clusters. # In[11]: sc.pl.umap(adata, color = 'leiden', legend_loc = 'on data') # In[12]: fcn1_pos_cl = select_clusters_by_gene_frac( adata, gene = 'FCN1', cutoff = 0.5, clusters = 'leiden' ) sc.pl.umap(adata, color = 'leiden', groups = fcn1_pos_cl) # In[13]: il3ra_pos_cl = select_clusters_by_gene_frac( adata, gene = 'IL3RA', cutoff = 0.5, clusters = 'leiden' ) sc.pl.umap(adata, color = 'leiden', groups = il3ra_pos_cl) # In[14]: ppbp_pos_cl = select_clusters_by_gene_frac( adata, gene = 'PPBP', cutoff = 0.8, clusters = 'leiden' ) sc.pl.umap(adata, color = 'leiden', groups = ppbp_pos_cl) # ## Select clusters and subset data # # In[15]: keep_cl = fcn1_pos_cl + il3ra_pos_cl keep_cl.sort() keep_cl # Now, we can filter the dataset to get the subset we're after. # In[16]: adata_subset = adata[adata.obs['leiden'].isin(keep_cl)] # In[17]: adata_subset.shape # ## Normalize and harmonize subset # # As in the original analysis of this dataset, we'll need to normalize, select marker genes, and run Harmony to integrate across our cohorts. # # It's important that we redo this step for our subset, as gene variability may differ when computed within our subset of cells rather than across the entire set of PBMCs. This key feature selection step will affect our ability to cluster and identify cell types, so we do this iteratively for the subset we're using now. # We previously stored raw counts in `adata.raw` - we can now recover these original count data for analysis of the selected cells: # In[18]: adata_subset = adata_subset.raw.to_adata() # In[19]: adata_subset.shape # In[20]: adata_subset.raw = adata_subset # In[21]: sc.pp.normalize_total(adata_subset, target_sum=1e4) # In[22]: sc.pp.log1p(adata_subset) sc.pp.highly_variable_genes(adata_subset) adata_subset = adata_subset[:, adata_subset.var_names[adata_subset.var['highly_variable']]] # In[23]: sc.pp.scale(adata_subset) # In[24]: sc.tl.pca(adata_subset, svd_solver='arpack') # In[25]: sce.pp.harmony_integrate( adata_subset, 'cohort.cohortGuid', max_iter_harmony = 30) # In[26]: sc.pp.neighbors( adata_subset, n_neighbors = 50, use_rep = 'X_pca_harmony', n_pcs = 30) # In[27]: sc.tl.umap(adata_subset, min_dist = 0.05) # In[10]: out_dir = 'output' if not os.path.isdir(out_dir): os.makedirs(out_dir) # In[29]: subset_h5ad = 'output/ref_pbmc_{c}_subset_{d}.h5ad'.format(c = cell_class, d = date.today()) adata_subset.write_h5ad(subset_h5ad) # ## Cluster at multiple resolutions # # Here, we use our helper functions to perform clustering at multiple resolutions. This can be helpful for finding a set of clusters that correspond well to marker expression and distinguish functional cell type differences. # In[8]: get_ipython().run_cell_magic('time', '', 'tasks = [\n (1, "leiden_resolution_1"),\n (1.5, "leiden_resolution_1.5"),\n (2, "leiden_resolution_2"),\n (2.5, "leiden_resolution_2.5"),\n (3, "leiden_resolution_3")\n]\n') # In[ ]: adata_subset = run_leiden_parallel(adata_subset, tasks) # In[4]: clustered_h5ad = 'output/ref_pbmc_{c}_clustered_{d}.h5ad'.format(c = cell_class, d = date.today()) # In[ ]: adata_subset.write_h5ad(clustered_h5ad) # ## Plot reference labels and clustering # # Now that we've clustered, it's helpful to plot reference labels and clusters on our UMAP projection to see how they fall relative to each other. # In[32]: sc.pl.umap( adata_subset, color = ['seurat.l2.5'], size = 2, show = False, ncols = 1 , frameon = False ) # In[33]: sc.pl.umap( adata_subset, color = ['celltypist.low'], size = 2, show = False, ncols = 1 , frameon = False ) # CMV status is also helpful to view, as CMV can drive expansion of some cell types. # In[34]: sc.pl.umap( adata_subset, color = ['subject.cmv'], size = 2, show = False, ncols = 1 , frameon = False ) # In[35]: leiden_cols = [t[1] for t in tasks] sc.pl.umap( adata_subset, color = leiden_cols, size = 2, show = False, ncols = 1 , frameon = False ) # ## Save UMAP coordinates and labels # In[36]: umap_mat = adata_subset.obsm['X_umap'] # In[37]: umap_df = pd.DataFrame(umap_mat, columns = ['umap_1', 'umap_2']) # In[38]: obs = adata_subset.obs obs['umap_1'] = umap_df['umap_1'] obs['umap_2'] = umap_df['umap_2'] # In[5]: out_csv = 'output/ref_pbmc_{c}_subclustered_umap_meta_{d}.csv'.format(c = cell_class, d = date.today()) # In[ ]: obs.to_csv(out_csv) # In[6]: out_parquet = 'output/ref_pbmc_{c}_subclustered_umap_meta_{d}.parquet'.format(c = cell_class, d = date.today()) # In[ ]: obs = obs.to_parquet(out_parquet) # ## Compute markers for each resolution of Leiden clustering # In[ ]: adata_subset = adata_subset.raw.to_adata() sc.pp.normalize_total(adata_subset, target_sum=1e4) sc.pp.log1p(adata_subset) marker_files = {} for res_num,res_name in tasks: res_csv = '{p}/ref_pbmc_{c}_res{n}_markers_{d}.csv'.format(p = out_dir, c = cell_class, n = res_num, d = date.today()) sc.tl.rank_genes_groups(adata_subset, res_name, method = 'wilcoxon') df = sc.get.rank_genes_groups_df(adata_subset, group = None) df.to_csv(res_csv) marker_files[res_num] = res_csv # In[11]: marker_files = {} for res_num,res_name in tasks: res_csv = '{p}/ref_pbmc_{c}_res{n}_markers_{d}.csv'.format(p = out_dir, c = cell_class, n = res_num, d = date.today()) marker_files[res_num] = res_csv # ## Upload assembled data to HISE # # Finally, we'll use `hisepy.upload.upload_files()` to send a copy of our output to HISE to use for downstream analysis steps. # In[19]: study_space_uuid = '64097865-486d-43b3-8f94-74994e0a72e0' title = 'Ref. Myeloid subclustering {d}'.format(d = date.today()) # In[20]: in_files = [h5ad_uuid] # In[21]: in_files # In[22]: marker_list = [f for f in marker_files.values()] # In[23]: out_files = [clustered_h5ad, out_csv, out_parquet] + marker_list # In[24]: out_files # In[25]: hisepy.upload.upload_files( files = out_files, study_space_id = study_space_uuid, title = title, input_file_ids = in_files ) # In[26]: import session_info session_info.show() # In[ ]: