StatGrapher Help

Version 0.7 beta - 23 Aug 2002

Table of Contents

  1. What is StatGrapher?
  2. Creating Categories
  3. Making Entries
  4. Reviewing Entries
  5. Plotting a Graph
  6. Viewing Graphs
  7. Exporting Data
  8. The Authors
  9. The License

What is StatGrapher?

StatGraph is an application that records numeric values and stores them in categories. It provides the means to graph the values for a particular category over time, and to export the data to common formats.

The program is ideal for anyone who wants to visually track the numeric values that are a part of their life. Golfers can track their score. Diabetics their blood glucose. Track body weight, blood pressure, temperature, auto mileage, sit-ups, pull-ups, hours of sleep. You get the idea.

[Back to Top]

Creating Categories

The first step is to create a category on the Categories tab. Tap the (+) icon and provide the details requested. Categories must, minimally, have a name and value label. Low and high values, and timeframe if specified, will be used as indicators during graphing.

Category definitions may be changed later by selecting the category and tapping the (pencil) icon. Delete a category and all of its stored data with the (trash) icon.

[Back to Top]

Making Entries

To record entries, switch to the Entries tab, then to New Entry. Specify the category that this entry is for, and enter the value in the combo box. You can use the on-screen keypad to enter numbers and the decimal point. the (+/-) will invert the number. The combo box stores the last 10 entered numbers.

If this value is to be marked as "special" or "different" from what you would consider a "normal" value, then check the Exception box. You can graph normal values separately from exceptions, or all of them together.

If you want to attach notes to this entry, tap the Notes tab and enter your notes in the field. The icons can be used to Cut, Copy or Paste text to or from the clipboard. Return to the New Entry tab to save your entry and notes.

Entries are saved with the current date and time.

[Back to Top]

Reviewing Entries

Currently stored entries can be viewed on the Review tab. Select a category and the entries are displayed in the table below. You can sort based on any of the column titles by tapping on the desired title. The 'X' column will contain an 'X' if the entry is an exception. The 'N' column will contain an 'N' if there are notes associated with the entry.

You can view the notes for an entry by first selecting it, then tapping the Notes tab.

Edit an entry with the (pencil) icon. Delete an entry with the (trash) icon.

[Back to Top]

Plotting a Graph

To turn data into a graph, visit the Categories tab and select the category you wish to graph. Tap the (graph) icon and specify the range of data to be included in the graph including the start date, start time, end date, end time, and whether to show all data, normal only or exceptions only.

You can also specify the minimum and maximum values you want included on your graph. After submitting these parameters, the graph is displayed on the Graphs tab.

[Back to Top]

Viewing Graphs

Graphs will typically be wider than your screen. For this reason there is a scroll bar provided to allow you to scroll or pan through the graph left-to-right.

When a graph is drawn for the first time, it is not saved. To save the parameters that were used to create this graph tap the (save) icon and provide the graph's name and optionally some notes.

To view a previously saved graph, select the graph name from the drop-down menu. If a graph has notes, they can be viewed with the (notes) icon. Saved graphs can be deleted by tapping the (trash) icon.

By default, graphs are drawn with 10 pixels of space between each horizontal gridline, and 20 pixels of space between each plotted point. This called scale 1. Decreasing the scale will reduce the horizontal space between plotted points. Increasing the scale will cause more space to be added.

[Back to Top]

Exporting Data

To use your data in another program, activate the Categories tab and select the category you wish to export. Tap the (export) icon and specify the file format for the data. Next, specify the name of the file, and its location.

[Back to Top]

The Authors

Concept and Design: Darien Kruss
http://zaurus.kruss.com/

Programming: Erik Davidson
http://zaurus.erikd.org/

[Back to Top]

The License

StatGrapher, stores numeric data collected over time and graphs the results.

This program is Copyright (C) 2002 by Team Zaurus Geek, a collaboration between Darien Kruss <darien@kruss.com> and Erik Davidson <erik@erikd.org>.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

[Back to Top]