figure-drawing

Academic Figure Drawing

CRITICAL RULES (read first)

1. NEVER inline TikZ code into paper sections. No \begin{tikzpicture} inside sections/*.tex or main.tex.
2. NEVER \input{figures/xxx.tex} a raw .tex file. The paper must use \includegraphics.
3. Every figure = standalone .tex → compile → PDF/PNG → \includegraphics.
4. Always compile and verify the standalone figure before inserting into the paper.

SOP

Step 1: Plan the figure

Before writing any code, decide:

• Type: taxonomy tree, architecture diagram, flowchart, bar/line chart, comparison table, timeline
• Content: what nodes/elements to show (read the relevant paper sections first)
• Layout direction: top-to-bottom or left-to-right (pick whichever avoids crowding)
• Estimated element count: if > 20 nodes, split into multiple figures

Step 2: Write the TikZ source

Write a standalone .tex file in figures/:

\documentclass[tikz,border=10pt]{standalone}
\usepackage[T1]{fontenc}
\usepackage{tikz}
\usetikzlibrary{positioning, arrows.meta, shapes, fit, backgrounds}
% Add other libraries as needed

\begin{document}
\begin{tikzpicture}[...]
  % figure content
\end{tikzpicture}
\end{document}

Step 3: Compile to PDF, then convert to PNG

cd figures/
pdflatex -interaction=nonstopmode xxx.tex
# Convert PDF to PNG (try available tools in order)
pdftoppm -png -r 300 xxx.pdf xxx_fig  # produces xxx_fig-1.png
# OR: convert xxx.pdf -density 300 xxx.png
# OR: sips -s format png xxx.pdf --out xxx.png  (macOS)

If pdftoppm / convert / sips are all unavailable, keep the PDF and use \includegraphics{figures/xxx.pdf} as fallback.

Step 4: Insert into paper

\begin{figure}[t]
  \centering
  \includegraphics[width=\columnwidth]{figures/xxx.png}
  \caption{Descriptive caption.}
  \label{fig:xxx}
\end{figure}

Step 5: Visual check

After compiling the full paper, verify the figure renders correctly and is referenced in the text with \ref{fig:xxx}.