模拟与分析软件：EnergyPlus二次开发_（7）.用户自定义功能开发.docx

PAGE1

PAGE1

用户自定义功能开发

在EnergyPlus的二次开发中，用户自定义功能开发是一个非常重要的环节。通过用户自定义功能，用户可以扩展EnergyPlus的模拟能力，实现特定的分析需求。这一节将详细讲解如何在EnergyPlus中实现用户自定义功能，包括自定义输入输出、编写用户自定义模型（UserDefinedModel,UDM）以及如何将自定义功能集成到EnergyPlus中。

自定义输入输出

EnergyPlus提供了多种方式来扩展和自定义输入输出功能。这些功能可以帮助用户更灵活地管理模拟数据，例如添加新的输入参数、修改现有参数的处理方式或生成自定义的输出报告。下面将详细介绍如何实现这些自定义功能。

添加新的输入参数

在EnergyPlus中，新的输入参数可以通过修改输入文件（IDF）来实现。具体步骤如下：

定义新的输入对象：在IDF文件中定义新的对象，并指定其参数。

修改EnergyPlus的输入处理代码：编写C++代码来处理新的输入参数。

编译和运行：编译EnergyPlus并运行模拟，验证新参数的正确性。

示例：添加新的输入参数

假设我们需要在EnergyPlus中添加一个新的输入参数，用于控制某个特定设备的运行模式。具体步骤如下：

定义新的输入对象：在IDF文件中添加一个新的对象，例如MyDevice。

!Exampleofanewinputobject

MyDevice,

Device1,!-Name

100,!-Power

On;!-Mode

修改输入处理代码：在EnergyPlus的C++源代码中，找到输入处理的部分，添加对新对象的处理代码。

//File:MyDevice.cpp

#includeMyDevice.hpp

#includeidd/MyDevice.idd

#includeModel.hpp

voidMyDevice::readInput(constWorkspaceObjectworkspaceObject){

name=workspaceObject.getString(MyDeviceFields::Name);

power=workspaceObject.getDouble(MyDeviceFields::Power);

mode=workspaceObject.getString(MyDeviceFields::Mode);

}

voidMyDevice::initialize(){

//Initializethedevicebasedontheinputparameters

if(mode==On){

//Deviceison

}elseif(mode==Off){

//Deviceisoff

}else{

//Invalidmode

logSevere(Invalidmodefordevice:+name);

}

}

编译和运行：编译EnergyPlus并运行模拟，验证新参数的正确性。

修改现有参数的处理方式

有时候，用户可能需要修改EnergyPlus中现有参数的处理方式。这可以通过修改EnergyPlus的源代码来实现。具体步骤如下：

找到现有参数的处理代码：在EnergyPlus的源代码中找到处理该参数的代码段。

修改代码：根据需求修改代码，确保新的处理方式符合逻辑。

编译和运行：编译EnergyPlus并运行模拟，验证修改后的参数处理是否正确。

示例：修改现有参数的处理方式

假设我们需要修改某个设备的功率计算方式。具体步骤如下：

找到现有参数的处理代码：在EnergyPlus的源代码中找到处理该设备功率的代码段。

//File:ExistingDevice.cpp

doubleExistingDevice::calculatePower()const{

returnpower*efficiency;

}

修改代码：根据需求修改功率计算方式。

//File:ExistingDevice.cpp

doubleExistingDevice::calculatePower()const{

//Newcalculationmethod

returnpower*efficiency*0.9;//Applya10%reductionfac