【公告】二次开发调试技术

    在调试用户子程序过程中，可以利用非《ANSYS命令参考手册》某些命令和其它特性帮助用户提供许多有用的信息。但是，它们仅仅适合于极小问题并只包含较少迭代求解情况；否则，它们将会输出大量的数据。 下面将详细介绍/TRACK 和 /DEBUG两个命令；另外有两个ANSYS文档没有包含的命令：OUTEQ 与 /NERR。
[$#61656] 命令OUTEQ,on 能够用于控制所有平衡迭代计算的输出结果。
[$#61656] 命令/NERR,,,-1 使系统一直报错，并保持程序继续运行。这时，正常的中断方式有：1) 系统中断； 2) 错误结果。  
  
1、跟踪程序运算逻辑顺序
/TRACK命令：当程序按逻辑顺序进入和离开某些更高级别的子程序时发送一条信息。子程序的TrackBegin（开始）和TrackEnd（结束）(参看UPFs第六章)一起构成/TRACK命令的程序跟踪。 然后，按下列格式执行命令：
/TRACK,MonLevel,PrintLevel,SumLevel
其中：MonLevel是时间监视级别；
PrintLevel是进入/退出输出状态开关；
SumLevel是输出累积时间状态开关。
这三个参数可以是0到9之间的任何值(缺省为0)。用户可以使用/TRACK命令查找出程序中断发生的代码位置。例如，将所有子程序标识为八个级别，以便确定程序进入与退出它们的时间, 此时用户应当执行的命令为：
/TRACK,,8
  
2、调试单元与求解
/DEBUG命令能够在输出的许多位置点进行调试。/DEBUG命令具有下列三种调试格式：
[$#61656] 求解（solution）调试格式
[$#61656] 单元（element）调试格式
[$#61656] 一般调试格式  
（1）求解（solution）调试格式
执行命令：  
/DEBUG,-1,F1,F2,F3,F4,F5,F6,F7,F8,F9
参数说明：
F1—1 (输出基本求解结果控制调试结果)  
F2—1 (输出使用Newmark常数的瞬态计算调试结果)
2 (输出使用速度与加速度的瞬态计算调试结果)
F3—1 (输出单元矩阵调试结果，包括矩阵与载荷矢量)
2 (输出单元矩阵调试结果，只包括载荷矢量)
3 (输出单元矩阵调试结果，包括矩阵对角元素和载荷矢量)
F4—1 (输出自动时间步长(auto time stepping)调试结果)
F5—1 (输出多物理场调试结果)  
F6—1 (输出弧长(arc-length)调试结果)  
F7—1 (输出基本Newton-Raphson调试结果)  
2 (输出Newton-Raphson调试结果，包括非平衡力或增量位移或每个DOF)  
3 (输出Newton-Raphson调试结果，包括施加载荷与每个DOF 上的n-r恢复力)  
F8—1,2 (输出位移矢量以及位移指针调试结果)  
2 (输出位移矢量以及增量位移调试结果)  
3 (输出位移矢量以及接触数据库调试结果)  
F9—1 (输出临时程序员调试结果)

（2）单元(element)调试格式
执行命令：
/DEBUG,-3,G1,G2,G3,G4,G5,G6,G7,G8,G9
参数说明：
G1—1 (输出基本单元通过(pass)调试结果)  
G2—1 (输出单元位移和坐标调试结果)  
G3—1 (输出单元矩阵调试结果，包括矩阵与载荷矢量)  
2 (输出单元矩阵调试结果，只包括载荷矢量)  
3 (输出单元矩阵调试结果，包括矩阵对角元素和载荷矢量)  
G4—1 (输出单元载荷调试结果)  
G5—1 (输出单元实常数(real constant)调试结果)  
G6—1 (输出单元存储变量(saved variable)调试结果)  
G7—1 (输出线性材料特性单元材料特性调试结果)  
2 (输出非线性材料特性单元材料特性调试结果)  
G8—1,2 (输出塑性单元非线性调试结果)  
2 (输出大变形单元非线性调试结果)  
3 (输出接触数据库单元非线性调试结果)  
G9—1 (输出临时程序员调试结果)  
  
（3）一般调试格式
执行命令：
/DEBUG,H1,H2,,H4,H5
参数说明：
H1—1 (输出文件头纪录(file header record)信息)  
2 (输出字符输入行(character))  
3 (输出解码输入行(decoded))  
H2—1 (输出波前重新排序(wavefront reordering)与单元检查调试结果)  
2 (输出网格划分调试结果)  
H4—1 (输出节点坐标系转换格式调试结果)  
2 (输出位移更新调试结果)  
H5—1 (输出pre-单元、单元特性(characteristics)以及单元场载荷调试结果)