handout-tips.pt-br.tex

\documentclass[10pt,landscape,a4paper]{article}
\usepackage[right=10mm, left=10mm, top=10mm, bottom=10mm]{geometry}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage[english]{babel}
\usepackage[rm,light]{roboto}
\usepackage{xcolor}
\usepackage{graphicx}
\graphicspath{{./figures/}}
\usepackage{multicol}
\usepackage{colortbl}
\usepackage{array}
\setlength\parindent{0pt}
\setlength{\tabcolsep}{2pt}
\baselineskip=0pt
\setlength\columnsep{1em}
\definecolor{Gray}{gray}{0.85}

% --- Listing -----------------------------------------------------------------
\usepackage{listings}
\lstset{
  frame=tb, framesep=4pt, framerule=0pt,
  backgroundcolor=\color{black!5},
  basicstyle=\ttfamily\footnotesize,
  commentstyle=\ttfamily\color{black!50},
  breakatwhitespace=false,
  breaklines=true,
  extendedchars=true,
  keepspaces=true,
  language=Python,
  rulecolor=\color{black},
  showspaces=false,
  showstringspaces=false,
  showtabs=false,
  tabsize=2,
  %
  emph = {
    plot, scatter, imshow, bar, contourf, pie, subplots, spines,
    add_gridspec, add_subplot, set_xscale, set_minor_locator, linestyle,
    dash_capstyle, projection, Stroke, Normal, add_axes, label, savefig,
    get_cmap, histtype, annotate, set_minor_formatter, tick_params,
    fill_betweenx, text, legend, errorbar, boxplot, hist, title, xlabel,
    ylabel, suptitle, fraction, pad, set_fontname, get_xticklabels},
  emphstyle = {\ttfamily\bfseries}
}

% --- Fonts -------------------------------------------------------------------
\usepackage{fontspec}
\usepackage[babel=true]{microtype}
\defaultfontfeatures{Ligatures = TeX, Mapping = tex-text}
\setsansfont{Roboto} [ Path           = fonts/roboto/Roboto-,
                       Extension      = .ttf,
                       UprightFont    = Light,
                       ItalicFont     = LightItalic,
                       BoldFont       = Regular,
                       BoldItalicFont = Italic ]
\setromanfont{RobotoSlab} [ Path           = fonts/roboto-slab/RobotoSlab-,
                            Extension      = .ttf,
                            UprightFont    = Light,
                            BoldFont       = Bold ]
\setmonofont{RobotoMono} [ Path           = fonts/roboto-mono/RobotoMono-,
                           Extension      = .ttf,
                           Scale          = 0.90,
                           UprightFont    = Light,
                           ItalicFont     = LightItalic,
                           BoldFont       = Regular,
                           BoldItalicFont = Italic ]
\renewcommand{\familydefault}{\sfdefault}

% -----------------------------------------------------------------------------
\begin{document}
\thispagestyle{empty}

\section*{\LARGE \rmfamily
          Matplotlib \textcolor{orange}{\mdseries dicas \& truques}}

\begin{multicols*}{3}


% -----------------------------------------------------------------------------
\subsection*{\rmfamily Transparência}

Gráficos de dispersão podem ser melhorados ao usar a transparência (alpha) para
mostrar uma área com maior densidade. Múltiplos gráficos de dispersão podem ser
usados para delinear uma fronteira.

\begin{tabular}{@{}m{.774\linewidth}m{.216\linewidth}}
\begin{lstlisting}[belowskip=-\baselineskip]
 X = np.random.normal(-1, 1, 500)
 Y = np.random.normal(-1, 1, 500)
 ax.scatter(X, Y, 50, "0.0", lw=2) # optional
 ax.scatter(X, Y, 50, "1.0", lw=0) # optional
 ax.scatter(X, Y, 40, "C1",  lw=0, alpha=0.1)
\end{lstlisting} &
\raisebox{-0.75em}{\includegraphics[width=\linewidth]{tip-transparency.pdf}}
\end{tabular}

% -----------------------------------------------------------------------------
\subsection*{\rmfamily Rasterização}
Se a sua figura tem muitos elementos gráficos, como um gráfico de dispersão
gigante, você pode rasterizá-los para salvar memória e manter outros elementos
em formato vetorial.
\begin{lstlisting}
 X = np.random.normal(-1, 1, 10_000)
 Y = np.random.normal(-1, 1, 10_000)
 ax.scatter(X, Y, rasterized=True)
 fig.savefig("rasterized-figure.pdf", dpi=600)
\end{lstlisting}

% -----------------------------------------------------------------------------
\subsection*{\rmfamily Renderização offline}

Use o backend Agg para renderizar a figura diretamente em um array.
\begin{lstlisting}
 from matplotlib.backends.backend_agg import FigureCanvas
 canvas = FigureCanvas(Figure()))
 ... # draw some stuff
 canvas.draw()
 Z = np.array(canvas.renderer.buffer_rgba())
\end{lstlisting}

% -----------------------------------------------------------------------------
\subsection*{\rmfamily Faixa contínua de cores}

Você pode usar um mapa de cor (colormap) para escolher de uma faixa de cores
contínuas.

\begin{tabular}{@{}m{.774\linewidth}m{.216\linewidth}}
\begin{lstlisting}[belowskip=-\baselineskip]
 X = np.random.randn(1000, 4)
 cmap = plt.get_cmap("Oranges")
 colors = cmap([0.2, 0.4, 0.6, 0.8])

 ax.hist(X, 2, histtype='bar', color=colors)
\end{lstlisting} &
\raisebox{-0.75em}{\includegraphics[width=\linewidth]{tip-color-range.pdf}}
\end{tabular}

% -----------------------------------------------------------------------------
\subsection*{\rmfamily Contorno de texto}
Use o contorno de texto para deixar o texto mais visível.

\begin{tabular}{@{}m{.774\linewidth}m{.216\linewidth}}
\begin{lstlisting}[belowskip=-\baselineskip]
 import matplotlib.patheffects as fx
 text = ax.text(0.5, 0.1, "Label")
 text.set_path_effects([
   fx.Stroke(linewidth=3, foreground='1.0'),
   fx.Normal()])
\end{lstlisting} &
\raisebox{-0.75em}{\includegraphics[width=\linewidth]{tip-outline.pdf}}
\end{tabular}


% -----------------------------------------------------------------------------
\subsection*{\rmfamily Plot multilinhas}
Você pode plotar várias linhas ao mesmo tempo usando None como separador.

\begin{lstlisting}
 X,Y = [], []
 for x in np.linspace(0, 10*np.pi, 100):
   X.extend([x, x, None]), Y.extend([0, sin(x), None])
 ax.plot(X, Y, "black")
\end{lstlisting}
\includegraphics[width=\linewidth]{tip-multiline.pdf}

% -----------------------------------------------------------------------------
\subsection*{\rmfamily Linhas pontilhadas}
Para obter linhas pontilhadas arredondadas, use o {\ttfamily linestyle}
customizado e modifique o {\ttfamily dash\_capstyle}.
\begin{lstlisting}
 ax.plot([0,1], [0,0], "C1",
        linestyle = (0, (0.01, 1)), dash_capstyle="round")
 ax.plot([0,1], [1,1], "C1",
        linestyle = (0, (0.01, 2)), dash_capstyle="round")
\end{lstlisting}
\includegraphics[width=\linewidth]{tip-dotted.pdf}

% -----------------------------------------------------------------------------
\subsection*{\rmfamily Eixos combinados}
Você pode usar eixos sobrepostos com diferentes projeções.

\begin{tabular}{@{}m{.774\linewidth}m{.216\linewidth}}
\begin{lstlisting}[belowskip=-\baselineskip]
 ax1 = fig.add_axes([0,0,1,1],
                    label="cartesian")
 ax2 = fig.add_axes([0,0,1,1],
                    label="polar",
                    projection="polar")
\end{lstlisting} &
\raisebox{-0.75em}{\includegraphics[width=\linewidth]{tip-dual-axis.pdf}}
\end{tabular}

\subsection*{\rmfamily Ajuste da barra de cores}
Você consegue ajustar o tamanho de uma barra de cores (colorbar) quando a
adiciona.

\begin{tabular}{@{}m{.754\linewidth}m{.236\linewidth}}
\begin{lstlisting}[belowskip=-\baselineskip]
 im = ax.imshow(Z)

 cb = plt.colorbar(im,
         fraction=0.046, pad=0.04)
 cb.set_ticks([])
\end{lstlisting} &
\raisebox{-0.75em}{\includegraphics[width=\linewidth]{tip-colorbar.pdf}}
\end{tabular}

\subsection*{\rmfamily Tirando vantagem da tipografia}
Você pode usar uma fonte condensada como a Roboto Condensed para salvar espaço
nos rótulos dos ticks.

\begin{lstlisting}
 for tick in ax.get_xticklabels(which='both'):
     tick.set_fontname("Roboto Condensed")
\end{lstlisting}
\includegraphics[width=\linewidth]{tip-font-family.pdf}

\subsection*{\rmfamily Se livrando das margens}
Uma vez que sua figura estiver pronta, você pode chamar {\ttfamily tight\_layout()}
para remover as margens brancas. Se houver alguma margem adicional, você pode
usar a utilidade do {\ttfamily pdfcrop} (vem com o TeX live).


\subsection*{\rmfamily Hachuras}
Você pode alcançar um efeito visual legal com padrões de hachuras.

\begin{tabular}{@{}m{.774\linewidth}m{.216\linewidth}}
\begin{lstlisting}[belowskip=-\baselineskip]
 cmap = plt.get_cmap("Oranges")
 plt.rcParams['hatch.color'] = cmap(0.2)
 plt.rcParams['hatch.linewidth'] = 8
 ax.bar(X, Y, color=cmap(0.6), hatch="/" )
\end{lstlisting} &
\raisebox{-0.75em}{\includegraphics[width=\linewidth]{tip-hatched.pdf}}
\end{tabular}


\subsection*{\rmfamily Leia a documentação}

Matplotlib tem uma documentação extensiva explicando os detalhes de cada comando
e é geralmente acompanhado por exemplos. Junto com uma galeria online gigante,
essa documentação é uma mina de ouro.

\vfill
%
{\scriptsize
  Matplotlib 3.5.0 handout for tips \& tricks.
  Copyright (c) 2021 Matplotlib Development Team.
  Released under a CC-BY 4.0 International License.
  Supported by NumFOCUS.
\par}



\end{multicols*}
\end{document}