This file is indexed.

/usr/share/doc/xmds2/faq.html is in xmds2-doc 2.2.3+dfsg-5.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">


<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
    <title>Frequently Asked Questions &mdash; XMDS2 2.2.3 documentation</title>
    
    <link rel="stylesheet" href="_static/classic.css" type="text/css" />
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
    
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    './',
        VERSION:     '2.2.3',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
      };
    </script>
    <script type="text/javascript" src="_static/jquery.js"></script>
    <script type="text/javascript" src="_static/underscore.js"></script>
    <script type="text/javascript" src="_static/doctools.js"></script>
    <script type="text/javascript" src="file:///usr/share/javascript/mathjax/MathJax.js?config=TeX-AMS_HTML,file:///usr/share/doc/xmds2/_static/mathjax-use-tex-fonts.js"></script>
    <link rel="shortcut icon" href="_static/xmds_favicon.ico"/>
    <link rel="top" title="XMDS2 2.2.3 documentation" href="index.html" />
    <link rel="next" title="Upgrading From XMDS 1.X" href="upgrade.html" />
    <link rel="prev" title="Advanced Topics" href="advanced_topics.html" /> 
  </head>
  <body role="document">
    <div class="related" role="navigation" aria-label="related navigation">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="genindex.html" title="General Index"
             accesskey="I">index</a></li>
        <li class="right" >
          <a href="upgrade.html" title="Upgrading From XMDS 1.X"
             accesskey="N">next</a> |</li>
        <li class="right" >
          <a href="advanced_topics.html" title="Advanced Topics"
             accesskey="P">previous</a> |</li>
        <li class="nav-item nav-item-0"><a href="index.html">XMDS2 2.2.3 documentation</a> &raquo;</li> 
      </ul>
    </div>  

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body" role="main">
            
  <div class="section" id="frequently-asked-questions">
<span id="faq"></span><span id="index-0"></span><h1>Frequently Asked Questions<a class="headerlink" href="#frequently-asked-questions" title="Permalink to this headline"></a></h1>
<div class="section" id="xmds-scripts-look-complicated-how-do-i-start">
<h2>XMDS scripts look complicated! How do I start?<a class="headerlink" href="#xmds-scripts-look-complicated-how-do-i-start" title="Permalink to this headline"></a></h2>
<p>If you&#8217;re unfamiliar with XMDS2, writing a script from scratch might seem difficult. In most cases, however, the best approach is to take an existing script and modify it for your needs. At the most basic level, you can simply take a script from the /examples directory that is similar to what you want to do, change the name of the integration variable(s) and replace the line describing the differential equation to use your DE instead. That&#8217;s all you need to do, and will ensure all the syntax is correct and all the required XML blocks are present.</p>
<p>You can then incrementally change things such as the number of output points, what quantities get output, number of grid points, and so on. Many XMDS2 users have never written a script from scratch, and just use their previous scripts and example scripts as a scaffold when they create a script for a new problem.</p>
</div>
<div class="section" id="where-can-i-get-help">
<h2>Where can I get help?<a class="headerlink" href="#where-can-i-get-help" title="Permalink to this headline"></a></h2>
<p>The documentation on this website is currently incomplete, but it still covers a fair bit and is worth reading. Similarly, the example scripts in the /examples directory cover most of the functionality of XMDS2, so it&#8217;s worth looking looking through them to see if any of them do something similar to what you&#8217;re trying to do.</p>
<p>You should also feel free to email questions to the XMDS users&#8217; mailing list at <a class="reference external" href="mailto:xmds-users&#37;&#52;&#48;lists&#46;sourceforge&#46;net">xmds-users<span>&#64;</span>lists<span>&#46;</span>sourceforge<span>&#46;</span>net</a>, where the developers and other users can assist you. You can join the mailing list by going to <a class="reference external" href="http://sourceforge.net/projects/xmds/">http://sourceforge.net/projects/xmds/</a> and clicking on &#8220;mailing lists.&#8221; Also, if you look through the mailing list archives, your particular problem may already have been discussed.</p>
</div>
<div class="section" id="how-should-i-cite-xmds2">
<span id="index-1"></span><h2>How should I cite XMDS2?<a class="headerlink" href="#how-should-i-cite-xmds2" title="Permalink to this headline"></a></h2>
<p>If you publish work that has involved XMDS2, please cite it as: <a class="reference external" href="http://dx.doi.org/10.1016/j.cpc.2012.08.016">Comput. Phys. Commun. 184, 201-208 (2013)</a>.</p>
</div>
<div class="section" id="i-think-i-found-a-bug-where-should-i-report-it">
<span id="index-2"></span><h2>I think I found a bug! Where should I report it?<a class="headerlink" href="#i-think-i-found-a-bug-where-should-i-report-it" title="Permalink to this headline"></a></h2>
<p>Please report bugs to the developer mailing list at <a class="reference external" href="mailto:xmds-devel&#37;&#52;&#48;lists&#46;sourceforge&#46;net">xmds-devel<span>&#64;</span>lists<span>&#46;</span>sourceforge<span>&#46;</span>net</a>. In your email, please include a description of the problem and attach the XMDS2 script that triggers the bug.</p>
</div>
<div class="section" id="how-do-i-put-time-dependence-into-my-vectors">
<span id="index-3"></span><h2>How do I put time dependence into my vectors?<a class="headerlink" href="#how-do-i-put-time-dependence-into-my-vectors" title="Permalink to this headline"></a></h2>
<p>Standard vectors can&#8217;t have time dependence (or, more accurately, depend on the <code class="docutils literal"><span class="pre">propagation_dimension</span></code> variable), but computed vectors can. So, for example, if you have set your <code class="docutils literal"><span class="pre">propagation_dimension</span></code> as &#8220;t&#8221;, you can simply use the variable &#8220;t&#8221; in your computed vector and it will work.</p>
<p>Alternatively, you can explicitly use the <code class="docutils literal"><span class="pre">propagation_dimension</span></code> variable in your differential equation inside the <code class="docutils literal"><span class="pre">&lt;operators&gt;</span></code> block.</p>
</div>
<div class="section" id="can-i-specify-the-range-of-my-domain-and-number-of-grid-points-at-run-time">
<span id="index-4"></span><h2>Can I specify the range of my domain and number of grid points at run-time?<a class="headerlink" href="#can-i-specify-the-range-of-my-domain-and-number-of-grid-points-at-run-time" title="Permalink to this headline"></a></h2>
<p>Yes, you can. In your script, specify the domain and number of grid points as arguments to be passed in at run-time, use those variables in your <code class="docutils literal"><span class="pre">&lt;geometry&gt;</span></code> block rather than explicitly specifying them, and use the <code class="docutils literal"><span class="pre">&lt;validation</span> <span class="pre">kind=&quot;run-time&quot;</span> <span class="pre">/&gt;</span></code> feature. See the <a class="reference internal" href="reference_elements.html#validation"><span>Validation</span></a> entry in the Reference section for an example.</p>
<p>While the domain can always be specified in this way, specifying the lattice size at run-time is currently only allowed with the following transforms: &#8216;dct&#8217;, &#8216;dst&#8217;, &#8216;dft&#8217; and &#8216;none&#8217; (see <a class="reference internal" href="reference_elements.html#validation"><span>Transforms</span></a> in the Reference section).</p>
<p>Also note that for some multi-dimensional spaces using different transforms, XMDS2 will sometimes optimise the code it generates based on the relative sizes of the dimensions. If one or more of the lattices are specified at run-time it is unable to do this and will have to make guesses. In some situations this may result in slightly slower code.</p>
</div>
<div class="section" id="when-can-i-use-ip-operators-and-why-should-i-and-when-must-i-use-ex-operators">
<span id="index-5"></span><h2>When can I use IP operators (and why should I) and when must I use EX operators?<a class="headerlink" href="#when-can-i-use-ip-operators-and-why-should-i-and-when-must-i-use-ex-operators" title="Permalink to this headline"></a></h2>
<p>An <a class="reference internal" href="reference_elements.html#operatornameselement"><span>&lt;operator&gt;</span></a> that specifies named operators to be used in integration equations can have the <code class="docutils literal"><span class="pre">kind=&quot;IP&quot;</span></code> or <code class="docutils literal"><span class="pre">kind=&quot;EX&quot;</span></code> attribute, standing for &#8216;interaction picture&#8217; and &#8216;explicit&#8217; operators respectively.  Explicit operators can be used in all situations, and simply construct and calculate a new vector of the form in the square brackets.  IP operators use less memory and can improve speed by allowing larger timesteps, but have two important restrictions.  <strong>Use of IP operators without understanding these restrictions can lead to incorrect code</strong>.</p>
<p>Some explanation is in order.  The IP algorithm applies the operator separately to the rest of the evolution.  The reason this can be so effective is that the separate evolution can be performed exactly.  The solution of the equation <span class="math">\(\frac{d \psi}{dt} = L \psi\)</span> is <span class="math">\(\psi(t+\Delta t) = exp(L \Delta t) \psi(t)\)</span> for arbitrarily large timestep <span class="math">\(\Delta t\)</span>.  For a diagonal linear <code class="docutils literal"><span class="pre">L</span></code>, the matrix exponential is straightforward.  Also, when it is constant, then the exponential can be computed and stored prior to the integration, which makes the implementation of this operator very cheap.  Thus, when IP operators are defined, XMDS2 reads the equations as written by the user, and determines which operators to apply to which fields.  It then implements these operators separately, and the text describing the operator inside the equations (in this example, the <code class="docutils literal"><span class="pre">L[psi]</span></code> term) is replaced by the numeral zero.</p>
<p>Therefore, the limitations of IP operators themselves means that they can only be applied to to named components of one of the integration vectors, and not functions of those components.  Furthermore, an IP operator acting on a component must only be used in the derivative for that particular component.  Secondly, due to the implementation of IP operators in XMDS2, it is not safe to use them in comments, or in conjunction with declared variables.  It is also not safe to multiply or divide them by any factors, functions or vectors.  They must turn up in a purely additive way when defining the derivative of a component of an integration vector.  The XMDS2 parser attempts to catch possible violations of these rules, and will produce warnings in some cases.</p>
</div>
<div class="section" id="visual-editors">
<h2>Visual Editors<a class="headerlink" href="#visual-editors" title="Permalink to this headline"></a></h2>
<p>In this section goes stuff about how to set up TextMate (or other editors to highlight xpdeint scripts).</p>
</div>
</div>


          </div>
        </div>
      </div>
      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
        <div class="sphinxsidebarwrapper">
            <p class="logo"><a href="index.html">
              <img class="logo" src="_static/xmds_logo.png" alt="Logo"/>
            </a></p>
  <h3><a href="index.html">Table Of Contents</a></h3>
  <ul>
<li><a class="reference internal" href="#">Frequently Asked Questions</a><ul>
<li><a class="reference internal" href="#xmds-scripts-look-complicated-how-do-i-start">XMDS scripts look complicated! How do I start?</a></li>
<li><a class="reference internal" href="#where-can-i-get-help">Where can I get help?</a></li>
<li><a class="reference internal" href="#how-should-i-cite-xmds2">How should I cite XMDS2?</a></li>
<li><a class="reference internal" href="#i-think-i-found-a-bug-where-should-i-report-it">I think I found a bug! Where should I report it?</a></li>
<li><a class="reference internal" href="#how-do-i-put-time-dependence-into-my-vectors">How do I put time dependence into my vectors?</a></li>
<li><a class="reference internal" href="#can-i-specify-the-range-of-my-domain-and-number-of-grid-points-at-run-time">Can I specify the range of my domain and number of grid points at run-time?</a></li>
<li><a class="reference internal" href="#when-can-i-use-ip-operators-and-why-should-i-and-when-must-i-use-ex-operators">When can I use IP operators (and why should I) and when must I use EX operators?</a></li>
<li><a class="reference internal" href="#visual-editors">Visual Editors</a></li>
</ul>
</li>
</ul>

<div id="searchbox" style="display: none" role="search">
  <h3>Quick search</h3>
    <form class="search" action="search.html" method="get">
      <input type="text" name="q" />
      <input type="submit" value="Go" />
      <input type="hidden" name="check_keywords" value="yes" />
      <input type="hidden" name="area" value="default" />
    </form>
    <p class="searchtip" style="font-size: 90%">
    Enter search terms or a module, class or function name.
    </p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
        </div>
      </div>
      <div class="clearer"></div>
    </div>
    <div class="related" role="navigation" aria-label="related navigation">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="genindex.html" title="General Index"
             >index</a></li>
        <li class="right" >
          <a href="upgrade.html" title="Upgrading From XMDS 1.X"
             >next</a> |</li>
        <li class="right" >
          <a href="advanced_topics.html" title="Advanced Topics"
             >previous</a> |</li>
        <li class="nav-item nav-item-0"><a href="index.html">XMDS2 2.2.3 documentation</a> &raquo;</li> 
      </ul>
    </div>
    <div class="footer" role="contentinfo">
        &copy; Copyright 2008-2014, Graham Dennis, Joe Hope and Mattias Johnsson. Licensed under the GNU FDL.
      Last updated on Jan 21, 2017.
      Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.3.6.
    </div>
  </body>
</html>