> For the complete documentation index, see [llms.txt](https://docs.freeflysystems.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.freeflysystems.com/products/products/ember-camera/ember-scientific-toolbox-app/tracking-tool.md).
# Tracking Tool
The tracking tool allows an object to be tracked with its position, velocity and acceleration charted and logged.
To start tracking select the **Track** tool and check **Enable**. Scrub or play to the time in the clip where tracking should begin and stop playback. Press **Set ROI** and use the mouse or touchpad to drag the tracking rectangle over the object to be tracked (the Region of Interest or ROI). Place the mouse cursor in the middle of the rectangle to drag the entire ROI or drag the edges or corners to resize the ROI. Press **Set ROI** again and the rectangle should turn solid yellow to indicate that tracking is now active. Note that when resizing the ROI the rectangle will snap to a specific size due to certain internal constraints in the tracking algorithm.
Press **Play** and the yellow ROI rectangle should follow the object being tracked. Let the clip play for the desired tracking duration and then stop the clip. Note that tracking can be disrupted by background clutter. High contrast objects work best.
To restart tracking from the same origin point, press **Return to start**. The clip will rewind to where tracking was initiated and the ROI will be reset.
The tracking history between where the ROI was set and the point where the clip is stopped is logged, and the clip can be freely scrubbed between these two points. Scrubbing outside these points is blocked while tracking is enabled. In order to extend tracking beyond the previous stop point just start the clip playing again. If it is desired to start tracking earlier in the clip than when the ROI was defined press **Set ROI** to unlock the scrubbing range and scrub to the new start point, repositioning the ROI as well if desired. Press **Set ROI** again to return to tracking mode.
Charts for position, velocity and acceleration can be enabled by selecting the appropriate checkbox. Scaling for each chart can be adjusted using the relevant **Scale** sliders, with the steppers adjacent to the slider providing a 103 coarse adjustment. Alternatively autoscaling can be enabled for all charts by checking **Autoscale.** The chart span can be adjusted by dragging the **Span** slider.
If calibration has been applied using the procedure in the [Measure Tool](/products/products/ember-camera/ember-scientific-toolbox-app/measure-tool.md) then real world units can be selected in the **Units** pulldown.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.freeflysystems.com/products/products/ember-camera/ember-scientific-toolbox-app/tracking-tool.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.