diff --git a/LICENSE.txt b/LICENSE.txt
index bc91318942ef841c0b4e47da88d91bf7a088a738..838f381fa5877204c97771dc8686b983b76e64f5 100644
--- a/LICENSE.txt
+++ b/LICENSE.txt
@@ -1,4 +1,4 @@
-Copyright (c) 2015 Max-Planck-Institut fuer Meteorologie, Hamburg, Germany
+Copyright (c) 2017 Max-Planck-Institut fuer Meteorologie, Hamburg, Germany
Copying and distribution of this package, with or without modification, are
permitted in any medium without royalty provided the copyright notice and this
diff --git a/doc/mkexp.fodt b/doc/mkexp.fodt
index 0dd904b631ead312001fd74c5883999e673acb95..b840a5edd1c699b2c1eb74535ec1edc16638b066 100644
--- a/doc/mkexp.fodt
+++ b/doc/mkexp.fodt
@@ -1,24 +1,24 @@
<?xml version="1.0" encoding="UTF-8"?>
<office:document xmlns:office="urn:oasis:names:tc:opendocument:xmlns:office:1.0" xmlns:style="urn:oasis:names:tc:opendocument:xmlns:style:1.0" xmlns:text="urn:oasis:names:tc:opendocument:xmlns:text:1.0" xmlns:table="urn:oasis:names:tc:opendocument:xmlns:table:1.0" xmlns:draw="urn:oasis:names:tc:opendocument:xmlns:drawing:1.0" xmlns:fo="urn:oasis:names:tc:opendocument:xmlns:xsl-fo-compatible:1.0" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:meta="urn:oasis:names:tc:opendocument:xmlns:meta:1.0" xmlns:number="urn:oasis:names:tc:opendocument:xmlns:datastyle:1.0" xmlns:svg="urn:oasis:names:tc:opendocument:xmlns:svg-compatible:1.0" xmlns:chart="urn:oasis:names:tc:opendocument:xmlns:chart:1.0" xmlns:dr3d="urn:oasis:names:tc:opendocument:xmlns:dr3d:1.0" xmlns:math="http://www.w3.org/1998/Math/MathML" xmlns:form="urn:oasis:names:tc:opendocument:xmlns:form:1.0" xmlns:script="urn:oasis:names:tc:opendocument:xmlns:script:1.0" xmlns:config="urn:oasis:names:tc:opendocument:xmlns:config:1.0" xmlns:ooo="http://openoffice.org/2004/office" xmlns:ooow="http://openoffice.org/2004/writer" xmlns:oooc="http://openoffice.org/2004/calc" xmlns:dom="http://www.w3.org/2001/xml-events" xmlns:xforms="http://www.w3.org/2002/xforms" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:rpt="http://openoffice.org/2005/report" xmlns:of="urn:oasis:names:tc:opendocument:xmlns:of:1.2" xmlns:xhtml="http://www.w3.org/1999/xhtml" xmlns:grddl="http://www.w3.org/2003/g/data-view#" xmlns:officeooo="http://openoffice.org/2009/office" xmlns:tableooo="http://openoffice.org/2009/table" xmlns:drawooo="http://openoffice.org/2010/draw" xmlns:calcext="urn:org:documentfoundation:names:experimental:calc:xmlns:calcext:1.0" xmlns:loext="urn:org:documentfoundation:names:experimental:office:xmlns:loext:1.0" xmlns:field="urn:openoffice:names:experimental:ooo-ms-interop:xmlns:field:1.0" xmlns:formx="urn:openoffice:names:experimental:ooxml-odf-interop:xmlns:form:1.0" xmlns:css3t="http://www.w3.org/TR/css3-text/" office:version="1.2" office:mimetype="application/vnd.oasis.opendocument.text">
- <office:meta><meta:creation-date>2015-01-05T17:44:27.618344249</meta:creation-date><dc:title>Make Experiments!</dc:title><meta:editing-duration>P12DT1H57M6S</meta:editing-duration><meta:editing-cycles>127</meta:editing-cycles><meta:generator>LibreOffice/5.1.6.2$Linux_X86_64 LibreOffice_project/10m0$Build-2</meta:generator><meta:initial-creator>Karl-Hermann Wieners</meta:initial-creator><dc:date>2017-03-17T17:16:35.530782037</dc:date><dc:creator>Karl-Hermann Wieners</dc:creator><meta:printed-by>Karl-Hermann Wieners</meta:printed-by><meta:print-date>2015-01-20T10:55:48.576690105</meta:print-date><dc:subject>Run-script generation for earth system models</dc:subject><meta:document-statistic meta:table-count="0" meta:image-count="0" meta:object-count="0" meta:page-count="28" meta:paragraph-count="560" meta:word-count="7646" meta:character-count="48733" meta:non-whitespace-character-count="41250"/><meta:template xlink:type="simple" xlink:actuate="onRequest" xlink:title="A4" xlink:href="../../../../../../home/m221078/.config/libreoffice/4/user/template/A4.ott" meta:date="2015-01-05T17:44:27.463210655"/></office:meta>
+ <office:meta><meta:creation-date>2015-01-05T17:44:27.618344249</meta:creation-date><dc:title>Make Experiments!</dc:title><meta:editing-duration>P12DT1H59M</meta:editing-duration><meta:editing-cycles>129</meta:editing-cycles><meta:generator>LibreOffice/5.1.6.2$Linux_X86_64 LibreOffice_project/10m0$Build-2</meta:generator><meta:initial-creator>Karl-Hermann Wieners</meta:initial-creator><dc:date>2017-04-07T13:05:20.621931309</dc:date><dc:creator>Karl-Hermann Wieners</dc:creator><meta:printed-by>Karl-Hermann Wieners</meta:printed-by><meta:print-date>2015-01-20T10:55:48.576690105</meta:print-date><dc:subject>Run-script generation for earth system models</dc:subject><meta:document-statistic meta:table-count="0" meta:image-count="0" meta:object-count="0" meta:page-count="28" meta:paragraph-count="560" meta:word-count="7646" meta:character-count="48730" meta:non-whitespace-character-count="41247"/><meta:template xlink:type="simple" xlink:actuate="onRequest" xlink:title="A4" xlink:href="../../../../../../home/m221078/.config/libreoffice/4/user/template/A4.ott" meta:date="2015-01-05T17:44:27.463210655"/></office:meta>
<office:settings>
<config:config-item-set config:name="ooo:view-settings">
- <config:config-item config:name="ViewAreaTop" config:type="long">231479</config:config-item>
+ <config:config-item config:name="ViewAreaTop" config:type="long">12277</config:config-item>
<config:config-item config:name="ViewAreaLeft" config:type="long">0</config:config-item>
- <config:config-item config:name="ViewAreaWidth" config:type="long">33847</config:config-item>
- <config:config-item config:name="ViewAreaHeight" config:type="long">18755</config:config-item>
+ <config:config-item config:name="ViewAreaWidth" config:type="long">31413</config:config-item>
+ <config:config-item config:name="ViewAreaHeight" config:type="long">18163</config:config-item>
<config:config-item config:name="ShowRedlineChanges" config:type="boolean">true</config:config-item>
<config:config-item config:name="InBrowseMode" config:type="boolean">false</config:config-item>
<config:config-item-map-indexed config:name="Views">
<config:config-item-map-entry>
<config:config-item config:name="ViewId" config:type="string">view2</config:config-item>
- <config:config-item config:name="ViewLeft" config:type="long">19576</config:config-item>
- <config:config-item config:name="ViewTop" config:type="long">245814</config:config-item>
+ <config:config-item config:name="ViewLeft" config:type="long">17270</config:config-item>
+ <config:config-item config:name="ViewTop" config:type="long">12501</config:config-item>
<config:config-item config:name="VisibleLeft" config:type="long">0</config:config-item>
- <config:config-item config:name="VisibleTop" config:type="long">231479</config:config-item>
- <config:config-item config:name="VisibleRight" config:type="long">33846</config:config-item>
- <config:config-item config:name="VisibleBottom" config:type="long">250232</config:config-item>
+ <config:config-item config:name="VisibleTop" config:type="long">12277</config:config-item>
+ <config:config-item config:name="VisibleRight" config:type="long">31411</config:config-item>
+ <config:config-item config:name="VisibleBottom" config:type="long">30438</config:config-item>
<config:config-item config:name="ZoomType" config:type="short">0</config:config-item>
<config:config-item config:name="ViewLayoutColumns" config:type="short">0</config:config-item>
<config:config-item config:name="ViewLayoutBookMode" config:type="boolean">false</config:config-item>
@@ -68,7 +68,7 @@
<config:config-item config:name="InvertBorderSpacing" config:type="boolean">false</config:config-item>
<config:config-item config:name="SaveGlobalDocumentLinks" config:type="boolean">false</config:config-item>
<config:config-item config:name="TabsRelativeToIndent" config:type="boolean">true</config:config-item>
- <config:config-item config:name="Rsid" config:type="int">14997060</config:config-item>
+ <config:config-item config:name="Rsid" config:type="int">15125915</config:config-item>
<config:config-item config:name="PrintProspectRTL" config:type="boolean">false</config:config-item>
<config:config-item config:name="PrintEmptyPages" config:type="boolean">false</config:config-item>
<config:config-item config:name="ApplyUserData" config:type="boolean">true</config:config-item>
@@ -108,7 +108,7 @@
<config:config-item config:name="LoadReadonly" config:type="boolean">false</config:config-item>
<config:config-item config:name="DoNotCaptureDrawObjsOnPage" config:type="boolean">false</config:config-item>
<config:config-item config:name="CurrentDatabaseCommand" config:type="string"/>
- <config:config-item config:name="PrinterSetup" config:type="base64Binary">jAH+/0Jhc2lzAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQ1VQUzpCYXNpcwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAWAAMArgAAAAAAAAAIAFZUAAAkbQAASm9iRGF0YSAxCnByaW50ZXI9QmFzaXMKb3JpZW50YXRpb249UG9ydHJhaXQKY29waWVzPTEKY29sbGF0ZT1mYWxzZQptYXJnaW5kYWp1c3RtZW50PTAsMCwwLDAKY29sb3JkZXB0aD0yNApwc2xldmVsPTAKcGRmZGV2aWNlPTEKY29sb3JkZXZpY2U9MApQUERDb250ZXhEYXRhClBhZ2VTaXplOkxldHRlcgAAEgBDT01QQVRfRFVQTEVYX01PREUOAERVUExFWF9VTktOT1dO</config:config-item>
+ <config:config-item config:name="PrinterSetup" config:type="base64Binary">mwH+/0Jhc2lzAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQ1VQUzpCYXNpcwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAWAAMAvQAAAAAAAAAIAFZUAAAkbQAASm9iRGF0YSAxCnByaW50ZXI9QmFzaXMKb3JpZW50YXRpb249UG9ydHJhaXQKY29waWVzPTEKY29sbGF0ZT1mYWxzZQptYXJnaW5kYWp1c3RtZW50PTAsMCwwLDAKY29sb3JkZXB0aD0yNApwc2xldmVsPTAKcGRmZGV2aWNlPTEKY29sb3JkZXZpY2U9MApQUERDb250ZXhEYXRhCklucHV0U2xvdDpBdXRvAFBhZ2VTaXplOkxldHRlcgAAEgBDT01QQVRfRFVQTEVYX01PREUOAERVUExFWF9VTktOT1dO</config:config-item>
<config:config-item config:name="ClipAsCharacterAnchoredWriterFlyFrames" config:type="boolean">false</config:config-item>
</config:config-item-set>
</office:settings>
@@ -1039,245 +1039,242 @@
<style:style style:name="P219" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties officeooo:rsid="00e102d3" officeooo:paragraph-rsid="00e102d3"/>
</style:style>
- <style:style style:name="P220" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
- <style:text-properties officeooo:paragraph-rsid="007a1e4b"/>
+ <style:style style:name="P220" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:text-properties officeooo:rsid="00e4d644" officeooo:paragraph-rsid="00e4d644"/>
</style:style>
<style:style style:name="P221" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
- <style:text-properties officeooo:rsid="007ab691" officeooo:paragraph-rsid="007ab691"/>
+ <style:text-properties officeooo:paragraph-rsid="007a1e4b"/>
</style:style>
<style:style style:name="P222" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
- <style:text-properties officeooo:paragraph-rsid="007bf983"/>
+ <style:text-properties officeooo:rsid="007ab691" officeooo:paragraph-rsid="007ab691"/>
</style:style>
<style:style style:name="P223" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
- <style:text-properties officeooo:rsid="008e53fe" officeooo:paragraph-rsid="008e53fe"/>
+ <style:text-properties officeooo:paragraph-rsid="007bf983"/>
</style:style>
<style:style style:name="P224" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
- <style:text-properties fo:font-style="italic" officeooo:rsid="00925c69" officeooo:paragraph-rsid="00925c69" style:font-style-asian="italic" style:font-style-complex="italic"/>
+ <style:text-properties officeooo:rsid="008e53fe" officeooo:paragraph-rsid="008e53fe"/>
</style:style>
<style:style style:name="P225" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
- <style:text-properties officeooo:paragraph-rsid="0090e55e"/>
+ <style:text-properties fo:font-style="italic" officeooo:rsid="00925c69" officeooo:paragraph-rsid="00925c69" style:font-style-asian="italic" style:font-style-complex="italic"/>
</style:style>
<style:style style:name="P226" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
- <style:text-properties officeooo:rsid="00925c69" officeooo:paragraph-rsid="00925c69"/>
+ <style:text-properties officeooo:paragraph-rsid="0090e55e"/>
</style:style>
<style:style style:name="P227" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
- <style:text-properties officeooo:rsid="00beeeb9" officeooo:paragraph-rsid="00beeeb9"/>
+ <style:text-properties officeooo:rsid="00925c69" officeooo:paragraph-rsid="00925c69"/>
</style:style>
<style:style style:name="P228" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
- <style:text-properties officeooo:rsid="00beeeb9" officeooo:paragraph-rsid="00c0dbdb"/>
+ <style:text-properties officeooo:rsid="00beeeb9" officeooo:paragraph-rsid="00beeeb9"/>
</style:style>
<style:style style:name="P229" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
- <style:text-properties fo:font-weight="bold" officeooo:rsid="00cfb468" officeooo:paragraph-rsid="00cfb468" style:font-weight-asian="bold" style:font-weight-complex="bold"/>
+ <style:text-properties officeooo:rsid="00beeeb9" officeooo:paragraph-rsid="00c0dbdb"/>
</style:style>
<style:style style:name="P230" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
- <style:text-properties fo:font-weight="bold" officeooo:rsid="00d08d3b" officeooo:paragraph-rsid="00d08d3b" style:font-weight-asian="bold" style:font-weight-complex="bold"/>
+ <style:text-properties fo:font-weight="bold" officeooo:rsid="00cfb468" officeooo:paragraph-rsid="00cfb468" style:font-weight-asian="bold" style:font-weight-complex="bold"/>
</style:style>
<style:style style:name="P231" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
- <style:text-properties fo:font-weight="bold" officeooo:rsid="00e1d614" officeooo:paragraph-rsid="00e1d614" style:font-weight-asian="bold" style:font-weight-complex="bold"/>
+ <style:text-properties fo:font-weight="bold" officeooo:rsid="00d08d3b" officeooo:paragraph-rsid="00d08d3b" style:font-weight-asian="bold" style:font-weight-complex="bold"/>
</style:style>
<style:style style:name="P232" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
- <style:text-properties officeooo:rsid="00d08d3b" officeooo:paragraph-rsid="00d08d3b"/>
+ <style:text-properties fo:font-weight="bold" officeooo:rsid="00e1d614" officeooo:paragraph-rsid="00e1d614" style:font-weight-asian="bold" style:font-weight-complex="bold"/>
</style:style>
<style:style style:name="P233" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
- <style:text-properties officeooo:paragraph-rsid="00dbc83d"/>
+ <style:text-properties officeooo:rsid="00d08d3b" officeooo:paragraph-rsid="00d08d3b"/>
</style:style>
<style:style style:name="P234" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
+ <style:text-properties officeooo:paragraph-rsid="00dbc83d"/>
+ </style:style>
+ <style:style style:name="P235" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
<style:text-properties officeooo:paragraph-rsid="00dd5dd8"/>
</style:style>
- <style:style style:name="P235" style:family="paragraph" style:parent-style-name="Preformatted_20_Text_20_Interrupt">
+ <style:style style:name="P236" style:family="paragraph" style:parent-style-name="Preformatted_20_Text_20_Interrupt">
<style:text-properties officeooo:paragraph-rsid="008c2cba"/>
</style:style>
- <style:style style:name="P236" style:family="paragraph" style:parent-style-name="Preformatted_20_Text_20_Indented">
+ <style:style style:name="P237" style:family="paragraph" style:parent-style-name="Preformatted_20_Text_20_Indented">
<style:text-properties fo:font-style="normal" officeooo:rsid="008f3b90" officeooo:paragraph-rsid="008f3b90" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P237" style:family="paragraph" style:parent-style-name="Preformatted_20_Text_20_Indented">
+ <style:style style:name="P238" style:family="paragraph" style:parent-style-name="Preformatted_20_Text_20_Indented">
<style:text-properties fo:font-style="normal" fo:font-weight="normal" officeooo:rsid="00cba5e3" officeooo:paragraph-rsid="00d15d24" style:font-style-asian="normal" style:font-weight-asian="normal" style:font-style-complex="normal" style:font-weight-complex="normal"/>
</style:style>
- <style:style style:name="P238" style:family="paragraph" style:parent-style-name="Preformatted_20_Text_20_Indented">
+ <style:style style:name="P239" style:family="paragraph" style:parent-style-name="Preformatted_20_Text_20_Indented">
<style:text-properties fo:font-style="normal" fo:font-weight="normal" officeooo:rsid="00d15d24" officeooo:paragraph-rsid="00d15d24" style:font-style-asian="normal" style:font-weight-asian="normal" style:font-style-complex="normal" style:font-weight-complex="normal"/>
</style:style>
- <style:style style:name="P239" style:family="paragraph" style:parent-style-name="Preformatted_20_Text_20_Indented">
+ <style:style style:name="P240" style:family="paragraph" style:parent-style-name="Preformatted_20_Text_20_Indented">
<style:text-properties officeooo:paragraph-rsid="00cfb468"/>
</style:style>
- <style:style style:name="P240" style:family="paragraph" style:parent-style-name="Preformatted_20_Text_20_Indented">
+ <style:style style:name="P241" style:family="paragraph" style:parent-style-name="Preformatted_20_Text_20_Indented">
<style:text-properties officeooo:rsid="00d08d3b" officeooo:paragraph-rsid="00d08d3b"/>
</style:style>
- <style:style style:name="P241" style:family="paragraph" style:parent-style-name="Preformatted_20_Text_20_Indented">
+ <style:style style:name="P242" style:family="paragraph" style:parent-style-name="Preformatted_20_Text_20_Indented">
<style:text-properties officeooo:rsid="00d15d24" officeooo:paragraph-rsid="00d15d24"/>
</style:style>
- <style:style style:name="P242" style:family="paragraph" style:parent-style-name="Caption">
+ <style:style style:name="P243" style:family="paragraph" style:parent-style-name="Caption">
<style:paragraph-properties fo:text-align="center" style:justify-single-word="false"/>
</style:style>
- <style:style style:name="P243" style:family="paragraph" style:parent-style-name="Contents_20_Heading">
+ <style:style style:name="P244" style:family="paragraph" style:parent-style-name="Contents_20_Heading">
<style:paragraph-properties fo:break-before="page"/>
</style:style>
- <style:style style:name="P244" style:family="paragraph" style:parent-style-name="Heading_20_1">
+ <style:style style:name="P245" style:family="paragraph" style:parent-style-name="Heading_20_1">
<style:paragraph-properties fo:break-before="page"/>
<style:text-properties officeooo:rsid="000a3505" officeooo:paragraph-rsid="000a3505"/>
</style:style>
- <style:style style:name="P245" style:family="paragraph" style:parent-style-name="Contents_20_1">
+ <style:style style:name="P246" style:family="paragraph" style:parent-style-name="Contents_20_1">
<style:paragraph-properties>
<style:tab-stops>
<style:tab-stop style:position="17cm" style:type="right" style:leader-style="dotted" style:leader-text="."/>
</style:tab-stops>
</style:paragraph-properties>
</style:style>
- <style:style style:name="P246" style:family="paragraph" style:parent-style-name="Contents_20_2">
+ <style:style style:name="P247" style:family="paragraph" style:parent-style-name="Contents_20_2">
<style:paragraph-properties>
<style:tab-stops>
<style:tab-stop style:position="16.501cm" style:type="right" style:leader-style="dotted" style:leader-text="."/>
</style:tab-stops>
</style:paragraph-properties>
</style:style>
- <style:style style:name="P247" style:family="paragraph" style:parent-style-name="Contents_20_3">
+ <style:style style:name="P248" style:family="paragraph" style:parent-style-name="Contents_20_3">
<style:paragraph-properties>
<style:tab-stops>
<style:tab-stop style:position="16.002cm" style:type="right" style:leader-style="dotted" style:leader-text="."/>
</style:tab-stops>
</style:paragraph-properties>
</style:style>
- <style:style style:name="P248" style:family="paragraph" style:parent-style-name="Heading_20_1">
+ <style:style style:name="P249" style:family="paragraph" style:parent-style-name="Heading_20_1">
<style:text-properties officeooo:rsid="001888a2" officeooo:paragraph-rsid="009eea28"/>
</style:style>
- <style:style style:name="P249" style:family="paragraph" style:parent-style-name="Title" style:master-page-name="">
+ <style:style style:name="P250" style:family="paragraph" style:parent-style-name="Title" style:master-page-name="">
<style:paragraph-properties style:page-number="auto"/>
<style:text-properties officeooo:rsid="000a3505" officeooo:paragraph-rsid="000a3505"/>
</style:style>
- <style:style style:name="P250" style:family="paragraph" style:parent-style-name="Title" style:master-page-name="">
+ <style:style style:name="P251" style:family="paragraph" style:parent-style-name="Title" style:master-page-name="">
<style:paragraph-properties style:page-number="auto"/>
<style:text-properties officeooo:rsid="00cef9a3" officeooo:paragraph-rsid="00cef9a3"/>
</style:style>
- <style:style style:name="P251" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P252" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties officeooo:rsid="00750ebf" officeooo:paragraph-rsid="0074d148"/>
</style:style>
- <style:style style:name="P252" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P253" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties officeooo:rsid="00750ebf" officeooo:paragraph-rsid="00750ebf"/>
</style:style>
- <style:style style:name="P253" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P254" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties fo:font-style="normal" style:text-underline-style="none" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P254" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P255" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties fo:font-style="normal" style:text-underline-style="none" officeooo:rsid="009beecc" officeooo:paragraph-rsid="009beecc" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P255" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P256" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties fo:font-style="normal" style:text-underline-style="none" officeooo:paragraph-rsid="00c2926f" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P256" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P257" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties fo:font-style="normal" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P257" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P258" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties fo:font-style="normal" officeooo:paragraph-rsid="00931d47" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P258" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P259" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties fo:font-style="normal" officeooo:rsid="009715be" officeooo:paragraph-rsid="009acc7d" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P259" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P260" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties fo:font-style="normal" officeooo:rsid="009715be" officeooo:paragraph-rsid="00c6886f" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P260" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P261" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties officeooo:rsid="0063d022" officeooo:paragraph-rsid="0063d022"/>
</style:style>
- <style:style style:name="P261" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P262" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties officeooo:paragraph-rsid="00931d47"/>
</style:style>
- <style:style style:name="P262" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P263" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties officeooo:rsid="00c6886f" officeooo:paragraph-rsid="00c6886f"/>
</style:style>
- <style:style style:name="P263" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P264" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties officeooo:rsid="00d7bd9c" officeooo:paragraph-rsid="00d7bd9c"/>
</style:style>
- <style:style style:name="P264" style:family="paragraph" style:parent-style-name="Subtitle">
+ <style:style style:name="P265" style:family="paragraph" style:parent-style-name="Subtitle">
<style:text-properties officeooo:rsid="000a3505" officeooo:paragraph-rsid="000a3505"/>
</style:style>
- <style:style style:name="P265" style:family="paragraph" style:parent-style-name="Subtitle">
+ <style:style style:name="P266" style:family="paragraph" style:parent-style-name="Subtitle">
<style:text-properties officeooo:rsid="000a3505" officeooo:paragraph-rsid="00beeeb9"/>
</style:style>
- <style:style style:name="P266" style:family="paragraph" style:parent-style-name="Subtitle">
+ <style:style style:name="P267" style:family="paragraph" style:parent-style-name="Subtitle">
<style:text-properties officeooo:rsid="00beeeb9" officeooo:paragraph-rsid="00beeeb9"/>
</style:style>
- <style:style style:name="P267" style:family="paragraph" style:parent-style-name="Heading_20_2">
+ <style:style style:name="P268" style:family="paragraph" style:parent-style-name="Heading_20_2">
<style:text-properties officeooo:paragraph-rsid="00b17591"/>
</style:style>
- <style:style style:name="P268" style:family="paragraph" style:parent-style-name="Heading_20_2">
+ <style:style style:name="P269" style:family="paragraph" style:parent-style-name="Heading_20_2">
<style:text-properties officeooo:rsid="00288fc1" officeooo:paragraph-rsid="00423119"/>
</style:style>
- <style:style style:name="P269" style:family="paragraph" style:parent-style-name="Heading_20_2">
+ <style:style style:name="P270" style:family="paragraph" style:parent-style-name="Heading_20_2">
<style:text-properties officeooo:paragraph-rsid="00423119"/>
</style:style>
- <style:style style:name="P270" style:family="paragraph" style:parent-style-name="Heading_20_2">
+ <style:style style:name="P271" style:family="paragraph" style:parent-style-name="Heading_20_2">
<style:text-properties officeooo:paragraph-rsid="0063d022"/>
</style:style>
- <style:style style:name="P271" style:family="paragraph" style:parent-style-name="Heading_20_2">
+ <style:style style:name="P272" style:family="paragraph" style:parent-style-name="Heading_20_2">
<style:text-properties fo:font-style="normal" officeooo:paragraph-rsid="0086f697" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P272" style:family="paragraph" style:parent-style-name="Title" style:master-page-name="First_20_Page">
+ <style:style style:name="P273" style:family="paragraph" style:parent-style-name="Title" style:master-page-name="First_20_Page">
<style:paragraph-properties style:page-number="auto"/>
<style:text-properties officeooo:rsid="00cef9a3" officeooo:paragraph-rsid="00cef9a3"/>
</style:style>
- <style:style style:name="P273" style:family="paragraph" style:parent-style-name="Heading_20_1">
+ <style:style style:name="P274" style:family="paragraph" style:parent-style-name="Heading_20_1">
<style:text-properties officeooo:rsid="001888a2" officeooo:paragraph-rsid="009eea28"/>
</style:style>
- <style:style style:name="P274" style:family="paragraph" style:parent-style-name="Heading_20_1">
+ <style:style style:name="P275" style:family="paragraph" style:parent-style-name="Heading_20_1">
<style:paragraph-properties fo:break-before="page"/>
<style:text-properties officeooo:rsid="000a3505" officeooo:paragraph-rsid="000a3505"/>
</style:style>
- <style:style style:name="P275" style:family="paragraph" style:parent-style-name="Heading_20_2">
+ <style:style style:name="P276" style:family="paragraph" style:parent-style-name="Heading_20_2">
<style:text-properties officeooo:paragraph-rsid="00b17591"/>
</style:style>
- <style:style style:name="P276" style:family="paragraph" style:parent-style-name="Heading_20_2">
+ <style:style style:name="P277" style:family="paragraph" style:parent-style-name="Heading_20_2">
<style:text-properties officeooo:rsid="00288fc1" officeooo:paragraph-rsid="00423119"/>
</style:style>
- <style:style style:name="P277" style:family="paragraph" style:parent-style-name="Heading_20_2">
+ <style:style style:name="P278" style:family="paragraph" style:parent-style-name="Heading_20_2">
<style:text-properties officeooo:paragraph-rsid="00423119"/>
</style:style>
- <style:style style:name="P278" style:family="paragraph" style:parent-style-name="Heading_20_2">
+ <style:style style:name="P279" style:family="paragraph" style:parent-style-name="Heading_20_2">
<style:text-properties officeooo:paragraph-rsid="0063d022"/>
</style:style>
- <style:style style:name="P279" style:family="paragraph" style:parent-style-name="Heading_20_2">
+ <style:style style:name="P280" style:family="paragraph" style:parent-style-name="Heading_20_2">
<style:text-properties fo:font-style="normal" officeooo:paragraph-rsid="0086f697" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P280" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P281" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties officeooo:rsid="00750ebf" officeooo:paragraph-rsid="0074d148"/>
</style:style>
- <style:style style:name="P281" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P282" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties officeooo:rsid="00750ebf" officeooo:paragraph-rsid="00750ebf"/>
</style:style>
- <style:style style:name="P282" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P283" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties officeooo:rsid="00d7bd9c" officeooo:paragraph-rsid="00d7bd9c"/>
</style:style>
- <style:style style:name="P283" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P284" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties fo:font-style="normal" style:text-underline-style="none" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P284" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P285" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties fo:font-style="normal" style:text-underline-style="none" officeooo:rsid="009beecc" officeooo:paragraph-rsid="009beecc" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P285" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P286" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties fo:font-style="normal" style:text-underline-style="none" officeooo:paragraph-rsid="00c2926f" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P286" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P287" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties fo:font-style="normal" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P287" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P288" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties fo:font-style="normal" officeooo:paragraph-rsid="00931d47" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P288" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P289" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties fo:font-style="normal" officeooo:rsid="009715be" officeooo:paragraph-rsid="00c6886f" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P289" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P290" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties officeooo:rsid="0063d022" officeooo:paragraph-rsid="0063d022"/>
</style:style>
- <style:style style:name="P290" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P291" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties officeooo:paragraph-rsid="00931d47"/>
</style:style>
- <style:style style:name="P291" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P292" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties officeooo:rsid="00c6886f" officeooo:paragraph-rsid="00c6886f"/>
</style:style>
- <style:style style:name="P292" style:family="paragraph" style:parent-style-name="List_20_Contents">
- <style:text-properties officeooo:rsid="00dbc83d" officeooo:paragraph-rsid="00dbc83d"/>
- </style:style>
- <style:style style:name="P293" style:family="paragraph" style:parent-style-name="List_20_Contents">
- <style:text-properties officeooo:rsid="00e4d644" officeooo:paragraph-rsid="00e4d644"/>
- </style:style>
<style:style style:name="T1" style:family="text">
<style:text-properties officeooo:rsid="000be205"/>
</style:style>
@@ -2057,7 +2054,7 @@
<office:master-styles>
<style:master-page style:name="Standard" style:page-layout-name="pm1">
<style:footer>
- <text:p text:style-name="Footer"><text:page-number text:select-page="current">9</text:page-number><text:tab/><text:tab/><text:modification-date style:data-style-name="N84">2017-03-17</text:modification-date>, <text:modification-time style:data-style-name="N41">17:16:36</text:modification-time></text:p>
+ <text:p text:style-name="Footer"><text:page-number text:select-page="current">28</text:page-number><text:tab/><text:tab/><text:modification-date style:data-style-name="N84">2017-04-07</text:modification-date>, <text:modification-time style:data-style-name="N41">13:05:21</text:modification-time></text:p>
</style:footer>
</style:master-page>
<style:master-page style:name="First_20_Page" style:display-name="First Page" style:page-layout-name="pm2" style:next-style-name="Standard"/>
@@ -2072,10 +2069,10 @@
<text:sequence-decl text:display-outline-level="0" text:name="Text"/>
<text:sequence-decl text:display-outline-level="0" text:name="Drawing"/>
</text:sequence-decls>
- <text:p text:style-name="P272">Make Experiments!</text:p>
- <text:p text:style-name="P265">Run-script generation for earth system models</text:p>
- <text:p text:style-name="P266">Release 0.<text:span text:style-name="T241">4</text:span>.<text:span text:style-name="T244">2dev</text:span></text:p>
- <text:p text:style-name="P242">Karl-Hermann Wieners<text:line-break/><text:span text:style-name="T219">Max-Planck-Institut für Meteorologie<text:line-break/>Hamburg</text:span></text:p>
+ <text:p text:style-name="P273">Make Experiments!</text:p>
+ <text:p text:style-name="P266">Run-script generation for earth system models</text:p>
+ <text:p text:style-name="P267">Release 0.<text:span text:style-name="T241">4</text:span>.<text:span text:style-name="T244">2</text:span></text:p>
+ <text:p text:style-name="P243">Karl-Hermann Wieners<text:line-break/><text:span text:style-name="T219">Max-Planck-Institut für Meteorologie<text:line-break/>Hamburg</text:span></text:p>
<text:table-of-content text:style-name="Sect1" text:protected="true" text:name="Table of Contents1">
<text:table-of-content-source text:outline-level="10">
<text:index-title-template text:style-name="Contents_20_Heading">Table of Contents</text:index-title-template>
@@ -2162,58 +2159,58 @@
</text:table-of-content-source>
<text:index-body>
<text:index-title text:style-name="Sect1" text:name="Table of Contents1_Head">
- <text:p text:style-name="P243">Table of Contents</text:p>
+ <text:p text:style-name="P244">Table of Contents</text:p>
</text:index-title>
- <text:p text:style-name="P245"><text:a xlink:type="simple" xlink:href="#__RefHeading__2518_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">1 Introduction<text:tab/>3</text:a></text:p>
- <text:p text:style-name="P246"><text:a xlink:type="simple" xlink:href="#__RefHeading__2520_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">1.1 Example: ECHAM experiment setup<text:tab/>3</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2522_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">1.1.1 Experiments are defined by custom and default settings<text:tab/>3</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2524_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">1.1.2 Job templates are completed by settings to create scripts<text:tab/>4</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2526_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">1.1.3 Generating scripts only refers to the custom settings' file<text:tab/>6</text:a></text:p>
- <text:p text:style-name="P245"><text:a xlink:type="simple" xlink:href="#__RefHeading__2528_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2 Details on experiment definition<text:tab/>6</text:a></text:p>
- <text:p text:style-name="P246"><text:a xlink:type="simple" xlink:href="#__RefHeading__2530_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.1 Design<text:tab/>7</text:a></text:p>
- <text:p text:style-name="P246"><text:a xlink:type="simple" xlink:href="#__RefHeading__2532_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.2 Tools<text:tab/>7</text:a></text:p>
- <text:p text:style-name="P246"><text:a xlink:type="simple" xlink:href="#__RefHeading__2534_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.3 Format of .config files<text:tab/>8</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__1669_1438093122" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.3.1 Variables<text:tab/>8</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2536_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.3.2 Sections<text:tab/>9</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2538_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.3.3 Special variables and sections<text:tab/>9</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2540_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.3.4 Variable interpolation<text:tab/>11</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2542_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.3.5 Evaluation of interpolation<text:tab/>12</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2544_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.3.6 Special expressions<text:tab/>13</text:a></text:p>
- <text:p text:style-name="P246"><text:a xlink:type="simple" xlink:href="#__RefHeading__2546_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.4 Format of .tmpl files<text:tab/>14</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2548_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.4.1 Placeholders<text:tab/>14</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2550_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.4.2 Variables in sections<text:tab/>14</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2552_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.4.3 Expressions<text:tab/>15</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2554_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.4.4 Loops<text:tab/>15</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2556_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.4.5 Conditions<text:tab/>16</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2558_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.4.6 Comments<text:tab/>16</text:a></text:p>
- <text:p text:style-name="P246"><text:a xlink:type="simple" xlink:href="#__RefHeading__2560_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.5 Standard experiments<text:tab/>17</text:a></text:p>
- <text:p text:style-name="P246"><text:a xlink:type="simple" xlink:href="#__RefHeading__2562_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.6 Standard options<text:tab/>17</text:a></text:p>
- <text:p text:style-name="P246"><text:a xlink:type="simple" xlink:href="#__RefHeading__2564_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.7 Standard environments<text:tab/>18</text:a></text:p>
- <text:p text:style-name="P246"><text:a xlink:type="simple" xlink:href="#__RefHeading__1508_1711940803" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.8 Generating jobs<text:tab/>18</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2566_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.8.1 Changing the model job list<text:tab/>19</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2568_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.8.2 Pre-defined job variables<text:tab/>19</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2570_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.8.3 Overriding namelist settings in derived jobs<text:tab/>20</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2572_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.8.4 Native script variables<text:tab/>20</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2574_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.8.5 Initializing native script variables<text:tab/>21</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2576_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.8.6 Re-generation of scripts and backup<text:tab/>22</text:a></text:p>
- <text:p text:style-name="P246"><text:a xlink:type="simple" xlink:href="#__RefHeading__1883_1672291846" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.9 Defining namelists and other configuration files<text:tab/>22</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2578_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.9.1 Formatting the namelist information<text:tab/>23</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2580_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.9.2 Suppressing namelist groups or variables<text:tab/>23</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2714_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.9.3 Using the namelist text<text:tab/>24</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2584_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.9.4 Non-namelist configuration files<text:tab/>24</text:a></text:p>
- <text:p text:style-name="P246"><text:a xlink:type="simple" xlink:href="#__RefHeading__2831_1132221942" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.10 Defining input files for an experiment<text:tab/>25</text:a></text:p>
- <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2833_1132221942" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.10.1 Overriding input files for certain jobs<text:tab/>25</text:a></text:p>
+ <text:p text:style-name="P246"><text:a xlink:type="simple" xlink:href="#__RefHeading__2518_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">1 Introduction<text:tab/>3</text:a></text:p>
+ <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2520_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">1.1 Example: ECHAM experiment setup<text:tab/>3</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2522_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">1.1.1 Experiments are defined by custom and default settings<text:tab/>3</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2524_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">1.1.2 Job templates are completed by settings to create scripts<text:tab/>4</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2526_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">1.1.3 Generating scripts only refers to the custom settings' file<text:tab/>6</text:a></text:p>
+ <text:p text:style-name="P246"><text:a xlink:type="simple" xlink:href="#__RefHeading__2528_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2 Details on experiment definition<text:tab/>6</text:a></text:p>
+ <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2530_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.1 Design<text:tab/>7</text:a></text:p>
+ <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2532_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.2 Tools<text:tab/>7</text:a></text:p>
+ <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2534_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.3 Format of .config files<text:tab/>8</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__1669_1438093122" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.3.1 Variables<text:tab/>8</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2536_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.3.2 Sections<text:tab/>9</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2538_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.3.3 Special variables and sections<text:tab/>9</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2540_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.3.4 Variable interpolation<text:tab/>11</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2542_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.3.5 Evaluation of interpolation<text:tab/>12</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2544_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.3.6 Special expressions<text:tab/>13</text:a></text:p>
+ <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2546_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.4 Format of .tmpl files<text:tab/>14</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2548_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.4.1 Placeholders<text:tab/>14</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2550_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.4.2 Variables in sections<text:tab/>14</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2552_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.4.3 Expressions<text:tab/>15</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2554_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.4.4 Loops<text:tab/>15</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2556_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.4.5 Conditions<text:tab/>16</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2558_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.4.6 Comments<text:tab/>16</text:a></text:p>
+ <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2560_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.5 Standard experiments<text:tab/>17</text:a></text:p>
+ <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2562_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.6 Standard options<text:tab/>17</text:a></text:p>
+ <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2564_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.7 Standard environments<text:tab/>18</text:a></text:p>
+ <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__1508_1711940803" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.8 Generating jobs<text:tab/>18</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2566_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.8.1 Changing the model job list<text:tab/>19</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2568_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.8.2 Pre-defined job variables<text:tab/>19</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2570_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.8.3 Overriding namelist settings in derived jobs<text:tab/>20</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2572_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.8.4 Native script variables<text:tab/>20</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2574_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.8.5 Initializing native script variables<text:tab/>21</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2576_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.8.6 Re-generation of scripts and backup<text:tab/>22</text:a></text:p>
+ <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__1883_1672291846" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.9 Defining namelists and other configuration files<text:tab/>22</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2578_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.9.1 Formatting the namelist information<text:tab/>23</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2580_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.9.2 Suppressing namelist groups or variables<text:tab/>23</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2714_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.9.3 Using the namelist text<text:tab/>24</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2584_1114405012" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.9.4 Non-namelist configuration files<text:tab/>24</text:a></text:p>
+ <text:p text:style-name="P247"><text:a xlink:type="simple" xlink:href="#__RefHeading__2831_1132221942" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.10 Defining input files for an experiment<text:tab/>25</text:a></text:p>
+ <text:p text:style-name="P248"><text:a xlink:type="simple" xlink:href="#__RefHeading__2833_1132221942" text:style-name="Index_20_Link" text:visited-style-name="Index_20_Link">2.10.1 Overriding input files for certain jobs<text:tab/>25</text:a></text:p>
</text:index-body>
</text:table-of-content>
<text:p text:style-name="P82"/>
- <text:h text:style-name="P244" text:outline-level="1"><text:bookmark-start text:name="__RefHeading__2518_1114405012"/>Introduction<text:bookmark-end text:name="__RefHeading__2518_1114405012"/></text:h>
+ <text:h text:style-name="P245" text:outline-level="1"><text:bookmark-start text:name="__RefHeading__2518_1114405012"/>Introduction<text:bookmark-end text:name="__RefHeading__2518_1114405012"/></text:h>
<text:p text:style-name="Text_20_body">Running a numerical earth system model experiment requires a number of preparatory and processing steps like staging input data files, providing namelists and other configuration data, housekeeping duties like model-time management, post-processing and storing <text:span text:style-name="T1">of </text:span>output data. These steps are usually put into scripts or another kind of job description that is finally executed on some high-performance computing system.</text:p>
<text:p text:style-name="P1">The <text:span text:style-name="T144">Make Experiments! (</text:span>mkexp<text:span text:style-name="T144">)</text:span> toolbox provides a generic interface to setting up such a<text:span text:style-name="T1">n experiment</text:span>. At the heart of this <text:span text:style-name="T1">lies</text:span> the so-called .config file. This is a simple <text:span text:style-name="T1">text </text:span>file that contains the model settings for your experiment in a way that is <text:span text:style-name="T1">largely </text:span>independent of the job description that is later used to run it.</text:p>
<text:p text:style-name="P4">To make this an easy task, MPI-M's models are delivered with a number of standard experiment types. Your own .config file will chose one of these, thus inheriting their settings for use in your experiment. Typically, it will also override or amend these settings for the purpose of your experiment.</text:p>
<text:p text:style-name="P2">While the .config fil<text:span text:style-name="T2">e contains all necessary settings, there is much more to the actual job description. Therefore, the standard experiment types also provide templates (.tmpl files) for the jobs to run, that are then converted to the final job step descriptions, using the .config file settings. Besides, the .config file contains a 'jobs' section, where the job control flow and parameters of the job description itself may be adjusted, e.g. requiring more resources or disabling certain job steps.</text:span></text:p>
<text:h text:style-name="Heading_20_2" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__2520_1114405012"/>Example: <text:span text:style-name="T3">ECHAM experiment setup</text:span><text:bookmark-end text:name="__RefHeading__2520_1114405012"/></text:h>
<text:p text:style-name="P32">To illustrate the way <text:span text:style-name="T9">mkexp</text:span> works, let us look at the way that experiments with ECHAM, MPI-M's atmospheric circulation model, are set up.</text:p>
- <text:h text:style-name="P251" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2522_1114405012"/>Experiments are defined by custom and default settings<text:bookmark-end text:name="__RefHeading__2522_1114405012"/></text:h>
+ <text:h text:style-name="P252" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2522_1114405012"/>Experiments are defined by custom and default settings<text:bookmark-end text:name="__RefHeading__2522_1114405012"/></text:h>
<text:p text:style-name="P3">ECHAM comes with five <text:span text:style-name="T189">pre-defined </text:span>experiment types, amip-LR, amip-MR, amip-HR, sstClim-LR and sstClim-MR. <text:span text:style-name="T3">To set up an experiment based on one of these, like amip-LR, all you have to do is create your own experiment configuration file within ECHAM's run subdirectory, e.g. 'joe1234.config', setting amip-LR as experiment type and providing an experiment description with the header comment:</text:span></text:p>
<text:p text:style-name="P98"><text:soft-page-break/># Standard AMIP experiment as baseline for further experiments (LR)</text:p>
<text:p text:style-name="P98"/>
@@ -2239,7 +2236,7 @@
<text:p text:style-name="P103">ATMO_INPUT_ROOT = /pool/data/ECHAM6/input/r0004 </text:p>
<text:p text:style-name="P103">LAND_INPUT_ROOT = /pool/data/JSBACH/input/r0004 </text:p>
<text:p text:style-name="P6">The final configuration is then merged from all of these three sources, where the experiment configuration may override <text:span text:style-name="T44">or amend </text:span>settings from the experiment type, and the type config may in turn change the model defaults.</text:p>
- <text:h text:style-name="P252" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2524_1114405012"/>Job templates are completed by settings to create scripts<text:bookmark-end text:name="__RefHeading__2524_1114405012"/></text:h>
+ <text:h text:style-name="P253" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2524_1114405012"/>Job templates are completed by settings to create scripts<text:bookmark-end text:name="__RefHeading__2524_1114405012"/></text:h>
<text:p text:style-name="P6"><text:span text:style-name="T188">Now the experiment configuration is finalized, the </text:span>settings are used to fill in <text:span text:style-name="T188">a kind of job description forms, so called </text:span><text:span text:style-name="T9">templates</text:span><text:span text:style-name="T188">, </text:span>from which eventually the <text:span text:style-name="T188">actual </text:span>job description files are created. As the structure of<text:span text:style-name="T188"> </text:span>jobs is largely independent of the model resolution, all amip- experiment types share the same set of template files. One of them is <text:span text:style-name="T209">'</text:span>amip.run.tmpl<text:span text:style-name="T209">'</text:span>, also within the run/standard_experiments subdirectory. <text:span text:style-name="T6">The excerpt below shows that t</text:span>his looks mostly like a shell script, but contains <text:span text:style-name="T143">placeholders</text:span> that are filled using the .config file information:</text:p>
<text:p text:style-name="P103"><text:soft-page-break/>#! /bin/bash</text:p>
<text:p text:style-name="P103"/>
@@ -2306,33 +2303,33 @@
<text:p text:style-name="P13"><text:span text:style-name="T188">So, as soon as</text:span> <text:span text:style-name="T188">you have set up '</text:span>joe1234.config<text:span text:style-name="T188">'</text:span>, you may create the job scripts that are needed to run your experiment. Still within ECHAM's <text:span text:style-name="T190">'</text:span>run<text:span text:style-name="T190">'</text:span> subdirectory, type the following into your terminal:</text:p>
<text:p text:style-name="Preformatted_20_Text">../util/mkexp/mkexp joe1234.config</text:p>
<text:p text:style-name="P14">This will <text:span text:style-name="T144">read all configuration information and </text:span>create all job scripts that are defined within your experiment's setup, <text:span text:style-name="T144">using their respective templates as shown in the previous section</text:span>. <text:span text:style-name="T9">mkexp</text:span> will put these <text:span text:style-name="T144">scripts </text:span>in <text:span text:style-name="T144">a common</text:span> directory defined by the .config variable <text:span text:style-name="T190">'</text:span>SCRIPT_DIR<text:span text:style-name="T190">'</text:span>, and <text:span text:style-name="T190">print</text:span> the name of this directory on your terminal.</text:p>
- <text:h text:style-name="P248" text:outline-level="1"><text:bookmark-start text:name="__RefHeading__2528_1114405012"/>Details on <text:span text:style-name="T208">experiment</text:span> <text:span text:style-name="T208">definition</text:span><text:bookmark-end text:name="__RefHeading__2528_1114405012"/></text:h>
+ <text:h text:style-name="P249" text:outline-level="1"><text:bookmark-start text:name="__RefHeading__2528_1114405012"/>Details on <text:span text:style-name="T208">experiment</text:span> <text:span text:style-name="T208">definition</text:span><text:bookmark-end text:name="__RefHeading__2528_1114405012"/></text:h>
<text:p text:style-name="P15">With the introductory example of the previous section in mind, this section will give some more detailed information on specific aspects of <text:span text:style-name="T9">mkexp</text:span><text:span text:style-name="T47">.</text:span></text:p>
- <text:h text:style-name="P267" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__2530_1114405012"/><text:soft-page-break/>Design<text:bookmark-end text:name="__RefHeading__2530_1114405012"/></text:h>
+ <text:h text:style-name="P268" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__2530_1114405012"/><text:soft-page-break/>Design<text:bookmark-end text:name="__RefHeading__2530_1114405012"/></text:h>
<text:p text:style-name="P34">Experiment definition with <text:span text:style-name="T9">mkexp</text:span> <text:span text:style-name="T170">is organized</text:span> <text:span text:style-name="T170">in</text:span> three levels.</text:p>
<text:p text:style-name="P34">The first level is the <text:span text:style-name="T9">mkexp</text:span> toolbox. It provides the front end to create an executable job description from a generic experiment configuration, <text:span text:style-name="T169">but does not contain any model specific information. Instead a basic set of conventions is defined that should be applicable to a very large range of model systems. When this document uses the term </text:span><text:span text:style-name="T18">mkexp</text:span><text:span text:style-name="T53">, it refers to this system level.</text:span></text:p>
<text:p text:style-name="P34"><text:span text:style-name="T169">At a second level, a model needs to provide a number of files containing the information needed by </text:span><text:span text:style-name="T17">mkexp</text:span><text:span text:style-name="T169">: the required job steps and their interaction, the basic contents of job scripts, model specific information, and building blocks that may be combined to define a specific experiment. This is called the </text:span><text:span text:style-name="T17">model setup</text:span><text:span text:style-name="T52">. The files must maintain the naming conventions prescribed by </text:span><text:span text:style-name="T17">mkexp</text:span><text:span text:style-name="T52">.</text:span></text:p>
<text:p text:style-name="P35"><text:span text:style-name="T47">Finally, the third level is the actual experiment definition. Here the user decides which of the building blocks from the previous level are needed, and </text:span><text:span text:style-name="T84">defines</text:span><text:span text:style-name="T47"> experiment specific settings that override or amend the information from the model setup. It is also essential to supply an experiment description and a – possibly unique – experiment identifier. All this is called the </text:span><text:span text:style-name="T9">user setup</text:span><text:span text:style-name="T47">.</text:span></text:p>
<text:p text:style-name="P36"><text:span text:style-name="T47">All levels should make a clear distinction </text:span><text:span text:style-name="T54">between </text:span><text:span text:style-name="T47">the .config files, containing the experiment's configuration information, </text:span><text:span text:style-name="T54">and </text:span><text:span text:style-name="T47">the .tmpl files, containing the actual job description and job control syntax.</text:span></text:p>
- <text:h text:style-name="P268" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__2532_1114405012"/>Tools<text:bookmark-end text:name="__RefHeading__2532_1114405012"/></text:h>
+ <text:h text:style-name="P269" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__2532_1114405012"/>Tools<text:bookmark-end text:name="__RefHeading__2532_1114405012"/></text:h>
<text:p text:style-name="P83"><text:span text:style-name="T144">The </text:span><text:span text:style-name="T32">mkexp</text:span><text:span text:style-name="T144"> package provides a number of tools for working with script configurations and setups.</text:span></text:p>
<text:p text:style-name="Preformatted_20_List_20_Heading">mkexp <text:span text:style-name="T238">[-m] [-g] </text:span><text:span text:style-name="T23">file</text:span><text:span text:style-name="T65">.</text:span><text:span text:style-name="T47">config</text:span> [<text:span text:style-name="T9">name</text:span>=<text:span text:style-name="T9">value</text:span> ...]</text:p>
<text:p text:style-name="P200"><text:span text:style-name="T144">This is the main tool for generating an experiment setup. It </text:span>takes <text:span text:style-name="T191">the given</text:span> <text:span text:style-name="T191">user setup</text:span> and <text:span text:style-name="T210">the model setup that is referenced by the user setup </text:span>to generate <text:span text:style-name="T191">the</text:span> <text:span text:style-name="T191">job description files or</text:span> scripts that <text:span text:style-name="T210">are required to run a model experiment as specified in </text:span><text:span text:style-name="T21">file.</text:span><text:span text:style-name="T65">config</text:span><text:span text:style-name="T191">.</text:span></text:p>
<text:p text:style-name="P204">When running, <text:span text:style-name="T9">mkexp</text:span><text:span text:style-name="T47"> creates three directories, one each for the job scripts, run-time data, and output data, as defined by the setup. The names of these are printed, plus warnings if they already exist.</text:span></text:p>
<text:p text:style-name="P203">mkexp<text:span text:style-name="T47"> allows to override </text:span><text:span text:style-name="T63">or amend </text:span><text:span text:style-name="T47">the .config file settings on the command line </text:span><text:span text:style-name="T63">by defining or re-defining a variable </text:span><text:span text:style-name="T192">name</text:span><text:span text:style-name="T63"> set to </text:span><text:span text:style-name="T192">value</text:span><text:span text:style-name="T63">. Section variables are referenced as </text:span><text:span text:style-name="T192">sectionname</text:span><text:span text:style-name="T63">.</text:span><text:span text:style-name="T192">variablename</text:span><text:span text:style-name="T63">. Any periods in the variable name have to be duplicated, e.g. to set '.remove' in section 'jobs' to 'post', use 'jobs...remove=post'. Note that three periods will always be read as '.' followed by </text:span><text:soft-page-break/><text:span text:style-name="T63">'..', thus it is not possible to use variable names th</text:span><text:span text:style-name="T85">at</text:span><text:span text:style-name="T63"> </text:span><text:span text:style-name="T192">end</text:span><text:span text:style-name="T63"> </text:span><text:span text:style-name="T85">i</text:span><text:span text:style-name="T63">n a period.</text:span></text:p>
<text:p text:style-name="P218"><text:span text:style-name="T63">W</text:span><text:span text:style-name="T47">hen given the '-m' or '--no-make-dirs' option, only the </text:span><text:span text:style-name="T64">script</text:span><text:span text:style-name="T47"> directory is created while creation of the </text:span><text:span text:style-name="T64">run-time and outpu</text:span><text:span text:style-name="T47">t directories is skipped.</text:span></text:p>
- <text:p text:style-name="P293">With '-g' or '--getexp', instead of a .config file, <text:span text:style-name="T9">mkexp</text:span><text:span text:style-name="T47"> expects a dump generated by </text:span><text:span text:style-name="T9">getexp -vv</text:span><text:span text:style-name="T47"> (see below). The experiment setup is regenerated from this dump, overriding any model setup.</text:span></text:p>
- <text:p text:style-name="P221"><text:span text:style-name="T63">g</text:span><text:span text:style-name="T47">etexp [-v ...] </text:span><text:span text:style-name="T96">[-R]</text:span><text:span text:style-name="T47"> </text:span><text:span text:style-name="T9">file</text:span><text:span text:style-name="T47">.config [</text:span><text:span text:style-name="T9">name</text:span><text:span text:style-name="T47">=</text:span><text:span text:style-name="T9">value ...</text:span><text:span text:style-name="T47">]</text:span></text:p>
+ <text:p text:style-name="P220">With '-g' or '--getexp', instead of a .config file, <text:span text:style-name="T9">mkexp</text:span><text:span text:style-name="T47"> expects a dump generated by </text:span><text:span text:style-name="T9">getexp -vv</text:span><text:span text:style-name="T47"> (see below). The experiment setup is regenerated from this dump, overriding any model setup.</text:span></text:p>
+ <text:p text:style-name="P222"><text:span text:style-name="T63">g</text:span><text:span text:style-name="T47">etexp [-v ...] </text:span><text:span text:style-name="T96">[-R]</text:span><text:span text:style-name="T47"> </text:span><text:span text:style-name="T9">file</text:span><text:span text:style-name="T47">.config [</text:span><text:span text:style-name="T9">name</text:span><text:span text:style-name="T47">=</text:span><text:span text:style-name="T9">value ...</text:span><text:span text:style-name="T47">]</text:span></text:p>
<text:p text:style-name="P201">getexp<text:span text:style-name="T47"> reads the experiment setup the same way </text:span><text:span text:style-name="T85">as</text:span><text:span text:style-name="T47"> </text:span>mkexp<text:span text:style-name="T47">, but does not generate job scripts. Instead it prints the experiment name and directories to be generated in a shell-readable form. It is intended for debugging or passing setup information to utility scripts.</text:span></text:p>
<text:p text:style-name="P205"><text:span text:style-name="T47">When given the '-v' </text:span><text:span text:style-name="T96">or '--</text:span><text:span text:style-name="T47">verbose</text:span><text:span text:style-name="T96">'</text:span><text:span text:style-name="T47"> option, all </text:span><text:span text:style-name="T9">global</text:span><text:span text:style-name="T47"> configuration variables and their values are printed in alphabetical order. </text:span><text:span text:style-name="T96">When given twice, the whole configuration is dumped </text:span><text:span text:style-name="T101">to the screen</text:span><text:span text:style-name="T96">. </text:span><text:span text:style-name="T101">Save this to a file for use with </text:span><text:span text:style-name="T38">mkexp -g</text:span><text:span text:style-name="T101">.</text:span></text:p>
<text:p text:style-name="P192">When given the '-R' or '--readme' option, the header comment text is printed.</text:p>
- <text:p text:style-name="P233">diffexp <text:span text:style-name="T22">file</text:span><text:span text:style-name="T23">1</text:span><text:span text:style-name="T193">.config </text:span><text:span text:style-name="T22">file2</text:span><text:span text:style-name="T64">.</text:span><text:span text:style-name="T65">config</text:span></text:p>
+ <text:p text:style-name="P234">diffexp <text:span text:style-name="T22">file</text:span><text:span text:style-name="T23">1</text:span><text:span text:style-name="T193">.config </text:span><text:span text:style-name="T22">file2</text:span><text:span text:style-name="T64">.</text:span><text:span text:style-name="T65">config</text:span></text:p>
<text:p text:style-name="P189">For an easy comparison of the whole set of generated scripts for two different experiments, this tool takes the directories defined in each configuration, locates the job scripts corresponding to each other (e.g. exp0001.run and exp0002.run), equalizes all occurrences of the experiment name in the scripts and then uses the diff tool to show differences. The environment variable 'DIFF' may be set to an alternative tool to be called instead.</text:p>
- <text:p text:style-name="P222">rmexp <text:span text:style-name="T24">file</text:span><text:span text:style-name="T194">.config</text:span><text:span text:style-name="T66"> [</text:span><text:span text:style-name="T24">name</text:span><text:span text:style-name="T66">=</text:span><text:span text:style-name="T24">value ...</text:span><text:span text:style-name="T66">]</text:span></text:p>
+ <text:p text:style-name="P223">rmexp <text:span text:style-name="T24">file</text:span><text:span text:style-name="T194">.config</text:span><text:span text:style-name="T66"> [</text:span><text:span text:style-name="T24">name</text:span><text:span text:style-name="T66">=</text:span><text:span text:style-name="T24">value ...</text:span><text:span text:style-name="T66">]</text:span></text:p>
<text:p text:style-name="P207">This allows <text:span text:style-name="T197">interactive </text:span>remov<text:span text:style-name="T197">al for </text:span>all data of an experiment without having to deal with path names, as these are read from the configuration.</text:p>
- <text:p text:style-name="P234"><text:span text:style-name="T239">cp</text:span>exp <text:span text:style-name="T24">file</text:span><text:span text:style-name="T194">.config</text:span><text:span text:style-name="T66"> </text:span><text:span text:style-name="T37">new_name</text:span><text:span text:style-name="T97"> </text:span><text:span text:style-name="T66">[</text:span><text:span text:style-name="T24">name</text:span><text:span text:style-name="T66">=</text:span><text:span text:style-name="T24">value ...</text:span><text:span text:style-name="T66">]</text:span></text:p>
+ <text:p text:style-name="P235"><text:span text:style-name="T239">cp</text:span>exp <text:span text:style-name="T24">file</text:span><text:span text:style-name="T194">.config</text:span><text:span text:style-name="T66"> </text:span><text:span text:style-name="T37">new_name</text:span><text:span text:style-name="T97"> </text:span><text:span text:style-name="T66">[</text:span><text:span text:style-name="T24">name</text:span><text:span text:style-name="T66">=</text:span><text:span text:style-name="T24">value ...</text:span><text:span text:style-name="T66">]</text:span></text:p>
<text:p text:style-name="List_20_Contents"><text:span text:style-name="T240">Replicates all data </text:span>of an experiment <text:span text:style-name="T239">to a new experiment name; also updates text files by rewriting references to the old name</text:span>.</text:p>
- <text:h text:style-name="P269" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__2534_1114405012"/><text:span text:style-name="T150">F</text:span>ormat of .config files<text:bookmark-end text:name="__RefHeading__2534_1114405012"/></text:h>
+ <text:h text:style-name="P270" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__2534_1114405012"/><text:span text:style-name="T150">F</text:span>ormat of .config files<text:bookmark-end text:name="__RefHeading__2534_1114405012"/></text:h>
<text:p text:style-name="P15">The .config files are simple text files containing a dictionary of variables with their respective values. They may be structured using sections and comments. <text:span text:style-name="T145">For reading these files, </text:span><text:span text:style-name="T12">mkexp</text:span><text:span text:style-name="T145"> uses the </text:span><text:span text:style-name="T12">configobj</text:span><text:span text:style-name="T145"> Python library. All settings found in the .config files are handled as Python variables internally.</text:span></text:p>
<text:h text:style-name="Heading_20_3" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__1669_1438093122"/>Variables<text:bookmark-end text:name="__RefHeading__1669_1438093122"/></text:h>
<text:p text:style-name="P18">A <text:span text:style-name="T146">configuration variable is set by simply assigning a text value to a name, as in</text:span></text:p>
@@ -2427,7 +2424,7 @@
<text:h text:style-name="Heading_20_3" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2542_1114405012"/>Evaluation of interpolation<text:bookmark-end text:name="__RefHeading__2542_1114405012"/></text:h>
<text:p text:style-name="P76">While interpolation looks a lot like in shell scripts, there is a major difference: interpolation is – as in Makefiles – only evaluated when the final value is written or passed on. This has the advantage that the model setup may define settings based on variables that are only defined later in the user setup.</text:p>
<text:p text:style-name="P154"># model setup</text:p>
- <text:p text:style-name="P235"><text:span text:style-name="T204">MODEL</text:span>_<text:span text:style-name="T204">DIR</text:span> = $HOME/<text:span text:style-name="T204">$MODEL_SUBDIR</text:span></text:p>
+ <text:p text:style-name="P236"><text:span text:style-name="T204">MODEL</text:span>_<text:span text:style-name="T204">DIR</text:span> = $HOME/<text:span text:style-name="T204">$MODEL_SUBDIR</text:span></text:p>
<text:p text:style-name="P155"><text:soft-page-break/># user setup</text:p>
<text:p text:style-name="P155">MODEL_SUBDIR = echam</text:p>
<text:p text:style-name="P77">Here, as the model setup is read before the user setup, 'MODEL_SUBDIR' is not set when 'MODEL_ROOT' is defined. <text:span text:style-name="T205">This works, because i</text:span>nterpolation of 'MODEL_ROOT's value is postponed until all levels of setup have been read.</text:p>
@@ -2437,20 +2434,20 @@
<text:p text:style-name="Preformatted_20_Text">Oops: interpolation loop detected in value "SUBMODELS" while reading key 'SUBMODELS'</text:p>
<text:h text:style-name="Heading_20_3" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2544_1114405012"/>Special expressions<text:bookmark-end text:name="__RefHeading__2544_1114405012"/></text:h>
<text:p text:style-name="P79">For some applications, simply including some other variable is not enough. You might want to compute a time limit from a given constant divided by the number of computing nodes, or convert a time stamp to a list of values. For these purposes, <text:span text:style-name="T9">mkexp</text:span><text:span text:style-name="T47"> includes some special expressions, that are evaluated when interpolation occurs.</text:span></text:p>
- <text:p text:style-name="P223"><text:span text:style-name="T9">variable</text:span><text:span text:style-name="T47"> = </text:span><text:span text:style-name="T125">eval(</text:span><text:span text:style-name="T9">expression</text:span><text:span text:style-name="T125">)</text:span><text:span text:style-name="T47"><text:line-break/></text:span><text:span text:style-name="T9">variable</text:span><text:span text:style-name="T47"> = </text:span><text:span text:style-name="T125">evals(</text:span><text:span text:style-name="T9">expression</text:span><text:span text:style-name="T125">)</text:span></text:p>
+ <text:p text:style-name="P224"><text:span text:style-name="T9">variable</text:span><text:span text:style-name="T47"> = </text:span><text:span text:style-name="T125">eval(</text:span><text:span text:style-name="T9">expression</text:span><text:span text:style-name="T125">)</text:span><text:span text:style-name="T47"><text:line-break/></text:span><text:span text:style-name="T9">variable</text:span><text:span text:style-name="T47"> = </text:span><text:span text:style-name="T125">evals(</text:span><text:span text:style-name="T9">expression</text:span><text:span text:style-name="T125">)</text:span></text:p>
<text:p text:style-name="P208"><text:span text:style-name="T77">I</text:span><text:span text:style-name="T47">nterpret </text:span><text:span text:style-name="T9">expression</text:span><text:span text:style-name="T47"> as a valid Python expression and assign the result to </text:span><text:span text:style-name="T9">variable</text:span><text:span text:style-name="T47"> as a string. When the result is a list, </text:span><text:span text:style-name="T9">eval</text:span><text:span text:style-name="T47"> will return a list of strings, while </text:span><text:span text:style-name="T9">evals</text:span><text:span text:style-name="T47"> will return a single string, where elements are joined by a comma and a space.</text:span></text:p>
<text:p text:style-name="P208"><text:span text:style-name="T47">Note that interpolation does not work for list values; if you need this, consider to set the original variable </text:span><text:span text:style-name="T74">to a string containing a Python list expression</text:span><text:span text:style-name="T47">, and </text:span><text:span text:style-name="T74">then </text:span><text:span text:style-name="T47">use </text:span><text:span text:style-name="T9">eval</text:span><text:span text:style-name="T47"> </text:span><text:span text:style-name="T87">a</text:span><text:span text:style-name="T47">round the interpolation expression:</text:span></text:p>
- <text:p text:style-name="P236">DATE_<text:span text:style-name="T213">STRING</text:span> = '[2010, 10, 20]' # need quotes here!</text:p>
- <text:p text:style-name="P236">DATE_<text:span text:style-name="T213">LIST</text:span> = eval($DATE_<text:span text:style-name="T214">STRING</text:span>) # becomes a 3 element list</text:p>
- <text:p text:style-name="P224">variable<text:span text:style-name="T47"> = </text:span><text:span text:style-name="T125">read(</text:span>file_name<text:span text:style-name="T125">)</text:span></text:p>
+ <text:p text:style-name="P237">DATE_<text:span text:style-name="T213">STRING</text:span> = '[2010, 10, 20]' # need quotes here!</text:p>
+ <text:p text:style-name="P237">DATE_<text:span text:style-name="T213">LIST</text:span> = eval($DATE_<text:span text:style-name="T214">STRING</text:span>) # becomes a 3 element list</text:p>
+ <text:p text:style-name="P225">variable<text:span text:style-name="T47"> = </text:span><text:span text:style-name="T125">read(</text:span>file_name<text:span text:style-name="T125">)</text:span></text:p>
<text:p text:style-name="P202"><text:span text:style-name="T47">Read the contents of the file </text:span>file_name<text:span text:style-name="T47"> and assign its contents to </text:span>variable<text:span text:style-name="T47"> as a string.</text:span></text:p>
- <text:p text:style-name="P225"><text:span text:style-name="T27">variable</text:span><text:span text:style-name="T75"> = </text:span><text:span text:style-name="T127">split_date(</text:span><text:span text:style-name="T27">timestamp</text:span><text:span text:style-name="T127">)</text:span></text:p>
+ <text:p text:style-name="P226"><text:span text:style-name="T27">variable</text:span><text:span text:style-name="T75"> = </text:span><text:span text:style-name="T127">split_date(</text:span><text:span text:style-name="T27">timestamp</text:span><text:span text:style-name="T127">)</text:span></text:p>
<text:p text:style-name="P209"><text:span text:style-name="T206">T</text:span>ake <text:span text:style-name="T9">timestamp</text:span><text:span text:style-name="T47"> and split it into a list of numerical date/time elements. </text:span><text:span text:style-name="T9">tim</text:span><text:span text:style-name="T28">e</text:span><text:span text:style-name="T9">stamp</text:span><text:span text:style-name="T47"> </text:span><text:span text:style-name="T76">must have </text:span><text:span text:style-name="T47">an ISO-like format (date elements separated by '-'; 'T' or </text:span><text:soft-page-break/><text:span text:style-name="T47">space as date/time separator; time elements separated by ':</text:span><text:span text:style-name="T76">'; </text:span><text:span text:style-name="T47">trailing time elements </text:span><text:span text:style-name="T77">and their separators </text:span><text:span text:style-name="T76">are optional</text:span><text:span text:style-name="T47">; time zone indicator is not supported). </text:span><text:span text:style-name="T89">Unlike ISO, </text:span><text:span text:style-name="T31">split_date</text:span><text:span text:style-name="T89"> also</text:span><text:span text:style-name="T47"> </text:span><text:span text:style-name="T89">allows the date to be in the form YYYYMMDD</text:span><text:span text:style-name="T47">. </text:span><text:span text:style-name="T77">Unset fields default to zero.</text:span></text:p>
- <text:p text:style-name="P226"><text:span text:style-name="T9">variable</text:span><text:span text:style-name="T47"> = </text:span><text:span text:style-name="T125">sec2time(</text:span><text:span text:style-name="T9">second_of_day</text:span><text:span text:style-name="T125">)</text:span></text:p>
+ <text:p text:style-name="P227"><text:span text:style-name="T9">variable</text:span><text:span text:style-name="T47"> = </text:span><text:span text:style-name="T125">sec2time(</text:span><text:span text:style-name="T9">second_of_day</text:span><text:span text:style-name="T125">)</text:span></text:p>
<text:p text:style-name="P194">Take integer <text:span text:style-name="T9">second_of_day</text:span> (from 0 to 86399) and return the corresponding time stamp as string of the form HH:MM:SS.</text:p>
- <text:p text:style-name="P227"><text:span text:style-name="T9">variable</text:span> = '<text:span text:style-name="T131">add_years</text:span>(<text:span text:style-name="T9">datestamp</text:span>, <text:span text:style-name="T9">offset</text:span>)'</text:p>
+ <text:p text:style-name="P228"><text:span text:style-name="T9">variable</text:span> = '<text:span text:style-name="T131">add_years</text:span>(<text:span text:style-name="T9">datestamp</text:span>, <text:span text:style-name="T9">offset</text:span>)'</text:p>
<text:p text:style-name="P210">Take integer <text:span text:style-name="T9">offset</text:span><text:span text:style-name="T47"> (may be negative), add it to the year portion of </text:span><text:span text:style-name="T9">datestamp</text:span><text:span text:style-name="T47"> and return the resulting date string.</text:span></text:p>
- <text:p text:style-name="P228"><text:span text:style-name="T9">variable</text:span> = '<text:span text:style-name="T131">add_</text:span><text:span text:style-name="T139">days</text:span>(<text:span text:style-name="T9">datestamp</text:span>, <text:span text:style-name="T9">offset</text:span>)'</text:p>
+ <text:p text:style-name="P229"><text:span text:style-name="T9">variable</text:span> = '<text:span text:style-name="T131">add_</text:span><text:span text:style-name="T139">days</text:span>(<text:span text:style-name="T9">datestamp</text:span>, <text:span text:style-name="T9">offset</text:span>)'</text:p>
<text:p text:style-name="P211"><text:span text:style-name="T47">Take integer </text:span><text:span text:style-name="T9">offset</text:span><text:span text:style-name="T47"> (may be negative), add it to the </text:span><text:span text:style-name="T90">day</text:span><text:span text:style-name="T47"> portion of </text:span><text:span text:style-name="T9">datestamp</text:span><text:span text:style-name="T47"> and return the resulting date string. </text:span><text:span text:style-name="T90">Year and month portions will be set as appropriate, assuming a Proleptic Gregorian calendar with year 0.</text:span></text:p>
<text:h text:style-name="Heading_20_2" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__2546_1114405012"/>Format of .tmpl files<text:bookmark-end text:name="__RefHeading__2546_1114405012"/></text:h>
<text:p text:style-name="P24">The .tmpl files are also text files mostly written in the syntax of the job description that <text:span text:style-name="T9">mkexp</text:span> is meant to create. Currently this is usually the ksh or bash shell script syntax, but may also be any other interpreted language, like Perl or Python, or even a configuration or namelist file. The main difference are placeholders and structured comments that are embedded in the program text. These are evaluated or expanded using the information that comes with the .config files, to create the final text files, defining the jobs to be run on the target system.</text:p>
@@ -2482,28 +2479,28 @@
<text:p text:style-name="P122">LIST_SUBLIST=%{PATH[1:3]}</text:p>
<text:p text:style-name="Preformatted_20_Text">FILTERED_STRING=%{NAME | <text:span text:style-name="T155">lower()} <text:s/># is 'joe user'</text:span></text:p>
<text:p text:style-name="P92">The last example allows for <text:span text:style-name="T167">a </text:span>number of predefined filters instead of 'lower'. These are described in the <text:span text:style-name="T9">Jinja</text:span> documentation (List of Builtin Filters). <text:span text:style-name="T229">Besides, </text:span><text:span text:style-name="T9">mkexp</text:span> defines <text:s/><text:span text:style-name="T232">a number of </text:span>additional filters:</text:p>
- <text:p text:style-name="P229">split<text:span text:style-name="T161">(</text:span><text:span text:style-name="T42">s</text:span><text:span text:style-name="T128">, </text:span><text:span text:style-name="T42">m</text:span><text:span text:style-name="T128">=-1)</text:span></text:p>
+ <text:p text:style-name="P230">split<text:span text:style-name="T161">(</text:span><text:span text:style-name="T42">s</text:span><text:span text:style-name="T128">, </text:span><text:span text:style-name="T42">m</text:span><text:span text:style-name="T128">=-1)</text:span></text:p>
<text:p text:style-name="P195">cuts <text:span text:style-name="T231">the input </text:span>string <text:span text:style-name="T231">at all occurrences of </text:span><text:span text:style-name="T34">s</text:span><text:span text:style-name="T231">, returning</text:span> a list of substrings. <text:span text:style-name="T230">If </text:span><text:span text:style-name="T33">m</text:span><text:span text:style-name="T230"> is positive or zero, it cuts only at the first </text:span><text:span text:style-name="T33">m</text:span><text:span text:style-name="T230"> occurrences; the last element contains the remaining substring:</text:span></text:p>
<text:p text:style-name="Preformatted_20_Text_20_Indented">%{ 'A B C' | <text:span text:style-name="T131">split</text:span><text:span text:style-name="T161">(' ') }<text:tab/><text:tab/>→</text:span><text:span text:style-name="T164"> </text:span><text:span text:style-name="T163">['A', 'B', 'C']</text:span></text:p>
- <text:p text:style-name="P239"><text:span text:style-name="T163">%{ 'A B C' | split(' ', </text:span><text:span text:style-name="T141">1</text:span><text:span text:style-name="T163">) } <text:tab/></text:span><text:span text:style-name="T164">→ </text:span><text:span text:style-name="T163">['A', </text:span><text:span text:style-name="T141">'B C'</text:span><text:span text:style-name="T163">]</text:span></text:p>
+ <text:p text:style-name="P240"><text:span text:style-name="T163">%{ 'A B C' | split(' ', </text:span><text:span text:style-name="T141">1</text:span><text:span text:style-name="T163">) } <text:tab/></text:span><text:span text:style-name="T164">→ </text:span><text:span text:style-name="T163">['A', </text:span><text:span text:style-name="T141">'B C'</text:span><text:span text:style-name="T163">]</text:span></text:p>
<text:p text:style-name="P213"/>
<text:p text:style-name="P116"><text:soft-page-break/>filter<text:span text:style-name="T161">()</text:span></text:p>
<text:p text:style-name="P214">removes empty elements from <text:span text:style-name="T231">the input</text:span> list:</text:p>
- <text:p text:style-name="P240"><text:span text:style-name="T163">%{ ['A', '', 'C'] | </text:span><text:span text:style-name="T141">filter</text:span><text:span text:style-name="T163">() }<text:tab/>→</text:span><text:span text:style-name="T161"> ['A', 'C']</text:span></text:p>
- <text:p text:style-name="P230">match<text:span text:style-name="T161">(</text:span><text:span text:style-name="T42">regexp</text:span><text:span text:style-name="T161">, </text:span><text:span text:style-name="T42">default</text:span><text:span text:style-name="T161">='')</text:span></text:p>
+ <text:p text:style-name="P241"><text:span text:style-name="T163">%{ ['A', '', 'C'] | </text:span><text:span text:style-name="T141">filter</text:span><text:span text:style-name="T163">() }<text:tab/>→</text:span><text:span text:style-name="T161"> ['A', 'C']</text:span></text:p>
+ <text:p text:style-name="P231">match<text:span text:style-name="T161">(</text:span><text:span text:style-name="T42">regexp</text:span><text:span text:style-name="T161">, </text:span><text:span text:style-name="T42">default</text:span><text:span text:style-name="T161">='')</text:span></text:p>
<text:p text:style-name="P215"><text:span text:style-name="T161">returns the input string</text:span><text:span text:style-name="T128">, if </text:span><text:span text:style-name="T42">regexp</text:span><text:span text:style-name="T128"> matches somewhere in it. If </text:span><text:span text:style-name="T42">regexp</text:span><text:span text:style-name="T128"> contains matching groups (parentheses), the substring matching the first group is returned. If no match is found, the </text:span><text:span text:style-name="T42">default</text:span><text:span text:style-name="T128"> string is returned:</text:span></text:p>
- <text:p text:style-name="P240"><text:span text:style-name="T128">%{ 'Douglas Adams' | </text:span><text:span text:style-name="T125">match</text:span><text:span text:style-name="T128">('Adam') }<text:tab/><text:tab/>→ 'Douglas Adams'</text:span></text:p>
- <text:p text:style-name="P240"><text:span text:style-name="T128">%{ 'Douglas Adams' | match(</text:span><text:span text:style-name="T125">'Eve'</text:span><text:span text:style-name="T128">) }<text:tab/><text:tab/>→ ''</text:span></text:p>
- <text:p text:style-name="P240"><text:span text:style-name="T128">%{ 'Douglas Adams' | match('Abel', </text:span><text:span text:style-name="T125">'Cain'</text:span><text:span text:style-name="T128">) }<text:tab/>→ 'Cain'</text:span></text:p>
- <text:p text:style-name="P240"><text:span text:style-name="T128">%{ 'Douglas Adams' | match('l</text:span><text:span text:style-name="T125">(.*)</text:span><text:span text:style-name="T128">m') }<text:tab/><text:tab/>→ 'as Ada'</text:span></text:p>
- <text:p text:style-name="P232"><text:span text:style-name="T125">wordwrap</text:span><text:span text:style-name="T128">(width=79, break_long_words=true, break_on_hyphens=true, <text:s text:c="2"/><text:line-break/> <text:s text:c="8"/>wrapstring=none)</text:span></text:p>
+ <text:p text:style-name="P241"><text:span text:style-name="T128">%{ 'Douglas Adams' | </text:span><text:span text:style-name="T125">match</text:span><text:span text:style-name="T128">('Adam') }<text:tab/><text:tab/>→ 'Douglas Adams'</text:span></text:p>
+ <text:p text:style-name="P241"><text:span text:style-name="T128">%{ 'Douglas Adams' | match(</text:span><text:span text:style-name="T125">'Eve'</text:span><text:span text:style-name="T128">) }<text:tab/><text:tab/>→ ''</text:span></text:p>
+ <text:p text:style-name="P241"><text:span text:style-name="T128">%{ 'Douglas Adams' | match('Abel', </text:span><text:span text:style-name="T125">'Cain'</text:span><text:span text:style-name="T128">) }<text:tab/>→ 'Cain'</text:span></text:p>
+ <text:p text:style-name="P241"><text:span text:style-name="T128">%{ 'Douglas Adams' | match('l</text:span><text:span text:style-name="T125">(.*)</text:span><text:span text:style-name="T128">m') }<text:tab/><text:tab/>→ 'as Ada'</text:span></text:p>
+ <text:p text:style-name="P233"><text:span text:style-name="T125">wordwrap</text:span><text:span text:style-name="T128">(width=79, break_long_words=true, break_on_hyphens=true, <text:s text:c="2"/><text:line-break/> <text:s text:c="8"/>wrapstring=none)</text:span></text:p>
<text:p text:style-name="P217"><text:span text:style-name="T128">replaces the </text:span><text:span text:style-name="T129">builtin </text:span><text:span text:style-name="T43">Jinja </text:span><text:span text:style-name="T129">filter 'wordwrap' <text:s/>by a private version that allows to suppress breaks on hyphens:</text:span></text:p>
- <text:p text:style-name="P237">%{'long-hyphenated-text'|<text:span text:style-name="T131">wordwrap</text:span>(15, false)}</text:p>
- <text:p text:style-name="P241"><text:span text:style-name="T129">→</text:span><text:span text:style-name="T128"> 'long- </text:span></text:p>
- <text:p text:style-name="P238"><text:s text:c="3"/>hyphenated-text'</text:p>
- <text:p text:style-name="P241"/>
- <text:p text:style-name="P237">%{'long-hyphenated-text'|wordwrap(15, false, <text:span text:style-name="T131">false</text:span>)} </text:p>
- <text:p text:style-name="P241"><text:span text:style-name="T129">→</text:span><text:span text:style-name="T128"> 'long-</text:span><text:span text:style-name="T129">hyphenated-text'</text:span></text:p>
+ <text:p text:style-name="P238">%{'long-hyphenated-text'|<text:span text:style-name="T131">wordwrap</text:span>(15, false)}</text:p>
+ <text:p text:style-name="P242"><text:span text:style-name="T129">→</text:span><text:span text:style-name="T128"> 'long- </text:span></text:p>
+ <text:p text:style-name="P239"><text:s text:c="3"/>hyphenated-text'</text:p>
+ <text:p text:style-name="P242"/>
+ <text:p text:style-name="P238">%{'long-hyphenated-text'|wordwrap(15, false, <text:span text:style-name="T131">false</text:span>)} </text:p>
+ <text:p text:style-name="P242"><text:span text:style-name="T129">→</text:span><text:span text:style-name="T128"> 'long-</text:span><text:span text:style-name="T129">hyphenated-text'</text:span></text:p>
<text:h text:style-name="Heading_20_3" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2554_1114405012"/>Loops<text:bookmark-end text:name="__RefHeading__2554_1114405012"/></text:h>
<text:p text:style-name="P28">Text in a template may be used repeatedly, like a classical 'for' loop. Loops are defined by structured comments <text:span text:style-name="T215">i.e. lines </text:span>beginning with '#%'. <text:span text:style-name="T215">They </text:span>start with '#% for … <text:span text:style-name="T158">in …:</text:span>' and end in '#% endfor':</text:p>
<text:p text:style-name="Preformatted_20_Text"><text:span text:style-name="T131">#% for</text:span> countdown <text:span text:style-name="T131">in</text:span> [3, 2, 1, '<text:span text:style-name="T215">liftoff</text:span>']<text:span text:style-name="T131">:</text:span></text:p>
@@ -2547,10 +2544,10 @@
<text:p text:style-name="P11">Besides the standard experiment types, <text:span text:style-name="T9">mkexp</text:span> also supports option sets that are independent of the experiment type chosen.</text:p>
<text:p text:style-name="P11">Usually these option sets contain a number of settings needed for a certain technical aspect, e.g. for changing the output interval or aggregation method for output data, or providing resolution dependent model settings. They reside in a subdirectory 'standard_options' of the current working directory, each in their respective <text:span text:style-name="T9">optionname</text:span>.config file.</text:p>
<text:p text:style-name="P11">Within the experiment's .config file, options are selected by setting the variable EXP_OPTIONS to the list of required option names. These settings are loaded after the experiment type configuration but before the user defined experiment configuration.</text:p>
- <text:h text:style-name="P263" text:outline-level="3"><text:soft-page-break/><text:span text:style-name="T236">O</text:span>ptions set due to model configuration </text:h>
+ <text:h text:style-name="P264" text:outline-level="3"><text:soft-page-break/><text:span text:style-name="T236">O</text:span>ptions set due to model configuration </text:h>
<text:p text:style-name="P93">Some options may need to be set <text:span text:style-name="T235">for all experiments that use a given </text:span>model configuration. <text:span text:style-name="T235">If e.g. a part of the model is disabled at build time, the corresponding option set should also be disabled for all experiments.</text:span></text:p>
<text:p text:style-name="P94">For this, the build process may write an optional file 'SETUP.config' <text:s/>that is read before any type or user configuration. If this file contains the variable SETUP_OPTIONS, the options listed there will be loaded before loading the EXP_OPTIONS list. Do not override SETUP_OPTIONS in the user configuration unless you know what you are doing!</text:p>
- <text:h text:style-name="P270" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__1508_1711940803"/>Generating <text:span text:style-name="T183">j</text:span>obs<text:bookmark-end text:name="__RefHeading__1508_1711940803"/></text:h>
+ <text:h text:style-name="P271" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__1508_1711940803"/>Generating <text:span text:style-name="T183">j</text:span>obs<text:bookmark-end text:name="__RefHeading__1508_1711940803"/></text:h>
<text:p text:style-name="P42">When<text:span text:style-name="T171"> </text:span>running <text:span text:style-name="T9">mkexp</text:span><text:span text:style-name="T102">, </text:span><text:span text:style-name="T103">the special configuration section [jobs]</text:span><text:span text:style-name="T40"> </text:span><text:span text:style-name="T103">is read and evaluated. Each of its subsections, e.g. [[run]], defines a job definition file or job script to be created.</text:span></text:p>
<text:p text:style-name="P138"># <text:span text:style-name="T172">model setup: experiment type 'control'</text:span></text:p>
<text:p text:style-name="P125">[jobs]</text:p>
@@ -2574,7 +2571,7 @@
<text:p text:style-name="P139"><text:span text:style-name="T102"><text:s text:c="4"/>.</text:span><text:span text:style-name="T106">extends</text:span><text:span text:style-name="T102"> = p</text:span><text:span text:style-name="T107">ost</text:span></text:p>
<text:p text:style-name="P126"><text:s text:c="4"/>command = $HOME/bin/my_special_command</text:p>
<text:p text:style-name="P50">With this configuration, an additional 'joe1234.my_post' is created based on the existing 'post' template. A dedicated 'joe1234.my_post.tmpl' file is not needed here. The 'command' setting is <text:span text:style-name="T174">made available </text:span>to <text:span text:style-name="T174">the template via the</text:span> 'JOB' dictionary.</text:p>
- <text:h text:style-name="P254" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2568_1114405012"/>Pre-defined job variables<text:bookmark-end text:name="__RefHeading__2568_1114405012"/></text:h>
+ <text:h text:style-name="P255" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2568_1114405012"/>Pre-defined job variables<text:bookmark-end text:name="__RefHeading__2568_1114405012"/></text:h>
<text:p text:style-name="P55">While <text:span text:style-name="T9">mkexp</text:span> in general does not impose any naming convention on the variable names used in the job sections and leaves the details to the respective model setup, there are a few exceptions.</text:p>
<text:p text:style-name="P174">tasks</text:p>
<text:p text:style-name="P196">The total number of parallel (MPI) tasks that will be started when running the model. If a job section does not define 'tasks', its value defaults to 'nodes' times 'tasks_per_node'. Some models require that 'tasks' may explicitly be set to some artificial value to trigger the testing mode.</text:p>
@@ -2582,7 +2579,7 @@
<text:p text:style-name="P196">Number of computing nodes required on the computing system. Needed if 'tasks' is not set.</text:p>
<text:p text:style-name="P175">tasks_per_node</text:p>
<text:p text:style-name="P196">Number of parallel (MPI) tasks on a single node. Needed if 'tasks' is not set.</text:p>
- <text:h text:style-name="P253" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2570_1114405012"/>Overriding namelist settings in derived jobs<text:bookmark-end text:name="__RefHeading__2570_1114405012"/></text:h>
+ <text:h text:style-name="P254" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2570_1114405012"/>Overriding namelist settings in derived jobs<text:bookmark-end text:name="__RefHeading__2570_1114405012"/></text:h>
<text:p text:style-name="P50">There is special provision to change namelist files settings for a specific job. Consider this setting from the introductory example.</text:p>
<text:p text:style-name="P140"><text:soft-page-break/>[namelists]</text:p>
<text:p text:style-name="P100"><text:s text:c="2"/>[[namelist.jsbach]]</text:p>
@@ -2597,7 +2594,7 @@
<text:p text:style-name="P100"><text:s text:c="8"/><text:span text:style-name="T173">[[</text:span>[[[jsbach_ctl]]]<text:span text:style-name="T173">]]</text:span></text:p>
<text:p text:style-name="P100"><text:span text:style-name="T102"><text:s text:c="10"/>use_dynveg = </text:span><text:span text:style-name="T107">true</text:span></text:p>
<text:p text:style-name="P46"><text:span text:style-name="T108">This</text:span><text:span text:style-name="T102"> will result in a 'joe1234.run_first' file that is identical to 'joe1234.run' except for the 'use_dynveg' setting.</text:span></text:p>
- <text:h text:style-name="P253" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2572_1114405012"/>Native script variables<text:bookmark-end text:name="__RefHeading__2572_1114405012"/></text:h>
+ <text:h text:style-name="P254" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2572_1114405012"/>Native script variables<text:bookmark-end text:name="__RefHeading__2572_1114405012"/></text:h>
<text:p text:style-name="P48"><text:span text:style-name="T102">While the definition of .config variables may use</text:span><text:span text:style-name="T109"> variable references like</text:span><text:span text:style-name="T102"> $NAME or ${NAME} to include the </text:span><text:span text:style-name="T109">verbatim </text:span><text:span text:style-name="T102">value of other .config variables, this may not always be what you want. If you want to create a job </text:span><text:span text:style-name="T109">script</text:span><text:span text:style-name="T102"> that is supposed to be 'user-serviceable' for certain applications, the users will not appreciate having to change the same value several times in the same script. </text:span><text:span text:style-name="T109">Instead they will want to have a single, native script variable that is used throughout the job script, and that may be re-defined on a single line.</text:span></text:p>
<text:p text:style-name="P52">To allow this, <text:span text:style-name="T9">mkexp</text:span> locates all expressions like $${NAME} in the configuration values, and re-formats them to the syntax of the current job script:</text:p>
<text:p text:style-name="P125"># joe1234.config</text:p>
@@ -2626,7 +2623,7 @@
<text:p text:style-name="P143">#! /usr/bin/env python </text:p>
<text:p text:style-name="P143">NAME = '<text:span text:style-name="T180">Joe User</text:span>' </text:p>
<text:p text:style-name="P144">print<text:span text:style-name="T217">(</text:span>'<text:span text:style-name="T102">This experiment was generated by </text:span><text:span text:style-name="T111">' + str(</text:span><text:span text:style-name="T102">NAME) </text:span><text:span text:style-name="T111">+ '</text:span>'<text:span text:style-name="T217">)</text:span></text:p>
- <text:h text:style-name="P260" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2574_1114405012"/>Initializing native script variables<text:bookmark-end text:name="__RefHeading__2574_1114405012"/></text:h>
+ <text:h text:style-name="P261" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2574_1114405012"/>Initializing native script variables<text:bookmark-end text:name="__RefHeading__2574_1114405012"/></text:h>
<text:p text:style-name="P61">In the previous section, the native variables were initialized by an addition<text:span text:style-name="T184">al script line. While this is sufficient for a small number of variables, it may be difficult to maintain these initialization lines for a more complex setup with changing requirements.</text:span></text:p>
<text:p text:style-name="P61"><text:span text:style-name="T185">To allow a self-maintaining variable list based on the current configuration, </text:span><text:span text:style-name="T20">mkexp</text:span><text:span text:style-name="T185"> maintains the special variable VARIABLES_. When generating output for</text:span></text:p>
<text:p text:style-name="P132">NAME = Joe User</text:p>
@@ -2656,7 +2653,7 @@
<text:p text:style-name="P13">For this, a standard environment, like a standard experiment, consists of a .config file and a corresponding template. The <text:span text:style-name="T9">environmentname</text:span>.config file contains settings like directory paths or a description of machine capacities for job control</text:p>
<text:p text:style-name="P13">The actual job control headers needed to run a certain job step are saved as <text:span text:style-name="T9">environmentname</text:span>.tmpl. This template will be filled using configuration information from both experiment, options, and environment. <text:span text:style-name="T144">The resulting job header</text:span> is usually included at the beginning of the experiment's job script templates.</text:p>
<text:p text:style-name="P9">An experiment configuration <text:span text:style-name="T186">may</text:span> <text:span text:style-name="T186">set</text:span> the special variable E<text:span text:style-name="T186">NVIRONMENT</text:span> to the name of <text:span text:style-name="T186">the host </text:span>e<text:span text:style-name="T186">nvironment</text:span> to use. <text:span text:style-name="T186">If it is not set, or empty, the 'DEFAULT' environment settings will be used.</text:span></text:p>
- <text:h text:style-name="P271" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__1883_1672291846"/>Defining namelists and other configuration files<text:bookmark-end text:name="__RefHeading__1883_1672291846"/></text:h>
+ <text:h text:style-name="P272" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__1883_1672291846"/>Defining namelists and other configuration files<text:bookmark-end text:name="__RefHeading__1883_1672291846"/></text:h>
<text:p text:style-name="P69"><text:span text:style-name="T69">Most models need at least one Fortran namelist file or another form of configuration file to run. </text:span><text:span text:style-name="T70">The special section [namelists] </text:span><text:span text:style-name="T69">is designed to </text:span><text:span text:style-name="T70">contain all information that goes into </text:span><text:span text:style-name="T69">these</text:span><text:span text:style-name="T70"> files. Each </text:span><text:span text:style-name="T67">immediate </text:span><text:span text:style-name="T70">subsection defines settings for a single file that will </text:span><text:span text:style-name="T69">by default be </text:span><text:span text:style-name="T70">formatted as a Fortran namelist. </text:span><text:span text:style-name="T69">For </text:span><text:span text:style-name="T70">example,</text:span></text:p>
<text:p text:style-name="P146">[namelists]</text:p>
<text:p text:style-name="P156"/>
@@ -2668,7 +2665,7 @@
<text:p text:style-name="P148"><text:s text:c="6"/>out_expname = joe1234</text:p>
<text:p text:style-name="P148"><text:s text:c="6"/><text:span text:style-name="T199">dt_stop = 2009, 1, 1, 0, 0, 0</text:span></text:p>
<text:p text:style-name="P66"><text:span text:style-name="T47">defines </text:span><text:span text:style-name="T68">a single </text:span><text:span text:style-name="T47">namelist file, </text:span><text:span text:style-name="T71">'namelist.echam'</text:span><text:span text:style-name="T47">, </text:span><text:span text:style-name="T69">containing a single namelist group with four variables of different types. Note </text:span><text:span text:style-name="T88">that you do not </text:span><text:span text:style-name="T69">need to use quotes for strings nor periods for logical values.</text:span></text:p>
- <text:h text:style-name="P256" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2578_1114405012"/>Formatting the namelist information<text:bookmark-end text:name="__RefHeading__2578_1114405012"/></text:h>
+ <text:h text:style-name="P257" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2578_1114405012"/>Formatting the namelist information<text:bookmark-end text:name="__RefHeading__2578_1114405012"/></text:h>
<text:p text:style-name="P71"><text:span text:style-name="T67">The </text:span><text:span text:style-name="T68">names of the </text:span><text:span text:style-name="T67">subsections of each namelist file entry, i.e. the second level subsections under the immediate subsections of [namelists], are taken as namelist group </text:span><text:span text:style-name="T68">name</text:span><text:span text:style-name="T67">s, and their variables are formatted as fields of this namelist </text:span><text:span text:style-name="T68">group</text:span><text:span text:style-name="T67">. </text:span><text:span text:style-name="T68">In the example above, there is a single namelist group 'runctl', which will be converted to the Fortran namelist convention. </text:span><text:span text:style-name="T198">The values of the group's fields are checked to determine whether they are numerical, logical, or string values. Logical and string values will then be formatted using periods or quotes, respectively.</text:span></text:p>
<text:p text:style-name="P71"><text:span text:style-name="T218">In the example above, the first four fields are single values of logical, integer, floating </text:span><text:soft-page-break/><text:span text:style-name="T218">point, and string type.</text:span><text:span text:style-name="T71"> The fifth is a list of integer values, that will be passed as such to the namelist file:</text:span></text:p>
<text:p text:style-name="P115">&runctl</text:p>
@@ -2678,11 +2675,11 @@
<text:p text:style-name="P149"><text:s text:c="4"/>out_expname = <text:span text:style-name="T137">'</text:span><text:span text:style-name="T131">joe1234</text:span><text:span text:style-name="T137">'</text:span></text:p>
<text:p text:style-name="P149"><text:span text:style-name="T71"><text:s text:c="4"/>dt_stop = </text:span><text:span text:style-name="T126">2009, 1, 1, 0, 0, 0</text:span></text:p>
<text:p text:style-name="P134">/</text:p>
- <text:h text:style-name="P261" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2580_1114405012"/><text:span text:style-name="T69">S</text:span><text:span text:style-name="T47">uppressing namelist groups or variables</text:span><text:bookmark-end text:name="__RefHeading__2580_1114405012"/></text:h>
+ <text:h text:style-name="P262" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2580_1114405012"/><text:span text:style-name="T69">S</text:span><text:span text:style-name="T47">uppressing namelist groups or variables</text:span><text:bookmark-end text:name="__RefHeading__2580_1114405012"/></text:h>
<text:p text:style-name="P56">Both the namelist file sections and the namelist group section honor the special variable '.remove' which may be set to a list of names. Any namelist groups listed in the file's '.remove' variable, and any variables listed in the group's '.remove' variable will be deleted from the namelist definition.</text:p>
<text:p text:style-name="P56">The names may contain the usual file wildcards, '*' and '?' to remove a whole range of groups or variables.</text:p>
<text:p text:style-name="P80"><text:span text:style-name="T47">While '.remove' is useful to </text:span><text:span text:style-name="T78">suppress</text:span><text:span text:style-name="T47"> default settings that must not be present for the experiment setup, currently there is no way to resurrect a removed setting in a later setup level. </text:span><text:span text:style-name="T79">Therefore, its use in model setups is strongly discouraged.</text:span></text:p>
- <text:h text:style-name="P257" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2714_1114405012"/>Using the namelist text<text:bookmark-end text:name="__RefHeading__2714_1114405012"/></text:h>
+ <text:h text:style-name="P258" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2714_1114405012"/>Using the namelist text<text:bookmark-end text:name="__RefHeading__2714_1114405012"/></text:h>
<text:p text:style-name="P67"><text:span text:style-name="T69">T</text:span><text:span text:style-name="T71">he </text:span><text:span text:style-name="T60">formatted namelist text </text:span><text:span text:style-name="T47">is </text:span><text:span text:style-name="T71">stor</text:span><text:span text:style-name="T47">ed </text:span><text:span text:style-name="T71">in</text:span><text:span text:style-name="T47"> a global variable </text:span><text:span text:style-name="T71">that may be used by a template placeholder</text:span><text:span text:style-name="T47">. </text:span><text:span text:style-name="T69">This way, </text:span><text:span text:style-name="T47">all job information </text:span><text:span text:style-name="T71">available </text:span><text:span text:style-name="T69">is written to</text:span><text:span text:style-name="T47"> a single script or description file, </text:span><text:span text:style-name="T69">and </text:span><text:span text:style-name="T47">native script variables </text:span><text:span text:style-name="T69">may be used</text:span><text:span text:style-name="T47"> in the namelist definitions.</text:span></text:p>
<text:p text:style-name="P69"><text:span text:style-name="T60">The name of </text:span><text:span text:style-name="T71">this </text:span><text:span text:style-name="T60">variable</text:span><text:span text:style-name="T61"> </text:span><text:span text:style-name="T71">is</text:span><text:span text:style-name="T60"> generated from </text:span><text:span text:style-name="T71">its</text:span><text:span text:style-name="T60"> </text:span><text:span text:style-name="T61">respective</text:span><text:span text:style-name="T60"> file name, </text:span><text:span text:style-name="T71">like</text:span><text:span text:style-name="T60"> 'namelist.echam', by </text:span><text:span text:style-name="T70">converting all letters to upper case </text:span><text:span text:style-name="T60">(</text:span><text:span text:style-name="T70">namelist.echam →</text:span><text:span text:style-name="T60"> </text:span><text:span text:style-name="T70">NAMELIST.ECHAM</text:span><text:span text:style-name="T60">) </text:span><text:span text:style-name="T61">and </text:span><text:span text:style-name="T60">replacing non-word characters by an underscore (NAMELIST.ECHAM → NAMELIST_ECHAM).</text:span></text:p>
<text:p text:style-name="Preformatted_20_Text"># joe1234.config</text:p>
@@ -2705,7 +2702,7 @@
<text:p text:style-name="P105">EOF</text:p>
<text:p text:style-name="P70"><text:span text:style-name="T71">Note how this setup uses the native script variable 'EXP_ID' to set the </text:span><text:span text:style-name="T67">namelist contents.</text:span></text:p>
<text:p text:style-name="P70"><text:span text:style-name="T72">As in the example above, the script template is responsible for writing the namelist text to an actual file. </text:span><text:span text:style-name="T71">While in general the namelist file takes the same name as the .config subsection defining it, </text:span><text:span text:style-name="T25">mkexp</text:span><text:span text:style-name="T71"> </text:span><text:span text:style-name="T72">ha</text:span><text:span text:style-name="T71">s currently no way to enforce this. The template needs to be set up accordingly.</text:span></text:p>
- <text:h text:style-name="P262" text:outline-level="3">Using native script variables in namelists</text:h>
+ <text:h text:style-name="P263" text:outline-level="3">Using native script variables in namelists</text:h>
<text:p text:style-name="P88">When using native script variables in a namelist, it may be necessary to suppress the conversion of values to namelist conventions. Consider</text:p>
<text:p text:style-name="P159">[namelists]</text:p>
<text:p text:style-name="P159"><text:s text:c="2"/><text:span text:style-name="T223">[[namelist.echam]]</text:span></text:p>
@@ -2718,7 +2715,7 @@
<text:p text:style-name="P88">When the text for NAMELIST_ECHAM is generated, <text:span text:style-name="T9">mkexp</text:span><text:span text:style-name="T47"> converts the value of 'dt_stop' to a string surrounded by single quotes (see 'EXP_ID' in the previous example), as '$$final_date' cannot be </text:span><text:span text:style-name="T94">recognized</text:span><text:span text:style-name="T47"> as a numer</text:span><text:span text:style-name="T94">ic</text:span><text:span text:style-name="T47"> or logical value. In the namelist context however it is </text:span><text:span text:style-name="T94">needed</text:span><text:span text:style-name="T47"> as a</text:span><text:span text:style-name="T94">n unquoted</text:span><text:span text:style-name="T47"> list of integers. </text:span><text:span text:style-name="T93">To fix this, simply use the special syntax 'raw(…)' </text:span><text:span text:style-name="T94">around the value:</text:span></text:p>
<text:p text:style-name="Preformatted_20_Text"><text:span text:style-name="T94"><text:s text:c="6"/></text:span><text:span text:style-name="T92">dt_stop = </text:span><text:span text:style-name="T94">raw(</text:span><text:span text:style-name="T92">$$final_date</text:span><text:span text:style-name="T94">)</text:span></text:p>
<text:p text:style-name="P57">which disables the conversion to a valid namelist value, leaving the correct formatting of the native variable to the script.</text:p>
- <text:h text:style-name="P259" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2584_1114405012"/><text:soft-page-break/>Non-namelist configuration files<text:bookmark-end text:name="__RefHeading__2584_1114405012"/></text:h>
+ <text:h text:style-name="P260" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2584_1114405012"/><text:soft-page-break/>Non-namelist configuration files<text:bookmark-end text:name="__RefHeading__2584_1114405012"/></text:h>
<text:p text:style-name="P81"><text:span text:style-name="T82">A [namelists] subsection may not only define a Fortran namelist file but also a custom format configuration file. </text:span><text:span text:style-name="T80">F</text:span><text:span text:style-name="T47">or any </text:span><text:span text:style-name="T82">of these</text:span><text:span text:style-name="T81"> files, the special section variable '.use_template' m</text:span><text:span text:style-name="T95">ay</text:span><text:span text:style-name="T81"> be set to 'true', </text:span><text:span text:style-name="T95">if </text:span><text:span text:style-name="T82">the model setup provid</text:span><text:span text:style-name="T95">es</text:span><text:span text:style-name="T82"> a template '</text:span><text:span text:style-name="T29">subsection</text:span><text:span text:style-name="T82">.tmpl', </text:span><text:span text:style-name="T95">or to an arbitrary template name, replacing </text:span><text:span text:style-name="T35">subsection,</text:span><text:span text:style-name="T95"> if a template is applicable to more than one section</text:span><text:span text:style-name="T82">. This template is expanded using the subsection's variables to create a suitably formatted text. </text:span><text:span text:style-name="T83">As for genuine namelists, the result is stored in a global variable.</text:span></text:p>
<text:h text:style-name="Heading_20_2" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__2831_1132221942"/><text:span text:style-name="T83">D</text:span><text:span text:style-name="T47">efining input files for an experiment</text:span><text:bookmark-end text:name="__RefHeading__2831_1132221942"/></text:h>
<text:p text:style-name="P85"><text:span text:style-name="T47">While the namelist files determine the model properties, the model state </text:span><text:span text:style-name="T91">also </text:span><text:span text:style-name="T47">depends on input files for initial and boundary conditions or assimilation data. These files are defined in the [files] special section.</text:span></text:p>
@@ -2728,10 +2725,10 @@
<text:p text:style-name="List_20_Heading"><text:span text:style-name="T47">.</text:span><text:span text:style-name="T98">sub_dir</text:span></text:p>
<text:p text:style-name="P219"><text:span text:style-name="T99">file names are taken to be relative to this subdirectory of </text:span><text:span text:style-name="T47">'.base_dir'</text:span></text:p>
<text:p text:style-name="P63"><text:span text:style-name="T118">For expanding the resulting file path</text:span><text:span text:style-name="T102">, </text:span><text:span text:style-name="T39">mkexp</text:span><text:span text:style-name="T102"> provides </text:span><text:span text:style-name="T118">a global function:</text:span></text:p>
- <text:p text:style-name="P231"><text:span text:style-name="T102">get_file</text:span><text:span text:style-name="T123">(</text:span><text:span text:style-name="T41">section</text:span><text:span text:style-name="T123">, </text:span><text:span text:style-name="T41">name</text:span><text:span text:style-name="T123">)</text:span></text:p>
+ <text:p text:style-name="P232"><text:span text:style-name="T102">get_file</text:span><text:span text:style-name="T123">(</text:span><text:span text:style-name="T41">section</text:span><text:span text:style-name="T123">, </text:span><text:span text:style-name="T41">name</text:span><text:span text:style-name="T123">)</text:span></text:p>
<text:p text:style-name="P197">returns the full path for file <text:span text:style-name="T9">name</text:span> as given in the <text:span text:style-name="T9">section</text:span> object. Note that <text:span text:style-name="T9">section</text:span> is given as object reference, but <text:span text:style-name="T9">name</text:span> is given as a string. <text:span text:style-name="T243">All native script variables are expanded</text:span></text:p>
<text:p text:style-name="P85"><text:span text:style-name="T98">Other than that, t</text:span><text:span text:style-name="T91">here are no restrictions on the content structure of this section, and the job script templates are responsible for converting this content into a suitable script text.</text:span></text:p>
- <text:h text:style-name="P255" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2833_1132221942"/>Overriding <text:span text:style-name="T221">input file</text:span>s <text:span text:style-name="T221">for certain</text:span> jobs<text:bookmark-end text:name="__RefHeading__2833_1132221942"/></text:h>
+ <text:h text:style-name="P256" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2833_1132221942"/>Overriding <text:span text:style-name="T221">input file</text:span>s <text:span text:style-name="T221">for certain</text:span> jobs<text:bookmark-end text:name="__RefHeading__2833_1132221942"/></text:h>
<text:p text:style-name="P51"><text:span text:style-name="T222">As for namelists, t</text:span>here is special provision to change <text:span text:style-name="T221">the [</text:span>files<text:span text:style-name="T221">]</text:span> settings for a specific job. <text:span text:style-name="T221">Let us assume</text:span> <text:span text:style-name="T221">that a model run continues a previous run and reads that run's state from a restart file that may be defined like this:</text:span></text:p>
<text:p text:style-name="P141"><text:soft-page-break/>[<text:span text:style-name="T221">files</text:span>]</text:p>
<text:p text:style-name="P101"><text:s text:c="2"/>[[<text:span text:style-name="T221">echam</text:span>]]</text:p>
diff --git a/doc/mkexp.pdf b/doc/mkexp.pdf
index cc5968d5821a29f2ff87bfca0adfaac24cf6107d..91acc861ba97687e3a1daa15b268e56417c9f843 100644
Binary files a/doc/mkexp.pdf and b/doc/mkexp.pdf differ
diff --git a/setup.py b/setup.py
index 150ae60a2ca2a90efaedfcc216af04b8e4ec10ea..00ea8de6dd6076cf5c953f0524fee851cdd6f9a1 100644
--- a/setup.py
+++ b/setup.py
@@ -1,7 +1,7 @@
from distutils.core import setup
name = 'mkexp'
-version = '0.4.2dev'
+version = '0.4.2'
setup(
name = name,