TP TreeAge Pro中文帮助中心

Tree( ) 函数(The Tree( ) Function)

TreeAge Pro 包含多种特殊函数,在复杂模型中十分有用。下面几节将介绍这些函数,包括 Node()、Tree()、User() 和 Global()。

Tree() 函数使您能够返回另一棵树中的计算值。例如,您可以为治疗某种疾病的各个特定策略分别建立两个独立的马尔可夫模型,然后再建立第三棵树,其中包含一个决策节点,用 Tree() 函数分别引用每个策略树。

Tree() 函数是 TreeAge 提供的若干函数之一,这些函数接受双引号括起的字符串参数,而不只是可按数值求值的参数。不过,与所有函数一样,Tree() 函数返回的仍是一个数值。

在本文档中,这种树与树的关系被描述为:由调用树(calling tree)使用 Tree 函数访问目标树(target tree)。

建议在复杂模型中使用 Tree() 函数之前,先在简单模型中仔细测试。

Tree() 函数的语法如下表所述:

函数语法 说明

Tree( "target tree"; "calculation" )

打开指定树文件或包文件的隐藏副本,并返回指定计算的结果。

目标树会保持打开状态,以便后续的 Tree() 函数调用继续使用。

"target tree" 参数指定要打开用于计算的目标树的路径和文件名。不过,如果该文件与调用树位于同一目录,则只需提供文件名。

"calculation" 参数定义要在目标树上执行的计算。通常此处会使用 Node() 函数,以便计算目标树中的某个特定节点。

用法示例:utilXYZ = Tree( "c:\my docs\projects\xyz.tre"; "Node(1;0)")

在此例中,Node() 函数在目标树的根节点处执行一次简单的期望值计算。

Tree( "target tree"; "calc"; 1 )

与上文相同,但如果目标树已打开且可见,则计算完成后会保留该链接关系;这样便可对可见的目标树使用回推(rollback)等分析命令进行调试。

请注意,若使用此选项,传递给目标树的变量将保留下来,供后续对该树的调用使用。如果您稍后要以其他变量定义调用该目标树,请不要使用第三个参数。

Tree( "calculation" )

可在 Tree() 函数求值过程中使用,以便在当前目标树的根节点处执行指定的计算。

Tree( integer 0 )

关闭所有已打开的隐藏目标树。例如,如果您通过文件菜单打开了某个目标树并对其做了修改保存,可使用此语法;这样下次调用 Tree() 函数时,将从磁盘重新加载该目标树文件。

当该函数打开/访问某个目标树时,通常会建立一个临时链接:目标树的根节点成为调用节点的“子节点”。Tree() 函数的强大之处在于,目标树可以使用来自调用树或调用节点左侧的变量定义。这与克隆子树中的变量用法非常相似。其诀窍在于:变量可以在目标树中被引用,而自身没有任何定义;定义可以放在调用树中。请注意,变量名必须已在目标树的变量(Variables)列表中声明,尽管它不会在目标树中被定义。必须在回推之前打开目标树,才能建立这种活动连接。

该函数的主要用途是实现复杂树的模块化。例如,在某些模型中会创建成百上千个马尔可夫模型的克隆副本,造成很高的内存占用,此时可用该函数作为替代方案。举例来说,1000 个终端节点的收益值都可以使用 Tree() 函数计算同一个马尔可夫模型,只是变量定义各不相同(而不必挂接 1000 个马尔可夫子树克隆)。在大多数模型中,如果不使用 Tree() 函数而改用克隆,计算速度会更快;隐藏树中引用调用树所定义变量的表达式无法被优化。不过,使用克隆(或普通副本)有时会使树的内存需求超出可用的物理内存,导致计算速度急剧下降。此时,构建由 Tree() 函数链接的较小树模型将是很好的解决方案。

下面的示例使用了三个 Special Features 教程示例:Tree Function Syntax.trex、Node Function Syntax.trex 和 Node Function Variable.trex。

  • Tree Function Syntax:作为调用树,使用 Tree 函数调用另外两棵树。

  • Node Function Syntax:自包含的树,在 Lottery 节点处被引用。

  • Node Function Variable:与上一项相同,区别在于它需要从 Tree Function Syntax 树接收变量 GetDefFromParent 的定义。

我们来看 Tree Function Syntax 树——上方是其语法,下方是回推结果。

Tree 0 终端节点调用 Node Function Syntax 树在 Lottery 节点处的期望值,得到数值 500。

Tree 1 终端节点在 Node Function Syntax 树的 Lottery 节点处运行 100 次试验,得到的值接近 500,但不等于 500。

Tree 2 终端节点在 Node Function Variable 树的 Lottery 节点处运行 100 次试验。GetDefFromParent 的变量定义(10,000)会从该节点传递给 Node Function Variable 树。这样得到的值接近 5,000,但不一定等于 5,000。

Tree 3 终端节点调用 Node Function Variable 树在 Lottery 节点处的期望值。GetDefFromParent 的变量定义(1,000)会从该节点传递给 Node Function Variable 树。这样得到的值为 500。

Tree 4 终端节点调用 Node Function Variable 树在 Lottery 节点处的期望值。GetDefFromParent 的变量定义(100,000)会从该节点传递给 Node Function Variable 树。这样得到的值为 50,000。由于 Tree 函数包含第三个参数(1),从该树到目标树的连接得以保留,因此您可以在 GetDefFromParent 变量定义保持有效的情况下回推 Node Function Variable 树。

上图中,Win 节点处的收益值表达式为 GetDefFromParent。基于从 Tree Function Syntax 树传入且保持有效的变量定义,其求值结果为 100,000。

Legal 教程示例模型 Legal-MainTree.trex 和 Legal-Subtree.trex 中有一个更简单、或许也更贴近实际的示例。在该例中,子树用于确定证明过失的概率,主树随后将该概率引入考虑损害赔偿的更大法律模型。

子树的返回结果为证明过失的概率 0.56,该值随后用于主树中的变量 pWin。