スキップしてメイン コンテンツに移動

precompiled preambleを用意して，platexのタイプセットを高速化する

最近dynabook v713を使っていなかったので知人に譲り，これを元手にして，久々にwindowsのデスクトップPCを購入しました．所有しているMacbook Air (mid 2012)に比べてcpuの周波数が2倍，コア数も2倍になったけれど，platex+dvipdfmxによるタイプセットの速度は約60％速くなったくらいで，期待していたほどではありませんでした．TeXがシングルスレッドで動作するようなので，cpuのコア数は速度向上に寄与していないみたいです．

そこでLaTeXのタイプセット速度を向上させる方法がないか検索をしてみたら，
  • precompiled preambleを用意して，preambleの読み込み時間を短縮する．
  • tikzのexternalライブラリを用いて，tikzの絵をいったんpdf化し，それを読み込むことでtikzのタイプセット時間を短縮する．
という方法が見つかりました．

ここでは前者を紹介します．後者も試してみたのですが，可換図を描くライブラリであるtikz-cdのtikzcd環境と相性が悪いらしく，うまく行かなかったため断念しました．
追記：2021/09/19：以前はtikzのマニュアルにtikzcdとimcompatibleである旨が書いてあったと思うのですが，無くなっているようです．利用できるのかも．

precompiled preambleの作成
howtotex.comというブログの「Faster LaTeX part IV: Use a precompiled preamble」という記事でpreambleをprecompileする方法が紹介されています．まず，preambleを動的な部分と静的な部分に分けます．動的というのは，文章を書き上げる際に書き換えの頻度が高いという意味くらいに捉えておけばよいようです．例えば\includeonlyを使って部分タイプセットしているときは，書き換える頻度が高いので，動的と見なします．
preambleの静的な部分と静的な部分を\endofdumpで分けます．つまり，texファイルの\begin{document}よりも前の部分は次のようになります．

% 静的な部分
...
\endofdump
%動的な部分
...
\begin{document}
私はglossaries.styを使っていますが，\endofdumpより前に\usepackage{glossaries}があるとエラーが起きました．glossaries.styは動的な部分に配置してください．

以下ではtexファイルの名前が「mydoc.tex」であるとします．ターミナルを開いてmydoc.texのあるフォルダに移動し，
eptex -ini -jobname="mydoc" "&platex" mylatexformat.ltx mydoc.tex
と打ち込みます．するとmydoc.fmtというファイルが作成されます．このファイルをprecompiled preambleと言っているようです．元の記事では最初のeptexの部分がpdftexで，&platexの部分が&pdflatexになっています．最初のeptexの部分はplatexでも大丈夫でした．
最後に，フォーマットファイルmydoc.fmtを読み込むために，mydoc.texの最初の部分に%&mydocと記述します．
%&mydoc
...
\begin{document}
mydoc.fmtファイルを作った後はpreambleの静的な部分をコメントアウトしてもいいですし，そのままでもmydoc.fmyのほうを読みにいってくれます．静的な部分を独立したファイルにしてもいいみたいです．

私は上記のコマンドを覚えられそうにないので，シェルスクリプト化しました．

特にtikzを使っている場合は，tikzの関連ファイルの読み込みに時間がかかっていたので，短縮されました．MacBook Air (mid 2012 corei-7)でタイプセットに11秒かかっていた200ページくらいの文章が9.5秒くらいにはなりました．但し，あくまでもpreambleの読み込み速度を上げているだけなので，その分の時間短縮にしかならないようです．つまり本文が長くなっても短縮される時間に変わりはほとんどありませんでした．逆に本文が短くなればなるほど体感時間を速く感じると思われます．

preambleが肥大化している人は試してみるとよいのではないでしょうか．

ラベル

ラベル:

このブログの人気の投稿

OpenCv-PythonとpdfLaTeXで自炊pdfファイルの位置調整

この記事は TeX ＆ LaTeX Advent Calendar 2021 の11日目の記事です． 10日目は t_kemmochi さん，12日目は yukishita さんです．   動機  書籍の自炊にブックエッジスキャナーの AvisionのFB2280E を利用しています。書籍を裁断せずに1ページずつスキャンを行うため、本の開き具合などの要因で本の序盤、中盤、終盤で得られるスキャン画像の位置ずれが大きくなります。以前からpdfLaTeXを利用して位置調整をしていたのですが、OpenCvを利用して自動化できそうだったので試してみました。 やること 本記事では、pdf化した文書画像の版面（文字の印刷された部分の意味で使います）を半自動的に計算してpdfの画像の位置調整をするために、OpenCvとpdfLaTeXを利用する方法を解説します。手順としては Pythonの画像認識用ライブラリであるOpenCvを利用して版面を計算する。 テンプレートエンジンライブラリのJinja2を使って画像のバウンディングボックスなどを記述したLaTeXファイルを作成する。 pdfLaTeXでpdfを読み込み、位置の調整されたpdfを作成する。 という流れになっています。作業環境としては、 Visual Studio CodeをRemove - WSL拡張機能と併用 しています。PythonやそのライブラリはWSL上のUbuntuにインストールし、他にもpdfファイルを他のファイル形式にするためにpoppler-utilsなんかもインストールしました。 参考記事 OpenCvを利用した文書画像のレイアウト解析については ブログSomething Like Programming内の記事 Document Layout Analysis githubリポジトリ rbaguila/document-layout-analysis OpenCv-Pythonチュートリアル を参考にしました。 pdfLaTeXがpdf加工に使えるという話と、pdfpagesパッケージの存在は doraTeXさんのブログTeX Alchemist Onlineの記事 pdfTeX による見開きPDFの結合・分割 で知ったように思います。 画像pdfをpdfpagesで取り込む ま...
続きを読む

定理環境をmdframedからtcolorboxへ乗り換え

追記：2016/05/02 以前に掲載していた定理環境のマクロでは、カウンターが変化しないような記述をしてしまっていたので、全面的に書き換えました。 追記：2016/06/06 tcolorboxのオプションを追加できるように書き直しをしました( tcolorboxを使った定理環境 )。 LaTeXの話です。 これまで定理環境の修飾にmdframed.styを利用してきました。 mdframedを用いた定理環境の修飾(platex+dvipdfmx, tikz) しかし上の投稿で用いた記述をしていると、定理環境がページの下部にきたとき、まれに以下のように環境が新しいページに送られてしまい変なところで改ページが起こります。 TeX-LaTeX Stack Exchangeでも同様の不具合が報告されていて、mdframed.styの作者が回答して解決しているようなのですが、私の場合は上手く行きませんでした。タイトル部分の位置の計算に問題があるようです。 そういう訳で、mdframed.styよりも高い表現力を持つtcolorbox.styには興味を持っていました。今回は、mdframed.styで記述していた部分を、ソースの変更無しにtcolorboxで置き換えてみたので、その紹介をします。 tcolorbox.styで置き換えた結果は次のようになりました。 見た目はほとんど変わっていません。中のboxは別のtcolorbox環境です。 この定理環境のソースコードは次のようになります。 \usepackage{tcolorbox} \usepackage{varwidth} \tcbuselibrary{breakable} \tcbuselibrary{skins} \definecolor{frameinnercolor}{RGB}{49,44,44} \newcounter{theorem} \numberwithin{theorem}{section}% numberwithinはamsmath.styで定義されている \newenvironment{theorem}[2][]{% %#1 = タイトル,　#2 = 定理環境名 \refstepcounter{theorem}% \newtcolorbox{...
続きを読む

定理を再掲したときに定理番号も揃える（amsmathのtagと似た挙動の定理環境を作る）．

LaTeXの話題です．amsmath.styで定義されているtagコマンドは，数式環境の式番号部分を自由な文字列で置き換えることができるようになっています．下に例を挙げます． この画像を生成するLaTeXのコードは次のようになります． \documentclass[a4paper,dvipdfmx,uplatex]{jsarticle} \usepackage[dvipdfmx,bookmarks=true,bookmarksnumbered=true,% ,colorlinks=true,linkcolor=blue]{hyperref}% \usepackage{showkeys} \usepackage{amsmath} \numberwithin{equation}{section} Unknown environment 'document' 最初のequation環境にeq:eulerというlabelをつけ，第2のequation環境ではtagコマンドを使って数式番号部分に¥ref{eq:euler}と書くことで，実際に表示される式番号が第1のequation環境のものと同じになっています．この第2のequation環境にはeq:euler2というlabelを付けており，これを¥eqref{eq:euler2}と参照すると表示される番号は第1のequation環境のものであるにも関わらず，リンクをクリックすると第2のequation環境にジャンプします． このような現象が起こるのは，上記のファイルをタイプセット...
続きを読む