table_top/table_top.html

<html>

  <head>
    <title>
      TABLE_TOP - Plot Pairs of M-dimensional Data
    </title>
  </head>

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

    <h1 align = "center">
      TABLE_TOP <br> Plot Pairs of M-dimensional Data
    </h1>

    <hr>

    <p>
      <b>TABLE_TOP</b>
      is a FORTRAN90 program which
      displays patterns in a set of N points in M dimensions.
    </p>

    <p>
      The program simply creates an array of M<sup>2</sup> two dimensional
      subplots.  Plot (I,J) plots the I-th and J-th coordinate
      values against each other.  Simple patterns in the data may
      show up in the plots.
    </p>

    <p>
      <b>TABLE_TOP</b> then creates a PostScript file containing the plots, using
      routines from the PS_WRITE library.
    </p>

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

    <p>
      <dl>
        <dt>
          <b>table_top</b> <i>data.txt</i>
        </dt>
        <dd>
          reads the data in <i>data.txt</i> and makes the plots.
        </dd>
      </dl>
    </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">
      Related Data and Programs:
    </h3>

    <p>
      <a href = "../../f_src/ps_write/ps_write.html">
      PS_WRITE</a>,
      a FORTRAN90 library which
      creates a PostScript
      graphics file.  This library is used by <b>TABLE_TOP</b>.
    </p>

    <p>
      <a href = "../../f_src/table_barplot_ppma/table_barplot_ppma.html">
      TABLE_BARPLOT_PPMA</a>,
      a FORTRAN90 program which
      reads a table file and creates a
      PPMA bargraph of the data.
    </p>

    <p>
      <a href = "../../f_src/table_border/table_border.html">
      TABLE_BORDER</a>,
      a FORTRAN90 program which
       can be used to add a border
      (of zero values) to a table file.
    </p>

    <p>
      <a href = "../../f_src/table_columns/table_columns.html">
      TABLE_COLUMNS</a>,
      a FORTRAN90 program which
      can extract specific columns of data
      from a table file.
    </p>

    <p>
      <a href = "../../f_src/table_delaunay/table_delaunay.html">
      TABLE_DELAUNAY</a>,
      a FORTRAN90 program which
      computes the Delaunay triangulation of a set
      of points.
    </p>

    <p>
      <a href = "../../f_src/table_histogram/table_histogram.html">
      TABLE_HISTOGRAM</a>,
      a FORTRAN90 program which
      can make a histogram of a set of points
      stored in a table file.
    </p>

    <p>
      <a href = "../../f_src/table_io/table_io.html">
      TABLE_IO</a>,
      a FORTRAN90 library which
      supplies the routines used to read the TABLE file.
    </p>

    <p>
      <a href = "../../f_src/table_latinize/table_latinize.html">
      TABLE_LATINIZE</a>,
      a FORTRAN90 program which
      reads a file of
      points and creates a "latinized" version by adjusting the data.
    </p>

    <p>
      <a href = "../../f_src/table_merge/table_merge.html">
      TABLE_MERGE</a>,
      a FORTRAN90 program which
      reads a file of
      points and can delete points that are identical or close.
    </p>

    <p>
      <a href = "../../f_src/table_orthonormalize/table_orthonormalize.html">
      TABLE_ORTHONORMALIZE</a>,
      a FORTRAN90 program which
      reads a file of
      points and orthonormalizes the columns.
    </p>

    <p>
      <a href = "../../f_src/table_quality/table_quality.html">
      TABLE_QUALITY</a>,
      a FORTRAN90 program which
      reads a file of
      points and computes the quality of dispersion.
    </p>

    <p>
      <a href = "../../f_src/table_record_match/table_record_match.html">
      TABLE_RECORD_MATCH</a>,
      a FORTRAN90 program which
      can be used to find close records in a table file.
    </p>

    <p>
      <a href = "../../f_src/table_scale/table_scale.html">
      TABLE_SCALE</a>,
      a FORTRAN90 program which
      can be used to multiply the entries of a table file
      by a scale vector.
    </p>

    <p>
      <a href = "../../f_src/table_shift/table_shift.html">
      TABLE_SHIFT</a>,
      a FORTRAN90 program which
      can be used to shift the entries of a table file
      by a shift vector.
    </p>

    <p>
      <a href = "../../f_src/table_stats/table_stats.html">
      TABLE_STATS</a>,
      a FORTRAN90 program which
      can read a table file and compute certain statistics.
    </p>

    <p>
      <a href = "../../f_src/table_tet_mesh/table_tet_mesh.html">
      TABLE_TET_MESH</a>,
      a FORTRAN90 program which
      can read a table file of 3D data, and compute a
      tetrahedral mesh.
    </p>

    <p>
      <a href = "../../f_src/table_unborder/table_unborder.html">
      TABLE_UNBORDER</a>,
      a FORTRAN90 program which
      can be used to remove the border from a table file.
    </p>

    <p>
      <a href = "../../f_src/table_uniform_noise/table_uniform_noise.html">
      TABLE_UNIFORM_NOISE</a>,
      a FORTRAN90 program which
      can be used to add a uniform noise term to the data
      in a table file.
    </p>

    <p>
      <a href = "../../f_src/table_voronoi/table_voronoi.html">
      TABLE_VORONOI</a>,
      a FORTRAN90 program which
      can be used to compute information about
      the Voronoi diagram of the points.
    </p>

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

    <p>
      <ul>
        <li>
          <a href = "table_top.f90">table_top.f90</a>, the source code.
        </li>
        <li>
          <a href = "table_top.sh">table_top.sh</a>,
          commands to compile the source code.
        </li>
      </ul>
    </p>

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

    <p>
      <b>POWERS.TXT</b> is a set of data that does not lie between 0 and
      1.  (The TABLE_TOP program used to assume, in fact, that the
      data did lie between 0 and 1.)  Test files you may copy include:
      <ul>
        <li>
          <a href = "powers.txt">powers.txt</a>,
          a set of 4 dimensional sample data.
        </li>
        <li>
          <a href = "powers_output.txt">powers_output.txt</a>,
          the printed output from running TABLE_TOP on the data.
        </li>
        <li>
          <a href = "powers.png">powers.png</a>,
          a <a href = "../../data/png/png.html">PNG</a> image of
          the sample data.
        </li>
      </ul>
    </p>

    <p>
      <b>TABLE_TOP_PRB.TXT</b> is a dummy set of data.  There are 10
      4 dimensional points.  Test files you may copy include:
      <ul>
        <li>
          <a href = "table_top_prb.txt">table_top_prb.txt</a>,
          a set of 4 dimensional sample data.
        </li>
        <li>
          <a href = "table_top_prb_output.txt">table_top_prb_output.txt</a>,
          the printed output from running TABLE_TOP on the data.
        </li>
        <li>
          <a href = "table_top_prb.png">table_top_prb.png</a>,
          a <a href = "../../data/png/png.html">PNG</a> image of
          the sample data.
        </li>
      </ul>
    </p>

    <p>
      <b>CVT_03_00007.TXT</b> is a set of 3 dimensional data, generated
      by a centroidal Voronoi tessellation process.  We were interested
      in seeing how the 2D projections looked.  Test files you may copy include:
      <ul>
        <li>
          <a href = "cvt_03_00007.txt">cvt_03_00007.txt</a>,
          a set of 3 dimensional sample data.
        </li>
        <li>
          <a href = "cvt_03_00007_output.txt">cvt_03_00007_output.txt</a>,
          the printed output from running TABLE_TOP on the data.
        </li>
        <li>
          <a href = "cvt_03_00007.png">cvt_03_00007.png</a>,
          a <a href = "../../data/png/png.html">PNG</a> image of
          the sample data.
        </li>
        <li>
          <a href = "cvt_03_00007.latin.txt">cvt_03_00007.latin.txt</a>,
          a "latinized" version of the data set.
        </li>
        <li>
          <a href = "cvt_03_00007.latin.png">cvt_03_00007.latin.png</a>,
          a <a href = "../../data/png/png.html">PNG</a> image of
          the "latinized" version of the data set.
        </li>
      </ul>
    </p>

    <p>
      <b>CVT_03_00056.TXT</b> is 8 times as much data as CVT_03_00007.TXT.
      We really hoped that we would see a pattern, and for once,
      our hopes were rewarded.  The 2D projections clearly indicate
      the formation of a roughly regular grid that divides the
      faces into cells.  Test files you may copy include:
      <ul>
        <li>
          <a href = "cvt_03_00056.txt">cvt_03_00056.txt</a>,
          a set of 3 dimensional sample data.
        </li>
        <li>
          <a href = "cvt_03_00056_output.txt">cvt_03_00056_output.txt</a>,
          the printed output from running TABLE_TOP on the data.
        </li>
        <li>
          <a href = "cvt_03_00056.png">cvt_03_00056.png</a>,
          a <a href = "../../data/png/png.html">PNG</a> image of
          the sample data.
        </li>
        <li>
          <a href = "cvt_03_00056.latin.txt">cvt_03_00056.latin.txt</a>,
          a "latinized" version of the data set.
        </li>
        <li>
          <a href = "cvt_03_00056.latin.png">cvt_03_00056.latin.png</a>,
          a <a href = "../../data/png/png.html">PNG</a> image of
          the "latinized" version of the data set.
        </li>
      </ul>
    </p>

    <p>
      <b>CVT_07_00100.TXT</b> is a set of 7 dimensional data, generated
      by a centroidal Voronoi tessellation process.  It is desirable
      to have the data points well spread out.  However, the facts of
      7 dimensional geometry fight against this (let alone any defects
      in the CVT algorithm)!  Test files you may copy include:
      <ul>
        <li>
          <a href = "cvt_07_00100.txt">cvt_07_00100.txt</a>,
          a set of 4 dimensional sample data.
        </li>
        <li>
          <a href = "cvt_07_00100_output.txt">cvt_07_00100_output.txt</a>,
          the printed output from running TABLE_TOP on the data.
        </li>
        <li>
          <a href = "cvt_07_00100_0.png">cvt_07_00100_0.png</a>,
          a <a href = "../../data/png/png.html">PNG</a> image of
          the "page 0" of the sample data.
        </li>
        <li>
          <a href = "cvt_07_00100_1.png">cvt_07_00100_1.png</a>,
          a <a href = "../../data/png/png.html">PNG</a> image of
          the "page 1" of the sample data.
        </li>
        <li>
          <a href = "cvt_07_00100_2.png">cvt_07_00100_2.png</a>,
          a <a href = "../../data/png/png.html">PNG</a> image of
          the "page 2" of the sample data.
        </li>
        <li>
          <a href = "cvt_07_00100_3.png">cvt_07_00100_3.png</a>,
          a <a href = "../../data/png/png.html">PNG</a> image of
          the "page 3" of the sample data.
        </li>
        <li>
          <a href = "cvt_07_00100.latin.txt">cvt_07_00100.latin.txt</a>,
          a "latinized" version of the data set.
        </li>
        <li>
          <a href = "cvt_07_00100.latin_0.png">cvt_07_00100.latin_0.png</a>,
          a <a href = "../../data/png/png.html">PNG</a> image of
          the "page 0" of the "latinized" data.
        </li>
        <li>
          <a href = "cvt_07_00100.latin_1.png">cvt_07_00100.latin_1.png</a>,
          a <a href = "../../data/png/png.html">PNG</a> image of
          the "page 1" of the "latinized" data.
        </li>
        <li>
          <a href = "cvt_07_00100.latin_2.png">cvt_07_00100.latin_2.png</a>,
          a <a href = "../../data/png/png.html">PNG</a> image of
          the "page 2" of the "latinized" data.
        </li>
        <li>
          <a href = "cvt_07_00100.latin_3.png">cvt_07_00100.latin_3.png</a>,
          a <a href = "../../data/png/png.html">PNG</a> image of
          the "page 3" of the "latinized" data.
        </li>
      </ul>
    </p>

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

    <p>
      <ul>
        <li>
          <b>MAIN</b> is the main program for TABLE_TOP.
        </li>
        <li>
          <b>CH_EQI</b> is a case insensitive comparison of two characters for equality.
        </li>
        <li>
          <b>CH_TO_DIGIT</b> returns the integer value of a base 10 digit.
        </li>
        <li>
          <b>DTABLE_DATA_PRINT_SOME</b> prints some of a double precision table dataset.
        </li>
        <li>
          <b>DTABLE_DATA_READ</b> reads double precision table data from a file.
        </li>
        <li>
          <b>FILE_COLUMN_COUNT</b> counts the number of columns in the first line of a file.
        </li>
        <li>
          <b>FILE_NAME_EXT_GET</b> determines the "extension" of a file name.
        </li>
        <li>
          <b>FILE_NAME_EXT_SWAP</b> replaces the current "extension" of a file name.
        </li>
        <li>
          <b>FILE_ROW_COUNT</b> counts the number of row records in a file.
        </li>
        <li>
          <b>GET_UNIT</b> returns a free FORTRAN unit number.
        </li>
        <li>
          <b>PAIR_PLOT</b> plots pairs of coordinates.
        </li>
        <li>
          <b>S_BLANK_DELETE</b> removes blanks from a string, left justifying the remainder.
        </li>
        <li>
          <b>S_INDEX_LAST</b> finds the LAST occurrence of a given substring.
        </li>
        <li>
          <b>S_TO_R8</b> reads an R8 from a string.
        </li>
        <li>
          <b>S_TO_R8VEC</b> reads an R8VEC from a string.
        </li>
        <li>
          <b>S_WORD_COUNT</b> counts the number of "words" in a string.
        </li>
        <li>
          <b>TABLE_HEADER_READ</b> reads header data from a file.
        </li>
        <li>
          <b>TIMESTAMP</b> prints the current YMDHMS date as a time stamp.
        </li>
      </ul>
    </p>

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

    <hr>

    <i>
      Last revised on 21 January 2007.
    </i>

    <!-- John Burkardt -->

  </body>

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

</html>