API Reference

Inference API

Inference API

UQPyL.inference

inference 模块对标量 Problem 运行 MCMC 风格采样。

导入

python
from UQPyL.inference import MH, AMH, MH_Gibbs, DEMC, DREAM_ZS, InfReader

公共对象

对象作用
MHMetropolis-Hastings。
AMHAdaptive Metropolis-Hastings。
MH_Gibbs坐标式 Gibbs/MH 更新。
DEMCDifferential Evolution MCMC。
DREAM_ZSDREAM(ZS) 风格采样器。
Chain单条链的运行状态。
InfResult推断结果对象。
InfHistory推断历史。
InfReader读取保存的推断 sqlite。

通用调用

text
result = method.run(problem, gamma=0.2, seed=123)
参数含义
problem标量输出 Problem
gammaproposal scale,可以是标量、向量或 (nChains, nInput) 矩阵。
seed随机种子。

构造函数常用参数:

参数含义
nChains链数。
warmUpwarm-up 长度。
maxIters / maxIterTimes最大迭代次数。
logProbFunc自定义对数概率函数。
verboseFlag, logFlag, saveFlag运行输出和保存控制。

方法选择

方法适合场景
MH简单标量问题的默认起点。
AMHproposal scale 难手动固定时。
MH_Gibbs每次更新一个变量更稳定时。
DEMC多链共享差分 proposal。
DREAM_ZS更复杂后验形状和 archive-based proposal。

InfResult

字段含义
decs参数样本,shape 为 (n_chains, draws, n_input)
objs目标值,shape 为 (n_chains, draws, n_output)
cons约束值,无约束时为 None
logProb对数概率,shape 为 (n_chains, draws)
acceptedaccepted proposal 标记。
feasibleMask可行性标记。
acceptanceRate每条链的接受率。
bestDecs, bestObjs, bestCons最佳样本及其输出。
FEs, iters函数评估次数和迭代数。
history运行历史。
summary()摘要字典。

InfReader

方法含义
list_runs(result_dir)列出保存的推断结果。
get_run_summary()读取摘要。
get_run_params()读取参数。
list_snapshots()列出快照。
load_last_snapshot_members()读取最后快照的链成员。
load_result()重建 InfResult

下一步

目标阅读
用户指南Inference
标量问题定义Problem API
校准工作流Calibration API