From a7c7a6f18523dbeb12c8f652820109cc01ff4586 Mon Sep 17 00:00:00 2001
From: Karl-Hermann Wieners <karl-hermann.wieners@mpimet.mpg.de>
Date: Tue, 15 Dec 2015 23:28:56 +0000
Subject: [PATCH] Prepared for release 0.3.5
* Updated documentation
* Updated version info and change list
---
CHANGES.txt | 6 +
doc/mkexp.fodt | 1054 +++++++++++++++++++++++++-----------------------
doc/mkexp.pdf | Bin 387869 -> 388272 bytes
setup.py | 2 +-
4 files changed, 547 insertions(+), 515 deletions(-)
diff --git a/CHANGES.txt b/CHANGES.txt
index a98585d..63d6aa9 100644
--- a/CHANGES.txt
+++ b/CHANGES.txt
@@ -15,6 +15,12 @@ Global
* Added -q (quiet) option to mkexp to suppress info messages
* Fixed diffpath to also compare two files (used to expect directories)
+Templates
+---------
+
+* Replaced wordwrap by a private version that allows to suppress breaks on
+ hyphens (used to break long absolute file names)
+
Release 0.3.4
=============
diff --git a/doc/mkexp.fodt b/doc/mkexp.fodt
index be0f2ca..3b85601 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>P11DT23H4M5S</meta:editing-duration><meta:editing-cycles>100</meta:editing-cycles><meta:generator>LibreOffice/4.2.8.2$Linux_X86_64 LibreOffice_project/420m0$Build-2</meta:generator><meta:initial-creator>Karl-Hermann Wieners</meta:initial-creator><dc:date>2015-12-10T23:45:42.562162112</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="26" meta:paragraph-count="523" meta:word-count="7155" meta:character-count="45706" meta:non-whitespace-character-count="38698"/><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>P11DT23H4M52S</meta:editing-duration><meta:editing-cycles>103</meta:editing-cycles><meta:generator>LibreOffice/4.2.8.2$Linux_X86_64 LibreOffice_project/420m0$Build-2</meta:generator><meta:initial-creator>Karl-Hermann Wieners</meta:initial-creator><dc:date>2015-12-16T00:18:08.265912200</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="26" meta:paragraph-count="528" meta:word-count="7178" meta:character-count="45932" meta:non-whitespace-character-count="38904"/><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">6703</config:config-item>
+ <config:config-item config:name="ViewAreaTop" config:type="long">6209</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">24608</config:config-item>
- <config:config-item config:name="ViewAreaHeight" config:type="long">22438</config:config-item>
+ <config:config-item config:name="ViewAreaWidth" config:type="long">34953</config:config-item>
+ <config:config-item config:name="ViewAreaHeight" config:type="long">21407</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">11164</config:config-item>
+ <config:config-item config:name="ViewLeft" config:type="long">19401</config:config-item>
<config:config-item config:name="ViewTop" config:type="long">15314</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">6703</config:config-item>
- <config:config-item config:name="VisibleRight" config:type="long">24606</config:config-item>
- <config:config-item config:name="VisibleBottom" config:type="long">29139</config:config-item>
+ <config:config-item config:name="VisibleTop" config:type="long">6209</config:config-item>
+ <config:config-item config:name="VisibleRight" config:type="long">34951</config:config-item>
+ <config:config-item config:name="VisibleBottom" config:type="long">27614</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>
@@ -81,7 +81,7 @@
<config:config-item config:name="ConsiderTextWrapOnObjPos" config:type="boolean">false</config:config-item>
<config:config-item config:name="CurrentDatabaseCommandType" config:type="int">0</config:config-item>
<config:config-item config:name="RedlineProtectionKey" config:type="base64Binary"/>
- <config:config-item config:name="Rsid" config:type="int">13248803</config:config-item>
+ <config:config-item config:name="Rsid" config:type="int">13445820</config:config-item>
<config:config-item config:name="PrintProspectRTL" config:type="boolean">false</config:config-item>
<config:config-item config:name="PrinterSetup" config:type="base64Binary">pwH+/09mZmljZWpldC00NjIwLXNlcmllcwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQ1VQUzpPZmZpY2VqZXQtNDYyMC1zZXJpZXMAAAAAAAAWAAMAyQAAAAAAAAAEAAhSAAAEdAAASm9iRGF0YSAxCnByaW50ZXI9T2ZmaWNlamV0LTQ2MjAtc2VyaWVzCm9yaWVudGF0aW9uPVBvcnRyYWl0CmNvcGllcz0xCmNvbGxhdGU9ZmFsc2UKbWFyZ2luZGFqdXN0bWVudD0wLDAsMCwwCmNvbG9yZGVwdGg9MjQKcHNsZXZlbD0wCnBkZmRldmljZT0xCmNvbG9yZGV2aWNlPTAKUFBEQ29udGV4RGF0YQpJbnB1dFNsb3Q6QXV0bwBQYWdlU2l6ZTpBNAAAEgBDT01QQVRfRFVQTEVYX01PREUOAERVUExFWF9VTktOT1dO</config:config-item>
<config:config-item config:name="AlignTabStopPosition" config:type="boolean">true</config:config-item>
@@ -639,514 +639,529 @@
<style:style style:name="P87" style:family="paragraph" style:parent-style-name="Text_20_body">
<style:text-properties officeooo:rsid="00c85300" officeooo:paragraph-rsid="00c85300"/>
</style:style>
- <style:style style:name="P88" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P88" style:family="paragraph" style:parent-style-name="Text_20_body">
+ <style:text-properties officeooo:rsid="00cba5e3" officeooo:paragraph-rsid="00cba5e3"/>
+ </style:style>
+ <style:style style:name="P89" style:family="paragraph" style:parent-style-name="Text_20_body">
+ <style:text-properties officeooo:rsid="00cba5e3" officeooo:paragraph-rsid="00ccb67c"/>
+ </style:style>
+ <style:style style:name="P90" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:paragraph-rsid="000ef722"/>
</style:style>
- <style:style style:name="P89" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P91" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="000ef722" officeooo:paragraph-rsid="000ef722"/>
</style:style>
- <style:style style:name="P90" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P92" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="0010c1fe" officeooo:paragraph-rsid="0010c1fe"/>
</style:style>
- <style:style style:name="P91" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P93" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="00120dec" officeooo:paragraph-rsid="00120dec"/>
</style:style>
- <style:style style:name="P92" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P94" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="00120dec" officeooo:paragraph-rsid="0056317a"/>
</style:style>
- <style:style style:name="P93" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P95" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="00120dec" officeooo:paragraph-rsid="00c2926f"/>
</style:style>
- <style:style style:name="P94" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P96" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="00120dec" officeooo:paragraph-rsid="00c2ee8b"/>
</style:style>
- <style:style style:name="P95" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P97" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="00136724" officeooo:paragraph-rsid="00136724"/>
</style:style>
- <style:style style:name="P96" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P98" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="00136724" officeooo:paragraph-rsid="00145993"/>
</style:style>
- <style:style style:name="P97" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P99" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="00136724" officeooo:paragraph-rsid="00823929"/>
</style:style>
- <style:style style:name="P98" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P100" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="00136724" officeooo:paragraph-rsid="00c6886f"/>
</style:style>
- <style:style style:name="P99" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P101" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="00145993" officeooo:paragraph-rsid="00145993"/>
</style:style>
- <style:style style:name="P100" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P102" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-weight="bold" style:font-weight-asian="bold" style:font-weight-complex="bold"/>
</style:style>
- <style:style style:name="P101" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P103" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-weight="bold" officeooo:paragraph-rsid="00145993" style:font-weight-asian="bold" style:font-weight-complex="bold"/>
</style:style>
- <style:style style:name="P102" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P104" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-weight="bold" officeooo:rsid="00120dec" officeooo:paragraph-rsid="00145993" style:font-weight-asian="bold" style:font-weight-complex="bold"/>
</style:style>
- <style:style style:name="P103" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P105" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-weight="bold" officeooo:paragraph-rsid="0040993d" style:font-weight-asian="bold" style:font-weight-complex="bold"/>
</style:style>
- <style:style style:name="P104" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P106" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-weight="bold" officeooo:rsid="00136724" officeooo:paragraph-rsid="00823929" style:font-weight-asian="bold" style:font-weight-complex="bold"/>
</style:style>
- <style:style style:name="P105" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P107" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-weight="bold" officeooo:rsid="00136724" officeooo:paragraph-rsid="00c6886f" style:font-weight-asian="bold" style:font-weight-complex="bold"/>
</style:style>
- <style:style style:name="P106" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P108" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-weight="bold" officeooo:rsid="00823929" officeooo:paragraph-rsid="00823929" style:font-weight-asian="bold" style:font-weight-complex="bold"/>
</style:style>
- <style:style style:name="P107" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P109" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-weight="bold" officeooo:paragraph-rsid="00881a06" style:font-weight-asian="bold" style:font-weight-complex="bold"/>
</style:style>
- <style:style style:name="P108" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P110" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="002df45a" officeooo:paragraph-rsid="002df45a"/>
</style:style>
- <style:style style:name="P109" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P111" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:paragraph-rsid="002df45a"/>
</style:style>
- <style:style style:name="P110" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P112" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="0031081b" officeooo:paragraph-rsid="003212b8"/>
</style:style>
- <style:style style:name="P111" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P113" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:paragraph-rsid="003212b8"/>
</style:style>
- <style:style style:name="P112" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P114" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:paragraph-rsid="003b8120"/>
</style:style>
- <style:style style:name="P113" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P115" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="0040993d" officeooo:paragraph-rsid="0040993d"/>
</style:style>
- <style:style style:name="P114" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P116" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-style="normal" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P115" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P117" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-style="normal" officeooo:rsid="00c4ca99" officeooo:paragraph-rsid="00c4ca99" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P116" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P118" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<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="P117" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P119" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-style="normal" style:text-underline-style="none" officeooo:rsid="0056317a" officeooo:paragraph-rsid="00551136" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P118" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P120" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-style="normal" style:text-underline-style="none" officeooo:rsid="00584c1a" officeooo:paragraph-rsid="005a5c62" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P119" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P121" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-style="normal" style:text-underline-style="none" officeooo:paragraph-rsid="005a5c62" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P120" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P122" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-style="normal" style:text-underline-style="none" officeooo:rsid="005ac4c7" officeooo:paragraph-rsid="005ac4c7" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P121" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P123" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-style="normal" style:text-underline-style="none" officeooo:paragraph-rsid="005ac4c7" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P122" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P124" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-style="normal" style:text-underline-style="none" officeooo:rsid="005b6c85" officeooo:paragraph-rsid="005b6c85" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P123" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P125" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-style="normal" style:text-underline-style="none" officeooo:paragraph-rsid="00657146" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P124" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P126" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-style="normal" style:text-underline-style="none" officeooo:rsid="00657146" officeooo:paragraph-rsid="00657146" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P125" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P127" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-style="normal" fo:font-weight="bold" officeooo:rsid="00881a06" officeooo:paragraph-rsid="00881a06" style:font-style-asian="normal" style:font-weight-asian="bold" style:font-style-complex="normal" style:font-weight-complex="bold"/>
</style:style>
- <style:style style:name="P126" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P128" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-style="normal" fo:font-weight="normal" officeooo:rsid="00c6886f" officeooo:paragraph-rsid="00c6886f" 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="P127" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P129" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties fo:font-style="normal" fo:font-weight="normal" officeooo:rsid="00136724" officeooo:paragraph-rsid="00c6886f" 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="P128" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P130" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="00405b5f"/>
</style:style>
- <style:style style:name="P129" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P131" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="0051a8b5" officeooo:paragraph-rsid="0051a8b5"/>
</style:style>
- <style:style style:name="P130" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P132" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:paragraph-rsid="00551136"/>
</style:style>
- <style:style style:name="P131" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P133" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="0056317a" officeooo:paragraph-rsid="0056317a"/>
</style:style>
- <style:style style:name="P132" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P134" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="0056317a" officeooo:paragraph-rsid="00c2926f"/>
</style:style>
- <style:style style:name="P133" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P135" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:paragraph-rsid="005ac4c7"/>
</style:style>
- <style:style style:name="P134" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P136" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:paragraph-rsid="005b6c85"/>
</style:style>
- <style:style style:name="P135" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P137" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="005b6c85" officeooo:paragraph-rsid="005b6c85"/>
</style:style>
- <style:style style:name="P136" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P138" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:paragraph-rsid="00657146"/>
</style:style>
- <style:style style:name="P137" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P139" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:paragraph-rsid="006e58f1"/>
</style:style>
- <style:style style:name="P138" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P140" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="00823929" officeooo:paragraph-rsid="00823929"/>
</style:style>
- <style:style style:name="P139" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P141" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="00840f80" officeooo:paragraph-rsid="00840f80"/>
</style:style>
- <style:style style:name="P140" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P142" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="00840f80" officeooo:paragraph-rsid="00881a06"/>
</style:style>
- <style:style style:name="P141" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P143" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:paragraph-rsid="00881a06"/>
</style:style>
- <style:style style:name="P142" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P144" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="008a0101" officeooo:paragraph-rsid="008a0101"/>
</style:style>
- <style:style style:name="P143" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P145" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:paragraph-rsid="008a0101"/>
</style:style>
- <style:style style:name="P144" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P146" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="008b134d" officeooo:paragraph-rsid="008b134d"/>
</style:style>
- <style:style style:name="P145" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P147" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="008ba54a" officeooo:paragraph-rsid="008c2cba"/>
</style:style>
- <style:style style:name="P146" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P148" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="008c2cba" officeooo:paragraph-rsid="008c2cba"/>
</style:style>
- <style:style style:name="P147" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P149" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="00931d47" officeooo:paragraph-rsid="00931d47"/>
</style:style>
- <style:style style:name="P148" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P150" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="0089d9b6"/>
</style:style>
- <style:style style:name="P149" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P151" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:rsid="00c4ca99" officeooo:paragraph-rsid="00c4ca99"/>
</style:style>
- <style:style style:name="P150" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P152" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:paragraph-rsid="00c6886f"/>
</style:style>
- <style:style style:name="P151" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:style style:name="P153" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
<style:text-properties officeooo:paragraph-rsid="00c85300"/>
</style:style>
- <style:style style:name="P152" style:family="paragraph" style:parent-style-name="List_20_Heading">
+ <style:style style:name="P154" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:text-properties officeooo:rsid="00cba5e3" officeooo:paragraph-rsid="00cba5e3"/>
+ </style:style>
+ <style:style style:name="P155" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:text-properties officeooo:rsid="00cba5e3" officeooo:paragraph-rsid="00ccb67c"/>
+ </style:style>
+ <style:style style:name="P156" style:family="paragraph" style:parent-style-name="List_20_Heading">
<style:text-properties officeooo:rsid="00469c32" officeooo:paragraph-rsid="00469c32"/>
</style:style>
- <style:style style:name="P153" style:family="paragraph" style:parent-style-name="List_20_Heading">
+ <style:style style:name="P157" style:family="paragraph" style:parent-style-name="List_20_Heading">
<style:text-properties officeooo:rsid="00469c32" officeooo:paragraph-rsid="004e33b4"/>
</style:style>
- <style:style style:name="P154" style:family="paragraph" style:parent-style-name="List_20_Heading">
+ <style:style style:name="P158" style:family="paragraph" style:parent-style-name="List_20_Heading">
<style:text-properties fo:font-style="normal" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P155" style:family="paragraph" style:parent-style-name="List_20_Heading">
+ <style:style style:name="P159" style:family="paragraph" style:parent-style-name="List_20_Heading">
<style:text-properties fo:font-style="normal" officeooo:rsid="004584b6" officeooo:paragraph-rsid="004584b6" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P156" style:family="paragraph" style:parent-style-name="List_20_Heading">
+ <style:style style:name="P160" style:family="paragraph" style:parent-style-name="List_20_Heading">
<style:text-properties fo:font-style="normal" officeooo:rsid="0045d600" officeooo:paragraph-rsid="0045d600" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P157" style:family="paragraph" style:parent-style-name="List_20_Heading">
+ <style:style style:name="P161" style:family="paragraph" style:parent-style-name="List_20_Heading">
<style:text-properties fo:font-style="normal" officeooo:rsid="00469c32" officeooo:paragraph-rsid="00469c32" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P158" style:family="paragraph" style:parent-style-name="List_20_Heading">
+ <style:style style:name="P162" style:family="paragraph" style:parent-style-name="List_20_Heading">
<style:text-properties fo:font-style="normal" officeooo:rsid="00493380" officeooo:paragraph-rsid="00493380" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P159" style:family="paragraph" style:parent-style-name="List_20_Heading">
+ <style:style style:name="P163" style:family="paragraph" style:parent-style-name="List_20_Heading">
<style:text-properties fo:font-style="normal" officeooo:paragraph-rsid="00493380" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P160" style:family="paragraph" style:parent-style-name="List_20_Heading">
+ <style:style style:name="P164" style:family="paragraph" style:parent-style-name="List_20_Heading">
<style:text-properties fo:font-style="normal" officeooo:rsid="009d837c" officeooo:paragraph-rsid="009d837c" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P161" style:family="paragraph" style:parent-style-name="List_20_Heading">
+ <style:style style:name="P165" style:family="paragraph" style:parent-style-name="List_20_Heading">
<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="P162" style:family="paragraph" style:parent-style-name="List_20_Heading">
+ <style:style style:name="P166" style:family="paragraph" style:parent-style-name="List_20_Heading">
<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="P163" style:family="paragraph" style:parent-style-name="List_20_Heading">
+ <style:style style:name="P167" style:family="paragraph" style:parent-style-name="List_20_Heading">
<style:text-properties officeooo:rsid="00493380" officeooo:paragraph-rsid="004e33b4"/>
</style:style>
- <style:style style:name="P164" style:family="paragraph" style:parent-style-name="List_20_Heading">
+ <style:style style:name="P168" style:family="paragraph" style:parent-style-name="List_20_Heading">
<style:text-properties officeooo:rsid="00484f3f" officeooo:paragraph-rsid="004e33b4"/>
</style:style>
- <style:style style:name="P165" style:family="paragraph" style:parent-style-name="List_20_Heading">
+ <style:style style:name="P169" style:family="paragraph" style:parent-style-name="List_20_Heading">
<style:text-properties officeooo:rsid="00719334" officeooo:paragraph-rsid="00719334"/>
</style:style>
- <style:style style:name="P166" style:family="paragraph" style:parent-style-name="List_20_Heading">
+ <style:style style:name="P170" style:family="paragraph" style:parent-style-name="List_20_Heading">
<style:text-properties officeooo:rsid="00c20e43" officeooo:paragraph-rsid="00c20e43"/>
</style:style>
- <style:style style:name="P167" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P171" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties officeooo:rsid="004584b6" officeooo:paragraph-rsid="004584b6"/>
</style:style>
- <style:style style:name="P168" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P172" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties officeooo:rsid="00469c32" officeooo:paragraph-rsid="00469c32"/>
</style:style>
- <style:style style:name="P169" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P173" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties officeooo:rsid="00493380" officeooo:paragraph-rsid="00493380"/>
</style:style>
- <style:style style:name="P170" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P174" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties fo:font-style="normal" officeooo:rsid="0045d600" officeooo:paragraph-rsid="0045d600" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P171" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P175" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties fo:font-style="normal" officeooo:rsid="00484f3f" officeooo:paragraph-rsid="004e33b4" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P172" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P176" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties fo:font-style="normal" officeooo:rsid="00493380" officeooo:paragraph-rsid="00493380" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P173" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P177" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties fo:font-style="normal" officeooo:rsid="00493380" officeooo:paragraph-rsid="004e33b4" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P174" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P178" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties fo:font-style="normal" officeooo:rsid="00469c32" officeooo:paragraph-rsid="00469c32" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P175" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P179" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties fo:font-style="normal" officeooo:rsid="007ab691" officeooo:paragraph-rsid="007ab691" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P176" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P180" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties fo:font-style="normal" officeooo:rsid="009d837c" officeooo:paragraph-rsid="009d837c" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P177" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P181" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties fo:font-style="normal" officeooo:rsid="00719334" officeooo:paragraph-rsid="00719334" style:font-style-asian="normal" style:font-style-complex="normal"/>
</style:style>
- <style:style style:name="P178" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P182" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties fo:font-style="normal" fo:font-weight="normal" officeooo:rsid="00925c69" officeooo:paragraph-rsid="00925c69" 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="P179" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P183" style:family="paragraph" style:parent-style-name="List_20_Contents">
<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="P180" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P184" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties officeooo:rsid="00484f3f" officeooo:paragraph-rsid="004e33b4"/>
</style:style>
- <style:style style:name="P181" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P185" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties officeooo:rsid="006c5326" officeooo:paragraph-rsid="006c5326"/>
</style:style>
- <style:style style:name="P182" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P186" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties officeooo:paragraph-rsid="00779a5b"/>
</style:style>
- <style:style style:name="P183" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P187" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties fo:font-style="italic" officeooo:rsid="007ab691" officeooo:paragraph-rsid="007ab691" style:font-style-asian="italic" style:font-style-complex="italic"/>
</style:style>
- <style:style style:name="P184" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P188" style:family="paragraph" style:parent-style-name="List_20_Contents">
<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="P185" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P189" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties fo:font-style="italic" officeooo:rsid="00779a5b" officeooo:paragraph-rsid="00a52bc9" style:font-style-asian="italic" style:font-style-complex="italic"/>
</style:style>
- <style:style style:name="P186" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P190" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties officeooo:rsid="007a1e4b" officeooo:paragraph-rsid="007a1e4b"/>
</style:style>
- <style:style style:name="P187" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P191" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties officeooo:rsid="007ab691" officeooo:paragraph-rsid="007ab691"/>
</style:style>
- <style:style style:name="P188" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P192" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties officeooo:rsid="007bf983" officeooo:paragraph-rsid="007bf983"/>
</style:style>
- <style:style style:name="P189" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P193" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties officeooo:rsid="008e53fe" officeooo:paragraph-rsid="008f3b90"/>
</style:style>
- <style:style style:name="P190" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P194" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties officeooo:rsid="0090e55e" officeooo:paragraph-rsid="00913e1d"/>
</style:style>
- <style:style style:name="P191" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P195" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties officeooo:rsid="00beeeb9" officeooo:paragraph-rsid="00beeeb9"/>
</style:style>
- <style:style style:name="P192" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P196" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties officeooo:rsid="00beeeb9" officeooo:paragraph-rsid="00c0dbdb"/>
</style:style>
- <style:style style:name="P193" style:family="paragraph" style:parent-style-name="List_20_Contents">
+ <style:style style:name="P197" style:family="paragraph" style:parent-style-name="List_20_Contents">
<style:text-properties officeooo:rsid="00c20e43" officeooo:paragraph-rsid="00c20e43"/>
</style:style>
- <style:style style:name="P194" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
+ <style:style style:name="P198" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
<style:text-properties officeooo:paragraph-rsid="007a1e4b"/>
</style:style>
- <style:style style:name="P195" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
+ <style:style style:name="P199" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
<style:text-properties officeooo:rsid="007ab691" officeooo:paragraph-rsid="007ab691"/>
</style:style>
- <style:style style:name="P196" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
+ <style:style style:name="P200" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
<style:text-properties officeooo:paragraph-rsid="007bf983"/>
</style:style>
- <style:style style:name="P197" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
+ <style:style style:name="P201" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
<style:text-properties officeooo:rsid="008e53fe" officeooo:paragraph-rsid="008e53fe"/>
</style:style>
- <style:style style:name="P198" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
+ <style:style style:name="P202" 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:style>
- <style:style style:name="P199" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
+ <style:style style:name="P203" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
<style:text-properties officeooo:paragraph-rsid="0090e55e"/>
</style:style>
- <style:style style:name="P200" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
+ <style:style style:name="P204" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
<style:text-properties officeooo:rsid="00925c69" officeooo:paragraph-rsid="00925c69"/>
</style:style>
- <style:style style:name="P201" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
+ <style:style style:name="P205" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
<style:text-properties officeooo:rsid="00beeeb9" officeooo:paragraph-rsid="00beeeb9"/>
</style:style>
- <style:style style:name="P202" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
+ <style:style style:name="P206" style:family="paragraph" style:parent-style-name="Preformatted_20_List_20_Heading">
<style:text-properties officeooo:rsid="00beeeb9" officeooo:paragraph-rsid="00c0dbdb"/>
</style:style>
- <style:style style:name="P203" style:family="paragraph" style:parent-style-name="Preformatted_20_Text_20_Interrupt">
+ <style:style style:name="P207" 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="P204" style:family="paragraph" style:parent-style-name="Preformatted_20_Text_20_Indented">
+ <style:style style:name="P208" 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="P205" style:family="paragraph" style:parent-style-name="Caption">
+ <style:style style:name="P209" 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="P206" style:family="paragraph" style:parent-style-name="Contents_20_Heading">
+ <style:style style:name="P210" style:family="paragraph" style:parent-style-name="Contents_20_Heading">
<style:paragraph-properties fo:break-before="page"/>
</style:style>
- <style:style style:name="P207" style:family="paragraph" style:parent-style-name="Heading_20_1">
+ <style:style style:name="P211" 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="P208" style:family="paragraph" style:parent-style-name="Contents_20_1">
+ <style:style style:name="P212" 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="P209" style:family="paragraph" style:parent-style-name="Contents_20_2">
+ <style:style style:name="P213" 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="P210" style:family="paragraph" style:parent-style-name="Contents_20_3">
+ <style:style style:name="P214" 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="P211" style:family="paragraph" style:parent-style-name="Heading_20_1">
+ <style:style style:name="P215" 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="P212" style:family="paragraph" style:parent-style-name="Title" style:master-page-name="">
+ <style:style style:name="P216" 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="P213" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P217" 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="P214" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P218" 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="P215" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P219" 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="P216" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P220" 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="P217" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P221" 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="P218" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P222" 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="P219" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P223" 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="P220" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P224" 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="P221" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P225" 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="P222" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P226" 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="P223" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P227" style:family="paragraph" style:parent-style-name="Heading_20_3">
<style:text-properties officeooo:paragraph-rsid="00931d47"/>
</style:style>
- <style:style style:name="P224" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P228" 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="P225" style:family="paragraph" style:parent-style-name="Subtitle">
+ <style:style style:name="P229" style:family="paragraph" style:parent-style-name="Subtitle">
<style:text-properties officeooo:rsid="000a3505" officeooo:paragraph-rsid="000a3505"/>
</style:style>
- <style:style style:name="P226" style:family="paragraph" style:parent-style-name="Subtitle">
+ <style:style style:name="P230" style:family="paragraph" style:parent-style-name="Subtitle">
<style:text-properties officeooo:rsid="000a3505" officeooo:paragraph-rsid="00beeeb9"/>
</style:style>
- <style:style style:name="P227" style:family="paragraph" style:parent-style-name="Subtitle">
+ <style:style style:name="P231" style:family="paragraph" style:parent-style-name="Subtitle">
<style:text-properties officeooo:rsid="00beeeb9" officeooo:paragraph-rsid="00beeeb9"/>
</style:style>
- <style:style style:name="P228" style:family="paragraph" style:parent-style-name="Heading_20_2">
+ <style:style style:name="P232" style:family="paragraph" style:parent-style-name="Heading_20_2">
<style:text-properties officeooo:paragraph-rsid="00b17591"/>
</style:style>
- <style:style style:name="P229" style:family="paragraph" style:parent-style-name="Heading_20_2">
+ <style:style style:name="P233" 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="P230" style:family="paragraph" style:parent-style-name="Heading_20_2">
+ <style:style style:name="P234" style:family="paragraph" style:parent-style-name="Heading_20_2">
<style:text-properties officeooo:paragraph-rsid="00423119"/>
</style:style>
- <style:style style:name="P231" style:family="paragraph" style:parent-style-name="Heading_20_2">
+ <style:style style:name="P235" style:family="paragraph" style:parent-style-name="Heading_20_2">
<style:text-properties officeooo:paragraph-rsid="0063d022"/>
</style:style>
- <style:style style:name="P232" style:family="paragraph" style:parent-style-name="Heading_20_2">
+ <style:style style:name="P236" 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="P233" style:family="paragraph" style:parent-style-name="Title" style:master-page-name="First_20_Page">
+ <style:style style:name="P237" 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="000a3505" officeooo:paragraph-rsid="000a3505"/>
</style:style>
- <style:style style:name="P234" style:family="paragraph" style:parent-style-name="Heading_20_2">
+ <style:style style:name="P238" style:family="paragraph" style:parent-style-name="Heading_20_2">
<style:text-properties officeooo:paragraph-rsid="00b17591"/>
</style:style>
- <style:style style:name="P235" style:family="paragraph" style:parent-style-name="Heading_20_2">
+ <style:style style:name="P239" 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="P236" style:family="paragraph" style:parent-style-name="Heading_20_2">
+ <style:style style:name="P240" style:family="paragraph" style:parent-style-name="Heading_20_2">
<style:text-properties officeooo:paragraph-rsid="00423119"/>
</style:style>
- <style:style style:name="P237" style:family="paragraph" style:parent-style-name="Heading_20_2">
+ <style:style style:name="P241" style:family="paragraph" style:parent-style-name="Heading_20_2">
<style:text-properties officeooo:paragraph-rsid="0063d022"/>
</style:style>
- <style:style style:name="P238" style:family="paragraph" style:parent-style-name="Heading_20_2">
+ <style:style style:name="P242" 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="P239" style:family="paragraph" style:parent-style-name="Heading_20_1">
+ <style:style style:name="P243" 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="P240" style:family="paragraph" style:parent-style-name="Heading_20_1">
+ <style:style style:name="P244" 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="P241" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P245" 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="P242" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P246" 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="P243" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P247" 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="P244" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P248" 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="P245" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P249" 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="P246" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P250" 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="P247" style:family="paragraph" style:parent-style-name="Heading_20_3">
+ <style:style style:name="P251" 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="P248" 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 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="P249" 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="0063d022" officeooo:paragraph-rsid="0063d022"/>
</style:style>
- <style:style style:name="P250" 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 officeooo:paragraph-rsid="00931d47"/>
</style:style>
- <style:style style:name="P251" 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 officeooo:rsid="00c6886f" officeooo:paragraph-rsid="00c6886f"/>
</style:style>
+ <style:style style:name="P256" style:family="paragraph" style:parent-style-name="Preformatted_20_Text">
+ <style:text-properties officeooo:rsid="00ccb67c" officeooo:paragraph-rsid="00ccb67c"/>
+ </style:style>
<style:style style:name="T1" style:family="text">
<style:text-properties officeooo:rsid="000be205"/>
</style:style>
@@ -1756,6 +1771,12 @@
<style:style style:name="T203" style:family="text">
<style:text-properties officeooo:rsid="00ca2923"/>
</style:style>
+ <style:style style:name="T204" style:family="text">
+ <style:text-properties officeooo:rsid="00cba5e3"/>
+ </style:style>
+ <style:style style:name="T205" style:family="text">
+ <style:text-properties officeooo:rsid="00ccb67c"/>
+ </style:style>
<style:style style:name="Sect1" style:family="section">
<style:section-properties fo:background-color="transparent" style:editable="false">
<style:columns fo:column-count="1" fo:column-gap="0cm"/>
@@ -1810,7 +1831,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">2</text:page-number><text:tab/><text:tab/><text:modification-date style:data-style-name="N84">2015-12-10</text:modification-date>, <text:modification-time style:data-style-name="N41">23:45:43</text:modification-time></text:p>
+ <text:p text:style-name="Footer"><text:page-number text:select-page="current">26</text:page-number><text:tab/><text:tab/><text:modification-date style:data-style-name="N84">2015-12-16</text:modification-date>, <text:modification-time style:data-style-name="N41">00:18:08</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"/>
@@ -1824,10 +1845,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="P233">Make Experiments!</text:p>
- <text:p text:style-name="P226">Run-script generation for earth system models</text:p>
- <text:p text:style-name="P227">Release 0.3.<text:span text:style-name="T203">5dev</text:span></text:p>
- <text:p text:style-name="P205">Karl-Hermann Wieners<text:line-break/><text:span text:style-name="T196">Max-Planck-Institut für Meteorologie<text:line-break/>Hamburg</text:span></text:p>
+ <text:p text:style-name="P237">Make Experiments!</text:p>
+ <text:p text:style-name="P230">Run-script generation for earth system models</text:p>
+ <text:p text:style-name="P231">Release 0.3.<text:span text:style-name="T203">5</text:span></text:p>
+ <text:p text:style-name="P209">Karl-Hermann Wieners<text:line-break/><text:span text:style-name="T196">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>
@@ -1914,172 +1935,172 @@
</text:table-of-content-source>
<text:index-body>
<text:index-title text:style-name="Sect2" text:name="Table of Contents1_Head">
- <text:p text:style-name="P206">Table of Contents</text:p>
+ <text:p text:style-name="P210">Table of Contents</text:p>
</text:index-title>
- <text:p text:style-name="P208"><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="P209"><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="P210"><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="P210"><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="P210"><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="P208"><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="P209"><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="P209"><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="P209"><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="P210"><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="P210"><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="P210"><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="P210"><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="P210"><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="P210"><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="P209"><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="P210"><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="P210"><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="P210"><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="P210"><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="P210"><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="P210"><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="P209"><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="P209"><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="P209"><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="P209"><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="P210"><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="P210"><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="P210"><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="P210"><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="P210"><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="P210"><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="P209"><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="P210"><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="P210"><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="P210"><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="P210"><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="P209"><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="P210"><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="P212"><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="P213"><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="P214"><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="P214"><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="P214"><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="P212"><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="P213"><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="P213"><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="P213"><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="P214"><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="P214"><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="P214"><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="P214"><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="P214"><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="P214"><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="P213"><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="P214"><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="P214"><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="P214"><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="P214"><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="P214"><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="P214"><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="P213"><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="P213"><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="P213"><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="P213"><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="P214"><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="P214"><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="P214"><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="P214"><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="P214"><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="P214"><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="P213"><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="P214"><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="P214"><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="P214"><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="P214"><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="P213"><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="P214"><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="P81"/>
- <text:h text:style-name="P207" 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="P211" 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="T124">Make Experiments! (</text:span>mkexp<text:span text:style-name="T124">)</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="P213" 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="P217" 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="T166">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="P90"><text:soft-page-break/># Standard AMIP experiment as baseline for further experiments (LR)</text:p>
- <text:p text:style-name="P90"/>
- <text:p text:style-name="P90">EXP_TYPE = amip-LR</text:p>
+ <text:p text:style-name="P92"><text:soft-page-break/># Standard AMIP experiment as baseline for further experiments (LR)</text:p>
+ <text:p text:style-name="P92"/>
+ <text:p text:style-name="P92">EXP_TYPE = amip-LR</text:p>
<text:p text:style-name="P3">For each <text:span text:style-name="T4">experiment type</text:span>, you will find a .config file in the run/standard_experiments subdirectory. For instance, <text:span text:style-name="T165">'</text:span>amip-LR.config<text:span text:style-name="T165">'</text:span> includes these settings</text:p>
- <text:p text:style-name="P89"># Default definitions for amip-LR experiments </text:p>
- <text:p text:style-name="P88"/>
- <text:p text:style-name="P88">RES = 63 </text:p>
+ <text:p text:style-name="P91"># Default definitions for amip-LR experiments </text:p>
+ <text:p text:style-name="P90"/>
+ <text:p text:style-name="P90">RES = 63 </text:p>
<text:p text:style-name="Preformatted_20_Text"/>
<text:p text:style-name="Preformatted_20_Text">[namelists] </text:p>
- <text:p text:style-name="P88"/>
- <text:p text:style-name="P88"><text:s text:c="2"/>[[namelist.echam]] </text:p>
+ <text:p text:style-name="P90"/>
+ <text:p text:style-name="P90"><text:s text:c="2"/>[[namelist.echam]] </text:p>
<text:p text:style-name="Preformatted_20_Text"><text:s text:c="3"/>[[[runctl]]] </text:p>
<text:p text:style-name="Preformatted_20_Text"><text:s text:c="6"/>lamip = true</text:p>
- <text:p text:style-name="P91"/>
- <text:p text:style-name="P91"><text:s text:c="2"/>[[namelist.jsbach]] </text:p>
- <text:p text:style-name="P91"><text:s text:c="4"/>[[[jsbach_ctl]]] </text:p>
- <text:p text:style-name="P91"><text:s text:c="6"/>use_dynveg <text:s/>= false </text:p>
+ <text:p text:style-name="P93"/>
+ <text:p text:style-name="P93"><text:s text:c="2"/>[[namelist.jsbach]] </text:p>
+ <text:p text:style-name="P93"><text:s text:c="4"/>[[[jsbach_ctl]]] </text:p>
+ <text:p text:style-name="P93"><text:s text:c="6"/>use_dynveg <text:s/>= false </text:p>
<text:p text:style-name="P5">As you can see, settings are simple name = value pairs that may be organized in sections. Sections are defined by a bracketed section name. They may contain subsections, where the number of brackets define<text:span text:style-name="T122">s</text:span> the hierarchy depth. The pre-defined sections [namelists] and [jobs] are used for special purposes within <text:span text:style-name="T9">mkexp</text:span>.</text:p>
<text:p text:style-name="P5"><text:span text:style-name="T165">Some s</text:span>ettings apply to all <text:span text:style-name="T165">ECHAM </text:span>experiment types. <text:span text:style-name="T165">They</text:span> go into a file named <text:span text:style-name="T165">'</text:span>DEFAULT.config<text:span text:style-name="T165">'</text:span>. <text:span text:style-name="T9">mkexp</text:span> will <text:span text:style-name="T165">always </text:span>read this file <text:span text:style-name="T165">first, </text:span>before applying <text:span text:style-name="T165">any </text:span>settings from <text:span text:style-name="T165">a specific experiment type like 'amip-LR.config'.</text:span> <text:span text:style-name="T165">Such settings might be default paths for input data, as in</text:span></text:p>
- <text:p text:style-name="P95"># <text:span text:style-name="T165">Default definitions for all </text:span>ECHAM experiment<text:span text:style-name="T165">s</text:span></text:p>
- <text:p text:style-name="P95"/>
- <text:p text:style-name="P95">ATMO_INPUT_ROOT = /pool/data/ECHAM6/input/r0004 </text:p>
- <text:p text:style-name="P95">LAND_INPUT_ROOT = /pool/data/JSBACH/input/r0004 </text:p>
+ <text:p text:style-name="P97"># <text:span text:style-name="T165">Default definitions for all </text:span>ECHAM experiment<text:span text:style-name="T165">s</text:span></text:p>
+ <text:p text:style-name="P97"/>
+ <text:p text:style-name="P97">ATMO_INPUT_ROOT = /pool/data/ECHAM6/input/r0004 </text:p>
+ <text:p text:style-name="P97">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="T35">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="P214" 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="P218" 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="T165">Now the experiment configuration is finalized, the </text:span>settings are used to fill in <text:span text:style-name="T165">a kind of job description forms, so called </text:span><text:span text:style-name="T9">templates</text:span><text:span text:style-name="T165">, </text:span>from which eventually the <text:span text:style-name="T165">actual </text:span>job description files are created. As the structure of<text:span text:style-name="T165"> </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="T186">'</text:span>amip.run.tmpl<text:span text:style-name="T186">'</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="T123">placeholders</text:span> that are filled using the .config file information:</text:p>
- <text:p text:style-name="P95"><text:soft-page-break/>#! /bin/bash</text:p>
- <text:p text:style-name="P95"/>
- <text:p text:style-name="P95"># Job file to run ECHAM 6 </text:p>
- <text:p text:style-name="P95"/>
- <text:p text:style-name="P99">EXP=<text:span text:style-name="T112">%{EXP_ID}</text:span> # experiment identifier </text:p>
- <text:p text:style-name="P95"/>
- <text:p text:style-name="P95">RES=<text:span text:style-name="T112">%{RES}</text:span> <text:span text:style-name="T123"># experiment truncation</text:span></text:p>
- <text:p text:style-name="P95"/>
- <text:p text:style-name="P99"># absolute paths to directories with initial data: </text:p>
- <text:p text:style-name="P99">ATMO_DATA=<text:span text:style-name="T112">%{ATMO_INPUT_ROOT}</text:span> </text:p>
- <text:p text:style-name="P99">ATMO_MAP_DATA=$ATMO_DATA/T${RES} </text:p>
- <text:p text:style-name="P99"/>
- <text:p text:style-name="P99"># absolute path to directory with initial data for JSBACH: </text:p>
- <text:p text:style-name="P99">LAND_MAP_DATA=<text:span text:style-name="T112">%{LAND_INPUT_ROOT}</text:span>/T${RES} </text:p>
- <text:p text:style-name="P96"/>
- <text:p text:style-name="P96"># </text:p>
- <text:p text:style-name="P95"># ECHAM6 namelist </text:p>
- <text:p text:style-name="P95"># </text:p>
- <text:p text:style-name="P95">cat > namelist.echam << EOF </text:p>
- <text:p text:style-name="P95"><text:span text:style-name="T112">%{NAMELIST_ECHAM}</text:span> </text:p>
- <text:p text:style-name="P95">EOF </text:p>
- <text:p text:style-name="P95"/>
- <text:p text:style-name="P95"># </text:p>
- <text:p text:style-name="P95"># JSBACH namelist</text:p>
- <text:p text:style-name="P95"># </text:p>
- <text:p text:style-name="P95">cat > namelist.jsbach << EOF </text:p>
- <text:p text:style-name="P95"><text:span text:style-name="T112">%{NAMELIST_JSBACH}</text:span> </text:p>
- <text:p text:style-name="P95">EOF </text:p>
+ <text:p text:style-name="P97"><text:soft-page-break/>#! /bin/bash</text:p>
+ <text:p text:style-name="P97"/>
+ <text:p text:style-name="P97"># Job file to run ECHAM 6 </text:p>
+ <text:p text:style-name="P97"/>
+ <text:p text:style-name="P101">EXP=<text:span text:style-name="T112">%{EXP_ID}</text:span> # experiment identifier </text:p>
+ <text:p text:style-name="P97"/>
+ <text:p text:style-name="P97">RES=<text:span text:style-name="T112">%{RES}</text:span> <text:span text:style-name="T123"># experiment truncation</text:span></text:p>
+ <text:p text:style-name="P97"/>
+ <text:p text:style-name="P101"># absolute paths to directories with initial data: </text:p>
+ <text:p text:style-name="P101">ATMO_DATA=<text:span text:style-name="T112">%{ATMO_INPUT_ROOT}</text:span> </text:p>
+ <text:p text:style-name="P101">ATMO_MAP_DATA=$ATMO_DATA/T${RES} </text:p>
+ <text:p text:style-name="P101"/>
+ <text:p text:style-name="P101"># absolute path to directory with initial data for JSBACH: </text:p>
+ <text:p text:style-name="P101">LAND_MAP_DATA=<text:span text:style-name="T112">%{LAND_INPUT_ROOT}</text:span>/T${RES} </text:p>
+ <text:p text:style-name="P98"/>
+ <text:p text:style-name="P98"># </text:p>
+ <text:p text:style-name="P97"># ECHAM6 namelist </text:p>
+ <text:p text:style-name="P97"># </text:p>
+ <text:p text:style-name="P97">cat > namelist.echam << EOF </text:p>
+ <text:p text:style-name="P97"><text:span text:style-name="T112">%{NAMELIST_ECHAM}</text:span> </text:p>
+ <text:p text:style-name="P97">EOF </text:p>
+ <text:p text:style-name="P97"/>
+ <text:p text:style-name="P97"># </text:p>
+ <text:p text:style-name="P97"># JSBACH namelist</text:p>
+ <text:p text:style-name="P97"># </text:p>
+ <text:p text:style-name="P97">cat > namelist.jsbach << EOF </text:p>
+ <text:p text:style-name="P97"><text:span text:style-name="T112">%{NAMELIST_JSBACH}</text:span> </text:p>
+ <text:p text:style-name="P97">EOF </text:p>
<text:p text:style-name="P7"><text:span text:style-name="T166">T</text:span>h<text:span text:style-name="T166">e</text:span>se <text:span text:style-name="T166">'</text:span>%{...}<text:span text:style-name="T166">'</text:span> construct<text:span text:style-name="T7">s</text:span> correspond to the configuration settings shown in the previous section. The value for <text:span text:style-name="T186">the setting </text:span>given <text:span text:style-name="T166">by the variable name between '%{' and '}'</text:span> is pasted into the template, replacing the placeholder. The special names 'NAMELIST_ECHAM' and 'NAMELIST_JSBACH' contain the contents of the 'namelists' subsections, with each setting taken to be a Fortran namelist setting, and formatted accordingly. 'EXP_ID' is taken to be the base filename of the experiment's .config file. The result of this operation is then written to the final job script, in our case <text:span text:style-name="T166">'</text:span>joe1234.run<text:span text:style-name="T166">'</text:span>:</text:p>
- <text:p text:style-name="P96"><text:soft-page-break/>#! /bin/bash</text:p>
- <text:p text:style-name="P96"/>
- <text:p text:style-name="P96"># Job file to run ECHAM 6 </text:p>
- <text:p text:style-name="P96"/>
- <text:p text:style-name="P99">EXP=<text:span text:style-name="T112">joe1234</text:span> # experiment identifier </text:p>
- <text:p text:style-name="P96"/>
- <text:p text:style-name="P96">RES=<text:span text:style-name="T113">63</text:span><text:span text:style-name="T6"> # experiment truncation</text:span></text:p>
- <text:p text:style-name="P96"/>
- <text:p text:style-name="P96">#<text:span text:style-name="T6"> absolute paths to directories with initial data: </text:span></text:p>
- <text:p text:style-name="P99">ATMO_DATA=<text:span text:style-name="T114">/pool/data/ECHAM6/input/r0004</text:span><text:span text:style-name="T5"> </text:span></text:p>
- <text:p text:style-name="P99">ATMO_MAP_DATA=$ATMO_DATA/T${RES} </text:p>
- <text:p text:style-name="P99"/>
- <text:p text:style-name="P99"># absolute path to directory with initial data for JSBACH: </text:p>
- <text:p text:style-name="P99">LAND_MAP_DATA=<text:span text:style-name="T114">/pool/data/JSBACH/input/r0004</text:span>/T${RES} </text:p>
- <text:p text:style-name="P99"/>
- <text:p text:style-name="P99">#</text:p>
- <text:p text:style-name="P96"># ECHAM6 namelist </text:p>
- <text:p text:style-name="P96"># </text:p>
- <text:p text:style-name="P96">cat > namelist.echam << EOF </text:p>
- <text:p text:style-name="P101"><text:span text:style-name="T6">&</text:span>runctl </text:p>
- <text:p text:style-name="P101"><text:s text:c="4"/>lamip = .true.</text:p>
- <text:p text:style-name="P102">/</text:p>
- <text:p text:style-name="P96">EOF </text:p>
- <text:p text:style-name="P96"/>
- <text:p text:style-name="P96"># </text:p>
- <text:p text:style-name="P96"># JSBACH namelist</text:p>
- <text:p text:style-name="P96"># </text:p>
- <text:p text:style-name="P96">cat > namelist.jsbach << EOF </text:p>
- <text:p text:style-name="P102"><text:span text:style-name="T6">&</text:span>jsbach_ctl </text:p>
- <text:p text:style-name="P102"><text:s text:c="4"/>use_dynveg = .false.</text:p>
- <text:p text:style-name="P102">/</text:p>
- <text:p text:style-name="P96">EOF </text:p>
+ <text:p text:style-name="P98"><text:soft-page-break/>#! /bin/bash</text:p>
+ <text:p text:style-name="P98"/>
+ <text:p text:style-name="P98"># Job file to run ECHAM 6 </text:p>
+ <text:p text:style-name="P98"/>
+ <text:p text:style-name="P101">EXP=<text:span text:style-name="T112">joe1234</text:span> # experiment identifier </text:p>
+ <text:p text:style-name="P98"/>
+ <text:p text:style-name="P98">RES=<text:span text:style-name="T113">63</text:span><text:span text:style-name="T6"> # experiment truncation</text:span></text:p>
+ <text:p text:style-name="P98"/>
+ <text:p text:style-name="P98">#<text:span text:style-name="T6"> absolute paths to directories with initial data: </text:span></text:p>
+ <text:p text:style-name="P101">ATMO_DATA=<text:span text:style-name="T114">/pool/data/ECHAM6/input/r0004</text:span><text:span text:style-name="T5"> </text:span></text:p>
+ <text:p text:style-name="P101">ATMO_MAP_DATA=$ATMO_DATA/T${RES} </text:p>
+ <text:p text:style-name="P101"/>
+ <text:p text:style-name="P101"># absolute path to directory with initial data for JSBACH: </text:p>
+ <text:p text:style-name="P101">LAND_MAP_DATA=<text:span text:style-name="T114">/pool/data/JSBACH/input/r0004</text:span>/T${RES} </text:p>
+ <text:p text:style-name="P101"/>
+ <text:p text:style-name="P101">#</text:p>
+ <text:p text:style-name="P98"># ECHAM6 namelist </text:p>
+ <text:p text:style-name="P98"># </text:p>
+ <text:p text:style-name="P98">cat > namelist.echam << EOF </text:p>
+ <text:p text:style-name="P103"><text:span text:style-name="T6">&</text:span>runctl </text:p>
+ <text:p text:style-name="P103"><text:s text:c="4"/>lamip = .true.</text:p>
+ <text:p text:style-name="P104">/</text:p>
+ <text:p text:style-name="P98">EOF </text:p>
+ <text:p text:style-name="P98"/>
+ <text:p text:style-name="P98"># </text:p>
+ <text:p text:style-name="P98"># JSBACH namelist</text:p>
+ <text:p text:style-name="P98"># </text:p>
+ <text:p text:style-name="P98">cat > namelist.jsbach << EOF </text:p>
+ <text:p text:style-name="P104"><text:span text:style-name="T6">&</text:span>jsbach_ctl </text:p>
+ <text:p text:style-name="P104"><text:s text:c="4"/>use_dynveg = .false.</text:p>
+ <text:p text:style-name="P104">/</text:p>
+ <text:p text:style-name="P98">EOF </text:p>
<text:h text:style-name="Heading_20_3" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2526_1114405012"/><text:span text:style-name="T166">G</text:span>enerat<text:span text:style-name="T166">ing scripts only refers to the custom settings' file</text:span><text:bookmark-end text:name="__RefHeading__2526_1114405012"/></text:h>
<text:p text:style-name="P13"><text:span text:style-name="T165">So, as soon as</text:span> <text:span text:style-name="T165">you have set up '</text:span>joe1234.config<text:span text:style-name="T165">'</text:span>, you may create the job scripts that are needed to run your experiment. Still within ECHAM's <text:span text:style-name="T167">'</text:span>run<text:span text:style-name="T167">'</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="T124">read all configuration information and </text:span>create all job scripts that are defined within your experiment's setup, <text:span text:style-name="T124">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="T124">scripts </text:span>in <text:span text:style-name="T124">a common</text:span> directory defined by the .config variable <text:span text:style-name="T167">'</text:span>SCRIPT_DIR<text:span text:style-name="T167">'</text:span>, and <text:span text:style-name="T167">print</text:span> the name of this directory on your terminal.</text:p>
- <text:h text:style-name="P211" text:outline-level="1"><text:bookmark-start text:name="__RefHeading__2528_1114405012"/>Details on <text:span text:style-name="T185">experiment</text:span> <text:span text:style-name="T185">definition</text:span><text:bookmark-end text:name="__RefHeading__2528_1114405012"/></text:h>
+ <text:h text:style-name="P215" text:outline-level="1"><text:bookmark-start text:name="__RefHeading__2528_1114405012"/>Details on <text:span text:style-name="T185">experiment</text:span> <text:span text:style-name="T185">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="T38">.</text:span></text:p>
- <text:h text:style-name="P228" 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="P232" 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="T147">is organized</text:span> <text:span text:style-name="T147">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="T146">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="T44">, it refers to this system level.</text:span></text:p>
<text:p text:style-name="P34"><text:span text:style-name="T146">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="T146">: 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="T43">. 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="T43">.</text:span></text:p>
<text:p text:style-name="P35"><text:span text:style-name="T38">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="T75">defines</text:span><text:span text:style-name="T38"> 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="T38">.</text:span></text:p>
<text:p text:style-name="P36"><text:span text:style-name="T38">All levels should make a clear distinction </text:span><text:span text:style-name="T45">between </text:span><text:span text:style-name="T38">the .config files, containing the experiment's configuration information, </text:span><text:span text:style-name="T45">and </text:span><text:span text:style-name="T38">the .tmpl files, containing the actual job description and job control syntax.</text:span></text:p>
- <text:h text:style-name="P229" 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="P233" 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="P82"><text:span text:style-name="T124">The </text:span><text:span text:style-name="T32">mkexp</text:span><text:span text:style-name="T124"> 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="T23">file</text:span><text:span text:style-name="T56">.</text:span><text:span text:style-name="T38">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="P182"><text:span text:style-name="T124">This is the main tool for generating an experiment setup. It </text:span>takes <text:span text:style-name="T168">the given</text:span> <text:span text:style-name="T168">user setup</text:span> and <text:span text:style-name="T187">the model setup that is referenced by the user setup </text:span>to generate <text:span text:style-name="T168">the</text:span> <text:span text:style-name="T168">job description files or</text:span> scripts that <text:span text:style-name="T187">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="T56">config</text:span><text:span text:style-name="T168">.</text:span></text:p>
- <text:p text:style-name="P186">When running, <text:span text:style-name="T9">mkexp</text:span><text:span text:style-name="T38"> 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="P185">mkexp<text:span text:style-name="T38"> allows to override </text:span><text:span text:style-name="T54">or amend </text:span><text:span text:style-name="T38">the .config file settings on the command line </text:span><text:span text:style-name="T54">by defining or re-defining a variable </text:span><text:span text:style-name="T169">name</text:span><text:span text:style-name="T54"> set to </text:span><text:span text:style-name="T169">value</text:span><text:span text:style-name="T54">. Section variables are referenced as </text:span><text:span text:style-name="T169">sectionname</text:span><text:span text:style-name="T54">.</text:span><text:span text:style-name="T169">variablename</text:span><text:span text:style-name="T54">. 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="T54">'..', thus it is not possible to use variable names th</text:span><text:span text:style-name="T76">at</text:span><text:span text:style-name="T54"> </text:span><text:span text:style-name="T169">end</text:span><text:span text:style-name="T54"> </text:span><text:span text:style-name="T76">i</text:span><text:span text:style-name="T54">n a period.</text:span></text:p>
- <text:p text:style-name="P195"><text:span text:style-name="T54">g</text:span><text:span text:style-name="T38">etexp [-v] </text:span><text:span text:style-name="T9">file</text:span><text:span text:style-name="T38">.config [</text:span><text:span text:style-name="T9">name</text:span><text:span text:style-name="T38">=</text:span><text:span text:style-name="T9">value ...</text:span><text:span text:style-name="T38">]</text:span></text:p>
- <text:p text:style-name="P183">getexp<text:span text:style-name="T38"> reads the experiment setup the same way </text:span><text:span text:style-name="T76">as</text:span><text:span text:style-name="T38"> </text:span>mkexp<text:span text:style-name="T38">, 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="P187"><text:span text:style-name="T38">When given the '-v' (verbose) option, </text:span><text:span text:style-name="T9">all</text:span><text:span text:style-name="T38"> global configuration variables and their values are printed in alphabetical order.</text:span></text:p>
- <text:p text:style-name="P194">diffexp <text:span text:style-name="T22">file</text:span><text:span text:style-name="T23">1</text:span><text:span text:style-name="T170">.config </text:span><text:span text:style-name="T22">file2</text:span><text:span text:style-name="T55">.</text:span><text:span text:style-name="T56">config</text:span></text:p>
- <text:p text:style-name="P175">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="P196">rmexp <text:span text:style-name="T24">file</text:span><text:span text:style-name="T171">.config</text:span><text:span text:style-name="T57"> [</text:span><text:span text:style-name="T24">name</text:span><text:span text:style-name="T57">=</text:span><text:span text:style-name="T24">value ...</text:span><text:span text:style-name="T57">]</text:span></text:p>
- <text:p text:style-name="P188">This allows <text:span text:style-name="T174">interactive </text:span>remov<text:span text:style-name="T174">al for </text:span>all scripting and run-time data of an experiment without having to deal with path names, as these are read from the configuration.</text:p>
- <text:h text:style-name="P230" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__2534_1114405012"/><text:span text:style-name="T130">F</text:span>ormat of .config files<text:bookmark-end text:name="__RefHeading__2534_1114405012"/></text:h>
+ <text:p text:style-name="P186"><text:span text:style-name="T124">This is the main tool for generating an experiment setup. It </text:span>takes <text:span text:style-name="T168">the given</text:span> <text:span text:style-name="T168">user setup</text:span> and <text:span text:style-name="T187">the model setup that is referenced by the user setup </text:span>to generate <text:span text:style-name="T168">the</text:span> <text:span text:style-name="T168">job description files or</text:span> scripts that <text:span text:style-name="T187">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="T56">config</text:span><text:span text:style-name="T168">.</text:span></text:p>
+ <text:p text:style-name="P190">When running, <text:span text:style-name="T9">mkexp</text:span><text:span text:style-name="T38"> 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="P189">mkexp<text:span text:style-name="T38"> allows to override </text:span><text:span text:style-name="T54">or amend </text:span><text:span text:style-name="T38">the .config file settings on the command line </text:span><text:span text:style-name="T54">by defining or re-defining a variable </text:span><text:span text:style-name="T169">name</text:span><text:span text:style-name="T54"> set to </text:span><text:span text:style-name="T169">value</text:span><text:span text:style-name="T54">. Section variables are referenced as </text:span><text:span text:style-name="T169">sectionname</text:span><text:span text:style-name="T54">.</text:span><text:span text:style-name="T169">variablename</text:span><text:span text:style-name="T54">. 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="T54">'..', thus it is not possible to use variable names th</text:span><text:span text:style-name="T76">at</text:span><text:span text:style-name="T54"> </text:span><text:span text:style-name="T169">end</text:span><text:span text:style-name="T54"> </text:span><text:span text:style-name="T76">i</text:span><text:span text:style-name="T54">n a period.</text:span></text:p>
+ <text:p text:style-name="P199"><text:span text:style-name="T54">g</text:span><text:span text:style-name="T38">etexp [-v] </text:span><text:span text:style-name="T9">file</text:span><text:span text:style-name="T38">.config [</text:span><text:span text:style-name="T9">name</text:span><text:span text:style-name="T38">=</text:span><text:span text:style-name="T9">value ...</text:span><text:span text:style-name="T38">]</text:span></text:p>
+ <text:p text:style-name="P187">getexp<text:span text:style-name="T38"> reads the experiment setup the same way </text:span><text:span text:style-name="T76">as</text:span><text:span text:style-name="T38"> </text:span>mkexp<text:span text:style-name="T38">, 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="P191"><text:span text:style-name="T38">When given the '-v' (verbose) option, </text:span><text:span text:style-name="T9">all</text:span><text:span text:style-name="T38"> global configuration variables and their values are printed in alphabetical order.</text:span></text:p>
+ <text:p text:style-name="P198">diffexp <text:span text:style-name="T22">file</text:span><text:span text:style-name="T23">1</text:span><text:span text:style-name="T170">.config </text:span><text:span text:style-name="T22">file2</text:span><text:span text:style-name="T55">.</text:span><text:span text:style-name="T56">config</text:span></text:p>
+ <text:p text:style-name="P179">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="P200">rmexp <text:span text:style-name="T24">file</text:span><text:span text:style-name="T171">.config</text:span><text:span text:style-name="T57"> [</text:span><text:span text:style-name="T24">name</text:span><text:span text:style-name="T57">=</text:span><text:span text:style-name="T24">value ...</text:span><text:span text:style-name="T57">]</text:span></text:p>
+ <text:p text:style-name="P192">This allows <text:span text:style-name="T174">interactive </text:span>remov<text:span text:style-name="T174">al for </text:span>all scripting and run-time data of an experiment without having to deal with path names, as these are read from the configuration.</text:p>
+ <text:h text:style-name="P234" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__2534_1114405012"/><text:span text:style-name="T130">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="T125">For reading these files, </text:span><text:span text:style-name="T12">mkexp</text:span><text:span text:style-name="T125"> uses the </text:span><text:span text:style-name="T12">configobj</text:span><text:span text:style-name="T125"> 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="T126">configuration variable is set by simply assigning a text value to a name, as in</text:span></text:p>
@@ -2091,64 +2112,64 @@
<text:p text:style-name="P21">will set PATH to ['/bin', '/usr/bin', '/usr/local/bin'].</text:p>
<text:h text:style-name="Heading_20_3" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2536_1114405012"/>Sections<text:bookmark-end text:name="__RefHeading__2536_1114405012"/></text:h>
<text:p text:style-name="P22">Variable assignments may be contained in <text:span text:style-name="T9">sections</text:span><text:span text:style-name="T38">. They </text:span><text:span text:style-name="T40">group</text:span><text:span text:style-name="T38"> a set of variables that may be treated </text:span><text:span text:style-name="T77">in a way </text:span><text:span text:style-name="T38">different fro</text:span><text:span text:style-name="T77">m</text:span><text:span text:style-name="T38"> the global variables. Sections are created by a section name on a line by itself, enclosed by brackets. Any variables defined later in the .config file belong to this section:</text:span></text:p>
- <text:p text:style-name="P114">[section1]</text:p>
- <text:p text:style-name="P114"><text:s text:c="4"/>description = This is the first section</text:p>
+ <text:p text:style-name="P116">[section1]</text:p>
+ <text:p text:style-name="P116"><text:s text:c="4"/>description = This is the first section</text:p>
<text:p text:style-name="P22">will be stored as a dictionary section1 with section1['description'] set to 'This is the first section'.</text:p>
<text:p text:style-name="P22">Sections may be nested to arbitrary depth by incrementing the number of bracket pairs <text:span text:style-name="T128">as in</text:span></text:p>
<text:p text:style-name="Preformatted_20_Text">[section1]</text:p>
<text:p text:style-name="Preformatted_20_Text"><text:s text:c="4"/>description = This is the first section</text:p>
<text:p text:style-name="Preformatted_20_Text"><text:s text:c="4"/>[[subsection1a]]</text:p>
<text:p text:style-name="Preformatted_20_Text"><text:s text:c="8"/>description = This is the first sub section of the first section</text:p>
- <text:p text:style-name="P109"><text:s text:c="4"/>[[subsection1<text:span text:style-name="T128">b</text:span>]]</text:p>
- <text:p text:style-name="P109"><text:s text:c="8"/>description = This is the <text:span text:style-name="T128">second</text:span> sub section of the first section</text:p>
- <text:p text:style-name="P108">[section2]</text:p>
- <text:p text:style-name="P108"><text:s text:c="4"/>description = This is the second section </text:p>
+ <text:p text:style-name="P111"><text:s text:c="4"/>[[subsection1<text:span text:style-name="T128">b</text:span>]]</text:p>
+ <text:p text:style-name="P111"><text:s text:c="8"/>description = This is the <text:span text:style-name="T128">second</text:span> sub section of the first section</text:p>
+ <text:p text:style-name="P110">[section2]</text:p>
+ <text:p text:style-name="P110"><text:s text:c="4"/>description = This is the second section </text:p>
<text:p text:style-name="P23"><text:span text:style-name="T172">A s</text:span>ection <text:span text:style-name="T172">is</text:span> closed by the beginning of a new section of the same level, by a section <text:span text:style-name="T172">of </text:span>l<text:span text:style-name="T172">ower</text:span> <text:span text:style-name="T172">nesting </text:span>depth, <text:span text:style-name="T172">or the end of the .config file</text:span>. Thus, section1 will contain 'description' and two dictionaries 'subsection1' and 'subsection2', each of those containing their own 'description'. 'section2' then is a top-level dictionary, again with its own 'description' variable.</text:p>
<text:p text:style-name="P23">Note that indentation may be used to make the file more legible but is completely ignored when the file is loaded. The number of brackets is the only way to define the level of a section. This means that all variables in a section must be defined before any subsections. Otherwise, the variable <text:s/>would be<text:span text:style-name="T129">long</text:span> to the respective subsection.</text:p>
<text:p text:style-name="P22">Fortran scholars will also want to note that names are case-sensitive, i.e. the variable 'NAME' is quite different from 'name'. Usually, setups use upper-case names for global variables and lower-case names for sections and their variables.</text:p>
<text:h text:style-name="Heading_20_3" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2538_1114405012"/>Special <text:span text:style-name="T164">v</text:span>ariables <text:span text:style-name="T164">and sections</text:span><text:bookmark-end text:name="__RefHeading__2538_1114405012"/></text:h>
<text:p text:style-name="P39"><text:span text:style-name="T38">There are a number of special variables that influence the way </text:span>mkexp<text:span text:style-name="T38"> works. They must be present in one of the .config files, unless noted otherwise below. </text:span><text:span text:style-name="T42">They are </text:span><text:soft-page-break/><text:span text:style-name="T42">listed here for a first overview. Their exact meaning is explained in more detail in the upcoming sections.</text:span></text:p>
<text:p text:style-name="P40"><text:span text:style-name="T42">T</text:span><text:span text:style-name="T38">he first set of variables is usually defined in the model setup:</text:span></text:p>
- <text:p text:style-name="P154">SCRIPT_DIR</text:p>
- <text:p text:style-name="P167"><text:span text:style-name="T41">D</text:span><text:span text:style-name="T38">irectory where the generated job descriptions are stored. This directory and its parents are created by </text:span><text:span text:style-name="T9">mkexp</text:span><text:span text:style-name="T38"> if they do not exist.</text:span></text:p>
- <text:p text:style-name="P155">WORK_DIR</text:p>
- <text:p text:style-name="P170">Directory where the experiment is run. The jobs will use this for providing input data and configuration files needed for model execution. This directory and its parents are created if they do not exist.</text:p>
- <text:p text:style-name="P156">DATA_DIR</text:p>
- <text:p text:style-name="P170">Directory for storing output data. When a model run finishes, output will be stored there for further processing. Will also be created when non-existent.</text:p>
- <text:p text:style-name="P160">VERSION_</text:p>
- <text:p text:style-name="P176">Each .config file in the model setup <text:span text:style-name="T202">should</text:span> set this variable to a suitable value, e.g. version control information. The values are collected in a variable 'VERSIONS_' which is usually written to the resulting job descriptions.</text:p>
+ <text:p text:style-name="P158">SCRIPT_DIR</text:p>
+ <text:p text:style-name="P171"><text:span text:style-name="T41">D</text:span><text:span text:style-name="T38">irectory where the generated job descriptions are stored. This directory and its parents are created by </text:span><text:span text:style-name="T9">mkexp</text:span><text:span text:style-name="T38"> if they do not exist.</text:span></text:p>
+ <text:p text:style-name="P159">WORK_DIR</text:p>
+ <text:p text:style-name="P174">Directory where the experiment is run. The jobs will use this for providing input data and configuration files needed for model execution. This directory and its parents are created if they do not exist.</text:p>
+ <text:p text:style-name="P160">DATA_DIR</text:p>
+ <text:p text:style-name="P174">Directory for storing output data. When a model run finishes, output will be stored there for further processing. Will also be created when non-existent.</text:p>
+ <text:p text:style-name="P164">VERSION_</text:p>
+ <text:p text:style-name="P180">Each .config file in the model setup <text:span text:style-name="T202">should</text:span> set this variable to a suitable value, e.g. version control information. The values are collected in a variable 'VERSIONS_' which is usually written to the resulting job descriptions.</text:p>
<text:p text:style-name="P41">There is a second set of variables that belongs in the user setup:</text:p>
- <text:p text:style-name="P158">EXP_TYPE</text:p>
- <text:p text:style-name="P172">Selects one of the standard experiments that are pre-defined in the model setup as basis of the current experiment definition.</text:p>
- <text:p text:style-name="P159">ENVIRONMENT</text:p>
- <text:p text:style-name="P169">Selects one of the standard host environments that are available for the model.</text:p>
- <text:p text:style-name="P163"><text:span text:style-name="T38">EXP_OPTIONS (</text:span><text:span text:style-name="T9">optional</text:span><text:span text:style-name="T38">)</text:span></text:p>
- <text:p text:style-name="P173">Subset of the model's standard options that should be applied to the current experiment definition.</text:p>
- <text:p text:style-name="P164">EXP_ID (<text:span text:style-name="T9">optional</text:span>)</text:p>
- <text:p text:style-name="P180">Name of the experiment to be created. If not set, this will be set to the base name of the user's .config file, e.g. 'joe1234' in the introductory example. All job description files will carry this as the first part of their name. For almost all model setups, this will be used in the definitions of SCRIPT_DIR, WORK_DIR, and DATA_DIR.</text:p>
- <text:p text:style-name="P153">EXP_DESCRIPTION <text:span text:style-name="T145">(</text:span><text:span text:style-name="T16">optional</text:span><text:span text:style-name="T145">)</text:span></text:p>
- <text:p text:style-name="P171">Extensive description of the experiment to be created. If not set, this will contain all text in the header comment of the user's .config file. The leading comment characters and leading and trailing empty lines are removed. Note that <text:span text:style-name="T188">both header comment and </text:span>EXP_DESCRIPTION may reference any other global variable defined in the experiment configuration <text:span text:style-name="T188">(see section </text:span><text:span text:style-name="T188"><text:bookmark-ref text:reference-format="chapter" text:ref-name="__RefHeading__2540_1114405012">2.3.4</text:bookmark-ref></text:span><text:span text:style-name="T188">)</text:span>.</text:p>
- <text:p text:style-name="P171">The contents of this variable is written to a 'README' file in SCRIPT_DIR.</text:p>
+ <text:p text:style-name="P162">EXP_TYPE</text:p>
+ <text:p text:style-name="P176">Selects one of the standard experiments that are pre-defined in the model setup as basis of the current experiment definition.</text:p>
+ <text:p text:style-name="P163">ENVIRONMENT</text:p>
+ <text:p text:style-name="P173">Selects one of the standard host environments that are available for the model.</text:p>
+ <text:p text:style-name="P167"><text:span text:style-name="T38">EXP_OPTIONS (</text:span><text:span text:style-name="T9">optional</text:span><text:span text:style-name="T38">)</text:span></text:p>
+ <text:p text:style-name="P177">Subset of the model's standard options that should be applied to the current experiment definition.</text:p>
+ <text:p text:style-name="P168">EXP_ID (<text:span text:style-name="T9">optional</text:span>)</text:p>
+ <text:p text:style-name="P184">Name of the experiment to be created. If not set, this will be set to the base name of the user's .config file, e.g. 'joe1234' in the introductory example. All job description files will carry this as the first part of their name. For almost all model setups, this will be used in the definitions of SCRIPT_DIR, WORK_DIR, and DATA_DIR.</text:p>
+ <text:p text:style-name="P157">EXP_DESCRIPTION <text:span text:style-name="T145">(</text:span><text:span text:style-name="T16">optional</text:span><text:span text:style-name="T145">)</text:span></text:p>
+ <text:p text:style-name="P175">Extensive description of the experiment to be created. If not set, this will contain all text in the header comment of the user's .config file. The leading comment characters and leading and trailing empty lines are removed. Note that <text:span text:style-name="T188">both header comment and </text:span>EXP_DESCRIPTION may reference any other global variable defined in the experiment configuration <text:span text:style-name="T188">(see section </text:span><text:span text:style-name="T188"><text:bookmark-ref text:reference-format="chapter" text:ref-name="__RefHeading__2540_1114405012">2.3.4</text:bookmark-ref></text:span><text:span text:style-name="T188">)</text:span>.</text:p>
+ <text:p text:style-name="P175">The contents of this variable is written to a 'README' file in SCRIPT_DIR.</text:p>
<text:p text:style-name="P38"><text:span text:style-name="T38">Another set of variables is automatically added to the job specific experiment configuration. </text:span><text:span text:style-name="T53">These are considered read-only</text:span><text:span text:style-name="T38"> </text:span><text:span text:style-name="T46">and may not be altered</text:span><text:span text:style-name="T38">.</text:span></text:p>
- <text:p text:style-name="P152"><text:soft-page-break/>JOB</text:p>
- <text:p text:style-name="P168">A dictionary of system settings pertaining to the current job.</text:p>
- <text:p text:style-name="P157">VARIABLES_</text:p>
- <text:p text:style-name="P174">List of all names that were recognized as native variables of the current job. May be used to maintain a variable definition list in the generated script.</text:p>
- <text:p text:style-name="P165"><text:span text:style-name="T50">m</text:span><text:span text:style-name="T38">kexp_input</text:span></text:p>
- <text:p text:style-name="P177">Descriptive string for script headers. It is set to 'Generated by … mkexp …' where the ellipses are filled with version information.</text:p>
- <text:p text:style-name="P160">VERSIONS_</text:p>
- <text:p text:style-name="P176">List of all 'VERSION_' strings that were found in the different .config files.</text:p>
+ <text:p text:style-name="P156"><text:soft-page-break/>JOB</text:p>
+ <text:p text:style-name="P172">A dictionary of system settings pertaining to the current job.</text:p>
+ <text:p text:style-name="P161">VARIABLES_</text:p>
+ <text:p text:style-name="P178">List of all names that were recognized as native variables of the current job. May be used to maintain a variable definition list in the generated script.</text:p>
+ <text:p text:style-name="P169"><text:span text:style-name="T50">m</text:span><text:span text:style-name="T38">kexp_input</text:span></text:p>
+ <text:p text:style-name="P181">Descriptive string for script headers. It is set to 'Generated by … mkexp …' where the ellipses are filled with version information.</text:p>
+ <text:p text:style-name="P164">VERSIONS_</text:p>
+ <text:p text:style-name="P180">List of all 'VERSION_' strings that were found in the different .config files.</text:p>
<text:p text:style-name="P64">These special sections are usually pre-defined in the model setup, but are commonly altered by the user.</text:p>
<text:p text:style-name="List_20_Heading">[jobs]</text:p>
- <text:p text:style-name="P181">This section defines the job description set needed for an experiment. It also provides job specific settings. Details are given in section <text:bookmark-ref text:reference-format="chapter" text:ref-name="__RefHeading__1508_1711940803">2.8</text:bookmark-ref>, '<text:bookmark-ref text:reference-format="text" text:ref-name="__RefHeading__1508_1711940803">Generating jobs</text:bookmark-ref>'.</text:p>
+ <text:p text:style-name="P185">This section defines the job description set needed for an experiment. It also provides job specific settings. Details are given in section <text:bookmark-ref text:reference-format="chapter" text:ref-name="__RefHeading__1508_1711940803">2.8</text:bookmark-ref>, '<text:bookmark-ref text:reference-format="text" text:ref-name="__RefHeading__1508_1711940803">Generating jobs</text:bookmark-ref>'.</text:p>
<text:p text:style-name="List_20_Heading">[namelists]</text:p>
- <text:p text:style-name="P181">Information that is contained in model configuration or namelist files is set in this section. For further details see section <text:bookmark-ref text:reference-format="chapter" text:ref-name="__RefHeading__1883_1672291846">2.9</text:bookmark-ref>, <text:span text:style-name="T177">'</text:span><text:span text:style-name="T177"><text:bookmark-ref text:reference-format="text" text:ref-name="__RefHeading__1883_1672291846">Defining namelists and other configuration files</text:bookmark-ref></text:span><text:span text:style-name="T177">'.</text:span></text:p>
- <text:p text:style-name="P166">[files]</text:p>
- <text:p text:style-name="P193">All input files that are needed for an experiment and <text:span text:style-name="T199">information</text:span> to provide them go into this section. <text:span text:style-name="T199">See section </text:span><text:span text:style-name="T199"><text:bookmark-ref text:reference-format="chapter" text:ref-name="__RefHeading__2831_1132221942">2.10</text:bookmark-ref></text:span><text:span text:style-name="T199">, '</text:span><text:span text:style-name="T199"><text:bookmark-ref text:reference-format="text" text:ref-name="__RefHeading__2831_1132221942">Defining input files for an experiment</text:bookmark-ref></text:span><text:span text:style-name="T199">'.</text:span></text:p>
+ <text:p text:style-name="P185">Information that is contained in model configuration or namelist files is set in this section. For further details see section <text:bookmark-ref text:reference-format="chapter" text:ref-name="__RefHeading__1883_1672291846">2.9</text:bookmark-ref>, <text:span text:style-name="T177">'</text:span><text:span text:style-name="T177"><text:bookmark-ref text:reference-format="text" text:ref-name="__RefHeading__1883_1672291846">Defining namelists and other configuration files</text:bookmark-ref></text:span><text:span text:style-name="T177">'.</text:span></text:p>
+ <text:p text:style-name="P170">[files]</text:p>
+ <text:p text:style-name="P197">All input files that are needed for an experiment and <text:span text:style-name="T199">information</text:span> to provide them go into this section. <text:span text:style-name="T199">See section </text:span><text:span text:style-name="T199"><text:bookmark-ref text:reference-format="chapter" text:ref-name="__RefHeading__2831_1132221942">2.10</text:bookmark-ref></text:span><text:span text:style-name="T199">, '</text:span><text:span text:style-name="T199"><text:bookmark-ref text:reference-format="text" text:ref-name="__RefHeading__2831_1132221942">Defining input files for an experiment</text:bookmark-ref></text:span><text:span text:style-name="T199">'.</text:span></text:p>
<text:h text:style-name="Heading_20_3" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2540_1114405012"/>Variable interpolation<text:bookmark-end text:name="__RefHeading__2540_1114405012"/></text:h>
<text:p text:style-name="P71">The value of a .config variable may reference the value of another variable by prefixing its name with <text:span text:style-name="T178">a </text:span>dollar sign. <text:span text:style-name="T178">This is called </text:span><text:span text:style-name="T26">interpolation</text:span><text:span text:style-name="T64"> of variables. E.g.</text:span></text:p>
- <text:p text:style-name="P142"># joe1234.config</text:p>
- <text:p text:style-name="P148">WORK_ROOT = /scratch/joe</text:p>
+ <text:p text:style-name="P144"># joe1234.config</text:p>
+ <text:p text:style-name="P150">WORK_ROOT = /scratch/joe</text:p>
<text:p text:style-name="Preformatted_20_Text">WORK_DIR = $WORK_ROOT/experiments/<text:span text:style-name="T179">$EXP_ID</text:span></text:p>
<text:p text:style-name="P73">will set 'WORK_DIR' to '/scratch/joe/experiments/joe1234'.</text:p>
<text:p text:style-name="P72">Interpolation only works for variables of the current section or its ancestor sections.</text:p>
@@ -2161,20 +2182,20 @@
<text:p text:style-name="P72">because 'size' is not defined in 'jobs', nor on the global level.</text:p>
<text:p text:style-name="P74"><text:soft-page-break/>As in shell scripts, the variable name must be enclosed in braces if the interpolation continues with a word character (alphanumerical or underscore), or if the variable name contains a space (which is perfectly legal):</text:p>
<text:p text:style-name="Preformatted_20_Text">WORK_DIR = /tmp/$EXP_ID_test <text:s text:c="3"/><text:span text:style-name="T179"># ERROR: missing option "EXP_ID_test"</text:span></text:p>
- <text:p text:style-name="P143"><text:span text:style-name="T179">WORK_DIR = /tmp/</text:span><text:span text:style-name="T119">${EXP_ID}_test</text:span><text:span text:style-name="T179"> <text:s/># OK</text:span></text:p>
- <text:p text:style-name="P142"/>
- <text:p text:style-name="P142">SPACY <text:span text:style-name="T180">VAR</text:span> = Whew! </text:p>
- <text:p text:style-name="P142"><text:span text:style-name="T180">MESSAGE</text:span> = He said: $SPACY VAR <text:s text:c="2"/><text:span text:style-name="T180"># ERROR: missing option </text:span>"<text:span text:style-name="T180">SPACY</text:span>"</text:p>
- <text:p text:style-name="P144">MESSAGE = <text:span text:style-name="T179">He said: </text:span><text:span text:style-name="T119">$</text:span><text:span text:style-name="T112">{</text:span><text:span text:style-name="T119">SPACY VAR</text:span><text:span text:style-name="T112">}</text:span> # OK</text:p>
+ <text:p text:style-name="P145"><text:span text:style-name="T179">WORK_DIR = /tmp/</text:span><text:span text:style-name="T119">${EXP_ID}_test</text:span><text:span text:style-name="T179"> <text:s/># OK</text:span></text:p>
+ <text:p text:style-name="P144"/>
+ <text:p text:style-name="P144">SPACY <text:span text:style-name="T180">VAR</text:span> = Whew! </text:p>
+ <text:p text:style-name="P144"><text:span text:style-name="T180">MESSAGE</text:span> = He said: $SPACY VAR <text:s text:c="2"/><text:span text:style-name="T180"># ERROR: missing option </text:span>"<text:span text:style-name="T180">SPACY</text:span>"</text:p>
+ <text:p text:style-name="P146">MESSAGE = <text:span text:style-name="T179">He said: </text:span><text:span text:style-name="T119">$</text:span><text:span text:style-name="T112">{</text:span><text:span text:style-name="T119">SPACY VAR</text:span><text:span text:style-name="T112">}</text:span> # OK</text:p>
<text:p text:style-name="P74">The user<text:span text:style-name="T189">'</text:span>s <text:span text:style-name="T9">environment variables</text:span> may be referenced as global variables in a .config file. Thus a user may write something like</text:p>
<text:p text:style-name="Preformatted_20_Text">SCRIPT_ROOT = $HOME/experiments/$EXP_ID</text:p>
<text:p text:style-name="P74">setting 'SCRIPT_ROOT' to a subdirectory of the user's home directory.</text:p>
<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="P75">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="P145"># model setup</text:p>
- <text:p text:style-name="P203"><text:span text:style-name="T181">MODEL</text:span>_<text:span text:style-name="T181">DIR</text:span> = $HOME/<text:span text:style-name="T181">$MODEL_SUBDIR</text:span></text:p>
- <text:p text:style-name="P146"># user setup</text:p>
- <text:p text:style-name="P146">MODEL_SUBDIR = echam</text:p>
+ <text:p text:style-name="P147"># model setup</text:p>
+ <text:p text:style-name="P207"><text:span text:style-name="T181">MODEL</text:span>_<text:span text:style-name="T181">DIR</text:span> = $HOME/<text:span text:style-name="T181">$MODEL_SUBDIR</text:span></text:p>
+ <text:p text:style-name="P148"># user setup</text:p>
+ <text:p text:style-name="P148">MODEL_SUBDIR = echam</text:p>
<text:p text:style-name="P76">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="T182">This works, because i</text:span>nterpolation of 'MODEL_ROOT's value is postponed until all levels of setup have been read.</text:p>
<text:p text:style-name="P76">The disadvantage is that there may be no incremental adding of values to a given variable because this would cause circular dependencies. Imagine</text:p>
<text:p text:style-name="Preformatted_20_Text">SUBMODELS = $SUBMODELS jsbach</text:p>
@@ -2182,21 +2203,21 @@
<text:p text:style-name="Preformatted_20_Text"><text:soft-page-break/>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="P78">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="T38"> includes some special expressions, that are evaluated when interpolation occurs.</text:span></text:p>
- <text:p text:style-name="P197"><text:span text:style-name="T9">variable</text:span><text:span text:style-name="T38"> = </text:span><text:span text:style-name="T108">eval(</text:span><text:span text:style-name="T9">expression</text:span><text:span text:style-name="T108">)</text:span><text:span text:style-name="T38"><text:line-break/></text:span><text:span text:style-name="T9">variable</text:span><text:span text:style-name="T38"> = </text:span><text:span text:style-name="T108">evals(</text:span><text:span text:style-name="T9">expression</text:span><text:span text:style-name="T108">)</text:span></text:p>
- <text:p text:style-name="P189"><text:span text:style-name="T68">I</text:span><text:span text:style-name="T38">nterpret </text:span><text:span text:style-name="T9">expression</text:span><text:span text:style-name="T38"> 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="T38"> 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="T38"> will return a list of strings, while </text:span><text:span text:style-name="T9">evals</text:span><text:span text:style-name="T38"> will return a single string, where elements are joined by a comma and a space.</text:span></text:p>
- <text:p text:style-name="P189"><text:span text:style-name="T38">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="T65">to a string containing a Python list expression</text:span><text:span text:style-name="T38">, and </text:span><text:span text:style-name="T65">then </text:span><text:span text:style-name="T38">use </text:span><text:span text:style-name="T9">eval</text:span><text:span text:style-name="T38"> </text:span><text:span text:style-name="T78">a</text:span><text:span text:style-name="T38">round the interpolation expression:</text:span></text:p>
- <text:p text:style-name="P204">DATE_<text:span text:style-name="T190">STRING</text:span> = '[2010, 10, 20]' # need quotes here!</text:p>
- <text:p text:style-name="P204">DATE_<text:span text:style-name="T190">LIST</text:span> = eval($DATE_<text:span text:style-name="T191">STRING</text:span>) # becomes a 3 element list</text:p>
- <text:p text:style-name="P198">variable<text:span text:style-name="T38"> = </text:span><text:span text:style-name="T108">read(</text:span>file_name<text:span text:style-name="T108">)</text:span></text:p>
- <text:p text:style-name="P184"><text:span text:style-name="T38">Read the contents of the file </text:span>file_name<text:span text:style-name="T38"> and assign its contents to </text:span>variable<text:span text:style-name="T38"> as a string.</text:span></text:p>
- <text:p text:style-name="P199"><text:span text:style-name="T27">variable</text:span><text:span text:style-name="T66"> = </text:span><text:span text:style-name="T110">split_date(</text:span><text:span text:style-name="T27">timestamp</text:span><text:span text:style-name="T110">)</text:span></text:p>
- <text:p text:style-name="P190"><text:span text:style-name="T183">T</text:span>ake <text:span text:style-name="T9">timestamp</text:span><text:span text:style-name="T38"> 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="T38"> </text:span><text:span text:style-name="T67">must have </text:span><text:span text:style-name="T38">an ISO-like format (date elements separated by '-'; 'T' or space as date/time separator; time elements separated by ':</text:span><text:span text:style-name="T67">'; </text:span><text:span text:style-name="T38">trailing time elements </text:span><text:span text:style-name="T68">and their separators </text:span><text:span text:style-name="T67">are optional</text:span><text:span text:style-name="T38">; time zone indicator is not supported). </text:span><text:span text:style-name="T80">Unlike ISO, </text:span><text:span text:style-name="T31">split_date</text:span><text:span text:style-name="T80"> also</text:span><text:span text:style-name="T38"> </text:span><text:span text:style-name="T80">allows the date to be in the form YYYYMMDD</text:span><text:span text:style-name="T38">. </text:span><text:span text:style-name="T68">Unset fields default to zero.</text:span></text:p>
- <text:p text:style-name="P200"><text:span text:style-name="T9">variable</text:span><text:span text:style-name="T38"> = </text:span><text:span text:style-name="T108">sec2time(</text:span><text:span text:style-name="T9">second_of_day</text:span><text:span text:style-name="T108">)</text:span></text:p>
- <text:p text:style-name="P178">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="P201"><text:span text:style-name="T9">variable</text:span> = '<text:span text:style-name="T112">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="P191">Take integer <text:span text:style-name="T9">offset</text:span><text:span text:style-name="T38"> (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="T38"> and return the resulting date string.</text:span></text:p>
- <text:p text:style-name="P202"><text:span text:style-name="T9">variable</text:span> = '<text:span text:style-name="T112">add_</text:span><text:span text:style-name="T120">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="P192"><text:span text:style-name="T38">Take integer </text:span><text:span text:style-name="T9">offset</text:span><text:span text:style-name="T38"> (may be negative), add it to the </text:span><text:span text:style-name="T81">day</text:span><text:span text:style-name="T38"> portion of </text:span><text:span text:style-name="T9">datestamp</text:span><text:span text:style-name="T38"> and return the resulting date string. </text:span><text:span text:style-name="T81">Year and month portions will be set as </text:span><text:soft-page-break/><text:span text:style-name="T81">appropriate, assuming a Proleptic Gregorian calendar with year 0.</text:span></text:p>
+ <text:p text:style-name="P201"><text:span text:style-name="T9">variable</text:span><text:span text:style-name="T38"> = </text:span><text:span text:style-name="T108">eval(</text:span><text:span text:style-name="T9">expression</text:span><text:span text:style-name="T108">)</text:span><text:span text:style-name="T38"><text:line-break/></text:span><text:span text:style-name="T9">variable</text:span><text:span text:style-name="T38"> = </text:span><text:span text:style-name="T108">evals(</text:span><text:span text:style-name="T9">expression</text:span><text:span text:style-name="T108">)</text:span></text:p>
+ <text:p text:style-name="P193"><text:span text:style-name="T68">I</text:span><text:span text:style-name="T38">nterpret </text:span><text:span text:style-name="T9">expression</text:span><text:span text:style-name="T38"> 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="T38"> 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="T38"> will return a list of strings, while </text:span><text:span text:style-name="T9">evals</text:span><text:span text:style-name="T38"> will return a single string, where elements are joined by a comma and a space.</text:span></text:p>
+ <text:p text:style-name="P193"><text:span text:style-name="T38">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="T65">to a string containing a Python list expression</text:span><text:span text:style-name="T38">, and </text:span><text:span text:style-name="T65">then </text:span><text:span text:style-name="T38">use </text:span><text:span text:style-name="T9">eval</text:span><text:span text:style-name="T38"> </text:span><text:span text:style-name="T78">a</text:span><text:span text:style-name="T38">round the interpolation expression:</text:span></text:p>
+ <text:p text:style-name="P208">DATE_<text:span text:style-name="T190">STRING</text:span> = '[2010, 10, 20]' # need quotes here!</text:p>
+ <text:p text:style-name="P208">DATE_<text:span text:style-name="T190">LIST</text:span> = eval($DATE_<text:span text:style-name="T191">STRING</text:span>) # becomes a 3 element list</text:p>
+ <text:p text:style-name="P202">variable<text:span text:style-name="T38"> = </text:span><text:span text:style-name="T108">read(</text:span>file_name<text:span text:style-name="T108">)</text:span></text:p>
+ <text:p text:style-name="P188"><text:span text:style-name="T38">Read the contents of the file </text:span>file_name<text:span text:style-name="T38"> and assign its contents to </text:span>variable<text:span text:style-name="T38"> as a string.</text:span></text:p>
+ <text:p text:style-name="P203"><text:span text:style-name="T27">variable</text:span><text:span text:style-name="T66"> = </text:span><text:span text:style-name="T110">split_date(</text:span><text:span text:style-name="T27">timestamp</text:span><text:span text:style-name="T110">)</text:span></text:p>
+ <text:p text:style-name="P194"><text:span text:style-name="T183">T</text:span>ake <text:span text:style-name="T9">timestamp</text:span><text:span text:style-name="T38"> 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="T38"> </text:span><text:span text:style-name="T67">must have </text:span><text:span text:style-name="T38">an ISO-like format (date elements separated by '-'; 'T' or space as date/time separator; time elements separated by ':</text:span><text:span text:style-name="T67">'; </text:span><text:span text:style-name="T38">trailing time elements </text:span><text:span text:style-name="T68">and their separators </text:span><text:span text:style-name="T67">are optional</text:span><text:span text:style-name="T38">; time zone indicator is not supported). </text:span><text:span text:style-name="T80">Unlike ISO, </text:span><text:span text:style-name="T31">split_date</text:span><text:span text:style-name="T80"> also</text:span><text:span text:style-name="T38"> </text:span><text:span text:style-name="T80">allows the date to be in the form YYYYMMDD</text:span><text:span text:style-name="T38">. </text:span><text:span text:style-name="T68">Unset fields default to zero.</text:span></text:p>
+ <text:p text:style-name="P204"><text:span text:style-name="T9">variable</text:span><text:span text:style-name="T38"> = </text:span><text:span text:style-name="T108">sec2time(</text:span><text:span text:style-name="T9">second_of_day</text:span><text:span text:style-name="T108">)</text:span></text:p>
+ <text:p text:style-name="P182">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="P205"><text:span text:style-name="T9">variable</text:span> = '<text:span text:style-name="T112">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="P195">Take integer <text:span text:style-name="T9">offset</text:span><text:span text:style-name="T38"> (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="T38"> and return the resulting date string.</text:span></text:p>
+ <text:p text:style-name="P206"><text:span text:style-name="T9">variable</text:span> = '<text:span text:style-name="T112">add_</text:span><text:span text:style-name="T120">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="P196"><text:span text:style-name="T38">Take integer </text:span><text:span text:style-name="T9">offset</text:span><text:span text:style-name="T38"> (may be negative), add it to the </text:span><text:span text:style-name="T81">day</text:span><text:span text:style-name="T38"> portion of </text:span><text:span text:style-name="T9">datestamp</text:span><text:span text:style-name="T38"> and return the resulting date string. </text:span><text:span text:style-name="T81">Year and month portions will be set as </text:span><text:soft-page-break/><text:span text:style-name="T81">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>
<text:p text:style-name="P24">The expansion of .tmpl files into the job description uses the <text:span text:style-name="T9">Jinja</text:span> Python library. It provides a default set of facilities that can be used to expand any textual template. The proposed default syntax was slightly customized to fit the needs of <text:span text:style-name="T9">mkexp</text:span>.</text:p>
@@ -2205,8 +2226,8 @@
<text:p text:style-name="Preformatted_20_Text">#! /bin/ksh</text:p>
<text:p text:style-name="Preformatted_20_Text"><text:span text:style-name="T132">#</text:span> This script was <text:span text:style-name="T132">crea</text:span>ted by %{NAME}</text:p>
<text:p text:style-name="P33">Here, the placehol<text:span text:style-name="T173">d</text:span>er requests the 'NAME' variable which was set to 'Joe User' in the example .config file <text:span text:style-name="T173">of section </text:span><text:span text:style-name="T173"><text:bookmark-ref text:reference-format="chapter" text:ref-name="__RefHeading__1669_1438093122">2.3.1</text:bookmark-ref></text:span>. This value is now looked up in the <text:span text:style-name="T173">configuration</text:span> and used to textually replace the placeholder expression, yield<text:span text:style-name="T173">ing</text:span> the final text:</text:p>
- <text:p text:style-name="P111">#! /bin/ksh</text:p>
- <text:p text:style-name="P110"><text:span text:style-name="T133"># </text:span>This script was <text:span text:style-name="T133">crea</text:span>ted by <text:span text:style-name="T131">Joe User</text:span></text:p>
+ <text:p text:style-name="P113">#! /bin/ksh</text:p>
+ <text:p text:style-name="P112"><text:span text:style-name="T133"># </text:span>This script was <text:span text:style-name="T133">crea</text:span>ted by <text:span text:style-name="T131">Joe User</text:span></text:p>
<text:h text:style-name="Heading_20_3" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2550_1114405012"/><text:span text:style-name="T135">V</text:span>ariables in sections<text:bookmark-end text:name="__RefHeading__2550_1114405012"/></text:h>
<text:p text:style-name="P26">To request a variable within a section, simply prepend the section name to the variable name, using '.' as separator, as in</text:p>
<text:p text:style-name="Preformatted_20_Text"># %{section1.description}</text:p>
@@ -2223,24 +2244,29 @@
<text:p text:style-name="Preformatted_20_Text">LITERAL_BOOLEANS=%{false} <text:s/># Always lower-case!</text:p>
<text:p text:style-name="Preformatted_20_Text">ARITHMETIC=%{2 + 2 * 2 – 2 / 2} <text:s/># is 5</text:p>
<text:p text:style-name="Preformatted_20_Text">STRING_TOGETHER=%{NAME ~ ', employee number ' ~ 42} <text:s/># Converts <text:span text:style-name="T135">42</text:span> to string</text:p>
- <text:p text:style-name="P113">LIST_ELEMENT=%{PATH[0]} <text:s/># indices start with 0</text:p>
- <text:p text:style-name="P113">LIST_SUBLIST=%{PATH[1:3]}</text:p>
+ <text:p text:style-name="P115">LIST_ELEMENT=%{PATH[0]} <text:s/># indices start with 0</text:p>
+ <text:p text:style-name="P115">LIST_SUBLIST=%{PATH[1:3]}</text:p>
<text:p text:style-name="Preformatted_20_Text">FILTERED_STRING=%{NAME | <text:span text:style-name="T135">lower()} <text:s/># is 'joe user'</text:span></text:p>
- <text:p text:style-name="Text_20_body">The last example allows for <text:span text:style-name="T144">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="T9">mkexp</text:span> defines two additional filters, 'split' for cutting a string into a list of substrings, and 'filter' for removing (empty) ele<text:span text:style-name="T200">s</text:span>ments from a list:</text:p>
+ <text:p text:style-name="Text_20_body">The last example allows for <text:span text:style-name="T144">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="T9">mkexp</text:span> defines two additional filters, 'split' for cutting a string into a list of substrings, and 'filter' for removing (empty) elements from a list:</text:p>
<text:p text:style-name="Preformatted_20_Text">SPLIT_EXAMPLE=%{'A B C' | split(' ')} <text:s/># is ['A', 'B', 'C']</text:p>
<text:p text:style-name="Preformatted_20_Text">FILTER_EXAMPLE=%{['A', '', 'C'] | filter()<text:span text:style-name="T135">}</text:span> <text:s/># is ['A', 'C']</text:p>
+ <text:p text:style-name="P89">The builtin <text:span text:style-name="T9">Jinja </text:span>filter 'wordwrap' is replaced by a private version that allows to suppress breaks on hyphens:</text:p>
+ <text:p text:style-name="Preformatted_20_Text">%<text:span text:style-name="T204">{'long-arbitrarily-hyphened-text'|wordwrap(width=15,break_on_hyphens=false)}</text:span></text:p>
+ <text:p text:style-name="P88">results in</text:p>
+ <text:p text:style-name="P256">long-arbitraril </text:p>
+ <text:p text:style-name="P256">y-hyphened-text </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="T192">i.e. lines </text:span>beginning with '#%'. <text:span text:style-name="T192">They </text:span>start with '#% for … <text:span text:style-name="T138">in …:</text:span>' and end in '#% endfor':</text:p>
<text:p text:style-name="Preformatted_20_Text"><text:span text:style-name="T112">#% for</text:span> countdown <text:span text:style-name="T112">in</text:span> [3, 2, 1, '<text:span text:style-name="T192">liftoff</text:span>']<text:span text:style-name="T112">:</text:span></text:p>
<text:p text:style-name="Preformatted_20_Text">echo %{countdown}</text:p>
- <text:p text:style-name="P100">#% endfor</text:p>
+ <text:p text:style-name="P102">#% endfor</text:p>
<text:p text:style-name="P28">will <text:span text:style-name="T136">be expanded by </text:span><text:span text:style-name="T30">mkexp</text:span><text:span text:style-name="T136"> to </text:span>yield</text:p>
- <text:p text:style-name="Preformatted_20_Text">echo 3</text:p>
+ <text:p text:style-name="Preformatted_20_Text"><text:soft-page-break/>echo 3</text:p>
<text:p text:style-name="Preformatted_20_Text">echo 2</text:p>
<text:p text:style-name="Preformatted_20_Text">echo 1</text:p>
<text:p text:style-name="Preformatted_20_Text">echo <text:span text:style-name="T192">liftoff</text:span></text:p>
<text:p text:style-name="P31"><text:span text:style-name="T138">You may of course use expressions in the loop definition. </text:span>For classical, index based loops, there is a 'range' function as in Python, <text:span text:style-name="T138">and the size of a list is queried with the 'length' filter</text:span>.</text:p>
- <text:p text:style-name="P112"><text:soft-page-break/>#% for index in <text:span text:style-name="T112">range(1, </text:span><text:span text:style-name="T115">PATH|length()</text:span><text:span text:style-name="T112">)</text:span> <text:s/><text:span text:style-name="T138"># PATH was defined in </text:span><text:span text:style-name="T138"><text:bookmark-ref text:reference-format="chapter" text:ref-name="__RefHeading__1669_1438093122">2.3.1</text:bookmark-ref></text:span></text:p>
+ <text:p text:style-name="P114">#% for index in <text:span text:style-name="T112">range(1, </text:span><text:span text:style-name="T115">PATH|length()</text:span><text:span text:style-name="T112">)</text:span> <text:s/><text:span text:style-name="T138"># PATH was defined in </text:span><text:span text:style-name="T138"><text:bookmark-ref text:reference-format="chapter" text:ref-name="__RefHeading__1669_1438093122">2.3.1</text:bookmark-ref></text:span></text:p>
<text:p text:style-name="Preformatted_20_Text"><text:span text:style-name="T138">echo</text:span> %<text:span text:style-name="T139">{index}: </text:span>%{<text:span text:style-name="T138">PATH[</text:span>index<text:span text:style-name="T138">]</text:span>} <text:s/></text:p>
<text:p text:style-name="Preformatted_20_Text">#% endfor</text:p>
<text:p text:style-name="Text_20_body">Note that <text:span text:style-name="T137">indexing of lists starts at 0,</text:span> <text:span text:style-name="T137">i.e. the first element of the PATH list is skipped. Besides, </text:span>the stop index <text:span text:style-name="T139">is</text:span> not included, i.e. <text:span text:style-name="T138">as PATH has a length of 3, </text:span>the last looping has index <text:span text:style-name="T137">2</text:span>:</text:p>
@@ -2250,18 +2276,18 @@
<text:p text:style-name="P29">A template may contain alternative parts <text:span text:style-name="T139">that are selected depending on the .config data</text:span>, <text:span text:style-name="T139">similar to an 'if' statement. This is useful for e.g. skipping certain parts of the script template that are not applicable to runs of a given resolution but required for others. They are also implemented as structured comments, starting with '#% if …:' and ending in '#% endif', with optional '#% elif …:' and '#% else:' parts.</text:span></text:p>
<text:p text:style-name="P30"><text:span text:style-name="T139">For testing, you may use expressions with comparisons (==, !=, >, >=, <, <=), querying a certain list element (… in …), and logical operators (and, or, not). Sub-expressions may be parenthesized to change the order of evaluation. Besides, </text:span><text:span text:style-name="T14">Jinja</text:span><text:span text:style-name="T139"> provides a number of named tests that use the '… is …' Syntax.</text:span></text:p>
<text:p text:style-name="Preformatted_20_Text"><text:span text:style-name="T112">#% if </text:span><text:span text:style-name="T141">PATH|length()</text:span><text:span text:style-name="T140"> </text:span><text:span text:style-name="T116">is divisibleby 3:</text:span></text:p>
- <text:p text:style-name="P128">diff3 %{PATH[:3]|join(' ')}</text:p>
- <text:p text:style-name="P103">#% elif <text:span text:style-name="T141">PATH|length()</text:span> is even:</text:p>
- <text:p text:style-name="P113">diff %{PATH[:2]|join(' ')}</text:p>
- <text:p text:style-name="P100">#% else:</text:p>
+ <text:p text:style-name="P130">diff3 %{PATH[:3]|join(' ')}</text:p>
+ <text:p text:style-name="P105">#% elif <text:span text:style-name="T141">PATH|length()</text:span> is even:</text:p>
+ <text:p text:style-name="P115">diff %{PATH[:2]|join(' ')}</text:p>
+ <text:p text:style-name="P102">#% else:</text:p>
<text:p text:style-name="Preformatted_20_Text">echo <text:span text:style-name="T142">cannot handle PATH</text:span></text:p>
- <text:p text:style-name="P100">#% endif</text:p>
+ <text:p text:style-name="P102">#% endif</text:p>
<text:p text:style-name="P37">If PATH is defined as in the examples above, this will result in</text:p>
<text:p text:style-name="Preformatted_20_Text">diff3 /bin /usr/bin /usr/local/bin</text:p>
<text:p text:style-name="P30"><text:span text:style-name="T139"><text:s/>For a list of available tests, see the </text:span><text:span text:style-name="T15">Jinja</text:span><text:span text:style-name="T143"> documentation.</text:span></text:p>
- <text:h text:style-name="Heading_20_3" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2558_1114405012"/>Comments<text:bookmark-end text:name="__RefHeading__2558_1114405012"/></text:h>
+ <text:h text:style-name="Heading_20_3" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2558_1114405012"/><text:soft-page-break/>Comments<text:bookmark-end text:name="__RefHeading__2558_1114405012"/></text:h>
<text:p text:style-name="P58"><text:span text:style-name="T9">Jinj</text:span>a also allows template comments that are removed when the template is expanded. This is implemented as another kind of structured comment starting with <text:span text:style-name="T193">'#%</text:span>#':</text:p>
- <text:p text:style-name="Preformatted_20_Text"><text:soft-page-break/># This comment will make it to the expanded script</text:p>
+ <text:p text:style-name="Preformatted_20_Text"># This comment will make it to the expanded script</text:p>
<text:p text:style-name="Preformatted_20_Text">#%# This one will not make it <text:span text:style-name="T152">and is for template documentation only</text:span></text:p>
<text:h text:style-name="Heading_20_2" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__2560_1114405012"/>Standard experiment<text:span text:style-name="T36">s</text:span><text:bookmark-end text:name="__RefHeading__2560_1114405012"/></text:h>
<text:p text:style-name="P16">When generating an experiment setup, <text:span text:style-name="T9">mkexp</text:span> expects the .config and .tmpl files to reside in a subdirectory of the current working directory, called 'standard_experiments'.</text:p>
@@ -2271,140 +2297,140 @@
<text:h text:style-name="Heading_20_2" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__2562_1114405012"/>Standard options<text:bookmark-end text:name="__RefHeading__2562_1114405012"/></text:h>
<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="Heading_20_2" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__2564_1114405012"/><text:soft-page-break/>Standard environments<text:bookmark-end text:name="__RefHeading__2564_1114405012"/></text:h>
+ <text:p text:style-name="P11">Within the experiment's .config file, options are selected by setting the variable <text:soft-page-break/>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="Heading_20_2" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__2564_1114405012"/>Standard environments<text:bookmark-end text:name="__RefHeading__2564_1114405012"/></text:h>
<text:p text:style-name="P12">The above examples neglect an important feature <text:span text:style-name="T111">of job descriptions, namely the system or machine dependent set up. Different computing centers use different job control software and naming conventions, might provide different versions of the same software at differing locations. This needs to be handled in a way that is independent of the other configuration as far as possible.</text:span></text:p>
<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="T124">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="T163">may</text:span> <text:span text:style-name="T163">set</text:span> the special variable E<text:span text:style-name="T163">NVIRONMENT</text:span> to the name of <text:span text:style-name="T163">the host </text:span>e<text:span text:style-name="T163">nvironment</text:span> to use. <text:span text:style-name="T163">If it is not set, the 'DEFAULT' environment settings will be used.</text:span></text:p>
- <text:h text:style-name="P231" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__1508_1711940803"/>Generating <text:span text:style-name="T160">j</text:span>obs<text:bookmark-end text:name="__RefHeading__1508_1711940803"/></text:h>
+ <text:h text:style-name="P235" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__1508_1711940803"/>Generating <text:span text:style-name="T160">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="T148"> </text:span>running <text:span text:style-name="T9">mkexp</text:span><text:span text:style-name="T86">, </text:span><text:span text:style-name="T87">the special configuration section [jobs]</text:span><text:span text:style-name="T34"> </text:span><text:span text:style-name="T87">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="P129"># <text:span text:style-name="T149">model setup: experiment type 'control'</text:span></text:p>
- <text:p text:style-name="P116">[jobs]</text:p>
- <text:p text:style-name="P116"><text:s text:c="2"/>[[pre]]</text:p>
- <text:p text:style-name="P116"><text:s text:c="2"/>[[run]]</text:p>
- <text:p text:style-name="P116"><text:s text:c="2"/>[[post]]</text:p>
+ <text:p text:style-name="P131"># <text:span text:style-name="T149">model setup: experiment type 'control'</text:span></text:p>
+ <text:p text:style-name="P118">[jobs]</text:p>
+ <text:p text:style-name="P118"><text:s text:c="2"/>[[pre]]</text:p>
+ <text:p text:style-name="P118"><text:s text:c="2"/>[[run]]</text:p>
+ <text:p text:style-name="P118"><text:s text:c="2"/>[[post]]</text:p>
<text:p text:style-name="P43"><text:span text:style-name="T87">For each of </text:span><text:span text:style-name="T89">the jobs defined in the model setup above</text:span><text:span text:style-name="T87">, there </text:span><text:span text:style-name="T89">must</text:span><text:span text:style-name="T87"> be a template file in the model setup, </text:span><text:span text:style-name="T89">e.g. for [[run]] </text:span><text:span text:style-name="T87">either as 'control.run.tmpl' or 'DEFAULT.run.tmpl'. </text:span><text:span text:style-name="T88">The corresponding</text:span><text:span text:style-name="T87"> file is expanded to its final form using the </text:span><text:span text:style-name="T88">full</text:span><text:span text:style-name="T87"> experiment configuration, </text:span><text:span text:style-name="T88">as described before</text:span><text:span text:style-name="T87">. Besides, the </text:span><text:span text:style-name="T88">job specific </text:span><text:span text:style-name="T87">variable</text:span><text:span text:style-name="T88">s</text:span><text:span text:style-name="T87"> </text:span><text:span text:style-name="T88">are set and passed according to their respective template</text:span><text:span text:style-name="T87">.</text:span></text:p>
- <text:p text:style-name="P43"><text:span text:style-name="T90">The resulting job scripts are </text:span><text:span text:style-name="T89">written to the directory defined by SCRIPT_DIR, </text:span><text:span text:style-name="T90">e.g. </text:span><text:span text:style-name="T89">as 'joe1234.run', </text:span><text:span text:style-name="T90">and marked as being executable. </text:span><text:span text:style-name="T96">Besides, as mentioned before, the contents of the special variable EXP_DESCRIPTION is written to a README file in that same directory. </text:span><text:span text:style-name="T99">Also, an update script is created that allows to re-generate all output files with identical environment and command line settings by simply running './update' from the script directory.</text:span></text:p>
- <text:h text:style-name="Heading_20_3" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2566_1114405012"/><text:soft-page-break/><text:span text:style-name="T90">C</text:span><text:span text:style-name="T86">hanging the model job list</text:span><text:bookmark-end text:name="__RefHeading__2566_1114405012"/></text:h>
+ <text:p text:style-name="P43"><text:span text:style-name="T90">The resulting job scripts are </text:span><text:span text:style-name="T89">written to the directory defined by SCRIPT_DIR, </text:span><text:span text:style-name="T90">e.g. </text:span><text:span text:style-name="T89">as 'joe1234.run', </text:span><text:span text:style-name="T90">and marked as being executable. </text:span><text:span text:style-name="T96">Besides, as mentioned before, the contents of the special variable EXP_DESCRIPTION is written to a README file in </text:span><text:soft-page-break/><text:span text:style-name="T96">that same directory. </text:span><text:span text:style-name="T99">Also, an update script is created that allows to re-generate all output files with identical environment and command line settings by simply running './update' from the script directory.</text:span></text:p>
+ <text:h text:style-name="Heading_20_3" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2566_1114405012"/><text:span text:style-name="T90">C</text:span><text:span text:style-name="T86">hanging the model job list</text:span><text:bookmark-end text:name="__RefHeading__2566_1114405012"/></text:h>
<text:p text:style-name="P44"><text:span text:style-name="T87">U</text:span><text:span text:style-name="T86">sually, the job list is defined in the model setup. The user may chose to add </text:span><text:span text:style-name="T92">jobs </text:span><text:span text:style-name="T86">and delete jobs from this list as appropriate. While adding a job is straightforward, removing a job uses a special section variable '.remove' (note the leading period). It </text:span><text:span text:style-name="T92">is</text:span><text:span text:style-name="T86"> defined in the [jobs] section and contains a list of the jobs to be suppressed.</text:span></text:p>
- <text:p text:style-name="P116"># joe1234.config</text:p>
- <text:p text:style-name="P116">EXP_TYPE = control</text:p>
- <text:p text:style-name="P116">[jobs]</text:p>
- <text:p text:style-name="P116"><text:s text:c="2"/>.remove = post, pre</text:p>
- <text:p text:style-name="P116"><text:s text:c="2"/>[[my_pre]]</text:p>
- <text:p text:style-name="P116"><text:s text:c="2"/>[[my_post]]</text:p>
+ <text:p text:style-name="P118"># joe1234.config</text:p>
+ <text:p text:style-name="P118">EXP_TYPE = control</text:p>
+ <text:p text:style-name="P118">[jobs]</text:p>
+ <text:p text:style-name="P118"><text:s text:c="2"/>.remove = post, pre</text:p>
+ <text:p text:style-name="P118"><text:s text:c="2"/>[[my_pre]]</text:p>
+ <text:p text:style-name="P118"><text:s text:c="2"/>[[my_post]]</text:p>
<text:p text:style-name="P49">This way, the 'pre' and 'post' jobs will not be created in favor of two new jobs, 'my_pre' and 'my_post'. In this case, the user setup must provide two templates 'joe1234.my_pre.tmpl' and 'joe1234.my_post.tmpl', together with the .config file.</text:p>
<text:p text:style-name="P45">Alternatively, you may want to introduce a new 'my_p<text:span text:style-name="T150">ost</text:span>' job, that is basically the same as the old 'p<text:span text:style-name="T150">ost</text:span>' job but uses a slightly different configuration. This may be done using the special section variable '.extends'.</text:p>
- <text:p text:style-name="P116">[jobs]</text:p>
- <text:p text:style-name="P130"><text:span text:style-name="T86"><text:s text:c="2"/>[[my_p</text:span><text:span text:style-name="T91">ost</text:span><text:span text:style-name="T86">]]</text:span></text:p>
- <text:p text:style-name="P130"><text:span text:style-name="T86"><text:s text:c="4"/>.</text:span><text:span text:style-name="T90">extends</text:span><text:span text:style-name="T86"> = p</text:span><text:span text:style-name="T91">ost</text:span></text:p>
- <text:p text:style-name="P117"><text:s text:c="4"/>command = $HOME/bin/my_special_command</text:p>
+ <text:p text:style-name="P118">[jobs]</text:p>
+ <text:p text:style-name="P132"><text:span text:style-name="T86"><text:s text:c="2"/>[[my_p</text:span><text:span text:style-name="T91">ost</text:span><text:span text:style-name="T86">]]</text:span></text:p>
+ <text:p text:style-name="P132"><text:span text:style-name="T86"><text:s text:c="4"/>.</text:span><text:span text:style-name="T90">extends</text:span><text:span text:style-name="T86"> = p</text:span><text:span text:style-name="T91">ost</text:span></text:p>
+ <text:p text:style-name="P119"><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="T151">made available </text:span>to <text:span text:style-name="T151">the template via the</text:span> 'JOB' dictionary.</text:p>
- <text:h text:style-name="P216" 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="P220" 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="P161">tasks</text:p>
- <text:p text:style-name="P179">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>
- <text:p text:style-name="P162">nodes</text:p>
- <text:p text:style-name="P179">Number of computing nodes required on the computing system. Needed if 'tasks' is not set.</text:p>
- <text:p text:style-name="P162">tasks_per_node</text:p>
- <text:p text:style-name="P179">Number of parallel (MPI) tasks on a single node. Needed if 'tasks' is not set.</text:p>
- <text:h text:style-name="P215" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2570_1114405012"/><text:soft-page-break/>Overriding namelist settings in derived jobs<text:bookmark-end text:name="__RefHeading__2570_1114405012"/></text:h>
+ <text:p text:style-name="P165">tasks</text:p>
+ <text:p text:style-name="P183">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>
+ <text:p text:style-name="P166">nodes</text:p>
+ <text:p text:style-name="P183">Number of computing nodes required on the computing system. Needed if 'tasks' <text:soft-page-break/>is not set.</text:p>
+ <text:p text:style-name="P166">tasks_per_node</text:p>
+ <text:p text:style-name="P183">Number of parallel (MPI) tasks on a single node. Needed if 'tasks' is not set.</text:p>
+ <text:h text:style-name="P219" 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="P131">[namelists]</text:p>
- <text:p text:style-name="P92"><text:s text:c="2"/>[[namelist.jsbach]]</text:p>
- <text:p text:style-name="P92"><text:s text:c="4"/>[[[jsbach_ctl]]]</text:p>
- <text:p text:style-name="P92"><text:s text:c="6"/>use_dynveg = false</text:p>
+ <text:p text:style-name="P133">[namelists]</text:p>
+ <text:p text:style-name="P94"><text:s text:c="2"/>[[namelist.jsbach]]</text:p>
+ <text:p text:style-name="P94"><text:s text:c="4"/>[[[jsbach_ctl]]]</text:p>
+ <text:p text:style-name="P94"><text:s text:c="6"/>use_dynveg = false</text:p>
<text:p text:style-name="P46"><text:span text:style-name="T86">If – for some reason – your experiments needs 'use_dynveg' set to 'true' for the first year only, you may create an additional 'run_first' job, </text:span><text:span text:style-name="T92">with a job specific namelists subsection that – apart from the addition</text:span><text:span text:style-name="T94">al</text:span><text:span text:style-name="T92"> brackets – has the same structure as</text:span><text:span text:style-name="T86"> </text:span><text:span text:style-name="T92">the global namelists section.</text:span></text:p>
- <text:p text:style-name="P131">[jobs]</text:p>
- <text:p text:style-name="P131"><text:s text:c="2"/>[[run_first]]</text:p>
- <text:p text:style-name="P131"><text:s text:c="4"/>.extends = run</text:p>
- <text:p text:style-name="P131"><text:s text:c="4"/><text:span text:style-name="T112">[[[namelists]]</text:span><text:span text:style-name="T121">]</text:span></text:p>
- <text:p text:style-name="P92"><text:s text:c="6"/><text:span text:style-name="T150">[[</text:span>[[namelist.jsbach]]<text:span text:style-name="T150">]]</text:span></text:p>
- <text:p text:style-name="P92"><text:s text:c="8"/><text:span text:style-name="T150">[[</text:span>[[[jsbach_ctl]]]<text:span text:style-name="T150">]]</text:span></text:p>
- <text:p text:style-name="P92"><text:span text:style-name="T86"><text:s text:c="10"/>use_dynveg = </text:span><text:span text:style-name="T91">true</text:span></text:p>
+ <text:p text:style-name="P133">[jobs]</text:p>
+ <text:p text:style-name="P133"><text:s text:c="2"/>[[run_first]]</text:p>
+ <text:p text:style-name="P133"><text:s text:c="4"/>.extends = run</text:p>
+ <text:p text:style-name="P133"><text:s text:c="4"/><text:span text:style-name="T112">[[[namelists]]</text:span><text:span text:style-name="T121">]</text:span></text:p>
+ <text:p text:style-name="P94"><text:s text:c="6"/><text:span text:style-name="T150">[[</text:span>[[namelist.jsbach]]<text:span text:style-name="T150">]]</text:span></text:p>
+ <text:p text:style-name="P94"><text:s text:c="8"/><text:span text:style-name="T150">[[</text:span>[[[jsbach_ctl]]]<text:span text:style-name="T150">]]</text:span></text:p>
+ <text:p text:style-name="P94"><text:span text:style-name="T86"><text:s text:c="10"/>use_dynveg = </text:span><text:span text:style-name="T91">true</text:span></text:p>
<text:p text:style-name="P46"><text:span text:style-name="T92">This</text:span><text:span text:style-name="T86"> 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="P215" 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="P219" 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="T86">While the definition of .config variables may use</text:span><text:span text:style-name="T93"> variable references like</text:span><text:span text:style-name="T86"> $NAME or ${NAME} to include the </text:span><text:span text:style-name="T93">verbatim </text:span><text:span text:style-name="T86">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="T93">script</text:span><text:span text:style-name="T86"> 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="T93">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="P116"># joe1234.config</text:p>
- <text:p text:style-name="P116">NAME = Joe User</text:p>
+ <text:p text:style-name="P118"># joe1234.config</text:p>
+ <text:p text:style-name="P118">NAME = Joe User</text:p>
<text:p text:style-name="Preformatted_20_Text_20_Interrupt">MESSAGE = This experiment was generated by $${NAME}</text:p>
- <text:p text:style-name="P122">#%# joe1234.job.tmpl</text:p>
- <text:p text:style-name="P116">#! /bin/sh</text:p>
- <text:p text:style-name="P120">NAME='%{NAME}'</text:p>
- <text:p text:style-name="P116">echo %{MESSAGE}</text:p>
+ <text:p text:style-name="P124"><text:soft-page-break/>#%# joe1234.job.tmpl</text:p>
+ <text:p text:style-name="P118">#! /bin/sh</text:p>
+ <text:p text:style-name="P122">NAME='%{NAME}'</text:p>
+ <text:p text:style-name="P118">echo %{MESSAGE}</text:p>
<text:p text:style-name="P52">By default, <text:span text:style-name="T152">native variables are formatted as </text:span>shell script, namely ${NAME}:</text:p>
- <text:p text:style-name="P119"><text:soft-page-break/>#! /bin/sh</text:p>
- <text:p text:style-name="P122">NAME='Joe User'</text:p>
- <text:p text:style-name="P118">echo This experiment was generated by ${NAME}</text:p>
+ <text:p text:style-name="P121">#! /bin/sh</text:p>
+ <text:p text:style-name="P124">NAME='Joe User'</text:p>
+ <text:p text:style-name="P120">echo This experiment was generated by ${NAME}</text:p>
<text:p text:style-name="P53"><text:span text:style-name="T159">T</text:span>o support variable reference<text:span text:style-name="T158">s for other script languages, a</text:span> job specific variable '.var_format' may be defined. <text:span text:style-name="T158">It defines an output format string where any occurrence of '%s' will be replaced by the respective variable name. </text:span>For a Python based script, <text:span text:style-name="T152">this may look like:</text:span></text:p>
- <text:p text:style-name="P121"># joe1234.config</text:p>
- <text:p text:style-name="P121">NAME = Joe User</text:p>
- <text:p text:style-name="P121">MESSAGE = This experiment was generated by $${NAME}</text:p>
- <text:p text:style-name="P133">[jobs]</text:p>
+ <text:p text:style-name="P123"># joe1234.config</text:p>
+ <text:p text:style-name="P123">NAME = Joe User</text:p>
+ <text:p text:style-name="P123">MESSAGE = This experiment was generated by $${NAME}</text:p>
+ <text:p text:style-name="P135">[jobs]</text:p>
<text:p text:style-name="Preformatted_20_Text"><text:s text:c="2"/>[[job]]</text:p>
<text:p text:style-name="Preformatted_20_Text_20_Interrupt"><text:s text:c="4"/>.var_format = <text:span text:style-name="T155">"</text:span><text:span text:style-name="T153">' + str(</text:span>%s<text:span text:style-name="T157">)</text:span> <text:span text:style-name="T153">+ '</text:span><text:span text:style-name="T155">"</text:span></text:p>
- <text:p text:style-name="P122">#%# joe1234.job.tmpl</text:p>
- <text:p text:style-name="P134">#! /usr/bin/env python </text:p>
+ <text:p text:style-name="P124">#%# joe1234.job.tmpl</text:p>
+ <text:p text:style-name="P136">#! /usr/bin/env python </text:p>
<text:p text:style-name="Preformatted_20_Text">NAME = '%{NAME}' </text:p>
<text:p text:style-name="Preformatted_20_Text">print<text:span text:style-name="T194">(</text:span>'%{MESSAGE}'<text:span text:style-name="T194">)</text:span> </text:p>
<text:p text:style-name="P59">This setup will expand to</text:p>
- <text:p text:style-name="P134">#! /usr/bin/env python </text:p>
- <text:p text:style-name="P134">NAME = '<text:span text:style-name="T157">Joe User</text:span>' </text:p>
- <text:p text:style-name="P135">print<text:span text:style-name="T194">(</text:span>'<text:span text:style-name="T86">This experiment was generated by </text:span><text:span text:style-name="T95">' + str(</text:span><text:span text:style-name="T86">NAME) </text:span><text:span text:style-name="T95">+ '</text:span>'<text:span text:style-name="T194">)</text:span></text:p>
- <text:h text:style-name="P222" 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="P136">#! /usr/bin/env python </text:p>
+ <text:p text:style-name="P136">NAME = '<text:span text:style-name="T157">Joe User</text:span>' </text:p>
+ <text:p text:style-name="P137">print<text:span text:style-name="T194">(</text:span>'<text:span text:style-name="T86">This experiment was generated by </text:span><text:span text:style-name="T95">' + str(</text:span><text:span text:style-name="T86">NAME) </text:span><text:span text:style-name="T95">+ '</text:span>'<text:span text:style-name="T194">)</text:span></text:p>
+ <text:h text:style-name="P226" 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="T161">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="T162">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="T162"> maintains the special variable VARIABLES_. When generating output for</text:span></text:p>
- <text:p text:style-name="P123">NAME = Joe User</text:p>
- <text:p text:style-name="P124">EMAIL = joe@domain.tld</text:p>
- <text:p text:style-name="P136"><text:span text:style-name="T86">MESSAGE = This experiment was generated by $${NAME} </text:span><text:span text:style-name="T97"><$${EMAIL}></text:span></text:p>
- <text:p text:style-name="P62"><text:span text:style-name="T33">mkexp</text:span><text:span text:style-name="T86"> will parse all values, recognize 'NAME' and 'EMAIL' as native variables, and </text:span><text:span text:style-name="T98">will </text:span><text:span text:style-name="T86">put their names in the VARIABLES_ list. Now we may use the 'for' template directive to generate an additional line for each member of VARIABLES_. To query the value for a given variable name, </text:span><text:span text:style-name="T33">mkexp</text:span><text:span text:style-name="T86"> provides the 'context' function, such that the template</text:span></text:p>
- <text:p text:style-name="P123"><text:soft-page-break/>#! /bin/sh</text:p>
- <text:p text:style-name="P124">#%# for <text:span text:style-name="T112">variable</text:span> in <text:span text:style-name="T112">VARIABLES_</text:span>:</text:p>
- <text:p text:style-name="P124">%{<text:span text:style-name="T112">variable</text:span>}='%{<text:span text:style-name="T112">context(variable)</text:span>}'</text:p>
- <text:p text:style-name="P124">#%# endfor</text:p>
- <text:p text:style-name="P124">echo <text:span text:style-name="T154">"</text:span>%{MESSAGE}<text:span text:style-name="T154">"</text:span></text:p>
+ <text:p text:style-name="P125">NAME = Joe User</text:p>
+ <text:p text:style-name="P126">EMAIL = joe@domain.tld</text:p>
+ <text:p text:style-name="P138"><text:span text:style-name="T86">MESSAGE = This experiment was generated by $${NAME} </text:span><text:span text:style-name="T97"><$${EMAIL}></text:span></text:p>
+ <text:p text:style-name="P62"><text:span text:style-name="T33">mkexp</text:span><text:span text:style-name="T86"> will parse all values, recognize 'NAME' and 'EMAIL' as native variables, and </text:span><text:span text:style-name="T98">will </text:span><text:span text:style-name="T86">put their names in the VARIABLES_ list. Now we may use the 'for' template directive to generate an additional line for each member of VARIABLES_. To query </text:span><text:soft-page-break/><text:span text:style-name="T86">the value for a given variable name, </text:span><text:span text:style-name="T33">mkexp</text:span><text:span text:style-name="T86"> provides the 'context' function, such that the template</text:span></text:p>
+ <text:p text:style-name="P125">#! /bin/sh</text:p>
+ <text:p text:style-name="P126">#%# for <text:span text:style-name="T112">variable</text:span> in <text:span text:style-name="T112">VARIABLES_</text:span>:</text:p>
+ <text:p text:style-name="P126">%{<text:span text:style-name="T112">variable</text:span>}='%{<text:span text:style-name="T112">context(variable)</text:span>}'</text:p>
+ <text:p text:style-name="P126">#%# endfor</text:p>
+ <text:p text:style-name="P126">echo <text:span text:style-name="T154">"</text:span>%{MESSAGE}<text:span text:style-name="T154">"</text:span></text:p>
<text:p text:style-name="P54">eventually yields</text:p>
- <text:p text:style-name="P123">#! /bin/sh</text:p>
- <text:p text:style-name="P136"><text:span text:style-name="T103">EMAIL</text:span><text:span text:style-name="T107">='</text:span><text:span text:style-name="T103">joe@domain.tld</text:span><text:span text:style-name="T107">'</text:span></text:p>
- <text:p text:style-name="P136"><text:span text:style-name="T102">NAME</text:span><text:span text:style-name="T106">=</text:span><text:span text:style-name="T107">'</text:span><text:span text:style-name="T102">Joe User</text:span><text:span text:style-name="T107">'</text:span></text:p>
- <text:p text:style-name="P136"><text:span text:style-name="T97">echo </text:span><text:span text:style-name="T156">"This experiment was generated by ${NAME} <${EMAIL}>"</text:span></text:p>
+ <text:p text:style-name="P125">#! /bin/sh</text:p>
+ <text:p text:style-name="P138"><text:span text:style-name="T103">EMAIL</text:span><text:span text:style-name="T107">='</text:span><text:span text:style-name="T103">joe@domain.tld</text:span><text:span text:style-name="T107">'</text:span></text:p>
+ <text:p text:style-name="P138"><text:span text:style-name="T102">NAME</text:span><text:span text:style-name="T106">=</text:span><text:span text:style-name="T107">'</text:span><text:span text:style-name="T102">Joe User</text:span><text:span text:style-name="T107">'</text:span></text:p>
+ <text:p text:style-name="P138"><text:span text:style-name="T97">echo </text:span><text:span text:style-name="T156">"This experiment was generated by ${NAME} <${EMAIL}>"</text:span></text:p>
<text:p text:style-name="P63">Note that the order of variable names is not necessarily the order in which they were defined in the .config file.</text:p>
<text:h text:style-name="Heading_20_3" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2576_1114405012"/>Re-generation of <text:span text:style-name="T160">s</text:span>cripts and <text:span text:style-name="T160">b</text:span>ackup<text:bookmark-end text:name="__RefHeading__2576_1114405012"/></text:h>
<text:p text:style-name="P60">Even the simplest user setup may contain an error. In this case, it is considered good practice to fix this error in the user setup, and to rerun <text:span text:style-name="T9">mkexp.</text:span><text:span text:style-name="T38"> If you want to be really good, you might even start a new experiment from the previous one's restart data.</text:span></text:p>
<text:p text:style-name="P85"><text:span text:style-name="T48">A</text:span><text:span text:style-name="T38">s a convenient short-cut, </text:span><text:span text:style-name="T9">mkexp</text:span><text:span text:style-name="T38"> provides the script 'update' in the script directory. It may be called instead of going back to the 'run' and re-running </text:span><text:span text:style-name="T9">mkexp </text:span><text:span text:style-name="T38">directly. The update script records all command line settings and environment settings that were used for running </text:span><text:span text:style-name="T9">mkexp</text:span><text:span text:style-name="T38"> so that './update' reg</text:span><text:span text:style-name="T83">e</text:span><text:span text:style-name="T38">nerates the scripts exactly as they were created, without having to re-construct the exact settings. Like mkexp, update allows to set or change variables on the command line, e.g.</text:span></text:p>
- <text:p text:style-name="P115">./update FINAL_DATE=2015-12-31</text:p>
+ <text:p text:style-name="P117">./update FINAL_DATE=2015-12-31</text:p>
<text:p text:style-name="P85">may be used to regenerate scripts with a new final date. Note that these settings are also recorded, i.e. running just './update' the next time will again set FINAL_DATE.</text:p>
<text:p text:style-name="P60"><text:span text:style-name="T38">Of course, there is also the possibility to </text:span><text:span text:style-name="T48">change</text:span><text:span text:style-name="T38"> the </text:span><text:span text:style-name="T19">generated</text:span><text:span text:style-name="T47"> </text:span><text:span text:style-name="T38">job scripts directly, and then go on. This is fine as long as the required setting is using a native variable or is otherwise easily editable. On the other hand, </text:span><text:span text:style-name="T49">facing</text:span><text:span text:style-name="T38"> the next </text:span><text:span text:style-name="T49">change,</text:span><text:span text:style-name="T38"> this might not be the case, so eventually you </text:span><text:span text:style-name="T47">may</text:span><text:span text:style-name="T38"> need to re-generate the whole thing. What now about those manual changes to the job scripts?</text:span></text:p>
- <text:p text:style-name="P60"><text:span text:style-name="T38">Whenever </text:span><text:span text:style-name="T9">mkexp</text:span><text:span text:style-name="T38"> sees existing job scripts while trying to generate the new description, it will automatically create backup files. They are placed in a subdirectory of SCRIPT_DIR, named 'backup'. </text:span><text:span text:style-name="T47">Also, the scripts for each regeneration are bundled in their own subdirectory, named after the current date-time stamp. </text:span><text:span text:style-name="T48">This way you may easily compare old and new scripts to evaluate and possibly transfer any manual changes </text:span><text:span text:style-name="T83">after a necessary regeneration</text:span><text:span text:style-name="T48">.</text:span></text:p>
- <text:h text:style-name="P232" text:outline-level="2"><text:bookmark-start text:name="__RefHeading__1883_1672291846"/><text:soft-page-break/>Defining namelists and other configuration files<text:bookmark-end text:name="__RefHeading__1883_1672291846"/></text:h>
+ <text:p text:style-name="P60"><text:span text:style-name="T38">Whenever </text:span><text:span text:style-name="T9">mkexp</text:span><text:span text:style-name="T38"> sees existing job scripts while trying to generate the new description, it will automatically create backup files. They are placed in a subdirectory of SCRIPT_DIR, named 'backup'. </text:span><text:span text:style-name="T47">Also, the scripts for each regeneration are bundled in their own subdirectory, named after the current date-time stamp. </text:span><text:span text:style-name="T48">This way you may easily compare old and new scripts to evaluate and possibly transfer any manual </text:span><text:soft-page-break/><text:span text:style-name="T48">changes </text:span><text:span text:style-name="T83">after a necessary regeneration</text:span><text:span text:style-name="T48">.</text:span></text:p>
+ <text:h text:style-name="P236" 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="P68"><text:span text:style-name="T60">Most models need at least one Fortran namelist file or another form of configuration file to run. </text:span><text:span text:style-name="T61">The special section [namelists] </text:span><text:span text:style-name="T60">is designed to </text:span><text:span text:style-name="T61">contain all information that goes into </text:span><text:span text:style-name="T60">these</text:span><text:span text:style-name="T61"> files. Each </text:span><text:span text:style-name="T58">immediate </text:span><text:span text:style-name="T61">subsection defines settings for a single file that will </text:span><text:span text:style-name="T60">by default be </text:span><text:span text:style-name="T61">formatted as a Fortran namelist. </text:span><text:span text:style-name="T60">For </text:span><text:span text:style-name="T61">example,</text:span></text:p>
- <text:p text:style-name="P137">[namelists]</text:p>
- <text:p text:style-name="P147"/>
- <text:p text:style-name="P137"><text:s text:c="2"/>[[<text:span text:style-name="T175">namelist.echam</text:span>]] </text:p>
- <text:p text:style-name="P137"><text:s text:c="4"/>[[[runctl]]] </text:p>
- <text:p text:style-name="P137"><text:s text:c="6"/>lamip = true</text:p>
- <text:p text:style-name="P137"><text:s text:c="6"/><text:span text:style-name="T184">nproma = 48</text:span></text:p>
- <text:p text:style-name="P139"><text:s text:c="6"/>earth_angular_velocity = 7.3e-5</text:p>
- <text:p text:style-name="P139"><text:s text:c="6"/>out_expname = joe1234</text:p>
- <text:p text:style-name="P139"><text:s text:c="6"/><text:span text:style-name="T176">dt_stop = 2009, 1, 1, 0, 0, 0</text:span></text:p>
+ <text:p text:style-name="P139">[namelists]</text:p>
+ <text:p text:style-name="P149"/>
+ <text:p text:style-name="P139"><text:s text:c="2"/>[[<text:span text:style-name="T175">namelist.echam</text:span>]] </text:p>
+ <text:p text:style-name="P139"><text:s text:c="4"/>[[[runctl]]] </text:p>
+ <text:p text:style-name="P139"><text:s text:c="6"/>lamip = true</text:p>
+ <text:p text:style-name="P139"><text:s text:c="6"/><text:span text:style-name="T184">nproma = 48</text:span></text:p>
+ <text:p text:style-name="P141"><text:s text:c="6"/>earth_angular_velocity = 7.3e-5</text:p>
+ <text:p text:style-name="P141"><text:s text:c="6"/>out_expname = joe1234</text:p>
+ <text:p text:style-name="P141"><text:s text:c="6"/><text:span text:style-name="T176">dt_stop = 2009, 1, 1, 0, 0, 0</text:span></text:p>
<text:p text:style-name="P65"><text:span text:style-name="T38">defines </text:span><text:span text:style-name="T59">a single </text:span><text:span text:style-name="T38">namelist file, </text:span><text:span text:style-name="T62">'namelist.echam'</text:span><text:span text:style-name="T38">, </text:span><text:span text:style-name="T60">containing a single namelist group with four variables of different types. Note </text:span><text:span text:style-name="T79">that you do not </text:span><text:span text:style-name="T60">need to use quotes for strings nor periods for logical values.</text:span></text:p>
- <text:h text:style-name="P218" 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="P222" 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="P70"><text:span text:style-name="T58">The </text:span><text:span text:style-name="T59">names of the </text:span><text:span text:style-name="T58">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="T59">name</text:span><text:span text:style-name="T58">s, and their variables are formatted as fields of this namelist </text:span><text:span text:style-name="T59">group</text:span><text:span text:style-name="T58">. </text:span><text:span text:style-name="T59">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="T175">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="P70"><text:span text:style-name="T195">In the example above, the first four fields are single values of logical, integer, floating point, and string type.</text:span><text:span text:style-name="T62"> 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="P107"><text:soft-page-break/>&runctl</text:p>
- <text:p text:style-name="P141"><text:s text:c="4"/>lamip = <text:span text:style-name="T112">.true.</text:span></text:p>
- <text:p text:style-name="P141"><text:s text:c="4"/><text:span text:style-name="T175">nproma = </text:span><text:span text:style-name="T117">48</text:span></text:p>
- <text:p text:style-name="P140"><text:s text:c="4"/>earth_angular_velocity = <text:span text:style-name="T112">7.3e-5</text:span></text:p>
- <text:p text:style-name="P140"><text:s text:c="4"/>out_expname = <text:span text:style-name="T118">'</text:span><text:span text:style-name="T112">joe1234</text:span><text:span text:style-name="T118">'</text:span></text:p>
- <text:p text:style-name="P140"><text:span text:style-name="T62"><text:s text:c="4"/>dt_stop = </text:span><text:span text:style-name="T109">2009, 1, 1, 0, 0, 0</text:span></text:p>
- <text:p text:style-name="P125">/</text:p>
- <text:h text:style-name="P223" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2580_1114405012"/><text:span text:style-name="T60">S</text:span><text:span text:style-name="T38">uppressing namelist groups or variables</text:span><text:bookmark-end text:name="__RefHeading__2580_1114405012"/></text:h>
+ <text:p text:style-name="P109"><text:soft-page-break/>&runctl</text:p>
+ <text:p text:style-name="P143"><text:s text:c="4"/>lamip = <text:span text:style-name="T112">.true.</text:span></text:p>
+ <text:p text:style-name="P143"><text:s text:c="4"/><text:span text:style-name="T175">nproma = </text:span><text:span text:style-name="T117">48</text:span></text:p>
+ <text:p text:style-name="P142"><text:s text:c="4"/>earth_angular_velocity = <text:span text:style-name="T112">7.3e-5</text:span></text:p>
+ <text:p text:style-name="P142"><text:s text:c="4"/>out_expname = <text:span text:style-name="T118">'</text:span><text:span text:style-name="T112">joe1234</text:span><text:span text:style-name="T118">'</text:span></text:p>
+ <text:p text:style-name="P142"><text:span text:style-name="T62"><text:s text:c="4"/>dt_stop = </text:span><text:span text:style-name="T109">2009, 1, 1, 0, 0, 0</text:span></text:p>
+ <text:p text:style-name="P127">/</text:p>
+ <text:h text:style-name="P227" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2580_1114405012"/><text:span text:style-name="T60">S</text:span><text:span text:style-name="T38">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="P79"><text:span text:style-name="T38">While '.remove' is useful to </text:span><text:span text:style-name="T69">suppress</text:span><text:span text:style-name="T38"> 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="T70">Therefore, its use in model setups is strongly discouraged.</text:span></text:p>
- <text:h text:style-name="P219" 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="P223" 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="P66"><text:span text:style-name="T60">T</text:span><text:span text:style-name="T62">he </text:span><text:span text:style-name="T51">formatted namelist text </text:span><text:span text:style-name="T38">is </text:span><text:span text:style-name="T62">stor</text:span><text:span text:style-name="T38">ed </text:span><text:span text:style-name="T62">in</text:span><text:span text:style-name="T38"> a global variable </text:span><text:span text:style-name="T62">that may be used by a template placeholder</text:span><text:span text:style-name="T38">. </text:span><text:span text:style-name="T60">This way, </text:span><text:span text:style-name="T38">all job information </text:span><text:span text:style-name="T62">available </text:span><text:span text:style-name="T60">is written to</text:span><text:span text:style-name="T38"> a single script or description file, </text:span><text:span text:style-name="T60">and </text:span><text:span text:style-name="T38">native script variables </text:span><text:span text:style-name="T60">may be used</text:span><text:span text:style-name="T38"> in the namelist definitions.</text:span></text:p>
<text:p text:style-name="P68"><text:span text:style-name="T51">The name of </text:span><text:span text:style-name="T62">this </text:span><text:span text:style-name="T51">variable</text:span><text:span text:style-name="T52"> </text:span><text:span text:style-name="T62">is</text:span><text:span text:style-name="T51"> generated from </text:span><text:span text:style-name="T62">its</text:span><text:span text:style-name="T51"> </text:span><text:span text:style-name="T52">respective</text:span><text:span text:style-name="T51"> file name, </text:span><text:span text:style-name="T62">like</text:span><text:span text:style-name="T51"> 'namelist.echam', by </text:span><text:span text:style-name="T61">converting all letters to upper case </text:span><text:span text:style-name="T51">(</text:span><text:span text:style-name="T61">namelist.echam →</text:span><text:span text:style-name="T51"> </text:span><text:span text:style-name="T61">NAMELIST.ECHAM</text:span><text:span text:style-name="T51">) </text:span><text:span text:style-name="T52">and </text:span><text:span text:style-name="T51">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>
@@ -2412,51 +2438,51 @@
<text:p text:style-name="Preformatted_20_Text"><text:s text:c="2"/><text:span text:style-name="T112">[[namelist.echam]]</text:span></text:p>
<text:p text:style-name="Preformatted_20_Text"><text:s text:c="4"/>[[[runctl]]]</text:p>
<text:p text:style-name="Preformatted_20_Text_20_Interrupt"><text:s text:c="6"/>out_expname = $${EXP_ID}</text:p>
- <text:p text:style-name="P138">#! /bin/sh</text:p>
+ <text:p text:style-name="P140">#! /bin/sh</text:p>
<text:p text:style-name="Preformatted_20_Text">EXP_ID=%{EXP_ID}</text:p>
- <text:p text:style-name="P97">cat > namelist.echam << EOF</text:p>
- <text:p text:style-name="P104">%{NAMELIST_ECHAM}</text:p>
- <text:p text:style-name="P97">EOF</text:p>
+ <text:p text:style-name="P99">cat > namelist.echam << EOF</text:p>
+ <text:p text:style-name="P106">%{NAMELIST_ECHAM}</text:p>
+ <text:p text:style-name="P99">EOF</text:p>
<text:p text:style-name="P67">which expand to</text:p>
- <text:p text:style-name="P138"><text:soft-page-break/>#! /bin/sh</text:p>
+ <text:p text:style-name="P140"><text:soft-page-break/>#! /bin/sh</text:p>
<text:p text:style-name="Preformatted_20_Text">EXP_ID=joe1234</text:p>
- <text:p text:style-name="P97">cat > namelist.echam << EOF</text:p>
- <text:p text:style-name="P106">&runctl</text:p>
- <text:p text:style-name="P100"><text:s text:c="4"/>out_expname = '${EXP_ID}'</text:p>
- <text:p text:style-name="P106">/</text:p>
- <text:p text:style-name="P97">EOF</text:p>
+ <text:p text:style-name="P99">cat > namelist.echam << EOF</text:p>
+ <text:p text:style-name="P108">&runctl</text:p>
+ <text:p text:style-name="P102"><text:s text:c="4"/>out_expname = '${EXP_ID}'</text:p>
+ <text:p text:style-name="P108">/</text:p>
+ <text:p text:style-name="P99">EOF</text:p>
<text:p text:style-name="P69"><text:span text:style-name="T62">Note how this setup uses the native script variable 'EXP_ID' to set the </text:span><text:span text:style-name="T58">namelist contents.</text:span></text:p>
<text:p text:style-name="P69"><text:span text:style-name="T63">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="T62">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="T62"> </text:span><text:span text:style-name="T63">ha</text:span><text:span text:style-name="T62">s currently no way to enforce this. The template needs to be set up accordingly.</text:span></text:p>
- <text:h text:style-name="P224" text:outline-level="3">Using native script variables in namelists</text:h>
+ <text:h text:style-name="P228" text:outline-level="3">Using native script variables in namelists</text:h>
<text:p text:style-name="P86">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="P150">[namelists]</text:p>
- <text:p text:style-name="P150"><text:s text:c="2"/><text:span text:style-name="T200">[[namelist.echam]]</text:span></text:p>
- <text:p text:style-name="P150"><text:s text:c="4"/><text:span text:style-name="T200">[[[runctl]]]</text:span></text:p>
+ <text:p text:style-name="P152">[namelists]</text:p>
+ <text:p text:style-name="P152"><text:s text:c="2"/><text:span text:style-name="T200">[[namelist.echam]]</text:span></text:p>
+ <text:p text:style-name="P152"><text:s text:c="4"/><text:span text:style-name="T200">[[[runctl]]]</text:span></text:p>
<text:p text:style-name="Preformatted_20_Text_20_Interrupt"><text:s text:c="6"/><text:span text:style-name="T200">dt_stop = $$final_date</text:span></text:p>
- <text:p text:style-name="P126">final_date='2015, 12, 31, 23, 52, 30'</text:p>
- <text:p text:style-name="P98">cat > namelist.echam << EOF</text:p>
- <text:p text:style-name="P105">%{NAMELIST_ECHAM}</text:p>
- <text:p text:style-name="P127">EOF</text:p>
+ <text:p text:style-name="P128">final_date='2015, 12, 31, 23, 52, 30'</text:p>
+ <text:p text:style-name="P100">cat > namelist.echam << EOF</text:p>
+ <text:p text:style-name="P107">%{NAMELIST_ECHAM}</text:p>
+ <text:p text:style-name="P129">EOF</text:p>
<text:p text:style-name="P86">When the text for NAMELIST_ECHAM is generated, <text:span text:style-name="T9">mkexp</text:span><text:span text:style-name="T38"> 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="T85">recognized</text:span><text:span text:style-name="T38"> as a numer</text:span><text:span text:style-name="T85">ic</text:span><text:span text:style-name="T38"> or logical value. In the namelist context however it is </text:span><text:span text:style-name="T85">needed</text:span><text:span text:style-name="T38"> as a</text:span><text:span text:style-name="T85">n unquoted</text:span><text:span text:style-name="T38"> list of integers. </text:span><text:span text:style-name="T84">To fix this, simply use the special syntax 'raw(…)' </text:span><text:span text:style-name="T85">around the value:</text:span></text:p>
<text:p text:style-name="Preformatted_20_Text"><text:span text:style-name="T85"><text:s text:c="6"/></text:span><text:span text:style-name="T83">dt_stop = </text:span><text:span text:style-name="T85">raw(</text:span><text:span text:style-name="T83">$$final_date</text:span><text:span text:style-name="T85">)</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="P221" 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="P80"><text:span text:style-name="T73">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="T71">F</text:span><text:span text:style-name="T38">or any </text:span><text:span text:style-name="T73">of these</text:span><text:span text:style-name="T72"> files, the special section variable '.use_template' must be set to 'true', </text:span><text:span text:style-name="T73">and the model setup must provide a template '</text:span><text:span text:style-name="T29">subsection</text:span><text:span text:style-name="T73">.tmpl'. This template is expanded using the subsection's variables to create a suitably formatted text. </text:span><text:span text:style-name="T74">As for genuine namelists, the result is stored in a global variable.</text:span></text:p>
+ <text:h text:style-name="P225" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2584_1114405012"/>Non-namelist configuration files<text:bookmark-end text:name="__RefHeading__2584_1114405012"/></text:h>
+ <text:p text:style-name="P80"><text:span text:style-name="T73">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="T71">F</text:span><text:span text:style-name="T38">or any </text:span><text:span text:style-name="T73">of these</text:span><text:span text:style-name="T72"> files, the special section variable '.use_template' must be set to 'true', </text:span><text:span text:style-name="T73">and the model setup must provide a template '</text:span><text:span text:style-name="T29">subsection</text:span><text:span text:style-name="T73">.tmpl'. This template is expanded using the subsection's variables to create a suitably formatted text. </text:span><text:span text:style-name="T74">As for genuine namelists, the result is stored in a global </text:span><text:soft-page-break/><text:span text:style-name="T74">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="T74">D</text:span><text:span text:style-name="T38">efining input files for an experiment</text:span><text:bookmark-end text:name="__RefHeading__2831_1132221942"/></text:h>
<text:p text:style-name="P83"><text:span text:style-name="T38">While the namelist files determine the model properties, the model state </text:span><text:span text:style-name="T82">also </text:span><text:span text:style-name="T38">depends on input files for initial and boundary conditions or assimilation data. These files are defined in the [files] special section. </text:span><text:span text:style-name="T82">There 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="P217" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2833_1132221942"/>Overriding <text:span text:style-name="T198">input file</text:span>s <text:span text:style-name="T198">for certain</text:span> jobs<text:bookmark-end text:name="__RefHeading__2833_1132221942"/></text:h>
+ <text:h text:style-name="P221" text:outline-level="3"><text:bookmark-start text:name="__RefHeading__2833_1132221942"/>Overriding <text:span text:style-name="T198">input file</text:span>s <text:span text:style-name="T198">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="T199">As for namelists, t</text:span>here is special provision to change <text:span text:style-name="T198">the [</text:span>files<text:span text:style-name="T198">]</text:span> settings for a specific job. <text:span text:style-name="T198">Let us assume</text:span> <text:span text:style-name="T198">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="P132">[<text:span text:style-name="T198">files</text:span>]</text:p>
- <text:p text:style-name="P93"><text:s text:c="2"/>[[<text:span text:style-name="T198">echam</text:span>]]</text:p>
- <text:p text:style-name="P93"><text:s text:c="4"/>[[[<text:span text:style-name="T198">restart</text:span>]]]</text:p>
- <text:p text:style-name="P93"><text:s text:c="6"/><text:span text:style-name="T198">restart_myexp_echam.nc = restart_myexp_echam_18491231.nc</text:span></text:p>
+ <text:p text:style-name="P134">[<text:span text:style-name="T198">files</text:span>]</text:p>
+ <text:p text:style-name="P95"><text:s text:c="2"/>[[<text:span text:style-name="T198">echam</text:span>]]</text:p>
+ <text:p text:style-name="P95"><text:s text:c="4"/>[[[<text:span text:style-name="T198">restart</text:span>]]]</text:p>
+ <text:p text:style-name="P95"><text:s text:c="6"/><text:span text:style-name="T198">restart_myexp_echam.nc = restart_myexp_echam_18491231.nc</text:span></text:p>
<text:p text:style-name="P84">The first run <text:span text:style-name="T199">will instead pick up its state from another experiment. This is done with </text:span><text:span text:style-name="T92"><text:s/>a job specific </text:span><text:span text:style-name="T101">'file</text:span><text:span text:style-name="T92">s</text:span><text:span text:style-name="T101">'</text:span><text:span text:style-name="T92"> subsection that – apart from the addition</text:span><text:span text:style-name="T94">al</text:span><text:span text:style-name="T92"> brackets – has the same structure as</text:span><text:span text:style-name="T91"> </text:span><text:span text:style-name="T92">the global </text:span><text:span text:style-name="T101">'files'</text:span><text:span text:style-name="T92"> section.</text:span></text:p>
- <text:p text:style-name="P132">[jobs]</text:p>
- <text:p text:style-name="P132"><text:s text:c="2"/>[[run_first]]</text:p>
- <text:p text:style-name="P132"><text:s text:c="4"/><text:span text:style-name="T112">[[[</text:span><text:span text:style-name="T121">file</text:span><text:span text:style-name="T112">s]</text:span><text:span text:style-name="T121">]</text:span><text:span text:style-name="T112">]</text:span></text:p>
- <text:p text:style-name="P93"><text:s text:c="6"/><text:span text:style-name="T150">[[</text:span>[[<text:span text:style-name="T199">echam</text:span>]]<text:span text:style-name="T150">]]</text:span></text:p>
- <text:p text:style-name="P93"><text:s text:c="8"/><text:span text:style-name="T150">[[</text:span>[[[<text:span text:style-name="T199">restart</text:span>]]]<text:span text:style-name="T150">]]</text:span></text:p>
- <text:p text:style-name="P94"><text:span text:style-name="T86"><text:s text:c="10"/></text:span><text:span text:style-name="T100">restart_myexp_echam.nc = restart_</text:span><text:span text:style-name="T104">another</text:span><text:span text:style-name="T105">exp</text:span><text:span text:style-name="T100">_echam_18491231.nc</text:span></text:p>
+ <text:p text:style-name="P134">[jobs]</text:p>
+ <text:p text:style-name="P134"><text:s text:c="2"/>[[run_first]]</text:p>
+ <text:p text:style-name="P134"><text:s text:c="4"/><text:span text:style-name="T112">[[[</text:span><text:span text:style-name="T121">file</text:span><text:span text:style-name="T112">s]</text:span><text:span text:style-name="T121">]</text:span><text:span text:style-name="T112">]</text:span></text:p>
+ <text:p text:style-name="P95"><text:s text:c="6"/><text:span text:style-name="T150">[[</text:span>[[<text:span text:style-name="T199">echam</text:span>]]<text:span text:style-name="T150">]]</text:span></text:p>
+ <text:p text:style-name="P95"><text:s text:c="8"/><text:span text:style-name="T150">[[</text:span>[[[<text:span text:style-name="T199">restart</text:span>]]]<text:span text:style-name="T150">]]</text:span></text:p>
+ <text:p text:style-name="P96"><text:span text:style-name="T86"><text:s text:c="10"/></text:span><text:span text:style-name="T100">restart_myexp_echam.nc = restart_</text:span><text:span text:style-name="T104">another</text:span><text:span text:style-name="T105">exp</text:span><text:span text:style-name="T100">_echam_18491231.nc</text:span></text:p>
<text:p text:style-name="P47"><text:span text:style-name="T92">This</text:span><text:span text:style-name="T100"> will result in a '.run_first' </text:span><text:span text:style-name="T101">script</text:span><text:span text:style-name="T100"> tha</text:span><text:span text:style-name="T101">t gets the model state from 'anotherexp', while the '.run' script</text:span><text:span text:style-name="T100"> </text:span><text:span text:style-name="T101">uses 'myexp'.</text:span></text:p>
</office:text>
</office:body>
diff --git a/doc/mkexp.pdf b/doc/mkexp.pdf
index 9ea0e17115eeeb2655e412a90f1eb714b912c7a2..0e8ed8c61362e27d62f7187d2fb328e1811beba4 100644
GIT binary patch
delta 43213
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%0D|7jSr1zx#62CQKS`Wf)qoMXw69
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
O3IV4P5mDArq4_^IW5Uz`
delta 42863
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
diff --git a/setup.py b/setup.py
index fe6fcb4..8616830 100644
--- a/setup.py
+++ b/setup.py
@@ -1,7 +1,7 @@
from distutils.core import setup
name = 'mkexp'
-version = '0.3.5dev'
+version = '0.3.5'
setup(
name = name,
--
GitLab