Plotly.io.to_templated

Нека се потопим.

Синтаксис на функцията

Функцията предоставя прост синтаксис, който ви позволява да се съсредоточите върху кода. Синтаксисът е изразен по-долу:

Параметрите на функцията са:

1. Фигура – ​​указва фигурния обект, чийто стил искате да преместите в шаблон.
2. Пропускане – указва колекция от имена на свойствата, които искате да изключите, когато премествате стила към шаблон. По подразбиране е включено само свойството заглавие. Това предотвратява импортирането на текста на фигурата, като заглавията на осите, от други фигури.

Фигурата връща копие на фигурата със стила, преместен в шаблон. Типът връщане на go.Figure.

Пример

Нека илюстрираме как можем да използваме функцията to_templated(), за да експортираме стила на конкретна фигура в шаблон.

Нека започнем, като създадем фигура с персонализиран стил. Примерен код е показан по-долу:

В този пример създаваме точкова диаграма с персонализиран стил на текст, като семейство шрифтове, цвят на шрифта, размер на шрифта и т.н.

Кодът по-горе трябва да върне проста точкова диаграма, както е показано:

Можем да преобразуваме тази фигура във фигура със стилизиращ шаблон с помощта на функцията to_template().

Примерен код е както е показано:

В кода по-горе започваме с импортиране на модула plotly io като io. След това създаваме копие на фигурата със стила, записан в потребителски шаблон, като използваме функцията to_templated().

Можем да видим шаблона, като изпълним кода:

Това трябва да върне речник със свойства, които определят стила на фигурата. Примерна изходна стойност е както е показано:

Можете да покажете фигурата просто като извикате записания шаблон като:

Това трябва да покаже фигурата, записана в шаблона.

Създайте фигура с шаблона

След като сме запазили стила на фигура в потребителски шаблон, можем да използваме този шаблон, за да приложим стила към друга фигура.

Примерен код е както е показано:

В горния пример започваме с импортиране на модула graph_objects от Plotly. В този случай ние използваме graph_objects, тъй като искаме да създадем празна фигура, но използваме само стила.

С помощта на функцията go.Figure() предаваме параметъра за оформление и посочваме целевия шаблон, използвайки свойството „template“.

След това можем да покажем получената фигура, като извикаме new_fig. Това трябва да върне:

Имайте предвид, че фигурата по-горе не съдържа данни или текст. Включва само стила, като цвят на текста, семейство шрифтове, размер на шрифта и т.н.

За да създадем точкова диаграма с този шаблон, можем да използваме кода, както е показано:

Примерът по-горе трябва да върне фигура, както е показано:

Обърнете внимание, че цветът, семейството и размерът на шрифта са подобни на зададените в шаблона.

Запазване на именуван шаблон

Можем да запазим персонализирания шаблон, като използваме обекта шаблони, както е показано в кода по-долу:

Кодът по-горе ще запази шаблона под името „my_custom_template“. След това можете да използвате това име, за да посочите шаблона, който искате да използвате:

Заключение

В този урок научихме как да създадем фигура със стила, записан в потребителски шаблон. Разгледахме също как да използвате шаблона в други фигури и да запазите шаблона за по-късна употреба.