Skip to main content

LUT Estimator

PyPI GitHub License Python

Estimate a 3D LUT from a before/after image pair and apply that look to another image. The package is published on PyPI and can be used either as a CLI tool or as a small Python library.

Japanese documentation is available in README.ja.md.

Why This Exists

This project is for cases where you have:

  • a source image before grading
  • a reference image after grading
  • another target image that should receive a similar look

The estimator samples the before/after pair, reconstructs a 3D LUT, and applies that LUT to the target image with trilinear interpolation.

Example Result

Input image before grading Reference image after grading Image processed with the estimated LUT

Left: source image, center: reference grading, right: target processed with the estimated LUT

Features

  • Estimates a 3D LUT from aligned before/after image pairs
  • Applies LUTs with trilinear interpolation to reduce banding
  • Supports optional Gaussian blur before estimation
  • Exports the estimated LUT as a standard .cube file
  • Provides both a CLI and a Python API

Install

Install from PyPI:

python -m pip install lut-estimator

After installation, you can:

  • run the lut-estimator command from your shell
  • import lut_estimator from Python

For development from source:

python -m pip install -e .[dev]

CLI Usage

Basic usage:

lut-estimator \
  --before before.jpg \
  --after after.jpg \
  --target target.jpg \
  --output estimated_result.jpg

Example with tuning parameters:

lut-estimator \
  --before img/base.JPG \
  --after img/apply_lut.JPG \
  --target img/base.JPG \
  --output estimated_result.jpg \
  --lut-size 33 \
  --sample-rate 0.02 \
  --blur-ksize 0 \
  --seed 42

This writes:

  • the transformed image to the path given by --output
  • a companion .cube LUT file unless --no-cube is passed

Show CLI help:

lut-estimator --help

Legacy script entrypoint:

python lut_tool.py --before before.jpg --after after.jpg --target target.jpg

Python Usage

from lut_estimator import estimate_and_apply_lut

estimate_and_apply_lut(
    before_image_path="before.jpg",
    after_image_path="after.jpg",
    target_image_path="target.jpg",
    output_image_path="estimated_result.jpg",
    lut_size=33,
    sample_rate=0.02,
    blur_ksize=0,
    save_cube=True,
    seed=42,
)

Parameters

  • lut_size: LUT grid resolution. Larger values are usually more accurate but slower.
  • sample_rate: Fraction of pixels used for LUT estimation.
  • blur_ksize: Odd Gaussian kernel size used before estimation. Set 0 to disable blur.
  • seed: Optional random seed for reproducible sampling.

Project Layout

src/lut_estimator/
  core.py      Core LUT estimation and application logic
  cli.py       Command-line interface
tests/
  test_core.py Regression tests
lut_tool.py    Backward-compatible script entrypoint

Notes

  • Input images should be aligned before/after pairs.
  • If the before/after images differ in size, both are resized to the smaller common resolution for estimation.
  • The current estimator models a global RGB-to-RGB transform rather than localized retouching.

Development

Run tests:

pytest

Install pre-commit hooks:

pre-commit install

Build distributions:

python -m build --no-isolation

Validate package metadata:

python -m twine check dist/*

Community

License

Released under the MIT License.

Metadata

Release files for lut-estimator 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for lut-estimator 0.1.2
File Interpreter ABI Platform Actions
lut_estimator-0.1.2-py3-none-any.whl Python 3 none any Details for lut_estimator-0.1.2-py3-none-any.whl

Release files / lut_estimator-0.1.2-py3-none-any.whl

Download URL lut_estimator-0.1.2-py3-none-any.whl
Size 8.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
10f3eb5e03443d22e9278221b6db94270ec42c5e2428a1e1a5bd362a77d10371
BLAKE2b-256 checksum
How to use checksums
5bba985f074171abecddba52b2c44d2c717536f4598be5ec2b9094dd59c15eb0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.2

Security for lut-estimator 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.2 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page