Skip to content

Add rank order option to grid descriptor configuration. - #119

Merged
romerojosh merged 6 commits into
mainfrom
rank_order_config
Apr 29, 2026
Merged

Add rank order option to grid descriptor configuration.#119
romerojosh merged 6 commits into
mainfrom
rank_order_config

Conversation

@romerojosh

@romerojoshromerojosh commented Apr 29, 2026

Copy link
Copy Markdown
Collaborator

In #85, an option to make cuDecomp use column major rank assignment was made available via an environment variable CUDECOMP_USE_COL_MAJOR_RANK_ORDER. In practice, using this functionality can be a bit awkward as programs that depend on it require checks on the user environment (via something like getenv) to ensure the environment variable is set appropriately.

This PR addresses this by adding a new field, rank_order to the grid descriptor configuration struct to enable per grid descriptor settings of the rank assignment. A new enum cudecompRankOrder_t is added to enable users to select from default/row-major (CUDECOMP_RANK_ORDER_DEFAULT/CUDECOMP_RANK_ORDER_ROW_MAJOR) or column-major (CUDECOMP_RANK_ORDER_COL_MAJOR). Importantly, this makes the rank assignment expectation a programmatic setting rather than awkwardly relying on environment variable settings.

As part of this PR, the CUDECOMP_USE_COL_MAJOR_RANK_ORDER env var functionality is deprecated. It will be honored if CUDECOMP_RANK_ORDER_DEFAULT is used, ignored otherwise. This feature will be removed in a future release.

Noting that this is an ABI break since it alters the configuration struct layout.

Signed-off-by: Josh Romero <joshr@nvidia.com>
Signed-off-by: Josh Romero <joshr@nvidia.com>
Signed-off-by: Josh Romero <joshr@nvidia.com>
@romerojosh

Copy link
Copy Markdown
CollaboratorAuthor

/build

@github-actions

Copy link
Copy Markdown

🚀 Build workflow triggered! View run

@github-actions

Copy link
Copy Markdown

✅ Build workflow passed! View run

Signed-off-by: Josh Romero <joshr@nvidia.com>
Signed-off-by: Josh Romero <joshr@nvidia.com>
Signed-off-by: Josh Romero <joshr@nvidia.com>
@romerojosh
romerojosh merged commit 0afeb97 into mainApr 29, 2026
4 checks passed
@romerojosh
romerojosh deleted the rank_order_config branch April 30, 2026 18:03
Sign up for freeto 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

@romerojosh