Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add grid transform zero fill shortcut #8099

Draft
wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

Conversation

pmeier
Copy link
Collaborator

@pmeier pmeier commented Nov 7, 2023

Fixes #6517 together with #8098.

cc @vfdev-5

Copy link

pytorch-bot bot commented Nov 7, 2023

🔗 Helpful Links

🧪 See artifacts and rendered test results at hud.pytorch.org/pr/pytorch/vision/8099

Note: Links to docs will display an error until the docs builds have been completed.

❌ 20 New Failures, 17 Unrelated Failures

As of commit a33a0aa with merge base f69eee6 (image):

NEW FAILURES - The following jobs have failed:

FLAKY - The following jobs failed but were likely due to flakiness present on trunk:

This comment was automatically generated by Dr. CI and updates every 15 minutes.

Comment on lines +576 to +578
# filling with zeros is the default behavior and thus we can skip the extra fill handling
if fill is not None and all(f == 0 for f in fill):
fill = None
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe it's because I should be sleeping already but I don't really understand the meaning of that comment, or what that code is really doing...

Is fill = None supposed to be equivalent to filling with zeros?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is fill = None supposed to be equivalent to filling with zeros?

Yes. IMO the parameter name "fill" is a misnomer. Filling will happen for most affine ops whether the user likes it or not and regardless of what value they pass for fill. This is just the nature of affine transformations since they can leave the original image into a state that doesn't fill the full rectangular image. Hence we need to fill the parts that are not covered by the transformed image.

IMO, a better name would be "fill color". We had that initially, but it was decided for fill in #2479. IIUC, the only reason for it was that we had more ops that used fill than ops that used fillcolor 🤷

Coming back to your question: yes fill=None, fill=0, and fill=[0,0,0] in theory should all do the same thing, namely filling with zeros. I don't know why we chose None as default rather than fill=0. IMO that further enhances the confusion that there is actually a case that doesn't fill.

Anyway, fill=None is a performance optimization. The PyTorch op that we use does not allow filling with anything but zeros (other filling modes are supported, but we need to change the fill value for constant filling). If we get a any value besides fill=None, we perform some extra steps to allow the fill color the user wants. However in case of fill=0 or fill=[0,0,0] this unnecessary, since it is the default behavior from the PyTorch op anyway.

Right now there is a bug (?) in our affine ops that actually gives us different behavior for the case of fill is not None. #8098 deals with that. If that is resolved, this PR will just be a performance shortcut. If we decide to not move forward with #8098, this likely means, we should also close this PR.

@pmeier pmeier marked this pull request as draft November 8, 2023 08:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Fill arg and _apply_grid_transform improvements
3 participants