nuget
api documents
Conditional Probability Table (CPT) for a DBN node. Stores P(node_state | parent_states) for all combinations of parent states.
The table is indexed by a string key formed by joining parent state values with the "|" separator. Each entry contains a probability distribution over the child node's states.
线程安全：本类不是线程安全的。惰性求值时 GetDistribution 会向 Table 写入 记忆化结果，多个线程并发查询同一个节点会导致 Dictionary 损坏。 调用方需自行保证同一实例的访问是串行的（当前 DBN 的预测/传播链路均为串行）。
01 Syntax
02 Methods
| Name | Overloads | Summary |
|---|---|---|
| GetKey | 1 | Build the lookup key from an ordered list of parent state values |
| GetDistribution | 1 | Get the probability distribution over child states given a parent configuration. |
| SetDistribution | 1 | Set the probability distribution for a parent configuration |
| GetAllParentConfigurations | 1 | Enumerate all possible parent state combinations (Cartesian product). |
| GetConfigurationCount | 1 | 计算父配置的组合总数（各父节点状态数的乘积，默认 3 态即 3^P）。 结果达到 Integer.MaxValue 时提前饱和返回 Long.MaxValue：既避免溢出， 也直接给出"该节点的 CPT 无法完整展开"的判据。 |
03 Properties
| Name | Overloads | Summary |
|---|---|---|
| VariableId | 1 | ID of the variable (child node) this CPT belongs to |
| ParentIds | 1 | Ordered list of parent node IDs (order matters for key construction) |
| States | 1 | Discrete states of the child node (e.g., "Low", "Medium", "High") |
| Table | 1 | Probability table: key = "|"-joined parent states, value = probability array. |
| OnDemandProvider | 1 | 按需计算委托：表中不存在某个父配置时，用该委托现场计算其概率分布。 CPT 的行数等于各父节点状态数的乘积（默认 3 态即 3^P），父节点数不受限时 完整展开会直接耗尽内存。由于拓扑先验分布本身是一个纯函数（noisy-OR/AND 得分 的确定性映射），可以推迟到真正查询时再算，数学结果与全表展开完全一致。 该委托为 Nothing 时，缺失… |
| MaxCacheRows | 1 | 惰性求值时允许缓存（记忆化）的最大条目数。超过该上限后不再写入缓存， 每次查询都现场计算，避免稀疏缓存无限增长。 |
04 Members
List(Of String))Build the lookup key from an ordered list of parent state values
List(Of String), Boolean)Get the probability distribution over child states given a parent configuration.
查表顺序：Table → ConditionalProbabilityTable.OnDemandProvider（惰性求值并记忆化）→ 均匀分布。
| Name | Type | Description |
|---|---|---|
parentStates | List(Of String) | 父节点状态（顺序与 ConditionalProbabilityTable.ParentIds 一致） |
copy | Boolean | 是否返回副本。只读场景传 False 可避免每次查询都分配一个新数组 （初始化/学习/预测等热路径的调用量是配置数量的量级，省下的分配非常可观）。 注意：传 False 时返回的可能是表内部的数组引用，调用方不得修改其内容。 |
List(Of String), Double(), Boolean)Set the probability distribution for a parent configuration
| Name | Type | Description |
|---|---|---|
parentStates | List(Of String) | 父节点状态（顺序与 ConditionalProbabilityTable.ParentIds 一致） |
distribution | Double() | 概率分布（长度需与 ConditionalProbabilityTable.States 一致） |
copy | Boolean | 是否复制一份再保存。写入方持有的是刚生成的临时数组时传 False， 可以省掉一次等长数组分配与拷贝（在 3^P 量级的初始化热路径上非常可观）。 |
Dictionary(Of String, List(Of String)))Enumerate all possible parent state combinations (Cartesian product). Used for CPT initialization and parameter learning.
惰性求值（按"里程表"逐位进位产生配置），不再一次性构造出全部配置列表。 旧实现先把完整的 List(Of List(Of String)) 物化到堆上，其内存占用与最终 CPT 表同一量级，是初始化阶段内存峰值的主要来源之一；改为惰性后该部分峰值降为 O(P)。 产出顺序与旧实现保持一致（最后一个父节点变化最快），保证结果可复现。
Dictionary(Of String, List(Of String)))计算父配置的组合总数（各父节点状态数的乘积，默认 3 态即 3^P）。 结果达到 Integer.MaxValue 时提前饱和返回 Long.MaxValue：既避免溢出， 也直接给出"该节点的 CPT 无法完整展开"的判据。
ID of the variable (child node) this CPT belongs to
Ordered list of parent node IDs (order matters for key construction)
Discrete states of the child node (e.g., "Low", "Medium", "High")
Probability table: key = "|"-joined parent states, value = probability array. The array is aligned with the States list.
注意：当父节点较多、配置总数（3^P）超过 ConditionalProbabilityTable.MaxCacheRows 时， 该表只保存"实际被访问过的配置"（惰性求值 + 记忆化），而不是完整笛卡尔积。 缺失的配置由 ConditionalProbabilityTable.OnDemandProvider 现场计算，结果与完整展开等价。
按需计算委托：表中不存在某个父配置时，用该委托现场计算其概率分布。
CPT 的行数等于各父节点状态数的乘积（默认 3 态即 3^P），父节点数不受限时 完整展开会直接耗尽内存。由于拓扑先验分布本身是一个纯函数（noisy-OR/AND 得分 的确定性映射），可以推迟到真正查询时再算，数学结果与全表展开完全一致。 该委托为 Nothing 时，缺失配置回退为均匀分布（保持原有行为）。
惰性求值时允许缓存（记忆化）的最大条目数。超过该上限后不再写入缓存， 每次查询都现场计算，避免稀疏缓存无限增长。