% Manual of pgf-pie.sty, a convenient set of macros for drawing pie
% chart. Written by Xu Yuan <
[email protected]> This file is part of
% pgf-pie you may get it at
https://github.com/pgf-tikz/pgf-pie
\PassOptionsToPackage{%
colorlinks=true,
linkcolor=blue,
anchorcolor=black,
citecolor=olive,
filecolor=magenta,
menucolor=red,
urlcolor=blue
}{hyperref}
\documentclass{ltxdoc}
\usepackage{pgf-pie}
\usetikzlibrary{babel, shadows}
\usepackage[a4paper,left=2.25cm,right=2.25cm,top=2.5cm,bottom=2.5cm,nohead]{geometry}
\usepackage{calc}
\usepackage{graphicx}
\input{pgfmanual-en-macros.tex}
\pgfqkeys{/codeexample}{%
scale/.store in=\pgfpieexamplescale,
scale=1,
every codeexample/.style={%
width=.4\textwidth+7pt,
pre={
\setbox\codeexamplebox=\hbox\bgroup
},
post={
\egroup
\resizebox{\pgfpieexamplescale\textwidth}{!}{\box\codeexamplebox}%
},
},
}
\newcommand\pgfpiename{\texttt{pgf-pie}}
\begin{document}
\title{Drawing Pie Chart by using \pgfpiename}
\author{\href{mailto:
[email protected]}{Yuan Xu}}
\date{\today{}~(v0.7)}
\maketitle
\begin{abstract}
\pgfpiename\ is a LaTeX package for drawing pie chart (and
variant charts). As stated by its name, it is based on a very
popular graphic package \pgfname/\tikzname. This document presents
the usage of \pgfpiename\ and collects some pie charts as
examples. \pgfpiename\ can be downloaded from
\href{
https://github.com/pgf-tikz/pgf-pie}{
https://github.com/pgf-tikz/pgf-pie}.
\end{abstract}
\tableofcontents
\section{Usage}
\subsection{First Pie}
|\pie| is the only command that provided by
\pgfpiename. The argument is a list of number and text
combination in the formate of |number/text|, i.e. |10/A, 20/B, 30/C, 40/D|.
The result is shown in figure \ref{fig:first-pie}.
\begin{figure}
\centering
\codeexample[scale=0.25,from file={demo/first-pie.tex}]
\caption{The first pie.}
\label{fig:first-pie}
\end{figure}
\subsection{Position, Rotation, Size}
The center of chart can be set by |pos|, default is
|{0,0}|. The chart can be rotated by setting |rotate|
(in degrees). The size of chart can be set by |radius|, default
is 3.
\codeexample[scale=0.4,from file={demo/radius.tex}]
\subsection{Color}
The color can be specified by |color|, the default color wheel
is shown in figure \ref{fig:color-wheel}.
\begin{figure}
\centering
\input{demo/colorwheel}
\caption{Default color wheel}
\label{fig:color-wheel}
\end{figure}
\codeexample[scale=0.4,from file={demo/color.tex}]
\subsection{Explode}
\codeexample[scale=0.4,from file={demo/explode.tex}]
\subsection{Angle of slices}
The value of |sum| indicates the sum of all data in the chart,
it is 100 by default. It can be calculated automatically when
|auto| is set. Then the angle of slices are determined by
number value and |sum|.
\codeexample[scale=0.4,from file={demo/sum.tex}]
\subsection{Slice order}
The slices order direction can be set to clockwise by setting |change direction|, default is counterclockwise.
\codeexample[scale=0.4,from file={demo/change-direction.tex}]
\subsection{Text}
\subsubsection{Number}
Two parameters can be used to decorate number: |before number|
and |after number|. Both are empty by default, but if
|sum=100|, |after number| will be set to \%
automatically if user doesn't set it.
\codeexample[scale=0.25,from file={demo/before-after-number.tex}]
The number also can be hide by |hide number|:
\codeexample[scale=0.25,from file={demo/hide-number.tex}]
\paragraph{Scale font}
The size of font in size pie can be scaled according to how big the
part is automatically.
\codeexample[scale=0.25,from file={demo/scalefont.tex}]
\subsubsection{Label text}
The value of |text| can be |label| (default),
|pin|, |inside| or |legend|.
\codeexample[scale=0.25,from file={demo/text.tex}]
\codeexample[scale=0.25,from file={demo/text-inside.tex}]
\codeexample[scale=0.25,from file={demo/legend.tex}]
\subsection{More about style}
\subsubsection{shadow}
\codeexample[scale=0.25,from file={demo/shadow.tex}]
\section{Variant Charts}
\subsection{Polar area diagram}
The polar area diagram is similar to a usual pie chart, except sectors
are equal angles and differ rather in how far each sector extends from
the center of the circle.
\codeexample[scale=0.25,from file={demo/polar.tex}]
\subsection{Square}
\codeexample[scale=0.25,from file={demo/square.tex}]
Note: |explode| has no affects in square chart.
\subsection{Clouds}
\codeexample[scale=0.25,from file={demo/cloud.tex}]
\section{Examples}
% \subsection{Population of the world}
% \example{population}
\section{Acknowledgements}
Many people contributed to \pgfpiename\ by reporting problems,
suggesting various improvements or submitting code. Here is a list of
these people:
\href{mailto:
[email protected]}{Mohammed Alfaki},
and
\href{mailto:
[email protected]}{Lukas Drude}
