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

在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与联系）。在Microsoft Visual Studio中创建VDF编译环境在Visual Studio 2003选择FileNewProject，创建一个新的Project。选择General Custom Winzard。在Name编辑栏输入VDF，在Location编辑栏输入“C:Program FilesTransCADvGISDK”，如下图所示：这里我们假定你的TransCAD是安装在“C:Program FilesTransCAD”下面，而你自己的VDF文件要存储在它下面的GISDK文档里面。单击OK，弹出的下一个Application Settings对话框。单击Application Settings 显示应用程序定制界面。在Application type单选列表选择DLL类型。在Additional options选择Empty project。最后点击Finish。Visual Studio在你指定的 “C:Program FilesTransCADGISDK”下面的VDF文档里生成几个文件，其中最重要的是vdf.vproj文件。你后面将在这个文件中定义定制VDF的编译环境。原先在GISDKVDF文档里，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章“高级交通分配方法”中第1319页“创建流量延误函数动态链接库”中的介绍来了解如何为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程序所在的文档，这可以是相对路径名“.”，因为VDF文档比TransCAD程序文档低两级。在Debugging页面的Command编辑栏输入TransCAD的执行文件“tcw.exe”所在的路径名。作这项选择与创建VDF没有关系，但它可以让你在Microsoft Visual Studio的IDE环境下进行你的VDF程序的纠错。2.单击C/C+下的Advanced页，在Calling Convention下拉菜单选则“_fastcall(/Gr)”。在Linker下面的General页面的Output File编辑栏，把输出的执行文件的后缀从.dll改成.vdf。编译和链接VDF你定制VDF函数的程序写好以后，可以用Visual Studio的BuildBuild Solution命令，快捷键F7，或鼠标点击按钮来进行编译和连接。如果一切顺利，这将在TransCAD程序文档中创建一个VDF.vdf文件和同名但后缀为.lib和.pdb等等的文件。对TransCAD使用你的VDF而言，只需保存动态链接库函数VDF.vdf文件。有关其他文件和更多编译、连接和执行程序的选项，请参阅Visual Studio的用户手册。用定制的VDF执行TransCAD交通分配程序编译和链接无误以后，可以用Visual Studio的DebugStart命令或快捷键F5启动TransCAD.。遵照屏幕的提示，进入TransCAD以后，打开TransCAD程序文件夹下的Tutorial文档中的Workspace 文件“Traffic Assign.wrk”。TransCAD将打开一个地图、矩阵和相应的网络。选择TransCAD的PlanningAdvanced AssignmentAssignment with User VDF命令，打开Assignment with User VDF对话框：注意到你的VDF（广义成本函数）已经出现Delay Function下拉菜单下的选项当中。关于使用Assignment with User VDF程序的更多信息，请参阅TransCAD需求模型第10章“高级交通分配方法”。在必要时，用Visual Studio你可以在自己程序的指定地点设置断点（Break Points）。程序执行到你的断点你可以检查输入变量的值，你的程序的流程和返回值。编制自己的VDF时，这样的查错功能往往是很重要的。程序满意以后，你可以将其重新编译成优化的格式（Optimized）。这可以通过Visual Studio的BuildConfiguration Manager命令来实现。在Configuration Manager对话框，把A