ad · PyPI

Fast, transparent first- and second-order automatic differentiation for Python

Overview

The ad package allows you to easily and transparently perform first- and second-order automatic differentiation. Advanced math involving trigonometric, logarithmic, hyperbolic, and related functions can be evaluated directly using the ad.admath submodule.

All base numeric types are supported (int, float, complex, etc.). The package is designed so underlying numeric types interact as they normally do during calculations. In practice, ad behaves like a lightweight wrapper that tracks derivatives while preserving standard numeric behavior.

From the Wikipedia entry on Automatic differentiation:

"AD exploits the fact that every computer program, no matter how complicated, executes a sequence of elementary arithmetic operations (addition, subtraction, multiplication, division, etc.) and elementary functions (exp, log, sin, cos, etc.). By applying the chain rule repeatedly to these operations, derivatives of arbitrary order can be computed automatically, and accurate to working precision."

See the package documentation for details and examples.

Main Features

Transparent calculations with derivatives, requiring little or no modification to existing code (including NumPy-based code).
Broad mathematical operation support, including most functions from math and cmath, plus convenience trigonometric, hyperbolic, and logarithmic helpers (csc, acoth, ln, etc.). Comparison operators follow the same rules as the wrapped numeric values.
Seamless real and complex arithmetic through ad.admath counterparts.
Automatic gradient and Hessian function generator for optimization workflows with scipy.optimize via gh(your_func_here).
Linear algebra routines in ad.linalg similar to NumPy's linalg, without LAPACK dependency.

Linear Algebra Routines

Decompositions

chol: Cholesky decomposition
lu: LU decomposition
qr: QR decomposition

Solving equations and matrix inversion

solve: General solver for linear systems
lstsq: Least-squares solver for linear systems
inv: Multiplicative inverse of a matrix

Installation

uv pip install ad

Requires Python 3.10+. See the full installation guide.

Documentation

Theory — mathematical background, hierarchical basis, algorithms
Quickstart — runnable examples
API Reference — class and function signatures
References — literature citations

License

BSD-3-Clause.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ad-1.5.1.tar.gz (237.9 kB view details)

Uploaded Aug 19, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ad-1.5.1-py3-none-any.whl (21.4 kB view details)

Uploaded Aug 19, 2026 Python 3

File details

Details for the file ad-1.5.1.tar.gz.

File metadata

Download URL: ad-1.5.1.tar.gz
Upload date: Aug 19, 2026
Size: 237.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ad-1.5.1.tar.gz
Algorithm	Hash digest
SHA256	`ee7c5dfe8744ba43bfac9e32b0c6e9f710ad71dc4174189c82f8a8a079bfb47b`
MD5	`9db5bcf7a5892478737fdc53e02648fc`
BLAKE2b-256	`7c4aa508b0fbc2835d49c85836a51fb6f90675a076140a92333a5b1b79b2a008`

See more details on using hashes here.

Provenance

The following attestation bundles were made for ad-1.5.1.tar.gz:

Publisher: publish_dist.yml on eggzec/ad

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: ad-1.5.1.tar.gz
- Subject digest: ee7c5dfe8744ba43bfac9e32b0c6e9f710ad71dc4174189c82f8a8a079bfb47b
- Sigstore transparency entry: 2514757218
- Sigstore integration time: Aug 19, 2026
Source repository:
- Permalink: eggzec/ad@108d14a1c6f2753ae63d496a6359c6a1395a3257
- Branch / Tag: refs/tags/v1.5.1
- Owner: https://github.com/eggzec
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish_dist.yml@108d14a1c6f2753ae63d496a6359c6a1395a3257
- Trigger Event: release