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

Blas1: docs update for PR #1803 #1805

Merged
merged 3 commits into from
Apr 25, 2023
Merged

Conversation

lucbv
Copy link
Contributor

@lucbv lucbv commented Apr 24, 2023

updating documentation for changes in PR #1803, this PR will be rebased once #1803 is merged.
It mostly includes additional overloads of our BLAS1 functions to accept an execution space instance.
Additional documentation improvement have been made as well.

@lucbv lucbv requested a review from e10harvey April 24, 2023 16:21
@lucbv lucbv self-assigned this Apr 24, 2023
@lucbv lucbv added the AT: WIP label Apr 24, 2023
@lucbv
Copy link
Contributor Author

lucbv commented Apr 24, 2023

Making this PR WIP so that it does not trigger any testing as it only contains changes to documentation (both inline and in rst files).

Copy link
Contributor

@e10harvey e10harvey left a comment

Choose a reason for hiding this comment

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

Before merging this, I would like the doxygen style comments updated to note:

  1. Blocking behavior of each function
  2. Default execution space of each function

shall I open a PR into your fork for these changes?


/// \brief R(i,j) = abs(X(i,j))
///
/// Replace each entry in R with the absolute value (magnitude) of the
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
/// Replace each entry in R with the absolute value (magnitude) of the
/// Non-blocking function to replace each entry in R with the absolute value (magnitude) of the

@@ -28,18 +28,34 @@ namespace KokkosBlas {
/// Replace each entry in R with the absolute value (magnitude) of the
/// corresponding entry in X.
///
/// \tparam execution_space a Kokkos execution space to run the kernels on.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
/// \tparam execution_space a Kokkos execution space to run the kernels on.
/// \tparam execution_space a Kokkos execution space to run the kernels on (default: RMV::execution_space)

Copy link
Contributor

Choose a reason for hiding this comment

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

Actually, we should document this in the overload without a space parameter.

@lucbv
Copy link
Contributor Author

lucbv commented Apr 25, 2023

@e10harvey thanks for approving this although it would be best if you approved the original PR as it needs to merge before this one...

@e10harvey
Copy link
Contributor

e10harvey commented Apr 25, 2023

@e10harvey thanks for approving this although it would be best if you approved the original PR as it needs to merge before this one...

@lucbv: Both are approved now. Merging this PR should mark #1803 as merged since these commits are a superset of the commits in 1803.

@e10harvey e10harvey mentioned this pull request Apr 25, 2023
@lucbv
Copy link
Contributor Author

lucbv commented Apr 25, 2023

Actually I believe I have fixed an issue or two with the TPLs yesterday that is not in this branch so this branch needs to be at least rebased.
More importantly this PR contains code changes that are not tested since it is marked as WIP, merging it would be fairly unsafe for the code, again because there can be some diff that appeared while I was writing the documentation here.
In general if there is a code change I require that it goes through testing.

lucbv added 3 commits April 25, 2023 07:50
This documents the addition of the execution_space template
parameter and the associated space parameter to allow execution
of the BLAS kernels in streams/queues when on device.
@lucbv lucbv force-pushed the blas1_on_stream_docs branch from 3d2639e to 03d6787 Compare April 25, 2023 13:50
@e10harvey
Copy link
Contributor

Actually I believe I have fixed an issue or two with the TPLs yesterday that is not in this branch so this branch needs to be at least rebased.
More importantly this PR contains code changes that are not tested since it is marked as WIP, merging it would be fairly unsafe for the code, again because there can be some diff that appeared while I was writing the documentation here.
In general if there is a code change I require that it goes through testing.

Okay, note that this PR went from 11 commits to 3 commits after #1803 merged and that these 3 commits only touch c++ comments and .rst files which were tested via github-DOCS in this PR.

@lucbv
Copy link
Contributor Author

lucbv commented Apr 25, 2023

Yes, I agree but before I rebased they had code changes and if anything was slightly out of sync between this PR and #1803 we would be introducing a bug.
Here going the sage route of rebasing is easy so we should do it, I am flexible in certain cases when it's more complicated though.
I will merge this now since you are okay with the documentation done here.

@lucbv lucbv merged commit ccf8f15 into kokkos:develop Apr 25, 2023
@lucbv lucbv deleted the blas1_on_stream_docs branch April 25, 2023 13:59
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.

2 participants