Analysis API

`UQPyL.analysis`

analysis 模块评估输入变量如何影响目标或约束输出。

python

from UQPyL.analysis import RBDFAST, Sobol, Morris
from UQPyL.analysis.runtime import AnaReader

对象	作用
`Sobol`	基于 Saltelli 样本的方差分解敏感性分析。
`FAST`	基于 FAST 设计的 Fourier amplitude sensitivity test。
`RBDFAST`	可用于普通样本矩阵的一阶敏感性分析。
`Morris`	基于 elementary effects 的筛选方法。
`RSA`	Regional sensitivity analysis。
`DeltaTest`	基于近邻的变量敏感性分析。
`MARS`	MARS-based 分析；可选依赖不可用时可能为 `None`。
`AnaResult`	`analyze()` 返回的标准结果对象。
`AnaMetric`	`AnaResult` 中的一张指标矩阵。
`AnaReader`	读取 `saveFlag=True` 保存的 sqlite 结果。

text

result = method.analyze(
    problem,
    X,
    Y=None,
    meta=None,
    target="objs",
    index="all",
)

参数	含义
`problem`	`ProblemBase` 实例。
`X`	输入样本矩阵。
`Y`	与 `X` 对应的输出矩阵；不传时由方法内部评估。
`meta`	`sampleWithMeta()` 返回的采样元数据。部分方法必需。
`target`	分析输出块，通常为 `"objs"` 或 `"cons"`。
`index`	输出列选择：`"all"`、整数或整数列表。

运行控制参数：

方法	需要的样本设计	主要指标
`Sobol`	`SaltelliDesign.sampleWithMeta()`	`S1`, `S1_norm`, `ST`, `ST_norm`, 可选 `S2`
`FAST`	`FASTDesign.sampleWithMeta()`	`S1`, `S1_norm`, `ST`, `ST_norm`
`Morris`	`MorrisDesign.sampleWithMeta()`	`mu`, `mu_star`, `sigma`, `S1_norm`
`RBDFAST`	普通样本矩阵即可	`S1`
`RSA`	普通样本矩阵即可	`S1`, `S1_norm`
`DeltaTest`	普通样本矩阵即可	`S1`, `S1_norm`
`MARS`	普通训练式样本	`S1`, `S1_norm`

用于读取 analysis sqlite 结果。

方法	含义
`list_runs(result_dir)`	列出结果目录中的 analysis runs。
`get_run_summary()`	读取运行摘要。
`get_run_params()`	读取运行参数。
`get_metrics()` / `get_metric(name)`	读取指标。
`get_artifacts()`	读取 `X`、`Y`、`settings`、`meta` 等 artifact。
`load_problem()`	读取保存的问题对象。
`load_result()`	重建完整 `AnaResult`。