Download as pdf or txt
Download as pdf or txt
You are on page 1of 92

aefJt^pv=pçÑíï~êÉ

cbcilt =S o

cáåáíÉ=bäÉãÉåí=pìÄëìêÑ~ÅÉ=cäçï
C=qê~åëéçêí=páãìä~íáçå=póëíÉã

rëÉê=j~åì~ä

aefJt^pv=dãÄe

cbcilt=S=ö=N
`çéóêáÖÜí=åçíáÅÉW
kç=é~êí=çÑ=íÜáë=ã~åì~ä=ã~ó=ÄÉ=éÜçíçÅçéáÉÇI=êÉéêçÇìÅÉÇI=çê=íê~åëä~íÉÇ=ïáíÜçìí=ïêáííÉå=éÉêãáëëáçå=çÑ=íÜÉ=
ÇÉîÉäçéÉê=~åÇ=ÇáëíêáÄìíçê=aefJt^pv=dãÄeK
`çéóêáÖÜí=EÅF=OMNM=aefJt^pv=dãÄe=_Éêäáå=J=~ää=êáÖÜíë=êÉëÉêîÉÇK=
aefJt^pvI=cbcilt=~åÇ=tdbl=~êÉ=êÉÖáëíÉêÉÇ=íê~ÇÉã~êâë=çÑ=aefJt^pv=dãÄeK

aefJt^pv=dãÄe===
t~äíÉêëÇçêÑÉê=píê~≈É=NMRI=NOROS=_ÉêäáåI=dÉêã~åó
mÜçåÉW=HQVJPMJST=VV=VUJMI=c~ñW=HQVJPMJST=VV=VUJVV
bJj~áäW=ã~áä]ÇÜáJï~ëóKÇÉ

O=ö=rëÉê=j~åì~ä
`çåíÉåíë

`çåíÉåíë

NK=fåíêçÇìÅíáçå =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K T
NKN= tÉäÅçãÉ=íç=cbciltK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KT NKQ= pÅçéÉ=~åÇ=píêìÅíìêÉ =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= U
NKO= qÜÉ=cbcilt=m~Åâ~ÖÉ=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KT NKR= kçí~íáçå=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= U
NKP= cbcilt=açÅìãÉåí~íáçå K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KU

OK=qÜÉ=rëÉê=fåíÉêÑ~ÅÉK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K NN
OKN= mÜáäçëçéÜó =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KNN OKQKN= qóéÉë=çÑ=sáÉï=táåÇçïë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= NO
OKO= dê~éÜáÅë=aêáîÉê K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KNN OKQKO= k~îáÖ~íáçåK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= NO
OKP= `ìëíçãáòáåÖ=íÜÉ=fåíÉêÑ~ÅÉ K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KNO OKR= qìíçêá~ä=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= NP
OKQ= sáÉï=táåÇçïë =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KNO

PK=tçêâáåÖ=ïáíÜ=j~éë =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K NR
PKN= j~éëÔtÜ~í=cçê\ K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KNR PKR= j~é=bñéçêí K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= NU
PKO= `ççêÇáå~íÉ=póëíÉãë =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KNS PKS= qìíçêá~ä=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= NU
PKP= dÉçêÉÑÉêÉåÅáåÖ=j~éë=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KNT PKSKN== j~é=i~óÉêë =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= NV
PKQ= e~åÇäáåÖ=j~éë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KNT

QK=pìéÉêãÉëÜ=aÉëáÖå =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K ON
QKN= tÜ~í=áë=~=pìéÉêãÉëÜ\ K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KON QKQ= qìíçêá~ä=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= OP
QKNKN= pìéÉêãÉëÜ=mçäóÖçåëK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KON QKQKN== qççäë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= OP
QKNKO= pìéÉêãÉëÜ=iáåÉë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KON QKQKO== mçäóÖçåëI=iáåÉë=~åÇ=mçáåíëK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= OP
QKNKP= pìéÉêãÉëÜ=mçáåíë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KON QKQKP== qÜÉ=máå=`ççêÇáå~íÉë=qççäÄ~ê=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= OQ
QKO= bÇáíáåÖ=pìéÉêãÉëÜ=cÉ~íìêÉë =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KOO QKQKQ== pìéÉêãÉëÜ=fãéçêí=îá~=j~éë =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= OQ
QKP= `çåîÉêíáåÖ=j~é=cÉ~íìêÉë=íç=pìéÉêãÉëÜ=cÉ~íìêÉë=KOP

cbcilt=S=ö=P
`çåíÉåíë

RK=cáåáíÉJbäÉãÉåí=jÉëÜ =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= OT
RKN= pé~íá~ä=aáëÅêÉíáò~íáçå K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KOT RKS= qìíçêá~ä =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= OV
RKO= jÉëÜ=dÉåÉê~íáçå=mêçÅÉëë =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KOT RKSKN= qççäë=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= OV
RKP= jÉëÜ=dÉåÉê~íáçå=^äÖçêáíÜãëK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KOU RKSKO= jÉëÜ=dÉåÉê~íáçå K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= PM
RKPKN= ^Çî~åÅáåÖ=cêçåí K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KOU RKSKOKN= qêá~åÖìä~íáçå K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= PM
RKPKO= dêáÇÄìáäÇÉê K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KOU RKSKOKO= nì~Ç=jÉëÜáåÖK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= PO
RKPKP= qêá~åÖäÉ =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KOU RKSKP= bÇáíáåÖ=íÜÉ=jÉëÜ=dÉçãÉíêó K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= PO
RKPKQ= qê~åëéçêí=j~ééáåÖ K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KOU RKSKPKN== qêá~åÖìä~ê=jÉëÜÉë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= PO
RKQ= jÉëÜ=bÇáíáåÖK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KOU RKSKPKO= nì~Ç=jÉëÜÉëK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= PP
RKR= Pa=aáëÅêÉíáò~íáçåK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KOV RKSKQ= bñíÉåÇáåÖ=~=jçÇÉä=íç=PaK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= PP

SK=mêçÄäÉã=pÉííáåÖë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= PR
SKN= mêçÄäÉã=`ä~ëë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KPR SKNKRKP= cêÉÉ=pìêÑ~ÅÉ=`çåëíê~áåíëK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= QM
SKNKN= mÜóëáÅ~ä=mêçÅÉëëÉë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KPR SKO= pçäîÉê=qóéÉ=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= QM
SKNKO= aáãÉåëáçå=~åÇ=mêçàÉÅíáçåë=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KPS SKP= qìíçêá~ä =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= QN
SKNKP= qÉãéçê~ä=pÉííáåÖë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KPT SKPKN= `çåÑáåÉÇ=L=råÅçåÑáåÉÇ=jçÇÉäë =K=K=K=K=K=K=K=K=K=K=K=K=K=K= QN
SKNKQ= bêêçê=`êáíÉêáçå K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KPT SKPKO= råë~íìê~íÉÇ=jçÇÉäëK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= QO
SKNKR= cêÉÉ=pìêÑ~ÅÉ =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KPT SKPKP= qê~åëéçêí=jçÇÉäëK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= QO
SKNKRKN= Oa=jçÇÉä K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KPU SKPKQ= píÉ~Çó=L=qê~åëáÉåí=jçÇÉäë=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= QP
SKNKRKO= Pa=jçÇÉä K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KPU

TK=tçêâáåÖ=ïáíÜ=pÉäÉÅíáçåë=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= QR
TKN= fåíêçÇìÅíáçå=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KQR TKQKP= j~åì~ä=pÉäÉÅíáçåë=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= QT
TKO= pÉäÉÅíáçå=qççäë =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KQR TKQKPKN= pÉäÉÅíáçåë=áå=Oa K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= QT
TKP= píçêáåÖ=pÉäÉÅíáçåë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KQS TKQKPKO= pÉäÉÅíáçåë=áå=Pa K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= QU
TKQ= qìíçêá~ä K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KQT TKQKQ= j~éJÄ~ëÉÇ=pÉäÉÅíáçåë =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= QU
TKQKN== qççäëK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KQT TKQKR= píçêáåÖ=pÉäÉÅíáçåë =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= QV
TKQKO== dÉåÉê~ä=oÉã~êâë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KQT

UK=m~ê~ãÉíÉê=sáëì~äáò~íáçåK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= RN
UKN= fåíêçÇìÅíáçå=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KRN UKT= qìíçêá~ä =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= RP
UKO= sáÉï=táåÇçïë =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KRN UKTKN= sáÉï=táåÇçïë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= RP
UKP= jçÇÉä=dÉçãÉíêó=~åÇ=a~í~=mäçíë K=K=K=K=K=K=K=K=K=K=K=K=K=KRN UKTKO= ^ÇÇ=jçÇÉä=dÉçãÉíêó=~åÇ=m~ê~ãÉíÉêë K=K=K=K=K=K=K=K=K= RP
UKQ= sáëì~äáò~íáçå=léíáçåëK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KRN UKTKP= sáëì~äáò~íáçå=léíáçåë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= RQ
UKR= `äáééáåÖ=~åÇ=`~êîáåÖ =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KRO UKTKQ= `äáééáåÖ=~åÇ=`~êîáåÖK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= RR
UKS= fåëéÉÅíáçå K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KRP

Q=ö=rëÉê=j~åì~ä
`çåíÉåíë

VK=m~ê~ãÉíÉê=^ëëáÖåãÉåí K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K RT
VKN= fåíêçÇìÅíáçå=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KRT VKS= ^ëëáÖåãÉåí=çÑ=iççâìé=q~ÄäÉ=s~äìÉë K=K=K=K=K=K=K=K=K=K=K= SQ
VKO= fåéìí=m~ê~ãÉíÉêëK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KRT VKSKN= iççâìé=q~ÄäÉë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= SQ
VKOKN= mêçÅÉëë=s~êá~ÄäÉë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KRU VKSKO= ^ëëáÖåãÉåí=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= SQ
VKOKO= _çìåÇ~êó=`çåÇáíáçåë =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KRU VKT= `çéóáåÖ=çÑ=a~í~=s~äìÉë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= SQ
VKOKP= j~íÉêá~ä=mêçéÉêíáÉë =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KSM VKU= råáíë=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= SR
VKOKQ= oÉÑÉêÉåÅÉ=a~í~=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KSN VKV= qìíçêá~ä=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= SR
VKP= ^ëëáÖåãÉåí=çÑ=`çåëí~åí=s~äìÉë K=K=K=K=K=K=K=K=K=K=K=K=K=K=KSN VKVKN= qççäë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= SR
VKQ= ^ëëáÖåãÉåí=çÑ=qáãÉ=pÉêáÉë=a~í~ =K=K=K=K=K=K=K=K=K=K=K=K=K=KSN VKVKO== ^ëëáÖåãÉåí=çÑ=`çåëí~åí=s~äìÉë =K=K=K=K=K=K=K=K=K=K=K=K=K=K= SR
VKQKN= qáãÉ=pÉêáÉë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KSN VKVKP== ^ëëáÖåãÉåí=çÑ=qáãÉ=pÉêáÉë=a~í~ K=K=K=K=K=K=K=K=K=K=K=K=K=K= SS
VKQKO= ^ëëáÖåãÉåí K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KSO VKVKQ== ^ëëáÖåãÉåí=çÑ=j~é=a~í~ K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= ST
VKR= ^ëëáÖåãÉåí=çÑ=j~é=a~í~K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KSO VKVKQKN= fåíÉê~ÅíáîÉ=a~í~=fåéìí =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= ST
VKRKN= fåíÉê~ÅíáîÉ=a~í~=fåéìí K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KSP VKVKQKO====^ìíçã~íáÅ=a~í~=fåéìí =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= SU
VKRKO= ^ìíçã~íáÅ=a~í~=fåéìí K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KSP VKVKR== ^ëëáÖåãÉåí=îá~=`çéó=~åÇ=m~ëíÉ K=K=K=K=K=K=K=K=K=K=K=K=K=K= SV

NMK=páãìä~íáçå K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K TN
NMKN== fåíêçÇìÅíáçå=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KTN NMKS= qìíçêá~ä=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= TO
NMKO= jçÇÉä=`ÜÉÅâ =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KTN NMKSKN= qççäë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= TO
NMKP= oÉëìäíë=lìíéìí =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KTN NMKSKO= jçÇÉä=`ÜÉÅâ K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= TO
NMKQ= oìååáåÖ=íÜÉ=páãìä~íáçåK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KTO NMKSKP= oÉëìäíë=lìíéìí K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= TP
NMKR= `çåîÉêÖÉåÅÉ =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KTO NMKSKQ= oìååáåÖ=íÜÉ=páãìä~íáçå K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= TP

NNK=oÉëìäíë=bî~äì~íáçå K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K TR
NNKN= fåíêçÇìÅíáçå=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KTR NNKT= qìíçêá~ä=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= TT
NNKO= lÄëÉêî~íáçå=mçáåíë=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KTR NNKTKN= qççäë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= TT
NNKP= _ìÇÖÉí=^å~äóëáëK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KTR NNKTKO= lÄëÉêî~íáçå=mçáåíëK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= TT
NNKQ= `çåíÉåí=^å~äóëáë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KTS NNKTKP= _ìÇÖÉí=^å~äóëáë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= TU
NNKR= píêÉ~ãäáåÉë=~åÇ=m~íÜäáåÉë=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KTS NNKTKQ= `çåíÉåí=^å~äóëáë =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= TV
NNKS= bñéçêíK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KTT NNKTKR= píêÉ~ãäáåÉëI=m~íÜäáåÉë =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= TV
NNKTKS= bñéçêí=çÑ=oÉëìäíë =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= UN

cbcilt=S=ö=R
`çåíÉåíë

NOK=^åáã~íáçå=~åÇ=sáÇÉç=bñéçêí K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= UP
NOKN= fåíêçÇìÅíáçå=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KUP NOKQKN= qççäë=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= UQ
NOKO= `êÉ~íáåÖ=~=mêÉëÉåí~íáçå K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KUP NOKQKO= `êÉ~íáåÖ=~=mêÉëÉåí~íáçå=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= UQ
NOKP= jçîáÉ=bñéçêí =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KUQ NOKQKP= jçîáÉ=bñéçêí K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= UR
NOKQ= qìíçêá~ä K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KUQ NOKQKQ= bñéçêí=pÉííáåÖë =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= UR

NPK=mäìÖJáåë=~åÇ=fåíÉêÑ~ÅÉ=j~å~ÖÉê=fcjK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= UT
NPKN= fåíêçÇìÅíáçå=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KUT NPKRKO== mêçÖê~ããáåÖ=mäìÖJáåë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= UV
NPKO= mäìÖJáåë=Ñçê=rëÉêë =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KUT NPKRKOKN= pí~êíáåÖ=íÜÉ=fcj=táò~êÇ K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= UV
NPKP= qÉÅÜåçäçÖóK=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KUU NPKRKOKO= fåáíá~ä=mäìÖJfå=pÉííáåÖë =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= UV
NPKQ= fcj=Ñçê=mêçÖê~ããÉêë =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KUU NPKRKOKP= fãéäÉãÉåíáåÖ=íÜÉ=cìåÅíáçå~äáíó K=K=K=K=K=K=K=K=K=K=K=K=K=K= VM
NPKR= qìíçêá~ä K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KUU NPKRKOKQ= `çãéáäáåÖ=~åÇ=aÉÄìÖÖáåÖ =K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= VN
NPKRKN= rëáåÖ=mäìÖJáåë K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=KUU

pìÄàÉÅí=fåÇÉñ K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K=K= VP

S=ö=rëÉê=j~åì~ä
NKN=tÉäÅçãÉ=íç=cbcilt

fåíêçÇìÅíáçå
N
`çãã~åÇJiáåÉ=jçÇÉ
N fåíêçÇìÅíáçå

NKN tÉäÅçãÉ=íç=cbcilt In command-line mode, FEFLOW runs without any


graphical user interface. This is especially useful for
Thank you for choosing FEFLOW! You have batch runs or integration into other simulation environ-
selected one of the most comprehensive, well-tested ments.
and reliable programs for the simulation of flow and cbcilt=`ä~ëëáÅ
transport processes in porous media. Most of the functionality required for typical appli-
This manual explains FEFLOW’s extensive model- cations is available in the standard user interface. How-
ing capabilities so that the easy-to-use intuitive graphi- ever, some specific tasks require the previous interface.
cal user interface can be used to full potential.
Please take your time to familiarize yourself with tdbl
the software to ensure maximum productivity and effi- WGEO is a geo-imaging software. Its most impor-
ciency in your projects. tant fields of application in connection with FEFLOW
modeling are georeferencing of raster maps and coordi-
NKO qÜÉ=cbcilt=m~Åâ~ÖÉ nate transformation.
cbmilq
The FEFLOW user interface supports the entire As FEFLOW itself does not provide printing capa-
workflow from preprocessing via the simulation run to bilities, FEPLOT can be used to create plot layouts and
postprocessing. In addition, there are a number of sup- print maps composed of vector maps, graphical ele-
porting applications for specific purposes: ments, and text.
cbJijO
cbcilt=sáÉïÉê
This tool provides functionality for curve fitting,
Free visualization and postprocessing tool for
e.g., for obtaining the parameters for parametric rela-
FEFLOW files.
tionships in unsaturated flow or for sorption isotherms.

cbcilt=S=ö=T
NK=fåíêçÇìÅíáçå

NKP cbcilt=açÅìãÉåí~íáçå tation is between the theoretical basis in Reference


Manual and White Papers and the detailed description
The FEFLOW documentation provides an introduc- of the user-interface elements and workflows in the
tion to the practical application of the software as well help system.
as a detailed description of the underlying concepts and The manual follows a typical modeling workflow—
methods. While you obtained the Installation Guide starting from basic maps and finishing with postpro-
and User Manual in print, the Reference Manual and cessing and extending FEFLOW’s capabilities. Each
the White Papers are available in pdf format on the chapter starts with an introduction to the topic, presents
installation disk. On request they are also provided as the relevant FEFLOW tools, describes the concepts and
printed books. workflows, and ends with a tutorial.
The Reference Manual contains the physical and This manual is based on the FEFLOW 6 user inter-
mathematical basis of FEFLOW along with a descrip- face, but some chapters may refer to the FEFLOW 6
tion of numerous benchmark cases that were used to Classic interface for certain functionality. The classic
verify the applicability of FEFLOW for a broad variety interface is described in a separate User Manual
of physical processes. FEFLOW 6 Classic available digitally on the
The White Papers are a collection of papers regard- FEFLOW installation disk.
ing different topics related to FEFLOW, ranging from
theoretical concepts to special fields of application. NKR kçí~íáçå
This User Manual and the step-by-step Tutorial con-
tained in the DVD booklet complement the documenta- Most of the tutorials are based on prepared files,
tion on the more practical side. thus they require installation of the FEFLOW demo
A full reference of the user interface elements along data package. <FEFLOW demo> in a file path refers to
with a detailed description of the handling is available the folder of the demo data installation. The default
in the help system of the graphical interface. installation location may differ between operating sys-
tems. On Microsoft Windows, the typical installation
NKQ pÅçéÉ=~åÇ=píêìÅíìêÉ locations are:

This User Manual is intended as a practical guide to • Windows XP:


groundwater modeling with FEFLOW. It aims to C:\Documents and Settings\All Users\Docu-
explain the essential work steps of model setup, simu- ments\WASY FEFLOW 6.0\demo\
lation and postprocessing, and to present alternative
options and settings with their specific advantages and • Windows Vista / Windows 7:
disadvantages for specific applications. Thus the User C:\Users\Public\Documents\WASY FEFLOW
Manual can serve both as an introduction for FEFLOW 6.0\demo
’newbies’, and as a reference for more experienced
users. Its position within the complete set of documen-

U=ö=rëÉê=j~åì~ä
OKN=mÜáäçëçéÜó

qÜÉ=rëÉê=fåíÉêÑ~ÅÉ

How to use the basic user interface components


O
grams—all adapt automatically to the current context.
O qÜÉ=rëÉê=fåíÉêÑ~ÅÉ

OKN mÜáäçëçéÜó To provide often-needed functionality as quickly as


possible, many controls are also accessible via context
The user interface of FEFLOW 6 is designed to pro- menus that are available for most user-interface ele-
vide as many tools as possible without the need to open ments, for example, parameters in the Data panel or
nested dialogs or menus. While allowing an efficient legends in a view window.
workflow for experienced FEFLOW modelers, the
interface might look complex to first-time users. OKO dê~éÜáÅë=aêáîÉê
Therefore only the interface components that are
relevant at the current stage of model setup or for the The FEFLOW user interface makes use of OpenGL
current model class are shown. The five main interface (Open Graphics Library) for visualization. OpenGL is
components—menus, toolbars, views, panels and dia- a well-proven standard that gives access to the capabil-
ities of the graphics hardware for accelerated display.
To efficiently use OpenGL, a graphics driver provided
by the graphics-card or chipset manufacturer should be
installed. The standard drivers included with an operat-
ing system might not support OpenGL to a sufficient
extent. Especially on laptop computers, drivers pro-
vided at purchase have been found to contain OpenGL
bugs in several cases. We recommend to download the
most recent drivers from the graphics-card or chipset
manufacturer’s web site before using FEFLOW or
when problems in the graphical display are observed.

Figure 2.1 Context menu in the View Components panel.

cbcilt=S=ö=NN
OK=qÜÉ=rëÉê=fåíÉêÑ~ÅÉ

OKP `ìëíçãáòáåÖ=íÜÉ=fåíÉêÑ~ÅÉ user interface, i.e., parts where no other context menu
comes up (Figure 2.2).Panels and diagrams can also be
The interface is completely customizable, i.e., the closed by clicking on the closing icon in the upper right
location and visibility of all components except the corner of the element.
main menu can be chosen arbitrarily. Components can While exploring the new interface you may come to
be docked to a certain main-window location, or they a situation where most panels and toolbars are hidden,
can be floating as separate windows. and the remaining ones are not where you want them to
To switch between docked and floating status, dou- be. In such a case, just switch on Reset toolbar and
ble-click the header of a panel or move a component to dock-window layout in the View menu, and FEFLOW
another location by dragging it while pressing the left will come up with the default layout when starting it
mouse button. To avoid docking, the <Shift> key can the next time.
be pressed before and while moving a panel or diagram
window. OKQ sáÉï=táåÇçïë
Panels and diagrams can also be tabbed so that two
or more of these elements are placed above each other. View windows contain different views of the model,
Clicking on one of the tabs brings the corresponding possibly along with maps and other visualization fea-
panel or diagram to the front. tures. Limited only by the available memory, any num-
Floating toolbars, panels and diagrams can be ber of windows can be displayed simultaneously to
moved outside the main application window. This is show different model components (listed in the View
especially helpful to enlarge view windows on one Components panel for the active view). Each view has
screen while arranging toolbars and panels on another its own settings and components handling.
screen. View windows cannot be moved outside the
main window. OKQKN qóéÉë=çÑ=sáÉï=táåÇçïë

FEFLOW has four types of view windows:


• Supermesh view
• FE-Slice view
• 3D view
• Cross-section view
New view windows can be opened via the View
menu. For opening cross-sectional views, a 2D surface
line has to be selected in the Spatial Units panel.
Figure 2.2 Context menu.
OKQKO k~îáÖ~íáçå
Toolbars, panels and diagrams can be turned on and
off by using the context menu on ’empty’ parts of the Navigation in view windows is most straightfor-
NO=ö=rëÉê=j~åì~ä
OKR=qìíçêá~ä

ward by using the left and right mouse buttons and the To get familiar with the graphical user interface we
mouse wheel. By default, the left mouse button is used now add a further panel to our workspace.
to pan in FE-Slice views and to rotate in 3D views. Go to View > Panels in the main menu and click
Besides invoking the context menu on a view, the right on the entry Plug-ins Panel. The panel now appears at
mouse button also allows zooming when a navigation the bottom right corner of the FEFLOW window.
tool is active. In FE-Slice views, the mouse wheel has Change the panel position by dragging it to a differ-
zooming functionality, while in 3D views it is used for ent location while holding the left mouse button. Leave
rotation. <Shift> on the keyboard in combination with the panel as a separate floating window or dock it at a
the mouse wheel changes the directional exaggeration certain location.
(in y direction in FE-Slice views and z direction in 3D
views).
Keyboard shortcuts allow to quickly return to the
full view (<Home>), to reset the rotation (<Ctrl>-
<Home>), and to reset the scaling (<Shift>-<Home>).
Additional tools in the View toolbar can also be
used to return to full view, to return to a preferred view
defined via the View menu, and to undo/redo view
changes.

OKR qìíçêá~ä
When FEFLOW is started it opens with an empty
project by default and the Initial Domain Bounds dia-
log comes up. Here, we need to define the initial work
Figure 2.3 The FEFLOW standard layout.
area for mesh design. This can either be done manually
or with the use of maps that are loaded in a subsequent Add another panel using a different method. Right-
step. For a quick start, simply hit Specify manu- click on an empty part of the user interface, e.g., in the
ally and accept the default domain bounds with a click grey part above the Inspection panel. A context
on OK. menu with the entries Toolbars, Panels, Diagrams
The following components are now visible in the opens up. Go to Panels and click on Map Proper-
workspace: ties Panel. The panel now appears in our workspace as
• the active view window—the Supermesh view a separately floating item. Dock the panel with a dou-
• the main menu on top ble-click on its header. The Spatial Units and the
• a number of panels and toolbars Properties panel are tabbed so that only one is visi-
By default, not all panels and toolbars are displayed. ble at a time. Click on the tab Properties to bring this

cbcilt=S=ö=NP
OK=qÜÉ=rëÉê=fåíÉêÑ~ÅÉ

panel to the front. Remove the two panels by clicking


on the closing icon in the upper right corner of the
respective panel.

Figure 2.4 A floating panel and toolbar in the workspace.

Only toolbars relevant to the currently active view


can be shown. Aside from this restriction, toolbar visi-
bility and position are user-controlled. As an exercise,
click on the left border of the Mesh Editor toolbar
and drag it to a different location, e.g. into the Super-
mesh view. We also want to add the Origin tool-
bar to our workspace. Choose one of the options
described for adding a panel: Either go to View >
Toolbars or right-click into an empty part of the work-
space. To restore the default settings for the graphical
user interface go to View and select Reset Toolbar
and Dock-Window Layout. When FEFLOW is started
the next time, toolbars and panels will be arranged
according to the default layout.

NQ=ö=rëÉê=j~åì~ä
PKN=j~éëÔtÜ~í=cçê\

tçêâáåÖ=ïáíÜ=j~éë

Loading and managing different kinds of maps


P
geometrical features. While some formats like shp sup-
P tçêâáåÖ=ïáíÜ=j~éë

PKN j~éëÔtÜ~í=cçê\ port an unlimited number of user-defined attributes,


others like dxf only allow drawing attributes such as
Maps are an integral part of all but very simple color or line style, and very simple formats such as trp
modeling projects. Their most obvious role is to pro- (ASCII triplet format—XYF) only support one single
vide a basis for convenient orientation in the model attribute value.
area. FEFLOW, however, makes much wider use of
maps in the modeling workflow. Map geometries can OaLPa
be used to influence the mesh generation process, they ESRI Shape Files, AutoCAD Exchange Files and
can serve to geometrically define the target nodes or tabular files (dbf, dat) may contain three-dimensional
elements for parameter assignment, and attributed map information. FEFLOW supports 3D map display
maps can even provide the input data themselves. in 3D view windows (Figure 3.1).

o~ëíÉêLsÉÅíçê=j~éë
We have to distinguish between raster maps and
vector maps. Pixel-based raster maps in formats such
as TIFF, JPEG or PNG can only provide visual infor-
mation. Vector maps contain discrete geometries
(points, lines, and polygons). Formats supported by
FEFLOW include ESRI Shape Files, AutoCAD
Exchange Files, DBase Tables and several ASCII (text)
file formats. In addition to geometrical information
these file formats also encompass attribute data, i.e., Figure 3.1 3D map in 3D view window.
numerical and/or textual information related to certain

cbcilt=S=ö=NR
PK=tçêâáåÖ=ïáíÜ=j~éë

PKO `ççêÇáå~íÉ=póëíÉãë
Dealing with spatial data requires the definition of a
unique coordinate system as a reference. FEFLOW can
use data in any metric cartesian system, i.e., any system
with orthogonal x and y axes and coordinates in meters.
The most popular of these systems is the UTM coordi-
nate system.
To achieve better precision in the calculations,
FEFLOW always uses a local and a global coordinate
system at the same time. The axes in both systems have
the same orientation, only the origin of the local system
has an offset in global coordinates.
Locations in the local system can be expressed in
cartesian or polar coordinates. The coordinate system
used in a particular view window can be defined in the
View menu. The offset of global and local coordinate
system is defined automatically via map extents or
manually when starting a new model, but can be edited
later on in the Coordinate-System Origin dialog which
is accessed with a click on the Edit Origin button in the
Origin toolbar. In practical cases, it is usually sufficient
to deal with the global coordinate system.
In 2D cross-sectional and axisymmetric models the
y coordinate refers to the elevation. In these cases an
offset between local and global coordinates in y should
be avoided so that there is no doubt about the elevation
reference. Internally, FEFLOW uses the local y coordi-
nate as the reference for elevation-dependent parame-
ters, e.g., when converting hydraulic head to pressure
Figure 3.2 Global and local coordinates (2D/3D).
head and vice versa.

NS=ö=rëÉê=j~åì~ä
PKP=dÉçêÉÑÉêÉåÅáåÖ=j~éë

PKP dÉçêÉÑÉêÉåÅáåÖ=j~éë j~é=i~óÉêë


While raster maps already contain information
The WGEO software provided with FEFLOW can about the display color for each pixel, this is typically
add a geographical reference to raster images such as not the case for features in vector maps. The display
scanned maps in TIFF, JPEG or PNG format for use as information for these kinds of maps is contained in so-
maps in FEFLOW. WGEO can also perform coordinate called layers. When loading a map, FEFLOW creates a
transformation for raster and vector maps applying a 7- layer named Default with just one single style (color,
parameter Helmert transformation routine. line style, etc.) applied to all features in the map. The
In Plus mode (separate licensing required), WGEO properties of the default layer can be edited, and addi-
also provides functionality for georeferencing of ESRI tional layers can be added by using the functions in the
Shape Files (shp) and AutoCAD Exchange Files (dxf). context menu of the layer and the map.
Additional coordinate transformation routines are also
available on demand. j~é=mêçéÉêíáÉë
Please refer to the WGEO manual and its help sys- The properties of a map layer can be edited in the
tem for a detailed description of the respective work- Map Properties panel which is opened via the context
flows. menu of the layer. Basic settings such as opacity, light-
ing options and 3D drawing options can be applied to
PKQ e~åÇäáåÖ=j~éë all features of the map.

The Maps panel is used to load and manage raster


and vector maps. Available formats are tif, jpg and png
for raster maps, and shp, lin, ply, pnt, trp, ano, dxf,
smh, dbf and dat. In case of tabular data, the columns
containing coordinate values have to be chosen at the
time of import, unless they correspond to some defaults
like X, Y and Z. When an FE-Slice view or 3D view is
the active view, an available supermesh (polygons,
lines and points) of the current model is also displayed
in the panel.
The maps are automatically sorted by format in the
tree. The order of the different file types, and the order
of files within a file type can be changed by drag-and-
drop, e.g., to gain quick access to often used maps.
Figure 3.3 Map Properties panel.

cbcilt=S=ö=NT
PK=tçêâáåÖ=ïáíÜ=j~éë

The map can be classified based on one of the as a background map for orientation.
attribute fields of the map either by applying a different The map now appears as Geo-JPEG in the Maps
style to each unique attribute value, or by partitioning panel. Double-click on this entry to add the map to the
the overall range of values of a numeric attribute into a active view.
number of classes. Predefined color palettes are readily Next, load some further maps that contain informa-
available to be applied to the classes or unique values. tion on the model site. Make a right-click on Maps in
Color and other styles can also be edited manually the Maps panel and choose Add Maps.... Select
for any individual class or for a selection of multiple the files
classes. • model_area.shp
• sewage_treatment.shp
PKR j~é=bñéçêí • waste_disposal.shp
• rivers.lin
All the model properties and results can be exported • demo_wells.pnt
to different kinds of map files, retaining the geographi- We can either load the maps one by one or import
cal reference of the model. them all at once by pressing the <Ctrl> key while we
Export of parameters is invoked via the context select the maps.
menu of the parameter in the Data panel, or via the Depending on the respective file formats, the maps
context menu of the parameter in the View Compo- now appear in different trees in the Maps panel,
nents panel. In the latter, also export for the selected together with a Default (layer) entry that FEFLOW
geometries or the values in the current slice/layer only creates automatically. Add all maps to the active view
is supported. with a double-click on their Default entry.
Visualization options such as isolines or fringes can
be exported to a map file via the context menu of the
visualization option in the View Components panel.

PKS qìíçêá~ä
In the following exercises we want to get familiar
with the handling of maps in the FEFLOW workspace.
The most important tool in this context is the Maps
panel which is used to load and manage maps.
As a first exercise, we load a number of maps of dif-
ferent formats that could be used to set up a supermesh. Figure 3.4 Maps panel.
Start with an empty FEFLOW project. Click on
Use map(s)... in the Initial Domain Bounds dia- Maps that have been added to the active view also
log and select the file SimulationArea.jpg that is used appear in the View Components panel. Here, maps

NU=ö=rëÉê=j~åì~ä
PKS=qìíçêá~ä

can be switched on and off temporarily via the check- button and close the panel.
boxes. Their order can be changed by dragging them For the next map sewage_treatment we create a
with the mouse cursor to another position in the tree. If new layer besides the already existing default layer.
not all of the loaded maps are visible in the Supermesh Open the context menu of this map with a right-click
view change their order in the View Components and select Create Layer. A new entry Layer 1 is
panel to bring maps covered by others to the surface. now added to the tree of this map. Open the Map
Properties panel for this layer as previously described
and click again on <All Records>. Change the fill color
and the outline style of the polygon and also the opac-
ity and confirm the settings with a click on Apply
Changes before closing the panel.
Double-click on Layer 1 in the Maps panel to
add this layer to the active view. You can switch
between different layers of a map using the checkboxes
in front of these layers in the View Components
panel. The last one activated is always the uppermost
layer. Figure 3.5 gives an example for a certain style of
the imported maps.
The remaining maps that we have loaded contain
spatial information on rivers and wells, i.e., line and
point structures. To enhance the appearance of the riv-
Figure 3.5 Maps displayed in the active view. ers in the active view we change width and color of the
line, again using the Map Properties panel for the
Default layer of the map rivers.
PKSKN= j~é=i~óÉêë For the map demo_wells the style settings of the
markers and for the labels can be edited separately.
The map model_area defines the outer boundary of
the model area. To change the style of the Default layer
of this map make a right-click on Default in the
Maps panel and select Edit properties from the
context menu. In the upper part of the Map Proper-
ties panel that now opens click on <All Records> and
go to Polygon Attributes. Change the fill color of the
polygon and also the outline style. Next, reduce the
opacity of the map to make underlying maps visible.
Confirm the new settings with the Apply Changes

cbcilt=S=ö=NV
PK=tçêâáåÖ=ïáíÜ=j~éë

OM=ö=rëÉê=j~åì~ä
QKN=tÜ~í=áë=~=pìéÉêãÉëÜ\

pìéÉêãÉëÜ=aÉëáÖå

Setting up the framework for mesh generation


Q
• The required density of the finite-element mesh
Q pìéÉêãÉëÜ=aÉëáÖå

QKN tÜ~í=áë=~=pìéÉêãÉëÜ\ can be specified for each polygon.


• The polygons can be used for parameter assign-
The so-called Supermesh in FEFLOW forms the ment and results evaluation later.
framework for the generation of a finite-element mesh.
It contains all the basic geometrical information the QKNKO pìéÉêãÉëÜ=iáåÉë
mesh generation algorithm needs.
While in the very simplest case the Supermesh only Lines in the Supermesh are applied to represent lin-
defines the outline of the model area, i.e., consists of ear structures in the finite-element mesh to be created.
one single polygon, the concept offers many more pos- Their advantages include:
sibilities: Supermeshes can be composed of an arbi- • Finite-element edges will honor the line, provid-
trary number of polygons, lines and points. Their ing for example the basis for later applying the
respective features and purposes are described in the boundary condition for a river exactly along the
following sections. river axis.
• The mesh may be automatically refined during
QKNKN pìéÉêãÉëÜ=mçäóÖçåë mesh generation along the line.
• The lines can be used for parameter assignment
A subdivision of the model area into a number of and results evaluation later.
separate polygons can be useful for a number of rea-
sons: QKNKP pìéÉêãÉëÜ=mçáåíë
• Finite-Element edges will honor the polygon
boundaries, allowing for example an exact zoning Points in the Supermesh are typically placed in the
of parameters and setting of boundary conditions locations of production or injection wells or in observa-
in exact locations later. tion locations. They make sure that a finite-element
node is set at exactly this location during mesh genera-
cbcilt=S=ö=ON
QK=pìéÉêãÉëÜ=aÉëáÖå

tion, they allow a local mesh refinement around the


point, and they can be used for parameter assignment,
e.g., to set the boundary condition for a pumping well.

Figure 4.2 Inner Supermesh border.

The Mesh Editor toolbar provides the tools to digi-


tize and edit Supermesh polygons, lines, and points.
In Move Node mode, both the originally digitized
nodes and smaller nodes in between can be moved.
Moving the small nodes results in curved polygon
edges (parabolic or circular shape) that are typically
applied to curved structures such as borehole edges or
pipe walls in small-scale models.
Figure 4.1 Example for a Supermesh detail. When digitizing a polygon next to an existing one,
the editor will automatically follow the existing poly-
gon boundary to close the new polygon (Figure 4.3).
QKO bÇáíáåÖ= pìéÉêãÉëÜ= cÉ~J
íìêÉë
The Mesh Editor toolbar provides the tools to digi-
tize and edit Supermesh features.
Sets of polygons have to fulfil some requirements:
• No overlapping polygons are allowed.
• No polygons can be entirely contained by another
polygon.
The user interface tools ensure that these require-
ments are met at any time. Internal holes in the super-
mesh are possible. They are indicated by another color
for the internal boundary (Figure 4.2).
Figure 4.3 Follow existing boundaries.

OO=ö=rëÉê=j~åì~ä
QKP=`çåîÉêíáåÖ=j~é=cÉ~íìêÉë=íç=pìéÉêãÉëÜ=cÉ~íìêÉë

QKP `çåîÉêíáåÖ= j~é= cÉ~íìêÉë polygon nodes with a left-click in the Supermesh view
íç=pìéÉêãÉëÜ=cÉ~íìêÉë window and finish by clicking on the first node of the
polygon again. The finished polygon appears shaded in
Instead of digitizing Supermesh features on screen, grey.
they can be imported from background maps. This is Now, add a second polygon that adjoins the first
done via the Convert to Supermesh entry in the context one. Pay attention to how the mouse cursor symbol
menu on the name of the map file in the Maps panel. changes depending on its position in the Supermesh
All features of the map are converted to supermesh view: The cross-hairs cursor indicating that polygon
features using this approach. Polygons that would over- nodes can be set only appears outside the existing poly-
lap with already existing polygons are not converted. gon. This makes sure that only non-overlapping poly-
gons are created. Clicking inside the polygon
FEFLOW does not create a new node. Place the first
QKQ qìíçêá~ä node of the new polygon on the edge of the existing
polygon, continue with some more nodes and set a last
QKQKN= qççäë node on the polygon edge again. To finish the polygon,
use the autoclose function by double-clicking on the
All of the tools that are used in this exercise are last node. FEFLOW now automatically closes the poly-
located in the Mesh Editor toolbar. gon along the existing polygon edge.

Figure 4.4 Mesh Editor toolbar.

QKQKO=mçäóÖçåëI=iáåÉë=~åÇ=mçáåíë

To get some hands-on training in supermesh design


we design a first supermesh that consists of a single
polygon.
Open an empty FEFLOW project and start with the
definition of the work area for mesh design. Click on
Specify manually in the Initial Domain Bounds
dialog and simply leave the next dialog with OK.
The domain bounds have now been set to 100m x 100 Figure 4.5 A finished polygon in the Supermesh view.
m.
Now, click on Add Polygons in the Mesh Also, add some line and point features to the super-
Editor toolbar in the upper left of the window. Set mesh, using the Add Lines and Add Points

cbcilt=S=ö=OP
QK=pìéÉêãÉëÜ=aÉëáÖå

tool. Finish a line with a double-click on the last node. Polygons, lines and points that have been misplaced
The polygons that we have created can be merged can also be deleted. Use one of the Selection tools
with the Join Polygons option. First, select both again and click on the component that we would like to
polygons with one of the three Selection tools in delete. Then simply press the <Del> key to remove the
the Mesh Editor toolbar. Now the Join Poly- component.
gons button in the Mesh Editor toolbar is acti- If a node is misplaced while we draw a line or a
vated. Click this button to merge the two polygons. polygon we can delete this node by clicking on a previ-
ous node of the same line or polygon.

Figure 4.6 Polygons selected for joining.

Figure 4.7 Using the Pin Coordinates toolbar.


QKQKP=qÜÉ=máå=`ççêÇáå~íÉë=qççäÄ~ê

Polygon nodes can also be positioned exactly. In the QKQKQ=pìéÉêãÉëÜ=fãéçêí=îá~=j~éë


next step, we design a square polygon with the dimen-
sions of 100 m x 100 m. Hit the Add Polygons but- In the next step we do not design a supermesh man-
ton and press <F2>. The Pin Coordinates toolbar ually on screen but import the supermesh features from
appears. Insert 0,0 to set the first node and press a map. To load a map go to the Maps panel and
<Enter>. In the same way, enter the coordinates of the double-click on Add Maps. A file selection box
remaining three nodes of the polygon. To finish the appears. Select the files
polygon, enter the coordinates of the first node again or • model_area.shp
simply click on it. • sewage_treatment.shp

OQ=ö=rëÉê=j~åì~ä
QKQ=qìíçêá~ä

• waste_disposal.shp locations. Right-click on this map to open its context


• demo_wells.shp. menu and select Convert to > Supermesh Points.
The two well locations are now visible as red points in
These maps are now displayed under ESRI Shape the Supermesh view.
Files in the Maps panel. Double-click on the entry As a last step we want to include the two contami-
Default of each map to make it visible in the Super- nation sites in the supermesh. These cannot be
mesh view. Figure 4.8 shows the loaded maps in the imported from a map via the Convert to option as
Supermesh view. this would lead to overlapping polygons. Instead, we
will split the existing polygon and cut out the contami-
nation sources. Start with the eastern source of contam-
ination. Click the button Split Polygons and select
the map waste_disposal from the dropdown list in the
Mesh Editor toolbar. To digitize the contamina-
tion source accurately we can use a tool that snaps to
the fixed points of this map. To activate the snapping
click the Snap to Points button right next to the
dropdown list.

Figure 4.8 Maps displayed in the Supermesh view.

First we want to create a polygon that describes the


total model area. We import this polygon from the map
model_area. Open the context menu of this map with a
right-click and go to Convert to > Supermesh Poly-
gons. When we click on the Add Polygons button
in the Mesh Editor toolbar we can see the Figure 4.9 Polygon splitting along contamination site.
imported polygon.
In addition to this polygon we want to include two Polygon splitting must start and end at an already
well locations as points in our supermesh. The process existing polygon border. As the contamination sources
to import these points is completely analogous to the are located completely inside the model area two cuts
polygon import. The map demo_wells contains the well are necessary. Start on an arbitrary point on the model
cbcilt=S=ö=OR
QK=pìéÉêãÉëÜ=aÉëáÖå

boundary and go halfway around the contamination-


source. To complete the first cut, return to the model
boundary on the other side (see figure 4.9). Complete
the polygon with a second cut along the missing parts
of the contamination source polygon.
Create the polygon for the second contamination
source in the same way, this time selecting
sewage_treatment from the dropdown list in the
Mesh Editor toolbar.
An exemplary supermesh setup is shown in figure
4.10.

Figure 4.10 Completed supermesh.

OS=ö=rëÉê=j~åì~ä
RKN=pé~íá~ä=aáëÅêÉíáò~íáçå

cáåáíÉJbäÉãÉåí=jÉëÜ

Obtaining a suitable spatial discretization of the model domain


R
R cáåáíÉJbäÉãÉåí=jÉëÜ

RKN pé~íá~ä=aáëÅêÉíáò~íáçå
This section describes the generation of finite-ele-
ment meshes. During the simulation, results are com-
puted on each node of the finite-element mesh and
interpolated within the finite elements. The denser the
mesh the better the numerical accuracy, and the higher
the computational effort. Numerical difficulties can
arise during the simulation if the mesh contains too
many highly distorted elements. Thus some attention
should be given to the proper design of the finite-ele- Figure 5.1 Examples for bad and good mesh geometry.
ment mesh. For transport simulations, the Peclet crite-
rion can be useful for determining the required mesh
density. To assist in creating a well-shaped mesh, RKO jÉëÜ=dÉåÉê~íáçå=mêçÅÉëë
FEFLOW offers various tools, including local refine-
FEFLOW supports either triangular or quadrangular
ment and derefinement of the mesh. Local refinement
finite-element meshes. A separate toolbar is available
during mesh generation will lead to a better mesh qual-
to support the mesh generation process. The generation
ity than later subdivision of elements.
is generally based on the input of an approximate num-
ber of finite elements to be generated. The desired
mesh density of each supermesh polygon can be edited
separately.
Different algorithms for the mesh generation are
provided, all of them with their specific options and

cbcilt=S=ö=OT
RK=cáåáíÉJbäÉãÉåí=jÉëÜ

properties. Some algorithms can consider also lines and RKPKP qêá~åÖäÉ
points in the supermesh and allow a local mesh refine-
ment at polygon edges, lines and points. Triangle is a triangulation code developed by
Mesh generation is typically a trial-and-error pro- Jonathan Shewchuk at UC Berkeley, USA. It is
cess. The user hereby iteratively optimizes element extremely fast, supports very complex combinations of
numbers, generator property settings and—if neces- polygons, lines and points in the supermesh, allows a
sary—the supermesh until a satisfactory mesh is minimum angle to be specified for all finite elements to
obtained. be created, and provides the means for local mesh
refinement with a maximum element size at lines or
RKP jÉëÜ= dÉåÉê~íáçå= ^äÖçJ points of the supermesh.
êáíÜãë FEFLOW provides a convenient interface to Trian-
gle, which can be freely downloaded from the devel-
There are many different strategies for the discreti- oper’s website. Please refer to the FEFLOW help
zation of complex domains into triangles or quad ele- system for a detailed description of the process to
ments. As each has its specific advantages and enable Triangle in FEFLOW. Free use of Triangle is
disadvantages, FEFLOW supports three different algo- based on conditions defined in a usage agreement
rithms for triangulation and one for quad meshing. available in the FEFLOW help system and from the
Triangle website.
RKPKN ^Çî~åÅáåÖ=cêçåí
RKPKQ qê~åëéçêí=j~ééáåÖ
Advancing Front is a relatively simple triangular
meshing algorithm that does not support any lines or Transport mapping is the algorithm used in
points in the supermesh. If present, they are simply FEFLOW for generating meshes of quadrilateral ele-
ignored in the generation process. Its main advantages ments. This option requires that the quad meshing
are its speed and its ability to produce very regularly option in the Mesh menu is selected and that all super-
shaped elements. mesh polygons have exactly four sides.
Lines and points in the supermesh are ignored when
RKPKO dêáÇÄìáäÇÉê generating quadrilateral meshes.

Gridbuilder—developed by Rob McLaren at the RKQ jÉëÜ=bÇáíáåÖ


University of Waterloo, Canada—is a flexible triangu-
lation algorithm. Gridbuilder supports polygons, lines Some specific modifications of the finite-element
and points in the supermesh as well as local mesh mesh are possible at any time after mesh generation,
refinement at points, lines, or supermesh polygon even after model parameterization:
edges. • Mesh refinement by element subdivision
• Mesh derefinement (after previous refinement)
OU=ö=rëÉê=j~åì~ä
RKR=Pa=aáëÅêÉíáò~íáçå

• Splitting of quad elements into triangles


• Smoothing of the entire mesh
All the mesh-editing functionality is contained in
the Mesh Geometry toolbar.

RKR Pa=aáëÅêÉíáò~íáçå
For 3D models, FEFLOW applies a layer-based
approach. The triangular or quadrangular mesh is
extended to the third dimension by extruding the 2D
mesh, resulting in prismatic 3D elements. In FEFLOW
terminology, all horizontally adjacent 3D elements
comprise one layer, while a slice is either the interface
between two vertically adjacent layers or the top or
bottom of the model domain. All mesh nodes are
located on slices.
The extension of a 2D model to a 3D model is facil-
itated by the 3D Layer Configuration dialog that is
accessed via the Edit menu. Initially defined layers are
exactly horizontal. Real elevations are assigned like a
process variable for each node as discussed in chapter
9. Figure 5.2 Horizontal and vertical layering approaches.
All the layers in 3D models have to be continuous The 3D Layer Configuration dialog also provides
over the entire horizontal model domain. Thus model tools to add or remove layers from existing models, and
layers representing lenses or pinching-out stratigraphic to change layer thicknesses globally. Model properties
layers have to be continued to the model boundary. of new layers can be conveniently inherited from
Typically, they are then assigned a small thickness and already existing layers.
the properties of the layer immediately above or below.
3D model setup is in most cases based on a vertical
extension of a horizontal mesh. For applications such
as modelling of dams where a high level of detail is
needed vertically, but less along the horizontal axis, the
mesh can be generated in vertical projection and
extended horizontally. In the latter case, the y axis in
FEFLOW points in the direction opposite to gravity,
similar to a 2D cross-sectional model.

cbcilt=S=ö=OV
RK=cáåáíÉJbäÉãÉåí=jÉëÜ

RKS qìíçêá~ä
RKSKN qççäë

All of the tools used in these exercises are located in


the Mesh Generator toolbar

Figure 5.3 Mesh Generator toolbar.

and in the Mesh Geometry toolbar.

Figure 5.4 Mesh Geometry toolbar.

Some mesh-editing options also require the tools of


the Selection toolbar.
Figure 5.6 Supermesh.
Figure 5.5 Selection toolbar. Enter a Total Number of 2000 elements in the
input field and click on Generate Mesh to start the
mesh-generation process. A new window, the FE-Slice
RKSKO jÉëÜ=dÉåÉê~íáçå view, opens with the resulting finite-element mesh.
As figure 5.7 shows, Advancing Front ignores the
line and point features which are included in the super-
RKSKOKN qêá~åÖìä~íáçå mesh.
Now, use the same supermesh to generate a finite-
To get some hands-on experience in how the avail-
element mesh with the Gridbuilder algorithm. Click on
able mesh generator algorithms work we apply the
the Supermesh view to make the Mesh Generator
three different mesh generators on the same supermesh
toolbar visible again. Without any further changes sim-
and study the resulting finite-element meshes.
ply click on Generate Mesh.
First, click on Open to load the supermesh file
The resulting finite-element mesh looks similar to
mesh.smh. This supermesh consists of two polygons,
the one created with the Advancing Front algorithm,
one line and three point features.
except that polygon edges, lines and points are now
Start with the Advancing Front algorithm which
honored by the mesh.
can be selected from the generator list of the
As a next step, we will refine the mesh around the
Mesh Generator toolbar.
point and lines features. The refinement settings are

PM=ö=rëÉê=j~åì~ä
RKS=qìíçêá~ä

located in the Generator Properties dialog in the Leave the dialog and use the Refinement Selec-
Mesh Generator toolbar. tion tool to select the edge between the two polygons in
the Supermesh view. Clicking on Generate Mesh
should now produce a finite-element mesh should look
similar to the one on the left in figure 5.8.

Figure 5.7 Advancing Front and Gridbuilder.

Open the dialog and activate a refinement for all


three geometrical features. For polygon edges, choose Figure 5.8 Meshes generated with the Triangle algorithm.
a refinement level of 5, for lines a level of 8, and for
points a gradation of 10. Make sure that the option qÜÉ= qêá~åÖäÉ= ãÉëÜ
Apply to Selected polygon or line edges is activated pÉé~ê~íÉ=bÇáíáåÖ=çÑ=mçäóÖçåë ÖÉåÉê~íçê= ÉåÖáåÉ= áë
before you leave the dialog. åçí= éêçîáÇÉÇ= ïáíÜ
For every supermesh polygon the mesh density can
cbcilt>= cçê= ÇÉí~áäë= ~Äçìí
To select the elements to be refined click on be defined separately while the total number of ele-
Üçï= íç= çÄí~áå= íÜÉ= qêá~åÖäÉ
Refinement Selection and go back to the Super- ments remains constant. Go to the Supermesh view ãÉëÜ= ÖÉåÉê~íçêI= ëÉÉ= íÜÉ
mesh view. Click on the line and also on the edge that and activate the tool Edit Meshing Density in the cbcilt=ÜÉäé=ëóëíÉãK
separates the two polygons, then click on Generate Mesh Generator toolbar. FEFLOW now automat-
Mesh again. The resulting finite-element mesh with ically selects a polygon for which a meshing density
local refinement is shown in figure 5.7. factor can be specified. Start with the proposed poly-
Next, we will apply the Triangle algorithm to gen- gon and enter a factor of 5. After hitting <Enter>
erate a finite-element mesh. the number in the input field turns red, indicating that
Choose Triangle from the generator list in the the meshing density for this polygon has been modi-
Mesh Generator toolbar. Open the Generator fied. Proceed with the second polygon. Select it with a
Properties dialog and apply the following settings: single click and enter a density factor of 2 in the
Refinement around Selected polygon edges input field. Hit <Enter> again and start the mesh gener-
ation with a click on Generate Mesh. The right
• Polygons: gradation: 5, target element size: 1.0 m mesh in figure 5.8 shows the resulting finite element
• Lines: gradation: 3, target element size: 0.5 m mesh. To reset the meshing density factors to the
• Points: gradation: 3, target element size: 0.5 m default value, click on Reset Meshing Density.

cbcilt=S=ö=PN
RK=cáåáíÉJbäÉãÉåí=jÉëÜ

RKSKOKO nì~Ç=jÉëÜáåÖ RKSKP bÇáíáåÖ=íÜÉ=jÉëÜ=dÉçãÉíêó


A finite-element mesh with quadrilateral elements
can be generated using the Transport mapping algo- RKSKPKN =qêá~åÖìä~ê=jÉëÜÉë
rithm.
We load a new file which is a similar to the one used For this exercise load the file triangle.fem.
for the triangulation exercises, except this supermesh The geometry of the finite-element mesh can be
consists of only one polygon that has exactly four edited after the mesh generation process has been fin-
nodes. Click on Open and load the file quad- ished. All the necessary tools are located in the
mesh.smh. Transport mapping requires superelements Mesh Geometry toolbar.
with exactly four nodes, lines and points are ignored in It is possible to refine the mesh globally (entire
the mesh-generation process. mesh) or locally (only selected parts). A derefinement
To enable the quad meshing option go to Mesh option for previously refined parts of the mesh is also
and activate Quadrilateral Mode. Select Transport available.
Mapping in the Mesh Generator toolbar and If we want to apply local mesh refinement we have
enter a Total Number of 2000 elements. to select a target area first. All necessary selection tools
The resulting finite-element mesh is shown in figure can be found in the Selection toolbar. Using the
5.9. Select in Rectangular Region tool from the drop-
down list, create a rectangle around the line feature.
To create an element-based selection it is necessary
to activate a parameter in the Data panel that refers
to an elemental value. Double-click on Transmissivity.
Now click on Refine Elements in the
Mesh Generator toolbar. Each selected element is
subdivided into four elements. The result is shown in
figure 5.10.
The derefinement tool is used similarly; however,
only those parts that were previously refined can be
derefined.
Figure 5.9 Quadmesh. Mesh smoothing can produce more regularly
shaped elements. Simply click on Smooth Mesh in
the Mesh Geometry toolbar to start the smoothing
process.
Elements can also be deleted from the finite-ele-
ment mesh. Select a couple of elements and click on
Delete Elements to cut out these elements. On the

PO=ö=rëÉê=j~åì~ä
RKS=qìíçêá~ä

right hand side of figure 5.10 a (purely illustrative)


example for a mesh with deleted elements is shown.

Figure 5.11 Refined quadmesh.

Figure 5.10 Refinement and deleted elements.


RKSKQ bñíÉåÇáåÖ=~=jçÇÉä=íç=Pa

RKSKPKO nì~Ç=jÉëÜÉë After the model has been discretized in 2D we now


extend it to a 3D model. Click on Open and load
Click on Open to load the file quadmesh.fem the file triangle.fem for this exercise.
for this exercise. To perform the extension to a 3D model, go to the
Except for the derefinement tool all editing options Edit menu and open the 3D Layer Configuration
are also available for quad meshes. dialog. The table on the left displays the number of
As an additional option, quad meshes can be trans- slices and layers, and also the elevation of each slice.
formed into triangular meshes. Four different triangu- The 3D model shall consist of 3 slices and 2 layers
larization methods are available. Select the tool and the top slice shall be located at an elevation of 5 m.
Four Triangles around Center from the dropdown To set the elevation of the top slice, enter 5 in
list in the Mesh Geometry toolbar to subdivide the Elevation input field and hit <Enter>. To add slices
every quad element into four triangular elements. The to the model increase the number of slices to 3 and
resulting finite-element mesh is shown in figure 5.11. hit <Enter>.

cbcilt=S=ö=PP
RK=cáåáíÉJbäÉãÉåí=jÉëÜ

tion in plan view remains the same but the previously


2D finite elements have now been extended to 3D pris-
matic elements.

Figure 5.12 3D Layer Configurator.

The table now shows 3 slices with elevations of 5


m, 4 m and 3 m. Click on OK to apply the settings
and to leave the dialog.

Figure 5.13 The model in 3D view.

A new view window, the 3D view, now opens dis-


playing the model in 3D. The in-slice spatial discretiza-

PQ=ö=rëÉê=j~åì~ä
SKN=mêçÄäÉã=`ä~ëë

mêçÄäÉã=pÉííáåÖë

Defining the modeling approach


S
generally applicable to variably saturated conditions.
S mêçÄäÉã=pÉííáåÖë

SKN mêçÄäÉã=`ä~ëë
SKNKN mÜóëáÅ~ä=mêçÅÉëëÉë

FEFLOW allows the simulation of flow, mass and


heat transport processes in either saturated, or in vari-
ably saturated media. The basic settings defining the
simulated processes are done via the Problem Settings
dialog that is accessed via the Edit menu.

p~íìê~íÉÇ=L=råë~íìê~íÉÇ
Saturated groundwater flow is described by the
equation of continuity with a Darcy flux law. Different
options for handling a phreatic surface are described in
chapter 6.1.5. Figure 6.1 Problem Settings dialog.
For unsaturated flow, FEFLOW solves Richards’
equation that assumes a stagnant air phase that is at cäçï=L=qê~åëéçêí
atmospheric pressure everywhere. Substantial compu-
A transport simulation is always performed in con-
tational effort can result from the typically nonlinear
junction with a flow simulation. FEFLOW provides
relationships between capillary pressure and saturation
capabilities for single-species and multispecies solute
and between saturation and hydraulic conductivity. As
transport simulation, heat-transport simulation, and
the FEFLOW implementation of Richards’ equation
combined mass-and-heat (“thermohaline”) transport
also includes the proper terms for saturated flow, it is
calculations.

cbcilt=S=ö=PR
SK=mêçÄäÉã=pÉííáåÖë

píÉ~Çó=pí~íÉ=L=qê~åëáÉåí resents a 2D model. Two-dimensional models can be of


Transient simulations proceed from an initial condi- horizontal, vertical, or axisymmetric projection.
tion and cover a specified time period. In contrast, a A typical application for horizontal 2D models are
steady-state solution can also be obtained directly and for regional water management models without signifi-
represents the state of a system having been subject to cant vertical flow components. Vertical models re used,
fixed boundary conditions and material properties for for example, for the simulation of unsaturated flow and
an infinitely long time. It is possible to combine a saltwater intrusion. Axisymmetric models have a radial
steady-state flow with a transient transport simulation. symmetry such as the cone of a pumping or injection
In such a case, the flow system is solved once at the well. Essential for the suitability of an axisymmetric
beginning with all storage terms set to zero to obtain a model are horizontally homogeneous material proper-
steady-state solution as the basis for the transient trans- ties and outer boundary conditions.
port calculation.

Figure 6.2 Simulation types.

SKNKO aáãÉåëáçå=~åÇ=mêçàÉÅíáçåë Figure 6.3 2D model projections.

FEFLOW supports 2D and 3D models. Finite ele-


ments of a lower dimension (1D in 2D models, 1D/2D Pa=jçÇÉäë
in 3D models) can be added, representing for example 3D models can be created by expanding the mesh in
fractures or boreholes. These so-called discrete feature the third direction into layers via the 3D Layer Config-
elements can, at the moment, only be defined in uration dialog which is accessed via the Edit menu. As
FEFLOW 6.0 Classic and are therefore described in the all layers have an identical horizontal discretization,
corresponding User Manual. the 3D mesh consists of prismatic or cuboid elements
and each layer extends over the entire horizontal model
Oa=jçÇÉäë domain.
A newly generated finite-element mesh, always rep- In 3D models, the direction of gravity can be set to

PS=ö=rëÉê=j~åì~ä
SKN=mêçÄäÉã=`ä~ëë

match any of the major coordinate directions (see chap- instabilities under highly nonlinear conditions in unsat-
ter 5.5). urated or density-dependent models. Thus for unsatur-
ated model types the linear Forward Euler/backward
SKNKP qÉãéçê~ä=pÉííáåÖë Euler method is used by default.

Corresponding to the discretization in space a dis- SKNKQ bêêçê=`êáíÉêáçå=


cretization in time has to be specified for transient sim-
ulations. The dimensionless error criterion is used for two
FEFLOW supports three different time-stepping purposes in FEFLOW:
options: • The determination of convergence in iterative pro-
• Constant time steps cesses based on the change of results between iter-
• Varying time steps ations, e.g., the ’outer’ iteration within a time step
• Automatic time-step control or in a steady-state solution to take care of nonlin-
As constant time steps have the disadvantage that earities in the basic equations. ^ë= íÜÉ= Éêêçê= ÅêáíÉJ
the most dynamic moment expected during the simula- • The determination of an appropriate time-step êáçå= áë= åçêã~äáòÉÇ
tion controls the time step length for the entire simula- length in automatic time-stepping procedures Äó= íÜÉ= ã~ñáãìã
tion, the definition of varying time steps offers some based on the deviation of calculated from pre- ÜÉ~Ç= íóéáÅ~ääó= áåéìí= áå= ã
more flexibility. However, this option requires the dicted solutions. ^piI=íÜÉ=êÉã~áåáåÖ=~ÄëçäìíÉ
specification of the length of each single time step in The absolute error (e.g., head difference) is normal- Éêêçê=ÇÉéÉåÇë=çå=íÜÉ=ÉäÉî~J
advance. Thus in most cases FEFLOW simulations use ized by the maximum value of the corresponding pri- íáçå= çÑ= íÜÉ= ãçÇÉäK= eáÖÜÉê
an automatic time-step control scheme, where an mary variable in initial or boundary conditions ÉäÉî~íáçåë= êÉèìáêÉ= ~= äçïÉê
appropriate length of the time step is determined based (maximum hydraulic head, maximum concentration, Éêêçê= ÅêáíÉêáçå= íç= çÄí~áå= íÜÉ
ë~ãÉ=êÉëìäí>
on the change in the primary variables (head, concen- etc.).
tration, temperature) between the time steps.
SKNKR cêÉÉ=pìêÑ~ÅÉ
cbL_b=sÉêëìë=^_Lqo
The automatic time-stepping procedure in By default, a newly created FEFLOW model
FEFLOW is by default based on a predictor-corrector reflects a confined aquifer. Saturated simulations of
scheme. unconfined conditions require specific treatment of the
The Forward Adams-Bashforth/backward trape- phreatic groundwater table.
zoid rule (AB/TR) is the default for standard flow and
combined flow and transport simulations. While the
second-order approach applied for the prediction in this SKNKRKN Oa=jçÇÉä
method in many cases provides a more accurate esti-
mation of the predicted result for the next time step and In unconfined two-dimensional models with a hori-
thus a faster solution, it also may more easily lead to zontal projection the saturated thickness is iteratively

cbcilt=S=ö=PT
SK=mêçÄäÉã=pÉííáåÖë

adapted to the resulting hydraulic head. For this pur- their specific advantages and disadvantages, the meth-
pose, material-property input includes the aquifer top ods applied in FEFLOW will be explained in detail:
and bottom elevations.
When the hydraulic head exceeds the aquifer top cêÉÉ=C=jçî~ÄäÉ
elevation, the model calculations presume confined This mode takes care of the phreatic surface by ver-
conditions in the respective area, i.e., the saturated tically moving the calculation mesh in a way that the
thickness is limited to the difference between top and top of the model is exactly at the water-table elevation
bottom elevation. Aquifers with partly confined condi- at any time. For this purpose, layer elevations are
tions are thus easily simulated. changed at each time step (transient simulation) or for
Two-dimensional vertical cross-sectional and axi- each iteration (steady-state simulation). The movement
symmetric models are always assumed to be com- is done by using the so-called BASD technique which
pletely confined. Modeling of unconfined conditions in places layer interfaces (slices) at elevations of slices in
these cases requires a simulation in unsaturated/vari- the original stratigraphy whenever possible.
ably saturated mode. Material (elemental) properties are mapped from
the original stratigraphy to the actual stratigraphy,
whereas nodal properties such as boundary conditions
SKNKRKO Pa=jçÇÉä= and observation points are moved with the slices.

In three-dimensional models with gravity in the


direction of the negative z axis (default ’top view’
models) two different strategies can be applied in
FEFLOW for handling the phreatic surface besides
simulating in unsaturated mode. It is important to note
that these methods were originally designed for
regional water-management models. They are clearly
limited (with very few exceptions) to cases with a sin-
gle phreatic surface. Simulations where partial desatu-
Figure 6.4 Schematical views of mesh movement and
ration of the model is expected below saturated parts,
parameter interpolation in free&movable mode.
e.g., due to drainage in a lower aquifer, have to be sim-
ulated in unsaturated/variably saturated mode. In con-
trast to an often-heard opinion, unsaturated models can The most important advantage of this method is its
be as computationally efficient or even more efficient ability to exclude all partially saturated or unsaturated
than saturated models with phreatic-surface handling if parts of the initial stratigraphy from the model so that
appropriate simplifications are applied to the unsatur- only saturated parts are simulated at all times. The
ated material properties. main disadvantage is a consequence of the layer move-
As both options for phreatic-surface handling have ment: In cases where the actual water table cuts

PU=ö=rëÉê=j~åì~ä
SKN=mêçÄäÉã=`ä~ëë

through slices of the initial stratigraphy, model ele- uration is calculated by dividing the saturated thickness
ments may occur that are located in multiple layers of the element by the total thickness of the element.
(and material zones) of the original stratigraphy.In Conductivity values in all directions are then linearly
these cases, a volume-weighted averaging for the mate- reduced by multiplying them with the partial saturation
rial properties is applied, giving rise to material proper- of the element.
ties that differ from the original input. When For entirely dry elements (hydraulic head below the
interpolating between aquifer and aquitard properties, element bottom), a residual water depth is applied for
this approximation might not be acceptable (Figure the calculation of the partial saturation and reduced
6.5). conductivity. This residual water depth can be defined
via the Free Surface tab of the problem settings.
Groundwater recharge is applied on the top of the
model in phreatic mode and therefore has to pass the
partially saturated/dry elements before reaching the
water table.
The phreatic mode avoids all slice movement and
related parameter interpolation and is therefore applica-
ble to water tables with steep gradients that extend over
multiple layers. On the other hand, dry elements with
Figure 6.5 Unintended conductivity interpolation in low conductivity values can lead to strong contrasts in
free&movable mode in a schematized layered aquifer the model, making the solution more difficult. The
(cross-section view). default low residual water depth might cause difficul- få= ãçÇÉäë= ïáíÜ
ties for the infiltration of recharge into dry soil, espe- íÜáÅâ= Çêó= ä~óÉêë= íÜÉ
As a rule of thumb, the free&movable method is êÉëáÇì~ä= ï~íÉê
cially in cases with time-varying groundwater
particularly suitable for cases where the water table ÇÉéíÜ= ëÜçìäÇ= ÄÉ= áåÅêÉ~ëÉÇ
recharge.
varies within one model layer. It is less applicable to
In phreatic mode, the unconfined storage term is Ñçê=ãçêÉ=åìãÉêáÅ~ä=ëí~ÄáäáíóK=
models where steeply dipping phreatic surfaces are
always only applied to the slice set to ’phreatic’, i.e.,
expected.
usually to the top slice. The values for drain-/fillable
porosity, however, are correctly derived from the layer
mÜêÉ~íáÅ
where the water table is located at a given time. While
In phreatic mode, the model stratigraphy is fixed this simplification has no negative consequences for
and, as a consequence, elements may become dry or typical regional models with significant horizontal
partially saturated. In contrast to unsaturated mode, the flow components, it makes the phreatic mode less suit-
calculation of the unsaturated zone is highly simplified able for problems in which vertical flow is important,
and (with rarely occurring exceptions) only one such as simulations of drainage of a soil column from
phreatic surface is possible. the bottom.
For each partially saturated element, the partial sat-

cbcilt=S=ö=PV
SK=mêçÄäÉã=pÉííáåÖë

cêÉÉ=pìêÑ~ÅÉ=pÉííáåÖë applied at all bottom nodes that would otherwise


`çåëíê~áåáåÖ= íÜÉ
ï~íÉê= í~ÄäÉ= çå= íçé To allow combining of different methods of fall dry, with a fixed head that is bottom elevation
çê= Äçííçã= ÅÜ~åÖÉë phreatic-surface handling, the method is set for each plus residual water depth as defined in the Free
íÜÉ=çîÉê~ää=ï~íÉê=Ä~ä~åÅÉ=çÑ slice separately. Surfaces tab.
íÜÉ=ãçÇÉäK=bëéÉÅá~ääó=~ÇÇáåÖ Typically, the first slice is set to either phreatic or For the model surface, similar options are available:
ï~íÉê=çå=íÜÉ=ãçÇÉä=Äçííçã free&movable, while all the slices below are set to • Unconstrained (default):
ãáÖÜí=åçí=ÄÉ=~ÅÅÉéí~ÄäÉK= unspecified except for the bottom slice which is always Hydraulic-head values exceeding the model top
set to fixed. Unspecified slices are defined by the first elevation are tolerated, and the parts above the top
slice above that is specified, e.g., unspecified slices are treated as part of the first layer, i.e., calculation
below a free&movable slice can move if necessary. is done with the properties of the first layer (3D
Layers whose top slice is set to fixed are treated as models). For 3D models using the phreatic mode
fully saturated, no matter whether the hydraulic head is for the free surface, alternatively the aquifer can
above or below the layer. In models using the be treated as confined as soon as it gets fully satu-
free&movable approach, fixed is especially useful to rated. In 2D horizontal unconfined models, the
avoid slice movement (and possible material property model is treated as confined if the water level
interpolation) in layers that are known to be saturated exceeds the top elevation, which is a material
during the entire simulation. property in this model type and therefore can be
set higher if this behavior is not desired.
• Constrained:
SKNKRKP cêÉÉ=pìêÑ~ÅÉ=`çåëíê~áåíë FEFLOW will prevent water levels higher than
the model surface. If hydraulic-head values higher
In models with a phreatic surface, two particular than the top elevation would occur, FEFLOW sets
cases may occur: Dirichlet boundary conditions with a value of the
• All layers can be dry in a certain location. top elevation at these locations.
• The water level can exceed the top of the model.
FEFLOW provides two options for dealing with a SKO pçäîÉê=qóéÉ
dry model bottom:
• Unconstrained (default): FEFLOW offers iterative solvers and a direct equa-
Hydraulic-head values lower than the model bot- tion solver. As the computational demand of the direct
tom are tolerated. The saturated thickness is con- solver increases with the third power of the number of
sidered equal to the residual water depth at these mesh nodes, the applicability of this solver has a practi-
locations. cal limit of about 100,000 nodes.
• Constrained: Iterative solvers are therefore used by default. Sepa-
FEFLOW will prevent hydraulic-head values rate iterative solver types can be selected for the (sym-
below the model bottom. For this purpose, metric) flow and (nonsymmetric) transport equation
Dirichlet boundary conditions are internally systems. The default options are a preconditioned con-

QM=ö=rëÉê=j~åì~ä
SKP=qìíçêá~ä

jugate-gradient (PCG) solver for flow and a BICG- conditions and confirm with Apply. In the Data
STABP-type solver for transport. Alternatively, for panel, the material-properties list automatically adapts
either type of equation systems an algebraic multigrid to the changed settings. Transmissivity is replaced by
solver can be chosen (SAMG). The main advantages of the parameter Conductivity, and Aquifer top and bot-
SAMG are its parallelization on multicore or multi- tom elevation need to be defined.
processor systems, and its more efficient solution algo- Additionally, for unconfined (phreatic) models free-
rithm, in particular for steady-state simulations and surface constraints can be set to define model behav-
simulations with large ranges of element sizes in the ior when water touches the top surface, or the model
mesh. As the algebraic multigrid technique is not falls dry at the bottom.
always the most efficient one, the SAMG solver auto- Leave the Problem Settings dialog with
matically selects between a CG-type or AMG-type Cancel and close the model without saving the
solution strategy according to the current conditions. changes.
We proceed by studying a 3D flow model. Click
SKP qìíçêá~ä Open and load the file free3d.fem. Again, open
the Problem Settings dialog vie the Edit menu. The
In this exercise we load a number of models with Problem Class page shows that a saturated model type
different problem types to get familiar with the avail- is set.
able problem settings. In contrast to 2D models the projection is fixed for
3D models, but the gravity direction can be changed
SKPKN `çåÑáåÉÇ=L=råÅçåÑáåÉÇ=jçÇÉäë from the default negative z-axis to a different direction.
On the Free Surface page, Confined or
We start with a very basic 2D flow model. Start Unconfined conditions can be chosen where two
FEFLOW and click Open to load the file quad- different options are available for the latter. Currently, a
mesh.fem. To check the basic settings of the model, Free & Movable approach is chosen. When we change
open the Problem Settings dialog via the Edit the status of slice 1 to Phreatic, we can use
menu. Specific option to define whether the top slice
On the Problem Class page we can see that a satu- shall be regarded as confined or unconfined when the
rated flow model type is set. The Projection page water level reaches the top surface.
shows that the model is assumed to be horizontal. Now, Leave the dialog with Cancel, activate the 3D
switch to a Vertical projection and click Apply. view and click Play in the Simulator toolbar
Notice how the page list under Problem Class changes: to start the simulation. We can see the mesh moving in
The Free Surface page is removed and the Gravity such a way that the top of the model is always at the
direction page is displayed instead. water level elevation.
Switch back to a Horizontal projection and open When the simulation has stopped, leave the simula-
the Free Surface page. The model is currently assumed tor with a click on Stop. Reload the same file via
to be confined. Change the settings to Unconfined File > Recent FEM Problem files.

cbcilt=S=ö=QN
SK=mêçÄäÉã=pÉííáåÖë

Go back to Edit > Problem Settings and switch SKPKP qê~åëéçêí=jçÇÉäë


to Confined mode on the Free Surface page. Click
Apply and leave the dialog with OK. Start the To get familiar with the settings for transport simu-
simulation run for the changed conditions with a click lations load the model simulation.fem.
on Play. The mesh geometry is now fixed and the Open the Problem Settings dialog via the Edit
resulting hydraulic head distribution differs from the menu and start on the Problem Class page. Saturated
free & movable model run. conditions are assumed and the model type is set to
Terminate the simulation with a click on Stop Flow and Mass Transport. The calculation of both
and close the model without saving the changes. flow and transport is set to transient.
In mass-transport simulations, the Problem Settings
SKPKO råë~íìê~íÉÇ=jçÇÉäë dialog contains two additional pages: On the Transport
Settings page, we can choose between the
We continue with a 2D unsaturated flow model. Convective and the Divergence form of the
Click on Open and load the file transport equation and change the settings for the cal-
dam_seepage.fem. culation of fluid viscosity and density. Additionally, the
Start with the Problem Settings dialog located in Reference concentration for the mass- transport calcu-
the Edit menu. The Problem Class page shows that lation, and the Reference temperature for heat-trans-
the model type is set to unsaturated steady flow. port problems are specified here.
The list on the left-hand side now contains a new Switch to the Multispecies page. Here, additional
page for Unsaturated Flow. Here, the basic settings for fluid or solid species can be defined if the model
unsaturated models such as the form of the Richards requires more than one species. To add or remove spe-
flow equation, iteration schemes and hysteresis settings cies from the list, the Add new species or
can be changed. Do not do any changes here and switch Remove current species tools can be used.
to the Projection page. As we can see, only Proceed to the Numerical Parameters page. On this
Vertical and Axisymmetric projections are pos- page, the settings for the Error criterion and for the
sible for 2D unsaturated models. Leave the dialog with computation of mass matrices are located. Addition-
Cancel. ally, different upwinding techniques, e.g., Full
In unsaturated models additional parameters are upwinding or Shock capturing can be selected for
available in the Data panel. Saturation and Mois- the transport calculation. As we can see, for the current
ture content are added to the list of Process Variables model the default option No upwinding (Galerkin-
and the Material Properties list now contains unsatur- FEM) is set. Click Cancel to leave the dialog
ated flow parameters, such as Residual and Maximum without any changes.
Saturation. Notice how the Data panel has changed com-
pared to a flow simulation: The Process Variables,
Boundary Conditions and Material Properties trees
now each contain an additional branch for mass trans-

QO=ö=rëÉê=j~åì~ä
SKP=qìíçêá~ä

port. In multispecies models, a separate branch is cre- flow on the Problem Class page and click Apply to
ated for each species so that initial concentrations, confirm the changes. To specify the time discretization
boundary conditions and material properties can be for the transient simulation, go to the Temporal Set-
defined separately for each species. tings page that now appears in the list on the left-hand
The Budget panel now has two tabs, one for side. The available time-stepping options are Constant
Fluid and one for Mass. To monitor the mass fluxes time steps, Varying time steps and Automatic time-
during the simulation, click on the tab Mass and set the step control.
checkmark in front of Active. In multispecies mod- By default, an Automatic time-step control based
els, the panel contains a separate tab for each species. on a Predictor-corrector scheme with a Forward
The Content panel also contains additional Adams-Bashforth / Backward Trapezoid integration
entries for transport. To evaluate the amount of mass scheme is assumed. For the automatic time stepping, an
contained in the model, start the content calculation Initial time-step length and a Final time need to be
with Active and select Diluted mass from the con- specified. Change the Final time to 3650 days and
tent list. In a multispecies case, a species selector is dis- click OK to apply the changes and to leave the dia-
played which can be used to show the content of a log.
particular species. Start the transient simulation by clicking Play.
The current simulation time is displayed in the
SKPKQ píÉ~Çó=L=qê~åëáÉåí=jçÇÉäë Simulator toolbar and, optionally, also at the bot-
tom of each view window. All process variables such
To study the available settings for steady and tran- as hydraulic head can be monitored during the simula-
sient simulations, load the file enclosed_valley_3.fem. tion. Instead of the Error Norm diagram displayed for
Access the Problem Settings dialog via the Edit steady-state simulations, the Time Steps diagram
menu and go to the Problem Class page. The model appears and plots the elapsed simulation time versus
type is set to saturated flow and a steady-state simula- the time-step length.
tion is selected.
Leave the dialog with Cancel and start the sim-
ulation with a click on Play in the Simulator
toolbar. After a brief computation the steady-state solu-
tion is reached. In addition to the Hydraulic Head and
the Pressure diagram the Error Norm History is
shown which plots the remaining dimensionless error
for every iteration.
Terminate the simulation with a click on Stop
and reload the same file via File > Recent FEM
Problem files without saving the changes. Open the
Problem Settings dialog again, select Transient

cbcilt=S=ö=QP
SK=mêçÄäÉã=pÉííáåÖë

QQ=ö=rëÉê=j~åì~ä
TKN=fåíêçÇìÅíáçå

tçêâáåÖ=ïáíÜ=pÉäÉÅíáçåë

Use selections efficiently for parameter assignment and results evaluation


T
TKO pÉäÉÅíáçå=qççäë
T tçêâáåÖ=ïáíÜ=pÉäÉÅíáçåë

TKN fåíêçÇìÅíáçå
Selections can be created by applying one, or a
Selections of nodes or elements are among the basic combination, of the available manual or map-based
concepts in FEFLOW. They are the basis for parameter selection tools. The selection tools work on an either
input, visualization and postprocessing. nodal or elemental basis according to the nature of the
Selections can be stored with the model for repeated parameter that is currently active in the Data panel.
use—for example, to apply flow and mass transport The manual selection tools are:
boundary conditions at the same nodes, or to start path- • Select Individual Nodes/Elements
lines from nodes with a well boundary condition. • Select Complete Layer/Slice (3D view)
• Select in Rectangular Region (FE-Slice view)
• Select Using a Lasso (FE-Slice view)
• Select in Polygonal Region (FE-Slice view)
• Select Nodes along a Border (FE-Slice view)
Map-based selection requires that the desired map is
active in the Maps panel. An active map is indicated by
a map name in bold letters.
Interactive selection for a map includes selection
based on points, lines, and polygons. The availability
of certain selection modes depends on the map type:
While for polygon maps polygon, line (edge) and point
Figure 7.1 Nodal and elemental selections (FE-Slice
View). (node) selection is possible, for point files only point
selection is available. Clicking on a map element trig-
gers the selection of all nodes or elements within the
snap distance as defined in the Snap Distance toolbar
cbcilt=S=ö=QR
TK=tçêâáåÖ=ïáíÜ=pÉäÉÅíáçåë

(Figure 7.2).

qç=~îçáÇ=íÜ~í=ìåáåJ
íÉåíáçå~ääó= éêÉîáJ
çìë=ëÉäÉÅíë=~êÉ=âÉéí
~ë=é~êí=çÑ=~=åÉï=ëÉäÉÅíáçåI=áí
áë= êÉÅçããÉåÇÉÇ= íç= ÅäÉ~ê
ëÉäÉÅíáçåë=~ÑíÉê=ìëáåÖ=íÜÉãK= Figure 7.3 Selection modes: start selection, new, add,
remove, toggle, intersect (upper left to lower right).

TKP píçêáåÖ=pÉäÉÅíáçåë
Using the context menu of either the active view or
Figure 7.2 Nodal selection based on a map polygon (FE- the Spatial Units panel, selections can be stored with
Slice View). the model for later use in parameter assignment, visual-
ization or postprocessing.
A selection can also be performed for all map ele- Stored selections appear in the Spatial Units panel
ments without user interaction. and can be renamed via their respective context menu
By default, applying a selection tool to a group of or set as the current selection. Moreover, the nodes/ele-
nodes or elements toggles the selection state of theses ments of the stored selection can be added to, removed
nodes or elements, i.e., previously unselected nodes/ from, or intersected with the current selection. It is also
elements become selected, and already selected ones possible to directly make any stored node selection the
are deselected. Alternative selection modes are avail- budget domain for the Budget panel.
able via the selection toolbar: Create a new selection
every time, always add to the current selection, remove
from the selection, or intersect with the current selec-
tion (Figure 7.3).

QS=ö=rëÉê=j~åì~ä
TKQ=qìíçêá~ä

TKQ qìíçêá~ä nodes are highlighted in yellow. Delete this selection


again with a click on Clear Selection.
TKQKN= qççäë

Figure 7.4 Selection toolbar.

Figure 7.5 Snap distance toolbar.

TKQKO= dÉåÉê~ä=oÉã~êâë

Whether a nodal or an elemental selection is created


depends on the active parameter in the Data panel.
Figure 7.6 Node selection in FE-Slice view.
In the following exercises all selections are created
for nodes. Selections on an elemental basis can be cre-
ated following the same principle, though. Instead of selecting individual nodes, we can use
Select All to create a selection that contains all
TKQKP j~åì~ä=pÉäÉÅíáçåë nodes if a 3D view is active, or all nodes on the current
slice in an active FE-Slice view.
After a click on Clear Selection, choose the
As a first exercise, we create a number of selections
tool Select in Rectangular Region and draw a rect-
manually. First, click on Open and load the model
angle to create a new selection. Draw a second rectan-
selections.fem. Two views are displayed, an FE-Slice
gle that partially overlaps the first one. As we can see,
view (2D) and a 3D view window.
the selection is toggled: The already selected nodes are
removed and newly selected nodes are added to the
TKQKPKN pÉäÉÅíáçåë=áå=Oa selection. This default selection mode can be changed
by clicking Toggle in Selection which exposes all
Click in the FE-Slice view to make it the active available modes.
view and then browse to slice 1 in the slice list of the Click on Undo Last Selection Step to reverse
Spatial Units panel. the effect of the second rectangle. Now, activate the
Choose the tool Select Individual Nodes/Ele- Set New Selection mode and draw a rectangle sim-
ments from the Selection toolbar and click on an ilar to the one we just deleted. The result is quite differ-
arbitrary number of nodes on slice 1. The selected ent: The nodes in the first rectangle are now deselected
and a new selection is set instead. Once again, click
cbcilt=S=ö=QT
TK=tçêâáåÖ=ïáíÜ=pÉäÉÅíáçåë

Undo Last Selection Step and try the other modes


available for setting selections.

Figure 7.8 Selected nodes at southern border.

Figure 7.7 Toggled Selection.

TKQKPKO pÉäÉÅíáçåë=áå=Pa
A tool that is only available for node selections in
the FE-Slice view is Select Nodes along a Border.
Three selection tools are available in a 3D view:
Clear the current selection and switch back to the
Toggle in Selection mode. Click and hold the left Select All
mouse button on the western most node of the southern Select Individual Nodes/Elements
border. Move the cursor further along and release it at Select Complete Layer/Slice
the last node of that border. The selected nodes are now
highlighted in yellow. We now create a selection that contains all nodes of
To also select the corresponding nodes on the slices the top slice. Make sure that the 3D view is the active
below, we use the Copy Selection to Slices/Layers view window. Choose the Select Complete Layer/
tool in the Selection toolbar. Choose all slices as Slice tool from the dropdown menu of the
the target slices. Confirm with OK. In the 3D view Selection toolbar. Placing the mouse cursor over
we can see that the nodes of the southern border have any node in the top slice highlights all its nodes. Create
been selected on all slices. the selection with a single click. The selected nodes are
displayed as yellow disks.

TKQKQ j~éJÄ~ëÉÇ=pÉäÉÅíáçåë

A further option to create selections is to use maps.


The points, lines and polygons contained in the super-
mesh are available in the maps panel and selections can
be set based on these features.

QU=ö=rëÉê=j~åì~ä
TKQ=qìíçêá~ä

For this exercise, we use the same FEFLOW model TKQKR píçêáåÖ=pÉäÉÅíáçåë
as in the previous exercises. This model contains a
number of maps and also its supermesh. As map-based Selections can be stored for later use in parameter
selection is only possible in the FE-Slice view, we first assignment, visualization or postprocessing actions.
have to make sure that this is the active view. To store the current selection, invoke a context
In the first exercise we select the nodes of the well menu by right-clicking in the active view or on an
locations contained in the map demo_wells. These empty part in the Spatial Units panel. Choose the
locations have also been included in the supermesh and option Store Current Selection in the context
correspond to the refined areas in the southern part of menu. The stored selection appears in the new Node
the model area. Browse to slice 4 in the Spatial Selections branch in the Spatial Units panel. Open
Units panel, then switch to the Maps panel and acti- the context menu of the stored selection with a right-
vate demo_wells with a double-click. Enter 1m click on the selection in the Spatial Units panel.
in the Snap Distance toolbar and click on After choosing Rename, a new name can be
Select by All Map Geometries to create the selec- entered for this selection.
tion. The selected nodes are now highlighted in yellow.
Before we proceed, clear the selection with the
Clear Selection button.
In the next step, we create a selection for the poly-
gon that is defined in the map sewage_treatment, the
refined area on the left side of the model. Activate this
map in the Maps panel with a double-click and sim-
ply click Select by All Map Geometries again. A
different option to select this polygon is to choose the
Select by Map Polygon tool from the drop-down
list in the Selection toolbar. The selection is then
set with a single click in the respective polygon in the
FE-Slice view. Again, finish with a click on Clear
Selection.
The supermesh can be used to create selections in
the same way. Activate Supermesh > Polygons in the
Maps panel. When the mouse cursor is moved over
a polygon it is highlighted. Set the selection with a sin-
gle click.

cbcilt=S=ö=QV
TK=tçêâáåÖ=ïáíÜ=pÉäÉÅíáçåë

RM=ö=rëÉê=j~åì~ä
UKN=fåíêçÇìÅíáçå

m~ê~ãÉíÉê=sáëì~äáò~íáçå

Plotting input parameters and results


U
parameter may be plotted to the outer boundary of the
U m~ê~ãÉíÉê=sáëì~äáò~íáçå

UKN fåíêçÇìÅíáçå model domain, but also onto a single slice or to the
boundary of a parameter zone.
Visualization of the model parameters is not only For FE-Slice views, the target geometry is a layer
essential during model parameterization but for check- or slice, depending on whether nodal or elemental
ing the assigned model properties, for evaluating the parameters are shown. The Spatial Units panel (or the
model results, and for the presentation of model prop- <Pg Up> and <Pg Down> keys) can be used to switch
erties and simulation results. between different layers/slices. Cross-sectional views
are not affected by the Spatial Units panel. In case the
active view is a 3D view, the geometry of any spatial
UKO sáÉï=táåÇçïë unit can be added to the view by a double click on the
unit, or via the context menu.
All visualization options refer to a specific view
A parameter or parameter group (e.g., the group of
window (see chapter 2.4). Depending on the type of the
all flow boundary conditions) is added to the view by
view window, different options for visualization are
double click on the parameter in the Data panel, or by
available. Each view window manages its own list of
using the context menu of the parameter. The parame-
visualized parameters and visualization styles and set-
ter will be plotted to the geometry that is active in the
tings. The panels controlling visualization always
Spatial Units panel. Parameters can be plotted to more
reflect the active view window.
than one geometry at the same time, e.g., to the bottom
slice and the vertical hull.
UKP jçÇÉä=dÉçãÉíêó=~åÇ=a~í~
mäçíë UKQ sáëì~äáò~íáçå=léíáçåë
In the Spatial Units panel, the visualization target All geometry (3D view) and parameter information
geometry is chosen. For example, in a 3D view, a currently available in the active view are listed in a tree

cbcilt=S=ö=RN
UK=m~ê~ãÉíÉê=sáëì~äáò~íáçå

in the View Components panel. As the tree always trols to activate the respective plane and to specify
reflects the active view, it automatically changes when whether the plane is to be considered as part of a cutout
switching between the view windows. By changing the combination or as a simple clipping plane. A simple
checkbox in front of the leaf and branch items in the clipping plane clips all parts of the object located on its
tree, visibility of the corresponding view components back side. When using a cutout combination, only
can be toggled. those object parts are clipped that are on the back side
For parameters, different visualization styles may of all clipping planes of the cutout combination.
be available, one of which is active by default. For Simple clipping planes can be applied in addition to
example, hydraulic head can be shown as continuous a cutout combination.
plot, fringes, isolines, or isosurfaces in a 3D view. The location of each clipping plane can be changed
The parameters and visualization styles have prop- in the Plane definition dialog that is opened by click-
erties that can be edited in a Properties panel. The ing on the respective model view icon in the Planes
panel is opened by double-clicking on the parameter or panel. While modifying the plane equation, the plane is
style in the View Components panel, or by using the shown in the active view window.
context menu of the parameter or style. The contents of Whether a visualization item is clipped or not is
the Properties panel depend on the parameter or style, controlled via its context menu in the View Compo-
and are described in detail in the FEFLOW help sys- nents panel.
tem.
Whenever a new parameter is added to a view, by
default the previously shown parameter is removed.
While this is a convenient behavior for quickly editing
different parameters one at a time, in many cases it is
preferable to visualize more than one parameter simul-
taneously. For this purpose, parameters can be locked
via their context menu in the View Components panel.
Locked parameters are not removed when adding a
new component.

UKR `äáééáåÖ=~åÇ=`~êîáåÖ
Up to six planes can be arbitrarily defined and com-
bined in each 3D view window to expose data other- Figure 8.1 Cross-section visualization in 3D.
wise hidden within the model domain. Each of the six
planes of the active view can be accessed via the
Planes panel. For each plane, the panel provides con-

RO=ö=rëÉê=j~åì~ä
UKS=fåëéÉÅíáçå

UKS fåëéÉÅíáçå between different views: Click in the FE-Slice view


and set it as the active window. Hydraulic head then
The active parameters in the current view and the becomes the active parameter in the View Compo-
attributes of maps shown in the view can be inspected nents and in the Data panel and Conductivity [Kxx]
on a nodal or elemental basis, using the inspection tool, is removed from the View Components panel.
invoked via the Inspection toolbar. The properties of Additionally, the Spatial Units panel now shows
the target location are shown as constant values or that we are currently working on slice 1.
curves for transient properties in the Inspection panel.
UKTKO ^ÇÇ= jçÇÉä= dÉçãÉíêó= ~åÇ
m~ê~ãÉíÉêë

Click in the 3D view to set it as the active view.


Double-click on Hydraulic head in the Data panel
to plot this parameter. Note that the previously dis-
played parameter disappears from both the active view
and the View Components panel when a new
parameter is plotted.
It is also possible to display different parameters at
Figure 8.2 Checking boundary conditions with the the same time: Open the context menu of the entry
Inspection tool. Hydraulic head in the View Components panel and
select Lock Data at View. In front of Hydraulic
UKT qìíçêá~ä head the lock icon now appears. In the Data
panel double-click on In/outflow on top/bottom to add
The visualization options described in the following this parameter to the active view. Both parameters are
exercises are available during model setup, simulation now displayed at the same time.
run and also in postprocessing. In the 3D view not only parameters but also addi-
tional geometry can be added to the active view. Go to
UKTKN sáÉï=táåÇçïë the Spatial Units panel and double-click on the
entries Slice 1 and Slice 4. These slices are now added
Start FEFLOW, click on= Open and load the file to the active view. A new item for each slice appears in
visualization.fem. A 3D and an FE-Slice view are dis- the Faces and Edges branches of the control tree in the
played. For the 3D view, Conductivity [Kxx] is the View Components panel.
active parameter. Hydraulic head is the active parame-
ter in the FE-Slice view.
Pay attention to the changes when we switch

cbcilt=S=ö=RP
UK=m~ê~ãÉíÉê=sáëì~äáò~íáçå

To plot only slices 1 and 4 and not the entire domain UKTKP sáëì~äáò~íáçå=léíáçåë
uncheck the entries Faces > Domain and Edges >
Domain and also Hydraulic head > Continuous >
Domain in the View Components panel.

Figure 8.3 Plotting on selected geometries in 3D. Figure 8.4 Hydraulic head values displayed as continu-
ous, fringes and isolines plot.
We now want to plot a different parameter on each
of the two slices. Start with slice 1. In the Spatial We now select different visualization styles for the
Units panel single-click on Slice 1 to set it as target parameter Hydraulic head. Set the FE-Slice view as
geometry for the plot. Then, double-click on Hydraulic active view. In the View Components panel, three
head in the Data panel. Now click on Slice 4 in the styles are available for this parameter: Continuous,
Spatial Units panel and double-click Drain-/fill- Fringes and Isolines. Display the different styles by
able porosity. checking the checkbox in front of the respective entry.
Not only parameters but also maps can be plotted to The properties of each style can be edited in the
selected geometries. In the Spatial Units panel, set respective Properties panel. Open the context menu
Slice 1 as target geometry. Uncheck Hydraulic head in of Hydraulic head > Isolines in the View Compo-
the View Components panel and double-click on nents panel with a right-click and select Properties.
topography_rectified in the Maps panel. The map Several editing options are available: In the Size tab,
is now visible on slice 1 in the 3D view. The resulting the line width can be changed and the Light and Opac-
plot in the 3D view is shown in figure 8.3. ity tabs can be used to control brightness and make the
plot more or less transparent. To change the number of
displayed isolines go to the Iso tab. Increase the num-
ber of equidistant isolines to 25 and click
RQ=ö=rëÉê=j~åì~ä
UKT=qìíçêá~ä

Apply to confirm the changes. of the plane are now clipped away. To change the posi-
To hide the legend of a particular parameter style tion of the plane open the Plane definition dialog by
open the context menu of the style entry in the View clicking on its view in the Planes panel. Use the
Components panel and uncheck Legend Display. slider bars to change the offset or the normal vector.
To edit the number format of the displayed parame- Confirm the settings with Apply and leave the dia-
ter legend select Number Format in the context log with Close.
menu of Hydraulic head in the View Components
panel. Here, switch to Fixed floating-point and change
the number of significant digits to 2. Clicking
OK confirms the changes and the legend is now
displayed with the new settings.
The data range of the parameter plot and also the
color scheme are edited in the Properties panel of
the parameter. To open the panel right-click on
Hydraulic head in the View Components panel and
select Properties. Uncheck the box in front of
Auto-update range and set a new minimum value
Figure 8.5 Carving planes and carved model domain in
of 30 m and a maximum value of 50 m for the 3D view.
data range. The changes are confirmed with a click on
Apply. To change the color style of the parameter Now activate plane number 4 and select the option
plot right-click in the colored sidebar and switch to one Carving for both planes. Now, only the features on
of the available presets, e.g., the FEFLOW Classic the yellow sides of both planes are cut away.
style. The changes are immediately applied and dis- Visualization examples with carved models are
played in the active view. shown in Figures 8.5 and 8.6.

UKTKQ `äáééáåÖ=~åÇ=`~êîáåÖ

Go to Window > New and select 3D view to


open a new window. In the Navigation panel click
on the Projection tab and move the Scaling slider bar
upwards to stretch the model and to add some vertical
exaggeration for better visibility of the different layers.
In the Planes panel six different planes avail-
able for clipping and carving are displayed. Activate
the plane in the second box by setting the checkmark in
front of Active. All parts located on the yellow side

cbcilt=S=ö=RR
UK=m~ê~ãÉíÉê=sáëì~äáò~íáçå

Figure 8.6 3D visualization example.

RS=ö=rëÉê=j~åì~ä
VKN=fåíêçÇìÅíáçå

m~ê~ãÉíÉê=^ëëáÖåãÉåí

Input of initial conditions, boundary conditions and material properties


V
tree view in the Data panel (Figure 9.1):
V m~ê~ãÉíÉê=^ëëáÖåãÉåí

VKN fåíêçÇìÅíáçå • Process Variables


• Boundary Conditions
The task of assigning model parameters is in many • Material Properties
cases repeatedly performed during model setup and • Reference Data
application. After the initial parameterization, model
properties may have to be changed during calibration,
or parameters need to reflect different scenarios. Thus
the workflows for parameter assignment are crucial for
the efficient handling of a groundwater model.
Typical assignment procedures are based on the
activation of a property to be assigned and the selection
of the target nodes or elements. The tools for selecting
nodes or elements are described in detail in chapter 7.
There are some exceptions from this standard work-
flow: When working with map data, FEFLOW pro-
vides the means to automatically activate a parameter
and/or select the target geometry based on information
in the map or linked to the map. Figure 9.1 Data panel.

VKO fåéìí=m~ê~ãÉíÉêë While process variables (including initial condi-


tions) and boundary conditions are defined on the mesh
FEFLOW distinguishes between four groups of nodes, material properties representing the characteris-
parameters, all of them visible on the first level of the tics of the medium are assigned on an elemental basis.

cbcilt=S=ö=RT
VK=m~ê~ãÉíÉê=^ëëáÖåãÉåí

Reference data are normally not directly used in the ports four types of boundary conditions for flow and
simulation and can be based on nodes or elements. equivalent boundary condition types for mass and heat
transport:
VKOKN mêçÅÉëë=s~êá~ÄäÉë • Hydraulic-head BC
• Fluid-flux BC
Process variables include the primary variables • Fluid-transfer BC
hydraulic head, concentration, and temperature (as • Well (nodal source / sink) BC
applicable). When setting up the model, they describe The sign convention for boundary conditions in
qÜÉ= éêçÅÉëë= î~êáJ FEFLOW defines fluxes out of the model as positive
the initial conditions. During and after the simulation
~ÄäÉë= ~êÉ= ìëÉÇ= Ñçê
these process variables reflect the then-current condi- (e.g., well abstraction), while inflows are negative
ÄçíÜ= éêçîáÇáåÖ= áåáJ
tions. (Figure 9.2). Notably, this convention differs from
íá~ä= ÅçåÇáíáçåë= ~åÇ= ëíçêáåÖ
íÜÉ= êÉëìäíëK= ^ÑíÉê= ~= ëáãìä~J Other process variables contain values derived from other parts of FEFLOW, such as the Budget panel or
íáçå=Ü~ë=ëí~êíÉÇI=íÜÉó=Çç=åç the original primary variables. For example, pressure is the definition of boundary constraints, where inflows
äçåÖÉê= êÉÑäÉÅí= áåáíá~ä= ÅçåÇáJ not stored separately in FEFLOW, but calculated from are considered as positive, outflows as negative
íáçåë> hydraulic head and elevation on the fly. When these (Figure 9.4).
secondary parameters are used as input variables, the
input is converted into the original primary variable
based on current conditions.
The third type of process variables are auxiliary
variables supporting results evaluation and visualiza-
tion, such as budget and pathlines. They cannot be used
as input parameters.
In 3D models, the elevation is included in the pro-
cess variables section as a nodal parameter. In models
with fixed mesh, the elevation does not change during Figure 9.2 Algebraic signs for boundary conditions.
the simulation. In models representing a phreatic sur-
face with the free & movable approach (see chapter
6.1.5), the actual nodal elevation changes during the eóÇê~ìäáÅJÜÉ~Ç=_`
course of the simulation. The Reference Elevation pro-
This boundary condition type—often also referred
cess variable preserves the original node elevations.
to as Dirichlet or 1st kind boundary condition—speci-
fies a time-constant or time-varying hydraulic head at a
VKOKO _çìåÇ~êó=`çåÇáíáçåë node. The inflow or outflow to/from the model domain
at the node can be calculated from the simulation
By default, all model boundaries in FEFLOW are result.
impervious. To allow fluxes into or out of the model,
boundary conditions have to be defined. FEFLOW sup-

RU=ö=rëÉê=j~åì~ä
VKO=fåéìí=m~ê~ãÉíÉêë

cäìáÇJÑäìñ=_`
The fluid-flux boundary condition—often called
Neumann or 2nd kind boundary condition—describes
an in- or outflow of water at element edges (2D) or ele-
ment faces (3D). Though nodally defined, the condi-
tion must be applied for at least two adjacent nodes
(2D) or all nodes of a vertical or horizontal element
face (3D) to be effective. The given value is a Darcy
flux perpendicular to the boundary.

cäìáÇJíê~åëÑÉê=_`
Transfer conditions (Cauchy or 3rd-kind conditions)
can be used to describe rivers, lakes, and known
hydraulic heads in a distance from the model boundary
(sometimes called ’general head’ boundaries). The
condition is used to apply transfer properties between a Figure 9.3 Flux and transfer boundary conditions in 3D
reference hydraulic head and groundwater. Thus the model.
value of the boundary condition is a reference hydrau-
lic head (e.g., river water level). The transfer properties
(e.g., properties of a clogging layer) are defined as a tÉää=_`
material property on elements adjacent to the boundary Well boundary conditions are nodally applied and
condition. Similar to the Fluid-flux BC the transfer represent local injection or abstraction of water. In 3D
boundary condition must be specified along a line (2D) models, well boundary conditions on the same node in
or for an entire element face (3D—Figure 9.3). neighboring slices are automatically considered as a
multi-layer well. This means that the boundary condi-
tion nodes are internally connected by a highly conduc-
tive 1D element reflecting the high permeability within
a well pipe. The total withdrawal from a multilayer
well is the sum of the boundary condition values. Its qÜÉ= êÉëìäíáåÖ
distribution on layers is a result of the model run, ÜóÇê~ìäáÅ= ÜÉ~Ç= ~í
depending on the layer properties and hydraulic head ïÉää= åçÇÉë= ÇÉéÉåÇë
çå=íÜÉ=äçÅ~ä=ëé~íá~ä=ÇáëÅêÉíáJ
conditions in the different layers/slices. Practically,
ò~íáçåK= nì~åíáí~íáîÉ= ÅçãJ
total withdrawal is typically assigned to the bottom é~êáëçåë= ëÜçìäÇ= ÄÉ= ã~ÇÉ
node of a multi-layer well, and zero values are set for ïáíÜ=Å~êÉK
the well boundary condition at the upper nodes.

cbcilt=S=ö=RV
VK=m~ê~ãÉíÉê=^ëëáÖåãÉåí

_çìåÇ~êó=`çåëíê~áåíë
In FEFLOW, all boundary conditions can be physi-
cally constrained. For example, a fixed hydraulic-head
condition at a certain node can be limited by a maxi-
mum or minimum flow. Technically, these constraints
are realized by temporarily changing the respective
boundary condition. If the flow at a fixed head bound-
ary condition would exceed the maximum flow set as a
constraint condition, the corresponding boundary con-
dition is internally transformed into a well boundary
condition with the value of the maximum flow, and the
time step is repeated. Because this test is performed for
Figure 9.4 Algebraic signs for boundary constraints and
all affected nodes at every time step, considerable com-
budget.
putational effort can be associated with the use of
boundary constraints.
Constraints are typically complimentary to the VKOKP j~íÉêá~ä=mêçéÉêíáÉë
respective boundary condition, i.e., head-type bound-
ary conditions are constrained by minimum/maximum The material properties describe the relevant char-
flow, while flux-type conditions are constrained by acteristics of the porous medium for the considered
minimum/maximum head. Exceptions from this rule flow and transport processes to be simulated. They are
include additional constraints for transfer boundary defined on an elemental basis.
conditions (to limit the infiltration at disconnected riv- For the flow simulation, material properties encom-
ers) and for all transport boundary conditions (to limit pass quantities such as hydraulic conductivity in differ-
their application to a certain range of hydraulic head). ent directions according to the selected anisotropy
Boundary constraints are not shown in the Data model, drain-/fillable porosity (specific yield) and spe-
panel by default. They can be added to the tree by using cific storage (compressibility), and transfer rates (e.g.,
the context menu of the corresponding boundary condi- to represent river-bed conductance). Parameters such
tion. as source/sink or in/outflow on top/bottom (often used
for groundwater recharge) are mathematically close to
boundary conditions; however, their typically distrib-
uted spatial reference justifies their placement in mate-
rial properties.

SM=ö=rëÉê=j~åì~ä
VKP=^ëëáÖåãÉåí=çÑ=`çåëí~åí=s~äìÉë

VKOKQ oÉÑÉêÉåÅÉ=a~í~ VKQ ^ëëáÖåãÉåí= çÑ= qáãÉ


pÉêáÉë=a~í~
Arbitrary nodal or elemental reference distributions
can be created via the Data-panel context menu. They VKQKN qáãÉ=pÉêáÉë
can be assigned and visualized like the ’regular’
FEFLOW parameters. The input of time-varying boundary-condition data
Reference distributions can provide input for the is based on time series. Once defined, a time series can
FEFLOW equation editors (e.g., for defining kinetic be used for multiple boundary conditions.
reactions in multispecies transport), they can be used Time series can be imported from files or directly
for storing the data needed by FEFLOW plug-ins (see defined in the Time-Series dialog that is opened via the
chapter 13), or for comparing the model results to cer- Edit menu. A time series consists of an arbitrary num-
tain reference conditions. ber of (time, value) data pairs. The time intervals do
not have to be equal. When defining time series, it
VKP ^ëëáÖåãÉåí= çÑ= `çåëí~åí should be considered that automatic time-stepping pro-
s~äìÉë cedures make sure to meet each time value with a time
step, so that short-interval time series may lead to
The most basic approach for data assignment is the higher numbers of calculation time steps. Interpolation
input of time-constant parameter values at the currently between the data pairs can be defined as linear, con-
selected nodes or elements (see chapter 7). Precondi- stant (step function) or Akima/Akima2.
tion for the assignment is that a single target parameter
has been activated in the Data panel by a double click
or via the context menu. An active parameter is indi-
cated by bold letters.
The assignment of a constant value for the parame-
ter to the target node or element selection is executed
by typing the value into the input box in the Editor
toolbar and clicking the green checkmark button imme-
diately to the right of the input box (or hitting <Enter>
on the keyboard). If the units of the current input value
differ from the current parameter units, the unit can be
typed in with the parameter. Units recognized by
FEFLOW are accepted and automatically converted.
Figure 9.5 Time-series dialog.

Time series can be applied to the model cyclically,


i.e., a time series defined for part of the simulation time

cbcilt=S=ö=SN
VK=m~ê~ãÉíÉê=^ëëáÖåãÉåí

is applied repeatedly until the end of the simulation, or regionalization based on map-attribute data. The input
they can be used in linear mode. If the time series only
covers part of the simulation time in linear mode, the
first value is used from the simulation start to the
beginning of the time-series definition, and the last
value in the series is applied until the end of the simula-
tion.

VKQKO ^ëëáÖåãÉåí

Time-series data are assigned similarly to time-con-


stant values. Time-series assignment is currently only
possible for boundary conditions and constraints; input
of time-varying material data still requires the classic Figure 9.6 Map data input for nodal properties.
FEFLOW user interface. Elevation in 3D models can-
not be varied in time (except by using the programming options for attribute data depend on the map and target
interface). Precondition for the time-series assignment (node/element) geometries as shown in Figure 9.6 and
is that the corresponding boundary condition has been Figure 9.7.
activated in the Data panel, and that a selection of tar-
get nodes has been made. The input box in the Editor
toolbar has to be switched to time-series mode. The
assignment is executed by typing the number of the
time series to be applied to the selected nodes into the
input box in the Editor toolbar and clicking the green
checkmark button besides the input box (or hitting the
<Enter> key on the keyboard).

VKR ^ëëáÖåãÉåí=çÑ=j~é=a~í~
Map information can be used in different ways for
Figure 9.7 Map data input for elemental properties.
parameter assignment, ranging from using the map
geometry to define targets for interactive data input to

SO=ö=rëÉê=j~åì~ä
VKR=^ëëáÖåãÉåí=çÑ=j~é=a~í~

VKRKN fåíÉê~ÅíáîÉ=a~í~=fåéìí tion dialog. Here, it is defined whether the attribute


data are interpreted as distribution of time-constant
Interactive data input is chosen in cases where the parameter values or as the ID of a time series for
map geometry (points, lines, polygons) serves as target boundary conditions and constraints. The source data
geometry for data input, but the actual values to be unit can be specified, and, for point data sources, the
assigned are unrelated to the map. regionalization method and its properties are set. Fur-
This mode can be used in conjunction with the input thermore, it is possible to relate data to a certain slice or
modes for constant data, time series, or lookup tables in layer if the slice or layer number is contained in the
the Editor toolbar. After hitting the button for point, attribute data of the map. If another map is defined as
line, or polygon input the target geometry in the model the selection map, that map defines the target geometry.
is chosen by clicking the corresponding geometry. All Thus for example an interpolation from point geome-
elements/nodes within the distance defined in the Snap tries can be limited to the nodes within a polygon or
Distance toolbar are assigned the value. Existing selec- along a line obtained from another map. Either a selec-
tions are hereby ignored. tion map or a selection can be stored to easily repeat
the data import.
VKRKO ^ìíçã~íáÅ=a~í~=fåéìí
oÉÖáçå~äáò~íáçå
Many of the map formats compatible with The regionalization settings are edited in the
FEFLOW can contain attribute values, e.g., simple Parameter Association dialog as part of the link prop-
triplet-text or ESRI-Shape files. These attributes can be erties for point maps. For classic two-dimensional data
used as the data source for parameter assignment. interpolation, FEFLOW contains three interpolation
Depending on the type of map data (point, line, methods with their respective property settings:
polygon), the properties may be applied to the target • Inverse Distance
geometries either directly, or via a regionalization algo- • Kriging
rithm. • Akima
The Neighborhood Relationship regionalization
m~ê~ãÉíÉê=^ëëçÅá~íáçå assigns a property to the nearest node, or to a number
For all automatic data input, it is necessary to link of nodes close to a map point. One typical example is
the desired map attribute to a target FEFLOW parame- the import of pumping wells in cases where the well
ter. As this link is stored permanently with the model, locations have not been considered in the design of the
the import can be quickly repeated when the map data superelement mesh. The wells are then applied at the
have changed. The link is defined in the Parameter node closest to the original well location (Single Tar-
Association dialog that can be accessed via the context get), and if more than one well is mapped to the same
menu of the respective map in the Maps panel. node, the pumping rates will be summed up (Aggrega-
Detailed settings for the data transfer can be defined tion: Sum).
in the properties of the link in the Parameter Associa- Corresponding to the Neighborhood Relationship,

cbcilt=S=ö=SP
VK=m~ê~ãÉíÉê=^ëëáÖåãÉåí

the Point in Polygon regionalization method for ele- VKS ^ëëáÖåãÉåí= çÑ= iççâìé
mental properties assigns a value to those elements that q~ÄäÉ=s~äìÉë
contain a source data point. If more than one point is
located within the same element, the point attribute val-
VKSKN iççâìé=q~ÄäÉë
ues can be either summed or averaged.
A 1-dimensional linear interpolation method along
Parameter lookup tables allow the definition of
lines is available if a line map has been chosen as the
named properties, e.g., material types, each represent-
link selection. Intended mainly for river water levels,
ing a set of parameters, such as conductivity, drain-/fill-
this regionalization provides the means for interpola-
able porosity, etc. When assigning a parameter, the
tion between time-constant or time-varying water lev-
property name can then be used instead of assigning a
els, e.g., for considering the translation of a flood wave
value. The definition of the lookup table is located in
along the river.
iççâìé=í~ÄäÉ=î~äìÉë Global Settings, accessed via the Tools menu.
~êÉ=ìëÉÇ=~ë=~åçíÜÉê The lookup table is independent of the current
^ëëáÖåãÉåí
~ëëáÖåãÉåí= çéíáçåK model, so that the properties can be used in different
tÜÉåÉîÉê= äççâìé= í~ÄäÉ= î~äJ After defining the parameter association link, the projects.
ìÉë=~êÉ=ÅÜ~åÖÉÇI=íÜÉ=ÅçêêÉJ actual data assignment is invoked by clicking the green
ëéçåÇáåÖ= é~ê~ãÉíÉêë= Ü~îÉ checkmark in the Editor toolbar presuming the follow- VKSKO ^ëëáÖåãÉåí
íç=ÄÉ=êÉJ~ëëáÖåÉÇK ing conditions are met: The input field in the toolbar is
in map input mode, the correct map has been selected,
The assignment of parameters from a lookup table
the corresponding parameter is active, and if no selec-
is similar to the input of constant or time-series data.
tion map has been chosen as a link property, the target
The input box in the Editor toolbar, however, has to be
nodes or elements are selected. All requirements except
in lookup-table mode. The properties in the lookup
the selection can be fulfilled at once by double-clicking
table that contain a value for the current input parame-
on the entry for the link in the Maps panel, or, includ-
ter can be selected from a drop-down list.
ing the selection, by double-clicking on a previously
stored node/element selection or selection map entry
for the link in the Maps panel. VKT `çéóáåÖ=çÑ=a~í~=s~äìÉë
Parameter values in the current selection can be
copied to the clipboard and pasted either to the same
nodes/elements of another parameter of the same type
(e.g., Conductivity [Kxx] to Conductivity [Kyy]), or to
another slice or layer. The Copy and Paste functions are
available in the context menus of the parameters, in the
Edit menu, and in the Standard toolbar.

SQ=ö=rëÉê=j~åì~ä
VKU=råáíë

VKU råáíë VKVKN qççäë qÜÉ= ÅççêÇáå~íÉ= ëóëJ


íÉã=ìåáí=áå=cbcilt
FEFLOW uses a standard unit for each parameter áë= ~äï~óë= ãÉíÉêëK
that is listed in the parameter description in the help qÜìë= ã~éë= ëÜçìäÇ= ÄÉ= ÖÉçJ
Figure 9.8 Selection toolbar. êÉÑÉêÉåÅÉÇ=áå=ãÉíêáÅ=ëóëíÉãë
system. For parameter input and display, other units
can be applied in one of the following ways: çåäóK
• The standard unit for a physical unit (such as
velocity, time, etc.) can be changed globally for
Figure 9.9 Editor toolbar.
the user interface via Units in the Tools menu.
One of three predefined systems or a user-defined
unit set can be applied.
• For each parameter, the unit for the active model
Figure 9.10 Snap-distance toolbar.
can be chosen via the context menu of the parame-
ter in the Data panel. This unit is then the output
and default input unit. VKVKO= ^ëëáÖåãÉåí=çÑ=`çåëí~åí=s~äìÉë
• The unit of the input values can be defined at the
time of input: For manual input, the unit of the In the first exercise we assign constant values man-
input value can be typed in with the value. When ually. We start with the assignment of boundary condi-
assigning the value, the unit is automatically con- tions for flow and mass transport.
verted. For map-based data input, a unit conver- Go to the Data panel and activate Flow >
sion can be specified as part of the Parameter Hydraulic-head BC with a double-click. Next, select
Association link. the nodes to which the boundary condition is to be
assigned. We use the node selections displayed in the
VKV qìíçêá~ä Spatial Units panel to set a selection. Right-click
on Southern Border and choose Set as Current
In the following exercises we use different methods Selection from the context menu. The selected nodes of
to assign process variables, boundary conditions and the southern border now appear as yellow disks.
material properties. Now, enter a value of 32.1 m in the input box of
Click Open and load the file parameters.fem. the Editor toolbar and click Put Value. The
This model is a 3D transient flow and transient mass selected nodes are now surrounded with blue circles,
transport model. the symbol for a 1st kind boundary condition (see figure
9.11). Clear the selection with a click on and pro-

cbcilt=S=ö=SR
VK=m~ê~ãÉíÉê=^ëëáÖåãÉåí

ceed with the northern border. (here treated as positive). At BC nodes with outgoing
(here negative) flow, the fixed-concentration BC will
be replaced by the constraint. The minimum constraints
are displayed as white bars below the boundary-condi-
tion symbols in the model. Make sure to clear any
selection before proceeding to the next assignment.

Figure 9.11 Boundary conditions at southern border.

Open the context menu of Northern Border in the


Spatial Units panel and choose Set as Current
Selection. Enter 46 m in the Editor toolbar
and click the green checkmark to assign the value.
We proceed with the assignment of mass-transport
boundary conditions for the two borders. Go to the
Figure 9.12 Adding boundary constraints.
Data panel and activate the parameter Mass >
Mass-Concentration BC. In the Spatial Units
panel open the context menu of Southern Border. This VKVKP= ^ëëáÖåãÉåí=çÑ=qáãÉ=pÉêáÉë=a~í~
time, select the option Add to Current Selection to
select both the southern and the northern border. Type a
For the wells, we assume that the pumping rates
value of 0 mg/l in the Editor input field and click
change with time. We therefore use time series to
Put Value.
assign time-varying boundary conditions.
To ensure a free outflow of mass at these borders we
Open the Time series editor via Edit > Time
add a constraint. In the Data panel, open the context
Series. The ID list on the top left of the dialog is still
menu of Mass-Concentration BC and select Add
empty and shows that the model does not contain any
Constraint > Min. mass-flow constraint. Double-click
time series yet. To load the time series click on
on Min. mass-flow constraint and enter 0 g/d in
Import and choose the file well_rates.pow.
the input box of the Editor toolbar and assign the
This file contains two times series with IDs 1 and 4
value with a click on the green checkmark. The con-
that are now added to the time series list. No changes
straint will limit the applicability of the 0 mg/l fixed-
are necessary and we simply click on OK to con-
concentration BC to flow entering the model domain
firm the import and to leave the dialog.

SS=ö=rëÉê=j~åì~ä
VKV=qìíçêá~ä

After switching to the FE-Slice view activate Flow symbol in the Editor input field to switch to the
> Well BC in the Data panel. Then, scroll to slice 4 Assign Values mode. Enter 0 m³/d in the Edi-
in the Spatial Units panel and set Well West as cur- tor input field and assign the value with the Put
rent selection. Value button. Make sure to clear the selection with
The currently active assignment mode is Assign .
Values which is shown by the Assign Values sym-
bol in the input field of the Editor toolbar. Click
on this symbol to switch to the Time Series mode.
In the input field, select Well_West and click the green
checkmark to assign the time series. Besides the red
symbol for a well boundary condition also the time
series ID 1 is now displayed at the well.
Proceed with the remaining well. In the Spatial
Units panel, open the context menu of the node selec-
tion Well East and choose Set as Current Selec-
tion.
Select Well_East from the dropdown list in the
input field of the Editor toolbar and assign the
time-varying boundary condition with a click on the
green checkmark. The well symbol and the time series Figure 9.13 Time-varying well boundary conditions.
ID 4 are now displayed at the well node.
The wells are currently only set on the bottom slice.
and pump water from the bottom layer only. To model VKVKQ= ^ëëáÖåãÉåí=çÑ=j~é=a~í~
wells that are screened over the entire vertical extent,
we complete the well setup with additional 4th-kind
boundary conditions at the same horizontal locations VKVKQKN =fåíÉê~ÅíáîÉ=a~í~=fåéìí
on slices 1 through 3. The pumping rates at these nodes
are set to 0 m³/d. To complete the boundary conditions we assign a
Clear the selection and browse to slice 3 in the fixed concentration (1st kind Mass BC) to the nodes of
Spatial Units panel. In the Maps panel, activate the two contamination sites.
the map demo_wells with a double-click. Enter 1 Instead of creating a selection prior to the parameter
m in the Snap distance toolbar and click the assignment, we perform the assignment using the map
Select by All Map Geometries button in the geometry as target geometry.
Selection toolbar. Click Copy Selection to
Slices/Layers and select slices 1 and 2. Confirm the tar-
get slices with OK. Click the Time Series

cbcilt=S=ö=ST
VK=m~ê~ãÉíÉê=^ëëáÖåãÉåí

Start with the recharge which in FEFLOW is treated


as a material property. Go to the Maps panel and
open the context menu of the map year_rec with a
right-click. Select the entry Link to Parameter to
open the Parameter Association dialog.
The list on the left hand side contains the attribute
data which are stored in the map. Click on
MEAN_YEAR. To link these data to the FEFLOW
parameter double-click on Material Properties > Flow
> In/outflow on top/bottom in the list on the right hand
Figure 9.14 Highlighted contamination site (left) and
assigned boundary conditions (right).
side. A black line shows the created link. The link
properties are edited in the table below.
First, browse to slice 1 in the Spatial Units panel For material properties, currently only constant val-
when the FE-Slice view is the active view. Activate the ues can be assigned. The Link Type therefore remains
parameter Mass-concentration BC in the Data Time constant data. As source data unit for the
panel. Double-click Supermesh > Polygons in the recharge values select [10 -4 m/d].
Maps panel. Enter a concentration of 500 mg/l The link now turns red to indicate that the data unit
and switch to the now active tool Assign Data by has been changed. Do not modify the fields Element/
Map Polygon next to the input field of the Editor Layer Selection and Default Link Selection. As this
toolbar. Move the mouse cursor over the contamination map is a polygon shape file no regionalization is neces-
sites until they are highlighted. Assign the concentra- sary to import the data. Click on OK to confirm
tion with a single click in these areas. The boundary the settings and to leave the dialog.
conditions now appear as blue circles around the nodes.

VKVKQKO ===^ìíçã~íáÅ=a~í~=fåéìí

m~ê~ãÉíÉê=^ëëçÅá~íáçåI=oÉÖáçå~äáò~íáçå=~åÇ=
^ëëáÖåãÉåí
Having the boundary-condition assignment com-
pleted we proceed with the assignment of material
properties. To assign values for hydraulic conductivity
and recharge we use some of the maps that are included
with the model. These contain attribute values which
have to be linked to the respective FEFLOW parame-
Figure 9.15 Parameter Association dialog.
ter.

SU=ö=rëÉê=j~åì~ä
VKV=qìíçêá~ä

The link between the map data and the FEFLOW VKVKR= ^ëëáÖåãÉåí=îá~=`çéó=~åÇ=m~ëíÉ
parameter is now shown in the Maps panel in the
tree year_rec > Linked attributes. For the conductivity in y- and z-direction the same
To assign the linked recharge data double-click on values as for the x-direction shall be applied. To assign
the entry for the link in the Maps panel: In/outflow the values we copy the [Kxx] values to the parameters
on top/bottom now becomes the active parameter in the [Kyy] and [Kzz].
Data panel, the assignment mode is changed to First, we have to create a selection from which we
Maps and the correct map for assignment is set in want to copy. Again, select all elements of the top layer
the input field automatically. with Select All. In the Data panel, open the
Make sure that the FE-Slice view is the active view context menu of Conductivity [Kxx] and click on
and browse to slice 1 in the Spatial Units panel. Copy. Then, right-click on the parameter Conduc-
Now, select all elements of the top layer with a click on tivity [Kyy] and select Paste.
the= Select All button. To assign the data click the In the same way, copy the [Kxx] values to Conduc-
green checkmark. tivity [Kzz].
In the same way create the link to the parameter
Conductivity [Kxx]. Open the Parameter Association
dialog with a click on Link to Parameter in the
context menu of the map conduc2d.
Click on CONDUC2D_I in the list on the left hand
side and link these data to the FEFLOW parameter
Conductivity [Kxx].
Leave the Link Type as Time constant data and set
[10-4 m/s] as source data unit for the conductivity val-
ues. Do not do any changes to the fields Element/Layer
Selection and Default Link Selection.
In contrast to the polygon shape file for the recharge
values this map contains point data and we therefore
need to define a data regionalization method.
From the list of available methods select the Akima
method. Set a Linear Interpolation Type and choose 3
Figure 9.16 Parameter assignment using Copy/Paste.
Neighbors and 0 Over-/Under Shooting. Confirm the
link settings and leave the dialog with OK.
Now double-click on the link CONDUC2D_I-> Values can not only be copied to other parameters
Conductivity in the Maps panel and click Put but also to the same parameter on a different slice or
Value to assign the conductivity values to the top layer. layer. Make sure to click Clear Selection before
proceeding. Browse to layer 3 in the Spatial Units

cbcilt=S=ö=SV
VK=m~ê~ãÉíÉê=^ëëáÖåãÉåí

panel and select all elements of this layer with a click


on Select All.
Now double-click on Drain-/fillable porosity in the
Data panel and select the option Copy from
the context menu of the parameter.
Then, browse to layer 1 in the Spatial Units
panel and open the context menu of Drain-/fillable
porosity again. Select Paste to Slice/Layer to
assign the porosity values of layer 3 to layer 1.

TM=ö=rëÉê=j~åì~ä
NMKN=fåíêçÇìÅíáçå

páãìä~íáçå

Running a FEFLOW model


NM
erty in the Data panel indicates whether the respective
NM páãìä~íáçå

NMKN=fåíêçÇìÅíáçå parameter is homogeneous or heterogeneous (see chap-


^ÑíÉê= íÜÉ= ëáãìä~J
ter 10.6.2).
íáçå= íÜÉ= éêçÅÉëë
The FEFLOW user interface keeps all visualization î~êá~ÄäÉë= Åçåí~áå
options available during the simulation. The simulation NMKP oÉëìäíë=lìíéìí íÜÉ= Ñáå~ä= êÉëìäíëK= qç= êÉëí~êí
progress can thus be conveniently monitored and prob- íÜÉ= ëáãìä~íáçå= ìëáåÖ= íÜÉ
lems can be detected early. Simulation results can be stored in two different for- çêáÖáå~ä=áåáíá~ä=ÅçåÇáíáçåë=Ñçê
FEFLOW does not separately store initial condi- mats: a reduced results file (*.dar) and a full simulation ÜÉ~ÇI= ÅçåÅÉåíê~íáçå= ~åÇ
record (*.dac). íÉãéÉê~íìêÉI=íÜÉ=ãçÇÉä=Ü~ë
tions of hydraulic head or concentration/temperature
The reduced format contains text output for the íç=ÄÉ=äç~ÇÉÇ=~Ö~áå=Ñêçã=íÜÉ
during the simulation. So the hydraulic-head process
observation points and well locations only. It is espe- çêáÖáå~ä=ÑáäÉK=
variable contains the initial head values before the sim-
ulation, the current hydraulic head results at each time cially useful for automatic output processing with user-
step of a transient simulation, and the final hydraulic programmed scripts or optimization software such as
head after the simulation. These final results are also PEST. Reduced results files always contain values for
retained when leaving the simulation mode by clicking all the time steps.
Stop in the Simulator toolbar. In contrast, the full simulation record contains all
nodal values of the primary variables (hydraulic head, fÑ= ~= ÖáîÉå= ëáãìä~J
concentration, temperature) and of the flow velocities. íáçå=êÉÅçêÇ=ÇçÉë=åçí
NMKO jçÇÉä=`ÜÉÅâ= Åçåí~áå=~ää=íÜÉ=íáãÉ
By default, results at all time steps are stored. It is pos-
ëíÉéëI= éçëíéêçÅÉëëáåÖ= ãÉíÜJ
Before running the model, all input parameters and sible, however, to skip a number of time steps between
çÇë=íÜ~í=ÅçîÉê=ãìäíáéäÉ=íáãÉ
other model properties should be thoroughly checked. each output, or to specify the simulation moments for
ëíÉéëI= ëìÅÜ= ~ë= íê~åëáÉåí
A basic overview of the model characteristics is pro- which output is desired. In the latter case, the automatic é~íÜäáåÉ= ~å~äóëáëI= Å~å= çåäó
vided in the Problem Summary page in the Problem time stepping scheme ensures that results are calcu- ÖáîÉ=~ééêçñáã~íÉ=~åëïÉêK
Settings dialog. The icon preceding each material prop- lated exactly at the prescribed output moments.

cbcilt=S=ö=TN
NMK=páãìä~íáçå

NMKQ oìååáåÖ=íÜÉ=páãìä~íáçå In transient simulations with an automatic time-


stepping procedure, the time step is shortened if neces-
The handling of the interface is as easy as starting a sary to achieve convergence. Only if repeated time-step
tape or video recorder: The Play button in the Simula- reductions do not improve the situation, a log message
tor toolbar starts the simulation, the Pause button is shown indicating that time-step reduction failed. The
pauses it, the Stop button exits the simulation mode, simulation is continued with the results of the last cal-
and when the record button is pressed before starting culation for the time step. In general, models that show
the simulation, the results are recorded in a file while convergence problems even after greatly reducing the
the simulation runs. time-step length should be checked for errors in the
All visualization and also some results-evaluation input data or for insufficient mesh resolution.
features (Budget panel, Content panel) can be used
during the simulation. It should be considered, how- NMKS qìíçêá~ä
ever, that some of these features might slow down the
simulation. Especially more elaborate visualization NMKSKN qççäë
options such as isosurfaces or budgeting may require
significant calculation effort.
After the simulation finishes, FEFLOW remains in
paused simulator mode. Thus simulation results such as Figure 10.1 Simulator toolbar.
flow velocities and the solution of the last time step
remain available for postprocessing. Only when exiting
the simulation mode via Stop are these data removed
NMKSKO jçÇÉä=`ÜÉÅâ
from memory, and pathline calculation or budget anal-
ysis are no longer possible. Any postprocessing then Load the file simulation.fem via Open. Before
requires loading of the simulation-record file. we start the simulation we want to make sure that all
necessary parameters have been properly assigned and
that the problem settings have been set correctly.
NMKR `çåîÉêÖÉåÅÉ Start with the problem settings. Go to Edit >
Problem Settings and open the Problem Summary
When solving non-linear problems for steady state,
page in the dialog. Here, an overview of key simulation
or for transient conditions with constant or varying
control and model parameters is presented.
time steps, an Error Norm diagram is shown. Once the
To check values at specific nodes or elements we
change in results between two subsequent iterations is
can use the Inspection tool. Double-click on
below a certain error criterion (see chapter 6.1.4), the
Boundary Conditions > Flow in the Data panel.
simulation is terminated. FEFLOW brings up an alert
These parameters are now displayed in the Inspection
box and shows a message in the Log panel if no con-
panel. After clicking on Inspection move the
vergence was achieved within the defined maximum
mouse cursor over the nodes where boundary condi-
number of iterations.

TO=ö=rëÉê=j~åì~ä
NMKS=qìíçêá~ä

tions are set to check the values that have been


assigned there. The value for the respective boundary
condition, the node and the slice number are shown in
the Inspection panel.
Both constant values and time series can be checked
with the Inspection tool. Set the FE-Slice view as
active view and select slice 6 in the Spatial Units
panel. Move the mouse cursor over the nodes where a
well boundary condition is set. The assigned time
series is then shown in a diagram in the Inspection
panel. If the time-series diagram is hidden click on the
blue bar Show Time Series Diagram in the Inspection
panel to make the diagram visible.
The distribution type of a material property can be
quickly checked in the Data panel. Homogeneous
parameters are indicated by a symbol, heteroge-
neous parameters by a symbol in front of the Figure 10.2 Checking boundary conditions with the
Inspection tool.
parameter.

NMKSKP oÉëìäíë=lìíéìí NMKSKQ oìååáåÖ=íÜÉ=páãìä~íáçå


Before we start the simulation we define how and After checking the model properties and defining
where the results should be recorded. Click on the record location we start the simulation by clicking
Record in the Simulator toolbar to open the Play in the Simulator toolbar.
Record Properties dialog. Check the checkbox for Five different diagrams appear: Hydraulic Head,
Save complete results (DAC file) to create an out- Pressure, and since we are simulating transient flow
put file. Click on Browse to choose the location for and transport, also the Time Steps and Local and Aver-
the simulation record. To reduce the size of the output age Concentration diagrams. Graphs for the well loca-
file set the Number of skipped output steps to 4. tions and also for the observation points are displayed.
Leave the dialog with OK. The elapsed simulation time is shown at the bottom
of every view window.
During the simulation we can display different
parameters in the active view. Go to the Data panel
and click on Process Variables > Mass transport >
Mass concentration to see how the mass distribution
changes with time.
cbcilt=S=ö=TP
NMK=páãìä~íáçå

Open the Budget panel via View > Panels


and set the checkmark in front of Active to show the
budget analysis while the simulation is running. After a
short computation time the fluxes for each boundary
condition type, sources/sinks and the total balance are
displayed.
Now click Stop to terminate the simulation.
Notice that the in- and outgoing fluxes are no longer
displayed in the Budget panel due to the now lack-
ing flux field. Evaluation of flux-based results is still
possible by loading the simulation record.

TQ=ö=rëÉê=j~åì~ä
NNKN=fåíêçÇìÅíáçå

oÉëìäíë=bî~äì~íáçå

Analyzing the simulation results


NN
and slice or node number for the point from the
NN oÉëìäíë=bî~äì~íáçå

NNKNfåíêçÇìÅíáçå attribute data of the map. Observation points are


always bound to a certain slice.
As the evaluation of modeling results takes place During the simulation, diagrams are automatically
both during and after the simulation, the content of this shown for the results of the primary variables (hydrau-
chapter applies to monitoring the simulation results at lic head, concentration, and temperature) at the obser-
runtime, after finishing the simulation, and after load- vation points. Additional diagrams, e.g., for pressure,
ing a simulation record (postprocessing). can be added via the View menu.
Results evaluation also involves all visualization
and animation options described in chapter 8 and chap- NNKP _ìÇÖÉí=^å~äóëáë
ter 12. This section focuses on the tools specifically
designed for output interpretation. Whenever FEFLOW is in the simulator mode, i.e.,
when the simulation is running, is paused, or has come
NNKO lÄëÉêî~íáçå=mçáåíë to an end, the Budget panel can show the current water,
heat, or mass balance. For this, it has to be set to active.
Observation points are used to monitor simulation The water balance is subdivided into flows related
results at specific locations in the model domain via to the four boundary condition types, flows through
diagram windows. Using the tools in the Observation distributed sources/sinks (e.g., groundwater recharge),
Point toolbar, observation points can be defined either and a balance term representing the rate of storage
manually in an FE-Slice view, or by converting the change and any numerical errors. In a converged
current node selection into observation points. Features steady-state model, this balance term is expected to be
of point maps can be directly converted into observa- close to zero when computed for the entire model,
tion points using the context menu of the map in the reflecting the fact that the inflows into the model equal
Maps panel. The import also allows to obtain a label the outflows.

cbcilt=S=ö=TR
NNK=oÉëìäíë=bî~äì~íáçå

NNKR píêÉ~ãäáåÉë=~åÇ=m~íÜäáåÉë
Streamlines and pathlines can be very helpful in
visualizing steady-state and transient flow fields. While
a streamline represents the trajectory of a particle in a
steady flow field, a pathline follows a particle in a tran-
sient flow field. Pathline computation therefore
requires loading a simulation record of a transient
model.
Streamlines and pathlines can be calculated for-
wards or backwards from the starting point. The start-
ing points (seeds) can be set at points, circles around
points, or distributed along lines. Distributed seeds can
either be equally spaced along the starting line, or
Figure 11.1 Budget panel.
spaced such that the distance between adjacent seeds is
inversely proportional to the local flux magnitude.
Streamlines can be also shown during the simula-
NNKQ `çåíÉåí=^å~äóëáë tion. In this case, their location changes with the flow
field after each time step.
In the Content panel, total contents of the model at To visualize travel times of the particles along
the current time step can be calculated: streamlines and pathlines, isochrone markers can be set
• Total volume at specific time stages. The calculation of flow times as
• Void volume a basis for isochrone markers requires the definition of
• Fluid content an effective porosity. For this, one of the available
• Diluted mass (fluid phase) porosities for the given model type (specific yield,
• Diluted mass (squared) porosity for unsaturated flow, mass or heat transport
• Sorbed mass (solid phase) porosity) or an arbitrary reference distribution can be
• Energy of fluid phase applied.
• Energy of solid phase To display streamlines or pathlines, selection of an
• Total energy content appropriate source geometry in the Spatial Units panel
Depending on the model type, not all options may (node selection, 3D point set, 3D polyline, or 3D loop)
be available. is required. Node selections can be created by storing
the current selection, tools for generating the other 3D
geometries are available in the Drawing toolbar.
The second important component for streamline/
pathline generation is the Pathlines entry in the Pro-

TS=ö=rëÉê=j~åì~ä
NNKS=bñéçêí

cess variables section of the Data panel. Following a the camera button in the View toolbar. A resolution
double click on either Forward or Backward the path- enhancement can be applied to the image and texts
lines are calculated and added to the active view. Path- (e.g., legend text) to obtain high-resolution output suit-
line properties are found in two different locations: able for poster printing. Chapter 12 describes how
While the basic calculation settings, such as steady movies are created from a view animation.
(streamlines) or transient (pathlines) and the choice for Data and plot export encompasses a variety of dif-
effective porosity for isochrone calculation are found in ferent file formats, ranging from simple column-based
the Problem Settings dialog, view-specific visualiza- text files to GIS and CAD files. Data of process vari-
tion options such as number of seeds along a line or ables, boundary conditions, material properties and ref-
line width are controlled via the Properties of the path- erence distributions are exported via the context menus
lines entry in the View Components panel. of the parameter in the Data or View Components
panel. Visualization features such as isolines or fringes
are exported by using their context menu in the View
Components panel. If supported by the output format
(e.g., ESRI Shape file, AutoCAD Exchange file), plot
files are exported in 3D from 3D models.

NNKT qìíçêá~ä
In the following exercises we use a simulation
record to evaluate the modeling results after the simu-
lation. Start FEFLOW and click Open to load the
file results.dac. The file contains the complete results
for every calculated time step of a transient flow and
mass transport simulation.

Figure 11.2 Pathline analysis. NNKTKN qççäë

NNKS bñéçêí Figure 11.3 Simulator toolbar.

The FEFLOW export options can be broadly


grouped into export of movies and images (snapshots
of a view), and export of data and plots.
Snapshots of the active view are exported by using

cbcilt=S=ö=TT
NNK=oÉëìäíë=bî~äì~íáçå

NNKTKO lÄëÉêî~íáçå=mçáåíë NNKTKP _ìÇÖÉí=^å~äóëáë

For the loaded simulation record, five different dia- We can use the Budget panel to monitor the
grams can be displayed: Hydraulic Head, Pressure, fluid and mass fluxes that enter and leave the model
Local and Average Concentration, and Time Steps. domain, or only specific areas.
To open a diagram, right-click in an empty part of For mass-transport simulations, the Budget
the FEFLOW workspace, select Diagrams and then panel contains two tabs, one for fluid and one for mass
the diagram that is to be displayed. For each observa- fluxes (see Figure 11.1). To start the budget analysis
tion point a curve is plotted so that the hydraulic head, set the checkmark for Active in the respective tab
concentration and pressure changes at these locations for fluid and mass. After a brief computation the flow
can be monitored during and after the simulation. rate for each boundary condition type and for sources
and sinks are displayed together with the balance term
representing the rate of storage change. Flows that
leave the model have a negative algebraic sign while
flows that enter the model have a positive algebraic
sign.
We now calculate the fluid budget for the border in
the south instead of taking the entire model as budget
domain. Go to the Spatial Units panel, open the
context menu of Southern Border and select Apply
Selection as Budget Domain. The budget domain is
automatically switched from Model Domain to
Node Selection in the Budget panel. The budget is
now calculated for the selected nodes only. The balance
shows that water is leaving the model domain through
the border in the south.

Figure 11.4 Observation points and local concentration


diagram.

TU=ö=rëÉê=j~åì~ä
NNKT=qìíçêá~ä

NNKTKQ `çåíÉåí=^å~äóëáë

To check how much mass the model domain con-


tains at different time steps we use the Content
panel. Set the checkmark in front of Active and
select Diluted mass (fluid phase) from the content list.
The currently present amount of mass is now displayed
in milligrams. Browse the time step list in the
Simulator toolbar to check how the mass content
changes with time.

NNKTKR píêÉ~ãäáåÉëI=m~íÜäáåÉë

To visualize the steady-state and transient flow field


we plot streamlines and pathlines. Start with a 3D plot
Figure 11.5 Scaled budget spheres along the southern
of streamlines that start at the two well locations.
border.
First, set the 3D view as active view and deactivate
Additionally, the in- and outgoing fluxes can be Geometry > Faces in the View Components panel
visualized as scaled spheres. Set the 3D view as active as otherwise the streamlines located below slice 1
view and keep the Southern Border node selection as would be concealed.
budget domain. Now, click on Node Selection > Wells in the
Now, double-click on Flow > Budget in the Spatial Units panel and double-click on Pathlines
Data panel. Blue and green spheres of different > Backward in the Data panel to start the stream-
sizes are plotted at nodes along the southern border line plot. After a brief computation the streamlines are
where water leaves the model. We now increase the rel- shown in the 3D view.
ative size of the spheres in order to make smaller To visualize the flow field in the vicinity of the
spheres visible. Open the context menu of Budget > wells we increase the radius for the streamline seeds
Scaled Spheres in the View Components panel and around the wells. To change the radius and other
select Properties. In the Size tab increase the rela- streamline properties, open the context menu of Back-
tive size to 3.0 and click Apply. Figure 11.5 ward Pathlines@Wells in the View Components
shows the resulting plot in the 3D view. panel and select Properties. In the upcoming
Properties panel type 20 m as radius, hit
<Enter> and click Apply. Several streamlines are
now plotted around the two wells. Figure 11.6 shows a
3D plot of streamlines around the wells.

cbcilt=S=ö=TV
NNK=oÉëìäíë=bî~äì~íáçå

ity and click Apply to confirm the changes. The


streamline plot and the isochrone markers automati-
cally adapt to the changes.

Figure 11.6 3D Streamlines around the wells.

We also add Isochrone Markers to visualize parti- Figure 11.7 Pathline computation settings.
cle travel times along the streamlines. In the View
Components panel activate Backward Path- To visualize the transient flow field with pathlines
lines@Wells > Isochrone Markers. To edit the isoch- switch from a Steady to a Transient velocity
rone times for marker placement open the field on the Pathline computation page. Again, click
Properties panel via the context menu of Isochrone Apply to confirm the changes.
Markers. On the Iso tab, activate the option Streamlines or pathlines can also start from
Custom and click Edit. Enter 0, 365, 1825 polylines. To draw a polyline for streamline plotting,
and 7300 days as isochrone times and delete the open the context menu of Pathlines > Forward and
remaining entries in the list with the Delete row select Draw seed line/points > Draw a 3D Line.
button. Leave the dialog with OK and confirm the Start an arbitrary line on the top slice of the model with
changes with a click on Apply. a single click. Extend the line by adding points and fin-
To plot isochrones that represent fluid particle ish with a double-click.
instead of contaminant particle travel times, a different The line is now displayed in the active view and is
effective porosity should be used for the calculation of shown as Domain Locations > 3D Polyline #1 in the
flow times. Open the Problem Settings dialog located Spatial Units panel. Before starting the plot, switch
in the Edit menu to change the settings for the flow from pathline to streamline computation. Access the
time calculation. On the Pathline computation page Pathline computation page via Edit Pathline-
select drain- or fillable porosity as effective poros- Computation Settings in the context menu of Path-

UM=ö=rëÉê=j~åì~ä
NNKT=qìíçêá~ä

lines in the Data panel and select a Steady inter- a map and assigned as initial mass distribution in sub-
pretation of the velocity field. Apply the changes and sequent simulations.
leave the dialog with OK. Plots can be exported in the same way as data. To
export the isolines plot open the context menu of Mass
concentration > Isolines in the View Components
panel and select Export Plot. Choose a file name
and format for the exported isolines and finish the
export with Save.
A further option to export simulation results is to
take snapshots of the active view window. Click
Snapshot of the Active View in the View tool-
bar and choose a resolution enhancement factor for the
exported snapshot. After clicking OK, choose a
name and file format for the snapshot.

Figure 11.8 Streamlines starting at a polyline.

Now, click on 3D Polyline #1 in the Spatial


Units panel and start the streamline plot with a double-
click on Pathlines > Forward. Figure 11.8 shows an
example for a streamline plot from a polyline.

NNKTKS bñéçêí=çÑ=oÉëìäíë

To export the mass distribution obtained at the end


of the simulation browse to the last time step in the
Simulator toolbar and double-click on Mass con-
centration in the Data panel. Open the context
menu of Mass concentration in the View Compo-
nents panel and select Export Data > All Nodes.
Select a file name and choose the ESRI Shape File 3D
format (.shp). The exported data can be loaded again as
cbcilt=S=ö=UN
NNK=oÉëìäíë=bî~äì~íáçå

UO=ö=rëÉê=j~åì~ä
NOKN=fåíêçÇìÅíáçå

^åáã~íáçå=~åÇ=sáÇÉç=bñéçêí
NO
NO ^åáã~íáçå=~åÇ=sáÇÉç=bñéçêí

NOKN fåíêçÇìÅíáçå=
Dynamic visualization is essential when presenting
model results to clients, authorities and the public, and
facilitates understanding of complex processes.

NOKO `êÉ~íáåÖ=~=mêÉëÉåí~íáçå
A dynamic presentation can be set up for each view Figure 12.1 Autopilot panel.
window using its autopilot. The autopilot of the active
view window is accessible via the Autopilot panel The total length of the presentation (in seconds) can
where up to four separate categories, Simulation Time, be entered in the Autopilot panel. The displayed per-
Position, Clipping, and Visibility can be set up along a centage value corresponds to the position of the time-
common presentation-time line. Presentation time is line slider. It can be edited to explicitly set a timeline
real time as observed on a wrist watch during presenta- position.
tion play-back. The available categories depend on the A play-back function is provided to preview the
type of the respective view window. Each category has autopilot animation sequence.
an Engage checkbox that acts similar to a clutch. When A simple movement is produced by defining two
engaged, the autopilot completely controls the respec- object-position keys, one at the beginning and one at
tive category. For example, engaging the autopilot the end of the presentation-time line. Whenever the
Position category will disable user-controlled naviga- autopilot Position category is engaged (e.g., during
tion via Navigation panel or mouse tools and all object autopilot play-back and movie export), all intermediate
positioning becomes autopilot-controlled. object positions are automatically interpolated between

cbcilt=S=ö=UP
NOK=^åáã~íáçå=~åÇ=sáÇÉç=bñéçêí

the bracketing keys, resulting in a continuous object tiple data sources in sequence or to display features
movement. To produce more complex paths, additional such as the finite-element mesh or a surface map dur-
keys can be freely placed along the presentation-time ing only a portion of the entire presentation.
line. While the autopilot Visibility category is engaged,
When visualizing FEFLOW simulation records the feature-visibility settings are obtained from the
(.dac files) for transient problems, the simulation-time user-defined visibility keys on the presentation time-
axis (often covering days, months, or years) has to be line. At a given presentation moment, the visibility sta-
mapped to the presentation-time axis (typically, sec- tus of each feature will be given by the respective
onds or minutes long). The autopilot performs this previous visibility key on the presentation timeline.
mapping simultaneously with the dynamic object posi-
tioning. NOKP jçîáÉ=bñéçêí=
While the autopilot Simulation Time category is
jçîáÉ=bñéçêí=áë=ÅìêJ engaged, the candidate time step shown in the Simula- Export of the autopilot presentation of the active
êÉåíäó= çåäó= éçëëáÄäÉ tion toolbar is obtained by interpolating the user-
view to a movie is evoked via Export AVI in the File
çå= jáÅêçëçÑí= táåJ defined simulation-time keys on the presentation time-
menu or View toolbar. Any of the video compression
Ççïë=çéÉê~íáåÖ=ëóëíÉãëK
line. By default, beginning and end of the simulation codecs available on the operating system can be chosen
period are mapped to beginning and end of the presen- for the export.
tation timeline, respectively. Thus, in the simplest case,
no additional simulation-time keys have to be specified NOKQ qìíçêá~ä
at all.
To obtain animation effects such as a gradually
NOKQKN qççäë
extending cut-out section progressively exposing inter-
nal isosurfaces, the autopilot of a 3D view window can
dynamically interpolate between predefined (key) clip
Figure 12.2 Simulator toolbar.
settings.
While the autopilot Clipping category is engaged,
the settings for clipping and cutout planes are obtained NOKQKO `êÉ~íáåÖ=~=mêÉëÉåí~íáçå
by interpreting the user-defined clipping keys on the
presentation timeline. At a given presentation moment, In this exercise we create a presentation from a
the status of each plane (‘Disabled’, ‘Clipping’, or results file of a transient free & movable simulation
‘Cutout’) will be given by the respective previous clip- and export the presentation as a movie. First, click
ping key on the presentation timeline while position Open and load the file animation.dac.
and orientation of all planes are continuously interpo- We start with a very simple presentation in the 3D
lated between the respective bracketing clipping keys. view in which we show how the mesh stratigraphy
The autopilot can dynamically apply predefined changes during the simulation. Switch to the
feature-visibility settings to control the display of mul- Autopilot panel located below the active view.

UQ=ö=rëÉê=j~åì~ä
NOKQ=qìíçêá~ä

By default, beginning and end of the simulation are right mouse button to zoom out and then, with the left
mapped to beginning and end of the presentation time- mouse button, slightly rotate the model backwards and
line, respectively. The two green bars at beginning and to the left. To set the first key at this position move the
end of the Simulation Time line show that time keys white slider to the beginning of the presentation time
are set at these positions. and click the green checkmark in the Position line.
For showing the mesh movement during the simula- For the second key, position the model in the center
tion no additional settings are necessary. Simply click of the view, zoom in and rotate the model to the right.
Preview to preview the first presentation. Move the slider to the end of the presentation and click
In the next step we extend the animation to 20 sec- the green checkmark in the Position line again. The
onds and add further time line-keys to slow down the position of the model will now dynamically change
animation at the stages where strong changes are visi- between these two prescribed positions during the pre-
ble. sentation.
First, enter 20 sec as total presentation time and We complete the presentation by removing the han-
hit <Enter>. In the upcoming Expand presentation dia- dles from the active view. Right-click in the view win-
log select the option Rescale all existing key timings dow and deselect Show > Handles. Now click
and click Rescale. Now, browse to time step 40 in Preview again to see the final presentation.
the time step list in the Simulator toolbar, type
8.0 sec in the left input field of presentation time NOKQKP jçîáÉ=bñéçêí
and hit <Enter>. Alternatively, the white slider bar can
be moved manually to 8.0 sec of presentation time. To When all presentation keys are set we proceed with
set a key at this time step click the green checkmark in the export of the presentation as a movie.
the Simulation Time line. A green bar appears indicat- In the Autopilot panel, choose a Frame Rate of
ing that a key has been set here. 20 fps and click Export AVI in the View
Repeat the same steps to set the second time key for toolbar. Choose a name for the movie and click
time step 65 at 16 seconds of presentation time. After Save. Finally, select one of the available compres-
this time key has been set, click Preview again to sion codecs and the desired quality and click OK
see the presentation. to start the movie export.
In addition to presenting the mesh movement during
the simulation we want to change the model position in NOKQKQ bñéçêí=pÉííáåÖë
the active view during the presentation.
The model is to move from the upper left corner Presentations can also be exported and reloaded
towards the center of the active view during the presen- again. The presentation settings are exported together
tation. An increasing zoom factor and some rotation are with the settings of the active view. After creating the
also desired. presentation right-click in the active view window and
First, press the middle mouse button and drag the select Export Settings to save the presentation and
model to the upper left corner of the view. Now, use the view settings as xml-file.

cbcilt=S=ö=UR
NOK=^åáã~íáçå=~åÇ=sáÇÉç=bñéçêí

Reloading the animation and view settings works in


the same way: Go to Window > New and select 3D
View. Right-click in the new 3D view to invoke the
context menu, select Import Settings and load the
file that we have just exported. The view and animation
settings are now adopted from the xml-file.

US=ö=rëÉê=j~åì~ä
NPKN=fåíêçÇìÅíáçå

mäìÖJáåë=~åÇ=fåíÉêÑ~ÅÉ=j~å~ÖÉê=fcj=====================================

Extending FEFLOW’s functionality by using and programming plug-ins


NP
NPKN fåíêçÇìÅíáçå three files:
NP mäìÖJáåë=~åÇ=fåíÉêÑ~ÅÉ=j~å~ÖÉê=fcj

• a *.dll (Windows) or *.so (Linux) file


FEFLOW covers a broad range of functionality for • a *.html file with a description
porous-media flow and transport simulation, accessible • a *.txt file with a copyright statement
via a comprehensive user interface. For the plug-in functionality, only the first file is
Nevertheless there are cases in which extended user important. Plug-ins are automatically registered to
control over the internal processes in the software is FEFLOW when they are located in the modules32 (32-
desired and useful. Typical examples include data bit version of FEFLOW) or modules64 (64-bit version)
import from user-defined sources, coupled simulations folder in the FEFLOW installation directory.
with other software, extended interdependencies The Plug-ins panel is used to manage the plug-ins.
between parameters, specific physical processes, and Additional plug-ins in other than the above described
user-specific output formats. locations can be registered, and any registered plug-in
Many of these cases can be accommodated by the can be added to the current model. There is no limita-
FEFLOW plug-in concept and its open programming tion in the number of plug-ins in a model. Their execu-
interface controlled by the FEFLOW Interface Man- tion order is based on the list order in the Plug-ins
ager (IFM). panel.
While the use of available plug-ins does not require Some of the plug-ins have functionality that is
any programming skills, the IFM also provides support invoked by clicking the Edit button in the panel or by
for coding of own plug-ins by advanced modelers with choosing Activate from the context menu of the plug-
some programming experience. in. Plug-ins with their own user interface typically
bring up the interface when hitting the Edit button.
Plug-ins also have the ability to store their own data
NPKO mäìÖJáåë=Ñçê=rëÉêë into the *.fem file. Thus data input to the plug-in can be
saved with the model file.
Plug-ins for FEFLOW typically come as a set of
When deactivating a plug-in the panel, it is no

cbcilt=S=ö=UT
NPK=mäìÖJáåë=~åÇ=fåíÉêÑ~ÅÉ=j~å~ÖÉê=fcj

longer executed, but its data are kept. In contrast, in, a separate C function stub can be automatically gen-
removing the plug-in from the current model also erated. While C and C++ are the ’native’ languages for
removes its data from the FEFLOW model. coding FEFLOW plug-ins, code in other programming
languages can also be included via mixed-language
NPKP qÉÅÜåçäçÖó programming.
On Windows systems, Microsoft Visual Studio is
Plug-ins are compiled into Dynamic Link Libraries often used for plug-in development, either as the com-
(DLL) on Windows operating systems, and into mercial or as the free Express edition. To be able to
Dynamic Shared Objects (DSO) on Linux. With these, develop plug-ins, the IFM Development Kit has to be
it is possible to extend the capabilities of FEFLOW installed as part of the FEFLOW installation. With this
without modifying its source code. The Interface Man- software development kit (SDK), a wizard for
ager (IFM) uses a technique based on jump-tables that Microsoft Visual Studio is installed. This wizard pro-
are provided in source code, which supersedes the use vides a graphically supported, efficient way to generate
of object code or libraries. The jump tables are inter- the frame code for a new FEFLOW plug-in project,
nally implemented by FEFLOW, so that plug-ins have including all required project and solution settings. The
no external references to FEFLOW’s code or data. The programmer ’only’ has to fill in the user-specific code
plug-ins are thus largely shielded from changes within and compile the plug-in. Even the registration of the
FEFLOW. In particular, they are not bound to a specific plug-in to FEFLOW is done automatically during the
version of FEFLOW, making plug-in management compilation process.
independent from FEFLOW.
The set of API functions provided by the IFM NPKR qìíçêá~ä
ensures read and write access to nearly all parameters
and settings in FEFLOW, along with functionality to NPKRKN rëáåÖ=mäìÖJáåë
influence the course of simulation runs.
To show the capabilities of plug-ins in FEFLOW,
NPKQ fcj=Ñçê=mêçÖê~ããÉêë we attach and use the Check Mesh Properties plug-in,
which is part of the FEFLOW installation. The plug-in
The backbone of the programming interface are the calculates the occurring minimum and maximum angle
above-mentioned API functions together with call- of each finite element of a 2D mesh to check the mesh
backs, the possible entry points for plug-in code. Each quality.
of the callback functions is called at a specific point of Start a new FEFLOW document and create an arbi-
FEFLOW’s internal code sequence. For example, the trary supermesh polygon using the Add Polygons
PreTimeStep callback function is called immediately tool. When the polygon is finished, click Generate
before a new time step of the simulation is started. Mesh to generate a finite-element mesh.
The frame code for a new plug-in is created as C Open the Plug-ins panel via View > Panels.
code. For each callback to be implemented by the plug- In the list of available plug-ins, right click on Check

UU=ö=rëÉê=j~åì~ä
NPKR=qìíçêá~ä

Mesh Properties and choose Attach from the con- • FEFLOW IFM SDK (the respective package in jáÅêçëçÑí= sáëì~ä
text menu. The plug-in will now appear in the list of the FEFLOW setup has to be selected) píìÇáç= Ü~ë= íç= ÄÉ
attached plug-ins. áåëí~ääÉÇ= éêáçê= íç
When the Check Mesh Properties plug-in is íÜÉ= fcj= pah= íç= ~ääçï= íÜÉ
attached, it creates two reference distributions Mesh- NPKRKOKN pí~êíáåÖ=íÜÉ=fcj=táò~êÇ áåëí~ää~íáçå=çÑ=íÜÉ=íÉãéä~íÉK
Properties:MaxAngle and MeshProperties:MinAngle
in the Data panel. To start with a new plug-in, open Visual Studio
Double-click on one of these reference distributions 2010 and choose New > Project from the File menu.
to visualize the angles in the active view. In the tree on the left side of the dialog, click on
Whenever the mesh is changed (e.g., when applying FEFLOW 6 Projects. Next, click on the FEFLOW 6
Smooth Mesh in the Mesh Geometry tool- IFM Plug-in template. Remove the Create directory
bar), the values in the reference distribution are for solution checkmark at the bottom of the window.
updated. After entering the name (HelloWorld) and the target
If a mesh contains a large number of elements, the location for the new plug-in, click OK to proceed.
computation time for the updating process may become
unacceptably long. In this case, the plug-in can be tem-
porarily disabled by removing its checkmark in the
Plug-ins panel.

NPKRKO= mêçÖê~ããáåÖ=mäìÖJáåë

The widely used Microsoft Visual Studio develop-


ment environment has been found suitable for the
development of plug-ins. The basic version, Visual Stu-
dio Express, is available free of charge (http:// Figure 13.1 Choosing an IFM plug-in template.
www.microsoft.com/express/).
The following example is based on Microsoft
Visual Studio 2010 Standard/Professional Edition. The
approach differs slightly from other versions of NPKRKOKO fåáíá~ä=mäìÖJfå=pÉííáåÖë
Microsoft Visual Studio and the free Microsoft Visual
Studio 2010 Express Edition. On the Welcome page, click Next.
Before starting the plug-in development, the follow- The following Plug-in Name page asks for a plug-
ing items have to be installed: in ID (which is its unique identifier), its display name
• Microsoft Visual Studio Standard/Professional or (the name to be shown in FEFLOW) and the plug-in
Microsoft Visual Studio Express Edition with C++ version number.
support By default, Plug-In ID and Display Name are set

cbcilt=S=ö=UV
NPK=mäìÖJáåë=~åÇ=fåíÉêÑ~ÅÉ=j~å~ÖÉê=fcj

according to the project name given before. We accept


the default. The value of the Register Proc field should
not be modified.

Figure 13.3 Callback Selection page.

Figure 13.2 Plug-in Name page.

Clicking Next leads to the Callback Selection page. NPKRKOKP fãéäÉãÉåíáåÖ=íÜÉ=cìåÅíáçå~äáíó


Place the mouse cursor over a callback to get detailed
information in a tooltip window. Activate the callback With a double-click, open the primary source code
OnEditDocument. file HelloWorld.cpp from the tree in the Solution
Click on Finish to start the generation of the plug-in Explorer panel.
frame code and of the Visual Studio files. Scroll down to

static void OnEditDocument...

and replace the lines

VM=ö=rëÉê=j~åì~ä
NPKR=qìíçêá~ä

/*
* TODO: Add your own code here...
*/
by the command
IfmInfo(pDoc,”Hello World!”);
according to Figure 13.4.

Figure 13.5 Log window message “Hello World!”.

Figure 13.4 Example code. =`çãéáäáåÖ=êÉäÉ~ëÉ=~åÇ=ñSQ=îÉêëáçåë


By default, a debug dynamic link library is com-
piled, which allows debugging (e.g., using breakpoints
NPKRKOKQ `çãéáäáåÖ=~åÇ=aÉÄìÖÖáåÖ in the plug-in code), but has reduced performance.
To build a more efficient release version, change the
Build the plug-in by pressing <F7> and then start Configuration as shown in Figure 13.6.
debugging with <F5>. Visual Studio starts FEFLOW as
a child process in debugging mode. FEFLOW automat-
ically lists the plug-in in the Plug-ins panel.
Load an arbitrary FEFLOW model, attach the plug-
in as described in Chapter 13.5.1, and click Edit in Figure 13.6 Changing the configuration.
the Plug-ins panel. The message “Hello World”
appears in the Log panel. In the same way the platform can be changed to
x64, providing the means to build plug-ins suitable for
the 64-bit version of FEFLOW (Figure 13.7).

Figure 13.7 Changing the platform.

cbcilt=S=ö=VN
NPK=mäìÖJáåë=~åÇ=fåíÉêÑ~ÅÉ=j~å~ÖÉê=fcj

VO=ö=rëÉê=j~åì~ä
pìÄàÉÅí=fåÇÉñ

pìÄàÉÅí=fåÇÉñ d
dÉçêÉÑÉêÉåÅáåÖ=NT
dêáÇÄìáäÇÉê=OU
f
kìãÉêáÅë fåíÉêÑ~ÅÉ=j~å~ÖÉê=fcj=UT
Pa=aáëÅêÉíáò~íáçå=OV fåíÉêéçä~íáçå=SP
^ i
^Çî~åÅáåÖ=cêçåí=OU iççâìé=q~ÄäÉë=SQ
^åáã~íáçå=UP
j
_ j~éë=NR
_çìåÇ~êó=`çåÇáíáçåë=RU j~íÉêá~ä=mêçéÉêíáÉë=SM
_çìåÇ~êó=`çåëíê~áåí=`çåÇáíáçåë=SM jÉëÜ=bÇáíáåÖ=OU
_ìÇÖÉí=^å~äóëáë=TR jÉëÜ=dÉåÉê~íáçå=OT
` jìäíáJä~óÉê=ïÉää=RV
`äáééáåÖ=RO k
`çãã~åÇJiáåÉ=jçÇÉ=T kçí~íáçå=U
`çåëíê~áåí=`çåÇáíáçåë=SM
l
`çåíÉåí=^å~äóëáë=TS
lÄëÉêî~íáçå=mçáåíë=TR
`çåîÉêÖÉåÅÉ=TO
`ççêÇáå~íÉ=póëíÉãë=NS m
a m~ê~ãÉíÉê=^ëëáÖåãÉåí=RT
m~íÜäáåÉë=TS
aáãÉåëáçå=PS
mÜêÉ~íáÅ=PV
aáëÅêÉíáò~íáçå=OT
mä~åÉë=RO
açÅìãÉåí~íáçå=U
mäìÖJáåë=UT
b mêçÄäÉã=pÉííáåÖë=PR
bèì~íáçå=pçäîÉê=QM mêçÅÉëë=s~êá~ÄäÉë=RU
bêêçê=`êáíÉêáçå=PT mêçÖê~ããáåÖ=fåíÉêÑ~ÅÉ=UT
bñéçêí=NUI=TT mêçàÉÅíáçå=PS
c o
cbcilt=`ä~ëëáÅ=T o~ëíÉê=j~éë=NR
cbcilt=bñéäçêÉê=UT oÉÑÉêÉåÅÉ=a~í~=SN
cbJijO=U oÉÖáçå~äáò~íáçå=SP
cbmilq=T oÉëìäíë=bî~äì~íáçå=TR
cáåáíÉJbäÉãÉåí=jÉëÜ=OT
p
cêÉÉ=pìêÑ~ÅÉ=PT
pÉäÉÅíáçåë=QR
cêÉÉ=pìêÑ~ÅÉ=`çåëíê~áåíë=QM
páãìä~íáçå=TN
pçäîÉê=QM

cbcilt=S=ö=VP
pìÄàÉÅí=fåÇÉñ

pìéÉêãÉëÜ=ON
q
qáãÉ=pÉêáÉë=SN
qáãÉ=píÉééáåÖ=PT
qê~åëéçêí=j~ééáåÖ=OU
qêá~åÖäÉ=OU
r
råáíë=SR
rëÉê=fåíÉêÑ~ÅÉ=NN
s
sÉÅíçê=j~éë=NR
sáÇÉç=UP
sáÉï=táåÇçïë=NOI=RN
sáÉïÉê=jçÇÉ=T
sáëì~äáò~íáçå=RN
t
tdbl=T

VQ=ö=rëÉêÛë=j~åì~ä=

You might also like