Plotly.io.to_templated

Neste artigo, aprenderemos a mover o estilo de uma figura plotty para um modelo específico usando a função TO_TEMPLATED (). Você pode usar o modelo para estilizar outras figuras usando a propriedade de modelo.

Vamos mergulhar.

Função Sintaxe

A função fornece uma sintaxe simples que permite que você se concentre no código. A sintaxe é expressa como abaixo:

plotly.io.to_templated (fig, skip = ('title', 'text')))

Os parâmetros da função são:

1. Fig - Especifica o objeto da figura cujo estilo você deseja mudar para um modelo.
2. Skip - Especifica uma coleção de nomes das propriedades que você deseja excluir ao mover o estilo para um modelo. Por padrão, apenas a propriedade do título está incluída. Isso impede que o texto da figura, como títulos de eixo, de ser importado por outras figuras.

A figura retorna uma cópia da figura com o estilo movido para um modelo. O tipo de retorno de Go.Figura.

Exemplo

Vamos ilustrar como podemos usar a função to_templated () para exportar o estilo de uma figura específica para um modelo.

Vamos começar criando uma figura com estilo personalizado. Um código de exemplo é mostrado abaixo:

importar plotly.expresso como px
df = px.dados.íris()
Fig = px.dispersão (df, x = "Sepal_length", y = "Sepal_width", color = "espécies",
title = "Styling personalizado")
Figo.update_layout (
font_family = "Courier New, Monospace",
font_color = "vermelho",
font_size = 18,
title_font_family = "Times New Roman",
title_font_color = "azul",
Legend_title_font_color = "Green"
)
Figo.update_xaxes (title_font_family = "Arial")
Figo.mostrar()

Neste exemplo, criamos um gráfico de dispersão com um estilo de texto personalizado, como família de fontes, cor da fonte, tamanho da fonte, etc.

O código acima deve retornar um gráfico de dispersão simples, como mostrado:

Podemos converter esta figura em uma figura com um modelo de estilo usando a função to_template ().

Um código de exemplo é como mostrado:

importar plotly.io como io
fig_templated = io.to_templated (fig)

No código acima, começamos importando o módulo plotly io como io. Em seguida, criamos uma cópia da figura com o estilo salvo em um modelo personalizado usando a função to_templated ().

Podemos ver o modelo executando o código:

fig_templated.layout.modelo

Isso deve retornar um dicionário com propriedades que definem o estilo da figura. Um exemplo de valor de saída é como mostrado:

layout.Modelo(
'Data': 'bar': ['error_x': 'color': '#2a3f5f',
'Error_y': 'color': '#2a3f5f',
'Marker': 'line': 'color': '#e5ecf6', 'width': 0.5,
'Pattern': 'FillMode': 'Sobreposição', 'Tamanho': 10, 'Solididade': 0.2,
--------------------------------------saída truncada-----------------------------------------

Você pode exibir a figura simplesmente chamando o modelo salvo como:

fig_templated

Isso deve exibir a figura salva no modelo.

Crie uma figura com o modelo

Depois de salvarmos o estilo de uma figura em um modelo personalizado, podemos usar esse modelo para aplicar o estilo a outra figura.

Um código de exemplo é como mostrado:

importar plotly.Graph_Objectsas Go
new_fig = vá.Figura (layout =
'modelo': fig_templated.layout.modelo
)
new_fig

No exemplo acima, começamos importando o módulo Graph_Objects do plotly. Nesse caso, estamos usando graf_objects, pois desejamos criar uma figura vazia, mas apenas usar o estilo.

Usando o Go.Figura () Função, passamos pelo parâmetro de layout e especificamos o modelo de destino usando a propriedade 'modelo'.

Podemos então exibir a figura resultante chamando new_fig. Isso deve retornar:

Observe que a figura acima não contém dados ou texto. Ele inclui apenas o estilo, como cor de texto, família de fontes, tamanho da fonte, etc.

Para criar um gráfico de dispersão com este modelo, podemos usar o código como mostrado:

importar plotly.Graph_Objectsas Go
importar numpyas np
N = 1000
t = np.Linspace (0, 10, 50)
y = np.pecado (t)
fig = vá.Figura (Data = Go.Dispersão (x = t, y = y, modo = 'marcadores'), layout =
'modelo': fig_templated.layout.modelo
)
Figo.mostrar()

O exemplo acima deve retornar uma figura como mostrado:

Observe que a cor da fonte, a família e o tamanho são semelhantes aos definidos no modelo.

Salvando um modelo nomeado

Podemos salvar o modelo personalizado usando o objeto Modelos, conforme mostrado no código abaixo:

importar plotly.io como io
io.modelos ['my_custom_template'] = fig_templated.layout.modelo

O código acima salvará o modelo sob o nome 'my_custom_template'. Você pode usar este nome para especificar o modelo que deseja usar:

layout =
'modelo': 'my_custom_template'

Conclusão

Neste tutorial, aprendemos a criar uma figura com o estilo salvo em um modelo personalizado. Também abordamos como usar o modelo em outras figuras e salvar o modelo para uso posterior.