Plotly.io.to_html

Plotly Io To Html



Ngôn ngữ đánh dấu siêu văn bản hoặc tài liệu HTML là tài liệu đánh dấu cho phép bạn hiển thị thông tin trên World Wide Web. Khi bạn đang xem một trang web cụ thể, bạn đang sử dụng một tài liệu HTML.

Do đó, không có gì ngạc nhiên khi bạn có thể cần chuyển đổi một con số Plotly cụ thể thành một chuỗi HTML.

Trong hướng dẫn này, chúng ta sẽ học cách sử dụng mô-đun Plotly io để chuyển đổi một hình thành biểu diễn chuỗi HTML.







Hãy đi sâu vào.



Hàm Plotly.io.to_html ()

Hàm to_html () từ mô-đun Plotly’s io cho phép bạn chuyển một số liệu cụ thể dưới dạng tham số và chuyển đổi nó thành một chuỗi HTML.



Cú pháp hàm được thể hiện như hình dưới đây:





có âm mưu. đây . to_html ( quả sung , cấu hình = Không có , tự chạy = ĐÚNG VẬY , include_plotlyjs = ĐÚNG VẬY , include_mathjax = Sai , post_script = Không có , full_html = ĐÚNG VẬY , animation_opts = Không có , default_width = '100%' , default_height = '100%' , xác nhận = ĐÚNG VẬY , div_id = Không có )

Hãy cùng chúng tôi khám phá các tham số của hàm dưới đây:

  1. Hình - đề cập đến đối tượng hình hoặc đại diện từ điển của hình.
  2. Cấu hình - chỉ định các tùy chọn cấu hình plotly.js. Chuyển các tùy chọn cấu hình làm từ điển.
  3. Auto_play - xác định xem chuỗi hoạt ảnh có nên phát tự động khi tải trang hay không. Tham số này rất hữu ích nếu bạn có một hình chứa các khung hoạt hình.
  4. Bao gồm_plotlyjs - tham số này chỉ định cách thư viện plotly.js được đưa vào HTML. Các giá trị được chấp nhận trong tham số này bao gồm:
    • True - bao gồm thư viện plotly.js dưới dạng thẻ script trong tài liệu HTML. Điều này sẽ làm tăng kích thước tệp nhưng sẽ cho phép tệp được sử dụng trong môi trường ngoại tuyến.
    • ‘Cdn’ - đặt tham số include_plotlyjs thành ‘cdn’ sẽ thêm thẻ script trỏ đến liên kết từ xa cho thư viện plotly.js. Sử dụng tùy chọn này khi ở trong môi trường có mạng hoặc môi trường nhạy cảm với kích thước tệp.
    • ‘Directory’ - bao gồm một thẻ script trỏ đến một gói plotly.min.js bên ngoài nằm trong cùng một thư mục với tài liệu HTML.
    • ‘Request’ - đặt giá trị thành request sẽ tải thư viện plotly.js bằng cách sử dụng request.js. Đảm bảo rằng request.js đã được cài đặt và có sẵn trên toàn cầu trên hệ thống.
    • ‘Sai’ - không bao gồm thư viện plotly.js. Tránh giá trị này khi đặt tham số full_html thành True vì nó sẽ hiển thị toàn bộ tài liệu, không thể sử dụng được.
  5. include_mathjax - chỉ định xem tệp có nên bao gồm thư viện mathjax.js hay không. Các giá trị được chấp nhận tương tự như include_plotlyjs ngoại trừ giá trị ‘request’.
  6. Post_script - cho phép bạn bao gồm các đoạn mã JavaScript được thực thi sau khi tạo cốt truyện.
  7. Full_html - nếu đúng, hàm sẽ trả về một chuỗi chứa toàn bộ tài liệu HTML, bắt đầu bằng các thẻ . Nếu sai, hàm sẽ trả về một chuỗi HTML bắt đầu bằng phần tử
    .
  8. Animation_opts - cho phép bạn chỉ định các thuộc tính hoạt ảnh tùy chỉnh như một từ điển. Các giá trị này sau đó được chuyển đến hàm plotly.animate trong plotly.js.
  9. Default_width - chỉ định chiều rộng mặc định của hình kết quả tính bằng pixel.
  10. Default_height - chỉ định chiều cao mặc định của hình tính bằng pixel.
  11. Xác thực - xác định xem hình có nên được xác thực trước khi được chuyển đổi thành chuỗi HTML hay không.
  12. Div_id - chỉ định một giá trị của thuộc tính id của thẻ div nơi đặt biểu đồ.

Sau đó, hàm trả về một biểu diễn chuỗi của hình dưới dạng một chuỗi.



Cách sử dụng ví dụ

Đoạn mã sau đây cho thấy cách sử dụng hàm to_html để chuyển đổi một hình thành biểu diễn chuỗi HTML.

nhập khẩu có âm mưu. bày tỏ như px

df = px. dữ liệu . cổ phiếu ( lập chỉ mục = ĐÚNG VẬY )

quả sung = px. diện tích ( df , facet_col = 'Công ty' , facet_col_wrap = hai )

quả sung. buổi bieu diễn ( )

Trong ví dụ trên, chúng ta bắt đầu bằng cách nhập mô-đun Plotly express dưới dạng px. Sau đó, chúng tôi tạo một khung dữ liệu bằng cách sử dụng dữ liệu cổ phiếu từ Plotly.

Cuối cùng, chúng ta tạo một biểu đồ khu vực có khía cạnh bằng cách sử dụng hàm px.area. Điều này sẽ trả về một hình như được hiển thị bên dưới:

Chúng ta có thể chuyển đổi hình trên thành biểu diễn chuỗi HTML như được hiển thị trong đoạn mã dưới đây:

nhập khẩu có âm mưu. đây như đây

đây. to_html ( quả sung , full_html = Sai )

Chạy đoạn mã trên sẽ trả về một chuỗi HTML lớn như được hiển thị trong ảnh chụp màn hình bên dưới:

Lưu ý rằng tài liệu HTML bắt đầu từ phần tử

. Nếu bạn muốn bao gồm toàn bộ tệp HTML, hãy đặt tham số full_html = True như hình minh họa:

nhập khẩu có âm mưu. đây như đây

đây. to_html ( quả sung , full_html = ĐÚNG VẬY )

Lưu ý rằng đánh dấu bắt đầu ở thẻ .

Để bao gồm plotly.js, chúng ta có thể đặt tham số là:

nhập khẩu có âm mưu. đây như đây

đây. to_html ( quả sung , include_plotlyjs = 'cdn' , full_html = ĐÚNG VẬY )

Trong ví dụ trên, chúng tôi yêu cầu hàm bao gồm thư viện plotly.js thông qua liên kết CDN.

Chúng tôi có thể xác minh điều này từ đầu ra bên dưới:

Cách tốt nhất để sử dụng tài liệu to_html là xuất chuỗi HTML thành tệp HTML.

Chúng ta có thể thực hiện việc này bằng cách chạy một đoạn mã đơn giản như hình dưới đây:

nhập khẩu có âm mưu. đây như đây

với mở ( 'facetted.html' , 'Trong' ) như f:

f. writelines ( đây. to_html ( quả sung , include_plotlyjs = 'cnd' , full_html = ĐÚNG VẬY ) )

Trong ví dụ này, chúng tôi sử dụng mô-đun tệp bằng Python để viết chuỗi HTML dưới dạng tệp html aN.

Sau đó, chúng ta có thể mở tài liệu HTML trong trình duyệt và xem hình như minh họa:

Sự kết luận

Xin chúc mừng, bạn đã xuất thành công hình Plotly của mình dưới dạng chuỗi HTML bằng cách sử dụng hàm plotly.io.to_html.