TreeAge Pro中文网站 > 新手入门 > TreeAge Pro怎么设置隧道状态 TreeAge Pro隧道状态持续周期怎么定义
教程中心分类
TreeAge Pro怎么设置隧道状态 TreeAge Pro隧道状态持续周期怎么定义
发布时间:2026/08/19 10:55:20

  在Markov模型中,同一个健康状态的转移概率可能会随着“进入该状态后的时间”发生变化,例如治疗后的前3个月复发风险较高,之后逐渐稳定。普通Markov状态难以直接记录这种状态内时间,TreeAge Pro因此提供Tunnel State,将一个状态内部拆分成多个连续的临时状态。处理“TreeAge Pro怎么设置隧道状态,TreeAge Pro隧道状态持续周期怎么定义”时,关键是理解Tunnel Max控制的是临时状态数量,而不是简单设置一个“停留N周期后自动退出”的时间参数。

  一、TreeAge Pro怎么设置隧道状态

 

  普通Markov状态转换为Tunnel State后,TreeAge Pro会在内部维护多个临时状态,并通过_tunnel记录个体已经处于该隧道中的第几个周期。这样可以让同一个状态在不同停留周期使用不同的转移概率或成本。

 

  1、把普通状态设置为隧道状态

 

  ①在Markov模型中选中需要处理的健康状态,例如“治疗后”“疾病进展期”或“术后恢复期”。

 

  ②打开【Views】→【Markov】,进入当前状态的Markov参数设置区域。

 

  ③找到【Tunnel Max】,填写需要建立的临时状态数量。

 

  ④如果需要4个连续临时状态,就把【Tunnel Max】设置为【4】。

 

  ⑤保存模型后重新运行Markov分析,检查该状态是否按照多个临时状态参与计算。

 

  TreeAge Pro官方说明中,【Tunnel Max】决定_tunnel能够递增到的最大值,也决定软件内部为这个Tunnel State维护多少个临时状态。

 

  2、理解_tunnel计数方式

 

  进入Tunnel State时,TreeAge Pro会从_tunnel=1开始计数。如果个体下一周期仍然留在这个状态,则进入_tunnel=2,之后依次增加。

 

  因此可以把它理解为:

  这里不要把【_tunnel】和【_stage】混淆。【_stage】表示整个Markov模型运行到了第几个周期,而_tunnel表示当前个体进入这个Tunnel State后已经经历到第几个临时状态。即使患者在模型运行第20周期才进入该状态,其_tunnel仍会从1开始。

 

  二、TreeAge Pro隧道状态持续周期怎么定义

 

  隧道持续时间主要由【Tunnel Max】、模型周期长度和状态转移逻辑共同决定。只设置Tunnel Max,并不一定意味着到达最后一个周期后系统会强制退出。

 

  1、先根据模型周期换算Tunnel Max

 

  如果模型每个Markov周期代表1个月,那么希望区分进入状态后的前6个月,可以把【Tunnel Max】设置为【6】。

 

  如果每个周期代表3个月,而需要区分第一年的状态变化,则通常需要4个临时状态,也就是把【Tunnel Max】设置为【4】。

 

  ①先明确模型的【周期长度】。

 

  ②再确定需要单独描述多长时间的状态内变化。

 

  ③用需要描述的持续时间换算成临时状态数量。

 

  ④将得到的临时状态数量填写到【Tunnel Max】。

 

  Tunnel Max应设置为能够描述实际差异的最小数量。如果只有前4个周期的风险不同,从第4周期以后概率保持不变,一般没有必要建立几十个临时状态。TreeAge Pro官方也建议按照实际需要变化的周期数量确定Tunnel Max。

  2、使用_tunnel设置逐周期转移概率

 

  建立Tunnel State以后,所有临时状态共用同一套Transition Subtree,因此不同周期的概率通常通过【_tunnel】进行区分。

 

  ①建立包含各周期概率的数据表,例如第1到第4周期分别设置不同复发概率。

 

  ②在状态转移概率中使用【_tunnel】作为表格索引。

 

  ③第1个临时状态读取第1行,第2个临时状态读取第2行,依次类推。

 

  例如官方示例采用类似下面的方式读取不同周期死亡概率:

  这样不需要手工创建“治疗后第1期、治疗后第2期、治疗后第3期”等多个独立Markov状态,也能实现状态内时间依赖。

 

  3、需要固定周期后退出时还要调整转移

 

  这是Tunnel State设置中比较容易理解错误的地方。【Tunnel Max=4】并不代表进入第4个周期后一定自动离开。

 

  TreeAge Pro规定,当个体已经处于最后一个临时状态,如果转移逻辑仍让它再次进入同一个Tunnel State,它会继续留在最后一个临时状态,而_tunnel不会继续增加。

 

  如果业务模型要求“最多停留4个周期,第4周期结束必须退出”,需要额外设置转移规则:

 

  ①把【Tunnel Max】设置为【4】。

 

  ②对_tunnel为1至3时保留正常的“继续停留”概率。

 

  ③当【_tunnel=4】时,将继续留在该状态的概率调整为【0】。

 

  ④将第4周期的概率分配到其他目标状态,并保证该分支下转移概率关系正确。

 

  这样定义的才是“固定4周期后退出”,而不是单纯建立4个临时状态。

 

  三、隧道状态设置后怎么检查周期是否正确

 

  Tunnel State能够正常运行后,还要确认实际人群是否按照预期在各临时状态之间移动,特别是存在重新进入、长期停留或不同周期概率变化时。

 

  1、检查各周期状态人数

 

  ①运行【Markov Cohort】分析,查看状态概率变化。

 

  ②分析结果出现是否合并Tunnel临时状态的选项时,调试阶段可以选择【不合并】,分别观察各个临时状态。

 

  ③检查进入状态后的个体是否依次从第1个临时状态移动到第2、第3个临时状态。

 

  ④如果大量个体一直停留在最后一个临时状态,重新检查最后周期的自循环转移概率。

 

  TreeAge Pro默认可以把多个临时状态合并为一条状态结果,也可以展开查看各临时状态,因此模型验证阶段更适合先查看展开结果。

 

  2、重新进入状态时注意计数重置

 

  个体离开Tunnel State后再次进入,通常会重新从_tunnel=1开始。如果模型希望两个不同Tunnel State之间切换时仍连续记录隧道时间,则需要使用【Tunnel Crossover】等Markov Binding处理,而不能单纯依赖普通状态跳转。

 

  因此,建模时要先确定研究的是“本次进入该状态后的持续时间”,还是“跨多个相关状态累计的持续时间”,两种需求采用的结构并不完全相同。

  总结

 

  Tunnel State的价值在于为传统Markov模型补充状态内时间信息,使转移风险、成本或效用能够随着停留时间变化。建模时尤其要区分“临时状态数量”和“强制停留期限”,否则很容易把Tunnel Max误解为自动退出时间。模型完成后通过展开临时状态检查人群流动,可以更早发现持续时间与实际研究假设不一致的问题。如需进一步了解TreeAge Pro隧道状态设置、持续周期定义与Markov状态转移建模,欢迎联系咨询。

读者也访问过这里:
135 2431 0251