tool主命令

介绍tool主命令的使用和参数含义

基本说明

作用

在HYMACS中，tool命令主要定义一个工具，每一个工具在求解过程中，会对体系中原子在一定的时间（一个加载步完成后、一个子步完后等）进行一定的操作、计算或者显示。工具主要用来对HYMACS进行功能扩展，根据特殊需求，配合HYMACS完成复杂的计算过程。

形式

tool add id ...
     set id ...
     delete id1 id2 ...

说明

  • tool add id toolType … : 在HYMACS中加入一个名称为id的toolType类型的工具，后面一般会带有多个参数，参数的含义由具体的工具类型而定。
  • tool set id … : 设置名称为id的工具参数。
  • tool delete id1 id2 … : 删除HYMACS中已定义的工具。

示例

tool add hist Dump 1 0 -file ${proj}

目前支持的Tools

下面列出了HYMACS目前提供的工具类型。

Adaptive 工具

命令

tool add id Adaptive nStep element groupID factor a skin b

选项

  • -start step

说明

用于HYMACS计算过程中原子和集团区域的自适应切换。 groupID: 用于指定被测试的单元组 a: 用于确定原子和集团区域的能量差 b: 指定原子区域的搜索范围

  • -start: 表示从第几步开始自适应检查

示例

tool  add adaptive  Adaptive 1 actElems element factor 5.0e-3 skin 6.0

Command 工具

命令

tool add id Command nStep nSubStep "cmds" -if "condition"

选项

-

说明

用于在HYMACS的运行中每隔一定步数执行指定的命令。id表示为工具名称，nStep表示每隔多少加载步执行一次，nSubStep表示每隔多少子步执行一次，“cmds"表示所要执行的HYMACS命令。选项if用于给定执行条件，只有当条件"condition"为真时，才会执行指定的命令。

示例

-

Deform工具

命令

tool add id Deform nStep nSubStep dir style parameters

选项

-

说明

用于对体系实行变形加载。nStep表示每隔多少加载步执行一次，nSubStep表示每隔多少子步执行一次，dir表示加载方法可取x，y，z，xy，xz和yz，style表示加载方式可取delta，erate和trate，delta方式表示以增量的形式加载，erate表示以工程应变的形式加载，trate表示以真实应变的形式加载。

示例

-

Dump工具

命令

tool add id Dump nStep nSubStep options

选项

  • -style atom/xyz
  • -style custom var1 var2 …
  • -nstep n
  • -nsub n
  • -group groupname
  • -file filename
  • -multi nFrame

说明

输出体系构型文件到文件中。

  • nStep: 表示每隔多少加载步输出一次
  • nSubStep: 表示每隔多少子步输出一次
  • -nstep: 表示每隔多少加载步输出一次
  • -nsub: 表示每隔多少子步输出一次
  • -style: 用于指定输出构型的类型，msx 表示输出MOLESHOW使用的构型文件，可以将原子数据、网格数据同时输出。atom类型与LAMMPS的dump命令输出的格式一致，xyz表示输出xyz构型文件。custom表示输出自定义的原子数组变量，Dump工具默认输出atom类型的构型文件
  • -group: 用于指定输出特定组的原子信息
  • -file: 用于指定工具将变量输出到哪个文件中
  • -multi: 表示每隔多少帧在新的文件中输出，新的文件名会在filename后面附上当前帧信息作为标识，注意这里的帧是指一个完整的原子信息片段，并不与加载步一一对应

示例

tool add history Dump 1 0 ${proj}.dmp

Record工具

命令

tool add id Record nStep nSubStep options

选项

  • nstep n
  • nsub n
  • var var1 var2 …
  • flush yes/no
  • file filename

说明

变量跟踪工具，用于在计算过程中将变量按一定的步数输出到屏幕或文件。id表示为工具取一个名字，nStep表示每隔多少加载步输出一次，nSubStep表示每隔多少子步输出一次。选项nstep表示每隔多少加载步输出一次；nsub表示每隔多少子步输出一次；var用于指定每步需要输出的变量；flush表示每次输出变量值后是否对文件进行刷新；file用于指定工具将变量输出到哪个文件中，如果没有指定文件，Record工具会将数据输出到屏幕中。

示例

tool  add recScreen Record 1 20 -var Ecur Gcur ForceEval StopFlag Time
tool  add recFile Record 1 0 -var Ecur Gcur ForceEval StopFlag Time -file ${proj}.txt

反馈留言 💬