Report no 2 “OASIS3 User's Guide” 1 st ed - cerfacs

<strong>Report</strong> <strong>no</strong> 2
“OASIS3 User’s Guide”
1 st ed
Edited by:
Sophie Valcke, Arnaud Caubel, Damien Declat, Laurent Terray

Ž‘a’“9Ž ŠŒ‹
t—y¡!š#¢O£t¤W¥h¦p—§¤t˜_¦5¡!šO¥h¦9—yÿšO¡¢˜*¥*š‘©Kª¬«K­Kª®˜*¥*š‘©¯¡!šO˜*¢‘œ°—§©t¥›—{£t¤¢£§¤¯•t£9±²¥*£
”–•t—{˜_˜›š‘œOžṽŸS
!©tÿšO¡µ˜*—· t¨·¦9¥›—{£t¤v±–—{¥U•Œ¸¹»º!¼®º!½!¾
œ\š‘¦p¨{—y³Oš´¦¢O£§
t˜*š‘œ¦À®œ\—yš‘¤t¡!ÿ­È¥*£t£W¨&ÀM£§œ¦¢O£§ Kª
”–•tšv¦9—·¿£9ÀÁ¸–¹Áº!¼Âº!½_—y˜´¥*£#©!œ\£9Ãt—{¡!šv¦ÅÄšOÆt—·«t¨{š_¦W¤t¡Ç
¦W¤t¡Œœ\šOÉW—y£§¤!¦9¨

x
k
z
j–kSl >m j Rh?WoUDWLac k D9@

¦%$ )9:;,;$2$6+>(*@? A
8
‚ grABDŒ†SQ´> l > s @

)9.vfK r£
013254256x9:*¢¡KW9:>'+J9
‚ äSRUCbX#XBHKcÓHQY

l > s a®?§R_L‘?tVB@BJ-CETBuÇ^_?XD`JMŒHKTÜX ã ?§R_@

eg\hij ¤/i@g#¤@jp! ¥¤pn/ihi&% ¤/i>gG#+‡oŒ¥('%=jn:h)( #p :m
$
’pm#›‡oŒ¥('% :p#ok‹jm&(l(n)l\hp)(
¤
l(p*"›j\p :m #p:m+*
¤ql(p!"D<strong>no</strong>l‹j
l(p*"›j\p :m #p:m-,
¤ql(p!"Dpm#m
¤27i#:h)(l¤ )”‰/„‹ˆ/† h)(l(mqge(pn)l\hp)( /h)0g(nqgm"
ˆŒ‘ †(o†„ #p@jj/k8(h)#n)lh‹p)( :h)0g(<strong>no</strong>g"
¤qeh)eDm¤
jn/h4(lDn/h)(Dm! Nn&("j\pog(m;
9:(Dpol
x
¤qei>j$hm¤ †ˆ\¨ "i@l(m@j (p ’m›)(l(mog87(n#mxh)0g(nqgm"
¤:i#og\h)e£¤ ‹ˆq†Ŝh)(l(mqge(pn)l\hp)( /h)0g(nqgm"
¤:ih)eG#¤
¤ (q† #p)jj/k8(h#n)lhqp2( /h40g(nqgm"
¤:i)

cvRUVBT^\chCE^_D!P»†SQˆ> l > s H§LacOvHt_H ›D9@

C-TBCEchCMHKJ-CM*D¦chABDGLa?tVB@fJECETfuvHKT

x
z
z
x
k
z
Proc 1:
local offset = 0
local size = 4
Proc 2:
local offset = 4
local size = 6
Proc 3:
local offset = 10
local size = 5
C-utVBRhD ‚ wrQS@B@BJED@ ) )W(;
H§L A#@

x
z
CEcÓ Vf@B@

z
z
x
k
z
Proc 1: 1 st segment offset = 0
nbr of segments = 3 1 st segment size = 4
2nd segment offset = 7
2nd segment size = 2
3rd segment offset = 10
3rd segment size = 3
CEutVfRUD s w»†SROHKTfutD´@

x
x
‹Œ›eghi>j ’m&7

TâcUABD^â?XD9JBchCE^_DS*cUD9@B@fCETBuGJE?!?t@ PBDWHtLOAµ@fRU?LaDWhrCE^_@fJECEDpXˆCETâcUABD´L‘?tVB@BJ-CETBuG*D9T

TâcUABD´^_?XD`JechCE^_DS*cUD9@f@BCETBuGJE?!?§@&PBDWHtLOA_@BRh?LaDWhrCE^_@BJ-CEDWX€C-T_cUAfD´La?tVf@BJEC-TBu€RhDWLaD9C-!DWÐCEcO@

jk¦l >m >~D9Tc-Z ¤ | [ C acUABDVY
jk¦l >m d

aŒHÇ@BRU?LaDpU_TBD9DWXfÅch?/HW[

z
N HKRhRU?SŒLa?§RURUDp›@

B
z
^#HKcÓL ABDp chABDŒRUDWL‘D9CECETBuâHtL‘cUCE?§TÈ@

x
z
$
V

z
x
k
z
Model B timestep = 6
0 6 12 18 24 30
120
F1
F2
F3
F1 F2
F3
F1 F2
F3
F1 F2 F3 F1 F2 F3
OASIS3 main process
F1 F2 F3
F1 F2 F3
F1 F2 F3
F1 F2 F3
F1 F2 F3
F1 F2 F3
0 6 12 18 24 120
Model A timestep = 6
prism_put_proto/prism_get_proto leading to
sending/receiving actions
prism_put_proto/prism_get_proto NOT
leading to sending/receiving actions
Cpl_period(F1) = 12 LAG(F1) = 0 SEQ(F1) = 1
Cpl_period(F2) = 12 LAG(F2) = 0 SEQ(F2) = 2
Cpl_period(F3) = 12 LAG(F3) = 0 SEQ(F3) = 3
x b
CEu§VBRUD æ wIgrABDŒ>
La?§Tm j Rh?WoUDWLac k D9@

B
B
$
z
$
$
dQËäàCbr@e?~›C-cUCE!D
a

z
B
7 r 1 ; ¡"š)H=;D ¦H+ ¡W;$ *;()W9/K 9:;JS",9/@9/KWKK ?(*,"KJ H+$JK_)*;, ¡
6
eghi>j ekl gDm/i)lD<strong>no</strong>gl eg(pql(p
)MV*>V
$
B
x
k
$
z
First run:
LAG(F1) = -8
LAG(F2) = 6
SEQ(F1) = 2
SEQ(F2) = 1
F2
F1
F2
F1
F1
0 4 8 12
Next runs:
LAG(F1) = 4
LAG(F2) = 6
SEQ(F1) = 1
SEQ(F2) = 1
0 6 12
Restart
file F1
Restart
file F2
F2 F1 F2
F1
F2
F1
F2
F2
F2
prism_put_proto/prism_get_proto leading
to writing/reading to/from restart file
prism_put_proto/prism_get_proto leading
to sending/receiving actions
0
F1
12 16
6
F1
F2
F1
12
F1
F2
0 4 8 12 16
F2
116
18
108 114 120
F1
F1
120
F2 F1 F2
Restart
file F1
Model A
F2
F2
F1
120
120
Model B
Restart
file F2
Model B
Model A
prism_put_proto/prism_get_proto <strong>no</strong>t
leading to sending/receiving actions
prism_put_restart leading to writing to
coupling restart file
CEu§VBRUD
wrQST D`‰BHW^_@BJEDSV

l > s La?§TY

”Œ:„ ‡
‡
”¥(‡qŠ/„‹
p#m@jp <strong>no</strong>l‹jjp #&.Dm)jp ¢ ¢ ¡ ¢£¢
%
:„ ˆŽ”‰\
¤5%,'
@”)ŠŒ‰:„
* * * ''
D‡oŠ@”’‡
”(‡o‰
“†ˆ‰ ”(‡
,
‹Œ‰‘/†„
*
*
*+*,*+*,*,*+*,*+*,*,*-*+*,*-*+*,*-*,*-*+*,*-*+*,*-*,*-*+*,*-*+*,*-*,*+*-*,*-*+*,*-*,*+*-*,*-*+*,*-*,*+*-*,*+*-*,*-*,*+*-*,*+*-*,*,*-*+*-*,*
’m#p2( im#olh‹p&(
*
. *
*
Dhm +* *
*
*
D¨Ž‰/„ Ž+* ¨ ¤5 ¢ ii)lDpm# (# „…:†:‡oˆ‰/„‹Š
:‡‰¥‹‰
, * ¤¤¢ * ,¨ ¤ l(pm#m nqljp Œ:“ § © * ¤ ¤5' „&/ § © *
*¨
Œ¦¥/„ˆŒ/“„
§ * @”‰
*l(pqe(n ¢ * , ¤¡¨
nql5%
,©'%0 * ¢
’‡o”‹‰Œ”‰
*
Dhm -, *
*
’‡¨©/„ Š(‡ ¨ ¤5 72=(<strong>no</strong>l (G# „‹…/†:‡qˆ‰:„Š
:‡q”‹‰(‡q‰
lDpm#m Œ:“ § © * ¤ ¤5 „0/ § © *
<strong>no</strong>l‹jp
† , †
©/„ @” ˆ\o†‹ˆ ©/„ (‡qŽ‰
(‡‰ˆŒ”¥
x
k
z
¤
*&.¡
* .
*&.
*&.
*&.
*&.
*&.
‹‰ˆ@”/“
, † †
©/„ @” D‡ Œ\¨ ‹Œ‹”/„§ ©/„ (‡qŽ‰
(‡‰ˆŒ”¥
@”‰ § *
j–kSl >m j Rh?WoUDWLac k D9@

Ž Œ¥Ž
§ * @”‰
’‡o”„ˆ¦¥ ˆ ŒŒˆ Œ‰(‡o” * ˆŒ¥Œˆ/„Œ D)ˆ¥‰
*
Dhm *
*
©‹ ’‡ „‹”©¥ %' ¨ ¤5' * 7 ’n %0 (# o“‹”(‡qŽ‰
:‡„”
§ ©,' „0/ § © *
Œ:“
(‡‰ˆŒ”¥
Œ£¥:„ˆŒ:“„
*
Dhm ¤ *
*
*
*+*,*+*,*,*+*,*+*,*,*-*+*,*-*+*,*-*,*-*+*,*-*+*,*-*,*-*+*,*-*+*,*-*,*+*-*,*-*+*,*-*,*+*-*,*-*+*,*-*,*+*-*,*+*-*,*-*,*+*-*,*+*-*,*,*-*+*-*
grABD£¡ ›C-utT#^µVÜ›cr[

HKT

.
c›i@

‡qŽ‰/†‹Ž‰ w~›CE^â@BJEi »RUCEchcUD9Tâ?tVBcIcU?vHKT#?§VBcU@BVfc Ym l d

z
cU?LaDÕw€JE?L`HKcU?§R€@BRhD!Y

B
(#w ©ŒˆŒ‰:„ˆ %8,Œu§CECETBu_chABDvCETB@BVfc Y

Y
TcUAfD a®?§JEJ-?»C-TBur@ÜHKROHWutRÓHK@BA

‰ @”wWcUABD»^_C-TBCE^ŒVf^ §HKJ-VBD»?@a cUABD YÜD9JMX–a®?tRDWHtLOAŒ*?tVBRÓLaDSutRUCbX€@

RS132¡ w
7([»CM´V

.
.
.
¡ ¥ P4§¦ w
@” ZÂRh?tVBchCETBD #&.¦'7 7([L9HKJbLaVBJbHKcUDp€cUABDÕ^_DWHKT HKT

.
.
.
.
.
.
.
.
.
.
2 4!O w
ˆq†ˆåCb€TBD l > s HWT

z
¤
¤
¤
¤
.
.
.
.
.
Š‰‘:†GHKT

¤
.
¨
§ VB‰vLa?§T

¤
.
.
.
“‹ŒŽ¥(@Œ” Z®RU?tVfcUCETfDW5CET ¤qeg\hi>j ¤/i@gE#¤mh40¥¤n2(:n/hi13D[ŒCbÈH u~HKV

4!TUT 4 ¦ ¤ w
¡
¤oeghi>j ¤:i)gG#¤>jp ¤pn:ihi&%¦¤i)gG#¤&7(hh)(83 7([t@

T¢L9Ht*D_cUAfD_RUD9u§CE?§T

ŸZ@ÜHKRUcG?@á †SQ´> l > s PLa?tTcURh?tJEJ-DWXÈ[i
grABD¤a®?tJ-JE?»CETfuÈHKTÜHKJEif›Dp€HKRhD#H9§HKCEJbHK[BJ-DµC-T¯cUAfDIžÓLa?!?tNCETBu
¦(<strong>no</strong>gl 7 #pp
¦t2 ¨ w
¤oeghi>j ¤:i)gG#¤)jp! ¦¤pn:ihi&% ¤:i)gE# ¤m#p&(i‹mog < 7:[!@

.
.
():„
.
.
.
.
.
.
D)/„©Y‡ ] ä kSl ]?§@

ˆ/„ ¥:„ˆ¥„_X?!DpËTf?tcRr?§RUN3a®?§RG‡²HKT

La?tTcOHWCETBC-TBuµchABD–Y

u§RUCMXf¦cU?»ABCbL AÈchABDˆ:„Š/“‹(‡Œ?tR “‹(‡qˆ/„Š chROHWT< a®?§RU^#HWcUCE?§TÈCMHW@B@BJ-CEDWX
dnVfCERUDpX5?tTBJ-i3a®?tŔ
Q»^_D9TcUCE?§TBTBDWXâHK[

y‡ [HWT

1 *¢¡WKW9/'¦J9)9`v¨KfE( „…‰ˆŒ:†¥¤q”>”/„‹”” „‹…‰ˆŒ/†¦¤¨§/„D)“©‰ )”‰:„ˆ:†¥¤ ‹Žˆ¥/„©
ƒr¢W
“ŒŽ¥:@Œ” D‡ ‹Œ¨ 9/;,J ‹Ž“‹ˆ@Š
@”‰/„‹ˆ/†¦¤
z
.
x
„ s HWT

z
h‹n gDm/ii 9>h3 ;´CM»cUABDGH§XBXRUDpU¦?§T5cUAfD€*?tVBRÓLaD€u§RUCbX ?@acUAfD ¡ TBD`CEutA[

ƒr¢ 6 1 *¢¡WKW9/' J,9 9tv¨KW©E( ‹ˆo†‹ˆ
z
ˆq†ˆÈRUD9^×HK@B@BC-TBu!
„ | HKRUD HKVBch?t^#HWcUCML`HKJEJ-i/u§D9TBD9RÓHKcUDpX¤HKcÕRUVBTcUC-^_D5[i'† Qˆ> l > s grAfD9CERÕ›chRUV

l > s PrD`‰DWL‘VBcUD#cUAfDÇULaRhCE@Bc ’‡¨/† pn/ihi2%ÇCETNeghi>j ¤/i)gG#¤@j(p ¥¤pn/ihi)% grABCb
La?t^_@fCEJEDȆSQ´>
HKVBch?t^#HWcUCML`HKJEJ-iÈD9‰DWLaVBchDW ’‡¨:† /h40i pn/ihi&% C-Txeghij ¤qklh*BP%»AfCMLOĀ La?§^_@BC-JEDWHW@^
ULaRhCE@Bc
@BRÓHtLachCML9HWJÐD9‰fHK^_@BJ-D´?@aSH_ch?KiÇL‘?tVB@BJ-DWX5^_?XD`JáV l > s HKTÜX j >m l d

¦Dm!" (p/‹‡fa®?§RÊLa?t^_@fCEJEC-TBu j >m l dj ¤qkl\h*¤)j(p ¤olDp"#mhjP!Y s HWT

„ PÐcUABDâXC & D`RUD9Tc€chROHKTÜ a®?tRh^#HKchCE?§T l > s *VB@B@

Ž 3gh! ewG‡¦T

B
x
B
z
z
x
z
z
z
z
x
x
x
x
x
x
k
z
z
x
z
x
x
¡ ¦P§ ". ¢¡ $ ¨ ¤£ ¥c¡ £ ¦ £ ¦¥ $¥ ¡©¥¨§ ¡ §©£¦¥
grABDµ>BY kSl*j
‚ | La?§@iRUC-utAcS›cOHWcUD9^âD9TcRhDWHtXBSHt a®?tJ-JE?Saw
žaY?§@iRUC-utAc
‚`çtçn… P ‚9çtç
cUABD k D9u§D9TcO»?@aIcUABD ‡¦TBC-!D9RO*CEc*iµ?)aSYIHKJEC a®?tRhTBCMH
grAfCM*?@a®cV»HWRUD
HKTB†
grqÇQ k
[L9HKJ-JEDWX_>BY kSl›j
Cb ^×HtXDH9tHWCEJbHK[BJ-D
VBTB†
grqÇQ k
A

x
k
z
¡ §©§©£š§©£ ¥c§©
‚ AcUch@&w ã§ã ZZ
H§LaJ JMHWTBJ ut?W ã LaJEC-^_HWcUD ã ›?)a®c ÁHKRhD ã >BY kSl*jrã UL‘RUCE@ a®RÓHK^_DW AcU^
} AcUch@&w ã§ã ZZ u)a¬XJ ut?W ã¡ [ ã ^_@B@ CE? AcU^_J
j–kSl >m j Rh?WoUDWLac k D9@