Следователно не е изненада, че може да се наложи да конвертирате конкретна фигура на Plotly в HTML низ.
В този урок ще научим как да използваме модула Plotly io, за да конвертираме фигура в представяне на HTML низ.
Нека се потопим.
Функция Plotly.io.to_html().
Функцията to_html() от io модула на Plotly ви позволява да предадете конкретна цифра като параметър и да я конвертирате в HTML низ.
Синтаксисът на функцията се изразява, както е показано по-долу:
сюжетно. това . to_html ( фиг , конфиг = Нито един , автоматично изпълнение = Вярно , include_plotlyj = Вярно , include_mathjax = Невярно , post_script = Нито един , full_html = Вярно , animation_opts = Нито един , ширина_по подразбиране = '100%' , височина_по подразбиране = '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 документа.
- ‘require’ – задаването на стойността на require ще зареди библиотеката plotly.js с помощта на require.js. Уверете се, че require.js е инсталиран и достъпен глобално в системата.
- „False“ – не включва библиотеката plotly.js. Избягвайте тази стойност, когато задавате параметъра full_html на True, тъй като тя ще направи целия документ неизползваем.
- include_mathjax – указва дали файлът трябва да включва библиотеката mathjax.js. Приетите стойности са подобни на include_plotlyjs с изключение на стойността „require“.
- Post_script – позволява ви да включите JavaScript фрагменти, които се изпълняват след създаването на графиката.
- Full_html – ако е true, функцията ще върне низ, съдържащ целия HTML документ, започващ с таговете . Ако е невярно, функцията ще върне HTML низ, започващ с елемента .
- Animation_opts – позволява ви да зададете персонализирани свойства на анимацията като речник. След това тези стойности се предават на функцията plotly.animate в plotly.js.
- Default_width – определя ширината по подразбиране на получената фигура в пиксели.
- Default_height – определя височината по подразбиране на фигурата в пиксели.
- Валидиране – определя дали фигурата трябва да бъде валидирана, преди да бъде преобразувана в HTML низ.
- Div_id – указва стойност на атрибута id на тага div, където се намира диаграмата.
След това функцията връща низово представяне на фигурата като низ.
Примерна употреба
Следният код показва как да използвате функцията to_html за преобразуване на фигура в представяне на HTML низ.
импортиране сюжетно. експресен като px
df = px. данни . запаси ( индексиран = Вярно )
фиг = px. ■ площ ( df , facet_col = 'търговско дружество' , facet_col_wrap = две )
фиг. шоу ( )В горния пример започваме с импортиране на модула Plotly express като px. След това създаваме рамка с данни, използвайки данните за запасите от Plotly.
И накрая, ние създаваме диаграма с фасетирана площ, използвайки функцията px.area. Това трябва да върне фигура, както е показано по-долу:
Можем да преобразуваме горната фигура в представяне на HTML низ, както е показано в кода по-долу:
импортиране сюжетно. това като това
това. to_html ( фиг , full_html = Невярно )Изпълнението на горния код трябва да върне масивен HTML низ, както е показано на екранната снимка по-долу:
Имайте предвид, че HTML документът започва от елемента
. Ако искате да включите целия HTML файл, задайте параметъра full_html=True, както е показано: импортиране сюжетно. това като това
това. to_html ( фиг , full_html = Вярно )
Забележете, че маркирането започва от тага .
За да включим plotly.js, можем да зададем параметъра като:
импортиране сюжетно. това като това
това. to_html ( фиг , include_plotlyj = 'cdn' , full_html = Вярно )В горния пример казваме на функцията да включи библиотеката plotly.js чрез CDN връзка.
Можем да проверим това от резултата по-долу:
Най-добрият начин да използвате документа to_html е като експортирате HTML низа в HTML файл.
Можем да направим това, като изпълним прост код, както е показано по-долу:
импортиране сюжетно. това като това
с отворен ( 'facetted.html' , 'вътре' ) като е:
f. линии за писане ( това. to_html ( фиг , include_plotlyj = 'cnd' , full_html = Вярно ) )В този пример използваме файловия модул в Python, за да напишем HTML низа като N html файл.
След това можем да отворим HTML документа в браузъра и да видим фигурата, както е показано:
Заключение
Поздравления, успешно експортирахте фигурата си от Plotly като HTML низ с помощта на функцията plotly.io.to_html.