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 validationarxiv-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
\includegraphicscalls from all.texfiles - 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:
- Format compliance — does the format match the processor?
- File size — flag individual figures >2MB, total >15MB
- Resolution — PNG/JPEG: flag >34 Megapixels (arXiv warning threshold since Feb 2026)
- Content type — photograph vs diagram vs plot (determines optimal format)
- Redundant metadata — PNG: ICC profiles, alpha channels, EXIF, interlacing
- 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
%%BoundingBoxappears 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:
- Update
\includegraphicspaths - Remove explicit extensions where possible (allows processor flexibility)
- Verify
\graphicspathsettings if used
5. Verify
After optimization:
- Attempt local compilation to verify all figures render
- Compare visual output of optimized vs original figures
- 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.