学部生が LaTeX で書く最初の実験レポート

ゼロからコンパイルできるレポートまで。テンプレート、数式、図、参考文献、そして TeX Live を自分で管理しなくてもよいコンパイル手順。

実験レポートを仕上げるのに、LaTeX を極める必要はありません。必要なのは、テンプレートと、いくつかのコマンドと、初日から動くコンパイルボタンです。それ以外は、あとの授業で学位論文クラスの文書を求められたときまで待てます。

この記事は、完璧な組版よりもきれいな PDF を優先する、短い道筋です。

できれば数ギガバイトのインストールは省く

エンジンを同梱したデスクトップの研究向けエディタ (たとえば Oleafly (新しいタブで開きます)) なら、TeX Live を管理しなくても PDF にたどり着けます。テンプレート、エラーが出た行に表示されるエラーカード、クリックでジャンプできるソースの隣の PDF、そして別の Git の講義なしで使えるファイル履歴が揃っています。担当教員が特定のディストリビューションや Overleaf を指定している場合は、授業のノートに従ってください。そうでなければ、まず始められることを最優先にしましょう。

授業ですでにクラウドエディタを使っているなら、それでもかまいません。目標は期限までに PDF を出すことで、ツールチェーンにこだわることではありません。

骨組みを借りて、半分は削る

シンプルな article テンプレートから始めます。

\documentclass[11pt]{article}
\usepackage[margin=1in]{geometry}
\usepackage{amsmath,graphicx}
\begin{document}
\title{Lab 3: RC circuits}
\author{Your Name \and Lab Partner}
\date{Due date}
\maketitle
\section{Objective}
\section{Method}
\section{Results}
\section{Discussion}
\section{Conclusion}
\end{document}

詳しくは最初の PDF をコンパイルするとクイックリファレンスを参照してください。

評価基準が求めていないセクションは削除します。40 個のパッケージが並ぶ学位論文のプリアンブルを「念のため」コピーしないでください。余計なパッケージは、初心者が読めないエラーに遭遇する原因です。

教科書ではなく実験のための数式

文中の数式は $F = ma$ です。別行立ての数式は次のとおりです。

\[
v = v_0 + at
\]

あとで \eqref で引用するものにだけ番号を付けます。TA が不確かさを求めた場合は、まだ理解していない 10 行の align ではなく、文章か小さな表にします。分数は \frac{a}{b}、平方根は \sqrt{x} です。

コンパイルログに怖いことが書かれていても、直すのは最初のエラーだけにして、再コンパイルします。あとのエラーは、最初のエラーの副産物であることがよくあります。

図は 1 つ、しっかり作る

分析ツールからプロットを PDF か PNG でエクスポートします。次のように読み込みます。

\begin{figure}[htbp]
\centering
\includegraphics[width=0.85\textwidth]{plot.pdf}
\caption{Measured voltage vs time for trial 2.}\label{fig:vr}
\end{figure}

本文では Figure~\ref{fig:vr} shows... のように書きます。キャプションは図の下に置き、ラベルはキャプションの後に置きます。図が別のページに流れてしまうなら、配置オプションと 1 時間格闘する前に、幅を少し縮めてみてください。参考: フロートの配置。

苦労しない表

数行なら、シンプルな tabular で十分です。上にキャプションを付けるには、table と \caption を組み合わせます。TA がざっと見られるよう、数値は揃えます。最初の実験で出版レベルの booktabs は要りませんが、できれば縦罫線だらけの表は避けてください。

博士レベルの文献管理を使わない参考文献

引用が 3 つなら、手動の一覧で足ります。

\begin{thebibliography}{9}
\bibitem{textbook}
Author, \emph{Title}, year.
\end{thebibliography}

それより多いなら、Google Scholar や Zotero から .bib をエクスポートし、キーを短く読みやすいものに整えます。壊れた引用は [?] と表示されます。謎の引用マークを消すを参照してください。

実験マニュアルと教科書は、授業が求める形式 (IEEE、APA に近い形式、シンプルな番号付きリスト) で引用します。ジャーナルに合わせるより、評価基準に合わせるほうが大切です。

初心者によくあるエラー

  • \includegraphics の前に \usepackage{graphicx} を書き忘れる
  • % や _ などの特殊文字を、エスケープせずに文中で使う
  • $ の数式デリミタが対応していない
  • ファイル名に空白がある (my plot.pdf) ため、読み込みが壊れる
  • コンパイルしているのとは別のフォルダを編集している

落ち着いて、ログの最初の行を直し、再コンパイルしましょう。

PDF を提出し、ソースは手元に残す

LMS が求めるもの (通常は PDF) を提出します。.tex と図は、授業が終わっても残っているフォルダに保管してください。未来の自分が、次のレポートでこの骨組みを再利用します。エディタが自動で Git の履歴を残してくれるなら、さらによいです。正しい数式を消してしまう前の版を復元できます。

90 分の最初のセッション

今夜から始めるなら、次の順で進めます。

  1. テンプレートを開くか、上の骨組みを貼り付ける。
  2. タイトル、名前、評価基準にあるセクション見出しを埋める。
  3. すでに正しいと分かっている数式を 1 つ追加する。
  4. プロットを 1 つエクスポートし、読み込み、キャプションを付け、結果の節で引用する。
  5. 授業が求める形式で、参考文献を 2 つ追加する。
  6. PDF が白紙の article ではなくレポートに見えるまでコンパイルする。

評価基準を満たしたら止めます。パッケージのオプションに一晩を費やさないでください。

何かが壊れたとき

最初のエラーだけを読みます。よくある対処は、$ の欠落、グラフィックス用パッケージの欠落、ファイル名の間違い、余分な } です。大きな編集の前に、コンパイルできる版のコピーを保存しておくと、戻れます。クラスメートのプリアンブルが授業で動いているなら、学位論文用の一式ではなく、その人が使った最小限のパッケージを借りてください。

成功の目安

PDF が開き、余白が妥当に見え、図にキャプションがあり、数式が読みやすく、評価基準の項目に見出しが付いている。最初の LaTeX の実験レポートなら、それで十分です。組版の完璧さは、本当に必要な論文のためにとっておきましょう。

すべての投稿