api: make eye_() public — rename from _eye_() to eye_()

Downstream code (genesis solver) needs to call eye_() on tile
instances. Unlike _load/_store which have slice-syntax equivalents,
eye_() has no alternative public API, so it should be public.

Author: hughperkins

docs/source/user_guide/tile16.md

@@ -65,7 +65,7 @@ For padding partial tiles in blocked algorithms:
 
 ```python
 t = Tile.eye()    # create a new identity tile
-t._eye_()         # or reset an existing tile to identity in-place
+t.eye_()          # or reset an existing tile to identity in-place
 ```
 
 Each thread sets its diagonal element to 1.0 and all others to 0.0.
@@ -151,7 +151,7 @@ Not all GPU backends support f64. Use `test_utils.skip_if_f64_unsupported()` in
 | `t[:] = arr[i, r0:r1, c0:c1]` | Load from 3D array |
 | `arr[r0:r1, c0:c1] = t` | Store to 2D array |
 | `arr[i, r0:r1, c0:c1] = t` | Store to 3D array |
-| `t._eye_()` | Set to identity matrix (in-place) |
+| `t.eye_()` | Set to identity matrix (in-place) |
 | `t -= qd.outer(v, v)` | Symmetric rank-1 subtract |
 | `t -= qd.outer(a, b)` | General rank-1 subtract |
 | `t.cholesky_(eps)` | In-place Cholesky factorization |

python/quadrants/lang/simt/_tile16.py

@@ -27,7 +27,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None: ...  # noqa: E704
         def zeros(cls) -> _Tile16x16Proto: ...  # noqa: E704
         @classmethod
         def eye(cls) -> _Tile16x16Proto: ...  # noqa: E704
-        def _eye_(self) -> None: ...  # noqa: E704
+        def eye_(self) -> None: ...  # noqa: E704
         def cholesky_(self, eps: Any) -> None: ...  # noqa: E704
         def solve_triangular_(self, B: _Tile16x16Proto, lower: bool = True) -> None: ...  # noqa: E704
         def _load(self, arr: Any, row_start: Any, row_end: Any, col_start: Any, col_end: Any) -> None: ...  # noqa: E704
@@ -299,7 +299,7 @@ def _store3d(self, arr: qd.template(), batch, row_start, row_stop, col_start, co
                         arr[batch, row, col_start + j] = self._get_col(j)
 
         @qd.func
-        def _eye_(self):
+        def eye_(self):
             """Set this tile to the 16x16 identity matrix.  Each thread sets its diagonal element to 1.0 and all
             others to 0.0."""
             tid = qd.simt.subgroup.invocation_id()
@@ -507,7 +507,7 @@ def _augassign(self, other: Any, op: str) -> None:
     @qd.func
     def _eye():
         t = result()
-        t._eye_()  # type: ignore[reportAttributeAccessIssue]
+        t.eye_()  # type: ignore[reportAttributeAccessIssue]
         return t
 
     result.eye = _eye  # type: ignore[reportAttributeAccessIssue]

tests/python/test_tile16.py

@@ -96,7 +96,7 @@ def k1(src_arr: Ann, dst_arr: Ann):
         for _ in range(_TILE):
             t = qd.simt.Tile16x16.zeros(dtype=qd_dtype)
             t[:] = src_arr[0:_TILE, 0:_TILE]
-            t._eye_()
+            t.eye_()
             dst_arr[0:_TILE, 0:_TILE] = t
 
     data = np.arange(_TILE * _TILE, dtype=np_dtype).reshape(_TILE, _TILE) + 100.0