Getting Started
When you first open Tracker it appears as shown below. Here's how to start analyzing a video:

For more information about Tracker's user interface, including user customization, see User Interface.
1. Open a video or tracker file
Click the Open button
or File|Open menu item and select a QuickTime video (.mov) or tracker file (.trk) to open it. Other video types can be opened as long as QuickTime can play them. You can also open image files (.jpg, .gif) or paste an image from the clipboard. For more information see Videos.
2. Identify the frames ("video clip") you wish to analyze
Display the clip settings by clicking the Clip Settings button at the right end of the player as shown.

In the Clip Settings dialog, set the Start and End frames to define the range you wish to analyze. You can drag the player's slider to scan through the video and quickly find the frames of interest. If the video contains too many frames to analyze (more than 20 or so can become tedious), increase the Step Size to automatically skip frames. For more information see Setting video clip properties.

Click the Tape Measure button
to show the tape measure.
Drag the two ends of the tape to positions that are a known world distance apart (for example, the ends of a meter stick or other object with known dimensions in the video image). Then double-click the tape readout and enter the known distance. For more information see Tape Measure, or for an alternate way to calibrate the video consider a Calibration Point Pair.



4. Set the reference frame origin and angle
Click the Axes button
to show the coordinate axes. Drag the origin and/or x-axis to set the reference frame origin and angle. A common choice for the origin is the initial position of an object of interest. For more information see Axes, or for alternate ways to set the origin and/or angle consider a Calibration Point Pair or an Offset Origin.


The video scale and reference frame origin and angle uniquely define the coordinate system used to convert pixel image positions to scaled world positions. In some videos the coordinate system properties may vary from one frame to the next (e.g., if the camera is zoomed the scale will change, or if panned the origin will change). Tracker makes it easy to handle such videos--see Coordinate System for more information.
5. Track objects of interest with the mouse.
Click the Track Control button
to show the track control. Then click the New button and choose a track type from the menu of choices. Most moving objects are tracked using Point Mass tracks.

Mark the position of the object at every frame by holding down the shift key and clicking the mouse (crosshair cursor) as the video automatically steps through the video clip. Don't skip frames--if you do, velocities and accelerations cannot be determined.
You can always adjust a marked position by dragging it with the mouse or selecting it and nudging with the arrow keys. Right-click the video to zoom in for sub-pixel accuracy.

You can change the name and appearance of a track by clicking its button on the track control and choosing from the popup menu. Other track control buttons let you show or hide trails, labels, velocity vectors and acceleration vectors.
For more information on tracks and the track control, see Tracks. For detailed information on a specific track type, see Point Mass, Center of Mass, Vector, Vector Sum, Offset Origin, Calibration Point Pair, Line Profile, Analytic Particle Model or Dynamic Particle Model.
6. Plot and analyze the tracks
The Plot View displays graphs of track data. Click the x- or y-axis label to change the variable plotted on that axis. To plot multiple graphs, click the Plots button and select the desired number. Right-click on a plot to access display and analysis options in a popup menu.

Two of the most powerful analysis options available from the popup menu are Data Columns... and Analyze.... The Data Columns item displays a DataFunction Tool with which you can define custom variables for plots and datatables. Custom variables can be virtually any function of built-in and previously defined custom variables. The Analyze item displays a Dataset Tool with statistics, curve-fitting and other analysis capabilities. For more information see Plot View.


7. Save your work in a tracker (.trk) file
Click the Save button
or File|Save As... menu item to save your work in an XML-based tracker file with the extension ".trk". When a saved tracker file is opened, Tracker loads the video, sets the clip and coordinate system properties, and recreates all tracks, custom variables and views. For more information see XML Data Files.
8. Export track data to a spreadsheet
Tracker's Datatable View displays track data in a table. To change the variables included in the table, click the Data button and select from the list displayed.
Data can be easily exported from the datatable by copying to the clipboard and pasting into a spreadsheet or other application. To copy, select the desired data in the table, then right-click and choose Copy Data from the popup menu. For more information see Datatable View.


9. Print or copy/paste images for reports
You can print or copy an image of the entire Tracker frame or any individual view (e.g., a plot or datatable). To print the entire frame (all visible views), choose the File|Print Frame... menu item. To print an individual view, right-click the view and choose Print... from the popup menu. To copy an image, choose the desired view from the Edit|Copy Image menu or right-click a view and choose Copy Image. Pasting printed or copied images into notes and reports is an excellent way to document your video analysis results.
