一个简单的 Python 函数示例
Python 通常用于扩展 TreeAge Pro,不过我们先从一个简单示例入手,该示例实际上并不需要用到 Python。具体来说,我们将创建一个 Python 的 Discount 函数,然后对照内置的 Discount 函数进行验证。
特殊功能/Python(Special Features/Python)教程示例模型 Python Example – Discount.trex 包含两个策略(strategy)。您现在可以打开该模型。
重要提示:打开含用户自定义 Python 函数的模型时,系统会提示您启用 Python 脚本。这样您就能查看从不明来源获得的模型中包含的 Python 脚本(在模型中搜索“def ”和“python”)。 树中使用的这类 Python 命令不构成安全问题,但 Python 核心语言确实具备文件访问与互联网访问方法,理论上可能被滥用。 要关闭“Do you want to enable python scripts?”对话框,请转到窗口 > 应用程序首选项(Application Preferences),然后依次进入分析工具 > Python(Analysis Tools > Python),勾选“Do not show enable Python question”复选框。 |

上方策略的收益值引用 Python 函数 PythonDiscount,下方策略的收益值引用 TreeAge 内置函数 Discount()。回推(rollback)模型后可以看到两者取值相同。
Python 函数在变量定义中创建。本例在变量视图(Variables View)中于根节点处定义了名为 PythonDiscount 的变量。下图显示如何使用添加/修改变量(Add/Change Variable)对话框编辑 Python 函数。

在添加/修改变量对话框中,您会看到在“构建表达式”(Build Expression)上方选中了 Python 编辑器(Python Editor)选项。TreeAge Pro 之所以将该定义识别为 Python 函数,是因为它以关键字 def 开头。如果您要自行创建函数,请自行选择此编辑器选项。Python 编辑器模式允许使用必需的缩进并能识别 Python 关键字,从而帮助您编写 Python 代码。
Python 函数必须以函数声明 def 开头,其后是函数名,然后是圆括号,最后是冒号。如果函数需要参数,参数放在圆括号内,以逗号分隔。
def PythonDiscount(val, years, rate):
请注意,Python 函数名必须与树中的变量名一致,并且 Python 区分大小写。PythonDiscount 函数需要三个必需参数,调用函数时必须提供这些参数。
函数声明之后的 Python 代码必须用制表符或空格缩进,以表明这段代码包含在整体 Python 函数之内。Python 通过缩进识别代码块。如需把一段代码置于某个逻辑条件内,也要再增加一层缩进。
每行代码应以分号结尾,不过分号是可选的。要为代码添加注释,请在注释行开头输入“#”。return 语句用于从函数返回值。此处返回的是折现后的数值。函数结束位置是隐含的。
在树视图中,用户自定义函数定义以“(F)”为前缀。除非在变量显示(Variables Display)首选项中打开自动换行,否则只显示声明行。

有关 Python 语言与语法的更多信息,请访问 http://www.python.org/。