PGFPlots Bar Charts & Histograms: LaTeX Guide

Data visualization is a cornerstone of effective technical communication, and LaTeX users have a powerful ally in PGFPlots. This package, built on top of TikZ, allows you to generate publication-quality plots directly within your LaTeX documents. In this guide, we'll explore how to create two fundamental chart types: bar charts and histograms. Whether you're preparing a scientific paper, a thesis, or a business report, mastering the pgfplots bar chart and tikz histogram will elevate your documents.

Why Use PGFPlots for Charts?

PGFPlots integrates seamlessly with LaTeX, ensuring that fonts, colors, and styles match your document perfectly. Unlike external image files, PGFPlots generates vector graphics, which scale beautifully without loss of quality. This makes it ideal for academic and professional settings where precision is key. Moreover, the learning curve is manageable, especially for common chart types like bar charts and histograms.

Getting Started: The Basics of PGFPlots

Before diving into specific chart types, ensure you have the necessary packages in your preamble:

\usepackage{pgfplots}
\pgfplotsset{compat=1.18}

This sets up PGFPlots with a recent compatibility mode. All plots are created within a tikzpicture environment or using the axis environment provided by PGFPlots.

Creating a Bar Chart with PGFPlots

Bar charts are excellent for comparing categorical data. In PGFPlots, you can create a latex bar graph using the ybar option. Let's start with a simple example.

Basic Bar Chart

Suppose you want to visualize the sales of different products. Here's how you can do it:

\begin{tikzpicture}
\begin{axis}[
    ybar,
    xlabel={Products},
    ylabel={Sales (units)},
    symbolic x coords={A, B, C, D},
    xtick=data,
    ymin=0,
    bar width=0.5cm,
]
\addplot coordinates {(A, 20) (B, 35) (C, 30) (D, 45)};
\end{axis}
\end{tikzpicture}

This code produces a basic bar chart. The ybar option activates vertical bars, and symbolic x coords allows you to use text labels on the x-axis. The xtick=data ensures ticks are placed at each data point.

Customizing Your Bar Chart

PGFPlots offers extensive customization. You can change colors, add error bars, or group multiple bars. For instance, to compare two sets of data side by side, use the ybar option with multiple \addplot commands and set bar shift or use ybar=2pt for spacing. Here's an example of a grouped bar chart:

\begin{tikzpicture}
\begin{axis}[
    ybar,
    bar width=0.4cm,
    symbolic x coords={A, B, C},
    xtick=data,
    ymin=0,
    legend style={at={(0.5,-0.2)}, anchor=north, legend columns=-1},
]
\addplot coordinates {(A, 20) (B, 35) (C, 30)};
\addplot coordinates {(A, 25) (B, 30) (C, 35)};
\legend{Product 1, Product 2}
\end{axis}
\end{tikzpicture}

This creates two bars per category, making comparisons easy. You can further customize colors using fill and draw options in the \addplot command.

Creating a Histogram with PGFPlots

Histograms are used to show the distribution of numerical data. In PGFPlots, you can create a tikz histogram by using the ybar interval option or by binning data manually. PGFPlots also provides a hist plot type for automatic binning.

Automatic Histogram

If you have a list of data points, you can let PGFPlots compute the bins for you:

\begin{tikzpicture}
\begin{axis}[
    ybar interval,
    xlabel={Value},
    ylabel={Frequency},
]
\addplot+[hist={bins=5}] table[row sep=\\] {
1 \\ 2 \\ 2 \\ 3 \\ 3 \\ 3 \\ 4 \\ 4 \\ 5 \\ 5 \\ 5 \\ 5 \\ 6 \\ 6 \\ 7 \\ 8 \\ 9 \\ 10 \\
};
\end{axis}
\end{tikzpicture}

This code creates a histogram with 5 bins. The hist key automatically calculates bin widths and frequencies. The ybar interval option ensures bars touch each other, as is typical for histograms.

Manual Binning

For more control, you can pre-bin your data and plot it as a bar chart with interval coordinates. This is useful when you have specific bin edges in mind. Use xbar interval or ybar interval and provide coordinates like (bin_start, frequency) (bin_end, frequency).

Advanced Tips and Tricks

• Styling: Use cycle list to define a sequence of styles for multiple plots, ensuring consistency across your document.
• Error Bars: Add error bars to your bar charts using the error bars/y dir=both option in \addplot.
• 3D Bar Charts: PGFPlots supports 3D bar charts with ybar in a 3D axis environment, though they should be used sparingly.
• External Data: Load data from CSV files using table and \addplot table to keep your LaTeX code clean.
• Legends: Customize legend placement and appearance with legend style.

Conclusion

PGFPlots is a versatile tool for creating high-quality bar charts and histograms in LaTeX. With the pgfplots ybar option and histogram capabilities, you can produce professional visualizations that integrate seamlessly with your documents. Practice with the examples provided, and explore the PGFPlots manual for even more customization. Happy plotting!