Add Distance Measurement Block

[ediardo]

Description

Measure the distance between two bounding boxes on a 2D plane using a camera positioned perpendicular to the plane. This method requires footage from this specific perspective, along with either a reference object of known dimensions placed in the same plane as the bounding boxes or a pixel-to-centimeter ratio that defines how many pixels correspond to one centimeter.

Key features include:

• Distance Calculation: Compute the distance or gap between two bounding boxes using their closest edges for measurement.
• Calibration via Pixel to centimeter & Reference Object:
  • Calibrate the pixel to centimeter ratio by using either a known “pixel-ratio”
  • Use a reference object with known dimensions (width and height) to approximate scale distances.
• Measurement Outputs: Obtain the distance between bounding boxes in both centimeters and pixels, providing flexibility for various use cases.

Type of change

Please delete options that are not relevant.

• New feature (non-breaking change which adds functionality)

How has this change been tested, please provide a testcase or example of how you tested the change?

Created 10 unit tests to check various scenario, including different calibration methods, empty required inputs, incorrect value formats, and overlapping bounding boxes.

Docs

N/A

[PawelPeczek-Roboflow]

I find this if statement hard to understand - especially the latter part.
The root source of my confusion is the choice to measure distance along single dimension - why not to calculate distance in 2D?

[ediardo]

I understand the confusion.

The goal is to measure the distance or gap between the closest edges of two bounding boxes on a 2D plane.

I'm adding an illustration to clarify this further:

• has_overlap: check if bboxes overlap.
• has_axis_overlap: check if there isn't a vertical or horizontal gap between the bboxes.

[PawelPeczek-Roboflow]

Also - for future contributions - could you use direct pushes to the repository to make CI run smoothly?

[ediardo]

Hey @PawelPeczek-Roboflow , thanks for reviewing my PR. I will address more requests tomorrow.

[ediardo]

Also - for future contributions - could you use direct pushes to the repository to make CI run smoothly?

Now that I have access, future contributions will be made this way. thanks!

[PawelPeczek-Roboflow]

@ediardo I have concerns that this block may not be easy to adopt by clients and may produce errors - for instance when model do not provide reference object.

I do understand that the block solves a particular issue for the client, hence I am going to approve it, but in case of any future problems you will be in charge of solving them.