AracneOptions {SMRUCC.genomics.Model.Network.Regulons.ARACNE} .NET clr documentation

AracneOptions

Description

ARACNE 网络推断的参数配置。

所有的参数都带有合理的默认值,无参构造即可跑通完整的流程:

 MI(高斯 copula) -> 置换阈值(tau) -> DPI 去间接边 -> TF 定向

Declare

            
# namespace SMRUCC.genomics.Model.Network.Regulons.ARACNE
export class AracneOptions {
   # MiEstimator.AdaptivePartitioning 所使用的 bin 数量上限, 小于或者等于零的时候按照样本数量自动推算 round(sqrt(n)) (结果被限制在 [4, 64] 之内)。
   adaptiveMaxBins: integer;
   # MiEstimator.AdaptivePartitioning 之中每个 bin 的最小点数, 小于或者等于零的时候自动推算。
   adaptiveMinPoints: integer;
   # 边的方向赋予策略,默认 DirectionMode.TfDirected。
   directionMode: DirectionMode;
   # DPI 最多迭代多少轮,默认 5 轮。
   # 
   # 每一轮内部都是基于当轮开始时的邻接关系做判定(与参考实现一致的“单轮判定”语义), 被剔除的边会在该轮结束之后统一生效;如果某一轮没有任何边被剔除, 或者已经达到轮数上限,则停止迭代。
   dpiMaxPasses: integer;
   # DPI 的执行策略。
   # 
   # 为空(默认)的时候根据是否提供了 TF 列表自动选择: 提供了 TF 列表则使用 DpiMode.TfGuided,否则使用 DpiMode.Standard。
   dpiMode: Nullable`1;
   # MiEstimator.EqualFrequencyHistogram 所使用的等频 bin 数量,默认 4。
   histogramBins: integer;
   # MiEstimator.KernelDensity 的高斯核带宽, 小于或者等于零的时候使用 Silverman 经验公式自动推算。
   kernelBandwidth: double;
   # MiEstimator.KernelDensity 允许的最大样本数量(默认 2000)。
   # 
   # 核密度估计的计算量是 O(n^2),超过这个数量的时候会随机抽取样本 (固定随机种子,结果可复现)或者退回 MiEstimator.GaussianCopula。
   kernelMaxSamples: integer;
   # 是否对表达量做 log2(x + 1) 变换,默认关闭 (从 Matrix 读入的数据通常已经是 log 尺度)。
   log2Transform: boolean;
   # 并行计算互信息的最大并发度,小于或者等于零的时候由运行时决定。
   maxDegreeOfParallelism: integer;
   # 按照方差保留变化最剧烈的若干个基因,默认 0(保留全部)。
   # 
   # 真实的单细胞表达矩阵动辄两万个基因,全部纳入推断既慢又没有意义, 建议取 1000 ~ 3000。
   # 
   # 注意:AracneOptions.transcriptionFactors 之中列出的基因不受这个上限的 截断(转录因子是调控网络的起点,即使方差排名靠后也必须保留), 因此最终保留的基因数量可能略多于本参数。
   maxGenes: integer;
   # 每一个调控因子最多保留多少条最强的边(top-K 剪枝),默认 0(不剪枝)。
   # 
   # 剪枝可以显著压低 DPI 三元组的数量以及内存占用, 建议在大规模数据之上取 100 ~ 500。
   maxNeighbors: integer;
   # 互信息的估计方法,默认为 MiEstimator.GaussianCopula。
   miEstimator: MiEstimator;
   # 只保留在至少这个比例的样本之中有表达的基因,默认 0(不做过滤)。
   minNonZeroRatio: double;
   # 有效的最小样本数量要求,样本数少于这个数值的时候直接抛出异常。
   minSamples: integer;
   # MiThresholdMode.Fixed 模式之下的互信息阈值,默认 0(不做过滤)。
   miThreshold: double;
   # 置换零分布所采样的基因对数量,小于或者等于零的时候自动推算。
   permutationPairs: integer;
   # 置换零分布所取的分位数,默认 0.95(readme 建议 95% 或者 99%)。
   permutationQuantile: double;
   # 置换零分布之中每个基因对的打乱次数,默认 1。
   # 
   # 每一次打乱都会对基因对的两个表达向量分别独立洗牌, 因此即使取 1 也已经完全破坏了基因之间的依赖结构。
   permutationReplicates: integer;
   # 参与推断的最低先验置信度(资格门槛),默认 0.45(即 Low 及以上)。
   # 
   # 低于这个门槛的先验关系会被完全忽略(既不放宽阈值,也不保护); 达到门槛之后,保护的强度仍然与置信度成正比,见 AracneOptions.priorProtectionMode。
   priorMinConfidence: double;
   # curated 数据库之中的 TF -> TargetGene 调控关系先验(可选)。
   # 
   # 提供之后会启用四项基于先验的算法优化(readme 第四章的进一步工程化):
   # 
   # 
   # 
    #
  1. 计算空间补全:先验之中出现、但是转录因子列表没有覆盖的调控因子 会被自动补充进 TF 集合(由 AracneOptions.priorTfAugment 控制), 避免因为 TF 注释不全而漏掉真实的调控因子;
  2. #
  3. 阈值放宽:先验支持的基因对即使互信息低于置换阈值 tau, 只要高于 tau * priorThresholdFactor 也会被保留下来, 用于召回被严格阈值切掉的弱调控关系;
  4. #
  5. top-K 保护:先验支持的边不受 AracneOptions.maxNeighbors 剪枝的影响;
  6. #
  7. DPI 保护:先验支持的边不会被 DPI 判定为间接边而剔除, 这正是 ARACNE 的一个已知缺陷(反馈环路或者协同调控之中, 真实的直接边可能弱于传递边)。
  8. #
# # # 另外,先验的因果符号(激活 / 抑制)会被写入输出边的 AracneEdge.regulation 字段。 # # 需要强调的是:上述保护与放宽的强度是按先验的置信度分级的 (见 AracneOptions.priorProtectionMode 与 AracneOptions.priorProtectionStrength), 高置信度的边享有更大范围的保护窗口,低置信度的边只享有很窄的窗口, 数据证据明显不足的时候仍然会被 DPI 剔除。 priorNetwork: RegulatoryEdge[]; # 先验边在 DPI 判定之中所受保护的分级方式,默认 PriorProtectionMode.Graded。 priorProtectionMode: PriorProtectionMode; # 分级保护的强度,取值 0~1,默认 0.5。 # # 定义 DPI 的“保护窗口”:记标准容差为 eps、先验置信度为 c,则 # # #
 标准容差      : eps
   #  保护后的容差  : eps + (1 - eps) * priorProtectionStrength * c
# # # 一条先验边只有在“比另外两条边弱超过这个容差”的时候才会被 DPI 剔除, 也就是说置信度越高,允许它偏离直接关系证据的幅度越大: # # #
    #
  • c = 0.95 (High)、strength = 0.5:容差从 0.10 放宽到约 0.53;
  • #
  • c = 0.70 (Medium):容差放宽到约 0.42;
  • #
  • c = 0.45 (Low):容差放宽到约 0.30。
  • #
# # # 取 1 表示满置信度的先验边永远不会被 DPI 剔除(二值保护), 取 0 表示只按标准容差判定(等价于不保护)。 priorProtectionStrength: double; # 是否把先验之中的调控因子自动补充进 TF 集合,默认开启。 # # 转录因子注释(TF 列表)本身也可能不完整,而 curated 先验之中的调控因子 从定义上就是转录因子,因此把它们并入 TF 集合可以同时改善 计算空间的覆盖度与 DPI/定向的语义。 priorTfAugment: boolean; # 先验支持的边所使用的放宽阈值系数(置信度取满时的值),默认 0.5。 # # 置信度为 c 的先验边,其实际阈值是 # # #
 tau_prior(c) = tau * (1 - (1 - priorThresholdFactor) * c)
# # # 也就是说:c = 1 的时候门槛降到 tau * priorThresholdFactor, 而置信度很低的先验几乎享受不到放宽(tau_prior ~ tau)。 取 1 表示完全不放宽,取 0 表示满置信度的先验只要互信息为正就保留。 priorThresholdFactor: double; # 是否保护先验支持的边不被 DPI 剔除,默认开启。 # # 关闭等价于 PriorProtectionMode.Off。 protectPriorEdges: boolean; # 置换抽样与核密度抽样所使用的随机种子,固定种子保证结果可以复现。 randomSeed: integer; # 是否把表达量转换成秩(rank)之后再计算互信息,默认关闭。 # # 开启之后 copula 估计器等于计算 spearman 相关,对表达量的单调变换 与离群值更加稳健(单细胞数据的零膨胀会让 pearson 相关明显偏低)。 rankTransform: boolean; # 是否关闭推断过程之中的进度与阶段统计输出。 silent: boolean; # 是否在计算互信息之前把每一个基因的表达向量标准化(z-score),默认关闭。 # # 高斯 copula 估计器内部总是会做中心化与标准化(等价于计算 pearson 相关), 因此这个开关主要影响离散化/核密度估计器。 standardize: boolean; # 互信息显著性阈值 tau 的确定方式,默认 MiThresholdMode.Permutation。 thresholdMode: MiThresholdMode; # DPI 的容差比例 epsilon,默认 0.1(与 ARACNE 论文一致): 最弱的边必须比另外两条边都低超过 10% 才会被判定为间接边, 接近平局的三元组会保留下来。 tolerance: double; # 转录因子列表(基因编号,大小写不敏感)。 # # 提供之后会启用三项优化(readme 第四章): # # #
    #
  1. 计算空间缩减:互信息只需要计算 TF x All 与 TF-TF, 计算量由 O(N^2) 降为 O(T * N);
  2. #
  3. TF 导向的 DPI:见 DpiMode.TfGuided;
  4. #
  5. 方向赋予:见 DirectionMode.TfDirected。
  6. #
# # # 为空或者为空数组的时候按全基因 N x N 的上三角计算。 transcriptionFactors: string; }

.NET clr type reference tree

  1. use by property member directionMode: DirectionMode
  2. use by property member dpiMode: Nullable`1
  3. use by property member miEstimator: MiEstimator
  4. use by property member priorNetwork: RegulatoryEdge
  5. use by property member priorProtectionMode: PriorProtectionMode
  6. use by property member thresholdMode: MiThresholdMode

[Package {$package} version {$version} Index]