matplot2tikz

นี่คือ matplot2tikz เครื่องมือ Python สำหรับแปลงกราฟ matplotlib ให้เป็น PGFPlots (PGF/TikZ) รูปภาพ เช่น

เพื่อการนำเข้าโดยตรงในเอกสาร LaTeX หรือ ConTeXt

ผลลัพธ์ของ matplot2tikz อยู่ในรูปแบบ PGFPlots, ซึ่งเป็นไลบรารี TeX ที่พัฒนาต่อจาก PGF/TikZ และ ใช้ในการอธิบายกราฟในรูปแบบแกน ข้อมูล ฯลฯ ดังนั้น ผลลัพธ์ของ matplot2tikz

• รักษาข้อมูลไว้ได้มากขึ้น,
• เข้าใจได้ง่ายกว่า, และ
• แก้ไขได้ง่ายกว่า

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}

(ใช้ get_tikz_code() แทน save() หากคุณต้องการโค้ดเป็นสตริง)

การปรับแต่งกราฟทำได้ง่ายและสามารถทำได้เป็นส่วนหนึ่งของขั้นตอนการทำงาน TeX ของคุณ คู่มือ PGFPlots ที่ยอดเยี่ยม มีตัวอย่าง ดีๆ มากมายเกี่ยวกับวิธีทำให้กราฟของคุณดูดีขึ้นกว่าเดิม

แน่นอนว่าไม่ใช่ภาพทุกประเภทที่สร้างโดย matplotlib จะสามารถแปลงได้โดยไม่มีข้อผิดพลาด โดยเฉพาะ กราฟ 3D ใช้งานไม่ได้

การติดตั้ง

matplot2tikz มี ให้ดาวน์โหลดจาก Python Package Index ดังนั้นเพียงแค่ทำ

pip install matplot2tikz

การใช้งาน

• สร้างกราฟ matplotlib ของคุณตามปกติ
• แทนที่จะใช้ pyplot.show() ให้เรียกใช้ matplot2tikz โดย

matplot2tikz.save("mytikz.tex") # or matplot2tikz.save("mytikz.tex", flavor="context") ` เพื่อบันทึกไฟล์ TikZ เป็น mytikz.tex

• เพิ่มเนื้อหาของ mytikz.tex ลงในซอร์สโค้ด TeX ของคุณ วิธีที่สะดวกวิธีหนึ่งคือโดยใช้

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

นอกจากนี้โปรดตรวจสอบให้แน่ใจว่าแพ็กเกจสำหรับ PGFPlots และการรองรับ Unicode อย่างถูกต้อง ถูกเพิ่มไว้ในส่วนหัวของเอกสารของคุณ:

`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} ` คุณยังสามารถรับโค้ดได้ผ่านทาง:

`python import matplot2tikz

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

• [ตัวเลือก] ทำความสะอาดรูปภาพก่อนส่งออกไปยัง tikz โดยใช้คำสั่ง clean_figure

matplot2tikz.clean_figure() matplot2tikz.save("test.tex") ` คำสั่งนี้จะลบจุดที่อยู่นอกขอบเขตแกน, ทำใหเส้นโค้งง่ายขึ้น และลดความหนาแน่นของจุดตามความละเอียดเป้าหมายที่ระบุ

matplot2tikz vs. tikzplotlib

ไลบรารี matplot2tikz นี้มีต้นกำเนิดจากโปรเจกต์ tikzplotlib เหตุผลที่มีการสร้างไลบรารีใหม่ เนื่องจาก tikzplotlib ไม่มีการดูแลต่อเนื่องและ การดูแลสามารถทำได้โดยเจ้าของเดียวของไลบรารี tikzplotlib เท่านั้น หากคุณจำเป็นต้องใช้โค้ดจากบุคคลที่สามที่พึ่งพา tikzplotlib อยู่แล้ว ขอแนะนำให้เปลี่ยน การพึ่งพา tikzplotlib เป็น matplot2tikz หากไม่สามารถทำได้ วิธีแก้ไขชั่วคราวคือใส่โค้ดต่อไปนี้ ก่อน การนำเข้าโค้ดจากบุคคลที่สาม:

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

การมีส่วนร่วม

หากคุณพบข้อบกพร่อง ต้องการมีส่วนร่วม มีตัวอย่างที่ดีของสิ่งที่ matplot2tikz สามารถทำได้ หรือหากคุณกำลังมองหาข้อมูลเพิ่มเติม โปรดเยี่ยมชม หน้าของ matplot2tikz บน GitHub

สำหรับการมีส่วนร่วม กรุณาทำตามขั้นตอนเหล่านี้:

• ดาวน์โหลดที่เก็บ git ตัวอย่างเช่นโดยใช้

• สร้าง virtual environment ตัวอย่างเช่นโดยใช้ python -m venv venv
• เปิดใช้งาน virtual environment (ตัวอย่างเช่นบน Windows, venv\Scripts\activate)
• ติดตั้ง uv โดยใช้ pip install uv และจากนั้น tox-uv โดยใช้ uv pip install tox-uv
• สาขาหลักถูกป้องกัน หมายความว่าคุณไม่สามารถ push การเปลี่ยนแปลงไปยังสาขานี้ได้โดยตรง

• ก่อน push การเปลี่ยนแปลง ให้แน่ใจว่าโค้ดเป็นไปตามกฎการจัดรูปแบบและทดสอบสำเร็จ ให้รัน tox ซึ่งจะตรวจสอบรูปแบบและรันทดสอบทั้งหมด หากต้องการทำขั้นตอนเหล่านี้ด้วยตนเอง ให้ใช้คำสั่งต่อไปนี้:
• รัน tox -e lint คุณสามารถรันคำสั่ง linting ด้วยตนเองได้โดยใช้:
• (ครั้งเดียว) uv pip install -r requirements-lint.txt
• ruff format . --check (ลบ flag --check หากต้องการให้ ruff จัดรูปแบบให้เอง)
• ruff check .
• mypy .
• รัน tox -e py310
• รัน tox -e py311
• รัน tox -e py312
• รัน tox -e py313
• รัน tox -e py314
• รัน tox -e combine-test-reports
• ตรวจสอบว่าการทดสอบครอบคลุมทุกอย่างแล้วโดยใช้รายงาน coverage ที่

• ส่งการเปลี่ยนแปลงขึ้น GitHub หากทุกอย่างเรียบร้อยและคุณต้องการ merge การเปลี่ยนแปลงไปยังสาขา main

โปรดทราบว่าปัจจุบันเฉพาะ "เจ้าของโค้ด" เท่านั้นที่สามารถรวม pull request เข้าสู่สาขา main` ได้ สิ่งนี้เพื่อ ป้องกันไม่ให้ทุกคนสามารถทำให้โค้ดหลักเสียหาย (ถึงแม้จะไม่ได้ตั้งใจก็ตาม) หากคุณต้องการเป็น "เจ้าของโค้ด" แจ้งให้เราทราบได้เลย!

ใบอนุญาต

matplot2tikz เผยแพร่ภายใต้ สัญญาอนุญาต MIT license.

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