Skip to content

Update docstrings for dpnp.scipy.linalg LU functions#2802

Open
antonwolfy wants to merge 4 commits intomasterfrom
update-docstring-for-lu
Open

Update docstrings for dpnp.scipy.linalg LU functions#2802
antonwolfy wants to merge 4 commits intomasterfrom
update-docstring-for-lu

Conversation

@antonwolfy
Copy link
Contributor

@antonwolfy antonwolfy commented Mar 5, 2026

This PR implements few improvements for LU function in dpnp.scipy.linalg namespace:

  • resolved issue with Returns section formatting in lu function
  • changed to proper func: role for the functions cross-references in See also section
  • used Warnings section name instead of Warning
  • changed {None, bool} to bool for overwrite_a, check_finite, and overwrite_b parameters
  • Have you provided a meaningful PR description?
  • Have you added a test, reproducer or referred to an issue with a reproducer?
  • Have you tested your changes locally for CPU and GPU devices?
  • Have you made sure that new changes do not introduce compiler warnings?
  • Have you checked performance impact of proposed changes?
  • Have you added documentation for your changes, if necessary?
  • Have you added your changes to the changelog?

antonwolfy and others added 3 commits March 5, 2026 13:09
Change parameter types from `{None, bool}` to `bool` for overwrite_a,
check_finite, and overwrite_b parameters to match SciPy's documentation.

These parameters are boolean flags that do not accept None as a valid
value according to the documented API.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Change 'Warning' to 'Warnings' (plural) in docstring section headers
across multiple modules to follow NumPy/SciPy documentation style guide.

Files modified:
- dpnp/scipy/linalg/_decomp_lu.py (3 functions)
- dpnp/dpnp_iface_histograms.py (5 functions)
- dpnp/dpnp_iface_manipulation.py (2 functions)
- dpnp/dpnp_iface_nanfunctions.py (4 functions)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Change :obj: to :func: for function references in See Also sections
to be more semantically correct according to Sphinx documentation
conventions.

Updated 5 function cross-references in scipy.linalg._decomp_lu module.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@antonwolfy antonwolfy added this to the 0.20.0 release milestone Mar 5, 2026
@antonwolfy antonwolfy self-assigned this Mar 5, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Mar 5, 2026

View rendered docs @ https://intelpython.github.io/dpnp/pull/2802/index.html

@antonwolfy antonwolfy force-pushed the update-docstring-for-lu branch from 1f11691 to 79079e3 Compare March 5, 2026 12:56
@coveralls
Copy link
Collaborator

coveralls commented Mar 5, 2026

Coverage Status

coverage: 81.17%. remained the same
when pulling 5b4c119 on update-docstring-for-lu
into a2825a1 on master.

@github-actions
Copy link
Contributor

github-actions bot commented Mar 5, 2026

Array API standard conformance tests for dpnp=0.20.0dev3=py313h509198e_16 ran successfully.
Passed: 1354
Failed: 3
Skipped: 16

Replace bold asterisk formatting with clearer conditional returns
documentation:
- Add explanatory sentence about tuple returns based on permute_l
- List all return values (p, l, pl, u) at the top level for Napoleon
- Maintain clear structure: explanation first, then "where:" with details

Also add missing period to parameter description in lu_solve.

This ensures proper Sphinx/Napoleon rendering while keeping the clear
explanation of which tuples are returned.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@antonwolfy antonwolfy force-pushed the update-docstring-for-lu branch from 79079e3 to 5b4c119 Compare March 5, 2026 13:54
@antonwolfy antonwolfy marked this pull request as ready for review March 5, 2026 14:30
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.

2 participants