Skip to main content

Python script for combining LaTeX figures composed of subfigures.

Project description

LaTeX Subfigs Combiner

Python script for combining LaTeX figures composed of subfigures


What

This package provides a simple Python script for combining LaTeX figures composed of subfigures into single PDF files, i.e. one PDF per composite figure.

Why

If you have ever tried to publish on scientific journals, you have probably encountered at least one journal that either does not accept LaTeX subfigures or will combine your composite figures during production with a very high chance of making a mess (both scenarios are completely unreasonable, but yet they happen sometimes). Of course, you really like those shiny composite LaTeX figures and do not want to waste time painstakingly stitching them together by hand (e.g. using Inkscape). This Python script provides an hands-free automated solution to this problem.

How

The job is done by parsing the given TeX file, extracting the preamble, setting the page style to empty, extracting the figure environments that contain subfigures, compiling to a PDF via latexmk, and then crop each figure to a separate PDF file using pdfcrop.


Installation

Easy peasy via pip or equivalent

pip install latex-subfigs-combiner

Usage

In a terminal, simply run combine-subfigs on your LaTeX main file

combine-subfigs /path/to/my/awesome/paper.tex

This will produce all the composite figures in a directory named composite-figures at the location you called the script from.

By default, the output figures will be named as fig_1.pdf, fig_2.pdf, etc. If you want to change the output directory or the filename prefix fig_ of the figures, you can use the optional arguments --target_dir and --prefix, respectively. Execute combine-subfigs -h for more details.


Tips are welcomed! :love_you_gesture:

If you found this useful, feel free to offer me a beer :beer: via PayPal or send me a few sats :zap:.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

latex-subfigs-combiner-1.0.0.tar.gz (5.0 kB view details)

Uploaded Source

Built Distribution

latex_subfigs_combiner-1.0.0-py3-none-any.whl (5.6 kB view details)

Uploaded Python 3

File details

Details for the file latex-subfigs-combiner-1.0.0.tar.gz.

File metadata

  • Download URL: latex-subfigs-combiner-1.0.0.tar.gz
  • Upload date:
  • Size: 5.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.4 CPython/3.6.9 Linux/5.4.0-54-generic

File hashes

Hashes for latex-subfigs-combiner-1.0.0.tar.gz
Algorithm Hash digest
SHA256 da3393b9e8e60668aed319a7e336054438197eac68529ae44fc5ba83763ec553
MD5 63aa3d5b0d9e4c6f85b4f20be3bebc0b
BLAKE2b-256 16bd993d80f25b5dcdd9ca9288eb8d2e1bc25ffda17602641d6362513636b15f

See more details on using hashes here.

File details

Details for the file latex_subfigs_combiner-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for latex_subfigs_combiner-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f8c72a7c5c0252d9fd1db22da3ee868bba639496a066cb356c91d1b335958e60
MD5 9336fd5e45f25a411dbb5fccf76b92a2
BLAKE2b-256 4754e9296d8249a1af17637ddfecba6f95d025c54278d91bb7a278a34c817a77

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page