mathews-tom/armory/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

By Content Type

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

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.