لہذا یہ کوئی تعجب کی بات نہیں ہے کہ آپ کو ایک مخصوص Plotly اعداد و شمار کو HTML سٹرنگ میں تبدیل کرنے کی ضرورت پڑسکتی ہے۔
اس ٹیوٹوریل میں، ہم سیکھیں گے کہ Plotly io ماڈیول کو کس طرح استعمال کرتے ہیں تاکہ کسی فگر کو HTML سٹرنگ کی نمائندگی میں تبدیل کیا جائے۔
آئیے اندر کودیں۔
Plotly.io.to_html() فنکشن
Plotly کے io ماڈیول سے to_html() فنکشن آپ کو ایک پیرامیٹر کے طور پر ایک مخصوص اعداد و شمار کو پاس کرنے اور اسے HTML سٹرنگ میں تبدیل کرنے کی اجازت دیتا ہے۔
فنکشن نحو کا اظہار ذیل میں دکھایا گیا ہے:
سازش سے یہ . to_html ( انجیر , تشکیل = کوئی نہیں۔ , آٹو_پلے = سچ ہے۔ , include_plotlyjs = سچ ہے۔ , شامل_میتھجیکس = جھوٹا۔ , post_script = کوئی نہیں۔ , full_html = سچ ہے۔ , animation_opts = کوئی نہیں۔ , default_width = '100%' , default_height = '100%' , توثیق = سچ ہے۔ , div_id = کوئی نہیں۔ )
آئیے ذیل میں فنکشن کے پیرامیٹرز کو دریافت کریں:
- انجیر - فگر آبجیکٹ یا اعداد و شمار کی لغت کی نمائندگی سے مراد ہے۔
- کنفیگ - plotly.js کنفیگریشن آپشنز کی وضاحت کرتا ہے۔ ترتیب کے اختیارات کو بطور لغت پاس کریں۔
- آٹو_پلے - اس بات کا تعین کرتا ہے کہ آیا صفحہ لوڈ پر اینیمیشن کی ترتیب خود بخود چلنی چاہیے۔ یہ پیرامیٹر مفید ہے اگر آپ کے پاس اینی میٹڈ فریموں پر مشتمل فگر ہو۔
- Include_plotlyjs - یہ پیرامیٹر بتاتا ہے کہ plotly.js لائبریری کو HTML میں کیسے شامل کیا جاتا ہے۔ اس پیرامیٹر میں قبول شدہ اقدار میں شامل ہیں:
- True - HTML دستاویز میں اسکرپٹ ٹیگ کے طور پر plotly.js لائبریری شامل ہے۔ یہ فائل کے سائز میں اضافہ کرے گا لیکن فائل کو آف لائن ماحول میں استعمال کرنے کی اجازت دے گا۔
- 'cdn' - Include_plotlyjs پیرامیٹر کو 'cdn' پر سیٹ کرنے سے plotly.js لائبریری کے لیے ریموٹ لنک کی طرف اشارہ کرنے والا اسکرپٹ ٹیگ شامل ہو جائے گا۔ یہ اختیار استعمال کریں جب نیٹ ورک ماحول یا فائل سائز حساس ماحول میں ہو۔
- 'ڈائریکٹری' - ایک اسکرپٹ ٹیگ پر مشتمل ہے جو HTML دستاویز کے طور پر اسی ڈائریکٹری میں واقع ایک بیرونی plotly.min.js بنڈل کی طرف اشارہ کرتا ہے۔
- 'require' - مطلوبہ قدر کو سیٹ کرنے سے plotly.js لائبریری require.js کا استعمال کر کے لوڈ کر دے گی۔ یقینی بنائیں کہ need.js انسٹال ہے اور سسٹم پر عالمی سطح پر دستیاب ہے۔
- 'False' - اس میں plotly.js لائبریری شامل نہیں ہے۔ full_html پیرامیٹر کو True پر سیٹ کرتے وقت اس قدر سے گریز کریں کیونکہ یہ پوری دستاویز کو ناقابل استعمال بنا دے گا۔
- include_mathjax - یہ بتاتا ہے کہ کیا فائل میں mathjax.js لائبریری شامل ہونی چاہیے۔ قبول شدہ قدریں شامل_پلوٹلیز سے ملتی جلتی ہیں سوائے 'ضرورت' قدر کے۔
- Post_script - آپ کو جاوا اسکرپٹ کے ٹکڑوں کو شامل کرنے کی اجازت دیتا ہے جو پلاٹ کی تخلیق کے بعد عمل میں آتے ہیں۔
- Full_html - اگر درست ہے تو، فنکشن ٹیگز سے شروع ہونے والی پوری HTML دستاویز پر مشتمل ایک تار واپس کرے گا۔ غلط ہونے کی صورت میں، فنکشن عنصر سے شروع ہونے والی HTML سٹرنگ لوٹائے گا۔
- Animation_opts - آپ کو اپنی مرضی کے مطابق حرکت پذیری کی خصوصیات کو بطور لغت بتانے کی اجازت دیتا ہے۔ ان اقدار کو پھر plotly.js میں plotly.animate فنکشن میں منتقل کیا جاتا ہے۔
- Default_width - پکسلز میں نتیجے کے اعداد و شمار کی ڈیفالٹ چوڑائی کی وضاحت کرتا ہے.
- Default_height - پکسلز میں اعداد و شمار کی ڈیفالٹ اونچائی کی وضاحت کرتا ہے.
- توثیق کریں - اس بات کا تعین کرتا ہے کہ آیا HTML سٹرنگ میں تبدیل ہونے سے پہلے اعداد و شمار کی توثیق کی جانی چاہیے۔
- Div_id - div ٹیگ کے id انتساب کی قدر کی وضاحت کرتا ہے جہاں پلاٹ واقع ہے۔
پھر، فنکشن سٹرنگ کے طور پر اعداد و شمار کی سٹرنگ کی نمائندگی کرتا ہے۔
استعمال کی مثال
مندرجہ ذیل کوڈ دکھاتا ہے کہ to_html فنکشن کو کس طرح استعمال کیا جائے تاکہ کسی اعداد و شمار کو HTML سٹرنگ کی نمائندگی میں تبدیل کیا جائے۔
درآمد سازش سے اظہار کے طور پر px
ڈی ایف = px ڈیٹا . اسٹاک ( انڈیکسڈ = سچ ہے۔ )
انجیر = px رقبہ ( ڈی ایف , facet_col = 'کمپنی' , facet_col_wrap = دو )
انجیر. دکھائیں ( )اوپر کی مثال میں، ہم Plotly ایکسپریس ماڈیول کو px کے طور پر درآمد کرکے شروع کرتے ہیں۔ اس کے بعد ہم Plotly سے اسٹاک ڈیٹا کا استعمال کرتے ہوئے ڈیٹا فریم بناتے ہیں۔
آخر میں، ہم px.area فنکشن کا استعمال کرتے ہوئے ایک پہلو والا ایریا پلاٹ بناتے ہیں۔ یہ ایک اعداد و شمار واپس کرے جیسا کہ ذیل میں دکھایا گیا ہے:
ہم مندرجہ بالا اعداد و شمار کو ایچ ٹی ایم ایل سٹرنگ کی نمائندگی میں تبدیل کر سکتے ہیں جیسا کہ ذیل کے کوڈ میں دکھایا گیا ہے:
درآمد سازش سے یہ کے طور پر یہ
یہ. to_html ( انجیر , full_html = جھوٹا۔ )مندرجہ بالا کوڈ کو چلانے سے ایک بڑے پیمانے پر HTML سٹرنگ واپس آنی چاہیے جیسا کہ ذیل کے اسکرین شاٹ میں دکھایا گیا ہے:
نوٹ کریں کہ HTML دستاویز
عنصر سے شروع ہوتی ہے۔ اگر آپ پوری HTML فائل کو شامل کرنا چاہتے ہیں تو پیرامیٹر full_html=True کو سیٹ کریں جیسا کہ دکھایا گیا ہے: درآمد سازش سے یہ کے طور پر یہ
یہ. to_html ( انجیر , full_html = سچ ہے۔ )
نوٹ کریں کہ مارک اپ ٹیگ سے شروع ہوتا ہے۔
plotly.js کو شامل کرنے کے لیے، ہم پیرامیٹر کو اس طرح سیٹ کر سکتے ہیں:
درآمد سازش سے یہ کے طور پر یہ
یہ. to_html ( انجیر , include_plotlyjs = 'cdn' , full_html = سچ ہے۔ )اوپر کی مثال میں، ہم فنکشن سے کہتے ہیں کہ plotly.js لائبریری کو CDN لنک کے ذریعے شامل کریں۔
ہم ذیل میں آؤٹ پٹ سے اس کی تصدیق کر سکتے ہیں:
to_html دستاویز کو استعمال کرنے کا بہترین طریقہ HTML سٹرنگ کو HTML فائل میں برآمد کرنا ہے۔
ہم ذیل میں دکھایا گیا ایک سادہ کوڈ چلا کر ایسا کر سکتے ہیں:
درآمد سازش سے یہ کے طور پر یہ
کے ساتھ کھلا ( 'facetted.html' , 'میں' ) کے طور پر f:
f لکیریں ( یہ. to_html ( انجیر , include_plotlyjs = 'cnd' , full_html = سچ ہے۔ ) )اس مثال میں، ہم Python میں فائل ماڈیول کو HTML سٹرنگ کو aN html فائل کے طور پر لکھنے کے لیے استعمال کرتے ہیں۔
اس کے بعد ہم براؤزر میں ایچ ٹی ایم ایل دستاویز کھول سکتے ہیں اور تصویر کو دیکھ سکتے ہیں جیسا کہ دکھایا گیا ہے:
نتیجہ
مبارک ہو، آپ نے plotly.io.to_html فنکشن کا استعمال کرتے ہوئے کامیابی کے ساتھ اپنے Plotly کے اعداد و شمار کو HTML سٹرنگ کے طور پر برآمد کر لیا ہے۔