يوضّح هذا المستند طريقة إنشاء مخططات دائرية باستخدام Chart API.

جدول المحتويات

نظرة عامة

تعد المخططات الدائرية جيدة لعرض معلومات نسبية بسيطة وكاملة. يمكنك إنشاء رسم بياني دائري لسلسلة واحدة، حيث تتكون كل سلسلة من شرائح متعددة أو رسوم بيانية متحدة المركز من سلاسل متعددة.

تصف كل سلسلة مخطط دائري واحد، وتحدد كل قيمة بيانات شريحة واحدة. وعند استخدام الرسوم البيانية الدائرية المدمجة (الموضّحة أدناه)، استخدِم سلاسل متعددة.

لعرض النص المرتبط بشريحة، يجب استخدام تصنيفات الرسوم البيانية الدائرية أو وسيلة الإيضاح للرسم البياني. تصنيفات الرسوم البيانية الدائرية هي نص يحيط بالرسم البياني مع خطوط تشير إلى الشريحة. وسائل الإيضاح هي نصوص مرتبطة باللون.

التصنيفات	وسيلة الإيضاح	التسميات والتسمية التوضيحية
chl=January|February|March|April	chdl=January|February|March|April	chl=January|February|March|April chdl=30°|40°|50°|60°

يتم عرض القيم بالنسبة إلى بعضها بعضًا، وبالتالي فإنّ الرسم البياني الذي يحتوي على القيم 1,2,3 سيظهر بالشكل نفسه الذي يظهر به الرسم البياني بقيمة 100,200,300. ومع ذلك، عند استخدام بيانات تنسيق نصي، يتم اختصار القيم الأكبر من 100 لتصبح 100، وبالتالي ستحتاج إلى استخدام تنسيق نص مع تحجيم مخصّص لعرض الشرائح الأكبر من 100 بشكل صحيح (استخدِم المَعلمة chds مع قيم الحدّ الأدنى/الأقصى للسمة chds=0,<max-slice-size>).

يتم عرض القيم السلبية كشرائح فارغة بالحجم المناسب.

أنواع الرسوم البيانية

تتوفر ثلاثة أنواع عامة من الرسوم البيانية الدائرية التي يمكنك إنشاؤها: مسطّحة أو متحدة المركز أو ثلاثية الأبعاد. حدد مخططًا دائريًا بالبنية التالية:

البنية

cht=<chart_type>

حيث يكون <chart_type> أحد الأنواع التالية:

المَعلمة	الوصف	مثال
p	مخطط دائري ثنائي الأبعاد. أدخِل سلسلة بيانات واحدة فقط، ويتم تجاهل سلسلة البيانات اللاحقة. بشكل تلقائي، يتم إدراج ألوان الأجزاء الدائرية من البرتقالي الداكن إلى الأصفر الباهت. حدِّد الألوان الأخرى كما هو موضّح في ألوان السلسلة. حدِّد التصنيفات باستخدام chl كما هو موضّح في تصنيفات الرسوم البيانية الدائرية. تحسب Google Chart API نصف قطر الدائرة من الحد الأدنى للعرض والارتفاع المحددَين في معلَمة حجم الرسم البياني (chs). إذا أردت تضمين تصنيفات، قد تحتاج على الأرجح إلى تحديد حجم العرض ليكون ضعف حجم الارتفاع، لضمان أن تكون التصنيفات مرئية بالكامل.	cht=p chs=200x100
p3	مخطط دائري ثلاثي الأبعاد. حدِّد البيانات والتنسيق بالطريقة نفسها المستخدَمة في الرسوم البيانية الدائرية الثنائية الأبعاد أعلاه. إذا أردت تضمين تصنيفات في رسم بياني دائري ثلاثي الأبعاد، قد تحتاج على الأرجح إلى تحديد حجم العرض ليكون 2.5 مرة أكبر من حجم الارتفاع، لضمان أن تكون التصنيفات مرئية بالكامل.	cht=p3 chs=250x100
pc	مخطط دائري متحد المركز. أدخِل سلسلتَي بيانات أو أكثر.	cht=pc chd=s:Helo,Wrld
جميع الأنواع	تؤدّي الأرقام السالبة في البيانات إلى استخدام شرائح "فارغة".	cht=pc chd=t: 10,-10,10,-10| 5,-5,5,-5,5,-5,5,-5,5,-5

 

ألوان السلسلة chco

يمكنك تحديد ألوان جميع القيم أو كل قيمة أو بعض القيم باستخدام المعلَمة chco.

البنية

chco=<slice_1>|<slice_2>|<slice_n>,<series_color_1>,...,<series_color_n>

<color>

شرائح ألوان الشرائح بتنسيق RRGGBB السداسي العشري: حدِّد لونًا لسلسلة واحدة، وسيتم تلوين جميع الشرائح في هذه السلسلة بتدرجات اللون من أغمق (عضو البيانات الأول) إلى الأفتح (آخر عضو في البيانات). حدِّد لونين أو أكثر مفصولين بعلامة | لوصف ألوان الشرائح الفردية. عندما يكون لديك عدة سلاسل (أي رسم بياني يحتوي على حلقات متحدة المركز)، يمكنك تحديد قيم لسلاسل مختلفة عن طريق فصل القيم بفاصلة. عند تحديد عدد أقل من ألوان الشرائح/السلاسل مقارنةً بالشرائح/السلسلة المعروضة، سينتقل الرسم البياني من بداية قائمة الشرائح للسلسلة أو قائمة السلاسل للرسم البياني. ولا يمكنك تحديد تدرج مميز لكل سلسلة في رسم بياني متعدد السلاسل.

الوصف	مثال
حدِّد لونًا واحدًا للحصول على تدرّجات الألوان من أغمق (الشريحة الأولى) إلى أفتح (الشريحة الأخيرة).	chco=0000FF
تحديد التدرج؛ من الأصفر إلى الأحمر هنا.	chd=t:10,20,30,40,50 chco=FFFF10,FF0000
تحديد ألوان الشرائح الفردية، وتحديد لون واحد لكل شريحة	chd=t:10,20,30 chco=FF0000|00FF00|0000FF
يحتوي هذا الرسم البياني على سلسلتَي بيانات، لكنّه يحدِّد اللون بتدرج واحد في جميع الشرائح من الأصفر إلى الأحمر (BBBB00 - BB0000).	chco=BBBB00,BB0000
في ما يلي رسم بياني مركزي يشمل ألوان السلسلة وألوان الشرائح الفردية. يحتوي الرسم البياني على سلسلتَي بيانات متحدتَين المركز. في شكل يسهل على الإنسان قراءته، تكون الألوان chco=green|red,blue|yellow. وتُقسِّم الفاصلة ذلك إلى سلسلتَين: الأخضر|الأحمر - التبديل بين الشرائح الخضراء والحمراء. أزرق|أصفر - شرائح زرقاء وصفراء متناوبة	chd=s:eYY,ORVM chco=008800|880000,000088|888800

الرجوع إلى الأعلى

تصنيفات الرسم البياني الدائري chl

يمكنك تحديد تصنيفات لشرائح فردية في الرسم البياني الدائري باستخدام المَعلمة chl. ويمكنك أيضًا عرض legend بالقيم نفسها أو قيم مختلفة، مع إدخال وسيلة إيضاح واحدة لكل شريحة.

ملاحظة بشأن قيم السلسلة: يُسمح فقط باستخدام الأحرف الآمنة من عنوان URL في سلاسل التصنيفات. ولضمان الأمان، عليك ترميز عنوان URL لأي سلاسل تحتوي على أحرف غير متوفّرة في مجموعة الأحرف 0-9a-zA-Z. يمكنك العثور على برنامج ترميز لعنوان URL هنا.

البنية

chl=
  <label_value>|
    ...
  <label_value>

<label_value>

قيمة سلسلة لتطبيقها على شريحة. يتم تطبيق التصنيفات بالتتابع على نقاط البيانات في chd. إذا كانت لديك سلاسل متعددة (على سبيل المثال، لرسم بياني دائري متحد المركز)، يتم تطبيق التصنيفات على جميع النقاط في جميع التسلسلات، بالترتيب المحدّد في chd. استخدِم محدِّد الشرطة الرأسية ( |) بين كل تصنيف. حدِّد قيمة متداخلة ناقصة باستخدام حرفَي شُرطَين متتاليَين بدون مسافة بينهما: || . ولا تحتاج إلى تصنيف جميع الشرائح.

 

أمثلة

الوصف	مثال
تسميات للمخطط الدائري ثلاثي الأبعاد.	chl=May|Jun|Jul|Aug|Sep|Oct chs=220x100
عند تحديد حجم الرسم البياني باستخدام chs، فكِّر في المساحة التي ستحتاجها تصنيفاتك. وبشكل عام، يجب أن يكون عرض الرسم البياني الدائري ثنائي الأبعاد أكبر بمرّتين من ارتفاعه، ويجب أن يكون الرسم البياني الدائري الثلاثي الأبعاد أكثر عرضًا بمقدار مرتين ونصف تقريبًا من ارتفاعه كي يتم عرض التصنيفات بشكل صحيح. في المثال الأول، يتم عرض التصنيفات جزئيًا فقط، لأن الرسم البياني ليس واسعًا بما يكفي. يوضّح المثال الثاني أنّ عرض الرسم البياني يجب أن يبلغ 280 بكسل لعرض التصنيفات بالكامل. (تمت إضافة الحدود صراحةً إلى العنصر <img>.)	chl=May|June|July|August| September|October chs=220x100 chl=May|June|July|August| September|October chs=280x100

الرجوع إلى الأعلى

تدوير الرسم البياني الدائري chp

يتم رسم السلسلة الأولى تلقائيًا بدءًا من 3:00، ويستمر رسمها في اتجاه عقارب الساعة حول الرسم البياني، ولكن يمكنك تحديد عملية تدوير مخصَّصة باستخدام مَعلمة chp.

البنية

chp=<radians>
  

<radians>

قيمة نقطة عائمة تصف عدد وحدات الراديان المطلوب تدويرها في اتجاه عقارب الساعة الانعطاف الكامل يساوي 2π (2 باي - حوالي 6.28) راديان.

أمثلة

الوصف	مثال
لتغيير اتجاه رسم بياني دائري، استخدِم chp=<angle_in_radians>	chd=t:20,80 chd=t:80,20 chp=0.628
في ما يلي مثال آخر على عمليات تدوير المخطط الدائري. ويمكن دمجها مع علامات تحديد شكل الرسم البياني لإنشاء بعض التأثيرات المثيرة للاهتمام.

 

الرجوع إلى الأعلى

الميزات العادية

بقية الميزات الموجودة في هذه الصفحة هي ميزات مخطط قياسية.

عنوان الرسم البياني chtt، chts [جميع الرسوم البيانية]

يمكنك تحديد نص العنوان واللون وحجم الخط للمخطط.

البنية

chtt=<chart_title>
chts=<color>,<font_size>,<opt_alignment>

 

chtt: لتحديد عنوان الرسم البياني.

<chart_title>

العنوان الذي سيتم عرضه في الرسم البياني ولا يمكنك تحديد مكان ظهور هذا النص، ولكن يمكنك اختياريًا تحديد حجم الخط ولونه. استخدِم علامة + للإشارة إلى المسافات، وعلامة الشرطة الرأسية ( |) للإشارة إلى فواصل الأسطر.

 

chts [اختيارية]: الألوان وحجم الخط للمَعلمة chtt

<color>

لون العنوان بالتنسيق السداسي العشري RRGGBB. اللون التلقائي هو الأسود.

<font_size>

حجم خط العنوان بالنقاط

<opt_alignment>

[اختيارية] يجب عرض العنوان بشكل متّسق. اختر إحدى قيم السلسلة التالية الحساسة لحالة الأحرف: "l" (يسار) أو "c" (في الوسط) "r" (لليمين). القيمة التلقائية هي "c".

 

أمثلة

الوصف	مثال
مخطط بعنوان، باستخدام اللون وحجم الخط الافتراضيين. يجب تحديد مساحة باستخدام علامة الجمع (+). استخدِم حرف الشرطة الرأسية (|) لفرض فاصل أسطر. لم يتم تحديد chts هنا.	chtt=Site+visitors+by+month| January+to+July
رسم بياني لعنوان أزرق محاذٍ لليمين ومكونًا من 20 نقطة.	chtt=Site+visitors chts=FF0000,20,r

الرجوع إلى الأعلى

نص التسمية التوضيحية والنمط في الرسم البياني chdl وchdlp وchdls [كل الرسوم البيانية]

وسيلة الإيضاح هي قسم جانبي من الرسم البياني يقدّم وصفًا نصيًا صغيرًا لكل سلسلة. يمكنك تحديد النص المرتبط بكل سلسلة في وسيلة الإيضاح هذه، وتحديد مكان ظهورها على الرسم البياني.

راجِع أيضًا chma للاطّلاع على كيفية تحديد الهوامش حول وسيلة الإيضاح.

ملاحظة بشأن قيم السلسلة: يُسمح فقط باستخدام الأحرف الآمنة من عنوان URL في سلاسل التصنيفات. ولضمان الأمان، عليك ترميز عنوان URL لأي سلاسل تحتوي على أحرف غير متوفّرة في مجموعة الأحرف 0-9a-zA-Z. يمكنك العثور على برنامج ترميز لعناوين URL في مستندات العروض المرئية من Google.

البنية

chdl=<data_series_1_label>|...|<data_series_n_label>
chdlp=<opt_position>|<opt_label_order>
chdls=<color>,<size>

 

chdl - النص الخاص بكل سلسلة ليتم عرضه في وسيلة الإيضاح.

<data_series_label>

نص إدخالات وسيلة الإيضاح. ينطبق كل تصنيف على السلسلة المقابلة في المصفوفة chd. استخدِم علامة + للمساحة. وإذا لم تحدّد هذه المَعلمة، لن يحصل الرسم البياني على وسيلة إيضاح. ولا تتوفر طريقة لتحديد فاصل أسطر في التصنيف. وسيتم توسيع وسيلة الإيضاح عادةً للاحتفاظ بنص وسيلة الإيضاح، كما ستتقلّص مساحة الرسم البياني لتلائم وسيلة الإيضاح.

chdlp - [اختيارية] تحدّد هذه السمة موضع وسيلة الإيضاح وترتيب إدخالات التسمية التوضيحية. يمكنك تحديد <position> و/أو <label_order>. وإذا حدّدت كليهما، افصلهما بحرف شريط. يمكنك إضافة علامة "'s" إلى أي قيمة إذا أردت تخطّي الإدخالات الفارغة في وسيلة الإيضاح في chdl في وسيلة الإيضاح. أمثلة: chdlp=bv، chdlp=r، chdlp=bv|r، chdlp=bvs|r

<opt_position>

[اختيارية] تحدّد هذه السمة موضع وسيلة الإيضاح في الرسم البياني. لتحديد مساحة متروكة إضافية بين وسيلة الإيضاح ومنطقة الرسم البياني أو حدود الصورة، استخدِم المَعلمة chma. اختَر إحدى القيم التالية:

• b: وسيلة الإيضاح أسفل الرسم البياني، وإدخالات وسيلة الإيضاح في صف أفقي
• bv: وسيلة الإيضاح في أسفل الرسم البياني، وإدخالات وسيلة الإيضاح في عمود عمودي
• t: وسيلة الإيضاح أعلى الرسم البياني، وإدخالات وسيلة الإيضاح في صف أفقي
• tv: وسيلة إيضاح أعلى الرسم البياني، وإدخالات وسيلة الإيضاح في عمود عمودي
• r - [تلقائي] وسيلة الإيضاح على يسار الرسم البياني، وإدخالات وسيلة الإيضاح في العمود العمودي
• l: وسيلة إيضاح على يمين الرسم البياني، وإدخالات وسيلة الإيضاح في عمود عمودي

<opt_label_order>

[اختيارية] تمثّل هذه السمة الترتيب الذي تظهر به التصنيفات في وسيلة الإيضاح. اختَر إحدى القيم التالية:

• l - [الإعداد التلقائي للوسائل الإيضاح العمودية] عرض التصنيفات بالترتيب المقدم للسمة chdl.
• r - عرض التصنيفات بالترتيب العكسي كما هو موضح في chdl. ويعد هذا أمرًا مفيدًا في المخططات الشريطية المكدسة لعرض وسيلة الإيضاح
  بنفس الترتيب الذي تظهر فيه الأشرطة.
• a - [الإعداد التلقائي لأدوات الإيضاح الأفقية] الترتيب التلقائي: يعني الترتيب حسب الطول تقريبًا، والأقصر أولاً، حسب ما يتم قياسه بكتل 10 بكسل. عندما يكون العنصران بنفس الطول (مقسمَين إلى 10 وحدات بكسل)، سيظهر العنصر المُدرَج أولاً.
• 0,1,2... - ترتيب تصنيف مخصّص هذه قائمة بفهارس التصنيفات المستندة إلى صفر من chdl، مفصولة بفواصل.

chdls - [اختيارية]: تحدّد هذه السمة لون نص وسيلة الإيضاح وحجم الخط.

<color>

لون نص وسيلة الإيضاح، بالتنسيق السداسي العشري RRGGBB.

<size>

حجم نقطة نص وسيلة الإيضاح.

 

أمثلة

الوصف	مثال
مثالان على وسائل الإيضاح. حدِّد نص وسيلة الإيضاح بنفس ترتيب سلسلة البيانات.	chdl=NASDAQ|FTSE100|DOW chco=FF0000,00FF00,0000FF chdl=First|Second|Third chco=ff0000,00ff00,0000ff
يعرض الرسم البياني الأول إدخالات وسيلة الإيضاح الأفقية (chdlp=t، والتنسيق التلقائي هو أفقي)، ويوضّح الرسم البياني الثاني إدخالات وسيلة الإيضاح العمودية السفلية (chdlp=bv).	chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=t chdl=First|Second|Third chco=ff0000,00ff00,0000ff chdlp=bv
يوضح هذا المثال تغيير حجم الخط.	chdls=0000CC,14

الرجوع إلى الأعلى

هوامش الرسم البياني chma [كل الرسوم البيانية]

يمكنك تحديد حجم هوامش الرسم البياني بالبكسل. يتم احتساب الهوامش داخليًا من حجم الرسم البياني المحدّد (chs)، ولا تؤدي زيادة حجم الهامش إلى زيادة إجمالي حجم الرسم البياني، بل تقليص مساحة الرسم البياني إذا لزم الأمر.

الهوامش بشكل افتراضي هي ما يتبقى بعد حساب حجم المخطط. تختلف هذه القيمة التلقائية حسب نوع الرسم البياني. الهوامش التي تحدّدها هي حد أدنى للقيمة، وإذا تركت مساحة الرسم البياني مساحة للهوامش، سيكون حجم الهامش هو ما يتبقى، ولا يمكنك الضغط على الهوامش أصغر حجمًا مما هو مطلوب لأي وسائل إيضاح وتصنيفات. في ما يلي مخطّط بياني يوضّح الأجزاء الأساسية من الرسم البياني:

تشتمل هوامش الرسم البياني على تصنيفات المحاور ومنطقة الرسم البياني. يتم تغيير حجم منطقة وسيلة الإيضاح تلقائيًا لتلائم النص تمامًا، ما لم تحدّد عرضًا أكبر باستخدام chma، وفي هذه الحالة سيتم توسيع حجم الهامش على نطاق أوسع وضغط مساحة الرسم البياني ليكون أصغر. لا يمكنك اقتصاص وسيلة إيضاح من خلال تحديد حجم صغير جدًا، ولكن يمكنك جعلها تشغل مساحة أكبر مما تحتاج إليه. ملاحظة: في الرسم البياني الشريطي، لا يمكن تقليل عرض مساحة الرسم البياني إذا كان حجم الأشرطة ثابتًا (الإعداد التلقائي). يجب تحديد حجم شريط أصغر أو قابل لتغيير حجمه باستخدام chbh.

 

البنية

chma=
  <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>

<left_margin>، <left_margin>، <left_margin>، <left_margin>

الحد الأدنى لحجم الهامش حول مساحة الرسم البياني بالبكسل يمكنك زيادة هذه القيمة لتضمين بعض المساحة المتروكة لمنع اصطدام تصنيفات المحاور بحدود الرسم البياني.

<opt_legend_width>، <opt_legend_height>

[اختيارية] عرض الهامش حول وسيلة الإيضاح، بالبكسل استخدِم هذا الخيار لتجنّب ظهور وسيلة الإيضاح أمام منطقة الرسم البياني أو حواف الصورة.

 

أمثلة

الوصف	مثال
في هذا المثال، يبلغ الحد الأدنى للهامش 30 بكسل في الرسم البياني على كل جانب. وبما أنّ عرض وسيلة إيضاح الرسم البياني يزيد عن 30 بكسل، يتم ضبط الهامش في الجانب الأيسر على عرض وسيلة إيضاح الرسم البياني، ويختلف عن الهوامش الأخرى. تقع تصنيفات المحور خارج مساحة الرسم البياني، وبالتالي يتم رسمها داخل مساحة الهامش.	chma=30,30,30,30
لإضافة هامش حول وسيلة الإيضاح، اضبط قيمة للمعلمتَين <opt_legend_width> و<opt_legend_height>. في هذا المثال، يبلغ عرض وسيلة الإيضاح 60 بكسل تقريبًا. في حال ضبط <opt_legend_width> على 80 بكسل، يمتد الهامش إلى 20 بكسل خارج وسيلة الإيضاح.	chma=20,20,20,30|80,20

الرجوع إلى الأعلى

أنماط وتصنيفات المحور [الخط، الشريط، Google-o-meter، الرادار، المبعثر]

ويمكنك تحديد المحاور التي تريد عرضها على الرسم البياني ومنحها تصنيفات ومواضع ونطاقات وأنماط مخصّصة.

لا تعرض جميع الرسوم البيانية خطوط المحور تلقائيًا. يمكنك تحديد المحاور التي يجب أن يعرضها الرسم البياني بالضبط باستخدام معلَمة chxt. لا تعرض خطوط المحور التلقائية أرقامًا، يجب تحديد محور في المعلَمة chxt لعرض الأرقام.

يمكنك اختيار أن تعرض المحاور أرقامًا تعكس قيم البيانات، أو يمكنك تحديد محاور مخصّصة. والخيار التلقائي هو عرض القيم الرقمية، مع تغيير القيم لتتراوح من 0 إلى 100. ومع ذلك، يمكنك تغيير هذا النطاق باستخدام chxr لعرض أي نطاق، ويمكنك وضع نمط للقيم (على سبيل المثال، لعرض رموز العملات أو المنازل العشرية) باستخدام chxs.

إذا اخترت استخدام قيم مخصّصة، مثل "الاثنين، الثلاثاء، الأربعاء"، يمكنك استخدام مَعلمة chxl. لوضع هذه التصنيفات في مواقع محددة على طول المحور، استخدِم مَعلمة chxp.

أخيرًا، يمكنك استخدام المَعلمتَين chxs وchxtc لتحديد اللون والحجم والمحاذاة وسمات أخرى لتصنيفات المحاور المخصّصة والرقمية.

ملاحظة بشأن قيم السلسلة: يُسمح فقط باستخدام الأحرف الآمنة من عنوان URL في سلاسل التصنيفات. ولضمان الأمان، عليك ترميز عنوان URL لأي سلاسل تحتوي على أحرف غير متوفّرة في مجموعة الأحرف 0-9a-zA-Z. يمكنك العثور على برنامج ترميز لعناوين URL في مستندات العروض المرئية من Google.

يتناول هذا القسم المواضيع التالية:

• المحاور المرئية (chxt): تمثّل المحاور التي يجب عرضها.
• نطاق المحور (chxr) - نطاق القيمة لكل محور
• تصنيفات المحاور المخصصة (chxl): قيم مخصصة لتظهر على المحور.
• مواضع تصنيف المحور (chxp): موضع التصنيفات المخصّصة على طول كل محور
• أنماط تصنيفات المحاور (chxs): لون تصنيفات المحاور وحجمها ومحاذاة وتنسيقها
• أنماط علامات تحديد المحور (chxtc) - طول علامات التجزئة لمحور معيّن.

---

المحاور المرئية chxt

تعرض المخططات الشريطية والخطية والرادارية ومخططات النقاط المبعثرة خطًا أو خطَين على المحور بشكل تلقائي، ولكن هذه الخطوط لا تتضمّن قيمًا. لعرض القيم على خطوط المحور، أو لتغيير المحاور التي يتم عرضها، عليك استخدام مَعلمة chxt. تتراوح قيم المحور تلقائيًا بين 0 و100، ما لم يتم ضبطها بشكل صريح باستخدام السمة chxr. لإخفاء جميع خطوط المحاور في رسم بياني خطي، حدِّد :nda بعد قيمة نوع الرسم البياني في المعلمة cht (مثال: cht=lc:nda).

لا يعرض المحوران العلوي والسفلي تلقائيًا علامات اختيار حسب القيم، بينما يعرضهما المحوران الأيسر والأيمن. يمكنك تغيير هذا السلوك باستخدام المَعلمة chxs.

البنية

chxt=
  <axis_1>
    ,...,
  <axis_n>

<axis>

محور مطلوب عرضه على الرسم البياني. المحاور المتاحة هي:

• x - المحور "س" السفلي
• t - المحور "س" العلوي [غير متوافق مع Google-o-Meter]
• y - المحور "ص" الأيسر
• r - المحور ص الأيمن [غير متوافق مع Google-o-Meter]

يمكنك تحديد محاور متعدّدة من النوع نفسه، على سبيل المثال: cht=x,x,y. سيؤدي هذا الإجراء إلى تكديس مجموعتَين من المحاور x على طول الجزء السفلي من الرسم البياني. ويكون هذا الإجراء مفيدًا عند إضافة تصنيفات مخصّصة على محور يعرض قيمًا رقمية (راجِع المثال أدناه). يتم رسم المحاور من الداخل إلى الخارج، لذا إذا كان لديك x,x، تشير علامة x الأولى إلى النسخة الأعمق، وتشير علامة x التالية إلى النسخة الخارجية التالية، وهكذا.

 

أمثلة

الوصف	مثال
يعرض هذا المثال رسمًا بيانيًا خطيًا يحتوي على محور س ومحور ص ومحور علوي (t) ومحور أيمن (r). بسبب عدم تحديد أي تصنيفات، يتم ضبط الرسم البياني تلقائيًا على نطاق يتراوح بين 0 و100 لجميع المحاور. يُرجى العلم أنّ المحورين العلوي والسفلي لا يُظهران تلقائيًا علامات التجزئة بجانب التصنيفات.	chxt=x,y,r,t
يمكنك تضمين مجموعات متعدّدة من التصنيفات لكل محور من خلال تضمين القيمة نفسها أكثر من مرة. يوضّح هذا المثال مجموعتين من المحاور x ومجموعتين من المحاور y. ولن يكون ذلك مفيدًا بشكل خاص عند استخدام تصنيفات المحاور التلقائية فقط، كما هو موضّح هنا. ويمكنك تحديد تصنيفات مخصّصة لكل نسخة من كل محور باستخدام المَعلمة chxl.	<img <code="" dir="ltr" src="/static/chart/image/images/chart_41.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHKUju9uuXUc&chco=76A4FB&chls=2.0&chs=20" <img <code="" dir="ltr" src="/static/chart/image/images/chart_42.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHKUju9uuXUc&chco=76A4FB&chls=2.0&chs=20
يعرض هذا المثال رسمًا بيانيًا شريطيًا أفقيًا على محور "س" ومحور ص ومحور T علوي ومحور r أيمن. يتم حذف تصنيفات المحور، لذا تعرض Chart API نطاقًا من 0 إلى 100 للمحور x والمحور t. يتم تحديد نطاق المحور الصادي والمحور r من خلال عدد الأشرطة. في هذه الحالة، هناك خمسة أشرطة، لذا تعرض Chart API نطاقًا يتراوح من 0 إلى 4. يوضع التصنيف الأول في وسط قاعدة الشريط الأول، ويوضع التصنيف الثاني في وسط قاعدة الشريط الثاني، وهكذا.	chxt=x,y,r,t
يمكنك إيقاف المحاور التلقائية في رسم بياني خطي من خلال تحديد :nda بعد نوع الرسم البياني.	cht=lc:nda

الرجوع إلى الأعلى

نطاق المحور chxr

يمكنك تحديد نطاق القيم التي تظهر على كل محور بشكل مستقل، باستخدام المَعلمة chxr. يُرجى العِلم أنّ هذا لن يغيِّر مقياس عناصر الرسم البياني، بل يغير فقط مقياس تصنيفات المحور. إذا كنت تريد أن تصف أرقام المحاور قيم البيانات الفعلية، اضبط <start_val> و <end_val> على القيمتين الأدنى والعليا لنطاق تنسيق البيانات، على التوالي. راجِع تحجيم المحور للاطّلاع على مزيد من المعلومات.

عليك إظهار محور باستخدام المَعلمة chxt إذا كنت تريد تحديد نطاقه.

لتحديد قيم المحور المخصّص، استخدِم المَعلمة chxl.

البنية

افصل بين نطاقات تصنيفات المحاور المتعددة باستخدام رمز الشرطة الرأسية ( | ).

chxr=
  <axis_index>,<start_val>,<end_val>,<opt_step>
    |...|
  <axis_index>,<start_val>,<end_val>,<opt_step>

<axis_index>

محور تطبيق التصنيفات عليه. هذا الفهرس يستند إلى صفر في مصفوفة المحور التي تحدّدها السمة chxt. على سبيل المثال، سيكون المحور r هو 1 في chxt=x,r,y.

<start_val>

رقم يحدد القيمة المنخفضة لهذا المحور.

<end_val>

رقم يحدد القيمة العالية لهذا المحور.

<opt_step>

[اختيارية] هي خطوة العد بين المؤشرات على المحور. ولا تتوفّر قيمة تلقائية للخطوة، ويتم احتساب الخطوة لمحاولة عرض مجموعة من التصنيفات المتباعدة بشكل جيد.

 

أمثلة

الوصف	مثال
يعرض هذا المثال محورَي الصاديَين الأيمن والأيسر (y وr) ومحور س واحد (x). لكل محور نطاق محدد. بسبب عدم تحديد أي تصنيفات أو مواضع، يتم أخذ القيم من النطاق المحدد، وتكون متباعدة بشكل متساوٍ ضمن هذا النطاق. في المخطط الخطي، تنتشر القيم بالتساوي على المحور x. تم عكس اتجاه المحور للمحور r (الفهرس 2)، لأن القيمة الأولى (1000) أكبر من القيمة الأخيرة (0).	chxt=x,y,r chxr=   0,0,500|   1,0,200|   2,1000,0
في هذا المثال، يتم تحديد القيم للمحور x. تكون تسميات المحور متباعدة بشكل متساوٍ على طول المحور. ويتم تحديد قيمة خمسة (5) للمَعلمة <opt_step>.	chxt=x chxr=0,10,50,5

الرجوع إلى الأعلى

تصنيفات المحور المخصصة chxl

يمكنك تحديد تصنيفات محور السلسلة المخصّصة على أي محور، باستخدام المَعلمة chxl. يمكنك تحديد أي عدد تريده من التصنيفات. في حال عرض محور (باستخدام المَعلمة chxt) بدون تحديد تصنيفات مخصّصة، سيتم تطبيق التصنيفات العادية والرقمية. لتحديد نطاق رقمي مخصّص، استخدِم chxr المعلَمة بدلاً من ذلك.

لضبط مواقع جغرافية محدّدة على طول المحور للتصنيفات، استخدِم المَعلمة chxp.

البنية

حدِّد مجموعة واحدة من المَعلمات لكل محور تريد تصنيفه. افصل بين مجموعات التصنيفات المتعددة باستخدام رمز الشرطة الرأسية ( | ).

chxl=
  <axis_index>:|<label_1>|...|<label_n>
    |...|
  <axis_index>:|<label_1>|...|<label_n>

<axis_index>

محور تطبيق التصنيفات عليه. هذا فهرس في مصفوفة معلَمة chxt. على سبيل المثال، إذا كان لديك chxt=x,x,y,y، فسيكون الفهرس 0 هو المحور x الأول، وسيكون 1 هو المحور x الثاني.

<label_1>| ... |<label_n>

تصنيف واحد أو أكثر لوضعه على طول هذا المحور. يمكن أن تكون هذه القيم سلسلة أو أرقامًا، وليس من الضروري أن تكون السلاسل بين علامتَي اقتباس. ويتم عرض label_1 في أدنى موضع على المحور، كما يتم عرض label_n في أعلى موضع. تفصل التصنيفات الإضافية بينها بالتساوي. الإشارة إلى المساحات باستخدام علامة + ولا تتوفر طريقة لتحديد فاصل أسطر في التصنيف. افصل بين التصنيفات باستخدام رمز الشرطة الرأسية. ملاحظة: لا تضع ممرًا بعد التصنيف النهائي في مَعلمة chxl.

 

أمثلة

الوصف	مثال
يعرض هذا الرسم البياني كيفية إضافة تصنيفات مخصّصة إلى محورَين. يُرجى العِلم عن كيفية تباعد القيم بشكل متساوٍ، وكيفية عدم انتهاء قيمة chxl الأخيرة بممر.	chxt=x,y chxl= 0:|Jan|Feb|March|April|May| 1:|Min|Mid|Max
يتضمن هذا المثال تصنيفات المحاور على المحورَين الصاديَين الأيمن والأيسر (y وr). ويتضمّن أيضًا مجموعتَين من القيم للمحور س (x). يمكنك إضافة علامات اختيار على المحور ص باستخدام السمة chxs.	chxt=x,y,r,x chxl= 0:|Jan|July|Jan|July|Jan| 1:|0|50|100| 2:|A|B|C| 3:|2005|2006|2007
يتضمن هذا المثال تصنيفات المحاور على المحورين الصاديين الأيمن والأيسر (y وr). ويتضمّن أيضًا مجموعتَين من القيم للمحور س (x). لاحِظ التصنيفات الفارغة لمجموعة المحور "س" السفلية، والتي تُستخدم لتباعد القيم. يستخدم هذا المثال القيم الافتراضية لتسميات المحور على المحور y الأيسر.	chxt=x,y,r,x chxl= 0:|Jan|July|Jan|July|Jan| 2:|A|B|C| 3:|2005||2006||2007
إذا كنت تريد إضافة تصنيف عام لوصف محور بأكمله (على سبيل المثال، لتصنيف محور "التكلفة" وآخر "طالب")، استخدِم السمة chxt لإضافة محور إضافي على كل جانب، ثم استخدِم chxl لإضافة تصنيف مخصّص واحد إلى كل جانب وchxp لتباعده في منتصف المحور.	chxt=x,x,y,y chxl=1:|Martinis|3:|Score chxp=1,50|3,50

الرجوع إلى الأعلى

مواضع تصنيف المحور chxp

يمكنك تحديد تصنيفات المحاور التي تريد عرضها، سواء باستخدام التصنيفات التلقائية أو التصنيفات المخصّصة المحدّدة باستخدام chxl. إذا لم تحدّد مواضع دقيقة باستخدام هذه المَعلمة، سيتم تباعد التصنيفات بالتساوي وعلى قيمة خطوة تلقائية على طول المحاور. إذا لم تحدّد السمة chxl، ستكون تصنيفات علامات الاختيار هي القيم التلقائية (عادةً قيم البيانات أو الأرقام الشريطية في الرسوم البيانية الشريطية).

البنية

افصل بين مجموعات تحديد المواقع المتعددة باستخدام رمز الشرطة الرأسية (|).

chxp=
  <axis_1_index>,<label_1_position>,...,<label_n_position>
    |...|
  <axis_m_index>,<label_1_position>,...,<label_n_position>

<axis_index>

المحور الذي تحدّد المواضع له. يعرض هذا الحقل فهرسًا لمصفوفة معلَمة chxt. على سبيل المثال، إذا كان لديك chxt=x,x,y,y، سيكون الفهرس 0 هو المحور x الأول، وسيكون 1 هو المحور x الثاني، وهكذا.

<label_1_position>,...,<label_n_position>

موضع التصنيف على طول المحور. هذه قائمة من القيم الرقمية مفصولة بفواصل، تحدّد فيها كل قيمة موضع التصنيف المقابل في المصفوفة chxl: ينطبق الإدخال الأول على التصنيف الأول، وهكذا. الموضع هو قيمة في النطاق الخاص بهذا المحور. تجدر الإشارة إلى أنّ هذه القيمة ستكون دائمًا من 0 إلى 100 ما لم تحدّد نطاقًا مخصّصًا باستخدام chxr. يجب أن يكون لديك عدد من المواضع بالقدر الذي لديك فيه تصنيفات لهذا المحور.

 

أمثلة

الوصف	مثال
يتضمن هذا المثال تصنيفات المحور r في مواضع محددة على الرسم البياني. يتم تحديد نص التصنيف باستخدام المَعلمة chxl. يتم وضع التصنيفات التي لها موضع محدّد بقيمة 0 في أسفل المحور y أو r أو على يسار المحور "x" أو المحور "t". يتم وضع التصنيفات التي لها موضع محدّد بقيمة 100 أعلى المحور y أو r أو على يمين المحورين x أو t.	chxt=x,y,r chxl=2:|min|average|max chxp=2,10,35,75
يوضّح هذا المثال قيم التصنيف التلقائية، ولكن في مواقع جغرافية محدّدة فقط. chxp=1,10,35,75 - يجب أن يعرض المحور ص ثلاثة تصنيفات فقط: 10 و35 و75. وبسبب عدم تحديد نص تصنيف مخصّص، يتم عرض قيم المحاور هذه. يُرجى العِلم بأنّه لن تحتاج إلى الفصل بين التصنيفات بالتساوي عند استخدام chxp. إذا لم يتم تحديد chxp هنا، ستكون مسافة القيمة التلقائية للتصنيف على المحور ص كل 20 وحدة، كما هو موضّح في الرسم البياني الثاني.	chxt=x,y chxp=1,10,35,75 chxt=x,y chxp لم يتم تحديده

الرجوع إلى الأعلى

أنماط تصنيفات المحور chxs

يمكنك تحديد حجم الخط ولونه ومحاذاة تصنيفات المحاور، سواء كانت التصنيفات المخصّصة أو قيم التصنيفات التلقائية. وتكون جميع التصنيفات على المحور نفسه بالتنسيق نفسه. إذا كانت لديك نُسخ متعددة من محور واحد، يمكنك تنسيق كل نسخة بشكل مختلف. ويمكنك أيضًا تحديد تنسيق سلسلة التصنيف، مثلاً لعرض رموز العملات أو الأصفار اللاحقة.

بشكل افتراضي، لا يُظهر المحوران العلوي والسفلي علامات التجزئة حسب القيم، بينما يعرضهما المحوران الأيسر والأيمن.

البنية

ويجب فصل قيم المحاور المتعدّدة باستخدام الشرطة الرأسية (|).

chxs=
 <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>
   |...|
 <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>

<axis_index>

المحور الذي ينطبق عليه ذلك. وهذا الفهرس مبني على صفر في المعلَمة chxt.

<opt_format_string>

[اختيارية] هذه سلسلة تنسيق اختيارية، وتتّبع، في حال استخدامها، رقم فهرس المحور مباشرةً بدون فاصلة متداخلة. تبدأ قاعدة التنسيق بحرف حرف N متبوعًا بالقيم التالية، وجميعها اختيارية: تكون بنية سلسلة التنسيق على النحو التالي:
       N<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
وفي ما يلي معنى كل عنصر:

• <preceding_text> - نص حرفي يسبق كل قيمة
• *...*: هو جزء اختياري تحيط به علامات نجمية حرفية، حيث يمكنك تحديد تفاصيل تنسيق الأرقام. القيم التالية متوافقة، وجميعها اختيارية:
  • <number_type> - تنسيق الأرقام للقيم الرقمية حدِّد أحد الخيارات التالية:
    • f - [تلقائي] تنسيق النقاط العائمة ننصحك أيضًا بتحديد الدقة باستخدام القيمة <decimal_places>.
    • p - تنسيق النسبة المئوية يتم إلحاق علامة % تلقائيًا. ملاحظة: عند استخدام هذا التنسيق، يتم ربط قيم البيانات من 0.0 — 1.0 إلى 0 — 100% (على سبيل المثال، سيتم عرض 0.43 على هذا النحو بنسبة 43%).
    • e - تنسيق الترميز العلمي
    • c<CUR> - تنسيق الرقم بالعملة المحددة، باستخدام محدد العملة المناسب. استبدِل <CUR> برمز عملة مكوّن من ثلاثة أحرف. مثال: cEUR لليورو. يمكنك العثور على قائمة بالرموز على موقع ISO على الويب، ولكن ليست كل الرموز متوافقة.
  • <decimal_places> - عدد صحيح يحدد عدد المنازل العشرية المراد عرضه. ويتم تقريب القيمة (بدون اقتطاع) إلى هذا الطول. القيمة التلقائية هي 2.
  • z - عرض الأصفار اللاحقة القيمة التلقائية هي "لا".
  • s - عرض فواصل المجموعات القيمة التلقائية هي "لا".
  • x أو y -عرض البيانات من الإحداثي x أو y، على النحو المحدّد. يختلف معنى بيانات x حسب نوع الرسم البياني، لذا ننصحك بإجراء التجربة على الرسم البياني لتحديد معناه. القيمة التلقائية هي 'y'.
• <following_text> - النص الحرفي المطلوب اتّباع كل قيمة

<opt_label_color>

اللون المطلوب تطبيقه على نص المحور (وليس سطر المحور) بالتنسيق السداسي العشري RRGGBB. ويتم تحديد لون خط المحور بشكل منفصل باستخدام opt_axis_color. اللون التلقائي هو الرمادي.

<opt_font_size>

[اختيارية] تحدّد حجم الخط بالبكسل. هذه المَعلمة اختيارية.

<opt_alignment>

[اختياري] محاذاة التصنيف. بالنسبة إلى المحاور العلوية أو السفلية، يصف هذا التصنيف كيفية محاذاة التصنيف مع علامة الاختيار فوقه أو أسفله. أما بالنسبة إلى المحورَين الأيسر والأيمن، فيصف طريقة محاذاة التصنيف داخل مربّع الإحاطة الخاص به والذي يؤثّر على المحور. حدِّد أحد الأرقام التالية:

• -1 - أعلى أو أسفل: تظهر التصنيفات على يمين علامات التجزئة لليسار أو اليمين: تتم محاذاة التصنيفات إلى اليسار في منطقتها. الخيار التلقائي لتصنيفات المحور r
• 0 - لأعلى أو أسفل: ترتكز التصنيفات على علامات التجزئة إلى اليسار أو اليمين: تظهر التصنيفات في وسط المنطقة. الخيار التلقائي لتصنيفات المحورين "س" و"تي".
• 1 - أعلى أو أسفل: تظهر التصنيفات إلى يسار علامات التجزئة لليسار أو الأيمن: تتم محاذاة التصنيفات إلى اليمين في منطقتها. الخيار التلقائي لتصنيفات المحور y.

<opt_axis_or_tick>

[اختيارية، غير متاحة في Google-o-meter] ما إذا كان سيتم عرض علامات التجزئة و/أو خطوط المحور لهذا المحور لا تتوفّر علامات التأشير وخطوط المحور إلا للمحاور الأبعد. (على سبيل المثال، لا يمكن استخدامها مع الجزء الخارجي من محورَين س). استخدِم إحدى القيم التالية:

• l (الحرف الصغير "L") - رسم خط المحور فقط
• t - رسم علامات التجزئة فقط علامات التجزئة هي الخطوط الصغيرة بجانب تصنيفات المحاور.
• lt - [تلقائي] يمكنك رسم كل من خط المحور وعلامات التجزئة لجميع التصنيفات.
• _ - (شرطة سفلية) لا ترسم خط المحور أو علامات التجزئة. إذا كنت تريد إخفاء خط محور، استخدِم هذه القيمة.

<tick_color>

[اختيارية؛ غير متوافقة مع Google-o-meter] لون علامة الاختيار بالتنسيق السداسي العشري RRGGBB اللون التلقائي هو الرمادي.

<opt_axis_color>

[اختياري] لون خط المحور هذا، بتنسيق RRGGBB السداسي العشري. اللون التلقائي هو الرمادي.

 

أمثلة

الوصف	مثال
ويتم تحديد حجم الخط ولونه للمحور x الثاني (يناير، فبراير، مارس).	chxt=x,y,r,x chxr=2,0,4 chxl=3:|Jan|Feb|Mar|      1:|min|average|max chxp=1,10,35,75 chxs=3,0000DD,13,0,t
يتم تحديد حجم الخط ولونه والمحاذاة للمحور y الأيمن. يتم رسم علامات التجزئة، ولكن بدون خط المحور.	chxt=x,y,r,x chxl=3:|Jan|Feb|Mar|      2:|min|average|max chxp=2,10,35,95 chxs=2,0000DD,13,-1,t,FF0000
يتضمّن هذا الرسم البياني ثلاث مجموعات بيانات، ويعرض ثلاث مجموعات من تصنيفات المحاور، مجموعة واحدة لكل سلسلة. يتم تنسيق كل مجموعة من التصنيفات باستخدام سلسلة تنسيق مخصّصة، كما هو موضّح في ما يلي: 0N*e,000000| تعني 0 أول سلسلة بيانات وتشير السمة N إلى سلسلة تنسيق. * تعني بداية محددات التنسيق وتعني السمة e التدوين العلمي. * تعني نهاية محددات التنسيق وتشير العلامة 000000 إلى نص أسود. 1N*cUSD*Mil,FF0000| تشير السمة 1 إلى السلسلة الثانية وتشير السمة N إلى سلسلة تنسيق. * تعني بداية محددات التنسيق تعني c محدِّد العملة. USD يحدّد الدولار الأمريكي كمحدد للعملات المطلوب استخدامه * تعني نهاية محددات التنسيق Mil هو سلسلة تالية حرفية. FF0000 تعني نصًا أحمر. 2N*sz2*,0000FF "2" تعني السلسلة الثالثة. N يُقصد بها سلسلة تنسيق. * تعني بداية محددات التنسيق تعني العلامة s عرض محدّدات التجميع (باللغة الإنجليزية الأمريكية، وهي فاصلة كل ثلاثة أصفار). تعني الدالة z2 عرض أصفار لاحقة. و"0000FF" تعني نصًا أزرق. يتم ضبط نطاقات تصنيف المحور باستخدام المَعلمة chxr (axis_index وstart وend وstep). وإذا لم يتم ضبطها، ستكون القيمة التلقائية من 0 إلى 100.	chd=s:   984sttvuvkQIBLKNCAIi,   DEJPgq0uov17zwopQODS,   AFLPTXaflptx159gsDrn chxr=   0,0,1000000,250000|   1,0,60|   2,0,5000 chxs=   0N*e,000000|   1N*cUSD*Mil,FF0000|   2N*sz2*,0000FF

الرجوع إلى الأعلى

أنماط علامات تحديد المحور chxtc

يمكنك تحديد علامات تجزئة طويلة لمحاور محدّدة. وتُستخدم هذه الطريقة عادةً لتوسيع علامة التجزئة على طول الرسم البياني. استخدِم المَعلمة chxs لتغيير لون علامة التجزئة.

ويجب فصل قيم المحاور المتعدّدة باستخدام رمز الشرطة الرأسية (|). ويجب فصل القيم ضمن السلسلة بفاصلة.

البنية

chxtc=
  <axis_index_1>,<tick_length_1>,...,<tick_length_n>
    |...|
  <axis_index_m>,<tick_length_1>,...,<tick_length_n>

<axis_index>

المحور الذي ينطبق عليه ذلك. هذا الفهرس يستند إلى صفر في المعلَمة chxt. افصل بين القيم لمحاور مختلفة باستخدام محدد شريط.

<tick_length_1>,...,<tick_length_n>

طول علامات التجزئة على ذلك المحور بالبكسل إذا تم منح قيمة واحدة، سيتم تطبيقها على جميع القيم، وإذا تم منح أكثر من قيمة واحدة، ستتبدل علامات التجزئة على المحور في قائمة القيم الخاصة بذلك المحور. يتم رسم القيم الموجبة خارج مساحة الرسم البياني واقتصاصها بواسطة حدود الرسم البياني. الحد الأقصى للقيمة الموجبة هي 25. يتم رسم القيم السلبية داخل مساحة الرسم البياني واقتصاصها باستخدام حدود مساحة الرسم البياني.

 

أمثلة

الوصف	مثال
مثال على استخدام chxtc لإنشاء علامات اختيار حمراء طويلة يتجاوز طول علامة التجزئة هنا عرض مساحة الرسم البياني، ولكن يتم اقتصاصه لتلائم الرسم البياني. chxt=x,y,r,x - إظهار محور أيسر ومحور أيمن ومحورَين سفليَين chxl=2:|min|average|max|3:|Jan|Feb|Mar - نص التصنيف المخصّص للمحورَين "r" (الجانب الأيمن) والخارجي. chxp=2,10,35,95 - مواضع التصنيفات المخصّصة على المحور r (الفهرس=2) للتصنيفات الثلاثة chxs=2,0000dd,13,-1,t,FF0000 - أنماط تصنيف المحور للمحور r: لون النص، وحجم النص، والمحاذاة إلى اليسار، مع علامات تجزئة حمراء. chxtc=1,10|2,-180 - أطوال علامات المحور (ص) والمحور r. تحدد القيمة الأولى علامات بطول 10 بكسل خارج المحور. تحدّد القيمة الثانية علامات يبلغ طولها 180 بكسل داخل المحور، ويعني الرقم السالب أن العلامة تدخل داخل المحور، ويتم اقتصاصها لتلائم الرسم البياني.	chxt=x,y,r,x chxl=   2:|min|average|max|   3:|Jan|Feb|Mar chxp=2,10,35,95 chxs=   2,0000dd,13,-1,t,FF0000 chxtc=1,10|2,-180
يوضح هذا الرسم البياني أطوال علامات التجزئة المتبادلة. تحدّد السمة chxtc قيمتَين لطول التجزئة للمحور y (5 و15)، وتتناوب القيمتان المرسومتان على الرسم البياني.	chxt=x,y chxtc=   1,5,15

الرجوع إلى الأعلى

عمليات التعبئة في الخلفية chf [كل الرسوم البيانية]

يمكنك تحديد ألوان التعبئة والأنماط لمساحة بيانات الرسم البياني و/أو خلفية الرسم البياني بالكامل. تتضمن أنواع التعبئة تعبئة صلبة وتعبئات مخططة وتدرجات. يمكنك تحديد عمليات تعبئة مختلفة لمناطق مختلفة (على سبيل المثال، منطقة الرسم البياني بالكامل أو منطقة البيانات فقط). تحلّ تعبئة منطقة الرسم البياني محلّ تعبئة الخلفية. يتم تحديد جميع عمليات التعبئة باستخدام المَعلمة chf، ويمكنك مزج أنواع تعبئة مختلفة (الصلبة والمخططات والتدرجات) في الرسم البياني نفسه عن طريق فصل القيم بحرف الشرطة الرأسية ( | ). تملأ منطقة الرسم البياني استبدال عمليات تعبئة خلفية الرسم البياني.

تعبئة ثابتة chf [كل الرسومات البيانية]

يمكنك تحديد تعبئة ثابتة لمنطقة الخلفية و/أو الرسم البياني، أو تحديد قيمة شفافية للرسم البياني بأكمله. يمكنك تحديد عمليات تعبئة متعددة باستخدام رمز الشرطة الرأسية (|). (خرائط Google: الخلفية فقط).

البنية

chf=<fill_type>,s,<color>|...

<fill_type>

الجزء الذي يتم ملؤها من الرسم البياني. حدِّد إحدى القيم التالية:

• bg - تعبئة الخلفية
• c - ملء منطقة الرسم البياني هذه السمة غير متاحة للرسوم البيانية في الخرائط.
• a: جعل الرسم البياني بأكمله (بما في ذلك الخلفيات) شفافًا ويتم تجاهل الأرقام الستة الأولى من <color>، ويتم تطبيق آخر رقمين فقط (قيمة الشفافية) على الرسم البياني بأكمله وجميع عمليات التعبئة.
• b<index> - تعبئة ثابتة شريطية (الرسوم البيانية الشريطية فقط). استبدِل <index> بفهرس سلسلة الأشرطة لتعبئة لون ثابت. يشبه التأثير تحديد chco في رسم بياني شريطي. للاطّلاع على مثال، راجِع ألوان سلسلة الرسم البياني الشريطي.

ث

تشير إلى تعبئة ثابتة أو شفافة.

<color>

لون التعبئة بالتنسيق السداسي العشري RRGGBB. بالنسبة إلى الورق الشفاف، يتم تجاهل الأرقام الستة الأولى، ولكن يجب تضمينها على أي حال.

 

أمثلة

الوصف	مثال
يملأ هذا المثال خلفية الرسم البياني باللون الرمادي الباهت (EFEFEF).	chf=bg,s,EFEFEF
يملأ هذا المثال خلفية الرسم البياني باللون الرمادي الباهت (EFEFEF) ويملأ منطقة الرسم البياني باللون الأسود (000000).	chf=c,s,000000| bg,s,EFEFEF
يطبّق هذا المثال شفافية بنسبة 50% على الرسم البياني بالكامل (80 في النظام السداسي العشري تساوي 128، أو 50% تقريبًا من الشفافية). لاحِظ خلفية خلية الجدول تظهر من خلال الرسم البياني.	chf=a,s,00000080

الرجوع إلى الأعلى

تعبئة متدرجة chf [خط، شريط، Google-o-meter، رادار، مبعثر، فين]

يمكنك تطبيق تعبئة تدرج واحدة أو أكثر على المناطق أو الخلفيات في الرسم البياني. تتلاشى التعبئة المتدرجة من لون إلى آخر. (مخططات دائرية ومخططات Google-ometer: الخلفية فقط).

يحدد كل تعبئة تدرج زاوية، ثم يتم ربط لونين أو أكثر بموقع محدد. ويختلف اللون عند انتقاله من علامة ارتساء إلى أخرى. يجب أن يتوفر لديك لونان على الأقل بقيم <color_centerpoint> مختلفة، بحيث يمكن أن يختفي أحدهما الآخر. ويتم تحديد كل تدرج إضافي من خلال زوجَي <color>,<color_centerpoint>.

البنية

chf=<fill_type>,lg,<angle>,<color_1>,<color_centerpoint_1>
    ,...,
  <color_n>,<color_centerpoint_n>

<fill_type>

المنطقة المطلوب ملؤها في الرسم البياني واحد ممّا يلي:

• bg - تعبئة الخلفية
• c - ملء منطقة الرسم البياني
• b<index> - تعبئة متدرجة الشريط (الرسوم البيانية الشريطية فقط) استبدِل <index> بفهرس سلسلة الأشرطة لملئه بأحد التدرجات. للاطّلاع على مثال، راجِع ألوان سلسلة الرسم البياني الشريطي.

lg

تحديد تعبئة متدرجة.

<angle>

رقم يحدّد زاوية التدرج من 0 (أفقي) إلى 90 (عموديًا).

<color>

لون التعبئة بالتنسيق السداسي العشري RRGGBB:

<color_centerpoint>

يحدد نقطة الارتساء للون. سيبدأ اللون في التلاشي من هذه النقطة عند اقترابه من علامة ارتساء أخرى. يتراوح نطاق القيمة من 0.0 (الحافة السفلية أو اليسرى) إلى 1.0 (الحافة العلوية أو اليمنى)، ويتم إمالة النطاق بزاوية مقدارها <angle>.

 

أمثلة

الوصف	مثال
تحتوي منطقة الرسم البياني على تدرج خطي أفقي، ويتم تحديده بزاوية صفر درجة (0). الألوان هي الخوخ (FFE7C6) في الوسط على الجانب الأيسر (الموضع 0.0) والأزرق (76A4FB) في منتصف الجانب الأيمن (الموضع 1.0). خلفية الرسم البياني مرسومة باللون الرمادي (EFEFEF).	chf=   c,lg,0,   FFE7C6,0,(برتقالي فاتح)   76A4FB,1 (أزرق)
تتضمّن منطقة الرسم البياني تدرجًا خطيًا قطريًا (من أسفل اليسار إلى أعلى اليمين) ويتم تحديده بزاوية تبلغ خمسة وأربعين درجة (45). الخوخ (FFE7C6) هو أول لون محدد. ويظهر أسفل يسار الرسم البياني خوخ وردي فاتح. الأزرق (6A4FB) هو اللون الثاني المحدد. ويكون الجزء العلوي الأيمن من الرسم البياني باللون الأزرق الخالص. يُرجى العِلم كيف نحدِّد إزاحة 0.75 لتوفير قمة باللون الأزرق تتلاشى باتجاه الزاوية العلوية اليسرى. خلفية الرسم البياني مرسومة باللون الرمادي (EFEFEF).	chf=   c,lg,45,   FFE7C6,0, (برتقالي فاتح)   76A4FB,0.75 (أزرق)
تحتوي منطقة الرسم البياني على تدرج خطي عمودي (من أعلى إلى أسفل)، ويتم تحديده بزاوية تبلغ 90 درجة (90). الأزرق (76A4FB) هو أول لون محدّد. ويظهر الجزء العلوي من الرسم البياني باللون الأزرق الخالص. الخوخ (FFE7C6) هو اللون الثاني المحدد. ويظهر الجزء السفلي من الرسم البياني بلون وردي فاتح. خلفية الرسم البياني مرسومة باللون الرمادي (EFEFEF).	chf=   c,lg,90,   FFE7C6,0, (برتقالي فاتح)   76A4FB,0.5 (أزرق)

الرجوع إلى الأعلى

 

عمليات التعبئة المخطَّطة chf [خط، شريط، Google-o-meter، رادار، مبعثر، فين]

يمكنك تحديد تعبئة خلفية مخططة لمنطقة الرسم البياني، أو الرسم البياني بالكامل. (مخططات دائرية ومخططات Google-ometer: الخلفية فقط).

البنية

chf=
  <fill_type>,ls,<angle>,<color_1>,<width_1>
    ,...,
  <color_n>,<width_n>

<fill_type>

المنطقة المطلوب ملؤها في الرسم البياني واحد ممّا يلي:

• bg - تعبئة الخلفية
• c - ملء منطقة الرسم البياني
• b<index> - تعبئة مخطط شريطي (المخططات الشريطية فقط). استبدِل <index> بفهرس سلسلة الأشرطة لملئه بالشرائط. راجِع ألوان سلسلة الرسم البياني الشريطي للحصول على مثال.

ls

يحدد ملء الشريط الخطي.

<angle>

زاوية جميع الخطوط بالنسبة إلى المحور الصادي. استخدِم 0 للخطوط العمودية أو 90 للخطوط الأفقية.

<color>

لون هذا الشريط بالتنسيق السداسي العشري RRGGBB. كرِّر استخدام <color> و <width> لكل شريط إضافي. يجب أن يكون لديك شريطان على الأقل. وتتناوب الأشرطة إلى أن يتم ملء الرسم البياني.

<width>

عرض هذا الشريط، من 0 إلى 1، حيث تمثّل 1 عرض الرسم البياني الكامل. يتم تكرار الخطوط حتى يتم ملء الرسم البياني. كرِّر <color> و <width> لكل شريط إضافي. يجب أن يكون لديك شريطان على الأقل. وتتناوب الأشرطة إلى أن يتم ملء الرسم البياني.

 

أمثلة

الوصف	مثال
bg,ls,0 - يتم ملء شريط الخلفية بخطوط بزاوية صفرية للمحور y (بالتزامن مع المحور y). تملأ الخطوط خلفية الرسم البياني ومساحة الرسم أيضًا. CCCCCC,0.15 - يكون الشريط الأول باللون الرمادي الداكن، بعرض الرسم البياني بنسبة 15%. FFFFFF,0.1 - الشريط الثاني باللون الأبيض، بعرض 10% من الرسم البياني.	chf=   bg,ls,0,   CCCCCC,0.15,   FFFFFF,0.1
c,ls,90 - مساحة رسم بياني بخطوط أفقية بزاوية تبلغ 90 درجة من المحور الصادي. تملأ الخطوط مساحة الرسم، ولكن يتم حذف خلفية الرسم البياني. 999999,0.25 - يكون الشريط الأول رماديًا داكنًا، بعرض الرسم البياني بنسبة 25%. CCCCCC,0.25: يكون مماثلاً للشريط الأول، ولكن بلون رمادي أفتح. FFFFFF,0.25 - مثل الشريط الأول، ولكن باللون الأبيض.	chf=   c,ls,90,   999999,0.25,   CCCCCC,0.25,   FFFFFF,0.25

الرجوع إلى الأعلى

دوال البيانات chfd [كل chd الرسوم البيانية]

يمكنك تحديد دالة مخصصة ليتم عرضها على بيانات الرسم البياني باستخدام بنية الدالة muParser. يمكن أن تأتي البيانات المستخدمة في الدالة من أحد المصدرين:

• سلسلة بيانات من chd - يتم سحب البيانات من السلسلة المحدّدة في chd.
• نطاق من القيم التي تم تعريفها في المعلَمة chfd نفسها: يمكنك تعريف قيمة البداية والتوقف والخطوة لنطاق بيانات عشوائي.

من المهم ملاحظة أنّه في جميع الحالات، عليك تخصيص الناتج لسلسلة حالية في chd، وسيتم استبدال هذه السلسلة بمخرجات الدالة. لا يتم عرض الرسم البياني إلا بعد أن تتم معالجة جميع الدوال، لذلك إذا خصّصت دوال متعددة للمخرجات في سلسلة البيانات نفسها، سيتم تنفيذ الدوال بالترتيب المقدم، ولكن سيتم رسم ناتج الدالة النهائية فقط في الرسم البياني. يُرجى العِلم أنّه يمكن ربط الدوال بحيث يمكن استخدام دالة واحدة كمدخل لسلسلة ناتج عن دالة سابقة.

لتخصيص الألوان أو علامات chm لسطر دالة، يمكنك تخصيص الألوان أو العلامات لفهرس السلسلة للدالة. يُرجى العِلم أنّ العلامات يتم وضعها وفقًا للبيانات بعد معالجتها باستخدام الدالة.

البنية

chfd=
  <output_series_index>,<function_data>,<function_string>
    |...|
  <output_series_index>,<function_data>,<function_string>

<output_series_index>

فهرس يستند إلى الصفر لسلسلة بيانات في chd ستتم كتابة ناتج الدالة إليه. سيتم استبدال أي بيانات حالية بالكامل بإخراج الدالة. إذا لم يتم استخدام سلسلة كإدخال لدالة، فإن أفضل ممارسة هي تعيين قيمة وهمية واحدة لتلك السلسلة.

<function_data>

المتغيّرات والبيانات المطلوب رسمها. ويمكن أن تكون البيانات من نطاق تحدده أو من إحدى سلاسل البيانات chd. يمكنك تحديد متغيّرات متعددة لكل دالة باستخدام محدد ; (فاصلة منقوطة) لمتغيّرات متعددة. يُرجى العِلم بأنّه إذا حدّدت متغيّرات متعددة لدالة واحدة، وكان لهذه المتغيّرات عددًا مختلفًا من النقاط، ستتوقف الدالة عند وصولها إلى نقطة النهاية الأولى. على سبيل المثال، إذا كانت الدالة تحدّد كل من الخطوة 1، وx=1، وy=1—10، في الخطوة 1، ستنتهي الدالة عند الوصول إلى النقطة الخامسة.
    <variable_name>,<input_series_index>
         أو
    <variable_name>,<start>,<end>,<step>

• variable_name - اسم سلسلة عشوائية للمتغير. يمكنك استخدام هذا في الدالة المحدّدة بواسطة function_string.
• input_series_index: فهرس سلسلة بيانات chd لاستخدامه كبيانات إدخال.
• start - قيمة البدء الرقمية لنطاق.
• end - قيمة النهاية الرقمية للنطاق.
• step - قيمة الخطوة الرقمية من start إلى end. يمكن أن تكون قيمة موجبة أو سالبة، ولكن لا يمكن أن تكون صفرًا.

أمثلة: x,0,100,1 يعرّف عن متغيّر اسمه x بالقيم 0، 1، 2، ... 100. يعرّف x,0,100,1;r,0,3.1,.1 عن متغير x نفسه بالإضافة إلى متغير باسم r بالقيم 0، 0.1، 0.2، ...، 3.0، 3.1. تعلن x,0 عن متغير اسمه x يستخدم البيانات من أول سلسلة chd. سيتم استخدام هذه المتغيّرات بواسطة function_string. لن يتم تمثيلها على الرسم البياني ما لم تُحدِّدها في function_string. كلما كانت الخطوة أصغر، كان الرسم البياني أكثر سلاسة.

<function_string>

دالةك المكتوبة بلغة muParser. يتم تطبيق الدالة على المتغيّرات والبيانات المحدّدة في variable_data. يمكنك فقط الإشارة إلى المتغيّرات المعلَنة في مجموعة الدوال المحلية هذه، وليس في مجموعة أخرى ضمن الأنابيب تتضمّن معلَمات chfd. وظائف muParser الملخص غير متاحة (الحد الأدنى والحد الأقصى للمجموع والمتوسط). ملاحظة مهمة: عليك تذكر استخدام %2B بدلاً من + في الدوال.

 

أمثلة

الوصف	مثال
موجة جيبية بسيطة. بعض الملاحظات المهمة: chd=t:-1: نستخدم متغيرًا وهميًا لبيانات الرسم البياني، وذلك لأنّه يتم تعريف بياناتنا في معلَمة chfd. chco=FF0000 - تم تحديد اللون الأحمر للسلسلة الأولى. ومع أنّنا لا نستخدم البيانات من chd، سيتم استخدام اللون الموافِق لتلك السلسلة في الدالة المرسومة. chfd=0,x,0,11,0.1,sin(x)*50%2B50 - نُعلن عن متغيّر واحد، يُسمى x، وتكون القيم من 0 إلى 11، وتزيد القيمة بمقدار 0.1. يتم تحديدها للسلسلة الأولى، ما يعني أنّها ستحصل على لون السلسلة الأول (FF0000). الدالة المطبَّقة على x هي sin(x) * 50 + 50. ولاحِظ كيف يجب ترميز الرمز + في تلك الدالة.	cht=lc chd=t:-1 chco=FF0000 chfd=   0,x,0,11,0.1,sin(x)*50%2B50 chxt=x,y
يستخدِم هذا السطر بيانات من مَعلمة chd.	chd=t:5,10 chfd=0,x,0,x*4
يشير ذلك المصطلح إلى مزيج من الخطوط الدوال وغير الدالة. لاحِظ كيف يتم تحديد الألوان من خلال مَعلمة لون السلسلة chco. لاحِظ موضع العلامات في ناتج الدالة، حيث يتم احتساب نقاط البيانات من start وend وstep، فإذا كان نطاقك يتراوح بين 0 و11 خطوة 0.1، والنقطة 0 هو 0، والنقطة 1 هي 0.1 وهكذا، حتى النقطة 110 التي قيمتها 11.	chd=t:   -1   15,45 chco=   FF0000,000000 chfd=   0,x,0,11,0.1,sin(x)*50%2B50 chm=   c,00A5C6,0,110,10   a,00A5C6,0,60,10
لتحديد دالة في سمتَين، استخدِم رسمًا بيانيًا lxy، وعيِّن سلسلتين وهميتين، وحدِّد دالة لكل منهما. 0,x,0,10,0.1,sin(x)*50%2B50 - السلسلة 0 (قيم المحور x) تحتوي على متغيّر باسم x، وقيمته من 0 إلى 10، والخطوة 0.1، ودالة sin(x)*50 + 50 0,y,0,10,0.1,sin(y)*50%2B50 - السلسلة 0 (قيم المحور y) تحتوي على متغير اسمه y، يضم قيمًا من 0 إلى 10، والخطوة 0.1، ودالة sin(x)*50 + 50	cht=lxy chd=t:-1|-1 chfd=   0,x,0,10,0.1,sin(x)*50%2B50|   1,y,0,10,0.1,cos(y)*50%2B50
تتيح لك معلمة chfd إمكانية التعبير عن إبداعك. جرِّب النقر على هذه الصور لفتحها واللعب معها في منطقة الرسم البياني، وبذلك ستنجذب انتباهك.

الرجوع إلى الأعلى