Поэтому неудивительно, что вам может понадобиться преобразовать определенную фигуру Plotly в строку HTML.
В этом уроке мы узнаем, как использовать модуль Plotly io для преобразования фигуры в строковое представление HTML.
Давайте углубимся.
Функция Plotly.io.to_html()
Функция to_html() из модуля ввода-вывода Plotly позволяет вам передать конкретную цифру в качестве параметра и преобразовать ее в строку HTML.
Синтаксис функции выражается, как показано ниже:
сюжетно. это . to_html ( Рис , конфигурация знак равно Никто , Автовоспроизведение знак равно Истинный , include_plotlyjs знак равно Истинный , include_mathjax знак равно ЛОЖЬ , пост_скрипт знак равно Никто , full_html знак равно Истинный , анимация_opts знак равно Никто , default_width знак равно «100%» , default_height знак равно «100%» , подтверждать знак равно Истинный , div_id знак равно Никто )
Давайте рассмотрим параметры функции ниже:
- Fig — относится к объекту фигуры или словарному представлению фигуры.
- Config — указывает параметры конфигурации plotly.js. Передайте параметры конфигурации в виде словаря.
- Auto_play — определяет, должна ли последовательность анимации воспроизводиться автоматически при загрузке страницы. Этот параметр полезен, если у вас есть фигура, содержащая анимированные кадры.
- Include_plotlyjs — этот параметр указывает, как библиотека plotly.js включается в HTML. Допустимые значения этого параметра включают:
- True — включает библиотеку plotly.js в качестве тега скрипта в HTML-документ. Это увеличит размер файла, но позволит использовать файл в автономном режиме.
- «cdn» — установка для параметра include_plotlyjs значения «cdn» добавит тег скрипта, указывающий на удаленную ссылку для библиотеки plotly.js. Используйте этот параметр при работе в сетевой среде или в среде с чувствительным к размеру файла.
- «каталог» — включает тег script, указывающий на внешний пакет 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-документ, начиная с тегов . Если false, функция вернет строку HTML, начинающуюся с элемента .
- Animation_opts — позволяет указать пользовательские свойства анимации в виде словаря. Затем эти значения передаются функции plotly.animate в plotly.js.
- Default_width — определяет ширину результирующей фигуры по умолчанию в пикселях.
- Default_height — указывает высоту фигуры по умолчанию в пикселях.
- Проверить — определяет, следует ли проверять фигуру перед преобразованием в строку HTML.
- Div_id — указывает значение атрибута id тега div, в котором находится график.
Затем функция возвращает строковое представление фигуры в виде строки.
Пример использования
В следующем коде показано, как использовать функцию to_html для преобразования рисунка в строковое представление HTML.
импорт сюжетно. выражать в качестве пикс.
дф знак равно пикс. данные . акции ( проиндексирован знак равно Истинный )
Рис знак равно пикс. область ( дф , facet_col знак равно 'Компания' , facet_col_wrap знак равно два )
инжир. показывать ( )В приведенном выше примере мы начинаем с импорта экспресс-модуля Plotly как px. Затем мы создаем фрейм данных, используя данные о запасах из Plotly.
Наконец, мы создаем график с гранями, используя функцию px.area. Это должно вернуть фигуру, как показано ниже:
Мы можем преобразовать приведенный выше рисунок в строковое представление HTML, как показано в коде ниже:
импорт сюжетно. это в качестве это
это. 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.
Мы можем сделать это, запустив простой код, как показано ниже:
импорт сюжетно. это в качестве это
с открытым ( 'faceted.html' , 'в' ) в качестве ф:
ф. строчки ( это. to_html ( Рис , include_plotlyjs знак равно 'конд' , full_html знак равно Истинный ) )В этом примере мы используем файловый модуль в Python для записи строки HTML в виде HTML-файла.
Затем мы можем открыть документ HTML в браузере и просмотреть рисунок, как показано ниже:
Вывод
Поздравляем, вы успешно экспортировали фигуру Plotly в виде строки HTML с помощью функции plotly.io.to_html.