这篇文章的内容，是首次出现在Vensim中文教学中。目前中文网络内还未出现有关SDM-Doc内容的介绍，本篇内容是目前唯一介绍SDM-Doc的中文文章。
这种“首创”已经不是第一次在本公众号出现了，由于国内介绍Vensim的资料有限，而Vensim软件又涉及到大量的内容，其中还有一些晦涩难懂的软件背后的运行逻辑、数学原理、新开发的功能等，许多领域的知识在国内仍属空白，这也是深入学习Vensim的用户倍感困难的原因。
本公众号本着分享系统动力学前沿知识的理念，让后来的学习者可以更轻松的学习，避免前人学习的艰辛和坎坷，因此不惜深入了解这些晦涩难懂的知识，并不断去测试、拓展新的知识边界。本公众号不是对现有英文资料的简单翻译，而是根据国外相关资料，通过号主自主学习、理解、测试，将Vensim功能的使用方法和系统动力学的知识用简单、直白的语言分享给大家。
希望得到大家的认可和鼓励，也希望读者尊重号主的劳动成果，尊重知识产权。原创不易，且行且珍惜。
========================================
(一)什么是SDM-DOC？
我们日常传输Vensim模型是用Vensim的任一版本打开，可能是DSS，也可能是PLE，或者Pro，或者PLE Plus，还可能是Reader。但任何一个上述的Vensim软件版本，都需要在Vensim官网下载并安装，才可以阅读模型。
能不能脱离上述软件，用一种大家常用或通用的工具查看模型呢？SDM-DOC（System Dynamics Model- Document）就是处于这样一种目的被开发出来了。
Argonne National Laboratory（美国国家阿贡实验室）的Decision and Infrastructure Sciences Division（决策与基础设施部门）便开发了这种文档。但阿贡实验室并不是首创，而是受到了Oliva在2001年发表的一篇论文的启发，这篇论文的名称是《HTML model documentation utility v0.2.》。
SDM-DOC的开发理念就是基于全平台，即无论是windows还是mac或是Unix系统，都可以阅读的文档。如果对计算机有比较深入了解的同学可能会知道，基于全平台的计算机语言有很多种可以使用，其中最为知名的就是大名鼎鼎的Java。SDM-DOC就是基于Java开发的！因此使用SDM-Doc功能，需要首先安装java的运行环境，然后下载一个Java程序包。
下载java的运行环境，最好的选择莫过于去java官网进行下载。读者可以自行百度java官网，选择对应的程序安装运行环境。
然后，还需要下载一个java程序包，这个程序包的System Dynamics Society网站，地址是：https://systemdynamics.org/resources-old/sdm-doc/，这个地址是由System Dynamics Society运营的，不能保证长期有效。
SDM-DOC文档可以由常用的浏览器阅读，比如Windows自带的Edge浏览器，还有知名的如firefox浏览器、Google公司的Chrome浏览器等。
SDM-DOC功能在所有的Vensim版本中都可以使用。
SDM-DOC是一个开源的功能，但开源程序的使用和二次开发应遵守BSD（宽容自由软件许可证） 开源使用协议。
=========================================
(二)阿贡实验室
介绍一下美国阿贡实验室。Argonne National Laboratory，简称ANL，是美国政府最早建立的国家实验室，前身是芝加哥大学的冶金实验室（Metallurgical Lab），现在隶属于美国能源部和芝加哥大学，已经有70多年历史。
说到阿贡实验室的创建，就不得不提美国当年的曼哈顿计划（Manhattan Project），就是美国陆军部研制原子弹的计划，这一计划当时动用了10万人参与，耗资20亿元，阿贡实验室就是此时为了实施曼哈顿计划建立的。在研制原子弹过程中，负责人格罗夫斯和奥本海默应用了系统工程的思路和方法，大大缩短了工程所耗费的时间，促进了二战后系统工程的发展。在阿贡实验室，诺贝尔物理学奖获得者费米于1942年带领其小组建立了人类第一台可控反应堆，命名为Chicago Plie-1，由于这项实验在大城市进行太过危险，所以实验室被转移到了附近的Palos Hills，这座山附近的森林被称为“Argonne”，所以实验室后来就以Argonne National Laboratory命名。
现在，阿贡有雇员3200名，包括大约2000名科学家和工程师，其中约1600人具有博士学位。
==========================================
（三）设置SDM-Doc路径
如上文所说，首先应该先安装java环境，然后从System Dynamics Society的网站下载一个“SDM-Doc v x.x.x x64w”（64位程序包）的压缩包，x.x.x是版本号，如1.4.7。解压缩后文件内应该包含两个SDM-Doc的文件，如图：
在“工具”菜单中有“第三方工具”，然后选择“设置SDM-DOC”
然后在如下的对话框中，单击“是”，打开设置面板。
然后选中我们刚才解压缩的文件包，选中其中的SDM-Doc.vbs文件
选择“打开”之后，就会出现设置成功的对话框，如下：
设置好这个文件包路径，以后可以在“Tools”→“Options”下面进行修改，如图。
==============================================
（四）导出SDM-Doc文件
然后点击开始“SDM-Doc”，如图：
后就会出现这样一个对话框，里面我们可以选择，输出的文件是否包含循环数量、是否包括时间标识。
我们点击“Language”，可以看到目前可选择的语言，但目前还没有中文可选。
选择File菜单下的Option选项，可以看到四个方面内容的选项。
里面有很多的选项可以供我们选择是否输出，例如我们选择“Model Information”，就会出现如下的对话框，可以让我们选择输出的细节信息。
我们将模型正常保存后，模型会有一个保存路径，这个路径会自动出现在Definition Input File下面的框中，如图：
点击“Generate Document”后，会出现系统信息的文件报告，这是在对模型逐一进行扫描并产生SDM-Doc文件所需要的信息细节，这一过程会根据模型复杂程度，稍微地费一点时间。
信息报告结束后，就产生了SDM-Doc文件，并自动从浏览器打开，如下图：
我们可以看到，这个文件分为若干部分，首先是“模型评估结果”、“所有变量”、“变量连接细节”、“变量类型”、“视图”、“群组”、“单位”、“宏观变量”、“反馈循环最大长度”、“外部变量分析”、“内部变量分析”、“链接极性”、“视图摘要”、“视图变量配置”等。
里面的内容非常详尽，将模型的相关信息完全展示。读者可以根据这些信息，对模型有完全地了解。有些读者如果在论文中对模型的表达能力有限，也可以将这些信息中的重要内容，粘贴在论文中，以更便捷的方式向读者说明或解释模型。
转自：Vensim 学术教学
如有侵权，请联系本站删除！
