Phoenics Input Language: PIL• The PIL language was developed during the first stages of

PHOENICS development.• In that time there were no graphics interface and the user

had to communicate with the Main program by means of a Q1 file written in PIL.

• The PIL is quite similar to FORTRAN and is the Q1 input language.

• Despite of the graphics interface development, the PIL is still today largely used because it still can do tasks notpossible in VR interface for instance.

• For experienced users it is faster to modify Q1 rather thango to VR interface.

• At last, it is the most powerfull tool to design your owndevelopment.

Q1 and RESULT Files• The q1 is the input file. One may written a q1

using VR or typing from the key board the PIL statements.

• A balanced use of the two editors is very convenient.

• The result file is also written in PIL and echoes all the q1 statements.

• Most of the times the q1 statements are functions which, by their turn, became multiple arguments in RESULT file.

• We will see some examples in the following slides.

Schematic of the three main blocks of PHOENICS

PHOTON

AUTOPLOT

RESULTPHIXYZ

PÓS PROCESSAMENTO:

Apresentação Resultados

Satellite EARDAT

q1

Earth

GREX(ground examples)

GRND(user code)

ArquivosFORTRAN

PRÉ PROCESSAMENTO:Definição Problema MAIN: simulação

VR VIEWERVirtual Realityv 3.0

MENUv 2.0

NotePadPIL /

FORTRAN

Data input in PHOENICS is organized in 25 groups. GROUP 1 - Title & PreliminariesGROUPS 2 thru 6 - Transience & grid specificationGROUPS 7 and 8 - Solver options and controlsGROUP 9 - PropertiesGROUP 10 - Interphase transport coefficientsGROUP 11 - Initialization and porositiesGROUP 12 - Coefficients of convection and diffusionGROUP 13 - Source and boundary conditionsGROUP 14 - Parabolic runsGROUPS 15 thru 18 - Convergence controlsGROUP 19 - Calls to groundGROUP 20 thru 25 - Print outs & monitoring controls

We are going to get acquainted with the PHOENICS Groups and PIL Language by inspecting the echoed groups in Q1 and RESULT files from this case study.

Z

Y

CASE STUDY : 1D TRANSIENT CONDUCTION IN A FIN(LE#3 ex. #1)

GROUP 1 Run titles and other preliminaries

PHOENICS is arranged so as to make it possible to set up and execute a series of computer runs, a facility that is often exploited when 'parametric studies' are required. Each run then needs to be identified by a number; and it is usually convenient to give each run its own title. GROUP 1 is the place for such labeling operations.

Declarations such as REAL(...), CHAR(....), ARRAY(....,...), for variables which they user intends to use, are also best made here. However, so long as the declaration statement s appear in the Q1 file ABOVE the point of their first use, they can appear in any group.

GROUP 2 Transience: time-step specification

PHOENICS can simulate both steady-state and transient phenomena.

For the former, no entry is required in GROUP 2; otherwise, data items relating to time dependence must be supplied here.

GROUPS 3, 4 and 5 x-, y- and z-direction grid specifications

PHOENICS can represent phenomena in 1, 2 or 3 space dimensions. Provision is therefore made for setting up 'grids' in three directions, designated x, y and z; and each is dealt with separately.

x, y and z are all distances in the standard settings, measured in meters; however, x may be caused, by setting XCYCLE=T, to represent an angular coordinate; and similar changes can be effected, with more difficulty, for y and z.

GROUP 6 Body-fitted coordinates or grid distortion

BFC=T, if body-fitted coordinates are required, is set here. If it is, further commands such as GSET(....) usually follow, for specifying the grid.

GROUP 7 Variables stored, solved and named

PHOENICS has been set up so that it can solve differential equations for up to 50 dependent variables simultaneously with especial ease; but more can also be dealt with.

What variables are to be solved is settled in GROUP 7; also, to some extent, HOW they are to be solved.

If variables are to be given storage space but not actually solved, as is often convenient for important auxiliary variables, this information is also conveyed here.

GROUP 8 Terms (in differential equations) and devices

The typical differential equation which PHOENICS solves has terms corresponding to transient, convection, diffusion and source-sink effects; but not all the variables of a given problem exhibit all the effects.

GROUP 8 allows distinctions to be made between the variables in these respects. This facility can also be exploited as an economy measure, when some effects which are present are so small as to be negligible; for then they can be omitted entirely, with consequent saving ofcomputation time.

Should users wish to intervene, through GROUND, in the procedures for setting up and solving the flow-simulating equations, they can do so by setting certain 'switches' in GROUP 8 of SATELLITE, and then providing corresponding coding sequences in GROUP 8 of GROUND.

GROUP 9 Properties of the medium (or media)

It is necessary to inform PHOENICS about the physical properties of the medium in which the flow to be simulated actually occurs; and, since the computer code is equipped for the simulation of two-phase (ietwo-interpenetrating-media) phenomena, two sets of property data may require to be specified. The properties in question may be thermodynamic (egdensity), transport (eg viscosity), or inter-phase (egsaturation enthalpy).

GROUP 9 is the place for such data items.

GROUP 10 Interphase-transfer processes and properties

A special group, number 10, has been set aside for those property- data items which relate to the interactions between phases which are both present in the same location and at the same time. The interactions may involve heat transfer, mass transfer and momentum transfer; and information may also need to be supplied about the thermodynamic-equilibrium and chemical-kinetic natures of the interactions.

GROUP 11 Initialization of variable or porosity fieldsWhen PHOENICS is solving a problem involving time-dependence, the problem specification usually starts with a statement about what values of all the dependent variables pertain, to all the points in the space in question, at the first instant to be considered. These 'initial values' can be supplied among the data items of GROUP 11.

Even in problems of steady-state character, because PHOENICS proceeds in an iterative manner, initial values must be supplied. These are the 'first guesses', rather than problem-specifying data; and their values should not ordinarily influence the final solution. However, they are supplied in precisely the same way as are the initial values of true time-dependent phenomena.

Among the variables which may be initialized in this way are the so-called 'porosities', which indicate what fractions of the areas and volumes of the computational cells are actually accessible to the fluid. These are not ordinarily dependent variables of differential equations; but they may be stored and handled within PHOENICS as though they were.

GROUP 12 Convection and diffusion adjustments

The above-mentioned 'porosities' limit the magnitudes of the relevant fluxes of heat, mass and momentum uniformly in respect of all dependent variables. However, it may be useful sometimes to distinguish one variable from another, as when, for example, a membrane is introduced which is permeable to heat and some constituents of a mixture, but impermeable to other constituents.

GROUP 13 Boundary conditions and special sources

What makes one flow phenomenon differ from another is partly the properties of the medium, partly the initial conditions and partly the boundary conditions (which, despite their name, may be located inside the flow domain). PHOENICS is therefore supplied, in the sections appropriate to data-input GROUP 13, with an extensive set of procedures which permit the relevant information to be supplied.

All such boundary and internal conditions are treated, in PHOENICS, as sources and sinks; therefore the same data-input procedures are employed whenever any source/sink information is to be transmitted. GROUP 13 may thus also be used for representing generation terms in a turbulence-energy equation, or for introducing novel formulations for chemical-reaction rates.

GROUP 14 Downstream pressure for PARAB=T

PHOENICS can simulate fluid-flow phenomena of the kind known as 'parabolic', for example the development of a boundary layer on an airfoil. Some of these phenomena require, for their complete simulation, the specification of the way in which the fluid pressure varies with downstream (ie z-direction) distance. GROUP 14 has been provided as the repository of information of this kind.

GROUP 15 Termination of sweeps

PHOENICS solves its equations by guess-and-correct procedures, which, provided that they are indeed converging, cause the imbalances in the finite-domain equations to become smaller and smaller.

There is no limit to the number of cycles of successive adjustments that PHOENICS can perform; but there is a limit to how many are worth performing. It is for the user to provide PHOENICS with information about the latter limit; and GROUP 15 is the place where this provision should be made.

GROUP 16 Termination of iterations

There are iterations of two main kinds in PHOENICS: the 'outer iterations' or 'sweeps' , which are the concern of GROUP 15; and the 'inner iterations', for which the limiting information is supplied in GROUP 16. The former are concerned with eliminating imbalances deriving from the non-linearities, while the latter are associated with the fact that PHOENICS uses iterative procedures for solving even the linear equations which arise (in large numbers) at various points in the solution procedure.

GROUP 17 Under-relaxation devices

In order to ensure convergence, iterative solution procedures for non-linear sets may require the judicious introduction of 'under- relaxation' practices. For linear equations, on the other hand, over-relaxation may cause convergence to be attained more rapidly.

PHOENICS possesses several features which allow under- and over- relaxation to be practised, and in a rather discriminating way. GROUP 17 is the place at which these devices are normally activated.

GROUP 18 Limits on variables or increments to them

During the course of a sequence of outer-iteration cycles, values of dependent variables may wander rather far from both their initial values and from the values which are finally found to satisfy all the equations, ie from the solution. At times, this 'wandering' may become excessive; and, if no limits are placed on it, the result may be that 'divergence' occurs; no solution of the equations is then arrived at. The latter outcome can however often be prevented if PHOENICS is informed about the upper and lower limits, relevant to each dependent variable separately, which the said variables should not exceed. These limits may be set by the user, possibly on physical grounds (which preclude negative densities, for example), or perhaps to express other insights or desires which he possesses. GROUP 18 provides the necessary opportunities.

GROUP 19 Data communicated by SATELLITE to GROUND

PHOENICS users can, if they wish, modify or add to the GROUND sub- routines which are attached to the EARTH module; and spare variables such as RSG's (Realsconnecting Satellite and Ground), LSG's (Logicalsconnecting Satellite and Ground), ISG's (Integers...) and CSG's (Characters ....) are provided to enable them to transmit information from the SATELLITE to the coding which they have introduced. These are usually set in Group 19.

GROUPS 20 to 24Preliminary-, variable-, spot-value- and field- print-out; plot control and dumps for restarts

Quite apart from the ability to accept special print-out instructions via arrangements made through GROUP 19, PHOENICS possesses extensivecontrols for its already-built-in print-out procedures. The controls are distributed between the last five data-input groups.

GROUP 20 controls the extent to which EARTH prints out data-input summaries before execution begins. GROUP 21 accepts information about the extent and frequency of the print-out of dependent- variable fields, while GROUP 22 does the same for the print-out of the single-point values which are used for monitoring the course of the solution process.

GROUP 23 is the repository of information about which types of print-out are elicited for which stored variable; and, finally, GROUP 24 concerns that special kind of information 'dump' which permits continuation of an EARTH computation which has been paused, either with or without changed arrangements for print-out.

RESIDUAL AND NET SOURCES IN RESULT FILE

Whole-field residuals before solutionwith resref values determined by EARTH& resfac= 1.000000E-02

variable resref (res sum)/resref (res sum)TEM1 4.625E-02 4.551E-05 2.105E-06

Nett source of TEM1 at patch named: OB1 (LOW ) = 3.272568E-01Nett source of TEM1 at patch named: OC2 (NORTH ) =-2.624250E-01pos. sum= 3.272568E-01 neg. sum=-2.624250E-01nett sum= 6.483176E-02

CPU PERFORMANCE IN RESULT FILE

• ************************************************************• SATLIT RUN NUMBER = 1 ; LIBRARY REF.= 0

• Run completed at 20:34:06 on Tuesday, 12 April 2005 •• MACHINE-CLOCK TIME OF RUN = 3 SECONDS.

• TIME/(VARIABLES*CELLS*TSTEPS*SWEEPS*ITS) = 5.000E-04

************************************************************Group 1. Run TitleTEXT(LE#3 - EX#1 )************************************************************Group 2. TransienceSTEADY=F

* Set overall time and no. of stepsRSET(U,0.000000E+00,1.000000E+03,100)

* Modify regions************************************************************Groups 3, 4, 5 Grid Information NEXT* Overall number of cells, RSET(M,NX,NY,NZ,tolerance)

RSET(M,1,1,20)* Set overall domain extent:* xulast yvlast zwlast

nameXSI= 6.283190E+00; YSI= 5.000000E-03; ZSI= 1.000000E-01RSET(D,CHAM )

* Cylindrical-polar gridCARTES=F************************************************************Group 6. Body-Fitted coordinates************************************************************

• Group 24. Dumps For Restarts NEXT

NOWIPE = TIDISPA = 10 ;IDISPB = 1 ;IDISPC = 100CSG1 ='F'

GVIEW(P,-8.114650E-01,-6.012347E-02,-5.813001E-01)GVIEW(UP,-5.798833E-01,-4.060527E-02,8.136870E-01)

> DOM, SIZE, 6.283190E+00, 5.00E-03, 1.00E-01> DOM, MONIT, 3.141590E+00, 2.50E-03, 9.250E-02> DOM, SCALE, 1.00E+00, 1.00E+00, 1.00E+00> DOM, SNAPSIZE, 1.000E-02> DOM, RELAX, 5.000E-01•

************************************************************Group 7. Variables: STOREd,SOLVEd,NAMEd NEXTONEPHS = T

* Non-default variable namesNAME(148) =PRPS ; NAME(149) =SPH1NAME(150) =TEM1

* Solved variables listSOLVE(TEM1)

* Stored variables listSTORE(SPH1,PRPS)

* Additional solver optionsSOLUTN(TEM1,Y,Y,Y,N,N,Y)

************************************************************Group 8. Terms & Devices NEXTTERMS (TEM1,Y,Y,Y,Y,Y,Y)************************************************************

************************************************************Group 9. Properties NEXT SETPRPS(1, 67)RHO1 = 9.982300E+02PRESS0 = 1.000000E+05TEMP0 = 2.730000E+02CP1 = 4.181800E+03ENUL = 1.006000E-06 ;ENUT = 0.000000E+00DVO1DT = 1.180000E-04PRNDTL(TEM1) = -5.970000E-01************************************************************Group 10.Inter-Phase Transfer Processes************************************************************Group 11.Initialise Var/Porosity Fields NEXTFIINIT(PRPS) = 6.700000E+01 ;FIINIT(SPH1) = 4.730000E+02FIINIT(TEM1) = 2.000000E+01No PATCHes used for this Group

INIADD = F************************************************************Group 12. Convection and diffusion adjustmentsNo PATCHes used for this Group

************************************************************Group 13. Boundary & Special Sources NEXT

No PATCHes used for this GroupEGWF = T************************************************************Group 14. Downstream Pressure For PARAB************************************************************Group 15. Terminate Sweeps NEXTLSWEEP = 1000RESFAC = 1.000000E-02************************************************************Group 16. Terminate Iterations NEXT************************************************************Group 17. Relaxation NEXT************************************************************Group 18. Limits NEXT************************************************************Group 19. EARTH Calls To GROUND Station NEXTUSEGRD = T ;USEGRX = TASAP = TIDISPB = 1 ;IDISPC = 100CSG1 ='F'************************************************************

Group 24. Dumps For Restarts NEXT

> OBJ1, NAME, LOW> OBJ1, POSITION, 0.00E+00, 0.00E+00, 0.00E+00> OBJ1, SIZE, 6.283190E+00, 5.00E-03, 0.00E+00> OBJ1, CLIPART, polcu2> OBJ1, ROTATION24, 1> OBJ1, TYPE, PLATE> OBJ1, SURF_TEMP, 0.00E+00, 1.00E+02

> OBJ2, NAME, NORTH> OBJ2, POSITION, 0.00E+00, 5.00E-03, 0.00E+00> OBJ2, SIZE, 6.283185E+00, 0.00E+00, 1.00E-01> OBJ2, CLIPART, polcu2> OBJ2, ROTATION24, 1> OBJ2, TYPE, PLATE> OBJ2, LINR_HEAT, 1.075E+01, 2.00E+01STOP

ARQUIVO RESULT

• ‘ECOA’ TODOS OS COMANDOS EMITIDOS DO Q1

• ELE ESCREVE NUMA LINGUAGEM ‘PIL’ BÁSICA

• NOTE QUE OS COMANDOS DO Q1 SÃO ‘RE-INTERPRETADOS’ PARA APARECER NO RESULT

• DEVE-SE DESTACAR QUE ELES SÃO TOTALMENTE EQUIVALENTES.

• SE VOCÊ UTILIZASSE OS COMANDOS ECOADOS NO RESULT NO Q1 O RESULTADO SERIA O MESMO

• MUITAS VEZES OS COMANDOS DO Q1 SÃO MAIS CONVENIENTES POR SEREM MAIS ‘COMPACTOS’.

************************************************************Group 2. TransienceSTEADY = F

* Set overall time and no. of stepsTFIRST = 0.000000E+00 ;TLAST = 1.000000E+03LSTEP = 100TFRAC ( 1) = 1.000000E-02 ;TFRAC ( 2) = 2.000000E-02TFRAC ( 3) = 3.000000E-02 ;TFRAC ( 4) = 4.000000E-02TFRAC ( 5) = 5.000000E-02 ;TFRAC ( 6) = 6.000000E-02TFRAC ( 7) = 7.000000E-02 ;TFRAC ( 8) = 8.000001E-02TFRAC ( 9) = 9.000000E-02 ;TFRAC ( 10) = 1.000000E-01

.

.

.TFRAC ( 93) = 9.300001E-01 ;TFRAC ( 94) = 9.400001E-01TFRAC ( 95) = 9.500000E-01 ;TFRAC ( 96) = 9.600000E-01TFRAC ( 97) = 9.700000E-01 ;TFRAC ( 98) = 9.800000E-01TFRAC ( 99) = 9.900001E-01 ;TFRAC (100) = 1.000000E+00************************************************************

Group 3. X-Direction Grid Spacing BACKCARTES = FNX = 1XULAST = 6.283190E+00************************************************************Group 4. Y-Direction Grid SpacingNY = 1YVLAST = 5.000000E-03************************************************************Group 5. Z-Direction Grid SpacingPARAB = FNZ = 20ZWLAST = 1.000000E-01ZFRAC ( 1) = 5.000000E-02 ;ZFRAC ( 2) = 9.999999E-02ZFRAC ( 3) = 1.500000E-01 ;ZFRAC ( 4) = 2.000000E-01

.

.

.ZFRAC (17) = 8.500000E-01 ;ZFRAC (18) = 9.000000E-01ZFRAC (19) = 9.500000E-01 ;ZFRAC (20) = 1.000000E+00************************************************************

************************************************************Group 7. Variables: STOREd,SOLVEd,NAMEd BACKONEPHS = TNAME(148) =PRPS ;NAME(149) =SPH1NAME(150) =TEM1

* Y in SOLUTN argument list denotes:* 1-stored 2-solved 3-whole-field* 4-point-by-point 5-explicit 6-harmonic averaging

SOLUTN(PRPS,Y,N,N,N,N,Y)SOLUTN(SPH1,Y,N,N,N,N,N)SOLUTN(TEM1,Y,Y,Y,N,N,Y)PRPS = 148************************************************************Group 8. Terms & Devices BACK* Y in TERMS argument list denotes:* 1-built-in source 2-convection 3-diffusion 4-transient* 5-first phase variable 6-interphase transport

TERMS (TEM1,Y,N,Y,Y,Y,N)DIFCUT = 5.000000E-01 ;ZDIFAC = 1.000000E+00GALA = F ;ADDDIF = FISOLX = 0 ;ISOLY = 0 ;ISOLZ = 1************************************************************

************************************************************Group 9. Properties BACKRHO1 = 9.982300E+02 ;TMP1 = 0.000000E+00EL1 = 0.000000E+00TSURR = 0.000000E+00 ;TEMP0 = 2.730000E+02PRESS0 = 1.000000E+05DVO1DT = 1.180000E-04ENUL = 1.006000E-06 ;ENUT = 0.000000E+00PRNDTL(TEM1) = -5.970000E-01PRT (TEM1) = 1.000000E+00CP1 = 4.181800E+03 ;CP2 = 4.181800E+03************************************************************Group 10.Inter-Phase Transfer Processes************************************************************

************************************************************Group 11.Initialise Var/Porosity Fields BACKFIINIT(PRPS) = 6.700000E+01 ;FIINIT(SPH1) = 4.730000E+02FIINIT(TEM1) = 2.000000E+01No PATCHes yet used for this Group

INIADD = FFSWEEP = 1NAMFI =CHAM************************************************************Group 12. Patchwise adjustment of termsPatches for this group are printed with thosefor Group 13.Their names begin either with GP12 or &

************************************************************Group 13. Boundary & Special Sources BACK

Parent VR object for this patch is: LOWPATCH(OB1 ,LWALL , 1, 1, 1, 1, 1, 1, 1, 100)COVAL(OB1 ,TEM1, 1.000000E+00, 1.000000E+02)

Parent VR object for this patch is: NORTHPATCH(OB2 ,NWALL , 1, 1, 1, 1, 1, 20, 1, 100)

Parent VR object for this patch is: NORTHPATCH(OC2 ,NORTH , 1, 1, 1, 1, 1, 20, 1, 100)COVAL(OC2 ,TEM1, 1.075000E+01, 2.000000E+01)XCYCLE = FEGWF = F

************************************************************Group 14. Downstream Pressure For PARAB************************************************************Group 15. Terminate Sweeps BACKLSWEEP = 1000 ;ISWC1 = 1LITHYD = 1 ;LITFLX = 1 ;LITC = 1 ;ITHC1 = 1SELREF = TRESFAC = 1.000000E-02************************************************************Group 16. Terminate Iterations BACKLITER (TEM1) = 20ENDIT (TEM1) = 1.000000E-03************************************************************Group 17. Relaxation BACKRELAX(PRPS,LINRLX, 1.000000E+00)RELAX(SPH1,LINRLX, 1.000000E+00)RELAX(TEM1,FALSDT, 1.000000E+09)OVRRLX = 0.000000E+00EXPERT = F ;NNORSL = F

************************************************************Group 18. Limits BACKVARMAX(PRPS) = 1.000000E+10 ;VARMIN(PRPS) =-1.000000E+10VARMAX(SPH1) = 1.000000E+10 ;VARMIN(SPH1) =-1.000000E+10VARMAX(TEM1) = 1.000000E+10 ;VARMIN(TEM1) =-1.000000E+10************************************************************Group 19. EARTH Calls To GROUND Station BACKUSEGRD = T ;USEGRX = TASAP = TIDISPB = 1 ;IDISPC = 100CSG1 ='F'SPEDAT(SET,DOMAIN,PHASE_1_MAT,I,67)SPEDAT(SET,OBJNAM,^OB1,C,LOW)SPEDAT(SET,IGESTYPE,^OB1,C,PLATE)SPEDAT(SET,OBJNAM,^OB2,C,NORTH)SPEDAT(SET,IGESTYPE,^OB2,C,PLATE)SPEDAT(SET,OBJNAM,^OC2,C,NORTH)SPEDAT(SET,IGESTYPE,^OC2,C,USER_DEFINED)SPEDAT(SET,MATERIAL,67,L,T)

END