Help
Table
Operators
Tutorial: multiple records
Functions panel 1 (files, layout)
Functions panel 2 (time calculation)
Functions panel 3 (trigonometry)
Miscellaneous (preferences, serial port, import / export...)
The easiest way to get started is the "quicktour" from the help menu of the program.
Shows a large display of the running count.
Precision.
Minimal measurable duration: ca. 100 ms (depending on your machine).
Slow or busy machines may cause a switch delay of up to 10 ms.
The serial port access has additional delays: 1, 10 and 50 ms at precision of 1, 10 and 100 ms.
Between start and stop the program uses the hardware timer of your machine.
Shortcuts: Ctrl + 1, Ctrl + 2, Ctrl + 3.
Be aware that computers might be less precise than you believe, and use the "Calibrate" tool from the "Options" menu, especially if you compare results from different computers.
If you need absolutely perfect results for long durations, you should rely on special hardware devices rather than a Windows computer.
Start and Stop Button. Shortcut: F1.
Interim value. Also starts the timer if not already running. Shortcut: F2.
Reset of timer values. Writes the "total time" value at the end of the table (if not disabled). Shortcut: F3.
Return. Appends a blank row. Timer values are not inserted here. Shortcut: F4.
Absolute / relative. Applied to interim values which count either from start time (absolute) or from the last interim value.
Time display.
1. Offset: waits the entered time before starting. If switched to "threshold", starts immediately, but skips the count if a stop signal comes in during the entered time.
2. Current time: the actually running count.
3. Total time: permanently updated sum of all times together since program start or klicking "reset".
Table
Table and clear buttons.
Columns:
- Numbers (editable, semi-automatic). To show and fix an index display and scroll ramp, klick the column header (shortcut: Ctrl. + I)
- Time values. Counted values normally are inserted after the last value found in this column. Also accepts floating-point numbers.
- Operator column.
- Results or custom Items. "Lock Items" prevents to clear this column, even if you create a new file.
Index display.It appears when the cursor moves over the column header and can be fixed by clicking the header. It can be used to apply selection operators by clicking a row while Shift, Control or both keys are pressed. Two scroll ramps are shown at top and bottom.
Shortcut: Ctrl + I.
Multiple records
1) starting together, but stopping one after the other, where the stop range might be not predictable.
Press "Start" when all are starting and press "interim" for each stop time. Enter the items as soon as possible.
2) starting and stopping one after the other, perhaps knowing the start range, but likely not the stop range.
If you already know the start range, enter the items into the table before. If the first item is not in the first row, enter "<" into the operator column of this row to make the first stop value appear there.
Press "Start" before and "interim" for each start time.
After the last has been started, it's best to create an empty row using the "Return" key or button. Stop each with "interim" and enter the items as soon as possible to avoid confusion.
After all, subtract each start time from its corresponding stop time to get the results.
3) starting one after the other and stopping all together.
This is quite similar to 2), where the difference is that every start value becomes subtracted from the same stop value.
Functions panel 1
Initializes a new, untiteled file without resetting the timer.
Shortcut: Ctrl + N.
Opens an existing file without resetting the timer.
Shortcut: Ctrl + O.
Saves the open file without resetting the timer.
The diode indicates wether changes have been made.
Shortcut: Ctrl + S.
Saves the open file in a different path without resetting the timer.
Opens the data logging dialog. The diode appears if automatic logging is enabled.
Data logging dialog window.
The first option manually cuts off the specified amount of rows from top. A file dialog asks where to store the data. The data is appended to an existing or new file.
The second option allows to let the program decide when to cut off the specified amount of rows.
The subordinate options prevent the file to increase in an uncontrolled way (25 KB = ca. 1000 rows of time values only). The following opened file dialog proposes a filename consisting of a timestamp and an appendix. It is recommended only to edit the appendix. You may also select an existing file.
All options are set to default everytime you start the program.
To disable auto logging, deselect both main options.
Saves a copy of the entire table -- or, if you made a selection, the selected data -- to the end of an existing or to a new file. There are no changes made to the open file or to the timer.
Saves the entire table to "_backup.txt" in the program directory. To backup in a custom directory, use the "append" function.
Automatic backups can be enabled in the preferences dialog. They are saved to "_backup_auto.txt".
Displays or hides the graph.
Graph. Contains all data or the data of a selection. The enumeration is independent from that of the table.
For zooming edit the scale values.
Shortcut: Ctrl + G.
Enables / disables the automatic correction of time values within the time column. The correction is applied as soon as the text cursor is set to another cell, either by clicking somewhere or pressing the return key.
You can (mis)use this function to quickly convert values consisting of units that do not fit the time format. For instance, you could enter ",,900" which means 0 hours, 0 minutes, 900 seconds and 0 milliseconds and which is converted automatically to
If you use floating-point or integer numbers, and you do not everytime want to disable the function, append an "f" to the number (e.g. "8274f") which means that the number is now protected against automatic conversion.
Sorts one selection using the number column. Select y...x to sort in descending order.
Sorts one selection using the time column. Select y...x to sort in descending order.
Sorts one selection using the item column. Select y...x to sort in descending order.
Adds that number of rows which you entered in the operator column. The new rows are inserted before.
Deletes a selection.
Moves a selection to a target marked by a "z" (default). The rows are inserted before.
Copies a selection to a target marked by a "z" (default). The rows are inserted before.
Inserts date and time at the end of the table or at a row marked by "x" (default).
Shortcut: Ctrl + T.
Refreshes a selection of the number column. Option "1.." counts from 1, option "n.." counts from the number in the first selected row. Option
Functions panel 2
Converts floating-point or integer values into time format and reverse. For operators see the table section of this helpfile.
Adds the values of a selection together. All values must be in the same format (either floating-point or time).
The result is inserted in the item column on the right of the last selected value.
Shortcut: Ctrl + "+".
Subtracts values marked by "y" (default) from a value marked by "x" (default). Requires all values to be in the same format. The result is inserted on the right of value "x".
Shortcut: Ctrl + "-".
Multiplicates two values marked by "x" (default) and "y" (default). A time value cannot be multiplicated by a time value. The result is inserted on the right of value "x".
Shortcut: Ctrl + "*".
Divides a value marked by "x" (default) by a value marked by "y" (default). You cannot divide a number by a time value. The result is inserted on the right of value "x".
Shortcut: Ctrl + "/".
Calculates the average of a selection. Requires all values to be in the same format. Empty values are ignored. The result is inserted on the right of the last selected value.
Calculates the maximal common divisor of a selection. Empty values are ignored. Requires all values to be positive and in the same format (either time or integer). The result is inserted on the right of the last selected value.
Opens the dialog for the minimal common multiple.
Dialog for the minimal common multiple of a selection. Empty values are ignored. Requires all values to be positive and in the same format (either time or integer). The result is inserted on the right of the last selected value.
If you enter a maximal deviation, a more complicated (and much slower) algorithm is used. The calculation stops as soon as multiples of all values match with a deviation which is less than or equal to the entered value.
The calculation stops at the entered limit, and, in this case, displays an error. (0 means no limit, regardless of the upper system limit). A limit is not useful if you do not enter a deviaton.
Searches for the minimum of the entire time column or of a selection.
Searches for the maximum of the entire time column or of a selection.
Applies a specified increment or decrement to a selection. A practical purpose is to count events using the serial port. You can enter an offset or threshold (try out the difference).
Shortcuts: F12 / F11.
Functions panel 3
Sets the degree or radians mode. Alternatively you could append "d" or "r" to a number (the button then changes after the calculation). Time values are always interpreted as degree.
Converts a degree value (time format or floating-point) marked by "x" (default) to radians, and converts a radians value to degree (floating-point).
Miscellaneous
Sets the number of undo steps. It is recommended to keep the automatic adaption enabled.
Preferences dialog.
Automatic backups are saved to "_backup_auto.txt" in the program directory.
You can minimize the risk of unnoticed rounding errors by decreasing the limit. Klick "generate limit" to find a limit that is likely to prevent errors at integers and time values (the program searches for the highest errorless power of 10 and divides this number by 100). Clear the number of digits that you urgently need after the decimal point.
Serial port settings dialog.
This feature requires a VISA runtime engine to be installed.
Some computers, especially notebooks, do not have a serial port input. The socket must exactly look like this:
If your machine has one, all you need is a soldering iron, a 9 pin plug and a cable with up to 6 cores, depending on what you plan to do. For connection details see the help page of the dialog. If you scan flickering signals, set a threshold value to filter out short intervals (click "offset" in the main program to switch to "threshold").
Export / Import dialog (The import dialog looks slightly different).
Exports all data or selected rows using a specified format. The filetypes txt, csv and xls save the data as simple tabulator separated spreadsheet data. The sql filetype creates a MySQL dump file containing "CREATE TABLE" and "INSERT INTO" statements.
The import function does not support the xls type (you should then export the file from Excel as txt-file).
Html export dialog.
Exports all data or selected rows to a html file. Disable "convert special characters" if you want to use html code. Characters like é, â, ä and so on are always converted.
The "edit graph" button opens a dialog where you can zoom into the graph by editing the scale values. Color changes made afterwards are not applied to the graph.
Checks the entire time column for format errors. This is useful if you open files which have been saved with different separators. Be careful with the "replace all" function if the time column also contains floating-point numbers and integers, because they all would be converted to hours.
Opens a print preview of the entire or selected data. Make a test printout of a page and decrease the "rows per page" value if rows are lost at the lower margin.
If you want to edit graph scale values, use the "export to html" function and print from your browser. If you want the lowest scale value not to be zero but the minimal measured value, ensure that the selection does not contain empty values.
Shortcut: Ctrl + P.
Opens a dialog to execute up to three stored system commands. Klick "browse" to select first a program, and press again to select a file, or enter a command manually. To execute a command with options, use a .bat-file.
Metronome. This is a separate module which you must start from the program directory (start "metron.exe").
In the upper section you can set the beats per minute and a predefined or custom rhythm. On the left and right there are light diodes. The metronome must be switched on for running.
The middle section allows to record impulses you give by pressing the "rec" button or F12. The measured beats per minute are applied to the metronome setting. The option "single klicks" records the time difference to the previous click. If you use the option "average of 5 values", you must click at mindest six times to get a proper result.
In the lower section you can edit some sound settings, dependig on your system platform. The "tick.wav" files in the program directory are used only on windows platforms. Other platforms use internal sound data.
The sound output may hang a short time if your computer is very busy.
Waker. This is a separate module which you must start from the program directory (start "waker.exe").
Klick the pointer and move it to the right to that time which you want to wait. To set hours make additional turns.
An alarm window appears when the time is over.