Plotly.io.to_templated

هيا بنا نتعمق.

تركيب الوظيفة

توفر الوظيفة بنية بسيطة تسمح لك بالتركيز على الكود. يتم التعبير عن بناء الجملة على النحو التالي:

معلمات الوظيفة هي:

1. التين - يحدد كائن الشكل الذي ترغب في نقل نمطه إلى قالب.
2. تخطي - يحدد مجموعة أسماء الخصائص التي ترغب في استبعادها عند نقل النمط إلى قالب. بشكل افتراضي ، يتم تضمين خاصية العنوان فقط. يؤدي ذلك إلى منع استيراد نص الشكل ، مثل عناوين المحاور ، بواسطة أشكال أخرى.

يعرض الشكل نسخة من الشكل مع نقل التصميم إلى قالب. نوع العودة من go.

مثال

دعونا نوضح كيف يمكننا استخدام وظيفة to_templated () لتصدير تصميم شكل معين إلى قالب.

لنبدأ بإنشاء شخصية ذات تصميم مخصص. يظهر رمز مثال أدناه:

في هذا المثال ، نقوم بإنشاء مخطط مبعثر بتصميم نص مخصص مثل عائلة الخط ولون الخط وحجم الخط وما إلى ذلك.

يجب أن يُرجع الكود أعلاه مخطط تبعثر بسيط كما هو موضح:

يمكننا تحويل هذا الشكل إلى شكل باستخدام قالب تصميم باستخدام دالة to_template ().

رمز المثال هو كما هو موضح:

في الكود أعلاه ، نبدأ باستيراد وحدة plotly io كـ io. نقوم بعد ذلك بإنشاء نسخة من الشكل مع التصميم المحفوظ في قالب مخصص باستخدام وظيفة to_templated ().

يمكننا عرض القالب عن طريق تشغيل الكود:

يجب أن يعيد هذا قاموسًا بخصائص تحدد تصميم الشكل. مثال على قيمة الإخراج كما هو موضح:

يمكنك عرض الشكل ببساطة عن طريق استدعاء القالب المحفوظ على النحو التالي:

يجب أن يعرض هذا الشكل المحفوظ في النموذج.

قم بإنشاء شكل باستخدام القالب

بمجرد حفظ تصميم الشكل في قالب مخصص ، يمكننا استخدام هذا القالب لتطبيق التصميم على شكل آخر.

رمز المثال هو كما هو موضح:

في المثال أعلاه ، نبدأ باستيراد وحدة Graph_objects من Plotly. في هذه الحالة ، نستخدم Graph_objects كما نرغب في إنشاء شكل فارغ ولكننا نستخدم التصميم فقط.

باستخدام وظيفة go.Figure () ، نقوم بتمرير معلمة التنسيق وتحديد القالب المستهدف باستخدام خاصية 'template'.

يمكننا بعد ذلك عرض الشكل الناتج عن طريق استدعاء new_fig. يجب أن يعود هذا:

لاحظ أن الشكل أعلاه لا يحتوي على أي بيانات أو نص. يتضمن فقط الأنماط ، مثل لون النص وعائلة الخط وحجم الخط وما إلى ذلك.

لإنشاء مخطط مبعثر باستخدام هذا القالب ، يمكننا استخدام الكود كما هو موضح:

يجب أن يعرض المثال أعلاه رقمًا كما هو موضح:

لاحظ أن لون الخط والعائلة والحجم متشابهين مع المجموعة الموجودة في القالب.

حفظ قالب مسمى

يمكننا حفظ القالب المخصص باستخدام كائن القوالب كما هو موضح في الكود أدناه:

سيحفظ الرمز أعلاه النموذج تحت الاسم 'my_custom_template'. يمكنك بعد ذلك استخدام هذا الاسم لتحديد النموذج الذي ترغب في استخدامه:

استنتاج

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