# Compatibility & Limitations
### Example Equipment:
### Does **NOT**** f**unction: Flat putting mats with no return track
### Compatible Options - Ramp and return track
Equipment - Putting mats with a ramp and return track
* Common form factor, various length and quality of mat, material of the ramp or track.
* Unlikely to change for many years to come
## Examples of operation:
{% embed url="" %}
## How it works:
#### Return Track Indicates Either Miss - Catch or Make conditions.
The **PUTTING MAT ROI** is used to define the area between the **RAMP ROI** and the camera.
* Best practice is to extend the region a couple of inches beyond the actual mat in case the ball is rolling off the ramp sideways.
* A **MISS - RETURN** occurs when a ball passes from the **RAMP ROI** back into the **PUTTING MAT ROI**
* **MISS - RETURN** classification includes **RAMP entry ROI** & **RAMP exit ROI**
* The center of the ball rolling off the matt could trigger a **MISS - TIMEOUT**
* A **QUICK PUTT** is classified as a **MISS.**
* It is triggered by the presence of a ball detected in the **LEFT OF PUTTING MAT ROI** before a ball has either reached the **PUTTING MAT ROI** or **RETURN TRACK ROI**
* A **TIMEOUT** is classified as a **MISS**, and is triggered by a ball not being detected in either the **RETURN TRACK ROI** or **PUTTING MAT ROI** in 3 seconds.
* The ball has rolled off the putting mat entirely or gotten stuck inside the ramp
The **CATCH ROI** is an out of bounds area beyond the hole or around it, which funnels the ball through a tunnel under the **RAMP ROI**, releasing into the **RETURN TRACK ROI**.
* At the time of a ball being detected in the return track, it is classified as a **MISS - CATCH**, regardless if the ball falls backwards into the hole.
* Else, if the ball did not enter the **CATCH ROI**, it is a **MAKE** and the whole quadrant in which the ball passes into the **HOLE ROI** is recorded.
* MAKES classification includes Hole quadrant and **RAMP entry ROI**
* It is important to consider the direction of putts when submitting coordinates for the **RAMP ROI:** Top left first, then top right, bottom right, and bottom left last.
* These inform the orientation of the hole quadrants: **LOW, LEFT, TOP, RIGHT**
* They also calculate SUB-ROI segments for the **RAMP ROI: LEFT, CENTER, RIGHT**
* The IGNORE ROI is the area where the return track extends and the surrounding area.
* This prevents tracking issues when multiple balls are on the screen at a time
## Example Equipment:
### Does **NOT**** f**unction: Flat putting mats with no return track
### Compatible Options - Ramp and return track
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.proofofputt.com/compatibility-and-limitations.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.