Tramamente.IO.To_templated

En este artículo, aprenderemos cómo mover el estilo de una figura tramalmente a una plantilla específica utilizando la función to_templated () f. Luego puede usar la plantilla para diseñar otras figuras utilizando la propiedad de la plantilla.

Vamos a sumergirnos.

Sintaxis de funciones

La función proporciona una sintaxis simple que le permite concentrarse en el código. La sintaxis se expresa a continuación:

tramamente.IO.to_templated (fig, skip = ('title', 'text'))

Los parámetros de la función son:

1. Fig: especifica el objeto de figura cuyo estilo desea moverse a una plantilla.
2. Skip: especifica una colección de nombres de las propiedades que desea excluir al mover el estilo a una plantilla. Por defecto, solo se incluye la propiedad del título. Esto evita que el texto de la figura, como los títulos de eje, sea importado por otras figuras.

La figura devuelve una copia de la figura con el estilo movido a una plantilla. El tipo de regreso de go.Cifra.

Ejemplo

Ilustramos cómo podemos usar la función To_templated () para exportar el estilo de una figura específica a una plantilla.

Comencemos creando una figura con un estilo personalizado. A continuación se muestra un código de ejemplo:

Importar trama.expresar como PX
DF = PX.datos.iris()
Fig = PX.dispersión (df, x = "sepal_length", y = "sepal_width", color = "especies",
title = "Styling personalizado")
higo.update_layout (
font_family = "Courier New, Monospace",
font_color = "rojo",
font_size = 18,
title_font_family = "Times New Roman",
title_font_color = "Blue",
Legend_title_font_color = "verde"
)
higo.update_xaxes (title_font_family = "Arial")
higo.espectáculo()

En este ejemplo, creamos una trama de dispersión con un estilo de texto personalizado como la familia de fuentes, el color de fuente, el tamaño de la fuente, etc.

El código anterior debe devolver un gráfico de dispersión simple como se muestra:

Podemos convertir esta figura en una figura con una plantilla de estilo utilizando la función to_template ().

Un código de ejemplo es como se muestra:

Importar trama.io como io
Fig_templated = io.To_templated (fig)

En el código anterior, comenzamos importando el módulo IO complementario como IO. Luego creamos una copia de la figura con el estilo guardado en una plantilla personalizada utilizando la función to_templated ().

Podemos ver la plantilla ejecutando el código:

FIG_Templated.disposición.plantilla

Esto debería devolver un diccionario con propiedades que definan el estilo de la figura. Un valor de salida de ejemplo es como se muestra:

disposición.Plantilla(
'Data': 'Bar': ['Error_x': 'color': '#2a3f5f',
'Error_y': 'color': '#2a3f5f',
'Marker': 'línea': 'color': '#e5eCf6', 'ancho': 0.5,
'Patrón': 'FillMode': 'Superposición', 'tamaño': 10, 'Solidez': 0.2,
--------------------------------------salida truncada-----------------------------------------

Puede mostrar la figura simplemente llamando a la plantilla guardada como:

FIG_Templated

Esto debería mostrar la figura guardada en la plantilla.

Crear una figura con la plantilla

Una vez que hemos guardado el estilo de una figura en una plantilla personalizada, podemos usar esa plantilla para aplicar el estilo a otra figura.

Un código de ejemplo es como se muestra:

Importar trama.Graph_Objectsas Go
new_fig = Go.Figura (diseño =
'plantilla': fig_templated.disposición.plantilla
)
New_fig

En el ejemplo anterior, comenzamos importando el módulo Graph_Objects desde Plotly. En este caso, estamos usando Graph_Objects, ya que deseamos crear una figura vacía, pero solo usamos el estilo.

Usando el Go.Figura figura (), pasamos el parámetro de diseño y especificamos la plantilla de destino utilizando la propiedad 'plantilla'.

Luego podemos mostrar la figura resultante llamando a New_Fig. Esto debería volver:

Tenga en cuenta que la figura anterior no contiene ningún dato o texto. Solo incluye el estilo, como color de texto, familia de fuentes, tamaño de fuente, etc.

Para crear un diagrama de dispersión con esta plantilla, podemos usar el código como se muestra:

Importar trama.Graph_Objectsas Go
importar numpyas np
N = 1000
t = np.Linspace (0, 10, 50)
y = NP.pecado (t)
Fig = GO.Figura (datos = GO.Dispersión (x = t, y = y, mode = 'marcadores'), diseño =
'plantilla': fig_templated.disposición.plantilla
)
higo.espectáculo()

El ejemplo anterior debe devolver una figura como se muestra:

Tenga en cuenta que el color de fuente, la familia y el tamaño son similares al conjunto en la plantilla.

Guardar una plantilla con nombre

Podemos guardar la plantilla personalizada utilizando el objeto Plantillas como se muestra en el código a continuación:

Importar trama.io como io
IO.plantillas ['my_custom_template'] = fig_templated.disposición.plantilla

El código anterior guardará la plantilla bajo el nombre 'my_custom_template'. Luego puede usar este nombre para especificar la plantilla que desea usar:

diseño =
'plantilla': 'my_custom_template'

Conclusión

En este tutorial, aprendimos a crear una figura con el estilo guardado en una plantilla personalizada. También cubrimos cómo usar la plantilla en otras figuras y guardar la plantilla para su uso posterior.