انتقل إلى المحتوى

pgfplots في Scissor LaTeX

تعمل حزمة pgfplots في Scissor LaTeX لمعظم الرسوم ثنائية الأبعاد، ويرسمها مُصيِّر خاص بها: المحاور، والرسوم الخطية والمبعثرة والشريطية، والصيغ، والجداول وملفات CSV، والمحاور اللوغاريتمية، وأشرطة الخطأ، ووسائل الإيضاح، وgroupplots، وfill between، والخرائط الحرارية المنظورة من الأعلى؛ أما المناظر ثلاثية الأبعاد وaxis equal وجداول pgfplotstable فغير مدعومة بعد.

ماذا تفعل الحزمة

ترسم pgfplots رسومًا بيانية من البيانات أو الصيغ داخل رسم TikZ. تفتح \begin{tikzpicture}\begin{axis}[...]، وتضيف \addplot لكل سلسلة، فتختار pgfplots العلامات على المحاور ووسيلة الإيضاح والألوان. وتغطي خياراتها المحاور اللوغاريتمية والمخططات الشريطية وأشرطة الخطأ وخرائط الألوان وأكثر من ذلك بكثير.

لا يشغّل Scissor LaTeX حزمة pgfplots. يقرأ محرّك التنضيد الشيفرة نفسها ويرسم الرسم البياني بنفسه، رسومًا متجهية، مع التسميات بخطوط مستندك. وتتبع النتيجة الإعدادات الافتراضية لـ pgfplots عن قرب، ويُترجَم المصدر دون تغيير في تثبيت TeX.

ما الذي يعمل هنا

الميزةفي Scissor LaTeXالمزيد
axis مع التسميات والعنوان ووسيلة الإيضاح والشبكة والعلامات والمجالاتيعملأساسيات pgfplots
الخطوط والعلامات والألوان وقوائم الدورة وsmooth وconst plotيعملالرسوم الخطية
only marks ورسوم النقاط المبعثرةيعملرسوم النقاط المبعثرة
ybar وxbar والأشرطة المكدّسة وnodes near coords وsymbolic x coordsيعملالمخططات الشريطية
error bars/.cd, y explicit, +- (x, y)يعملأشرطة الخطأ
semilogyaxis, loglogaxis, xmode=logيعملالمحاور اللوغاريتمية
groupplot مع group style (مكتبة groupplots)يعملالرسوم المجمّعة
\addplot table من صفوف مكتوبة في المستند أو من ملف .csv/.dat في المشروعيعملالبيانات من CSV
\addplot3 مع view={0}{90}: surf وmatrix plot وcontour filled وcolorbarيعملالخطوط الكنتورية والخرائط الحرارية
fill between (مكتبة fillbetween) وname pathيعمل
\pgfplotsset{...} والأنماط وcompat=يعمليتصرف مثل compat=1.18، أيًّا كان الإعداد.
\addplot3 مع أي view آخر (ثلاثي الأبعاد حقًا)غير مدعوميُرسم محور فارغ، مع رسالة.
axis equalغير مدعوميُتجاهل مع رسالة؛ وتحتفظ المحاور بمقاييسها.
\pgfplotstabletypeset (pgfplotstable)غير مدعوميُتخطّى مع رسالة، ويُطبع اسم الملف.
الخيارات غير المعروفةيُحذفتُتجاهل مع رسالة تذكر الخيار؛ ويُرسم الباقي.

أمثلة

مخطط شريطي مع تسميات للقيم:

مخطط شريطي مع nodes near coords

\begin{tikzpicture}
  \begin{axis}[ybar, bar width=12pt, ymin=0, ymax=52,
      symbolic x coords={Mon,Tue,Wed,Thu}, xtick=data,
      nodes near coords, enlarge x limits=0.2,
      ylabel={Visitors}, width=7cm, height=5cm]
    \addplot coordinates {(Mon,31) (Tue,44) (Wed,38) (Thu,27)};
  \end{axis}
\end{tikzpicture}

سلسلتان تُقرآن من جدول مكتوب داخل المستند، مع وسيلة إيضاح:

أعمدة جدول مكتوب في المستند

\begin{tikzpicture}
  \begin{axis}[xlabel={Week}, ylabel={Hours of practice},
      legend pos=north west, width=7cm, height=5cm]
    \addplot table [x=week, y=erika] {
      week erika john
      1    4     2
      2    6     3
      3    5     5
      4    8     6
    };
    \addlegendentry{Erika}
    \addplot table [x=week, y=john] {
      week erika john
      1    4     2
      2    6     3
      3    5     5
      4    8     6
    };
    \addlegendentry{John}
  \end{axis}
\end{tikzpicture}

لا يُرسم بعد السطح المنظور بزاوية. يظهر المحور فارغًا، ويشرح تبويب «المشكلات» السبب:

المنظر ثلاثي الأبعاد لا يُرسم

\begin{tikzpicture}
  \begin{axis}[view={60}{30}, width=6cm]
    \addplot3[surf, domain=-2:2] {x^2 - y^2};
  \end{axis}
\end{tikzpicture}

تبويب المشكلات: 3D plots are drawn only when seen from above (view={0}{90}) for now

التوافق

  • من تثبيت TeX إلى هنا: تبدو معظم الرسوم ثنائية الأبعاد كما تبدو هناك، بفارق نقطة أو نقطتين. ويذكر تبويب «المشكلات» الرسوم ثلاثية الأبعاد الحقيقية وaxis equal والخيارات الواقعة خارج المجموعة المدعومة.
  • من هنا إلى تثبيت TeX: تُترجَم الرسوم هناك دون تغيير باستخدام pgfplots. ويحتاج contour lua وcontour gnuplot هناك إلى LuaLaTeX أو gnuplot؛ أما contour filled فلا يحتاج إلى أي منهما.

الدليل الكامل موجود على CTAN: ctan.org/pkg/pgfplots. وللرسومات دون محاور، راجع TikZ.

أسئلة وأجوبة

هل أحتاج إلى تثبيت pgfplots لاستخدامها هنا؟

لا. اكتب \usepackage{pgfplots} كالمعتاد؛ فيتعرّف Scissor LaTeX على الشيفرة ويرسم الرسم البياني في المتصفح.

لماذا رسمي ثلاثي الأبعاد فارغ؟

لا تُرسم حتى الآن إلا الرسوم المنظورة من الأعلى (view={0}{90}). أما المناظر الأخرى فتعطي محورًا فارغًا ورسالة في تبويب «المشكلات».

هل يمكنني رسم بيانات من ملف CSV؟

نعم. أضف الملف إلى المشروع واكتب \addplot table[x=a, y=b, col sep=comma] {file.csv};.

كل مثال في هذه الصفحة ينضّده Scissor LaTeX عند بناء الموقع. آخر تحديث: 2026-11-07.