matplot2tikz

Đây là matplot2tikz, một công cụ Python dùng để chuyển đổi các hình vẽ matplotlib thành các hình PGFPlots (PGF/TikZ) như

để nhúng trực tiếp vào các tài liệu LaTeX hoặc ConTeXt.

Đầu ra của matplot2tikz là ở dạng PGFPlots, một thư viện TeX dựa trên PGF/TikZ và mô tả biểu đồ dưới dạng các trục, dữ liệu, v.v. Do đó, đầu ra của matplot2tikz

• giữ lại nhiều thông tin hơn,
• dễ hiểu hơn,
• và dễ chỉnh sửa hơn

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}

(Hãy sử dụng get_tikz_code() thay vì save() nếu bạn muốn lấy mã dưới dạng chuỗi.)

Việc điều chỉnh biểu đồ rất đơn giản và có thể thực hiện như một phần trong quy trình làm việc với TeX. Hướng dẫn tuyệt vời về PGFPlots chứa nhiều ví dụ tuyệt vời về cách làm cho biểu đồ của bạn trông đẹp hơn nữa.

Tất nhiên, không phải tất cả các hình được tạo bằng matplotlib đều có thể chuyển đổi mà không gặp lỗi. Đáng chú ý, biểu đồ 3D không hoạt động.

Cài đặt

matplot2tikz có sẵn trên Python Package Index, vì vậy chỉ cần thực hiện

pip install matplot2tikz

Cách sử dụng

• Tạo biểu đồ matplotlib của bạn như bình thường.
• Thay vì sử dụng pyplot.show(), hãy gọi matplot2tikz bằng cách

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

để lưu tệp TikZ dưới tên mytikz.tex.

• Thêm nội dung của mytikz.tex vào mã nguồn TeX của bạn. Một cách tiện lợi để làm điều này là thông qua

`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} `

Bạn cũng có thể lấy mã thông qua:

`python import matplot2tikz

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

• [Tùy chọn] Làm sạch hình trước khi xuất ra tikz bằng lệnh clean_figure.

matplot2tikz.clean_figure() matplot2tikz.save("test.tex") ` Lệnh này sẽ loại bỏ các điểm nằm ngoài giới hạn trục, đơn giản hóa các đường cong và giảm mật độ điểm cho độ phân giải mục tiêu đã chỉ định.

matplot2tikz vs. tikzplotlib

Thư viện matplot2tikz này bắt nguồn từ dự án tikzplotlib. Lý do tạo ra một thư viện mới là vì tikzplotlib không còn được duy trì và việc duy trì chỉ có thể thực hiện bởi chủ sở hữu duy nhất của thư viện tikzplotlib. Nếu bạn cần sử dụng mã của bên thứ ba đã phụ thuộc vào tikzplotlib, đề xuất là thay đổi phụ thuộc tikzplotlib thành matplot2tikz. Nếu điều này không khả thi, một cách xử lý là đặt đoạn mã sau trước khi nhập mã của bên thứ ba:

` 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. `

Đóng góp

Nếu bạn gặp lỗi, muốn đóng góp, có những ví dụ hay về những gì matplot2tikz có thể làm được, hoặc chỉ đơn giản là muốn tìm thêm thông tin, hãy truy cập trang GitHub của matplot2tikz.

Để đóng góp, hãy làm theo các bước sau:

• Tải về kho git, ví dụ sử dụng

• Tạo môi trường ảo, ví dụ dùng python -m venv venv.
• Kích hoạt môi trường ảo (ví dụ trên Windows, venv\Scripts\activate).
• Cài đặt uv bằng pip install uv và sau đó tox-uv bằng uv pip install tox-uv.
• Nhánh main được bảo vệ, tức là bạn không thể đẩy trực tiếp các thay đổi lên nhánh này.

• Chạy tox -e lint. Bạn có thể thực hiện các lệnh linting thủ công như sau:
• (Một lần) uv pip install -r requirements-lint.txt
• ruff format . --check (bỏ cờ --check để cho ruff tự động định dạng)
• ruff check .
• mypy .
• Chạy tox -e py310.
• Chạy tox -e py311.
• Chạy tox -e py312.
• Chạy tox -e py313.
• Chạy tox -e py314.
• Chạy tox -e combine-test-reports
• Kiểm tra xem các kiểm thử đã bao phủ tất cả chưa bằng báo cáo coverage tại

• Đẩy thay đổi lên GitHub. Nếu mọi thứ đã ổn và bạn muốn gộp thay đổi vào nhánh main,

Lưu ý rằng hiện tại chỉ những "Chủ sở hữu mã" mới có thể hợp nhất các pull request vào nhánh main`. Điều này nhằm đảm bảo rằng không phải ai cũng có thể làm hỏng mã nguồn chính (ngay cả khi vô ý). Nếu bạn muốn trở thành "Chủ sở hữu mã", hãy cho chúng tôi biết!

Giấy phép

matplot2tikz được phát hành theo giấy phép MIT.

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