PFC3d手册命令中文详解

PFC3D学习记录5—COMMANDREFERENCE

通用规定和特征

吩咐语法

默认状况下，吩咐行忽视大小写，然而可以通过SETcase吩咐激活区分大小写状况。

斜体字代表数字，以i,j,mn为开头的字母代表整数，其他状况为实数

吩咐词，关键字和数值可用空格，以及()，=分隔。

在分号(;)后为注释

一行最多可包含80个字符。而&表示续行

Range语法

定义肯定限制范围的物体

可运用Range的吩咐：

Change/initial/propertyClumpFix/FreeGroupJset

ModelPlot(运用于不同输出项目)Print

Range(创建一个命名的范围)

一个Range定义一系列物体。由很多范围元素构成。

假如运用多个范围元素，最终物体几何为不同元素集合的交集。

但是可通过美键词any变更选择特性。假如运用美键词any选项，仃.何包含在范围内的单元

可被认为最终物体集合的一部分。

即求合集

除此之外，通过在定义范围单元后接关键词not确定全部不在指定范围的单元

通常还可以用定义group方式定义困难的rangeo

内置范围单元：

Annuluscenter(x,y,z)radius=rl,r2

球形空心区域中心在(x,y,z)内径rl,外径r2

Coloril<iu>

球体或墙体在间隔(il,iu)内颜色索引。若无iu则iu=il

球体颜色索引列表通过pr叩erty吩咐建立。

墙体颜色索引列表必需用FISH内置的w_color设置

Cylinderend1(xl,yl,zl)end2(x2,y2,z2)radius=r

圆柱范围。圆柱中心轴过endl(xl,yl,zl)end2(x2,y2,z2)半径为r.

Fishfname

调用用户定义的范围单元。通过FISH函数fname执行。而此函数中必需包含一个

range_element指定范围单元函数。此时fname就会调用全部在范围内的各个物体。

物体的地址将通过fc_arg(0)传入函数，而坐标x-,y-,和z-重量将通过fc_arg(1),

fc_arg(2),fc_arg(3)分别传入函数。物体类型由FISH内置的pointer_type指定。假如物

体不在指定范围内，则fname的值必需在函数内设置为零，假如未指定，默认值为1。

groupgname

定义属于group名字gname的颗粒球体，(粒子组通过group吩咐定义)

idil<iu>

id编号在il,iu范围内的物体，假如iu没有指定，则默认il=iu

jsetil<iu>

节理编号在在iLiu范围内的接触，假如iu没有指定，则默认il=iu

节理通过JSET吩咐创建

namemanic

创建一个命名范围rname,通过在吩咐行中范围元素集合定义，通常一个范围用range吩咐

创建。

planekeyword

无限平面包围区域

Keyword:

Originx,y,z平面上一点(x,y,z)

dddd方向角x-y平面上方向角，从y轴正向顺时针方向测最

dipdip俯角从x-y平面，向z轴负向。

Distanced在距离d范围内区域

Above平面上方below平面下方

normalnx,ny,nz平面的单位法向矢量

radiusrl<ru><tolerancet>

半径在(H,ru)范围内球体。ru未指定，则范围(H-t,ru-t)

t未指定，则t=HXI0-6.留意误差范围只有在未指定ru条件下指定。

mame命名范围「name

sphereccntcr(x,y,z)radius=r

球形区域，中心(x,y,z)半径r

x=xl,<xu>,<tolerance=t>

y=yl,<yu>,<tolerance=t>

z=zl,<zu>,<tolerance=t>

指定x,y,z坐标在指定范围内的物体。其他同radius条

重点理解fish定义range部分。

在线帮助

Cominand?适用command的各个关键词

?/help显示全部可用吩咐

吩咐分类

程序限制吩咐

这些吩咐支持批处理执行模式，允许变更程序状态。其与用程序建立实际数值模型无关。

Cycle&Step执行指定时间步

Solve执行计算，直至满意收敛条件

Build限制AC/DC操作

call调用data文件，执行吩咐，批处理模式

return从批处理模式中返回到限制台。或在多级调用中返回上一级调用文件

continue-pause重新/中止调用data文件

Fluid设置流体分析条件

/MPI限制MPI操作

/PARALLEL限制并行计算程序操作

NEW重启新模型

Quit&Stop/Save-Restore

Set变更全局程序设置

/Thermal设置热分析

/Title设置模型名称，这些将保存在随后的输出图并记录在save文件中

/Ucodc注册用户编译的C++类

特殊计算模式

可选计算模式，通过conf唱吩咐调用。

Config可在任何分析阶段给出，但是必需在调用时指定计算模式。

CppudmC++用户定义接触模型

CppuwcC++用户编写代码

fluid流体分析

thermal热分析

模型属性部分

模型建立和修改

Ball建立新球体

Clump建立新团块，或修改新团块属性

Delete删除球体，团块，墙体和时程记录

Generate生成球体集合

Jset生成一系列节理

Wall生成墙体或修改墙体属性

Fix对球体设置固定速度

Free将球体固定速度清零

Model对指定接触指定用户定义接触模型

Property修改已有球体属性（材料属性和施加外力和速度），修改

属性，粘结属性，接触属性

模型监控

History指定执行过程变量（预定或用户定义fish变量

Measure建立一个测量球或变更测量球属性

吩咐集合

建立球体

Ballradius=r<density=**hertzid=**x=**y=**z=**>

Radius:球体半径density:密度(m/V)

Hertz:指定Hertz接触模型否则为线性接触模型

Id:编号，唯一性，默认值大于当前编号最大值的整数

x,y,z：x-,y-z-坐标，默认为0.0

用ball建立球体允许重叠，球体属性由properly吩咐设置

Build限制执行AC/DC操作

Buildassemblyxa,ya,<za>

通过复制粒子和包含在pbrick中的力(必需已经存在)建立粒子集合，而初始粒子由

Call<fname>调用data文件，

默认为pfc3d.dat,而若扩展名未指定，等于*.dat

文件调用允很多级调用，但不允许相互迭代。

Change同property吩咐一样

创建团块

Clump<id=**>full=on/offpermanentreleaseupdate_cycle=n<range...>

创建一个团块，

若id等「已有团块编号，则为修改团块属性

Range为要建立团块的范围，

范围内原来属于其他团块的粒子转化到当前团块，必需指定range防止全部粒子变成一个团

块

Printclump输出团块信息,plotclump输出团块

1、Fullon在计算团块运动时，运用全部惯性向量力矩，这会耗费更多计算时间。因为

cross-couplingterm运用，必需进行矩阵转换。当旋转速度较大和陀螺效应影响大时运用。

Fulloff计算团块运动时，只有运用diagonalinertia,而忽视旋转速度乘积。只有3D计算受

full大键词影响。

当fullon时，应设置update_cycle=1

2、Permanent通过阻挡构成团块粒子间生成接触使得构成团块的粒子在随后模拟过程保持

接触。这样不须要存储接触信息，并且避开常常性更新接触信息及其对应的矢量。

当在模拟过程中团块有个形成和分解过程，就不能指定这个关键词

然而，指定颗粒间永久接触有利于节约内存和计算时间。

当一个团块有其permanent属性设置，其设置为永久的

然而永久团块可被删除且团块内球体可被释放。

Release关键词用于从团块提取球体，释放时，球体将不存在接触

3.release范围内全部属于同一团块将被释放。假如id未指定，全部范围内属于任何团块

的粒了•将被释放。团块内全部粒了•被释放时，团块本身不被删除，形成“空团块”，这种状

况在计算过程中忽视，而在粒子重新加入之后，被激活。

Deleteclump删除团块

4、update_cyclen

限制数据更新速度，默认值『10。N越大，计算时间小。可被更新速度有

Momentofinertiatensor惯性张量力矩(3D)

contactcoordinates接触坐标contactnormalvector接触法向矢量

接触剪力矢量(3D)平行粘结力矩(3D)平行粘结剪力矢量(3D)

留意

团块阻尼系数为构成团块粒子的阻尼系数的算术平均值

当模型中存在团块时，在本版本中就不能运用密度放大系数

Fix/free吩咐用于团块内任何粒子时，此工况用于团块重心。

Printclump可看到各个团块的fix/free状况。

Configkeyword<keyword>

指定可选计算模式

Keyword:

CppudrnC++用户定义模型

CppuwcC++用户编写代码

Fluid流体分析

Thermal热分析

Continue重启由pause中止的data文件过程

Cycle/Stepn

执行n时间步

对于热分析和热力分析计算为热计算步，否则为力学步

计算过程输入Esc,中止计算过程。计算过程输入空格，接着中止当前cycle.

当前计算过程由setmechanical和setthermal吩咐指定。

对于热力耦合计算，每个热步后跟着最多n个力学计算子步，吩咐：thcnnalsetsubstep.

Dampkeyword<keyword...><range...>

设置局部阻尼的阻尼属性（球体）和粘性阻尼的阻尼属性（接触）

局部阻尼：施加一个与各个球体自身不平衡力成比例大小的阻尼力。

粘性阻尼：在每个接触施加•个法向和切向粘壶，这些粘壶与原有接触作用平行，从而生成

与两接触实体（球一球或球一墙）相对速度差值成比力的粘滞阻力

两种阻尼可以同时存在

当未指定阻尼系数时，局部阻尼发生作用，且全部球体阻尼系数为0.7,而粘性阻尼不发生

作用。

Keyword

1、default指定新建球的阻尼参数

defaultlocal=v局部阻尼系数默认v=0.7

viscousnormal=v法向临界阻尼系数，默认v=0

notensionoff/on无拉力标记on-无张力默认off

shear=v切向临界阻尼系数，默认v=0

2、local=v范围内全部球体局部阻尼系数为v

3、viscousnormal=vnotension=off/onshear=v

设定范围内粘滞阻尼系数

Definefunctionname

End

定义fish函数

全部define...end内的语句被编译并以压缩方式存储以便后续过程运用

Deletekeyword...

删除球体，团块，时程关系，墙体

Keyword:

1、Balls<id>删除id号球体

<range...>删除质心在范围内球体

未指定任何参数时，模型内全部球体被删除

2、Clumpid

删除编号为id的团块，不能运用range参数。团块内全部球体被释放，但是球体未删除。

4、histories删除全部时程记录。

时程记录内容可以用historyreset吩咐删除。

Wallsidl<id2>删除编号为idl,id2的墙体

Idltoi<12<id3toid4>删除编号在idl,id2间墙体

Fixkeyword...<range>

固定球体指定自由度速度值。即赋值速度常量。

速度属性可以由property吩咐设置。

关键词：

x,y,zx-,y-,z-方向速度xspin,yspin,zspin:x・,y-,z-方向角速度

例子，固定球体（id=5）x-方向速度

Fixxrangeid=5

Propertyxvel=1.5rangeid=5

Fluidkeyword<keyword...>

流体分析

关键词:

1、modelxl,xh,yl,yh,zl,zhsizenx,ny,nz

设置x-,y-,z-方向模型尺寸和单元数目。

在[xl,xh][yl,yh][zl,zh]范围内建立总数为nx*ny*nz数目流体单元,每个流体单元x-,

丫-1-方向尺寸为（乂11R）/吆,（）41-丫1）/”,（zh-zl）/nz,留意模型总单元数为（nx+2）*（ny

+2）*（nz+2）,边界上附加一个单元为边界条件

2^propertydensityd流体密度d

Viscosity流体粘滞系数v

3、boundarynonslipkeyword在keyword指定位置设置无滑动边界

Slipkeyword在keyword指定位置设置滑动边界

Pressurepvkeyword在keyword指定位置设置压力

为pv

Velocityxv,yv,zvkeyword

在keyword指定位置指定apparent速度为xv,yv,zv

注：apparent速度定义：对于进入网格的流体将flowrate除以单元长度（或单元面积）

边界位置指定：

xl:x方向下边界xu:x方向上边界

yl：y方向下边界yu：y方向上边界

zl:z方向下边界zu:z方向上边界

atxp,yp,zp在点（xp,yp,zp）

4、setkeyword限制流体计算循环参数

buotermoff（默认）/onon:打开浮力作为外部体力（流体安排中

grtermoff（默认）/unoff:在Navier-Strokes方程中忽视重力

on:在流体计算中考虑重力影响setgravity

vistermoff（默认）/onoff:忽视粘滞影响

下面参数限制SIMPLE项H，留意假如迭代不收敛，pfc3D发出一个警告消息而不是结束计

算

Critcr指定SIMPLE安排收敛标准，默认104

Intvalintv假如在tdclauto时间步模式F指定。则流体计算将在每in【v计算步调

用，而流体计算步有模型状况指定

Iterationit指定SIMPLEscheme迭代限制，默认it=5000

P_relaxpr在压力调整计算中指定松弛因子默认pr=0.8

Por_relaxpor在孔隙率中指定松弛因子por=1.0

Tdelauto流体分析计算中时间步为自动计算

Tdeltdel指定流体时间步tdel

V_relaxvr指定速度计算的松弛因子，默认vr=0.5

Freekeyword...<range...>

消退指定范围内指定自由度的固定速度约束

关键词：x/y/z/xspin/yspin/zspin

Generate<keyword...>x=xl,xuy=yl,yuz=zl,zuradius=rl,ruid=il,iu<annulus(xc,

yc,zc)rl,r2>

生成颗粒集合，指定粒子数目(编号起始和终止)，粒子生成区域和粒子半径分布。粒子位

置和半径以随机分布。因此粒子集合最终状态有随机种子生成器(SETrandom)影响。

1、粒子生成区域定义：

(1)x,y,z关键词确定长方体区域(xl,xu)(yl,yu)(zl,zu)o3xl=xu/yl=yu/zl=zu

生成一排粒子集合。

(2)annulus关键词定义一圆形空心区域中心(xc,yc,zc)内径rl外径r2。

在这种状况下可忽视x,y,z关键词。假如同时指定。生成圆形空心区域和长方体区

域交集

(3)生成区域可用用户定义的fish函数定义(filter)

2、半径分布

Radius关键词指定，默认为匀称分布，高斯正态分布用gauss关键词

粒子数目

粒子数目指定id=il,iu粒子数目iu-il+1。粒子生成时与已存在的粒子不能重置。但

空间不能足够容纳粒子，则可用Ees关键词。定义更多尝试次数。假如不能生成足够粒子,

则可发生错误提示，Setgen_erroi•用于将错误提示改为警告提示，则吩咐将接着。

球体属性将用随后property吩咐指定

可选关键词：

1、filterfname

调用用户定义生成粒子过滤器。在每个试验粒子生成过程中，FISH函数fname将被调

用。试验粒子半径将通过fc_arg(0)，而粒子坐标三个重量将通过fc_arg(I),fc_arg(2),

fc_arg(3)分别导入函数。假如符合条件(即粒子落入指定区域)则fname必需被设定

为0,当调用时fname设置为1。

2、gauss

半径为高斯分布，平均半径(rl+ru)/2,标准差为(ru-rl)/2

3.hertz

新建球为Hertz接触模型，未指定为线性接触模型

4.Local

只有在并行计算时有用。通常只有在局部处理器，这样就处理器之间没有共享信息，必

需保证没有重复的id号

5.Minrmin

只有在gauss关键词时定义，此时高斯分布中最小半径为nnin,默认值为rl/10

6.no_shadow

防止球体在墙体阴影中（即墙体从非活动面的垂直投影）生成。

默认球体将在全部墙体活动面和非活动面任何一面生成。

7.triestmax

设置粒子生成尝试次数。默认tmax=20000。

GROUPkeyword...

定义群组，定义属于球体的群组（不论位置和属性变更）。可生成多级嵌套群组，比如一个

球体可属于多个群组

Printgroup显示当前存在群组

Printballinfo显示球体信息，包括其属于的群组

关键词

1.deletegnamc

群组gnamc将删除

2.gname<ownergnameO><range...>

建立群组gname.群组将包括全部指定范围内球体。若无指定，将包括模型内全部球体，假

如gname已经存在，则位于指定范围的球体将加入群组gname.

Owner关键词，gnameO被指定为gnames上一级（UPgname作为群组gnameO的从对象。

假如上一级组gnameO用range单元定义，则gnameO包含全部指定范围内球体和全部从组

内球体。而从组gname作为从组内单元，则从组之包含从组内球体。

留意:range定义41为叠加过程。

History<id=id><nstepn>keyword...

存储和采样一系列模型计算过程的变量。

这些变量可以绘制与步数或其他相关时程变量（plothistory）的图形。

时程变量可输出到文件（write关健词），

每个History吩咐中只能有一个变量，history时程变量可在任何时间添加。

全部时程变量内的具体内容可用purge关键词删除

而全部时程变量可用delete关键词删除

Printhistory显示全部时程变量项目

每个时程变最有唯一的ID号，默认按history吩咐依次生成。可通过id关键词指定。全部

时程变量用一个采样间隔，默认采样间隔为10步，采样间隔可用nstep关键词修改（更好

的方法是sethist_rep吩咐指定）不同时程变量不能运用不同的nstep。

除此之外还可将FISH符号作为关键词。

关键词

1.内置时程变量

（1）.球体

Historyball关键词x,y,z/id=n

监控特定球变量：①距离坐标为（x,y,z）最近的球/②id=n的球。

关键词有:sll：对应应力oxx,sl2（oxy）,sl3（oxz）。…$33

Temperature:温度，若热学分析未激活，返回0

Xposition/xspin/xvelocity：质心坐标，角速度,平移速度的X重量。（y/z方向类

似）

（2）诊断标记

HistoryDiagnostickeyword

mcf:平均接触力（全部非零法向力接触的法向力的平均肯定值。

muf:平均不平衡力（全部球体不平衡力平均肯定值

smr:力学计算过程的比例限制

str:热学计算过程的比例限制

（3）能量和功

HistoryEnergykeyword（必需通过（raceenergy激活此吩咐）

Body:体力功

Bond:粘结能

Boundary:边界功（外力功）

Frictional:摩擦功

Kinetic:动能

Strain:应变能

（3）测量球内时程变量

HistoryMeasurekeywordid=id编号为id测量球内数据变量

Coord坐标数目（每个球的平均接触数目）

edll/ed12...ed33应变率1-x2-yz-3

porosity孔隙率

sliding_fraction:滑动比例（接触中发生滑动的比例）

sil/s12.../s33应力

（5）墙体

Historywallkeywordid=id

ID=id墙体的参数

Power:由于接触球体全部力矩和外力施加在墙体上的功率

xforce/yforce/zforce:由全部与之接触球体产生不平衡力（x/y/z重量）

xmoinent/ymoment/zmoment:由与之接触球体作用在旋转中心的不平衡力矩。

2、时程英语语法支持

（1）删除全部时程数据

Historydelete等效于：reset关键词+deletehistories

（2）输出与计算步对应的编号为idl到idn时程变量数据到屏幕

Historydumpidl<id2...idn><keyword>

关键词用于指定输出计算步范围。

Beginnb:全部计算步大于或等于nb的时程数值将被输出。

Endne:全部计算步小于或等于ne的时程数值将被输出。

Skipns:每隔ns样本采样间隔的数据输出

VsidO:编号为idl至。idn时程数据值与编号为idOs时程数据输出

Xmaximumxmax:x重量值小于等于xmax的数据将被输出，默认x重量为计算步。

然而假如vsidO关键词，则x重量为idO的时程数据。

Xminimumxmin:x重量值大于等于xmin的数据将被输出，默认x重量为计算步。

然而假如vsidO关键词，则x重量为idO的时程数据。

ymaximumymax:y重量值小于等于ymax的数据将被输出

yminimumymax:y重量值大于等于ymin的数据将被输出

⑶historylimits:输出全部时程最大最小计算步数和数值

(4).Historyprint:输出全部时程数据信息。=printhistory

(5).historypurge:全部时程项目内数据删除，保存时程项目

(6).Historyrenameid=hnamc:设置编号为hnamc的时程项目名称，而时程项目的id号不变。

(7).Historyreset:删除全部时程项目

(8).Historywriteidl<id2...idn><keyword...>

全部编号为idl到idn时程项目数据与计算步关系将被输出至文件(file关键词)或表格

(table关键词)

关键词中定义作用范围：

Beginnb同前面

Endnc同前面

Pile<fnamc>以ASCII格式输出至文件fnamc

Skipns同前面

Tablen:输出结果至编号id=n的表格中，假如未指定n.则将创建。若指定n已存在，输

出数据将加入已存在表格末尾，留意表格运用便利性

VsidO同上

Xmaximumxmax同上

Xminimumxmin同上

Ymaximumymax同上

Yminimumymin同上

Initializekeyword…吩咐等同于property吩咐

JSETid=idkeyword<keyword...><range...>

生成节理，指定全部位于节理平面两个面上的接触为节理编号为id。节理平面可以为无限平

面或包含很多有限圆盘。只有粘结接触或法向力非零的接触受影响。Properly吩咐(用jset

范围单元)用于指定邻近指定节理的接触属性。

关键词有：

Area_ratiom<d>节理平面被盘占用的比例，m为平均值，而d为标准偏差,m=0~1默认

m=0,d=0

ddm<d>方位角(全局xy-平面从y轴顺时针方向)，m、d同上

dipm<d>俯冲角(从xy平面对下)in,d同上

gauss对m,d听从高斯分布

numbern节理面数目为n

origin(x,y,z)节理面原点或起始点

radiusm<d>圆形节理盘的半径。m,d同上

spacingm<d>节理间距.m,d同上

JSET吩咐必需在球体牛.成后运用，生成指定数目节理，在原点起先，然后变更每边，假如

未指定radius和arca_ratio.节理面为无限平面。

JSET中的range用于选择要变更的接触，从而创建有限节理平面.

当指定radius和area」atio,则沿着每隔节理平面生成很多圆盘。假如接触投影在圆盘内，则

穿过节理平面的球间接触属性将变更。圆盘将随机分布在节理平面的方形区域内。圆盘生成

直到全部圆盘面积占全部节理面面积比例达到area_ratio.不考虑圆盘重合，故此参数为近似

值。

Macrostring1string2

宏替换

siring2为当引号引用，嵌套时，仍旧须要单引号。嵌套允许10级别，允许迭代，当不能正

确执行。不允很多行

Measureid=idx=xcy=ycz=zcradius=r

建立一测量球

指定id.若测量球id己经存在，则指定测量球的属性将被修改。若不指定，则比当前最大

值大1。

Radius不能为零

Printmeasure显示测量球星系

Historymeasure测量球时程变量。

Modelmnamc<range...>

loadfilename

指定范围内接触为用户定义接触模型。假如没有指定范围，则为整个模型。

当运用此吩咐后，新接触模型将被给予内置接触模型。假如须要在新形成接触上定义新的接

触模型，则必需通过合适的fishcall动态赋值。

关键词load为加载dll版本接触模型,并且其用filename指定。一旦加载,则model吩咐+

range可加载dll接触模型。而modelload只有在configeppudm调用状况下可以加载。

如下接触模型可以运用，并且通过mname指定

Ductile简洁的韧性材料与内置线性接触模型类似，他有用户定义软化过程，而不是象内

置材料的脆性破坏。

Softening通用位移软化模型

Viscous简洁粘弹性模型：其剪力特性中包含一个弹簧连着粘壶。

下列接触模型通过model：oad指定

Burger综合Kelvin模型和Maxwell模型模拟蠕变：

Modelloadburwrv.dll

Hysdamp:通过摩擦滑动将迟滞阻尼将能量消散引入线性接触模型。

Modelloadhysv/rv.dil

Visdamp:通过摩擦滑动将粘滞阻尼将能量消散引入线性接触模型。

Modelloadviswrwdll

MOVIEkeyword<keyword>

限制屏幕绘图捕获并且允许快速回放生成动画。在运用movie吩咐运用setplot吩咐限制文

件格式和规格。假如未指定，将运用默认avi格式文件并且运用默认关键词。

关键词有

(1).Avi_open/avi_close<filefilename>

Avi.open-打开一个新的avi文件，假如文件已存在覆盖。未指定文件默认文件为pfc3d.avi,

同时可打开10个avi文件

Avi_close：关闭avi文件。其余同上

留意：每次一个新的输出窗口时，一个dcx格式文件自动打开和关闭。

(2).Stepn<vicwid><filefilename>

编号为viewid输出视口(未指定viewid时为当前视口)中内容每n计算步存储于file文件指

定文件。默认文件pfc3d.avi/pfc3d.dcx.

(3)snap<viewid><filefilename>

编号为viewid输出视口(未指定viewid时为当前视口)中内容以不规则或用户定义间隔计算

步存储于file文件指定文件。默认文件pfc3d.avi/pfc3d.dcx.

MPIkeyword

限制MPI并行操作。

关键词：

(1).Root

指定当前线程为根过程，这个线程可执行新的吩咐行，全部其他线程为从线程

(2)transmiton

使得根线程处理的吩咐(各种内容：关键词，FISH代码和data文件)发送至其他从线程。

在从线程执行吩咐避开其接受键盘输入的吩咐，并且内置call吩咐被忽视(因为根线程读

取的内容被传递至全部从线程)

New

清除全部程序状态信息，在不离开PFC3d状况下，允许起先新任务。此时文件PFC3D.INI

重新被全部起始吩咐调用3

tl志文件，回应模式，以及随机种子生成器(setlog/echo/random)不受new吩咐影响。

而其他程序状态信息包括fish函数和变量，时程变量，表格以及输出视图，将清零。这些信

息可通过save吩咐和restore吩咐实现保存和调用，另外fish函数可以写入一个文件保存。

PARALLELkeyword...

限制并行线程程序操作和仞始说明连接布局(topology)

关键词：

(1).end

当此吩咐被主线程接受，全部线程将转化为孤立模式

(2).mastermname

在从线程中用此吩咐指定称为mname网络为其主线程

(3).numprocessn

主线程用此吩咐指定并行计算线程总数目为n

(4).processpn

每个线程用此吩咐给自身指定一个id。Pn范围为其中n为线程总数。而0为主线

程保留

(5).Start

对于主线程，此吩咐使得全部从键盘和文件输入到PFC3D中的内容不仅对主线程适用，同

样对从线程适用。

对于从线程，此吩咐不允许全部键盘输入，且吩咐全部PFC3D接受主:线程特征输入。FISH

并行操作，以及FISHS生成的吩咐可在环境中说明。多个其他吩咐使得数据交换在底层。

Start吩咐是在假设process,numprocess和master已经处理状况下运行

在并行计算中应留意问题：

(I).假如有n个处理器，编码0,1,…,n-1,每个对于一个空间区域，处理器0位于最左区

域等等。直到处理器n-1为最右区域，处理器。被指定为主线程。

(2).与并行吩咐parallel有关的参数proc,num和master,用来设定数据交换和处理器个数，

并行处理通过参数start启动。通常将par吩咐放置在pfc3d.ini中。

(3).参数num只能在主线程中指定，用于定义并行处理处理器个数。

参数proc用一个不同数字(procnum)确定每个线程，其中。为主线程，每个从线程必需在

通过参数master供应一个网络名称作为主线程。而对于主线程为可选项。这个名称在一起

先用指定名称为处理器找寻网络。参数siarl启动并行操作，而参数end为反向操作即结束

并行操作。假如并行操作未启动，PFC3d就像在几个独立处理器独立运行。

PAUSE<key>

<t>

中止data文件执行。可通过下列三种方式调用：

假如为指定参数，则PFC3d在遇到pause吩咐时中止，此时程序进入交互模式，可以在键

盘输入吩咐，当键入continue,程序接着运行

假如指定可选关键字key,则PFC3d在遇到pause吩咐时中止，击打随意除ESC键外任何

键，程序接着运行。输入Esc键，程序中止，且返回交互模式。

若指定变景t,则PFC3d在遇到pause吩咐时中止，且等待t秒后接着运行程序。

Plotkeyword<switch<value>...>

屏幕绘图或将屏幕内容输出至硬拷贝设备或文件。

绘图输出语法建立在视口基础上，一个特定视口包括视口设置参数(背景，大小等)，绘图

项1=1(模型表面，矢量等)。视图输出用一个默认视图初始化视口，其视口编号为0,名称

为“Base”。

可创建和保存多个视口，可通过定义活动视口(plotcurrent)切换已保存视口。其中viewid

可以为整数(id)，也可为字符串(名称)

Plotcreate/current**plotprint

每个视n可以存储很多绘图项目(这些是特定绘图项目，例如模型，以及速度矢量)，绘图

项目增加(add)削减(subtract)修改(modify)重新编码(move)显示(show；显

示视口输出项目(printitem)

绘图限制可分为四类：

(I).视口限制-定义视口，输出条件

(2).视口设置限制一设置背景，前景色，视口位置设置，标题，名称

(3).视口输出项目限制一在一个视口内建立(加，减，修改)绘图项目

(4)交互限制一在绘图模式下，允许特定键盘输入使得用户限制视口。

四类列表如F

Table1.7Summary/PLOTmanipulationkeyword，

ViewViewsettingPlot-item

manipulationmanipulationmanipulation

closeresetadd

copysetkeyword...clear

createanglemodify

currentanimatemove

destroybackgroundprintitem

exportcaptionsubtract

hardcopycenter

printcolor

quiteyedistance

renameforeground

showmagnification

mode

moveincrement

perspective

plane

rotation

rotincrement

size

title

window

i.视口限制

(I),plotclose<viewid>

关闭当前或指定视口

(2).Plotviewidlviewid2<settings><items><both>

将编号为viewidI视口复制至编号为viewid2视口。

Settings:视口设置items:视口输出项目both:以上两项

若编号为viewid2视口为新视口，则使其为活动视口。

(3).Plotcreateviewid

创建视口viewid,并使之为活动视口

(4)plotcurrentviewid

使得视口视口viewid为活动视口

(5)plotdestroyviewid

删除视口viewid.当前视口和Base视口不能删除

(6)plotexport<viewid><filefilename>

将生成当前视口或指定视口的设置所需PFC3D的吩咐显示在屏幕上，假如指定，则输入至

文件filename,这个文件可通过call吩咐调用。

(7)plothardcopy<viewid><filefilename>

视口viewid或当前视口对于当前硬拷贝设备(setplot)通用。假如设备为一个生成文件，这

文件名为PFC3D.**,其中**确定当前硬拷贝设备名称，另外，可以干脆用关键词file干脆

指定文件名。当从图形界面创建•个硬拷贝输出时，输出窗口必需为全屏，这个输出界面与

出现在硬拷贝内图像相像，但图像比例可能与视图窗口尺寸不一样。

(8).Plotprint<view<viewid>>

<list>

vinformation、

<item<I>>

关键词print=printlist即输出全部视图视口和名称表格

View输出视口具体设置，可通过增加viewid增加一个指定视口

Information输出当前显示和硬拷贝设置.

Item输出视口中具体项忖列表，假如指定viewid,则输出具体项目设置

(9)plotquit

退出绘图模式，返回吩咐模式

(10)plotrenameviewid1vicwid2

视口更名，当base视口不能更名

(1l)plotshow<viewid>

显示指定视口

2.视口设置限制

(I)plotreset

全部视II设置更原为默认状态。

(2)plotsetkeyword

l).Plotsetanglea

设置视口角度，限制视图编写，a值越大，变形越大。故要倜整合适视角

2).plotsetanimateoff70n

视口图像内容变更是否，通常随吩咐执行变更或计算过程默认为20步变更(可通过set

pinterval变更)，off视口蛰像不变更，默认为on

3).Plotsetbackgroundcolor

设置视口背景

4).Plotsetcaptionkeyword设置标题位置

left视匚左侧默认值

off：关闭标题显示，允许整个屏幕绘图

on:打开标题显示(默认)

right:视口右侧

sizen:设置标题占视口大小百分比n%n=[10,50J

默认为n=35

4).Plotsetcenter(x,y,z)设置模型视口中心为(x,y,z)

Auto模型几何中心

5).PlotsetcolorofIVon

Off:不运用颜色，灰度模式on:打开彩色模式，用c【rl-G打开或关闭彩色模式

6).Plotseteyedistanced通过透视计算指定视察点到屏幕屏幕距离

Auto自动计算

7)plotsetforegroundcolor

设置屏幕前景色为color

8)plolsetmagnificationm

设置视口放大比例为m。

9).Plotsetmodekeyword

Modetoggles使得用户用更敏捷方式视察模型，因为model模式更便利视察模型从空间一个

静止点。

模式可以在绘图窗口以交互方式变更。

留意modetoggle本身不代参数一合适参数必需事先指定或用默认值。

视图系统取决于视察者和物体，视图描述两者关系并且限制二者质疑的移动且保持另一个静

止。一旦建立全部参数，pfc3d可以在不同模式中转化，并且将结果显示于视口。

不同模式列表如下，

①fkstperson:在这个模式中，物体静止而视察者移动，例如：绕z轴旋转表示视察者绕物体

旋转，而物体保持不动，视察者可能会看不到物体，优点在于视察者可移动穿过静止物体。

这个模式通过position,direclion和vertical关键词计算视口

Plotsetdirectionx,y,z设置原点到(x,y,z)矢量作为视察方向

Plotsetpositionx,y,z视察点位置为(x,y,z)

Plotsetverticalx,y,z设置原点到(x,y,z)矢量作为向上方向

②model:为默认模式，视察者静止，而物体运动，例如，绕绕z轴旋转表示物体绕z轴旋

转而视察者不变，物体似乎在视察者面前旋转。

这个模式通过cenier,distance和rotation关键词计算视口

Plotsetcenterx,y,z

Auto

指定模型视口中心，aul。指的是模型几何中心

Plotsetdistanced/auto

指定透视计算中视察者观测点到屏幕屏幕距离，auto自动计算

Plotsetrotationxr,yr,zr设置模型视口旋转角度，分别相对于x-轴y-轴，z-轴旋转角度。

③plane与model模式一样，区分在与视察者为一个平面而不是点。象在model模式中，平

面原点可以指定为真实模型外一点，旋转可使得模型在视口中消逝，默认状况平面原点在模

型中心。

这个模式通过origin,dip.dd,normaldistance和zangle美键词计算视口。

Plotsetddvalue设置平面方位角

Plotsetdipvalue设置平面俯角

Plotsetdistanced/auto

指定透视计算中视察者观测点到屏幕屏幕距离，auto自动计算

Plotsetnormalxv,yv,zv指定平面法向向量(xv,yv,zv)

Plotsetoriginxv,yv,zv/auto指定平面原点(xv,yv,zv)

Plotsetzangledegrees指定从当前指定平面的天顶角zenithangle顺时针转动至局部垂线的

角度。

10).Plotsetmovincrementm

设置在交互限制视图界面状况下，center,origin,position移动幅度大小，在模型空间中

11)plotsetperspectiveofPon

设置透视模式的开关，默认为on,off一简洁投影

12)plotsetplanekeywordvalue<keywordvalue>...

设置一横断界面参数，

关键词有：

①ddvalue设置平面方位角，默认value=0

②dipvalue设置平面俯角，默认value=0

③normalxv,yv,zv设置平面法向向量，指定normal,无需dd,dip

④originxv,yv,zv设置平面上一点(xv,yv,zv)

13)plotsetrotationrx,ry,rz

设置旋转视角,相对于x-,y・,z-轴o

14)plotsetrotincrementr

设置交互限制视图时键回旋转时角度增量。

15)plotsetsizexlow,xhighylow,yhigh

auto

设置输出窗口大小，输入尺寸为视口显示平面的部分，真实视口面积取决于输出设备比例。

Auto为自动计算

16)plotsettitlekeyword

设置窗口标题属性

关键词：

①bottom将标题置于视口底部

②off不激活标题窗口

③on激活标题窗口

④textstring指定标题内容

⑤top标题置顶

17)plotsetwaitt

设置在键盘限制视图时，计算机处理最小时间，假如视怪运行很慢时，设置t为。.25或0.5s,

默认为0,此设置对全部视口一样，开且不在save文件中保存。

18)plotsetwindowkeyword

限制当前视图位置和大小

关键词：

①position(x,y)视I」左上角坐标

②size(x,y)视口长度和高度

留意，以上x,y为相对于桌面比例。

3.输出项目限制

I)plotadditem

增加输出项R

2)plotclear

清除全部输出项目

3)plotmodifyiswitch<value>

将编号为i的项目给予新的编号

4)plotmoveil,i2

将编号为il的项目移动至i2前面，假如须要移动至输出项目列表末尾，必需置顶il>i2

5)plotprintitem<i>

输出当前视口全部绘图项目，指定i,则显示绘图项目i具体信息。

6)plotsubtracti

从活动视口删除绘图项目I，并且绘图项目重新编号。

4.视图区交互限制

TableL8Interactivekey、truke\inplotmode

KeystrokeFunction

<\>toggle\iewmode

<+>increasesincrenieni(x1.25)

<—>decreasestncretneni(x0.8)

<—>movesleft

V—>movesright

<f>movesup

<i>movesdoun

<C-RL-C>bringsupthecameradialog

<C-RI.-6>togglesbenveencolorandgrayscaleplotting

<C*R»-->cullingplane

<C-R--RAresetMCWtodefault

<C-R--Z>zoomreciar.gle

<：£.£•£>movesIlieeyedistancetowardtheinode】

<EN3>nu)vestoward(oui-of-plane)

<XN-£R>returnstoconunandinode

<H0NE>movesawa>(out-of-plane)

<：NSER->nwvestheeyedistanceawayfromthemodel

<N>decreases\jewingwidtli(magnify)

<SH：F--H>increasesviewingwiddj(un-magnify)

<3GDN>movesviewingplanei