matplot2tikz

Este é o matplot2tikz, uma ferramenta Python para converter figuras do matplotlib em PGFPlots (PGF/TikZ) figuras como

para inclusão nativa em documentos LaTeX ou ConTeXt.

A saída do matplot2tikz está em PGFPlots, uma biblioteca TeX que se baseia no PGF/TikZ e descreve gráficos em termos de eixos, dados, etc. Consequentemente, a saída do matplot2tikz

• retém mais informações,
• pode ser mais facilmente compreendida, e
• é mais facilmente editável

import matplotlib.pyplot as plt
import numpy as np
plt.style.use("ggplot")
t = np.arange(0.0, 2.0, 0.1)
s = np.sin(2  np.pi  t)
s2 = np.cos(2  np.pi  t)
plt.plot(t, s, "o-", lw=4.1)
plt.plot(t, s2, "o-", lw=4.1)
plt.xlabel("time (s)")
plt.ylabel("Voltage (mV)")
plt.title("Simple plot $\\frac{\\alpha}{2}$")
plt.grid(True)
import matplot2tikz
matplot2tikz.save("test.tex")

--> (see above) gives

\begin{tikzpicture}
\definecolor{chocolate2267451}{RGB}{226,74,51}
\definecolor{dimgray85}{RGB}{85,85,85}
\definecolor{gainsboro229}{RGB}{229,229,229}
\definecolor{steelblue52138189}{RGB}{52,138,189}
\begin{axis}[
axis background/.style={fill=gainsboro229},
axis line style={white},
tick align=outside,
tick pos=left,
title={Simple plot \(\displaystyle \frac{\alpha}{2}\)},
x grid style={white},
xlabel=\textcolor{dimgray85}{time (s)},
xmajorgrids,
xmin=-0.095, xmax=1.995,
xtick style={color=dimgray85},
y grid style={white},
ylabel=\textcolor{dimgray85}{Voltage (mV)},
ymajorgrids,
ymin=-1.1, ymax=1.1,
ytick style={color=dimgray85}
]
\addplot [line width=1.64pt, chocolate2267451, mark=*, mark size=3, mark options={solid}]
table {%
0 0
% [...]
1.9 -0.587785252292473
};
\addplot [line width=1.64pt, steelblue52138189, mark=*, mark size=3, mark options={solid}]
table {%
0 1
% [...]
1.9 0.809016994374947
};
\end{axis}
\end{tikzpicture}

(Use get_tikz_code() em vez de save() se você quiser o código como uma string.)

Ajustar o gráfico é simples e pode ser feito como parte do seu fluxo de trabalho TeX. O fantástico manual do PGFPlots contém excelentes exemplos de como deixar seu gráfico ainda melhor.

Claro, nem todas as figuras produzidas pelo matplotlib podem ser convertidas sem erro. Notavelmente, gráficos 3D não funcionam.

Instalação

matplot2tikz está disponível no Python Package Index, então simplesmente faça

pip install matplot2tikz

para instalar.

Uso

• Gere seu gráfico matplotlib normalmente.
• Em vez de pyplot.show(), invoque o matplot2tikz usando

matplot2tikz.save("mytikz.tex") # or matplot2tikz.save("mytikz.tex", flavor="context") `

para armazenar o arquivo TikZ como mytikz.tex.

• Adicione o conteúdo de mytikz.tex ao seu código fonte TeX. Uma maneira conveniente de fazer

`latex \input{/path/to/mytikz} `

Certifique-se também de que os pacotes para PGFPlots e o suporte adequado a Unicode estejam incluídos no cabeçalho do seu documento:

`latex \usepackage[utf8]{inputenc} \usepackage{pgfplots} \DeclareUnicodeCharacter{2212}{−} \usepgfplotslibrary{groupplots,dateplot} \usetikzlibrary{patterns,shapes.arrows} \pgfplotsset{compat=newest} `

or:

`latex \setupcolors[state=start] \usemodule[tikz] \usemodule[pgfplots] \usepgfplotslibrary[groupplots,dateplot] \usetikzlibrary[patterns,shapes.arrows] \pgfplotsset{compat=newest} \unexpanded\def\startgroupplot{\groupplot} \unexpanded\def\stopgroupplot{\endgroupplot} `

Você também pode obter o código através de:

`python import matplot2tikz

matplot2tikz.Flavors.latex.preamble() # or matplot2tikz.Flavors.context.preamble() `

• [Opcional] Limpe a figura antes de exportar para tikz usando o comando clean_figure.

matplot2tikz.clean_figure() matplot2tikz.save("test.tex") ` O comando removerá pontos que estão fora dos limites dos eixos, simplificará curvas e reduzirá a densidade de pontos para a resolução alvo especificada.

matplot2tikz vs. tikzplotlib

Esta biblioteca matplot2tikz se originou do projeto tikzplotlib. O motivo para a criação de uma nova biblioteca é que o tikzplotlib não é mais mantido e a manutenção só poderia ser feita pelo único proprietário da biblioteca tikzplotlib. Se você precisa usar código de terceiros que já depende do tikzplotlib, sugere-se alterar a dependência de tikzplotlib para matplot2tikz. Se isso não for possível, uma solução alternativa é colocar o seguinte código antes de importar o código de terceiros:

` import sys import matplot2tikz sys.modules["tikzplotlib"] = matplot2tikz # Do other imports, e.g., using import my_third_party_library # If tikzplotlib is used in this library, it will automatically use matplot2tikz instead. `

Contribuindo

Se você encontrar bugs, quiser contribuir, tiver bons exemplos do que o matplot2tikz pode fazer, ou se estiver apenas procurando por mais informações, então por favor visite a página do matplot2tikz no GitHub.

Para contribuir, siga estes passos:

• Baixe o repositório git, por exemplo, usando

• Crie um ambiente virtual, por exemplo, usando python -m venv venv.
• Ative o ambiente virtual (por exemplo, no Windows, venv\Scripts\activate).
• Instale uv usando pip install uv e depois tox-uv usando uv pip install tox-uv.
• O branch principal está protegido, o que significa que você não pode enviar mudanças diretamente para este branch.

• Execute tox -e lint. Você pode executar os comandos de linting manualmente usando:
• (Uma vez) uv pip install -r requirements-lint.txt
• ruff format . --check (remova a flag --check para deixar o ruff fazer a formatação)
• ruff check .
• mypy .
• Execute tox -e py310.
• Execute tox -e py311.
• Execute tox -e py312.
• Execute tox -e py313.
• Execute tox -e py314.
• Execute tox -e combine-test-reports
• Verifique se os testes cobriram tudo usando o relatório de cobertura em

• Envie as mudanças para o GitHub. Se tudo estiver OK e você quiser mesclar suas mudanças para o branch main,

Observe que atualmente apenas "Code owners" podem fazer merge de pull requests no branch main`. Isso é para garantir que nem todos possam quebrar o código principal (mesmo que sem querer). Se você quiser ser um "Code owner", avise-nos!

Licença

matplot2tikz é publicado sob a licença MIT.

--- Tranlated By Open Ai Tx | Last indexed: 2025-12-11 ---