Skip to content

torchdim Python port #160236

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

Open
wants to merge 3 commits into
base: gh/ezyang/3127/base
Choose a base branch
from
Open

torchdim Python port #160236

wants to merge 3 commits into from

Conversation

ezyang
Copy link
Contributor

@ezyang ezyang commented Aug 9, 2025

Stack from ghstack (oldest at bottom):

The big semantic change (and the reason for this port) is that we no longer monkeypatch Tensor with torchdim's special methods. The new algorithm for handling dispatch is that we first land in __torch_function__ and we see if a special FCD implementation needs to be dispatch to first, and if there is nothing we fallback to the standard level strategy.

Because there is no longer C binding equivalent of classes, we've condensed _C.Dim and Dim together, and similar for Tensor. This resulted in some bugs as the Python API is sometimes different from the C API. I've attempted to disambiguate these but there may still be mistakes (many early bugs were due to this problem). Dim and DimEntry are especially painful as Dim must abide by Tensor equality semantics, but is pointer equality in C (DimEntry doesn't have this problem). Another difference between C/Python that is subtle is we no longer get implicit conversions from Dim to DimEntry, this also caused some bugs.

Much of the mechanical porting work was done by claude code. I have a separate PR that deletes functorch._C, but it was useful having dim.cpp to point claude at it so I haven't done it in this PR. From a reviewing perspective, I need to re-review that I didn't forget to port anything, some noticeably missing "small" things are Tensor_ndim and patched_dim_method. I am still in progress of carefully doing a side-by-side review of ports; "simplifications" from claude code were also a major source of bugs.

There are two major feature gaps in the implementation:

  • DelayedTensor and dot handling are not implemented yet. This should be reasonably easy, just need to do it. However, for the purposes of sharded propagation it is actually better not to reconstruct matmuls.
  • Splitting dimensions with an index like [x, y] doesn't work. The problem is that __getitem__ interprets this as advanced indexing and sends the list to torch.tensor to turn into a tensor, instead of being eligible for __torch_function__. I think I might need to hard code a special case for this or something?

Signed-off-by: Edward Yang ezyang@meta.com

[ghstack-poisoned]
Copy link

pytorch-bot bot commented Aug 9, 2025

🔗 Helpful Links

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

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

❌ 25 New Failures

As of commit 172e55e with merge base 5dddcd5 (image):

NEW FAILURES - The following jobs have failed:

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

ezyang added a commit that referenced this pull request Aug 9, 2025
Signed-off-by: Edward Yang <ezyang@meta.com>
ghstack-source-id: 0db2026
Pull-Request: #160236
[ghstack-poisoned]
ezyang added a commit that referenced this pull request Aug 10, 2025
Signed-off-by: Edward Yang <ezyang@meta.com>
ghstack-source-id: 1960626
Pull-Request: #160236
@ezyang ezyang changed the title [WIP] torchdim Python port torchdim Python port Aug 10, 2025
@ezyang ezyang requested a review from zdevito August 10, 2025 04:18
@ezyang
Copy link
Contributor Author

ezyang commented Aug 10, 2025

This is ready for review!

[ghstack-poisoned]
ezyang added a commit that referenced this pull request Aug 10, 2025
Signed-off-by: Edward Yang <ezyang@meta.com>
ghstack-source-id: 70c67dd
Pull-Request: #160236
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant