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

Docs: Update Math API page #3738

Open
wants to merge 1 commit into
base: docs/develop
Choose a base branch
from
Open

Docs: Update Math API page #3738

wants to merge 1 commit into from

Conversation

adeljo-amd
Copy link

The goal of this PR is to improve the usability of the Math API page, by providing information about each function's maximum ULP error when compared against the C++ standard library (if applicable). It also highlights specific math functions which are unsupported too.

@adeljo-amd adeljo-amd added ci:docs-only Only run Read the Docs CI on this PR documentation labels Feb 3, 2025
@adeljo-amd adeljo-amd requested a review from neon60 February 3, 2025 16:02
@adeljo-amd adeljo-amd self-assigned this Feb 3, 2025
@adeljo-amd adeljo-amd force-pushed the math_doc branch 2 times, most recently from a1238f8 to e9be8fc Compare February 3, 2025 16:07
@adeljo-amd adeljo-amd changed the title Draft: Docs: Update Math API page Docs: Update Math API page Feb 5, 2025
Copy link

@randyh62 randyh62 left a comment

Choose a reason for hiding this comment

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

Looks good to me, except for the missing data related to the functions that don't run on GPUs.

difference between a HIP math function result and its corresponding C++ standard library
function (e.g., comparing HIP's sinf with C++'s sinf).

The following C++ example shows a simplified method for computing ULP differences between
Copy link

Choose a reason for hiding this comment

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

I like the addition of the test case example, but wonder if it should appear after the tables? We could have a reference to it here, above the tables, like "See the Example code for a demonstration of how this data was captured." or something like it?

Copy link
Author

Choose a reason for hiding this comment

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

I think it should be before the table, as it's more helpful for users to know how the metric is measured before seeing the metric values themselves

The functions in this section prioritize numerical accuracy and correctness, making them well-suited for
applications that require high precision and predictable results.

Arithmetic
Copy link

Choose a reason for hiding this comment

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

I like the sorted tables, and the stacked Single/Double Precision tables.

Copy link
Author

Choose a reason for hiding this comment

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

Thanks!

docs/reference/math_api.rst Outdated Show resolved Hide resolved
@neon60
Copy link
Contributor

neon60 commented Feb 7, 2025

@adeljo-amd Could you please rebase the branch?

@adeljo-amd
Copy link
Author

@adeljo-amd Could you please rebase the branch?

Done

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
ci:docs-only Only run Read the Docs CI on this PR documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants