<div class="section" id="defining-a-new-suite"> <span id="defining-a-suite"></span><span id="index-0"></span> <p>Create a file called <tt class="file docutils literal"><span class="pre">test.def</span></tt> with the following contents: (not the line numbers)</p> <div class="highlight-python"><pre>1 # Definition of the suite test 2 3 suite test 4 edit ECF_HOME "$HOME/course" # replace '$HOME' with the path to your home directory 5 task t1 6 endsuite</pre> </div> <p>This file contains the <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-suite-definition"><em class="xref std std-term">suite definition</em></a> of a <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-suite"><em class="xref std std-term">suite</em></a> called test. This suite contains a single <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-task"><em class="xref std std-term">task</em></a> called <strong>t1</strong>. Let us go through the lines one by one:</p> <ol class="arabic"> <li><p class="first">This line is a comment line. Any characters between the # and the end of line are ignored</p> </li> <li><p class="first">The second line is empty</p> </li> <li><p class="first">This line defines a new <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-suite"><em class="xref std std-term">suite</em></a> by the name of test.</p> </li> <li><p class="first">Here we define a ECF <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-variable"><em class="xref std std-term">variable</em></a> called ECF_HOME.</p> <p>This <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-variable"><em class="xref std std-term">variable</em></a> defines the directory where all the unix files that will be used by the <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-suite"><em class="xref std std-term">suite</em></a> test will reside.</p> <p>For the rest of the course all file names will be given relative to this directory.</p> <p>Be sure to <strong>replace</strong> $HOME with the path to your home directory</p> </li> <li><p class="first">This defines a <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-task"><em class="xref std std-term">task</em></a> named <strong>t1</strong></p> </li> <li><p class="first">The <a class="reference internal" href="/wiki/display/ECFLOW/Definition+file+Grammer#grammar-token-endsuite"><tt class="xref std std-token docutils literal"><span class="pre">endsuite</span></tt></a> finishes the definition of the <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-suite"><em class="xref std std-term">suite</em></a> test</p> </li> </ol> <p>Alternatively enter the following python code:</p> <div class="highlight-python"><div class="highlight"><pre><span class="c">#!/usr/bin/env python2.5</span> <span class="kn">import</span> <span class="nn">os</span> <span class="kn">import</span> <span class="nn">ecflow</span> <span class="n">defs</span> <span class="o">=</span> <span class="n">ecflow</span><span class="o">.</span><span class="n">Defs</span><span class="p">(</span><span class="s">"test.def"</span><span class="p">)</span> <span class="n">suite</span> <span class="o">=</span> <span class="n">defs</span><span class="o">.</span><span class="n">add_suite</span><span class="p">(</span><span class="s">"test"</span><span class="p">)</span> <span class="n">suite</span><span class="o">.</span><span class="n">add_variable</span><span class="p">(</span><span class="s">"ECF_HOME"</span><span class="p">,</span><span class="n">os</span><span class="o">.</span><span class="n">getenv</span><span class="p">(</span><span class="s">"HOME"</span><span class="p">)</span> <span class="o">+</span> <span class="s">"/course"</span><span class="p">)</span> <span class="n">suite</span><span class="o">.</span><span class="n">add_task</span><span class="p">(</span><span class="s">"t1"</span><span class="p">)</span> </pre></div> </div> <p>What to do</p> <ol class="arabic simple"> <li>Choose between entering plain text or python</li> <li>Type in the <a class="reference internal" href="/wiki/display/ECFLOW/Glossary#term-suite-definition"><em class="xref std std-term">suite definition</em></a> file. Do not type the line numbers!</li> </ol> </div> |