asa172/asa172.html

<html>

  <head>
    <title>
      ASA172 - Generation of all multi-indices in a given range
    </title>
  </head>

  <body bgcolor="#EEEEEE" link="#CC0000" alink="#FF3300" vlink="#000055">

    <h1 align = "center">
      ASA172 <br> Generation of all multi-indices in a given range
    </h1>

    <hr>

    <p>
      <b>ASA172</b> 
      is a C++ library which 
      generates all multidimensional indices in a given range.
      simulating the behavior of an arbitrary number of nested loops,
      by OFlaherty and MacKenzie.
    </p>

    <p>
      If the number of dimensions was known in advance, such an operation could
      be carried out by the corresponding set of nested loops.  For example, in 3D:
      <pre>
        for ( i = i1; i <= i2; i++ )
          for ( j = j1: j <= j2; j2++ )
            for ( k = k1; k <= k2; k++ )
              (I,J,K) is an index in the range.
      </pre>
      One feature of this library, though, is that it can generate all such indexes
      for an arbitrary number of dimensions.
    </p>

    <p>
      <b>ASA172</b> is Applied Statistics Algorithm 172.  Source code for many
      Applied Statistics Algorithms is available through 
      <a href = "http://lib.stat.cmu.edu/apstat">STATLIB</a>. 
    </p>

    <h3 align = "center">
      Licensing:
    </h3>

    <p>
      The computer code and data files described and made available on this web page
      are distributed under
      <a href = "../../txt/gnu_lgpl.txt">the GNU LGPL license.</a>
    </p>

    <h3 align = "center">
      Languages:
    </h3>

    <p>
      <b>ASA172</b> is available in
      <a href = "../../c_src/asa172/asa172.html">a C version</a> and
      <a href = "../../cpp_src/asa172/asa172.html">a C++ version</a> and
      <a href = "../../f77_src/asa172/asa172.html">a FORTRAN77 version</a> and
      <a href = "../../f_src/asa172/asa172.html">a FORTRAN90 version</a> and
      <a href = "../../m_src/asa172/asa172.html">a MATLAB version.</a>
    </p>

    <h3 align = "center">
      Related Data and Programs:
    </h3>

    <p>
      <a href = "../../cpp_src/subset/subset.html">
      SUBSET</a>,
      a C++ library which
      enumerates combinations, partitions, subsets, index sets,
      trees, and other combinatorial objects.
    </p>

    <h3 align = "center">
      Author:
    </h3>

    <p>
      Original FORTRAN77 version by M OFlaherty, G MacKenzie;
      C++ version by John Burkardt.
    </p>

    <h3 align = "center">
      Reference:
    </h3>

    <p>
      <ol>
        <li>
          M OFlaherty, G MacKenzie,<br>
          Algorithm AS 172:
          Direct Simulation of Nested Fortran DO-LOOPS,<br>
          Applied Statistics,<br>
          Volume 31, Number 1, 1982, pages 71-74.
        </li>
      </ol>
    </p>

    <h3 align = "center">
      Source Code:
    </h3>

    <p>
      <ul>
        <li>
          <a href = "asa172.cpp">asa172.cpp</a>, the source code.
        </li>
        <li>
          <a href = "asa172.hpp">asa172.hpp</a>, the include file.
        </li>
        <li>
          <a href = "asa172.sh">asa172.sh</a>,
          commands to compile the source code.
        </li>
      </ul>
    </p>

    <h3 align = "center">
      Examples and Tests:
    </h3>

    <p>
      <ul>
        <li>
          <a href = "asa172_prb.cpp">asa172_prb.cpp</a>,
          a sample calling program.
        </li>
        <li>
          <a href = "asa172_prb.sh">asa172_prb.sh</a>,
          commands to compile and run the sample program.
        </li>
        <li>
          <a href = "asa172_prb_output.txt">asa172_prb_output.txt</a>,
          the output file.
        </li>
      </ul>
    </p>

    <h3 align = "center">
      List of Routines:
    </h3>

    <p>
      <ul>
        <li>
          <b>REVERS</b> reorders the subscript vector, if required.
        </li>
        <li>
          <b>SIMDO</b> generates multi-indices, simulating nested DO-loops.
        </li>
        <li>
          <b>TIMESTAMP</b> prints out the current YMDHMS date as a timestamp.
        </li>
      </ul>
    </p>

    <p>
      You can go up one level to <a href = "../cpp_src.html">
      the C++ source codes</a>.
    </p>

    <hr>

    <i>
      Last revised on 27 July 2008.
    </i>

    <!-- John Burkardt -->

  </body>

  <!-- Initial HTML skeleton created by HTMLINDEX. -->

</html>