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

added documentation for IndexLayout #1583

Merged
merged 8 commits into from
Jan 26, 2024

Conversation

gberg617
Copy link
Contributor

This PR is for documenting the IndexLayout.

@gberg617 gberg617 force-pushed the feature/bergel1/index-view-documentation branch from a5fe48b to d18558a Compare December 20, 2023 21:55
Index Layout
^^^^^^^^^^^^

``RAJA::IndexLayout`` is a layout that uses an indexing strategy for each
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
``RAJA::IndexLayout`` is a layout that uses an indexing strategy for each
``RAJA::IndexLayout`` is a layout that potentially uses a different indexing strategy for each

In reality, all RAJA Layouts use an "index strategy" to index into an array of data. The distinguishing characteristic of IndexLayout is the fact that the indexing can be different for each dimension, correct?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I think the distinguishing feature should actually be that it can use an index list (or lists) that map input indices to some entry in a view. I don't really think that the fact that you can assign different indexing 'strategies' for each dimension is the central point here. I tried rewording this paragraph to convey that.

Copy link
Member

Choose a reason for hiding this comment

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

I agree that is the main thing. Having to set one for each dimension is not something you had to do before though so it seems noteworthy as well.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I re-worded the first paragraph to convey both of the above points. Let me know if you think more clarification or elaboration on those main points is needed.

@gberg617 gberg617 force-pushed the feature/bergel1/index-view-documentation branch from dcc9bd2 to d73db63 Compare December 22, 2023 18:59
@gberg617 gberg617 force-pushed the feature/bergel1/index-view-documentation branch from c13399d to dbaa1c3 Compare January 23, 2024 21:26
@gberg617 gberg617 enabled auto-merge January 24, 2024 16:34
@gberg617 gberg617 merged commit 7a20ea0 into develop Jan 26, 2024
15 checks passed
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.

3 participants