Skip to content

Rename distributed::Matrix non_local_matrix to ghost _matrix#2017

Open
pratikvn wants to merge 1 commit into
developfrom
rename/dist-local-diag
Open

Rename distributed::Matrix non_local_matrix to ghost _matrix#2017
pratikvn wants to merge 1 commit into
developfrom
rename/dist-local-diag

Conversation

@pratikvn
Copy link
Copy Markdown
Member

@pratikvn pratikvn commented May 8, 2026

This PR renames the distributed Matrix non_local_matrix to ghost_matrix . It deprecates the previous non_local names.

@pratikvn pratikvn self-assigned this May 8, 2026
@pratikvn pratikvn added the 1:ST:ready-for-review This PR is ready for review label May 8, 2026
@ginkgo-bot ginkgo-bot added reg:testing This is related to testing. reg:benchmarking This is related to benchmarking. type:solver This is related to the solvers type:preconditioner This is related to the preconditioners type:multigrid This is related to multigrid mod:all This touches all Ginkgo modules. labels May 8, 2026
@pratikvn
Copy link
Copy Markdown
Member Author

pratikvn commented May 8, 2026

format!

@pratikvn pratikvn force-pushed the rename/dist-local-diag branch from 685fa10 to 38a1edf Compare May 8, 2026 10:00
@pratikvn
Copy link
Copy Markdown
Member Author

pratikvn commented May 8, 2026

format!

@pratikvn pratikvn changed the title Rename distributed Matrix local_matrix and non_local_matrix Rename distributed::Matrix non_local_matrix to ghost _matrix May 8, 2026
@pratikvn pratikvn requested review from MarcelKoch and yhmtsai May 8, 2026 11:41
Copy link
Copy Markdown
Member

@MarcelKoch MarcelKoch left a comment

Choose a reason for hiding this comment

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

Only smaller nits.
I would also suggest to have another PR to use the same naming scheme for the index map.

Comment on lines 67 to 72
* provided as a list of tuples for each part
* of the row partition. Each tuple contains
* the size of the non-local matrix, a list of
* the size of the ghost matrix, a list of
* row indices (mapped to local indexing), a
* list of column indices (NOT mapped to local
* indexing), and a list of values.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

nit: fix indent

Comment on lines +424 to +425
* this process — i.e., the columns borrowed (as ghost values) from other
* ranks during SpMV.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This explanation seems confusing to me. Columns are not communicated during the spmv

Comment on lines +176 to +177
* entries from columns that are not owned by the process (the ghost columns
* borrowed from neighbors). The ghost matrix is stored in a compressed
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Same here. The columns are not borrowed from neighbors, they only exist on this rank.

@pratikvn pratikvn force-pushed the rename/dist-local-diag branch from 2976db4 to ca8b467 Compare May 12, 2026 13:18
Copy link
Copy Markdown
Member

@yhmtsai yhmtsai left a comment

Choose a reason for hiding this comment

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

LGTM. is off-diag or offdiag more often used?

DEFINE_string(non_local_formats, "csr",
"A comma-separated list of formats for the non-local matrix to "
DEFINE_string(off_diag_formats, "csr",
"A comma-separated list of formats for the off-diag matrix to "
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

off-diag to offdiag directly?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

1:ST:ready-for-review This PR is ready for review mod:all This touches all Ginkgo modules. reg:benchmarking This is related to benchmarking. reg:testing This is related to testing. type:multigrid This is related to multigrid type:preconditioner This is related to the preconditioners type:solver This is related to the solvers

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants