arXiv Figure Optimizer

Purpose

• arxiv-preflight

  — full submission validation

• arxiv-package

  — tarball packaging

Format Rules

By Processor

.ps

.eps

.pdf

.png

.jpg

.pdf

.png

.jpg

.ps

.eps

By Content Type

Workflow

1. Inventory

• 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

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

# 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

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

# 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

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

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

1. Update

   \includegraphics

   paths
2. Remove explicit extensions where possible (allows processor flexibility)
3. Verify

   \graphicspath

   settings if used

5. Verify

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

convert

ps2pdf

eps2eps

epstopdf

pdfcrop

optipng

pngquant

jpegoptim

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.