Time Data Plotter Code
Status: Beta
                
                Brought to you by:
                
                    valharis
                    
                
            | File | Date | Author | Commit | 
|---|---|---|---|
| samples | 2011-01-03 |  Martin Bickel | [6ed7bd] populating the repository | 
| .hgtags | 2011-01-03 |  Martin Bickel | [52bf18] Added tag v0.1 for changeset 33e878b52d5b | 
| COPYING | 2011-01-03 |  Martin Bickel | [33e878] Added copy of GPL | 
| readme.html | 2016-02-13 |  Martin Bickel | [350f26] cleanup imports | 
| timedataplotter | 2016-02-21 |  Martin Bickel | [94ba76] more date formats | 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<HTML>
<HEAD>
<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
<LINK REL="stylesheet" TYPE="text/css" HREF="mb.css">
<TITLE>TimeDataPlotter</TITLE>
<style type="text/css">
tt { background-color:#daecef; color:black; font-family:monospace; margin:1em; }
</style>
</HEAD>
<BODY>
<H1>TimeDataPlotter</H1>
<H2>Purpose</H2>
<p>Plotting data over time</p>
<H3>Why another plotting program?</H3>
<p>There are a lot of powerful programs out there for plotting data, for example <A href="http://www.gnuplot.info/">GnuPlot</A>, <A href="http://ploticus.sourceforge.net/">Ploticus</A> and many others.<p>
TimeDataPlotter doesn't want to compete with these, but is designed to occupy a niche that the heavyweight programs don't really fit in:
Quick and interactive displaying of data rows over a time scale.
<h3>Design goals of TimeDataPlotter</h3>
<ul>
<LI>display one or more data lines over a time scale</LI>
<li>Deliver nice results instantaneously, without the need for any kind of configuration</li>
<li>Allow for interactive zooming into the data</li>
</ul>
<h3>Cool Features</h3>
<ul>
<li>Press 'p' to export the current view as SVG, look in your current working directory for <tt>export0000.svg</tt></li>
</ul>
<H2>License</H2>
<p> <A HREF="http://www.gnu.org/licenses/gpl-2.0.html#TOC1">GNU GPL v2</a> </p>
<H2>Limitations</H2>
<ul>
<li>Doesn't scale well to large datasets. 10^4 points work nicely, 10^6 is really sluggish.</li>
<li>Zooming is only supported on the time axis</li>
<li>Currently only ISO 8601 time stamps are understood (e.g. "2016-02-13 15:32"). While it's easy to add other formats, I rather convert my data to ISO than have legacy date formats around...
</ul>
<p>Neither of these limitations are inherent, so I happily accept patches that address them :-)</p>
<H2>Getting the program</H2>
<H3>Source Tarball</H3>
<p><A href="https://sourceforge.net/projects/timedataplotter/files/">Download from Sourceforge</A></p>
<H3>Source repository</H3>
<p>Use <A HREf="http://mercurial.selenic.com/">Mercurial</A> to pull from Sourceforge: </p>
<p><TT>hg clone http://hg.code.sf.net/p/timedataplotter/code timedataplotter-code</TT></p>
<H2>Running</H2>
You need to have Python3 and the QT5 bindings for Python3 installed.
<p>Example usage is:</p>
<p><tt>./timedataplotter samples/data1 </tt></p>
<p>Assigning the data columns to different axes:</p>
<p><tt>./timedataplotter --leftaxis=1 --rightaxis=2 samples/data1 </tt></p>
<H2>Disussions</H2>
<p>Can be held at <A HREF="https://sourceforge.net/p/timedataplotter/discussion/">the forum at SourceForge</A>.</p>
</BODY>
</HTML>