PFC3d手冊命令中文詳解

PFC3D學習記錄5—COMMANDREFERENCE

通用規(guī)定和特征

吩咐語法

默認狀況下，吩咐行忽視大小寫，然而可以通過SETcase吩咐激活區(qū)分大小寫狀況。

斜體字代表數(shù)字，以i,j,mn為開頭的字母代表整數(shù)，其他狀況為實數(shù)

吩咐詞，關鍵字和數(shù)值可用空格，以及()，=分隔。

在分號(;)后為注釋

一行最多可包含80個字符。而&表示續(xù)行

Range語法

定義肯定限制范圍的物體

可運用Range的吩咐：

Change/initial/propertyClumpFix/FreeGroupJset

ModelPlot(運用于不同輸出項目)Print

Range(創(chuàng)建一個命名的范圍)

一個Range定義一系列物體。由很多范圍元素構成。

假如運用多個范圍元素，最終物體幾何為不同元素集合的交集。

但是可通過美鍵詞any變更選擇特性。假如運用美鍵詞any選項，仃.何包含在范圍內的單元

可被認為最終物體集合的一部分。

即求合集

除此之外，通過在定義范圍單元后接關鍵詞not確定全部不在指定范圍的單元

通常還可以用定義group方式定義困難的rangeo

內置范圍單元：

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

球形空心區(qū)域中心在(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函數(shù)fname執(zhí)行。而此函數(shù)中必需包含一個

range_element指定范圍單元函數(shù)。此時fname就會調用全部在范圍內的各個物體。

物體的地址將通過fc_arg(0)傳入函數(shù)，而坐標x-,y-,和z-重量將通過fc_arg(1),

fc_arg(2),fc_arg(3)分別傳入函數(shù)。物體類型由FISH內置的pointer_type指定。假如物

體不在指定范圍內，則fname的值必需在函數(shù)內設置為零，假如未指定，默認值為1。

groupgname

定義屬于group名字gname的顆粒球體，(粒子組通過group吩咐定義)

idil<iu>

id編號在il,iu范圍內的物體，假如iu沒有指定，則默認il=iu

jsetil<iu>

節(jié)理編號在在iLiu范圍內的接觸，假如iu沒有指定，則默認il=iu

節(jié)理通過JSET吩咐創(chuàng)建

namemanic

創(chuàng)建一個命名范圍rname,通過在吩咐行中范圍元素集合定義，通常一個范圍用range吩咐

創(chuàng)建。

planekeyword

無限平面包圍區(qū)域

Keyword:

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

dddd方向角x-y平面上方向角，從y軸正向順時針方向測最

dipdip俯角從x-y平面，向z軸負向。

Distanced在距離d范圍內區(qū)域

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

球形區(qū)域，中心(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顯示全部可用吩咐

吩咐分類

程序限制吩咐

這些吩咐支持批處理執(zhí)行模式，允許變更程序狀態(tài)。其與用程序建立實際數(shù)值模型無關。

Cycle&Step執(zhí)行指定時間步

Solve執(zhí)行計算，直至滿意收斂條件

Build限制AC/DC操作

call調用data文件，執(zhí)行吩咐，批處理模式

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生成一系列節(jié)理

Wall生成墻體或修改墻體屬性

Fix對球體設置固定速度

Free將球體固定速度清零

Model對指定接觸指定用戶定義接觸模型

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

屬性，粘結屬性，接觸屬性

模型監(jiān)控

History指定執(zhí)行過程變量（預定或用戶定義fish變量

Measure建立一個測量球或變更測量球屬性

吩咐集合

建立球體

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

Radius:球體半徑density:密度(m/V)

Hertz:指定Hertz接觸模型否則為線性接觸模型

Id:編號，唯一性，默認值大于當前編號最大值的整數(shù)

x,y,z：x-,y-z-坐標，默認為0.0

用ball建立球體允許重疊，球體屬性由properly吩咐設置

Build限制執(zhí)行AC/DC操作

Buildassemblyxa,ya,<za>

通過復制粒子和包含在pbrick中的力(必需已經(jīng)存在)建立粒子集合，而初始粒子由

Call<fname>調用data文件，

默認為pfc3d.dat,而若擴展名未指定，等于*.dat

文件調用允很多級調用，但不允許相互迭代。

Change同property吩咐一樣

創(chuàng)建團塊

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

創(chuàng)建一個團塊，

若id等「已有團塊編號，則為修改團塊屬性

Range為要建立團塊的范圍，

范圍內原來屬于其他團塊的粒子轉化到當前團塊，必需指定range防止全部粒子變成一個團

塊

Printclump輸出團塊信息,plotclump輸出團塊

1、Fullon在計算團塊運動時，運用全部慣性向量力矩，這會耗費更多計算時間。因為

cross-couplingterm運用，必需進行矩陣轉換。當旋轉速度較大和陀螺效應影響大時運用。

Fulloff計算團塊運動時，只有運用diagonalinertia,而忽視旋轉速度乘積。只有3D計算受

full大鍵詞影響。

當fullon時，應設置update_cycle=1

2、Permanent通過阻擋構成團塊粒子間生成接觸使得構成團塊的粒子在隨后模擬過程保持

接觸。這樣不須要存儲接觸信息，并且避開常常性更新接觸信息及其對應的矢量。

當在模擬過程中團塊有個形成和分解過程，就不能指定這個關鍵詞

然而，指定顆粒間永久接觸有利于節(jié)約內存和計算時間。

當一個團塊有其permanent屬性設置，其設置為永久的

然而永久團塊可被刪除且團塊內球體可被釋放。

Release關鍵詞用于從團塊提取球體，釋放時，球體將不存在接觸

3.release范圍內全部屬于同一團塊將被釋放。假如id未指定，全部范圍內屬于任何團塊

的粒了?將被釋放。團塊內全部粒了?被釋放時，團塊本身不被刪除，形成“空團塊”，這種狀

況在計算過程中忽視，而在粒子重新加入之后，被激活。

Deleteclump刪除團塊

4、update_cyclen

限制數(shù)據(jù)更新速度，默認值『10。N越大，計算時間小?？杀桓滤俣扔?/p>

Momentofinertiatensor慣性張量力矩(3D)

contactcoordinates接觸坐標contactnormalvector接觸法向矢量

接觸剪力矢量(3D)平行粘結力矩(3D)平行粘結剪力矢量(3D)

留意

團塊阻尼系數(shù)為構成團塊粒子的阻尼系數(shù)的算術平均值

當模型中存在團塊時，在本版本中就不能運用密度放大系數(shù)

Fix/free吩咐用于團塊內任何粒子時，此工況用于團塊重心。

Printclump可看到各個團塊的fix/free狀況。

Configkeyword<keyword>

指定可選計算模式

Keyword:

CppudrnC++用戶定義模型

CppuwcC++用戶編寫代碼

Fluid流體分析

Thermal熱分析

Continue重啟由pause中止的data文件過程

Cycle/Stepn

執(zhí)行n時間步

對于熱分析和熱力分析計算為熱計算步，否則為力學步

計算過程輸入Esc,中止計算過程。計算過程輸入空格，接著中止當前cycle.

當前計算過程由setmechanical和setthermal吩咐指定。

對于熱力耦合計算，每個熱步后跟著最多n個力學計算子步，吩咐：thcnnalsetsubstep.

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

設置局部阻尼的阻尼屬性（球體）和粘性阻尼的阻尼屬性（接觸）

局部阻尼：施加一個與各個球體自身不平衡力成比例大小的阻尼力。

粘性阻尼：在每個接觸施加?個法向和切向粘壺，這些粘壺與原有接觸作用平行，從而生成

與兩接觸實體（球一球或球一墻）相對速度差值成比力的粘滯阻力

兩種阻尼可以同時存在

當未指定阻尼系數(shù)時，局部阻尼發(fā)生作用，且全部球體阻尼系數(shù)為0.7,而粘性阻尼不發(fā)生

作用。

Keyword

1、default指定新建球的阻尼參數(shù)

defaultlocal=v局部阻尼系數(shù)默認v=0.7

viscousnormal=v法向臨界阻尼系數(shù)，默認v=0

notensionoff/on無拉力標記on-無張力默認off

shear=v切向臨界阻尼系數(shù)，默認v=0

2、local=v范圍內全部球體局部阻尼系數(shù)為v

3、viscousnormal=vnotension=off/onshear=v

設定范圍內粘滯阻尼系數(shù)

Definefunctionname

End

定義fish函數(shù)

全部define...end內的語句被編譯并以壓縮方式存儲以便后續(xù)過程運用

Deletekeyword...

刪除球體，團塊，時程關系，墻體

Keyword:

1、Balls<id>刪除id號球體

<range...>刪除質心在范圍內球體

未指定任何參數(shù)時，模型內全部球體被刪除

2、Clumpid

刪除編號為id的團塊，不能運用range參數(shù)。團塊內全部球體被釋放，但是球體未刪除。

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-方向模型尺寸和單元數(shù)目。

在[xl,xh][yl,yh][zl,zh]范圍內建立總數(shù)為nx*ny*nz數(shù)目流體單元,每個流體單元x-,

丫-1-方向尺寸為（乂11R）/吆,（）41-丫1）/”,（zh-zl）/nz,留意模型總單元數(shù)為（nx+2）*（ny

+2）*（nz+2）,邊界上附加一個單元為邊界條件

2^propertydensityd流體密度d

Viscosity流體粘滯系數(shù)v

3、boundarynonslipkeyword在keyword指定位置設置無滑動邊界

Slipkeyword在keyword指定位置設置滑動邊界

Pressurepvkeyword在keyword指定位置設置壓力

為pv

Velocityxv,yv,zvkeyword

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

注：apparent速度定義：對于進入網(wǎng)格的流體將flowrate除以單元長度（或單元面積）

邊界位置指定：

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

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

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

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

4、setkeyword限制流體計算循環(huán)參數(shù)

buotermoff（默認）/onon:打開浮力作為外部體力（流體安排中

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

on:在流體計算中考慮重力影響setgravity

vistermoff（默認）/onoff:忽視粘滯影響

下面參數(shù)限制SIMPLE項H，留意假如迭代不收斂，pfc3D發(fā)出一個警告消息而不是結束計

算

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>

生成顆粒集合，指定粒子數(shù)目(編號起始和終止)，粒子生成區(qū)域和粒子半徑分布。粒子位

置和半徑以隨機分布。因此粒子集合最終狀態(tài)有隨機種子生成器(SETrandom)影響。

1、粒子生成區(qū)域定義：

(1)x,y,z關鍵詞確定長方體區(qū)域(xl,xu)(yl,yu)(zl,zu)o3xl=xu/yl=yu/zl=zu

生成一排粒子集合。

(2)annulus關鍵詞定義一圓形空心區(qū)域中心(xc,yc,zc)內徑rl外徑r2。

在這種狀況下可忽視x,y,z關鍵詞。假如同時指定。生成圓形空心區(qū)域和長方體區(qū)

域交集

(3)生成區(qū)域可用用戶定義的fish函數(shù)定義(filter)

2、半徑分布

Radius關鍵詞指定，默認為勻稱分布，高斯正態(tài)分布用gauss關鍵詞

粒子數(shù)目

粒子數(shù)目指定id=il,iu粒子數(shù)目iu-il+1。粒子生成時與已存在的粒子不能重置。但

空間不能足夠容納粒子，則可用Ees關鍵詞。定義更多嘗試次數(shù)。假如不能生成足夠粒子,

則可發(fā)生錯誤提示，Setgen_erroi?用于將錯誤提示改為警告提示，則吩咐將接著。

球體屬性將用隨后property吩咐指定

可選關鍵詞：

1、filterfname

調用用戶定義生成粒子過濾器。在每個試驗粒子生成過程中，F(xiàn)ISH函數(shù)fname將被調

用。試驗粒子半徑將通過fc_arg(0)，而粒子坐標三個重量將通過fc_arg(I),fc_arg(2),

fc_arg(3)分別導入函數(shù)。假如符合條件(即粒子落入指定區(qū)域)則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

設置粒子生成嘗試次數(shù)。默認tmax=20000。

GROUPkeyword...

定義群組，定義屬于球體的群組（不論位置和屬性變更）。可生成多級嵌套群組，比如一個

球體可屬于多個群組

Printgroup顯示當前存在群組

Printballinfo顯示球體信息，包括其屬于的群組

關鍵詞

1.deletegnamc

群組gnamc將刪除

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

建立群組gname.群組將包括全部指定范圍內球體。若無指定，將包括模型內全部球體，假

如gname已經(jīng)存在，則位于指定范圍的球體將加入群組gname.

Owner關鍵詞，gnameO被指定為gnames上一級（UPgname作為群組gnameO的從對象。

假如上一級組gnameO用range單元定義，則gnameO包含全部指定范圍內球體和全部從組

內球體。而從組gname作為從組內單元，則從組之包含從組內球體。

留意:range定義41為疊加過程。

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

存儲和采樣一系列模型計算過程的變量。

這些變量可以繪制與步數(shù)或其他相關時程變量（plothistory）的圖形。

時程變量可輸出到文件（write關健詞），

每個History吩咐中只能有一個變量，history時程變量可在任何時間添加。

全部時程變量內的具體內容可用purge關鍵詞刪除

而全部時程變量可用delete關鍵詞刪除

Printhistory顯示全部時程變量項目

每個時程變最有唯一的ID號，默認按history吩咐依次生成?？赏ㄟ^id關鍵詞指定。全部

時程變量用一個采樣間隔，默認采樣間隔為10步，采樣間隔可用nstep關鍵詞修改（更好

的方法是sethist_rep吩咐指定）不同時程變量不能運用不同的nstep。

除此之外還可將FISH符號作為關鍵詞。

關鍵詞

1.內置時程變量

（1）.球體

Historyball關鍵詞x,y,z/id=n

監(jiā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測量球內數(shù)據(jù)變量

Coord坐標數(shù)目（每個球的平均接觸數(shù)目）

edll/ed12...ed33應變率1-x2-yz-3

porosity孔隙率

sliding_fraction:滑動比例（接觸中發(fā)生滑動的比例）

sil/s12.../s33應力

（5）墻體

Historywallkeywordid=id

ID=id墻體的參數(shù)

Power:由于接觸球體全部力矩和外力施加在墻體上的功率

xforce/yforce/zforce:由全部與之接觸球體產生不平衡力（x/y/z重量）

xmoinent/ymoment/zmoment:由與之接觸球體作用在旋轉中心的不平衡力矩。

2、時程英語語法支持

（1）刪除全部時程數(shù)據(jù)

Historydelete等效于：reset關鍵詞+deletehistories

（2）輸出與計算步對應的編號為idl到idn時程變量數(shù)據(jù)到屏幕

Historydumpidl<id2...idn><keyword>

關鍵詞用于指定輸出計算步范圍。

Beginnb:全部計算步大于或等于nb的時程數(shù)值將被輸出。

Endne:全部計算步小于或等于ne的時程數(shù)值將被輸出。

Skipns:每隔ns樣本采樣間隔的數(shù)據(jù)輸出

VsidO:編號為idl至。idn時程數(shù)據(jù)值與編號為idOs時程數(shù)據(jù)輸出

Xmaximumxmax:x重量值小于等于xmax的數(shù)據(jù)將被輸出，默認x重量為計算步。

然而假如vsidO關鍵詞，則x重量為idO的時程數(shù)據(jù)。

Xminimumxmin:x重量值大于等于xmin的數(shù)據(jù)將被輸出，默認x重量為計算步。

然而假如vsidO關鍵詞，則x重量為idO的時程數(shù)據(jù)。

ymaximumymax:y重量值小于等于ymax的數(shù)據(jù)將被輸出

yminimumymax:y重量值大于等于ymin的數(shù)據(jù)將被輸出

⑶historylimits:輸出全部時程最大最小計算步數(shù)和數(shù)值

(4).Historyprint:輸出全部時程數(shù)據(jù)信息。=printhistory

(5).historypurge:全部時程項目內數(shù)據(jù)刪除，保存時程項目

(6).Historyrenameid=hnamc:設置編號為hnamc的時程項目名稱，而時程項目的id號不變。

(7).Historyreset:刪除全部時程項目

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

全部編號為idl到idn時程項目數(shù)據(jù)與計算步關系將被輸出至文件(file關鍵詞)或表格

(table關鍵詞)

關鍵詞中定義作用范圍：

Beginnb同前面

Endnc同前面

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

Skipns同前面

Tablen:輸出結果至編號id=n的表格中，假如未指定n.則將創(chuàng)建。若指定n已存在，輸

出數(shù)據(jù)將加入已存在表格末尾，留意表格運用便利性

VsidO同上

Xmaximumxmax同上

Xminimumxmin同上

Ymaximumymax同上

Yminimumymin同上

Initializekeyword…吩咐等同于property吩咐

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

生成節(jié)理，指定全部位于節(jié)理平面兩個面上的接觸為節(jié)理編號為id。節(jié)理平面可以為無限平

面或包含很多有限圓盤。只有粘結接觸或法向力非零的接觸受影響。Properly吩咐(用jset

范圍單元)用于指定鄰近指定節(jié)理的接觸屬性。

關鍵詞有：

Area_ratiom<d>節(jié)理平面被盤占用的比例，m為平均值，而d為標準偏差,m=0~1默認

m=0,d=0

ddm<d>方位角(全局xy-平面從y軸順時針方向)，m、d同上

dipm<d>俯沖角(從xy平面對下)in,d同上

gauss對m,d聽從高斯分布

numbern節(jié)理面數(shù)目為n

origin(x,y,z)節(jié)理面原點或起始點

radiusm<d>圓形節(jié)理盤的半徑。m,d同上

spacingm<d>節(jié)理間距.m,d同上

JSET吩咐必需在球體牛.成后運用，生成指定數(shù)目節(jié)理，在原點起先，然后變更每邊，假如

未指定radius和arca_ratio.節(jié)理面為無限平面。

JSET中的range用于選擇要變更的接觸，從而創(chuàng)建有限節(jié)理平面.

當指定radius和area」atio,則沿著每隔節(jié)理平面生成很多圓盤。假如接觸投影在圓盤內，則

穿過節(jié)理平面的球間接觸屬性將變更。圓盤將隨機分布在節(jié)理平面的方形區(qū)域內。圓盤生成

直到全部圓盤面積占全部節(jié)理面面積比例達到area_ratio.不考慮圓盤重合，故此參數(shù)為近似

值。

Macrostring1string2

宏替換

siring2為當引號引用，嵌套時，仍舊須要單引號。嵌套允許10級別，允許迭代，當不能正

確執(zhí)行。不允很多行

Measureid=idx=xcy=ycz=zcradius=r

建立一測量球

指定id.若測量球id己經(jīng)存在，則指定測量球的屬性將被修改。若不指定，則比當前最大

值大1。

Radius不能為零

Printmeasure顯示測量球星系

Historymeasure測量球時程變量。

Modelmnamc<range...>

loadfilename

指定范圍內接觸為用戶定義接觸模型。假如沒有指定范圍，則為整個模型。

當運用此吩咐后，新接觸模型將被給予內置接觸模型。假如須要在新形成接觸上定義新的接

觸模型，則必需通過合適的fishcall動態(tài)賦值。

關鍵詞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吩咐限制文

件格式和規(guī)格。假如未指定，將運用默認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時為當前視口)中內容以不規(guī)則或用戶定義間隔計算

步存儲于file文件指定文件。默認文件pfc3d.avi/pfc3d.dcx.

MPIkeyword

限制MPI并行操作。

關鍵詞：

(1).Root

指定當前線程為根過程，這個線程可執(zhí)行新的吩咐行，全部其他線程為從線程

(2)transmiton

使得根線程處理的吩咐(各種內容：關鍵詞，F(xiàn)ISH代碼和data文件)發(fā)送至其他從線程。

在從線程執(zhí)行吩咐避開其接受鍵盤輸入的吩咐，并且內置call吩咐被忽視(因為根線程讀

取的內容被傳遞至全部從線程)

New

清除全部程序狀態(tài)信息，在不離開PFC3d狀況下，允許起先新任務。此時文件PFC3D.INI

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

tl志文件，回應模式，以及隨機種子生成器(setlog/echo/random)不受new吩咐影響。

而其他程序狀態(tài)信息包括fish函數(shù)和變量，時程變量，表格以及輸出視圖，將清零。這些信

息可通過save吩咐和restore吩咐實現(xiàn)保存和調用，另外fish函數(shù)可以寫入一個文件保存。

PARALLELkeyword...

限制并行線程程序操作和仞始說明連接布局(topology)

關鍵詞：

(1).end

當此吩咐被主線程接受，全部線程將轉化為孤立模式

(2).mastermname

在從線程中用此吩咐指定稱為mname網(wǎng)絡為其主線程

(3).numprocessn

主線程用此吩咐指定并行計算線程總數(shù)目為n

(4).processpn

每個線程用此吩咐給自身指定一個id。Pn范圍為其中n為線程總數(shù)。而0為主線

程保留

(5).Start

對于主線程，此吩咐使得全部從鍵盤和文件輸入到PFC3D中的內容不僅對主線程適用，同

樣對從線程適用。

對于從線程，此吩咐不允許全部鍵盤輸入，且吩咐全部PFC3D接受主:線程特征輸入。FISH

并行操作，以及FISHS生成的吩咐可在環(huán)境中說明。多個其他吩咐使得數(shù)據(jù)交換在底層。

Start吩咐是在假設process,numprocess和master已經(jīng)處理狀況下運行

在并行計算中應留意問題：

(I).假如有n個處理器，編碼0,1,…,n-1,每個對于一個空間區(qū)域，處理器0位于最左區(qū)

域等等。直到處理器n-1為最右區(qū)域，處理器。被指定為主線程。

(2).與并行吩咐parallel有關的參數(shù)proc,num和master,用來設定數(shù)據(jù)交換和處理器個數(shù)，

并行處理通過參數(shù)start啟動。通常將par吩咐放置在pfc3d.ini中。

(3).參數(shù)num只能在主線程中指定，用于定義并行處理處理器個數(shù)。

參數(shù)proc用一個不同數(shù)字(procnum)確定每個線程，其中。為主線程，每個從線程必需在

通過參數(shù)master供應一個網(wǎng)絡名稱作為主線程。而對于主線程為可選項。這個名稱在一起

先用指定名稱為處理器找尋網(wǎng)絡。參數(shù)siarl啟動并行操作，而參數(shù)end為反向操作即結束

并行操作。假如并行操作未啟動，PFC3d就像在幾個獨立處理器獨立運行。

PAUSE<key>

<t>

中止data文件執(zhí)行。可通過下列三種方式調用：

假如為指定參數(shù)，則PFC3d在遇到pause吩咐時中止，此時程序進入交互模式，可以在鍵

盤輸入吩咐，當鍵入continue,程序接著運行

假如指定可選關鍵字key,則PFC3d在遇到pause吩咐時中止，擊打隨意除ESC鍵外任何

鍵，程序接著運行。輸入Esc鍵，程序中止，且返回交互模式。

若指定變景t,則PFC3d在遇到pause吩咐時中止，且等待t秒后接著運行程序。

Plotkeyword<switch<value>...>

屏幕繪圖或將屏幕內容輸出至硬拷貝設備或文件。

繪圖輸出語法建立在視口基礎上，一個特定視口包括視口設置參數(shù)(背景，大小等)，繪圖

項1=1(模型表面，矢量等)。視圖輸出用一個默認視圖初始化視口，其視口編號為0,名稱

為“Base”。

可創(chuàng)建和保存多個視口，可通過定義活動視口(plotcurrent)切換已保存視口。其中viewid

可以為整數(shù)(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

創(chuàng)建視口viewid,并使之為活動視口

(4)plotcurrentviewid

使得視口視口viewid為活動視口

(5)plotdestroyviewid

刪除視口viewid.當前視口和Base視口不能刪除

(6)plotexport<viewid><filefilename>

將生成當前視口或指定視口的設置所需PFC3D的吩咐顯示在屏幕上，假如指定，則輸入至

文件filename,這個文件可通過call吩咐調用。

(7)plothardcopy<viewid><filefilename>

視口viewid或當前視口對于當前硬拷貝設備(setplot)通用。假如設備為一個生成文件，這

文件名為PFC3D.**,其中**確定當前硬拷貝設備名稱，另外，可以干脆用關鍵詞file干脆

指定文件名。當從圖形界面創(chuàng)建?個硬拷貝輸出時，輸出窗口必需為全屏，這個輸出界面與

出現(xiàn)在硬拷貝內圖像相像，但圖像比例可能與視圖窗口尺寸不一樣。

(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設置更原為默認狀態(tài)。

(2)plotsetkeyword

l).Plotsetanglea

設置視口角度，限制視圖編寫，a值越大，變形越大。故要倜整合適視角

2).plotsetanimateoff70n

視口圖像內容變更是否，通常隨吩咐執(zhí)行變更或計算過程默認為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本身不代參數(shù)一合適參數(shù)必需事先指定或用默認值。

視圖系統(tǒng)取決于視察者和物體，視圖描述兩者關系并且限制二者質疑的移動且保持另一個靜

止。一旦建立全部參數(shù)，pfc3d可以在不同模式中轉化，并且將結果顯示于視口。

不同模式列表如下，

①fkstperson:在這個模式中，物體靜止而視察者移動，例如：繞z軸旋轉表示視察者繞物體

旋轉，而物體保持不動，視察者可能會看不到物體，優(yōu)點在于視察者可移動穿過靜止物體。

這個模式通過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模式一樣，區(qū)分在與視察者為一個平面而不是點。象在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>...

設置一橫斷界面參數(shù)，

關鍵詞有：

①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.視圖區(qū)交互限制

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