Merge pull request #23940 from jakevdp:jacobian-doc

PiperOrigin-RevId: 679203936
jax-ml · Sep 26, 2024 · 6f7ad64 · 6f7ad64
2 parents 96cf2b8 + cf51ee7
commit 6f7ad64
Show file tree

Hide file tree

Showing 2 changed files with 8 additions and 1 deletion.
diff --git a/docs/jax.rst b/docs/jax.rst
@@ -91,6 +91,7 @@ Automatic differentiation
 
     grad
     value_and_grad
+    jacobian
     jacfwd
     jacrev
     hessian

diff --git a/jax/_src/api.py b/jax/_src/api.py
@@ -680,7 +680,13 @@ def jacfun(*args, **kwargs):
       return jac_tree, aux
 
   return jacfun
-jacobian = jacrev
+
+
+def jacobian(fun: Callable, argnums: int | Sequence[int] = 0,
+             has_aux: bool = False, holomorphic: bool = False, allow_int: bool = False) -> Callable:
+  """Alias of :func:`jax.jacrev`."""
+  return jacrev(fun, argnums=argnums, has_aux=has_aux, holomorphic=holomorphic, allow_int=allow_int)
+
 
 _check_input_dtype_jacrev = partial(_check_input_dtype_revderiv, "jacrev")
 _check_output_dtype_jacrev = partial(_check_output_dtype_revderiv, "jacrev")