{
 "cells": [
  {
   "cell_type": "markdown",
   "id": "0e4c68ea",
   "metadata": {},
   "source": [
    "---\n",
    "title: scATAC-seq 基因活力分析：染色质可及性与转录潜力评估\n",
    "author: SeekGene\n",
    "date: 2026-01-29\n",
    "tags:\n",
    "  - ATAC + RNA 双组学\n",
    "  - 分析指南\n",
    "  - Notebooks\n",
    "  - 活性分析\n",
    "---\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "b0426a4a-48d1-4565-bf34-1227be2f6491",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "source": [
    "# scATAC-seq 基因活力分析：染色质可及性与转录潜力评估"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "35f271f8-2f87-4532-ab89-97ed5261a7d1",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "source": [
    "## 背景介绍\n",
    "\n",
    "基因活力分析（Gene Activity Analysis）是单细胞 ATAC-seq 数据分析中的核心技术，它通过量化染色质可及性来间接评估基因的转录潜力。这种方法基于一个重要的生物学假设：染色质的开放状态与基因转录活性之间存在密切关联。\n",
    "\n",
    "### 核心原理\n",
    "该方法通过统计每个基因区域（包括基因体及其上游 2kb 调控区域）内的 ATAC-seq 信号强度，这些信号直接反映了 DNA 的开放程度，从而预示着基因的潜在转录活性。\n",
    "\n",
    "### 目的与意义\n",
    "- 数据整合桥梁：为 scATAC-seq 构建“转录近似”表型，用作与 scRNA-seq 的锚点，支持 CCA/Anchors 等跨组学整合与标签转移。\n",
    "- 注释与解释：在 ATAC 聚类上可视化经典标记基因活力，辅助识别细胞类型与状态。\n",
    "- 机制与发现：结合表达与活力做相关/差异分析，挖掘特异开放基因与潜在调控逻辑。\n",
    "\n",
    "### 本教程涵盖内容\n",
    "\n",
    "- **基因活力分析**：评估染色质可及性与基因转录潜力的关系\n",
    "- **基因活力差异分析**：识别不同细胞类型间的基因活力差异\n",
    "- **差异分析可视化**：结合基因表达数据，对比差异基因活力与对应基因的表达模式\n",
    "- **相关性分析**：\n",
    "  - 不同 cluster 间的基因活力相关性分析\n",
    "  - 不同 cluster 间的基因表达相关性分析\n",
    "\n",
    "### 预期分析结果\n",
    "\n",
    "通过本部分的分析，您将获得：\n",
    "\n",
    "- **cluster 特异性基因集**：识别在特定细胞类型中特异性开放的基因\n",
    "- **表达-活力关联性**：了解 cluster 特异性基因在基因活力和基因表达两个层面的表现\n",
    "- **异质性评估**：评估不同 cluster 在基因表达层面和基因活力层面的异质性特征"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "7b6cd768",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "source": [
    "## 参数设置\n",
    "\n",
    "请先挂载将要分析的云平台相关流程数据，挂载方式请参照 jupyter 使用教程\n",
    "\n",
    "具体参数填写：\n",
    "\n",
    "- rds：挂载的流程相关的 rds 数据，在/home/{UserName}/workspace/project/{UserName}/目录下，如下列项目数据/home/shumeng/workspace/data/AY1752167131383/\n",
    "- meta：与 rds 同目录下的 metadata 文件\n",
    "- outdir: 分析结果报错路径\n",
    "- celltype_colname：细胞类型列名，选择要分析的细胞类型或者聚类对应的标签。假如想对注释好的细胞类型进行分析，则选择其对应的标签，例如 CellAnnotation，与<细胞类型>配合使用\n",
    "- celltypes：细胞类型，多选，选择要分析的细胞类型或者聚类结果，如 Monocyte 和 Macrophage 等\n",
    "- logFC_cut：差异倍数的阈值，默认 0.25\n",
    "- padj_cut：pvadj 阈值，默认 < 0.05\n",
    "- pval_cut：pval 阈值，默认 < 0.05\n",
    "- reduction：FeaturePlot 可视化基因活力时，用于降维的方式，可选 umap/tsne/lsi/atacumap/atactsne/wnnumap/wnntsne。默认 wnnumap"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "0178cc95",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": [
     "remove-cell"
    ],
    "vscode": {
     "languageId": "r"
    }
   },
   "outputs": [],
   "source": [
    "# Parameters按照需要填写自己路径下的数据路径\n",
    "rds = \"/home/shumeng/workspace/data/AY1752167131383/input.rds\"\n",
    "meta = \"/home/shumeng/workspace/data/AY1752167131383/meta.tsv\"\n",
    "outdir = \"/home/shumeng/workspace/project/shumeng/\"\n",
    "celltype_colname = \"wknn_res.0.5_d30_l2_50\"\n",
    "celltypes = \"0,1,2,3,4,5,6,7,8,9\"\n",
    "logFC_cut = 0.25\n",
    "padj_cut = 0.05\n",
    "pval_cut = 0.05\n",
    "reduction = \"wnnumap\"\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "6de5a4cd",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "source": [
    "## 环境准备\n",
    "\n",
    "**R 包加载**\n",
    "\n",
    "**请选择 common_r 这个环境进行该教程的学习**"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "62bcd1b4-1bb2-4856-a09c-692fb0819f3d",
   "metadata": {
    "editable": true,
    "execution": {
     "iopub.execute_input": "2025-08-19T06:08:09.615810Z",
     "iopub.status.busy": "2025-08-19T06:08:09.614313Z",
     "iopub.status.idle": "2025-08-19T06:08:31.700214Z",
     "shell.execute_reply": "2025-08-19T06:08:31.698397Z"
    },
    "slideshow": {
     "slide_type": ""
    },
    "tags": [
     "remove-input"
    ],
    "vscode": {
     "languageId": "r"
    }
   },
   "outputs": [],
   "source": [
    "# 保存当前库路径\n",
    "original_lib_paths <- .libPaths()\n",
    "# 1. 首先加载基础依赖包\n",
    "suppressMessages({\n",
    "    library(Rcpp, quietly = TRUE)\n",
    "    library(Matrix, quietly = TRUE)\n",
    "})\n",
    "# 2. 设置临时库路径并加载 presto\n",
    "temp_lib_path <- \"/PROJ/development/liuxin/Software/miniconda3/envs/Celltype/lib/R/library\"\n",
    "if(dir.exists(temp_lib_path)) {\n",
    "    .libPaths(c(temp_lib_path, original_lib_paths))\n",
    "}\n",
    "suppressMessages({\n",
    "    library(presto, quietly = TRUE)\n",
    "    source(\"/PROJ2/FLOAT/shumeng/script/wilcoxauc.R\")\n",
    "})\n",
    "# 3. 恢复原始库路径\n",
    ".libPaths(original_lib_paths)\n",
    "# 4. 加载其他分析包，调整加载顺序\n",
    "suppressMessages({\n",
    "    # 先加载基础依赖\n",
    "    #library(parallelly, quietly = TRUE)\n",
    "    #library(future, quietly = TRUE)\n",
    "    # 然后加载主要分析包\n",
    "    library(ggrepel,quietly = TRUE)\n",
    "    library(Signac,quietly = TRUE)\n",
    "    library(Seurat,quietly = TRUE)\n",
    "    # 最后加载可视化和工具包\n",
    "    library(ggplot2, quietly = TRUE)\n",
    "    library(dplyr, quietly = TRUE)\n",
    "    #library(ggrepel, quietly = TRUE)\n",
    "    library(DT, quietly = TRUE)\n",
    "    library(hexbin, quietly = TRUE)\n",
    "    library(viridis, quietly = TRUE)\n",
    "    library(gridExtra, quietly = TRUE)\n",
    "    library(pheatmap, quietly = TRUE)\n",
    "    library(base64enc, quietly = TRUE)\n",
    "    library(viridis, quietly = TRUE)\n",
    "    library(RColorBrewer,quietly = TRUE)\n",
    "    library(scales,quietly = TRUE)\n",
    "\n",
    "\n",
    "})\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "70e54d5a-747b-48fa-9fca-7ee6c62285ff",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "source": [
    "## 基因活力（Gene Activity）计算"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "4ac20f6f-5b1e-4abc-8a53-edfcb6f7bf81",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "source": [
    "### 计算流程\n",
    "1. 目标区域确定：为每个基因定义基因体（gene body）与上游约 2 kb 启动子区域（可按需要调整）。\n",
    "2. 片段计数：对每个细胞统计 ATAC 片段落在上述区域内的次数（可按片段或插入位点计数）。\n",
    "3. 构建矩阵：将基因×细胞的计数整合为基因活力矩阵（`FeatureMatrix`；在实际流程中由 `GeneActivity()` 封装完成）。\n",
    "4. 归一化：对活力矩阵进行对数标准化，使其量级可与 scRNA-seq 表达相比较，便于联合分析与可视化。\n",
    "\n",
    "#### 在本项目中的实现（Signac）\n",
    "- 读取单样本或整合后的 `Seurat` 对象（可选合并 `meta` 并 `AddMetaData`）。\n",
    "- 设置默认 `assay` 为 `ATAC`，运行 `GeneActivity(sc)` 计算基因活力。\n",
    "- 将结果写入新的 `assay`：`ATAC_activity`（`CreateAssayObject(counts = gene.activity)`）。\n",
    "- 使用 `NormalizeData` 对 `ATAC_activity` 进行 `LogNormalize`，`scale.factor` 取 `median(sc$nCount_RNA)`，以便与 RNA 表达量处于相近量级，支持后续整合（如 CCA/Anchors）与对比展示。\n",
    "\n",
    "\n",
    "#### 实践要点与注意事项\n",
    "- 间接性与噪声：活力分数来自稀疏的可及性数据，较表达更噪；与真实表达并非一一对应。\n",
    "- 区域定义敏感：启动子窗口（如 2 kb）及是否包含基因体会影响结果，可按物种与注释版本微调。\n",
    "- 远端调控影响：对由远端增强子主导的基因，活力与表达的一致性可能较弱；可结合 `Cicero`/`ArchR` 等工具建联系并验证。"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "d9792f1c-42f4-432a-bffa-1801226d26ff",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": [
     "remove-input"
    ],
    "vscode": {
     "languageId": "r"
    }
   },
   "outputs": [],
   "source": [
    "suppressWarnings({\n",
    "  suppressMessages({\n",
    "      sc=readRDS(rds)\n",
    "      if(!is.null(meta)){\n",
    "          meta <- read.table(meta, header = T, sep = \"\\t\")\n",
    "          rownames(meta) <- meta$barcodes\n",
    "          sc <- AddMetaData(sc, meta)\n",
    "      }\n",
    "    \n",
    "      DefaultAssay(sc)=\"ATAC\"\n",
    "      gene.activity <- GeneActivity(sc)\n",
    "      sc[['ATAC_activity']] <- CreateAssayObject(counts = gene.activity) \n",
    "      sc <- NormalizeData(\n",
    "          object = sc, \n",
    "          assay = 'ATAC_activity', \n",
    "          normalization.method = 'LogNormalize',\n",
    "          scale.factor=median(as.numeric(sc$nCount_RNA))\n",
    "      )\n",
    "     })\n",
    "})   "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "3711f720-2ea1-4d30-a9bf-9d52b27dc207",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": [],
    "vscode": {
     "languageId": "r"
    }
   },
   "outputs": [],
   "source": [
    "sc@assays$ATAC_activity$counts[1:6,1:6]"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "6512dd4d-98dc-4daa-b3e2-90a7a5f43cf9",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "source": [
    "```{note}\n",
    "基因活力矩阵与基因表达矩阵类似，每一行代表一个基因，每一列代表一个细胞。值则表示每个细胞中对应基因的基因活力值。值越大表示该基因在对应细胞中的调控区域越开放，对应基因的潜在转录活性越高。此结论建立在基因活力与基因表达存在正相关的假设之上，实际由于基因表达调控的复杂性，可能存在基因活力高但基因表达低的情况，具体调控关系可根据实际需求进一步探究。\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "981486fc-9a43-4fa0-847d-8a84ff27ee43",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "source": [
    "## 基因活力差异分析\n",
    "\n",
    "### 细胞分群间基因活力差异分析\n",
    "\n",
    "#### 分析目的\n",
    "识别不同细胞分群（cluster）中基因活力显著升高或降低的基因，识别在特定细胞类型中特异性开放的基因，刻画各分群的表观转录特征。\n",
    "\n",
    "#### 对比策略与方法\n",
    "- 对比方式：采用“一对其余”（one-vs-rest）策略，对每个分群与其他所有分群进行独立比较。\n",
    "- 统计检验：使用 Wilcoxon 秩和检验评估基因活力在目标分群与其它分群之间的差异。\n",
    "\n",
    "#### 输出指标说明\n",
    "- feature：基因名称（基因层面的活力特征）\n",
    "- group：目标细胞分群\n",
    "- avgExpr：目标分群内该基因的平均活力水平\n",
    "- logFC：log2 倍数变化（目标分群相对其余分群的差异；正值表示目标分群更高）\n",
    "- statistic：Wilcoxon 检验统计量\n",
    "- auc：二分类 AUC，表示该基因活力对目标分群的区分能力\n",
    "- pval：原始 P 值\n",
    "- padj：多重检验校正后的 P 值\n",
    "- pct_in / pct_out：该基因在目标分群/其它分群中被检测到（活力>0）的细胞比例\n",
    "\n",
    "#### 筛选与阈值\n",
    "可结合效应大小与显著性设定阈值（如对 logFC 与 padj 同时约束），并参考检测率（pct_in/pct_out）以提升结果的稳健性。筛选后可获取各分群的候选高活力（或低活力）基因集。"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "e4e08cc9-9143-4735-aebc-5703bf450540",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": [
     "remove-input"
    ],
    "vscode": {
     "languageId": "r"
    }
   },
   "outputs": [],
   "source": [
    "dir.create(\"../result\", recursive = TRUE, showWarnings = FALSE)\n",
    "dir.create(\"../result/cluster_Diff\", recursive = TRUE, showWarnings = FALSE)\n",
    "dir.create(\"../result/cluster_Diff/FeaturePlot\", recursive = TRUE, showWarnings = FALSE)\n",
    "#dir.create(\"../result/group_Diff\", recursive = TRUE, showWarnings = FALSE)\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "b1007dea-dc5c-4c65-a0b7-881e239ee70d",
   "metadata": {
    "editable": true,
    "scrolled": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": [
     "remove-input"
    ],
    "vscode": {
     "languageId": "r"
    }
   },
   "outputs": [],
   "source": [
    "#celltype或者和cluster之间进行基因活力差异分析\n",
    "DefaultAssay(sc) <- \"ATAC_activity\"\n",
    "\n",
    "suppressWarnings({\n",
    "    suppressMessages({\n",
    "            Idents(sc)=sc@meta.data[[celltype_colname]]\n",
    "            Diff_genes_activity=wilcoxauc(sc,celltype_colname,assay = 'data',seurat_assay = 'ATAC_activity')\n",
    "            if(exists(\"padj_cut\")){\n",
    "                Diff_genes_activity=Diff_genes_activity[which(abs(Diff_genes_activity$logFC) > logFC_cut & Diff_genes_activity$padj < padj_cut),]\n",
    "            }else if(exists(\"pval_cut\")){\n",
    "                Diff_genes_activity=Diff_genes_activity[which(abs(Diff_genes_activity$logFC) > logFC_cut & Diff_genes_activity$padj < pval_cut),]\n",
    "            }\n",
    "            \n",
    "            write.table(Diff_genes_activity,file = \"../result/cluster_Diff/cluster_Diff_genes_activity.txt\",quote = F,sep = \"\\t\",row.names = F)    \n",
    "    })\n",
    "})"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "855ed6e4",
   "metadata": {},
   "source": [
    "\n",
    "#### 结果呈现与使用\n",
    "结果以交互式表格展示，支持过滤、排序与导出，便于提取各分群特异的高活力基因集"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "9c8768ce-453a-496f-970c-8392ab7a6f0a",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": [
     "remove-input"
    ],
    "vscode": {
     "languageId": "r"
    }
   },
   "outputs": [],
   "source": [
    "# 移除外层抑制函数，保证输出可见性\n",
    "if(nrow(Diff_genes_activity) < 1) {\n",
    "  print(\"没有基因活力显著差异的基因，请降低显著性阈值\")\n",
    "} else {\n",
    "  # 直接返回DT对象（无需print）\n",
    "  datatable(\n",
    "    Diff_genes_activity,\n",
    "    rownames = FALSE,\n",
    "    filter = \"top\",\n",
    "    extensions = 'Buttons',\n",
    "    options = list(\n",
    "      dom = 'Bfrtip',\n",
    "      buttons = c('csv', 'excel'),\n",
    "      columnDefs = list(\n",
    "        list(\n",
    "          targets = 2:9,  # 更简洁的索引写法\n",
    "          render = DT::JS(\"function(data) {\n",
    "            return typeof data === 'number' \n",
    "                   ? data.toExponential(2) \n",
    "                   : data;\n",
    "          }\")\n",
    "        )\n",
    "      )\n",
    "    )\n",
    "  )\n",
    "}"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "fb581427-eaad-4f34-9a6a-2675e0f58f47",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "source": [
    "```{note}\n",
    "通常当同时满足 logFC > 0.25 和 padj < 0.05 这两个条件时，可以认为该基因在这个特定细胞群中相比其他细胞群具有显著更高的调控活力。\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "3d8a9ad7-977e-494a-893c-ad5311b5e7fb",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "source": [
    "### 降维图可视化差异结果\n",
    "\n",
    "#### 特征基因可视化（FeaturePlot）\n",
    "\n",
    "为直观展示不同细胞类型的标志基因分布，我们为每个细胞类型选取最具代表性的前五个标志基因，并在降维空间中进行并行可视化。\n",
    "\n",
    "- **展示维度**\n",
    "  - ATAC_activity：反映基因启动子/基因体区域的染色质开放程度（调控潜力）\n",
    "  - RNA：反映对应基因的转录表达水平（实际转录产物）\n",
    "- **图形说明**\n",
    "  - 每个点代表一个单细胞；颜色深浅表示该基因在该细胞的活力或表达强度\n",
    "  - 将同一基因在两种模态下并列/分面展示，便于对比不同细胞类型中的特异性模式\n",
    "- **解读要点**\n",
    "  - 细胞类型特异性：标志基因在预期细胞类型中应呈现高活力/高表达的空间富集\n",
    "  - 跨模态一致性：ATAC 活力与 RNA 表达的一致性支持该基因在该类型的活跃转录状态\n",
    "  - 不一致线索：若活力高但表达低，可能提示调控预激活、时序差异或远端增强子影响\n",
    "- **注意事项**\n",
    "  - 基因活力为间接读数，噪声较大；与 RNA 表达不一定一一对应\n",
    "  - 活力的窗口定义（如上游 2 kb 是否包含、是否计入基因体）会影响可视化结果"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "82b94d93",
   "metadata": {
    "vscode": {
     "languageId": "r"
    }
   },
   "outputs": [],
   "source": [
    "#获取每个cluster中top10差异基因，和热图基因，为后续可视化做准备\n",
    " if(nrow(Diff_genes_activity) < 1){\n",
    "            print(\"没有基因活力显著差异的基因，请降低显著性阈值\")\n",
    "        }else{\n",
    "            cluster_num <- length(table(sc@meta.data[[celltype_colname]]))\n",
    "            if (cluster_num <= 8) {\n",
    "                n <- 10\n",
    "                height <- 3\n",
    "            } else if (cluster_num > 8 & cluster_num <= 10) {\n",
    "                n <- 8\n",
    "                height <- 4\n",
    "            } else if (cluster_num > 10 & cluster_num <= 15) {\n",
    "                n <- 5\n",
    "                height <- 5\n",
    "            } else {\n",
    "                n <- 4\n",
    "                height <- 7\n",
    "            }\n",
    "            Diff_genes_activity %>%\n",
    "                group_by(group) %>%\n",
    "                arrange(desc(logFC)) %>%\n",
    "                slice_head(n = n) %>%      # 改为10个基因\n",
    "                ungroup() -> top10\n",
    "\n",
    "            if(nrow(top10) <= 10){\n",
    "                width=5\n",
    "            }else if(nrow(top10) > 10 & nrow(top10) <= 15){\n",
    "                width=7\n",
    "            }else if(nrow(top10) > 15 & nrow(top10) <= 20){\n",
    "                width=9\n",
    "            }else if(nrow(top10) > 20 & nrow(top10) <= 25){\n",
    "                width=11\n",
    "            }else if(nrow(top10) > 25 & nrow(top10) <= 30){\n",
    "                width=13\n",
    "            }else if(nrow(top10) > 30 & nrow(top10) <= 35){\n",
    "                width=15\n",
    "            }else if(nrow(top10) > 35 & nrow(top10) <= 40){\n",
    "                width=17\n",
    "            }else if(nrow(top10) > 40 & nrow(top10) <= 45){\n",
    "                width=19\n",
    "            }else if(nrow(top10) > 45 & nrow(top10) <= 55){\n",
    "                width=20\n",
    "            }else if(nrow(top10) > 55 & nrow(top10) <= 65){\n",
    "                width=21\n",
    "            }else {\n",
    "                width=22\n",
    "            }\n",
    "                #获取每个cluster中top1差异基因\n",
    "            Diff_genes_activity %>%\n",
    "                group_by(group) %>%\n",
    "                arrange(desc(logFC)) %>%    # 添加这行，按照logFC从大到小排序\n",
    "                slice_head(n = 5) %>%      # 改为1个基因\n",
    "                ungroup() -> top5\n",
    "                #获取画热图的基因集\n",
    "            Diff_genes_activity %>%\n",
    "                group_by(group) %>%\n",
    "                arrange(desc(logFC)) -> heatmap_genes\n",
    "        }"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "5a2c8bfe-808a-4a0f-8f36-2d12d362d2d5",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": [
     "remove-input"
    ],
    "vscode": {
     "languageId": "r"
    }
   },
   "outputs": [],
   "source": [
    "# 添加必要的包\n",
    "# 检查并创建保存目录\n",
    "# dir.create(\"_build/html/result/cluster_Diff/FeaturePlot/\", recursive = TRUE, showWarnings = FALSE)\n",
    "options(warn = -1)\n",
    "save_and_encode_plot <- function(plot, filename, width, height) {\n",
    "    # 保存图片文件\n",
    "    full_path_pdf <- paste0(filename, \".pdf\")\n",
    "    temp_png <- tempfile(fileext = \".png\")\n",
    "    \n",
    "    # 保存PDF\n",
    "    ggsave(full_path_pdf, plot, width = width, height = height)\n",
    "    # 临时保存PNG用于base64编码\n",
    "    ggsave(temp_png, plot, width = width, height = height, dpi = 300)\n",
    "    \n",
    "    # 将图片转换为base64\n",
    "    png_data <- readBin(temp_png, \"raw\", file.info(temp_png)$size)\n",
    "    base64_img <- base64encode(png_data)\n",
    "    \n",
    "    # 删除临时PNG文件\n",
    "    #unlink(temp_png)\n",
    "    \n",
    "    return(list(\n",
    "        base64 = base64_img,\n",
    "        pdf_path = full_path_pdf\n",
    "    ))\n",
    "}\n",
    "\n",
    "suppressWarnings({\n",
    "    suppressMessages({\n",
    "        if(exists(\"top5\")){\n",
    "            cell_types <- unique(top5$group)    \n",
    "            # 创建数据框用于展示\n",
    "            image_df <- data.frame(\n",
    "                CellType = cell_types,\n",
    "                stringsAsFactors = FALSE\n",
    "            )\n",
    "            # 为每个assay生成一列图片\n",
    "            for(assay in c(\"ATAC_activity\", \"RNA\")) {\n",
    "                DefaultAssay(sc) <- assay\n",
    "                col_name <- paste0(assay, \"_Plot\")\n",
    "            \n",
    "                image_df[[col_name]] <- sapply(cell_types, function(i) {\n",
    "                    # 1. 生成图片\n",
    "                    p1 <- FeaturePlot(\n",
    "                        object = sc,\n",
    "                        features = top5$feature[top5$group == i],\n",
    "                        reduction = reduction,\n",
    "                        pt.size = 0.1,\n",
    "                        max.cutoff = 'q95',\n",
    "                        ncol = 5,\n",
    "                        cols=c(\"#E5E3E3\",\"#EF6067\"),\n",
    "                        order = TRUE\n",
    "                    ) +\n",
    "                    theme_minimal() +\n",
    "                    theme(\n",
    "                        panel.grid = element_blank(),\n",
    "                        axis.text = element_text(size = 8),\n",
    "                        axis.title = element_text(size = 10)\n",
    "                    )\n",
    "                \n",
    "                    # 2. 保存图片并获取base64编码\n",
    "                    result <- save_and_encode_plot(\n",
    "                        plot = p1,\n",
    "                        filename = paste0(\"../result/cluster_Diff/FeaturePlot/feature_plot_cluster_\", \n",
    "                                       assay, \"_\", i),\n",
    "                        width = 20,\n",
    "                        height = 3\n",
    "                    )\n",
    "                \n",
    "                    # 3. 创建HTML，包含base64图片\n",
    "                    sprintf(\n",
    "                        '<div class=\"plot-container\">\n",
    "                            <img src=\"data:image/png;base64,%s\" height=\"400px\" onclick=\"window.open(\\'%s\\')\"/>\n",
    "                        </div>',\n",
    "                        result$base64,\n",
    "                        result$pdf_path\n",
    "                    )\n",
    "                })\n",
    "            }\n",
    "        \n",
    "            # 4. 创建交互式表格展示结果\n",
    "            output_table <- suppressWarnings(DT::datatable(\n",
    "                image_df,\n",
    "                escape = FALSE,\n",
    "                options = list(\n",
    "                    pageLength = 1,\n",
    "                    scrollX = TRUE,\n",
    "                    dom = 'Bfrtip',\n",
    "                    server = TRUE,       # 强制服务器端模式\n",
    "                    pageLength = 1,\n",
    "                    deferRender = TRUE,  # 延迟渲染\n",
    "                    scroller = TRUE,     # 滚动加载\n",
    "                    columnDefs = list(\n",
    "                        list(\n",
    "                            targets = 1:2,\n",
    "                            width = \"45%\"\n",
    "                        )\n",
    "                    )\n",
    "                ),\n",
    "                rownames = FALSE,\n",
    "                filter = 'top',\n",
    "                caption = htmltools::tags$caption(\n",
    "                    style = 'caption-side: top; text-align: center; font-size: 1.2em; font-weight: bold;',\n",
    "                    'Feature plots for top 5 genes in each celltype'\n",
    "                )\n",
    "            )\n",
    "                                            )\n",
    "            output_table\n",
    "        }else{\n",
    "            print(\"没有基因活力显著差异的基因，请降低显著性阈值\")\n",
    "        }\n",
    "\n",
    "    })\n",
    "})\n",
    "options(warn = 0)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "211d5d85-8302-463c-8446-5906ef2cee85",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "source": [
    "```{note}\n",
    "表格中第一列为细胞分群信息，第二列为该细胞群中最具代表性的前五个标志基因染色质活力分布图，第三列为前五个标志基因基因表达分布图\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "1cbb4a58-bbfb-485c-94e8-f8c3fdc3bec8",
   "metadata": {},
   "source": [
    "### 热图可视化差异结果\n",
    "\n",
    "#### 特征基因热图对比（ATAC_activity vs RNA）\n",
    "\n",
    "- **可视化目的**\n",
    "    - 展示各细胞类型标志基因在两种模态（染色质活性与转录表达）下的分布与一致性，辅助细胞类型注释与机制解读。\n",
    "\n",
    "- **图像构成**\n",
    "    - 左侧：ATAC 活性热图（ATAC_activity，反映启动子/基因体的可及性）\n",
    "    - 右侧：RNA 表达热图（反映实际转录水平）\n",
    "    - 行：特征基因（每个细胞类型选取前五个或自定义列表）\n",
    "    - 列：单细胞；按细胞类型/cluster 分组，并以颜色条标注\n",
    "    - 颜色：由浅到深表示活性/表达由低到高\n",
    "    - 标准化建议：为突出相对模式，建议对每个基因按细胞方向做行内标准化（如 z-score），并在两张热图中保持相同的基因顺序与列顺序\n",
    "\n",
    "- **解读要点**\n",
    "    - 细胞类型特异性：标志基因在对应细胞类型中应显示高活性/高表达的聚集带\n",
    "    - 跨模态一致性：ATAC 活性与 RNA 表达的协同上调，提示活跃的转录状态与开放染色质的一致\n",
    "    - 不一致线索：活性高但表达低，可能反映转录预激活、时间滞后或远端增强子驱动；表达高但活性低，可能受技术噪声或区域定义影响\n",
    "    - 异质性：同一分群内的梯度/多峰提示亚群或连续谱状态"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "96e4f179",
   "metadata": {
    "vscode": {
     "languageId": "r"
    }
   },
   "outputs": [],
   "source": [
    "# 检查并处理 color_gradient\n",
    "# 将逗号分隔的字符串拆分成颜色值向量\n",
    "if(!exists(\"color_gradient\")){\n",
    "    color_gradient <- c(\"#F9F9F9\",\"#F0484A\")\n",
    "} else {\n",
    "    # 如果 color_gradient 是字符串，将其分割成向量\n",
    "    if(length(color_gradient) == 1) {\n",
    "        color_gradient. <- unlist(strsplit(color_gradient, \",\"))\n",
    "    }\n",
    "}\n",
    "colors_cancer <- colorRampPalette(color_gradient)(100)\n",
    "\n",
    "\n",
    "\n",
    "base_colors=c(\"#EDD496\",\"#65D1BF\",\"#7ADAEA\",\"#F2AFAF\",\"#EA8F8F\",\n",
    "                 \"#C1A9D3\",\"#F2DA9E\",\"#D9EF78\",\"#EF9ED9\",\"#C9BCC6\",\"#8BD198\")\n",
    "library(RColorBrewer)\n",
    "library(scales)  \n",
    "# 获取实际的cluster数量\n",
    "cell_types <- if(exists(\"celltypes\")) unlist(strsplit(celltypes, \",\")) else unique(sc@meta.data[[celltype_colname]])\n",
    "    unique_clusters <- length(cell_types)\n",
    "cell_types_all=cell_types\n",
    "generate_cols <- function(n) {\n",
    "    if(n <= 0) return(character(0))  # 处理0长度情况\n",
    "    # 循环扩展基础颜色\n",
    "    base_colors[((1:n)) %% length(base_colors) + 1] \n",
    "}\n",
    "my_cols <- generate_cols(unique_clusters)\n",
    "identity_colors <- setNames(my_cols, cell_types)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "cbe560f1-0926-40d3-8e00-1a9b87c81f32",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": [
     "remove-input"
    ],
    "vscode": {
     "languageId": "r"
    }
   },
   "outputs": [],
   "source": [
    "suppressWarnings({\n",
    "  suppressMessages({      \n",
    "    # 加载必要的包\n",
    "    \n",
    "    # 设置图形参数\n",
    "    options(repr.plot.width = 16, repr.plot.height = 10)\n",
    "    if(exists(\"top10\")){\n",
    "        # ATAC活性热图\n",
    "        DefaultAssay(sc) <- 'ATAC_activity'\n",
    "        p1 = DoHeatmap(sc,\n",
    "            features = top10$feature,\n",
    "            slot = \"data\",\n",
    "            draw.lines = TRUE,\n",
    "            raster = TRUE,\n",
    "            group.colors = identity_colors,\n",
    "            label = FALSE\n",
    "        ) +\n",
    "            scale_fill_gradientn(colors = colors_cancer) +\n",
    "            guides(fill = guide_colorbar(title = \"Activity\")) +\n",
    "            ggtitle(\"ATAC Activity\")  # 添加标题\n",
    "    \n",
    "        # RNA表达热图\n",
    "        DefaultAssay(sc) <- 'RNA'\n",
    "        p2 = DoHeatmap(sc,\n",
    "            features = top10$feature,\n",
    "            slot = \"data\",\n",
    "            draw.lines = TRUE,\n",
    "            raster = TRUE,\n",
    "            group.colors = identity_colors,\n",
    "            label = FALSE\n",
    "        ) +\n",
    "            scale_fill_gradientn(colors = colors_cancer) +\n",
    "            guides(fill = guide_colorbar(title = \"Expression\")) +\n",
    "            ggtitle(\"RNA Expression\")  # 添加标题\n",
    "        # 组合并显示图形\n",
    "        combined_plot <- p1 + p2  # 使用/进行垂直排列\n",
    "        print(combined_plot)\n",
    "        #dir.create(\"_build/html/result/cluster_Diff\", recursive = TRUE, showWarnings = FALSE)\n",
    "        # 保存图片\n",
    "        invisible(pdf(\"../result/cluster_Diff/Top10.GeneActivityandExpression.heatmap.pdf\", width = 8, height = 10))\n",
    "        invisible(print(combined_plot))\n",
    "        invisible(dev.off())\n",
    "    }else{\n",
    "       print(\"没有基因活力显著差异的基因，请降低显著性阈值\") \n",
    "    }\n",
    "  })\n",
    "})"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "9144b118-0d8e-488d-b663-e1729bc94393",
   "metadata": {},
   "source": [
    "### 小提琴图可视化差异结果\n",
    "\n",
    "#### 特征基因双模态小提琴图（ATAC_activity vs RNA）\n",
    "\n",
    "- **可视化目的**\n",
    "    - 对比各细胞亚群中高活性特征基因在染色质可及性（ATAC_activity）与转录表达（RNA）两种模态下的分布与一致性，辅助注释与机制解读。\n",
    "\n",
    "- **图像构成**\n",
    "    - 上半部分：ATAC 活性小提琴图，表示基因启动子/基因体的可及性分布（活力分数）。\n",
    "    - 下半部分：RNA 表达小提琴图，表示相同基因的转录水平分布。\n",
    "    - 选择与排序：每个细胞亚群选取基因活性最强的前 10 个特征基因；两种模态使用相同的基因集合与顺序；细胞按亚群分组并以颜色区分。\n",
    "    - 读图要点：小提琴的形状反映分布密度与异质性，颜色表示亚群，不同模态可直观比较同一基因在不同亚群的活性/表达强弱与分布差异。\n",
    "\n",
    "- **解读要点**\n",
    "    - 亚群特异性：目标亚群应呈现相应标志基因的活性/表达峰值与密度集中带。\n",
    "    - 跨模态一致性：ATAC 高活性与 RNA 高表达同步上升，支持开放染色质驱动的活跃转录。\n",
    "    - 不一致线索：活性高但表达低，可能提示转录预激活、时间滞后或远端增强子主导；表达高但活性低，可能受技术噪声或区域定义影响。\n",
    "    - 异质性识别：同一亚群内出现多峰/长尾，提示亚群结构或连续谱状态。\n",
    "\n",
    "- **注意事项**\n",
    "    - 间接性与噪声：基因活力为可及性的间接读数，较 RNA 更稀疏嘈杂，二者并非总一一对应。"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "e2b9be72-d190-4b72-a0b8-0bd036417464",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": [
     "remove-input"
    ],
    "vscode": {
     "languageId": "r"
    }
   },
   "outputs": [],
   "source": [
    "# 先设置图形大小\n",
    "suppressWarnings({\n",
    "  suppressMessages({\n",
    "      if(exists(\"top10\")){\n",
    "          assays=c(\"ATAC_activity\",\"RNA\")\n",
    "          p=list()\n",
    "          for(assay in assays){\n",
    "              DefaultAssay(sc)=assay\n",
    "              if(length(top10$feature) > 1){\n",
    "                  options(repr.plot.width = width, repr.plot.height = height)\n",
    "                  stack=TRUE\n",
    "                  p[[as.character(assay)]] = VlnPlot(sc,\n",
    "                                                     features = top10$feature,\n",
    "                                                     stack = stack,\n",
    "                                                     pt.size = 0,\n",
    "                                                     fill.by = \"ident\",\n",
    "                                                     cols = identity_colors    # 添加颜色参数\n",
    "                                                    ) + \n",
    "                  xlab(if(assay == \"ATAC_activity\"){\n",
    "                  \"Gene Activity\"\n",
    "                  }else{\n",
    "                      \"Gene Expression\"\n",
    "                  }) +\n",
    "                  theme_minimal() +\n",
    "                  theme(\n",
    "                      # 移除上方文本\n",
    "                      axis.text.x.top = element_blank(),\n",
    "                      strip.text.x = element_text(angle = 45, hjust = 0),  # 分面标签角度# 设置下方基因名称\n",
    "                      axis.text.x.bottom = element_text(\n",
    "                          angle = 45,\n",
    "                          hjust = 1,          # 调整为1使文本右对齐\n",
    "                          vjust = 1,          # 调整为1使文本对齐轴线\n",
    "                          face = \"plain\",\n",
    "                          size = 8,           # 添加字体大小设置\n",
    "                          margin = margin(t = 0, r = 0, b = 0, l = 0)),\n",
    "                      panel.grid.major = element_blank(),\n",
    "                      panel.grid.minor = element_blank(),\n",
    "                      legend.position = \"none\",\n",
    "                      axis.ticks.x = element_blank(),    # 移除刻度线\n",
    "                      axis.line.x = element_blank(),     # 移除轴线\n",
    "                      plot.margin = margin(t = 5, r = 5, b = 5, l = 5)  # 调整边距\n",
    "                  ) +NoLegend()+scale_x_discrete(labels = top10$feature)\n",
    "              }else if(length(top10$feature) ==1){\n",
    "                  options(repr.plot.width = width, repr.plot.height = height)\n",
    "                  stack=FALSE\n",
    "                  p[[as.character(assay)]] = VlnPlot(sc,\n",
    "                                                     features = top10$feature,\n",
    "                                                     stack = stack,\n",
    "                                                     pt.size = 0,\n",
    "                                                     fill.by = \"ident\",\n",
    "                                                     cols = identity_colors    # 添加颜色参数\n",
    "                                                    ) + \n",
    "                  xlab(if(assay == \"ATAC_activity\"){\"Gene Activity\"\n",
    "                                                   }else{\"Gene Expression\"}) +\n",
    "                  theme_minimal()                  \n",
    "              }\n",
    "\n",
    "              }\n",
    "          print(p[[1]])\n",
    "          print(p[[2]])\n",
    "          invisible(pdf(\"../result/cluster_Diff/Top10.GeneActivityandExpression.vlnplot.pdf\",width=24,height=6))\n",
    "          invisible(print(p[[1]]))\n",
    "          invisible(print(p[[2]]))\n",
    "          invisible(dev.off())\n",
    "      }else{\n",
    "          print(\"没有基因活力显著差异的基因，请降低显著性阈值\") \n",
    "      }\n",
    "  })\n",
    "})"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "e2063e6c-7821-46ec-a7b1-69226b76cd9e",
   "metadata": {},
   "source": [
    "### 气泡图可视化差异结果\n",
    "\n",
    "#### 双模态气泡图（ATAC_activity vs RNA）\n",
    "\n",
    "- **可视化目的**\n",
    "    - 并行展示各细胞类型中标志基因在染色质可及性与转录表达两种模态下的总体水平与检出情况，便于快速比较一致性与特异性。\n",
    "\n",
    "- **图像构成与编码**\n",
    "    - 维度：上方为 ATAC 活性气泡图（ATAC_activity），下方为 RNA 表达气泡图（RNA）。\n",
    "    - 行/列：行表示基因，列表示细胞类型/cluster（两张图使用相同的行列顺序以便对齐比较）。\n",
    "    - 气泡大小：该基因在对应细胞类型中被检测到的细胞比例（检测率；如活力/表达>0 的比例）。\n",
    "    - 颜色深浅：该基因在对应细胞类型的平均活力/平均表达水平（由浅到深表示由低到高）。\n",
    "    - 标准化建议：对两种模态分别在基因内做归一化/缩放，并统一配色范围与刻度标注，避免误读。\n",
    "\n",
    "- **解读要点**\n",
    "    - 特异性：目标细胞类型中应出现“大且深色”的气泡（高检测率且高均值），体现标志基因的特异活跃/高表达。\n",
    "    - 跨模态一致性：ATAC 与 RNA 在相同细胞类型同时出现“大且深色”的气泡，提示开放染色质与活跃转录的一致。\n",
    "    - 不一致线索：ATAC 大深而 RNA 小浅，可能为预激活/时间滞后或远端增强子主导；反之则可能受技术噪声或区域定义影响。\n",
    "    - 稀疏与异质：小但深的气泡可能来源于少数高值细胞；大但浅的气泡提示普遍低水平活跃/表达。"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "5776c6e9-1f4e-4fce-943f-0a9f8067cafe",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": [
     "remove-input"
    ],
    "vscode": {
     "languageId": "r"
    }
   },
   "outputs": [],
   "source": [
    "# 4. 气泡图\n",
    "suppressWarnings({\n",
    "  suppressMessages({\n",
    "      if(exists(\"top10\")){\n",
    "          options(repr.plot.width = width, repr.plot.height = height)\n",
    "          assays=c(\"ATAC_activity\",\"RNA\")\n",
    "          p=list()\n",
    "          for(assay in assays){\n",
    "              DefaultAssay(sc)=assay\n",
    "              p[[as.character(assay)]]=DotPlot(sc, \n",
    "                                           features = unique(top10$feature),\n",
    "                                           cols=c(\"#E5E3E3\",\"#F0484A\")  # 从浅灰到深红的渐变\n",
    "                                          ) + \n",
    "              #scale_size(range = c(0.5, 6)) +   # 调整点的大小范围\n",
    "              # 修改颜色图例标题\n",
    "              guides(color = guide_colorbar(if(assay == \"ATAC_activity\"){title = \"Average Activity\"}else{title = \"Average Expression\"})) +\n",
    "              # 或者使用这种方式也可以\n",
    "              # labs(color = \"Average Activity\") +\n",
    "              theme(\n",
    "                  axis.text.x.bottom = element_text(\n",
    "                      angle = 45, \n",
    "                      hjust = 1, \n",
    "                      vjust = 1),\n",
    "                  panel.grid.major = element_blank(),  # 移除网格线\n",
    "                  panel.grid.minor = element_blank(),\n",
    "                  axis.line = element_line(colour = \"black\"),  # 添加坐标轴线\n",
    "                  legend.position = \"right\"  # 保留图例以查看效果\n",
    "              )\n",
    "          }\n",
    "          print(p[[1]])\n",
    "          print(p[[2]])\n",
    "          invisible(pdf(\"../result/cluster_Diff/Top10.GeneActivityandExpression.dotplot.pdf\", width=24, height=6))\n",
    "          invisible(print(p[[1]]))\n",
    "          invisible(print(p[[2]]))\n",
    "          invisible(dev.off()) \n",
    "          }else{\n",
    "              print(\"没有基因活力显著差异的基因，请降低显著性阈值\") \n",
    "          }\n",
    "  })\n",
    "})"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "1d2db698-854b-4b34-bd9f-00ddb359dab0",
   "metadata": {},
   "source": [
    "```{note}\n",
    "通过比较 scATAC-seq 数据计算的基因活力与 scRNA-seq 数据测得的基因表达水平，我们可以观察两者的一致性，这有助于我们理解染色质可及性与基因表达之间的潜在调控关系。同时，我们也可以通过观察经典 marker 基因的活性来验证细胞聚类的合理性。\n",
    "但是，这些基因活力值的稳定性不如 scRNA-seq 直接测量的表达结果，主要有两个原因：\n",
    "染色质数据本身具有较高的稀疏性；\n",
    "基因调控区域的开放程度与基因的实际表达水平并非简单的线性关系。\n",
    "尽管如此，这些基因活力数据仍然能够帮助我们较好地识别主要的细胞类型。但如果要将细胞进一步划分为更精细的亚群，仅依靠这种监督分析方法则较为困难。\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "2d7873a0-6141-4ede-87b8-0be643b9fb83",
   "metadata": {},
   "source": [
    "## 细胞分群间的相关性分析\n",
    "\n",
    "### 跨细胞类型相关性分析（RNA 与 ATAC 活力）\n",
    "\n",
    "- **分析目的**\n",
    "    - 量化不同细胞类型在转录表达与染色质可及性两层面的相似性，检验聚类/注释合理性，并比较跨模态一致性与差异。\n",
    "\n",
    "- **具体实现（与本代码一致）**\n",
    "    - 输入：`sc`（Seurat 对象）、`cell_types_all`（细胞类型列表）、`celltype_colname`（类型列名）。\n",
    "    - 数据来源：`sc@assays$RNA@data` 与 `sc@assays$ATAC_activity@data`（均为对数标准化数据）。\n",
    "    - 类型汇总（pseudobulk）：\n",
    "        - 对每个细胞类型，取细胞层面的行均值：`Matrix::rowMeans(...)`，生成基因×类型矩阵。\n",
    "        - 得到 `rna_avg`（尺寸约 25055 × n_types）与 `atac_avg`（约 19620 × n_types）。\n",
    "    - 相关性计算：\n",
    "        - 分别对 `rna_avg` 与 `atac_avg` 按类型维度计算 Spearman 相关：`cor(..., method = \"spearman\")`。\n",
    "        - 输出两个类型×类型相关性矩阵：`RNA` 与 `ATAC`，行列名均为 `cell_types_all`。\n",
    "    - 返回结果：`list(RNA = rna_mat, ATAC = atac_mat)`，用于热图可视化（附层次聚类与类型颜色条）。\n",
    "\n",
    "- **解读要点**\n",
    "    - 一致性：同谱系或功能相近的类型应在两张相关性热图中均表现出高相关。\n",
    "    - 跨模态对齐：同一类型在 RNA 与 ATAC 两个矩阵的相邻类型关系相似，支持注释可靠。\n",
    "    - 差异线索：RNA 高相关但 ATAC 低相关提示表观层面差异更明显或 ATAC 稀疏；反之可能反映预激活/时序差异。\n",
    "    - 异质性：相关性梯度或分支结构可提示亚群或连续谱状态。"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "5c2e4343-44e4-44dc-8c72-3db2f48880f6",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": [
     "remove-input"
    ],
    "vscode": {
     "languageId": "r"
    }
   },
   "outputs": [],
   "source": [
    "# 计算不同细胞类型间的RNA和ATAC相关性\n",
    "calculate_modality_correlations <- function(sc,cell_types,celltype_colname) {\n",
    "  \n",
    "  # 初始化存储矩阵\n",
    "  n_types <- length(cell_types)\n",
    "  rna_mat <- matrix(0, n_types, n_types)\n",
    "  atac_mat <- matrix(0, n_types, n_types)\n",
    "  \n",
    "  # 获取正确的基因数量\n",
    "  n_rna_genes <- nrow(sc@assays$RNA@data)    # 应该是25055\n",
    "  n_atac_genes <- nrow(sc@assays$ATAC_activity@data)  # 应该是19620\n",
    "  \n",
    "  # 初始化正确维度的平均值矩阵\n",
    "  rna_avg <- matrix(0, n_rna_genes, n_types)\n",
    "  atac_avg <- matrix(0, n_atac_genes, n_types)\n",
    "  \n",
    "  # 计算每个细胞类型的平均表达/可及性\n",
    "  for (idx in seq_along(cell_types)) {\n",
    "    current_type <- cell_types[idx]\n",
    "    \n",
    "    # 获取当前类型的细胞索引\n",
    "    cell_idx <- which(sc@meta.data[[celltype_colname]] == current_type) \n",
    "    # 计算平均值\n",
    "    rna_avg[,idx] <- Matrix::rowMeans(sc@assays$RNA@data[, cell_idx])\n",
    "    atac_avg[,idx] <- Matrix::rowMeans(sc@assays$ATAC_activity@data[, cell_idx])\n",
    "  }\n",
    "  \n",
    "  # 计算相关性\n",
    "  rna_mat <- cor(rna_avg, method = \"spearman\")\n",
    "  atac_mat <- cor(atac_avg, method = \"spearman\")\n",
    "  \n",
    "  rownames(rna_mat) <- colnames(rna_mat) <- cell_types\n",
    "  rownames(atac_mat) <- colnames(atac_mat) <- cell_types\n",
    "  # 设置行列名\n",
    "  rownames(rna_mat) <- colnames(rna_mat) <- cell_types\n",
    "  rownames(atac_mat) <- colnames(atac_mat) <- cell_types\n",
    "  \n",
    "  # 返回相关性矩阵\n",
    "  return(list(RNA = rna_mat, ATAC = atac_mat))\n",
    "}\n",
    "\n",
    "# 使用函数\n",
    "results <- calculate_modality_correlations(sc,cell_types_all,celltype_colname)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "658709ca-88b3-47af-8d07-7d80eda8a961",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": [
     "remove-input"
    ],
    "vscode": {
     "languageId": "r"
    }
   },
   "outputs": [],
   "source": [
    "options(repr.plot.width = 18, repr.plot.height = 4)\n",
    "# 定义通用可视化参数\n",
    "get_breaks <- function(mat) {\n",
    "    min_break <- floor(min(mat) * 10) / 10  # 最小值向下取整到0.1\n",
    "    seq(min_break, 1, length.out = 101)     # 固定最大值1\n",
    "}\n",
    "\n",
    "colors <- colorRampPalette(c(\"#4B2991\", \"#56B1F7\", \"#FCFFA4\", \"#F97B57\", \"#AB3282\"))(100)\n",
    "breaks <- get_breaks(c(results$RNA, results$ATAC))  # 统一计算色阶\n",
    "\n",
    "# 通用热图参数\n",
    "heatmap_config <- list(\n",
    "    color = colors,\n",
    "    breaks = breaks,\n",
    "    cluster_rows = FALSE,\n",
    "    cluster_cols = FALSE,\n",
    "    fontsize = 8,\n",
    "    border_color = NA,\n",
    "    silent = TRUE\n",
    ")\n",
    "\n",
    "# 生成热图\n",
    "suppressWarnings({\n",
    "    rna_plot <- do.call(pheatmap, c(list(mat = results$RNA, main = \"RNA Expression Correlation\"), heatmap_config))\n",
    "    atac_plot <- do.call(pheatmap, c(list(mat = results$ATAC, main = \"ATAC Accessibility Correlation\"), heatmap_config))\n",
    "    \n",
    "    # 展示并保存\n",
    "    grid.arrange(rna_plot$gtable, atac_plot$gtable, ncol = 2)\n",
    "    pdf(\"../result/modality_correlations.pdf\", width = 12, height = 6)\n",
    "    grid.arrange(rna_plot$gtable, atac_plot$gtable, ncol = 2)\n",
    "    dev.off()\n",
    "})"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "c31cb1a2-0d1d-47c4-9728-4a2be846b6d5",
   "metadata": {},
   "source": [
    "```{note}\n",
    "* **左图：** RNA 表达相关性热图，反映了不同 cluster 在转录组水平上的相似程度和异质性\n",
    "* **右图：** ATAC 可及性相关性热图，展示了染色质开放状态的相似性分布和异质性\n",
    "```"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "0a86d421-1bce-43ac-b6bc-f6dda72fc81a",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": [
     "remove-input"
    ],
    "vscode": {
     "languageId": "r"
    }
   },
   "outputs": [],
   "source": [
    "saveRDS(sc, file = \"../result/result.rds\")"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "60694d7d-d5d1-49b5-946a-e0571778f28a",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "source": [
    "## 结果文件\n",
    "\n",
    "├── ***cluster_Diff***         细胞分群间基因活力差异分析结果文件夹<br>\n",
    "│   ├── cluster_Diff_genes_activity.txt 所有细胞分群间基因活力差异分析结果汇总表格<br>\n",
    "│   ├── ***FeaturePlot***   降维图可视化每个细胞分群中差异倍数(logFC)top5 的基因活力情况<br>\n",
    "│   │   ├── feature_plot_cluster_ATAC_activity_*.pdf <br>\n",
    "│   │   ├── feature_plot_cluster_ATAC_activity_*.png <br>\n",
    "│   │   ├── feature_plot_cluster_RNA_*.pdf <br>\n",
    "│   │   └── feature_plot_cluster_RNA_*.png<br>\n",
    "│   ├── Top10.GeneActivityandExpression.dotplot.pdf  气泡图可视化每个细胞分群中差异倍数(logFC)top10 的基因活力和基因表达情况<br>\n",
    "│   ├── Top10.GeneActivityandExpression.heatmap.pdf   热图可视化每个细胞分群中差异倍数(logFC)top10 的基因活力和基因表达情况<br>\n",
    "│   └── Top10.GeneActivityandExpression.vlnplot.pdf  小提琴图可视化每个细胞分群中差异倍数(logFC)top10 的基因活力和基因表达情况<br>\n",
    "├── ***group_Diff***     组间基因活力差异分析结果文件夹<br> \n",
    "│   ├── *.*vs*.heatmap.Activity.pdf  热图展示组间差异基因活力<br>\n",
    "│   ├── *.*vs*.heatmap.Activity.png  热图展示组间差异基因活力<br>\n",
    "│   ├── *.*vs*.heatmap.Expression.pdf 热图上述基因对应的基因表达情况<br>\n",
    "│   ├── *.*vs*.heatmap.Expression.png 热图上述基因对应的基因表达情况<br> \n",
    "│   ├── *.*vs*.Volcano.pdf 火山图可视化组间基因活力差异情况<br>\n",
    "│   ├── *.*vs*.Volcano.png 火山图可视化组间基因活力差异情况<br>\n",
    "│   └── group_Diff_genes_activity.txt 所有细胞分群中组间差异分析结果的汇总<br>\n",
    "└── modality_correlations.pdf<br>\n",
    "\n",
    "结果目录：目录下包括此项分析所涉及的所有图片以及表格等结果文件\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "cb5c527e-89ad-4adb-bbf2-8ec24180df29",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "source": [
    "## 文献案例解析\n",
    "\n",
    "* 《Single-cell systems pharmacology identifies development-driven drug response and combination therapy in B cell acute lymphoblastic leukemia》\n",
    "  \n",
    "* 《Single-cell analyses reveal key immune cell subsets associated with response to PD-L1 blockade in triple-negative breast cancer》基于基因活力矩阵，对 scATAC-seq 数据进行细胞注释\n",
    "\n",
    "* 《A cis-regulatory atlas in maize at single-cell resolution》\n",
    "\n",
    "  在这项研究中，研究人员通过整合单细胞水平的 ATAC-seq 和 RNA-seq 数据，探究了玉米基因组中基因可及性与基因表达之间的关系。研究发现，在 36,322 个分析的基因中，大多数基因表现出基因可及性与转录活性的正相关关系（图 E、F、G、H）。然而，研究也发现约 6,063 个基因虽然具有较高的染色质可及性，但却没有显著的转录活性（图 H），这表明基因的可及性并不必然导致基因表达。为了解释这一现象，研究人员对基因进行了表观遗传学分析。结果表明，这些可及但不表达的基因富集了 H3K27me3 修饰（图 J）；相比之下，那些既不可及又不表达的基因（约 4,315 个）则主要通过 DNA 甲基化来维持其沉默状态。这一发现揭示了玉米基因沉默调控的两种主要机制，（1）通过 H3K27me3 修饰，对基因进行沉默；（2）依赖 DNA 甲基化来维持沉默状态\n",
    "\n",
    "\n",
    "\n",
    "\n",
    "## 参考资料\n",
    "\n",
    "[1] Stuart T, Srivastava A, Madad S, et al.Single-cell chromatin state analysis with Signac (vol 18, pg 1333, 2021)[J].Nature methods, 2022(2):19.\n",
    "[2] Hao Y, Stuart T, Kowalski M, et al.Dictionary learning for integrative, multimodal, and scalable single-cell analysis[J].bioRxiv, 2022.DOI: 10.1101/2022.02.24.481684."
   ]
  },
  {
   "cell_type": "markdown",
   "id": "059455e6-b826-4582-b83d-aa42d6a4594c",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "source": [
    "## 附录\n",
    "\n",
    ".txt ：结果数据表格文件，文件以制表符（Tab）分隔。unix/Linux/Mac 用户使用 less 或 more 命令查看；windows 用户使用高级文本编辑器 Notepad++ 等查看，也可以用 Microsoft Excel 打开。\n",
    "\n",
    ".pdf ：结果图像文件，矢量图，可以放大和缩小而不失真，方便用户查看和编辑处理，可使用 Adobe Illustrator 进行图片编辑，用于文章发表等。\n",
    "\n",
    ".rds : 包含基因活力 assay 的 Seurat 对象，需要在 R 环境中打开查看和用于进一步分析。"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "common_r",
   "language": "R",
   "name": "common_r"
  },
  "language_info": {
   "codemirror_mode": "r",
   "file_extension": ".r",
   "mimetype": "text/x-r-source",
   "name": "R",
   "pygments_lexer": "r",
   "version": "4.3.3"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}
