以下截图为 0.10.1 版本运行结果
本文为创建一个简单模板的初级教程,为了更好地理解模板参数如何影响结果的,首先将介绍模板的运行机制。
模板运行机制(初级)
对于初级模板而言,模板的运行分为三个阶段:输入(为输入变量赋值)->算式(实际的计算过程,为输出变量赋值)->输出(指定输出显示的变量),此处以『身体质量指数(BMI)』模板为例进行演示,此模板内置在计算器内,可以通过『查看模板』项查看模板参数。
输入
首先是输入部分,创建了两个输入,名称为实际在模板中显示的输入项名称,变量名为计算中实际使用的变量名,变量名的命名要求与计算器的变量命名要求一致(字母开头,可混合数字,长度不限,区分大小写)。
名称 | 变量名 | |
变量1 | 体重 | weight |
变量2 | 身高 | height |
例如我们在身高中填入170,体重填入70,则输入部分的计算如下:
weight = 70
height = 170
此时两个输入变量就初始化完成了。
算式
算式部分按顺序执行所有算式,对于本例我们只需要一个算式,注释不是必填项,不会在计算模板中显示,会在此项发生错误或查看模板时显示:
算式 | 注释 | |
算式1 | BMI = weight / ((height / 100) ^ 2) | BMI的计算方法为体重除以身高的平方,体重和身高的单位分别为千克、米。 |
执行算式会对BMI变量赋值。
输出
此处创建了一个输出,名称为实际在模板中显示的输出项名称,变量名为计算中实际使用的变量名,我们只将感兴趣的变量输出出来。
名称 | 变量名 | |
变量1 | BMI | BMI |
此部分不会运行算式,只将变量提取并显示结果。
创建一个简单的模板
接下来我们将创建一个计算球体积的简单模板,首先为模板设置模板名称为『球体积』,并填入注释(非必填)『根据半径计算球体积。』,模板名称和注释会在模板顶部显示。
对于本例而言,输入变量为球的半径:
名称 | 变量名 | |
变量1 | 半径 | r |
然后创建计算球体积的公式:
算式 | 注释 | |
算式1 | V = 4 / 3 * pi * r^3 | 计算球体积。 |
最后添加输出:
名称 | 变量名 | |
变量1 | 体积 | V |
在模板编辑器中编辑:
最后点击保存则可以在模板列表中使用此模板了:
尾声
对于模板的更高级用法,例如输入类型检查、默认值、约束等,请参考『哈冬猪科学计算器系列教程——创建自定义模板(高级)』。