Metadata-Version: 2.4
Name: hintauc
Version: 0.3.0
Summary: Deterministic region-based hint generation (DHT) and Hint-AUC evaluation for line-art colorization
Author: Koki Madono
License-Expression: MIT
Project-URL: Homepage, https://github.com/MADONOKOUKI/DetFill-with-DHT
Project-URL: Repository, https://github.com/MADONOKOUKI/DetFill-with-DHT
Project-URL: Issues, https://github.com/MADONOKOUKI/DetFill-with-DHT/issues
Project-URL: Paper, https://doi.org/10.1109/TVCG.2026.3738401
Keywords: line art,colorization,evaluation,hint generation,Hint-AUC,diffusion
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Image Processing
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: <3.13,>=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: opencv-python
Requires-Dist: scikit-image>=0.19
Requires-Dist: fil_finder<1.8,>=1.7
Requires-Dist: astropy<6,>=5.0
Requires-Dist: pillow
Provides-Extra: perceptual
Requires-Dist: torch; extra == "perceptual"
Requires-Dist: torchvision; extra == "perceptual"
Requires-Dist: lpips; extra == "perceptual"
Requires-Dist: open_clip_torch; extra == "perceptual"
Requires-Dist: transformers; extra == "perceptual"
Requires-Dist: dreamsim; extra == "perceptual"
Requires-Dist: torchmetrics; extra == "perceptual"
Requires-Dist: dists-pytorch; extra == "perceptual"
Requires-Dist: torch-fidelity; extra == "perceptual"
Dynamic: license-file

# hintauc

Deterministic region-based hint generation (DHT) and Hint-AUC evaluation for line-art colorization, from
*Hint-AUC: Deterministic Region-based Hint Generation for Line Art Colorization Evaluation*
(IEEE Transactions on Visualization and Computer Graphics, 2026, DOI 10.1109/TVCG.2026.3738401).

```bash
pip install hintauc                 # deterministic hints, pixel metrics, Hint-AUC
pip install "hintauc[perceptual]"   # + LPIPS / OpenCLIP / DINOv2 / DreamSim
```

```python
import hintauc
hints = hintauc.generate_hints("illustration.png", size=64)      # image -> deterministic scribble and dot hints
color, mask = hints.at_ratio(0.10, hint_type="scribble")         # hints of the largest 10 % of the regions
evaluator = hintauc.Evaluator(metrics=("psnr", "lpips", "dreamsim"))
print(evaluator("colorized.png", "ground_truth.png"))
```

Command line: `hintauc generate image.png --ratio 0.1`, `hintauc eval pred_dir gt_dir --metrics mse psnr ssim`,
`hintauc curve pred_root gt_dir` (Hint-AUC from one directory of outputs per hint ratio). Your own model as a Python
function: `hintauc.evaluate_colorizer(fn, samples)`.

Documentation, the DetFill colorization model, all checkpoints and the reproduction package:
https://github.com/MADONOKOUKI/DetFill-with-DHT
