README.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
   2     "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
   4 <head>
   5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
   6 <meta name="generator" content="AsciiDoc 8.2.1" />
   7 <style type="text/css">
   8 /* Debug borders */
   9 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
  10 /*
  11   border: 1px solid red;
  12 */
  13 }
  14
  15 body {
  16   margin: 1em 5% 1em 5%;
  17 }
  18
  19 a {
  20   color: blue;
  21   text-decoration: underline;
  22 }
  23 a:visited {
  24   color: fuchsia;
  25 }
  26
  27 em {
  28   font-style: italic;
  29 }
  30
  31 strong {
  32   font-weight: bold;
  33 }
  34
  35 tt {
  36   color: navy;
  37 }
  38
  39 h1, h2, h3, h4, h5, h6 {
  40   color: #527bbd;
  41   font-family: sans-serif;
  42   margin-top: 1.2em;
  43   margin-bottom: 0.5em;
  44   line-height: 1.3;
  45 }
  46
  47 h1 {
  48   border-bottom: 2px solid silver;
  49 }
  50 h2 {
  51   border-bottom: 2px solid silver;
  52   padding-top: 0.5em;
  53 }
  54
  55 div.sectionbody {
  56   font-family: serif;
  57   margin-left: 0;
  58 }
  59
  60 hr {
  61   border: 1px solid silver;
  62 }
  63
  64 p {
  65   margin-top: 0.5em;
  66   margin-bottom: 0.5em;
  67 }
  68
  69 pre {
  70   padding: 0;
  71   margin: 0;
  72 }
  73
  74 span#author {
  75   color: #527bbd;
  76   font-family: sans-serif;
  77   font-weight: bold;
  78   font-size: 1.1em;
  79 }
  80 span#email {
  81 }
  82 span#revision {
  83   font-family: sans-serif;
  84 }
  85
  86 div#footer {
  87   font-family: sans-serif;
  88   font-size: small;
  89   border-top: 2px solid silver;
  90   padding-top: 0.5em;
  91   margin-top: 4.0em;
  92 }
  93 div#footer-text {
  94   float: left;
  95   padding-bottom: 0.5em;
  96 }
  97 div#footer-badges {
  98   float: right;
  99   padding-bottom: 0.5em;
 100 }
 101
 102 div#preamble,
 103 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
 104 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
 105 div.admonitionblock {
 106   margin-right: 10%;
 107   margin-top: 1.5em;
 108   margin-bottom: 1.5em;
 109 }
 110 div.admonitionblock {
 111   margin-top: 2.5em;
 112   margin-bottom: 2.5em;
 113 }
 114
 115 div.content { /* Block element content. */
 116   padding: 0;
 117 }
 118
 119 /* Block element titles. */
 120 div.title, caption.title {
 121   font-family: sans-serif;
 122   font-weight: bold;
 123   text-align: left;
 124   margin-top: 1.0em;
 125   margin-bottom: 0.5em;
 126 }
 127 div.title + * {
 128   margin-top: 0;
 129 }
 130
 131 td div.title:first-child {
 132   margin-top: 0.0em;
 133 }
 134 div.content div.title:first-child {
 135   margin-top: 0.0em;
 136 }
 137 div.content + div.title {
 138   margin-top: 0.0em;
 139 }
 140
 141 div.sidebarblock > div.content {
 142   background: #ffffee;
 143   border: 1px solid silver;
 144   padding: 0.5em;
 145 }
 146
 147 div.listingblock {
 148   margin-right: 0%;
 149 }
 150 div.listingblock > div.content {
 151   border: 1px solid silver;
 152   background: #f4f4f4;
 153   padding: 0.5em;
 154 }
 155
 156 div.quoteblock > div.content {
 157   padding-left: 2.0em;
 158 }
 159
 160 div.attribution {
 161   text-align: right;
 162 }
 163 div.verseblock + div.attribution {
 164   text-align: left;
 165 }
 166
 167 div.admonitionblock .icon {
 168   vertical-align: top;
 169   font-size: 1.1em;
 170   font-weight: bold;
 171   text-decoration: underline;
 172   color: #527bbd;
 173   padding-right: 0.5em;
 174 }
 175 div.admonitionblock td.content {
 176   padding-left: 0.5em;
 177   border-left: 2px solid silver;
 178 }
 179
 180 div.exampleblock > div.content {
 181   border-left: 2px solid silver;
 182   padding: 0.5em;
 183 }
 184
 185 div.verseblock div.content {
 186   white-space: pre;
 187 }
 188
 189 div.imageblock div.content { padding-left: 0; }
 190 div.imageblock img { border: 1px solid silver; }
 191 span.image img { border-style: none; }
 192
 193 dl {
 194   margin-top: 0.8em;
 195   margin-bottom: 0.8em;
 196 }
 197 dt {
 198   margin-top: 0.5em;
 199   margin-bottom: 0;
 200   font-style: italic;
 201 }
 202 dd > *:first-child {
 203   margin-top: 0;
 204 }
 205
 206 ul, ol {
 207     list-style-position: outside;
 208 }
 209 ol.olist2 {
 210   list-style-type: lower-alpha;
 211 }
 212
 213 div.tableblock > table {
 214   border: 3px solid #527bbd;
 215 }
 216 thead {
 217   font-family: sans-serif;
 218   font-weight: bold;
 219 }
 220 tfoot {
 221   font-weight: bold;
 222 }
 223
 224 div.hlist {
 225   margin-top: 0.8em;
 226   margin-bottom: 0.8em;
 227 }
 228 div.hlist td {
 229   padding-bottom: 5px;
 230 }
 231 td.hlist1 {
 232   vertical-align: top;
 233   font-style: italic;
 234   padding-right: 0.8em;
 235 }
 236 td.hlist2 {
 237   vertical-align: top;
 238 }
 239
 240 @media print {
 241   div#footer-badges { display: none; }
 242 }
 243
 244 div#toctitle {
 245   color: #527bbd;
 246   font-family: sans-serif;
 247   font-size: 1.1em;
 248   font-weight: bold;
 249   margin-top: 1.0em;
 250   margin-bottom: 0.1em;
 251 }
 252
 253 div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
 254   margin-top: 0;
 255   margin-bottom: 0;
 256 }
 257 div.toclevel2 {
 258   margin-left: 2em;
 259   font-size: 0.9em;
 260 }
 261 div.toclevel3 {
 262   margin-left: 4em;
 263   font-size: 0.9em;
 264 }
 265 div.toclevel4 {
 266   margin-left: 6em;
 267   font-size: 0.9em;
 268 }
 269 /* Workarounds for IE6's broken and incomplete CSS2. */
 270
 271 div.sidebar-content {
 272   background: #ffffee;
 273   border: 1px solid silver;
 274   padding: 0.5em;
 275 }
 276 div.sidebar-title, div.image-title {
 277   font-family: sans-serif;
 278   font-weight: bold;
 279   margin-top: 0.0em;
 280   margin-bottom: 0.5em;
 281 }
 282
 283 div.listingblock div.content {
 284   border: 1px solid silver;
 285   background: #f4f4f4;
 286   padding: 0.5em;
 287 }
 288
 289 div.quoteblock-content {
 290   padding-left: 2.0em;
 291 }
 292
 293 div.exampleblock-content {
 294   border-left: 2px solid silver;
 295   padding-left: 0.5em;
 296 }
 297
 298 /* IE6 sets dynamically generated links as visited. */
 299 div#toc a:visited { color: blue; }
 300 </style>
 301 <script type="text/javascript">
 302 /*<![CDATA[*/
 303 window.onload = function(){generateToc(2)}
 304 /* Author: Mihai Bazon, September 2002
 305  * http://students.infoiasi.ro/~mishoo
 306  *
 307  * Table Of Content generator
 308  * Version: 0.4
 309  *
 310  * Feel free to use this script under the terms of the GNU General Public
 311  * License, as long as you do not remove or alter this notice.
 312  */
 313
 314  /* modified by Troy D. Hanson, September 2006. License: GPL */
 315  /* modified by Stuart Rackham, October 2006. License: GPL */
 316
 317 function getText(el) {
 318   var text = "";
 319   for (var i = el.firstChild; i != null; i = i.nextSibling) {
 320     if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
 321       text += i.data;
 322     else if (i.firstChild != null)
 323       text += getText(i);
 324   }
 325   return text;
 326 }
 327
 328 function TocEntry(el, text, toclevel) {
 329   this.element = el;
 330   this.text = text;
 331   this.toclevel = toclevel;
 332 }
 333
 334 function tocEntries(el, toclevels) {
 335   var result = new Array;
 336   var re = new RegExp('[hH]([2-'+(toclevels+1)+'])');
 337   // Function that scans the DOM tree for header elements (the DOM2
 338   // nodeIterator API would be a better technique but not supported by all
 339   // browsers).
 340   var iterate = function (el) {
 341     for (var i = el.firstChild; i != null; i = i.nextSibling) {
 342       if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
 343         var mo = re.exec(i.tagName)
 344         if (mo)
 345           result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
 346         iterate(i);
 347       }
 348     }
 349   }
 350   iterate(el);
 351   return result;
 352 }
 353
 354 // This function does the work. toclevels = 1..4.
 355 function generateToc(toclevels) {
 356   var toc = document.getElementById("toc");
 357   var entries = tocEntries(document.getElementsByTagName("body")[0], toclevels);
 358   for (var i = 0; i < entries.length; ++i) {
 359     var entry = entries[i];
 360     if (entry.element.id == "")
 361       entry.element.id = "toc" + i;
 362     var a = document.createElement("a");
 363     a.href = "#" + entry.element.id;
 364     a.appendChild(document.createTextNode(entry.text));
 365     var div = document.createElement("div");
 366     div.appendChild(a);
 367     div.className = "toclevel" + entry.toclevel;
 368     toc.appendChild(div);
 369   }
 370 }
 371 /*]]>*/
 372 </script>
 373 <title>PyPlotSuite README File</title>
 374 </head>
 375 <body>
 376 <div id="header">
 377 <h1>PyPlotSuite README File</h1>
 378 <div id="toc">
 379   <div id="toctitle">Table of Contents</div>
 380   <noscript><p><b>JavaScript must be enabled in your browser to display the table of contents.</b></p></noscript>
 381 </div>
 382 </div>
 383 <div id="preamble">
 384 <div class="sectionbody">
 385 <div class="sidebarblock">
 386 <div class="sidebar-content">
 387 <div class="sidebar-title">Copyright and License</div>
 388 <p>Copyright &#169; 2006-2007 Antonino Ingargiola &lt;tritemio@gmail.com&gt;</p>
 389 <p>This program is free software; you can redistribute it and/or modify
 390 it under the terms of the GNU General Public License as published by
 391 the Free Software Foundation; either version 2 of the License, or
 392 (at your option) any later version.</p>
 393 <p>This program is distributed in the hope that it will be useful,
 394 but WITHOUT ANY WARRANTY; without even the implied warranty of
 395 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 396 GNU General Public License for more details.</p>
 397 <p>For more information read the file LICENSE.txt in the source directory.</p>
 398 </div></div>
 399 </div>
 400 </div>
 401 <h2>Project Description</h2>
 402 <div class="sectionbody">
 403 <p><strong>PyPlotSuite</strong> is a set of graphical tools to quick visualize and explore/analyze
 404 monodimentional and bidimensional data. The plot created can be saved in a
 405 variety of image formats to produce publication quality graphs.</p>
 406 <p>At the moment the project is composed by two little stand alone applications:
 407 <strong>ImageAnalyzer</strong> and <strong>Plotfile2</strong>. ImageAnalyzer is focused towards images (or any
 408 2D data, such as arrays) visualization, analysis, and measurement. Plotfile2
 409 focus is towards simple data series visualization, with the possibility to
 410 quick modify many plot characteristics. Both applications can save the result
 411 on a multitude of image file formats (png, eps, jpeg, pdf, and more).</p>
 412 <p>PyPlotSuite is written in python, using the GTK gui toolkit (through the python
 413 binding pygtk, and using Glade-2 to layout the windows). All plots are created
 414 with the great Matplotlib python 2D graphic library. Matplotlib is such a good
 415 tool that the PyPlotSuite applications are only tiny wrapper around Matplotlib
 416 functionality. Also some Numpy functionality are used both through Matplotlib
 417 (which requires Numpy) and both directly.</p>
 418 <div class="hlist"><table>
 419 <tr>
 420 <td class="hlist1">
 421 Home Page
 422 </td>
 423 <td class="hlist2">
 424 <a href="http://pyplotsuite.sourceforge.net">http://pyplotsuite.sourceforge.net</a>
 425 </td>
 426 </tr>
 427 <tr>
 428 <td class="hlist1">
 429 <strong>Latest Version</strong>
 430 </td>
 431 <td class="hlist2">
 432 0.1-alpha7
 433 </td>
 434 </tr>
 435 </table></div>
 436 </div>
 437 <h2>NEWS</h2>
 438 <div class="sectionbody">
 439 <h3>0.1-alpha8</h3>
 440 <ul>
 441 <li>
 442 <p>
 443 Added multiplatform installer using distutils.
 444 </p>
 445 </li>
 446 <li>
 447 <p>
 448 Various bug-fixes thanks to David Trémouilles' bug reports and patches (now
 449   the open dialog remebers the last dir).
 450 </p>
 451 </li>
 452 </ul>
 453 <h3>0.1-alpha7</h3>
 454 <p>Only Plotfile2 changes in this release. Various speed-up and code optimization, and the support for changing also the color for all line-plot elements.</p>
 455 <h3>0.1-alpha6</h3>
 456 <p>This is the first version of PyPlotSuite released as a single tarball. It
 457 includes both ImageAnalyzer and Plotfile2.</p>
 458 <p>A new plot property dialog in Plotfile2 allows to change many plot parameters
 459 (line style and width, marker style and size). There's also the GUI for
 460 changing the colors of the various plot elements but this functions is not
 461 implemented in the underlying code yet.</p>
 462 </div>
 463 <h2>Release Notice</h2>
 464 <div class="sectionbody">
 465 <p>Early versions of <strong>ImageAnalyzer</strong> and <strong>Plotfile2</strong> were released in separated
 466 tarballs with separated version number. Now they are released together in the
 467 same tarball with the same version number (and I plan to integrate them more).
 468 However they retain separated changelogs, so you can keep track of each
 469 application separately.</p>
 470 </div>
 471 <h2>Installation</h2>
 472 <div class="sectionbody">
 473 <p>You can decompress the archive where you want and then execute PyPloSuite in
 474 place, entering the directory and typing:</p>
 475 <div class="listingblock">
 476 <div class="content">
 477 <pre><tt>  python imageanalyzer</tt></pre>
 478 </div></div>
 479 <p>or</p>
 480 <div class="listingblock">
 481 <div class="content">
 482 <pre><tt>  python plotfile2</tt></pre>
 483 </div></div>
 484 <p>You can install PyPlotSuite system wide with this command:</p>
 485 <div class="listingblock">
 486 <div class="content">
 487 <pre><tt>  python setup.py install</tt></pre>
 488 </div></div>
 489 </div>
 490 <h2>Development Version</h2>
 491 <div class="sectionbody">
 492 <p>The development version of <strong>PyPlotSuite</strong> is hosted on a
 493 <a href="http://repo.or.cz/w/pyplotsuite.git">git repository</a>. To download the latest
 494 development version just install <a href="http://git.or.cz/">git</a>
 495 and type:</p>
 496 <div class="listingblock">
 497 <div class="content">
 498 <pre><tt>  $ git clone ssh://repo.or.cz/srv/git/pyplotsuite.git</tt></pre>
 499 </div></div>
 500 <p>Now you have a complete working tree of PyPlotSuite to test/hack on. If git
 501 and cogito does not work on your OS (I think only windows is affected) look at
 502 <a href="http://bazaar-vcs.org/">bazar</a> that is multiplatform SCM with a git plugin too.</p>
 503 </div>
 504 <h2>Requirements</h2>
 505 <div class="sectionbody">
 506 <p>You must have this software installed in order to be able to run the program:</p>
 507 <ul>
 508 <li>
 509 <p>
 510 Any recent version of Linux, Mac OSX or Windows
 511 </p>
 512 </li>
 513 <li>
 514 <p>
 515 Python 2.4 or newer (2.3 may still work, not tested):
 516     <a href="http://www.python.org">http://www.python.org</a>
 517 </p>
 518 </li>
 519 <li>
 520 <p>
 521 PyGTK 2.x:
 522     <a href="http://www.pygtk.org/">http://www.pygtk.org/</a>
 523 </p>
 524 </li>
 525 <li>
 526 <p>
 527 NumPy (1.0 or newer)
 528     <a href="http://numpy.scipy.org/">http://numpy.scipy.org/</a>
 529 </p>
 530 </li>
 531 <li>
 532 <p>
 533 MatPlotLib (0.87 or newer):
 534     <a href="http://matplotlib.sourceforge.net/">http://matplotlib.sourceforge.net/</a>
 535 </p>
 536 </li>
 537 <li>
 538 <p>
 539 SciPy (only the module scipy.ndimage.filters):
 540     <a href="http://www.scipy.org/">http://www.scipy.org/</a>
 541 </p>
 542 </li>
 543 <li>
 544 <p>
 545 Python Image Library (PIL):
 546     <a href="http://www.pythonware.com/products/pil/">http://www.pythonware.com/products/pil/</a>
 547 </p>
 548 </li>
 549 </ul>
 550 <div class="admonitionblock">
 551 <table><tr>
 552 <td class="icon">
 553 <img src="./images/icons/note.png" alt="Note" />
 554 </td>
 555 <td class="content">Typically Numpy is a prerequisite for Matplotlib, so you may have
 556 installed it in bundle with Matplotlib.</td>
 557 </tr></table>
 558 </div>
 559 <div class="admonitionblock">
 560 <table><tr>
 561 <td class="icon">
 562 <img src="./images/icons/note.png" alt="Note" />
 563 </td>
 564 <td class="content">The Scipy module and the PIL library are a requirement only if you want
 565 to run ImageAnalyzer. Plotfile2 does not requires them.</td>
 566 </tr></table>
 567 </div>
 568 </div>
 569 <h2>Image Analyzer</h2>
 570 <div class="sectionbody">
 571 <div class="hlist"><table>
 572 <tr>
 573 <td class="hlist1">
 574 Name
 575 </td>
 576 <td class="hlist2">
 577 Image Analyzer
 578 </td>
 579 </tr>
 580 <tr>
 581 <td class="hlist1">
 582 Description
 583 </td>
 584 <td class="hlist2">
 585 A tool to extract and make measures on scientific images.
 586 </td>
 587 </tr>
 588 </table></div>
 589 <h3>Description</h3>
 590 <p>ImageAnalyzer is a python[1] program written with the purpose to analyze
 591 scientific images to extract information such dimensions, and to reveal some
 592 subtle features. You can also create and save publication quality figures in a
 593 variety of hard-copy formats (using Matplotlib[5]).</p>
 594 <p>To execute the program type:</p>
 595 <div class="listingblock">
 596 <div class="content">
 597 <pre><tt>  python imageanalyzer</tt></pre>
 598 </div></div>
 599 <p>Remeber to check the software requirement above.</p>
 600 <h3>Image formats supported</h3>
 601 <p>All format supported by the PIL[6] library, with the following pixel formats:
 602 - L (Luminance, aka black&amp;white) 8 bit and 14 bit
 603 - RBG(A) with 8bit per channel</p>
 604 <h3>Features</h3>
 605 <p>The features currently implemented are:</p>
 606 <ul>
 607 <li>
 608 <p>
 609 Load, zoom and navigate on any RBG(A) or L (Luminance, aka black&amp;white)
 610       images.
 611 </p>
 612 </li>
 613 <li>
 614 <p>
 615 The possibility to choose one of the following 17 interpolation
 616       algorithms:
 617           Bessel, Bicubic, Bilinear, Blackman, Catrom, Gaussian, Hamming,
 618           Hanning, Hermite, Kaiser, Lanczos, Mitchell, Nearest, Quadric, Sinc,
 619           Spline16, Spline36.
 620       The default one is Nearest which is "no interpolation".
 621 </p>
 622 </li>
 623 <li>
 624 <p>
 625 Select one of the 14 color-maps (only for L images).
 626 </p>
 627 </li>
 628 <li>
 629 <p>
 630 Select a dynamic range either numerically and graphically through an
 631       histogram of the image (only for L images).
 632 </p>
 633 </li>
 634 <li>
 635 <p>
 636 Grid on/off, black/white (to match various color-maps).
 637 </p>
 638 </li>
 639 <li>
 640 <p>
 641 Calculate the distance between two points with the option to set the pixel
 642       dimension for the image (x and y separately).
 643 </p>
 644 </li>
 645 <li>
 646 <p>
 647 Plot the pixel-precise profile of an arbitrary number of sections of the
 648       image (only for L images).
 649 </p>
 650 </li>
 651 </ul>
 652 <h3>ImageAnalyzer TODO</h3>
 653 <p>To-do list in no particular order:</p>
 654 <ul>
 655 <li>
 656 <p>
 657 Allow to save modified images.
 658 </p>
 659 </li>
 660 <li>
 661 <p>
 662 Allow to save/load plot properties (colormap, interpolation, zoom).
 663       Handle this as explained in Plotfile2 TODO (below).
 664 </p>
 665 </li>
 666 <li>
 667 <p>
 668 Allow to choose font size for title and labels (separately).
 669 </p>
 670 </li>
 671 <li>
 672 <p>
 673 Fix axis apect ratio in histogram window.
 674 </p>
 675 </li>
 676 <li>
 677 <p>
 678 Better handling of failure on file load.
 679 </p>
 680 </li>
 681 <li>
 682 <p>
 683 Use Plotfile2 (instead of the current custom window) to show image
 684       sections.
 685 </p>
 686 </li>
 687 <li>
 688 <p>
 689 More image filtering options.
 690 </p>
 691 </li>
 692 <li>
 693 <p>
 694 Add pixel-value picker tool.
 695 </p>
 696 </li>
 697 <li>
 698 <p>
 699 Peak integration tool (2d integration on an elliptical area).
 700 </p>
 701 </li>
 702 <li>
 703 <p>
 704 Noise removal tools (dithering, noise shaping, 2D matched filter, you
 705       name it! :D)
 706 </p>
 707 </li>
 708 </ul>
 709 </div>
 710 <h2>Plotfile2</h2>
 711 <div class="sectionbody">
 712 <div class="hlist"><table>
 713 <tr>
 714 <td class="hlist1">
 715 Name
 716 </td>
 717 <td class="hlist2">
 718 Plotfile2
 719 </td>
 720 </tr>
 721 <tr>
 722 <td class="hlist1">
 723 Description
 724 </td>
 725 <td class="hlist2">
 726 A tool plot 1D data series.
 727 </td>
 728 </tr>
 729 </table></div>
 730 <h3>Description</h3>
 731 <p>Plotfile2 is is a python[1] program written with the purpose to quick plot data
 732 series stored in standard ascii text files. Multiple data series can be plotted,
 733 compared and the resulting plot can be saved in a variety of image file formats
 734 with a customizable size and resolution. This feature come particularly handy
 735 if you want to embed your plot in a document and you what size the final image
 736 will have.</p>
 737 <p>Plotfile2 is written using the GTK toolkit[2] and embeds Matplotlib[5] plot
 738 facility.</p>
 739 <p>To execute the program, enter the Plotfile2 dir and type:</p>
 740 <div class="listingblock">
 741 <div class="content">
 742 <pre><tt>  python plotfile2</tt></pre>
 743 </div></div>
 744 <p>See also the software requirements above.</p>
 745 <h3>Features</h3>
 746 <p>At the moment Plotfile2 can:</p>
 747 <ul>
 748 <li>
 749 <p>
 750 Load one or more data series from a two column (spaces or tab separated)
 751       ascii file. Blank lines (only spaces or tabs) are ignored.
 752 </p>
 753 </li>
 754 <li>
 755 <p>
 756 Detect if there is an header to automatically set axis labels. The header
 757       must be one line with two strings separated by spacing (or tabs). Blank
 758       lines before and after the header are ignored. More than two
 759       space-separated string results in an error.
 760 </p>
 761 </li>
 762 <li>
 763 <p>
 764 Controls to change the X and Y axis range, scale (linear or
 765       log) and  toggle grid.
 766 </p>
 767 </li>
 768 <li>
 769 <p>
 770 Controls to toggle if plot shows points (markers), lines or both.
 771 </p>
 772 </li>
 773 <li>
 774 <p>
 775 Complete customization of plot elements through a dedicated dialog
 776       (line style, marker type, colors, etc&#8230;).
 777 </p>
 778 </li>
 779 <li>
 780 <p>
 781 Set the plot title and axis labels
 782 </p>
 783 </li>
 784 <li>
 785 <p>
 786 Set the figure size (both in inches or in cm) and resolution (in dpi).
 787       This is useful to export a plot to be included in a document with a know
 788       size.
 789 </p>
 790 </li>
 791 <li>
 792 <p>
 793 Navigate/explore plots (zoom, un-zoom, pan, etc) thanks to the Matplotlib
 794       NavigationToolbar2 (try to click on the crossed arrows icon and then
 795       click and dragg with the right mouse button).
 796 </p>
 797 </li>
 798 <li>
 799 <p>
 800 Save the plot in a multitude of image formats (png, jpeg, eps, pdf, &#8230;
 801       all the formats supported by Matplotlib). Just click on the floppy icon.
 802 </p>
 803 </li>
 804 </ul>
 805 <h3>Plotfile2 TODO</h3>
 806 <ul>
 807 <li>
 808 <p>
 809 Possibility to customize plot line style, line color, line width, marker
 810   color, marker size, marker type for each series. <strong>[COMPLETED]</strong>
 811 </p>
 812 </li>
 813 <li>
 814 <p>
 815 Possibility to use spline interpolation (with various orders), and
 816   exponential-spline interpolation <em>[Work in progress]</em>.
 817 </p>
 818 </li>
 819 <li>
 820 <p>
 821 Add dialogs to choose an arbitrary color for plot elements in
 822   the "Plot Properties" dialog.
 823 </p>
 824 </li>
 825 <li>
 826 <p>
 827 Allow font size (and if possible) font style change for labels and title.
 828 </p>
 829 </li>
 830 <li>
 831 <p>
 832 Save plots as data (two columns ascii file or csv). This is useful for
 833   new data generated by the interpolation.
 834 </p>
 835 </li>
 836 <li>
 837 <p>
 838 Allow to save and load plot properties associated with a set of data. This
 839   would allow to load a dataset with associated plot style. To maintain the
 840   data in a compatible format this metadata will be saved in a new file with
 841   same name but different extension (f.e. ".plot"). Maybe the file should
 842   be hidden&#8230; (in the same dir of the data of course).
 843 </p>
 844 </li>
 845 <li>
 846 <p>
 847 Add basic operators (spectrum, intergrate, differentiate: which make sense?).
 848 </p>
 849 </li>
 850 <li>
 851 <p>
 852 Embed an (optional) [i]python shell.
 853 </p>
 854 </li>
 855 </ul>
 856 <h3>Plotfile2 Known Problems</h3>
 857 <ul>
 858 <li>
 859 <p>
 860 When you change figure size and resolution using the dedicated dialog, the
 861   main window may show a scrambled plot (or only an corner of the entire plot).
 862   This is only a visualization issue. Therefore, if you save the file (without
 863   resizing the window!) you will obtain the image file with the correct size
 864   and resolution ready to be included in your documents.
 865 </p>
 866 </li>
 867 </ul>
 868 <div class="admonitionblock">
 869 <table><tr>
 870 <td class="icon">
 871 <img src="./images/icons/note.png" alt="Note" />
 872 </td>
 873 <td class="content">If you have any suggestion to solve this problem please contact
 874 <a href="mailto:tritemio@gmail.com">me</a> via mail.</td>
 875 </tr></table>
 876 </div>
 877 </div>
 878 <h2>Links</h2>
 879 <div class="sectionbody">
 880 <ol>
 881 <li>
 882 <p>
 883 <strong>Python</strong>: a dynamic object-oriented programming language.
 884 </p>
 885 <ul>
 886 <li>
 887 <p>
 888 <a href="http://www.python.org">http://www.python.org</a>
 889 </p>
 890 </li>
 891 </ul>
 892 </li>
 893 <li>
 894 <p>
 895 <strong>PyGTK</strong>: Python binding for the GTK user interface library.
 896 </p>
 897 <ul>
 898 <li>
 899 <p>
 900 <a href="http://www.pygtk.org/">http://www.pygtk.org/</a>
 901 </p>
 902 </li>
 903 </ul>
 904 </li>
 905 <li>
 906 <p>
 907 <strong>Numpy</strong>: The fundamental package needed for numerical computing with Python.
 908     It is the successor (and unifier) of all the old projects (Numeric and
 909     Numarray) for python numerical computing.
 910 </p>
 911 <ul>
 912 <li>
 913 <p>
 914 <a href="http://numpy.scipy.org/">http://numpy.scipy.org/</a>
 915 </p>
 916 </li>
 917 </ul>
 918 </li>
 919 <li>
 920 <p>
 921 <strong>SciPy</strong>: Many modules that were not specific to Numpy are gathered under the
 922     broader project SciPy:
 923 </p>
 924 <ul>
 925 <li>
 926 <p>
 927 <a href="http://numpy.scipy.org/">http://numpy.scipy.org/</a>
 928 </p>
 929 </li>
 930 </ul>
 931 </li>
 932 <li>
 933 <p>
 934 <strong>MatPlotLib</strong>: A python 2D plotting library which produces publication quality
 935     figures in a variety of hard-copy formats and interactive environments
 936     across platforms.
 937 </p>
 938 <ul>
 939 <li>
 940 <p>
 941 <a href="http://matplotlib.sourceforge.net/">http://matplotlib.sourceforge.net/</a>
 942 </p>
 943 </li>
 944 </ul>
 945 </li>
 946 <li>
 947 <p>
 948 <strong>Python Imaging Library</strong> (PIL).
 949 </p>
 950 <ul>
 951 <li>
 952 <p>
 953 <a href="http://www.pythonware.com/products/pil/">http://www.pythonware.com/products/pil/</a>
 954 </p>
 955 </li>
 956 </ul>
 957 </li>
 958 </ol>
 959 <div class="sidebarblock">
 960 <div class="sidebar-content">
 961 <p>The html version of this README was generated from the ASCII file with:</p>
 962 <div class="listingblock">
 963 <div class="content">
 964 <pre><tt>$ asciidoc -a toc -a icons -a badges README</tt></pre>
 965 </div></div>
 966 </div></div>
 967 </div>
 968 <div id="footer">
 969 <div id="footer-text">
 970 Last updated 08-Jul-2007 03:18:19 CEST
 971 </div>
 972 <div id="footer-badges">
 973 <a href="http://validator.w3.org/check?uri=referer">
 974   <img style="border:none; width:88px; height:31px;"
 975        src="http://www.w3.org/Icons/valid-xhtml11"
 976        alt="Valid XHTML 1.1!" />
 977 </a>
 978 <a href="http://jigsaw.w3.org/css-validator/check/referer">
 979   <img style="border:none; width:88px; height:31px;"
 980        src="http://jigsaw.w3.org/css-validator/images/vcss"
 981        alt="Valid CSS!" />
 982 </a>
 983 <a href="http://www.mozilla.org/products/firefox/">
 984   <img style="border:none; width:110px; height:32px;"
 985        src="http://www.spreadfirefox.com/community/images/affiliates/Buttons/110x32/safer.gif"
 986        alt="Get Firefox!" />
 987 </a>
 988 </div>
 989 </div>
 990 </body>
 991 </html>