amesim中文教程附录B AMESim用到的特殊文件

amesim中文教程附录B AMESim用到的特殊文件 B AMESim B.1. AMESim用到很多特殊的文件，他们以以下的形式存储: l 直接存在AMESim的根目录下 l 在AMESim的节点上 我们讨论在安装目录下的最重要的一些文件。这些文件从最终的窗口得到，都带有AMESim的简写AME作为标志。 AMEload.sh 打开一个文件 AMEsave.sh 保存一个文件 AMEclean.sh 删除一个文件 AMEcompile.sh 利用模型的源代码产生一个可执行文件 所有的部分文件都以.ame的文件格式进行存储，即以为AMESim所创建的部件文件的格式进行存储。 下一节我们将讨论以下内容: l AMESim的节点 l 为AMESim所创建的文件 l 系统文件的清除工具 B.2. AMESim AMESim的节点即为一个文件夹或者目录，且这个文件用于存储下面的文件: l AMESet的一般子模型 l AMESim的一般超级部件 l AMECustom用户化的子模型或者超级部件。 下面是一个AMESim节点的典型结构 B.1AMESim AMESim的路径名的最后一块是AMESim节点的标志。在上面的例子中，AMESim的PDF 文件使用 pdfFactory Pro 试用版本创建 www.fineprint.cn节点的标志是libs。理论上说所有AMESim的标志都应该不同。 这些文件夹的使用如下: submodels 一直存在 用于存储在节点中存储的子模型和超级部件的细节信息 Icons 创建类以后存在 用于存储在类中的类的图标和部件的图标 lib 用户手工创建 用于存储文档库的地方 data 用户手工创建 用于存储任何的数据文件 doc 一直存在 用于存储任何的文档文件 在AMESim的节点中存储的文件如下 Submodels.index 一直 用于把子模型和超级部件和他们的图标联系起来 AMEIcons 在创建类以后 把节点中的类的文件进行分类 AME.make 手工创建 用于改变用于创建系统模型的可执行性的工具的行为 Icons .xbm文件用于定义类中的图标，.ico文件用于类中部件的图标，包括图标的描述，图标的位置等。 l .spe文件定义说明了子模型的特征。这些文件被AMESim读取，并且说明指令是怎样作用于子模型的。 l .sub文件说明超级部件中的内容 l .c或者.f文件是子模型的源代码。 l .o或者.obj文件是子模型的源文件经过编译后得到的目标文件。在一些平台下，这些文件存储在submodels文件夹中的一个特殊的子文件夹中，在另外一些系统中则直接存储在submodels文件夹中。 doc PDF 文件使用 pdfFactory Pro 试用版本创建 www.fineprint.cn 这个文件夹有着特殊复杂的结构，如下 重要的一点就是该文件夹有html子文件夹，该子文件夹中有用于子模型和超级部件的.html文件。 B.3 . AMEIcons AMEIcons文件有你可以使用的类的说明，每类中的特殊的部件，每类的描述。在搜索AMEIcons文件的时候AMESim路径列中的目录以一种特殊的顺序组织。最终的结果是文件成功读取后的内容的出现。一个AMEIcons文件的例子如下。 B.4. submodels.index .submodels.index文件是AMESim用来知道子模型是和那个图标相联系的。当一个子模型被建立在一个草图的图标之上的时候，AMESim就会查阅路径列表中的路径以查找处于打开状态的submodels.index文件，并且读取它。最这个过程的最后，和所选图标相适的子模型就会被成功的选择出来。submodels.index文件的一部分如下 B.5. AME.make AME.make文件说明AMESim怎样建立系统的可执行文件。这个可执行文件是在仿真模式下的。可执行文件是在能读取和处理AME.make文件的规则下建立的，AME.make文件建立在AMESim的路径列表中。这些文件一般有四行。在Cooling System(冷却PDF 文件使用 pdfFactory Pro 试用版本创建 www.fineprint.cn系统)库中给出了一个AME.make文件的例子。 第一行告送AMESim怎样编译你的系统的代码。第二行告送AMESim在编译完成之后要用怎样 的功能来产生一个可执行文件。通常情况下是一个C编译器，一个Fortran 编译器和一个联接器，第三行和第四行告送AMESim在生成可执行文件的时候，要加入的库。第三行用于Unix系统，而第四行用于Windows系统。 AMESim将取出在路径列表中它找到的第一个AME.make文件的前两行，并且综合剩下的AME.make文件的第三行和第四行。 最初，唯一的AME.make文件存在于AMESim的系统区，(由AME环境变量说明)。把它拷贝到你的工作区是很有用的，利用下面的操作可以实现 之后，你就可以对它进行编辑了，接着有以下不同的方式生成可执行文件。一个AME.make文件可以存在一个特殊的目录下面，以便一组用户都可以使用它。如果你建立了自己的库，你可以说明你建立了库和希望使用的意愿。 使用Unix系统时，建议库的名字以lib 开头，以a结束。例如libMylib.a。你必须特殊的库和他们的存储路径进行说明。第三行的一个例子如下 第四行如下面的形式: 如果第三行或者第四行已经存在则最好在行的前面加上这些文字。 B.6. AMESim 当你用AMESim创建立一个系统之后，进行仿真并且可能作线性化的处理，会产生一些文件。如果系统的名字是NAME 的话下面是一系列的可能存在的文件。也给出了各个文件的功能。除了有特殊的说明，否则都是ASCII文件。 文件名 描述 NAME.ame 一个生成单个文件的所有必要文件的集合，可以随意压缩，以节省磁盘空间。不是ASCII文件 PDF 文件使用 pdfFactory Pro 试用版本创建 www.fineprint.cnNAME_.cir 系统的完整描述包括:元件的格式，元件的位置，每行的位置 对每个子模型的描述和当前设定值，对系统进行描述的文字和文字的位置 NAME_.c 由AMESim产生的系统的源代码 NAME_.obj or NAME.o 描述系统的源代码经过编译后得到的二进制文件 NAME.exe or NAME_ 系统的可执行文件 NAME_.make 编译源代码并且生成可执行文件的说明 NAME_.data 可执行文件运行时要读取的系统参数 NAME_.data.n n组批运行时的系统参数 NAME_.sim 运行参数的说明 NAME_.param 在参数设定模式下，当你使用Tool菜单的下拉菜单list parameter的时候产生。它包含一个包含所有子模型列表和文件建立时设定的参数 NAME_.var 但前系统用到的外部变量和内部变量的列表。每一项纪录由子模型的名字和编号，变量名和单位组成。这些信息用于说明在仿真运行的时候完整输出的优先权。在AMESim的结果读入Matlab的时候也用到该文件。 NAME_.results 仿真运行结果的二进制文件 NAME_.results.n n 组批运行仿真时的结果的二进制文件 NAME_.state 状态变量和固有变量的列表，固有变量有包含子模型的定义的变量和AMESim解决固有的循环时产生的 NAME_.err 一个说明每个状态和固有变量限制综合步幅的大小的数。该文件和NAME_.state文件中的信息用于创建状态数 NAME_.la 线性分析所需要的细节 NAME_lock 状态变量是处于锁定状态或者处于解所状态的细节。该文件只用于固定运行状态 NAME_.sad 用于定义批运行的特性 NAME_.sai 用于定义批运行的特性 NAME_.ssf 用于定义结果文件中对哪个变量进行存储 NAME.BAK.LOG 系统的备份文件的信息 NAME.BAK 系统备份的二进制文件表示是时间和日期的编码格式此处日期是文件的创建日期 NAME_.jacn 线性化的结果如果对系统进行了在不同时间进行了一系列的线性化则第一次线性化的结果存储在NAME_.jac0中第二次线性化的结果放在NAME_.jac1中. NAME_.jacn.m n次线性化并运行m次的结果 当你建立一个新的系统的时候一系列和该系统有关的文件被建立起来。当你保存系统的时候，处于当前状态的文件的拷贝文件就会变成一个.ame文件，并且被压缩。 当你清除系统或者从AMESim退出的时候，NAME_.类型的文件就会被移除，这就会剩下NAME.ame文件 PDF 文件使用 pdfFactory Pro 试用版本创建 www.fineprint.cnNAME.BAK.LOG和NAME.BAK. 当你载入一个已有的系统的时候以NAME.ame格式存储的文件就会恢复成NAME_.文件的格式但是在NAME.ame文件没有被再次存储之前它是不会变的. B.7. 如果你想把一个文件发给你的同事，你要减小你的.ame文件的规模。文件的瘦身工具特别好用，你只要点几下鼠标就可以把不必要的文件精简掉。 l 为了精简一个你要使用Tools菜单并且选下拉菜单Purge.。 l 选择select file 按钮并且选择.ame文件对其瘦身。 剩下的操作就很显然了但是如果你想了解关于这个工具的更多信息参见368页Purge. B.8. 一些系统利用外部的信息，例如图标，用户化的对象，超级部件或者其他的对象。如果你想把一个完整的系统传给你的同事，处理由分立的的文件组成的系统的发送问时你可能会遇到问题。 AMESim提供了一个pack/unpack工具，即打包拆分工具，利用该工具你可以把所有的相关信息发给你的同事，以便你的同事可以运行它。 AMESim创建一个.pck含有系统所有的元素的文件。所以很容易传送这一个文件，而不用把大量的对象进行传送。 当你的同事把这个文件进行复原的时候，它只需要把该文件拆分，以便成为可用的系统。 下面的操作可把.ame文件和相关的对象进行打包，即选择菜单Tools，后下拉菜单Pack，AMESim就可以为你的文件进行打包了。如果你想了解关于pack/unpack工具更多的信息，参见370页打包拆分工具一节。 为了拆分文件，先使用相同的菜单Tools，后选择下拉菜单Unpack。想了解关于pack/unpack工具更多的信息，参见370页打包拆分工具一节。 PDF 文件使用 pdfFactory Pro 试用版本创建 www.fineprint.cn