TrackItVersion 2.0(Shareware-$20 US; $25 Canadian)November 3, 1997Written by Peter Mitchellcopyright 1996,1997 Mitchell System DesignsAll Rights ReservedThis release runs on Newton OS2.x only.WARNING: TrackIt 1.x data will be automatically converted to TrackIt 2.x format the first time TrackIt 2.x is run. There is also a price change for the new version and it requires a different registration code. It is possible to delete TrackIt version 2 and re-install TrackIt 1.x without a problem accessing your data. But if you were to do this, add new data with a 1.x version, and then re-install TrackIt 2.x, the data will not be updated a second time which will lead to problems.WARNING: If you have used the "load" feature from another application into TrackIt then you need to make a change for the new format. See the details below for the format.This document, as well as some screen shots and a link to download the latest version, can be accessed on the Web at .New - Added two new chart types, so now you can switch between line, bar, or scatter graph - Added multi-user classroom support for the eMate - Added ability to select a subset of points on which you can: - delete the selection - graph the selection - copy the selection to a new graph set - move the selection to a new graph set - Added more support for the keyboard; ie, Cmd-N for a new set, Cmd-D for new datum - Added resizable columns to the data area - Added ability to print - Revelar Connection Utility support - An application called Data Mover is included for moving TrackIt data around(see the release history below for other minor changes)Contents What is TrackIt? Loading a data set from another application Revelar Connection Utility Support How to Pay Contact Addresses Comments/Bug reports Problems Distribution Disclaimer Release HistoryWhat is TrackIt?Use TrackIt to record and graph any set of numbers. The data set can be time based or just a sequential set of numbers. If the data set is time based the X axis will graph the points spaced to reflect the time between points. Two types of time based sets are possible, either points that the scale reflects a time scale by days or points that have a time scale of minutes and seconds. These graphs can be displayed as a line, bar, or scatter graph and are scalable in the x direction.TrackIt supports the multi-user classroom mode so students data is kept private.This release contains the following:TrackIt2.pkg - The main program.ReadMe-TrackIt - This file you are reading.TI Documentation.pdf - An Adobe PDF format document containing documentation.for RCU ADF folder - A folder containing a file called TrackIt.adf that can be used with RCU.Mac Register Prog for TrackIt - A folder containing the Register program by Peter Lewis that can be run on a Macintosh to register TrackIt through the Kagi Shareware registration service.Newt Register Prog for TrackIt - A folder containing the Newton Register program and release documents by Flash Sheridan that can be run on your Newton device to register TrackIt through the Kagi Shareware registration service.Loading a data set from another applicationThis version of the program allows you to load a set of data to be graphed from another application. The data is loaded into TrackIt's soup and TrackIt will still need to be opened to view the graph. (If you would rather not be moving data into a soup like this and would prefer to just display a graph and discard the data, contact me about it. I am planning to offer a small app that will just provide the graphing portion and that could be opened and displayed from any application.)To use the current "load" feature in TrackIt add a line similar to the following to your application: GetRoot().|TrackIt:MSDA|:LoadGraph(,<x-axis label>,<min>,<max>,<type>,<chart>,<data>);where, <title> is a string used to label the Y-axis and is title for the graph <x-axis label> is a string used to label the X-axis <min> can be passed as a number or nil, if nil is passed the min value will be set during load <max> can be passed as a number or nil, if nil is passed the max value will be set during load <type> is a symbol and should be either 'dateType, 'timeType or 'evenType <chart> is a symbol and should be either 'line, 'bar, or 'scatter <data> is an array of 2 element arrays which hold the x,y valuesNote that if you are using date values in the x position the value in the x position in the array should be the integer representation for the date, not a string.An example: aDataArr := [[1,4],[2,7],[3,-5],[4,0],[5,-3],[6,3]]; GetRoot().|TrackIt:MSDA|:LoadGraph("My test values","Values",nil,nil,'evenType,'bar,aDataArr); Revelar Connection Utility SupportIf you use Revelar Connection Utility (RCU) there is a file called TrackIt.adf that you can put into the RCU ADF folder. This will allow you to access TrackIt data through RCU and could provide a way to export the data to a desktop computer.Note: There are three values from a graph set header entry that currently will not display in RCU. They are values indicating; X scale type (whether it's date based, time based, or sequentially based), grid status (whether the grid is on or off), and graph type (whether the graph is a line, bar or scatter graph).Note: Also note that date and time based graph sets display the date or time as an integer, not as a date string. These represent the number of minutes since Jan. 1, 1904 or the number of seconds since Jan. 1, 1993 respectively.How to PayThis version of the program, unregistered, is limited to adding 2 data sets. It can be used without any other restrictions, there is no limit put on the number of points that can be added to a data set. This should allow for enough use to decide if the program fits your needs and you want to pay the registration fee, or it allows for very basic use if you want to use it but not pay the registration.If you like the program, and want to remove the limit, please pay the requested fee and I will send you a registration number that will remove this restriction. ($20 US; $25 Canadian)Payments can be sent directly to me by cheque (in US or Canadian funds) to the address listed in the next section, or through Kagi Shareware by cheque or credit card using e-mail or snail mail. To register through Kagi Shareware, follow the instructions for the Newton, Macintosh or PC registration program you decide to use.Or, register on-line through Kagi at the following address:<http://kagi.direct.net/cgi-bin/register1.cgi?PB>Contact AddressesE-mail: <PMitchell@kagi.com> or <PMitchell@ccinet.ab.ca>orPeter MitchellMitchell System Designs9558 - 83 St.Edmonton, Alberta, Canada, T6C 3A1Comments/Bug reportsI'd like to hear from you if you have any comments, suggestions or bug reports. You can contact me by e-mail or snail mail through one of the addresses listed above.ProblemsIf all the points are within a time frame of a minute or two, the scale of the graph is still too small to show all the detail. If this is required to have a lot of points added within seconds, I can add a flag to change the scale for points based on seconds or add another graph type.If the minimum threshold is set to the same value as the lowest value in your data set and you choose to use a bar graph or scatter graph then the lowest value will not be visible in the graph. Use the "Settings" button to change the minimum value to at least 2 less than the current minimum.DistributionThis application is Shareware. You may use and distribute copies of this application as long as this documentation is included as is, the application is not altered in any way, and you don't charge for it.Future PlansAdding the ability to have more than one data set on a graph.I will look at all requests that I receive, although I will not guarantee that all of these will be implemented.DisclaimerThis application comes as is with no warranty, use at your own risk.Release Historyv2.0 (November 3, 1997)- Added two new chart types, so now you can switch between line, bar, or scatter graph- Added ability to select a subset of points on which you can: - delete the selection - graph the selection - copy the selection to a new graph set - move the selection to a new graph set- Added more support for the keyboard; ie, Cmd-N for a new set, Cmd-D for new datum- Added multi-user classroom support for the eMate- Added ability to print- Revelar Connection Utility support- Changed registration fee to $20 US/$25 Canadian- Changed address, I moved up the street- Changed how the minimum value was set so it is now set to 2 below the lowest value. This helps to ensure all data points are visible on the graph if using the bar or scatter chart option.- Added a select button to be able to quickly select a range of points- Added resizable columns to the data area- Changed load graph function for new format- An application called Data Mover is included for moving TrackIt data aroundv1.3 (March 7, 1997)- Added a third graph type for graphing time based points (separated by minutes/seconds)- Added ability to delete multiple entire sets- Made changes that should improve performance on larger data sets- Added new scrolling controls for moving through the data list view- Changed so that the state of the grid is saved for each data set- Added a display of the number of data pointsv1.2 (January 2, 1997)-Added an update to the graph after changing any settings-Added the ability to "load" a data set for graphing from another application-Added ability to enter multiple data points-Added option to be able to have graph updated/not updated between each point added-Added grid lines that can be shown/hidden and can be sized as desired-Added display of the average for all values in the graphv1.1 (October 29, 1996)-Fixed a bug that resulted in sequence number not being saved properly-Fixed so that the Max and Min values on the graph are set on first data point entered-Changed so the last x scale setting is saved with the graph, each graph can have diff. setting-Fixed bug that resulted in settings not being saved when overview button tapped-Added a "Settings" button to allow change to graph labels and Min/Max values-Reduced heap requirements after closing the applicationv1.0 (October 1996)Initial release