feat: in_range filtering

[vgilabert94]

Changes

Following cv2.inRange OpenCV function, I've implemented a pytorch version for batched images.
The function needs the image, and two bounds for filtering (lower and upper).
There is the possibility to add a parameter (return_mask) to return the mask and otherwise the filtered image.

Code to get image:

BASE_IMAGE_URL = "https://raw.githubusercontent.com/kornia/data/main/panda.jpg"
dev = 'cpu'
img = read_img_from_url(BASE_IMAGE_URL, (256, 256))
img_hsv = K.color.rgb_to_hsv(img)
h, s, v = torch.split(img_hsv, split_size_or_sections=1, dim=1)
h = h / (2*torch.pi)
img_hsv = torch.cat((h, s, v), dim=1)
img_hsv = img_hsv.to(dev)
img = img.to(dev)
lower = (0.314, 0.2, 0.2)
upper = (0.47, 1.0, 1.0)
lower = torch.tensor(lower).reshape(1,3,1,1)
upper = torch.tensor(upper).reshape(1,3,1,1)
mask = in_range(img_hsv, lower, upper)
out = img * mask

Type of change

• 📚 Documentation Update
• 🧪 Tests Cases
• 🐞 Bug fix (non-breaking change which fixes an issue)
• 🔬 New feature (non-breaking change which adds functionality)
• 🚨 Breaking change (fix or feature that would cause existing functionality to not work as expected)
• 📝 This change requires a documentation update

Checklist

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• Did you update CHANGELOG in case of a major change?

[johnnv1]

nice patch. lgtm, only needs the green lights on CI

[vgilabert94]

nice patch. lgtm, only needs the green lights on CI

I need help to solve this errors. I don't know how to debug properly without doing commit and push every time.

[johnnv1]

nice patch. lgtm, only needs the green lights on CI

I need help to solve this errors. I don't know how to debug properly without doing commit and push every time.

if it's some doc issue, you can check with make build-doc or make doctest... for testing falling cross OS, I would go with commit and push too

[johnnv1]

@vgilabert94 could you rebase this one? i removed the CI with the issue

[edgarriba]

@vgilabert94 i guess something is missing with the docstring format -- i suggest to run make build-docs and make doctest

[vgilabert94]

@vgilabert94 i guess something is missing with the docstring format -- i suggest to run make build-docs and make doctest

make doctest OK
make build-docs can't run in local. I'm on windows:

PS C:\Users\LENOVO\REPOSITORIOS\kornia> make build-docs 
cd docs; make clean html
El sistema no puede encontrar la ruta especificada.
make: *** [Makefile:52: build-docs] Error 1

[edgarriba]

ok, i'll handle it