Menu ▾ ▴

Tree [94ba76] default tip /
 History

Read Only access

File Date Author Commit
 samples 2011-01-03 Martin Bickel Martin Bickel [6ed7bd] populating the repository
 .hgtags 2011-01-03 Martin Bickel Martin Bickel [52bf18] Added tag v0.1 for changeset 33e878b52d5b
 COPYING 2011-01-03 Martin Bickel Martin Bickel [33e878] Added copy of GPL
 readme.html 2016-02-13 Martin Bickel Martin Bickel [350f26] cleanup imports
 timedataplotter 2016-02-21 Martin Bickel Martin Bickel [94ba76] more date formats

Read Me

<!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>