在TransCAD中如何编译和使用定制的VDF动态链接库.docVIP

在TransCAD中如何编译和使用定制的VDF动态链接库 杨齐 CALIPER 公司 　　TransCAD已经有几个现成的流量延误函数（VDF）可供用户在交通分配时选择，其中包括Akcelic Flow Delay、Bureau of Public Road (BPR)、Conical Congestion、Generalized Cost 和 Logit Delay 函数。用户还可以自己创建流量延误函数的动态链接库，用来解决特别的交通分配问题。这里我们用Visual Studio 2003版本（所谓的7.0版）为例（但你也可以用Visual Studio 6.0版或2005版本，手册中例子在用Visual Studio 2005版编译时需要在个别地方作适当修改，如果你是用的是2005版且需要我们提供更新的文件，请email与chi@联系）。 　　在Microsoft Visual Studio中创建VDF编译环境 　　在Visual Studio 2003选择File－New－Project，创建一个新的Project。选择General Custom Winzard。在Name编辑栏输入VDF，在Location编辑栏输入“C:\Program Files\TransCADv\GISDK”，如下图所示： 　　这里我们假定你的TransCAD是安装在“C:\Program Files\TransCAD”下面，而你自己的VDF文件要存储在它下面的GISDK文档里面。 　　单击OK，弹出的下一个Application Settings对话框。 　　单击Application Settings 显示应用程序定制界面。在Application type单选列表选择DLL类型。在Additional options选择Empty project。最后点击Finish。Visual Studio在你指定的 “C:\Program Files\TransCAD\GISDK”下面的VDF文档里生成几个文件，其中最重要的是vdf.vproj文件。你后面将在这个文件中定义定制VDF的编译环境。 　　原先在GISDK\VDF文档里，TransCAD已经安装了创建用户自己的VDF所需要的两个文件（VDFDLL.H和VDF_Preprocessor.c）和一个VDF的例子（gc_vdf.c）。下面我们用gc_vdf.c为例，解释如何为TransCAD编译你自己VDF。 　　加载VDF程序 　　TransCAD使用的动态链接库必须用Microsoft Visual C 6.0或以上的版本通过快速（__fastcall）调用协议（argument-calling convention）进行编译。编译好的执行文件必须用后缀为.VDF的文件名存放在TransCAD程序目录下，以便TransCAD自动找到它。这些要求可以通过下列步骤实现： 　　1.在Solution Explore树视窗口下面，在你刚刚生成的Vdf Project节点单击鼠标右键，选择Add – Add Existing Item …. 　　这个命令将弹出Add Existing Item对话框，让你能够选择你自己的VDF程序文件。请参考《TransCAD交通需求模型》第10章“高级交通分配方法”中第13－19页“创建流量延误函数动态链接库”中的介绍来了解如何为TransCAD编写定制VDF的更多信息，这里你将选择实现基于广义成本的VDF的gc_vdf.c文件。鼠标左键双击该文件名，或单击选中文件名后，再单击OK。这个gc_vdf.c文件将被加载到你的VDF Project里。 　　打开gc_vdf.c，在第242行作如下改动： short DLLEXPORT VDF_GetLabel(char *label) { strncpy(label, 广义成本函数, VDF_LABELSIZE); return *_platform_tc_status = TC_OKAY; } 　　这里我们只是把字串“Generalized Cost Function”换成“广义成本函数”。 　　你自己的VDF函数当然不只是函数的名称和TransCAD程序提供的这个例子中有所不同，你可以进一步修改这个例子，或从头编写你自己的VDF程序。基本的步骤和要实现的函数在上述模拟手册的有关章节中已经有具体描述，这里不再赘述。 　　设置编译参数 　　1.在Solution Explore树视窗口下面，鼠标右键单击Vdf Project节点，选择Project Settings打开项目设置界面。 　　在General页面的Output Directory编辑栏，输入TransCAD程序所在的文档，这可以是相对路径名“..\..