Skip to content

Fix incorrect example paths in CuTeDSL docstrings#3151

Open
Weili-0234 wants to merge 2 commits into
NVIDIA:mainfrom
Weili-0234:fix/cutedsl-example-paths
Open

Fix incorrect example paths in CuTeDSL docstrings#3151
Weili-0234 wants to merge 2 commits into
NVIDIA:mainfrom
Weili-0234:fix/cutedsl-example-paths

Conversation

@Weili-0234
Copy link
Copy Markdown

@Weili-0234 Weili-0234 commented Apr 6, 2026

This PR fix incorrect file paths in CuTeDSL example docstrings that prevent users from copy-pasting run commands directly. This is a superset of #2741, covering all affected files.

Three categories of issues fixed:

  1. Missing python/CuTeDSL/ prefix (69 files) e.g. examples/ampere/sgemm.pyexamples/python/CuTeDSL/ampere/sgemm.py
  2. Stale cutlass_ir/compiler/python/ prefix (6 files under cute/tvm_ffi/) e.g. cutlass_ir/compiler/python/examples/cute/tvm_ffi/aot_export.pyexamples/python/CuTeDSL/cute/tvm_ffi/aot_export.py
  3. Wrong filenames / missing subdirectories (9 files) e.g. blackwell/mla_fp16.pyblackwell/mla/mla_decode_fp16.py

The CuTeDSL examples reference incorrect paths in their docstrings
and usage comments. All paths were missing the `python/CuTeDSL/`
prefix (e.g., `examples/ampere/sgemm.py` instead of
`examples/python/CuTeDSL/ampere/sgemm.py`). Some files under
`cute/tvm_ffi/` also used a stale `cutlass_ir/compiler/python/`
prefix.

This is a superset of the fix in PR NVIDIA#2741, covering all 69 affected
files across ampere, hopper, blackwell, cute, distributed, jax, and
experimental subdirectories.
Addresses issues missed by the batch path prefix replacement:
- cooperative_launch.py, dynamic_smem_size.py: add full path prefix
- dense_blockscaled_gemm_persistent_amax.py: fix missing _amax suffix
- mla_decode_fp16.py, mla_decode_fp8.py: fix filename and add mla/ subdir
- grouped_mixed_input_gemm.py: add missing mixed_input_gemm/ subdir
- grouped_gemm.py (hopper): add full path prefix
- distributed_gemm_all_reduce_blackwell.py: fix wrong filename
- elementwise_apply_example.py (jax): fix references to wrong directory
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 6, 2026

This PR has been labeled inactive-30d due to no recent activity in the past 30 days. Please close this PR if it is no longer required. Otherwise, please respond with a comment indicating any updates. This PR will be labeled inactive-90d if there is no activity in the next 60 days.

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.

1 participant