jax-ml/jax · error · NotImplementedError
The 'out' argument to jnp.std is not supported.
Error message
The 'out' argument to jnp.std is not supported.
What it means
JAX arrays are immutable, so std cannot write its result into a caller-provided out buffer. The jitted _std helper fires when out is not None.
Solutions
- Drop the out argument and use the returned array: y = jnp.std(x)
- If reusing a buffer name is needed, reassign: buf = jnp.std(x) at runtime (jit will still avoid reallocation)
Example fix
// before np.std(x, out=buf) // after buf = jnp.std(x)
Defensive patterns
Strategy: validation
Validate before calling
kwargs.pop('out', None) # strip NumPy-style out before calling jnp.std Prevention
- Strip out= in NumPy→JAX adapter layers
- Remember all jnp reductions reject out=
- Grep ports for 'out=' before running
When it happens
Trigger: Calling jnp.std(x, out=buf) or any positional third argument being interpreted as out.
Common situations: Porting NumPy code that uses out= to avoid allocations; generic wrappers forwarding all NumPy kwargs.
Related errors
- jax.numpy.nanquantile does not support overwrite_input=True…
- jax.numpy.quantile does not support overwrite_input=True or…
- The 'out' argument to jnp.
- The 'out' argument to jnp.nanmean is not supported.
- The 'out' argument to jnp.nanstd is not supported.
AI-assisted analysis of jax-ml/jax@1e1c6a8fc0 (2026-08-27).
Data as JSON: /api/errors/1957608bb12659e9.
Report an issue: GitHub.
Appendix: source
Thrown at jax/_src/numpy/reductions.py:1284
if correction is None:
correction = ddof
elif not isinstance(ddof, int) or ddof != 0:
raise ValueError("ddof and correction can't be provided simultaneously.")
a = ensure_arraylike("std", a)
return _std(a, axis=_ensure_optional_axes(axis), dtype=dtype, out=out, correction=correction, keepdims=keepdims,
where=where, mean=mean)
@api.jit(static_argnames=('axis', 'dtype', 'keepdims'))
def _std(a: Array, *, axis: Axis = None, dtype: DTypeLike | None = None,
out: None = None, correction: int | float = 0, keepdims: bool = False,
where: ArrayLike | None = None, mean: ArrayLike | None = None) -> Array:
where = check_where("std", where)
if dtype is not None:
dtype = dtypes.check_and_canonicalize_user_dtype(dtype, "std")
if not dtypes.issubdtype(dtype, np.inexact):
raise ValueError(f"dtype argument to jnp.std must be inexact; got {dtype}")
if out is not None:
raise NotImplementedError("The 'out' argument to jnp.std is not supported.")
return lax.sqrt(var(a, axis=axis, dtype=dtype, correction=correction,
keepdims=keepdims, where=where, mean=mean))
@export
def ptp(a: ArrayLike, axis: Axis = None, out: None = None,
keepdims: bool = False) -> Array:
r"""Return the peak-to-peak range along a given axis.
JAX implementation of :func:`numpy.ptp`.
Args:
a: input array.
axis: optional, int or sequence of ints, default=None. Axis along which the
range is computed. If None, the range is computed on the flattened array.
keepdims: bool, default=False. If true, reduced axes are left in the result
with size 1.
out: Unused by JAX.View on GitHub (pinned to 1e1c6a8fc0)