mathews-tom/arxiv-figures

arXiv Figure Optimizer

Purpose

Analyze, optimize, and convert figures in a TeX/LaTeX project to meet arXiv requirements and size constraints. Produces correctly formatted, efficiently compressed figures that compile without errors.

Companion skills:

• arxiv-preflight — full submission validation
• arxiv-package — tarball packaging

Format Rules

By Processor

| Processor | Accepted | Rejected | |-----------|----------|----------| | LaTeX (DVI mode) | .ps, .eps | .pdf, .png, .jpg | | PDFLaTeX | .pdf, .png, .jpg | .ps, .eps |

By Content Type

| Content | Optimal Format | Rationale | |---------|---------------|-----------| | Photographs | JPEG | Lossy compression suits continuous tone | | Line drawings / diagrams | PDF (vector) | Scalable, sharp at any resolution | | Plots with text labels | PDF (vector) | Text remains crisp and searchable | | Screenshots / raster art | PNG | Lossless compression for sharp edges | | Mixed photo + text | PNG or PDF | Depends on dominant content |

Workflow

1. Inventory

Scan the project for all figures:

• Parse \includegraphics calls from all .tex files
• Identify the TeX processor (DVI vs PDFLaTeX) from document preamble or build config
• For each figure: record path, format, file size, dimensions (pixels or vector bounds)
• Flag missing figures, wrong-format figures, oversized figures

2. Analyze

For each figure, determine:

1. Format compliance — does the format match the processor?
2. File size — flag individual figures >2MB, total >15MB
3. Resolution — PNG/JPEG: flag >34 Megapixels (arXiv warning threshold since Feb 2026)
4. Content type — photograph vs diagram vs plot (determines optimal format)
5. Redundant metadata — PNG: ICC profiles, alpha channels, EXIF, interlacing
6. EPS efficiency — verbose PostScript from plotting programs (common with matplotlib, R, MATLAB)

3. Optimize

Apply transformations in order of impact:

Format Conversion (when format violates processor requirements)

# EPS → PDF (for PDFLaTeX)
epstopdf figure.eps
# or
ps2pdf -dEPSCrop figure.eps figure.pdf

# PDF/PNG/JPG → EPS (for DVI mode)
convert figure.png figure.eps

Size Reduction — Vector Figures

# Distill verbose EPS
eps2eps input.eps output.eps
# or convert to PDF
ps2pdf -dEPSCrop input.eps output.pdf

Size Reduction — Raster Figures

# Strip PNG metadata, remove alpha, optimize compression
convert input.png -strip -alpha remove -define png:compression-level=9 output.png

# Reduce oversized PNG resolution (keep ≤300 DPI at print size)
convert input.png -resize 3000x3000\> -strip output.png

# JPEG quality optimization (80-90 is visually lossless for most content)
convert input.jpg -quality 85 -strip output.jpg

# Downsample oversized JPEG
convert input.jpg -resize 3000x3000\> -quality 85 -strip output.jpg

PNG Optimization (avoid arXiv warnings)

• Remove palette indexing if unnecessary
• Remove alpha channel if background is solid
• Strip ICC color profiles
• Remove metadata chunks
• Disable interlacing

EPS BoundingBox Fix (prevents Missing number, treated as zero)

• Verify %%BoundingBox appears near top of file, not only at end
• If only %%BoundingBox: (atend), extract actual values and place at top

4. Update TeX Source

If figures were renamed or reformatted:

1. Update \includegraphics paths
2. Remove explicit extensions where possible (allows processor flexibility)
3. Verify \graphicspath settings if used

5. Verify

After optimization:

1. Attempt local compilation to verify all figures render
2. Compare visual output of optimized vs original figures
3. Report size reduction per figure and total

6. Report

# Figure Optimization Report

**Processor:** [detected]
**Total figures:** [count]
**Size before:** [total MB]
**Size after:** [total MB]
**Reduction:** [percentage]

## Changes Made

| Figure | Original | Optimized | Size Before | Size After | Action |
|--------|----------|-----------|-------------|------------|--------|
| fig1 | fig1.eps | fig1.pdf | 12.3 MB | 0.4 MB | EPS→PDF conversion |
| fig2 | fig2.png | fig2.png | 8.1 MB | 1.2 MB | Strip metadata, downsample |

## Warnings

[Any remaining issues — e.g., figures still above thresholds]

Tools Reference

| Tool | Install | Use Case | |------|---------|----------| | ImageMagick (convert) | System package | Format conversion, resizing, stripping | | Ghostscript (ps2pdf, eps2eps) | System package | EPS/PS optimization and conversion | | epstopdf | TeX Live | EPS → PDF conversion | | pdfcrop | TeX Live | Trim PDF whitespace | | optipng | System package | PNG lossless optimization | | pngquant | System package | PNG lossy size reduction | | jpegoptim | System package | JPEG lossless optimization |

Core Principles

• Never degrade visual quality below print-readable. Optimization means removing waste (metadata, unnecessary resolution, verbose encoding), not destroying information.
• Match format to processor. A figure in the wrong format blocks compilation. This is the highest priority fix.
• Preserve vector where possible. Converting vector to raster is a one-way quality loss. Only do this when the vector version is pathologically large (>10MB) and cannot be distilled.
• Report everything. The user decides which optimizations to accept. Show before/after sizes and explain each transformation.