Plotly.io.to_html

Plotly Io To Html

Язык гипертекстовой разметки или HTML-документы — это документы разметки, которые позволяют отображать информацию во всемирной паутине. Когда вы просматриваете определенный веб-сайт, вы используете HTML-документ.

Поэтому неудивительно, что вам может понадобиться преобразовать определенную фигуру 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 знак равно Никто )

Давайте рассмотрим параметры функции ниже:

  1. Fig — относится к объекту фигуры или словарному представлению фигуры.
  2. Config — указывает параметры конфигурации plotly.js. Передайте параметры конфигурации в виде словаря.
  3. Auto_play — определяет, должна ли последовательность анимации воспроизводиться автоматически при загрузке страницы. Этот параметр полезен, если у вас есть фигура, содержащая анимированные кадры.
  4. 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, так как это сделает весь документ непригодным для использования.
  5. include_mathjax — указывает, должен ли файл включать библиотеку mathjax.js. Принятые значения аналогичны include_plotlyjs, за исключением значения «require».
  6. Post_script — позволяет включать фрагменты JavaScript, которые выполняются после создания сюжета.
  7. Full_html — если true, функция вернет строку, содержащую весь HTML-документ, начиная с тегов . Если false, функция вернет строку HTML, начинающуюся с элемента
    .
  8. Animation_opts — позволяет указать пользовательские свойства анимации в виде словаря. Затем эти значения передаются функции plotly.animate в plotly.js.
  9. Default_width — определяет ширину результирующей фигуры по умолчанию в пикселях.
  10. Default_height — указывает высоту фигуры по умолчанию в пикселях.
  11. Проверить — определяет, следует ли проверять фигуру перед преобразованием в строку HTML.
  12. 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.