APSIM模型扩展指南：如何为自带基础作物模型添加自定义模块

1次阅读

没有评论

共计 1803 个字符，预计需要花费 5 分钟才能阅读完成。

刚开始使用 APSIM 时，我发现自带的基础作物模型虽然覆盖了常见场景，但在实际研究中经常遇到这些限制：

新品种特性无法直接套用现有参数（如抗旱水稻的根系分布模式）
需要添加特殊生长阶段（如果树的花芽分化期）
现有光合作用模型不适用于垂直农场的光照条件

这些情况迫使我学习模块扩展，就像给乐高套装添加自定义零件。

APSIM 采用 Component-Interface 设计模式，可以把整个系统想象成一台模块化电脑：

核心组件：比如 Plant 就像 CPU，Soil 是硬盘，Weather 是网络模块
接口规范：组件间通过标准接口通信（如 ISoilWater 接收降水数据）
热插拔特性：只要遵循接口规范，新模块可以随时加入系统

新建 MyPhenology.xml 文件，这是模块的 ” 说明书 ”：

<component name="MyPhenology" version="1.0">
  <input name="BaseTemperature" unit="°C" default="10.0" description="生长起点温度"/>
  <output name="ThermalTime" unit="°Cd" description="累积热时间"/>
  <event name="NewStage" description="新生长阶段触发"/>
</component>

关键标签说明：

<input>：声明模块需要的输入参数
<output>：定义模块的计算结果
<event>：标记重要状态变化事件

创建 ThermalTimeCalculator.cs：

[Serializable]
public class MyPhenology : Model
{[Link] private IWeather weather; // 自动注入天气组件

    [Param] private double BaseTemperature {get; set;}
    [Output] public double ThermalTime {get; private set;}

    public override void OnDailyUpdate()
    {
        try {double meanTemp = (weather.MaxT + weather.MinT) / 2;
            ThermalTime += Math.Max(0, meanTemp - BaseTemperature);

            if (ThermalTime > 200) 
                PublishEvent("NewStage");
        }
        catch (Exception ex) {throw new Exception("积温计算失败", ex);
        }
    }
}

代码要点：

必须继承 Model 基类
[Link]实现依赖注入
[Output]标记需要暴露的变量
异常处理是必须的

症状：模型列表中看不到新模块
检查清单：
DLL 文件是否在 APSIM 的 bin 目录下
XML 文件名是否与类名一致
.NET 运行时版本是否匹配

当模块需要小时级计算时：

在 XML 中添加 <timestep>hourly</timestep> 声明
实现 OnHourlyUpdate() 方法
使用 Clock.Today 保持日期同步

[TestFixture]
public class PhenologyTests
{[Test]
    public void TestBaseTemperature()
    {var pheno = new MyPhenology();
        pheno.BaseTemperature = 5.0;
        // 模拟 10°C 日均温
        Assert.AreEqual(5.0, pheno.CalculateThermalTime(10)); 
    }
}