|
| 1 | +.. SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved. |
| 2 | +.. SPDX-License-Identifier: Apache-2.0 |
| 3 | +
|
| 4 | +Updates in Nsight Python 1.1.1 |
| 5 | +============================== |
| 6 | + |
| 7 | +API Changes |
| 8 | +----------- |
| 9 | + |
| 10 | +- **Raise an error when no kernels were profiled** |
| 11 | + (`#83 <https://github.com/NVIDIA/nsight-python/pull/83>`_): |
| 12 | + :func:`@nsight.analyze.kernel <nsight.analyze.kernel>` now raises a |
| 13 | + ``RuntimeError`` when no kernel launch could be attributed to any |
| 14 | + :func:`nsight.annotate` region, instead of returning an empty DataFrame. |
| 15 | + Previously, with the CUPTI backend this failed silently when CUDA was used |
| 16 | + before the first profiled call. |
| 17 | + |
| 18 | +- **Warn on ignored annotation failures** |
| 19 | + (`#83 <https://github.com/NVIDIA/nsight-python/pull/83>`_): |
| 20 | + When an annotation created with ``ignore_failures=True`` raises, a |
| 21 | + ``RuntimeWarning`` naming the annotation and the ignored exception is now |
| 22 | + emitted. The measured metric for that run is still set to ``NaN``. |
| 23 | + |
| 24 | +Fixes |
| 25 | +----- |
| 26 | + |
| 27 | +- **Improved kernel-count and missing-report errors** |
| 28 | + (`#83 <https://github.com/NVIDIA/nsight-python/pull/83>`_): |
| 29 | + The errors raised when an annotation launches more than one kernel, or a |
| 30 | + different number of kernels in different runs, now report the kernel and run |
| 31 | + counts and suggest warming up code that autotunes on its first call. The |
| 32 | + error raised when no NVIDIA Nsight Compute report is found now includes the |
| 33 | + report path and the most likely cause. |
| 34 | + |
| 35 | +- **Plain-text output when stdout is not a terminal** |
| 36 | + (`#83 <https://github.com/NVIDIA/nsight-python/pull/83>`_): |
| 37 | + ANSI color and cursor-movement codes are only emitted when stdout is a |
| 38 | + terminal. When output is redirected to a file, a pipe, or a captured log, |
| 39 | + only the final progress bar is printed. |
0 commit comments