ดังนั้นจึงไม่น่าแปลกใจที่คุณอาจต้องแปลงตัวเลข Plotly ที่เฉพาะเจาะจงเป็นสตริง HTML
ในบทช่วยสอนนี้ เราจะเรียนรู้วิธีใช้โมดูล Plotly io เพื่อแปลงร่างเป็นการแสดงสตริง HTML
มาดำดิ่งกัน
Plotly.io.to_html() ฟังก์ชั่น
ฟังก์ชัน to_html() จากโมดูล io ของ Plotly ช่วยให้คุณสามารถส่งผ่านตัวเลขเฉพาะเป็นพารามิเตอร์และแปลงเป็นสตริง HTML
ไวยากรณ์ของฟังก์ชันแสดงดังที่แสดงด้านล่าง:
พล็อต นี้ . to_html ( รูปที่ , config = ไม่มี , เล่นอัตโนมัติ = จริง , รวม_plotlyjs = จริง , รวม_mathjax = เท็จ , post_script = ไม่มี , full_html = จริง , แอนิเมชั่น_opts = ไม่มี , default_width = '100%' , default_height = '100%' , ตรวจสอบความถูกต้อง = จริง , div_id = ไม่มี )
ให้เราสำรวจพารามิเตอร์ของฟังก์ชันด้านล่าง:
- รูป - หมายถึงวัตถุรูปหรือการแสดงพจนานุกรมของรูป
- Config – ระบุตัวเลือกการกำหนดค่า plotly.js ส่งผ่านตัวเลือกการกำหนดค่าเป็นพจนานุกรม
- Auto_play – กำหนดว่าลำดับภาพเคลื่อนไหวควรเล่นโดยอัตโนมัติในการโหลดหน้าเว็บหรือไม่ พารามิเตอร์นี้มีประโยชน์หากคุณมีฟิกเกอร์ที่มีเฟรมเคลื่อนไหว
- Include_plotlyjs – พารามิเตอร์นี้ระบุว่าไลบรารี plotly.js รวมอยู่ใน HTML อย่างไร ค่าที่ยอมรับในพารามิเตอร์นี้รวมถึง:
- จริง – รวมไลบรารี plotly.js เป็นแท็กสคริปต์ในเอกสาร HTML การทำเช่นนี้จะเพิ่มขนาดไฟล์ แต่จะอนุญาตให้ใช้ไฟล์ในสภาพแวดล้อมออฟไลน์
- 'cdn' – การตั้งค่าพารามิเตอร์ include_plotlyjs เป็น 'cdn' จะเพิ่มแท็กสคริปต์ที่ชี้ไปยังลิงก์ระยะไกลสำหรับไลบรารี plotly.js ใช้ตัวเลือกนี้เมื่ออยู่ในสภาพแวดล้อมแบบเครือข่ายหรือสภาพแวดล้อมที่คำนึงถึงขนาดไฟล์
- 'ไดเรกทอรี' - รวมแท็กสคริปต์ที่ชี้ไปยังบันเดิล plotly.min.js ภายนอกที่อยู่ในไดเร็กทอรีเดียวกันกับเอกสาร HTML
- 'ต้องการ' - การตั้งค่าที่ต้องการจะโหลดไลบรารี plotly.js โดยใช้ require.js ตรวจสอบให้แน่ใจว่า require.js ได้รับการติดตั้งและพร้อมใช้งานทั่วโลกบนระบบ
- ‘เท็จ’ – ไม่รวมไลบรารี plotly.js หลีกเลี่ยงค่านี้เมื่อตั้งค่าพารามิเตอร์ full_html เป็น True เนื่องจากจะทำให้ทั้งเอกสารใช้ไม่ได้
- include_mathjax – ระบุว่าไฟล์ควรมีไลบรารี mathjax.js หรือไม่ ค่าที่ยอมรับจะคล้ายกับ include_plotlyjs ยกเว้นค่า 'require'
- Post_script – อนุญาตให้คุณรวมข้อมูลโค้ด JavaScript ที่ดำเนินการหลังจากสร้างพล็อต
- Full_html – ถ้าเป็นจริง ฟังก์ชันจะส่งคืนสตริงที่มีเอกสาร HTML ทั้งหมด เริ่มต้นด้วยแท็ก หากเป็นเท็จ ฟังก์ชันจะส่งคืนสตริง HTML ที่ขึ้นต้นด้วยองค์ประกอบ
- Animation_opts – อนุญาตให้คุณระบุคุณสมบัติแอนิเมชั่นที่กำหนดเองเป็นพจนานุกรม ค่าเหล่านี้จะถูกส่งต่อไปยังฟังก์ชัน plotly.animate ใน plotly.js
- Default_width – ระบุความกว้างเริ่มต้นของตัวเลขผลลัพธ์เป็นพิกเซล
- Default_height – ระบุความสูงเริ่มต้นของตัวเลขเป็นพิกเซล
- ตรวจสอบ - กำหนดว่าควรตรวจสอบตัวเลขก่อนแปลงเป็นสตริง HTML หรือไม่
- Div_id – ระบุค่าของแอตทริบิวต์ id ของแท็ก div ที่พล็อตตั้งอยู่
จากนั้น ฟังก์ชันจะส่งกลับการแสดงสตริงของรูปเป็นสตริง
ตัวอย่างการใช้งาน
รหัสต่อไปนี้แสดงวิธีใช้ฟังก์ชัน to_html เพื่อแปลงร่างเป็นการแสดงสตริง HTML
นำเข้า พล็อต ด่วน เช่น px
df = พิกเซล ข้อมูล . หุ้น ( จัดทำดัชนี = จริง )
รูปที่ = พิกเซล พื้นที่ ( df , facet_col = 'บริษัท' , facet_col_wrap = สอง )
รูปที่. แสดง ( )ในตัวอย่างข้างต้น เราเริ่มต้นด้วยการนำเข้าโมดูล Plotly express เป็น px จากนั้นเราสร้าง data frame โดยใช้ข้อมูลหุ้นจาก Plotly
สุดท้าย เราสร้างพล็อตพื้นที่เหลี่ยมเพชรพลอยโดยใช้ฟังก์ชัน px.area สิ่งนี้ควรส่งคืนตัวเลขที่แสดงด้านล่าง:
เราสามารถแปลงตัวเลขด้านบนเป็นการแสดงสตริง HTML ตามที่แสดงในโค้ดด้านล่าง:
นำเข้า พล็อต นี้ เช่น นี้
นี้. to_html ( รูปที่ , full_html = เท็จ )การเรียกใช้โค้ดด้านบนควรส่งคืนสตริง HTML ขนาดใหญ่ตามที่แสดงในภาพหน้าจอด้านล่าง:
โปรดทราบว่าเอกสาร HTML เริ่มต้นที่
องค์ประกอบ หากคุณต้องการรวมไฟล์ HTML ทั้งหมด ให้ตั้งค่าพารามิเตอร์ full_html=True ดังที่แสดง: นำเข้า พล็อต นี้ เช่น นี้
นี้. to_html ( รูปที่ , full_html = จริง )สังเกตว่ามาร์กอัปเริ่มต้นที่แท็ก
ในการรวม plotly.js เราสามารถตั้งค่าพารามิเตอร์เป็น:
นำเข้า พล็อต นี้ เช่น นี้
นี้. to_html ( รูปที่ , รวม_plotlyjs = 'cdn' , full_html = จริง )ในตัวอย่างข้างต้น เราบอกให้ฟังก์ชันรวมไลบรารี plotly.js ผ่านลิงก์ CDN
เราสามารถตรวจสอบได้จากผลลัพธ์ด้านล่าง:
วิธีที่ดีที่สุดในการใช้เอกสาร to_html คือการส่งออกสตริง HTML ลงในไฟล์ HTML
เราสามารถทำได้โดยการรันโค้ดง่ายๆ ดังที่แสดงด้านล่าง:
นำเข้า พล็อต นี้ เช่น นี้
กับ เปิด ( 'facetted.html' , 'ใน' ) เช่น ฉ:
ฉ. สายการเขียน ( นี้. to_html ( รูปที่ , รวม_plotlyjs = 'ซีเอ็นดี' , full_html = จริง ) )ในตัวอย่างนี้ เราใช้โมดูลไฟล์ใน Python เพื่อเขียนสตริง HTML เป็นไฟล์ N html
จากนั้นเราสามารถเปิดเอกสาร HTML ในเบราว์เซอร์และดูรูปภาพดังที่แสดง:
บทสรุป
ขอแสดงความยินดี คุณส่งออกตัวเลข Plotly ของคุณเป็นสตริง HTML สำเร็จโดยใช้ฟังก์ชัน plotly.io.to_html