Sumisid tayo.
Syntax ng Function
Ang function ay nagbibigay ng isang simpleng syntax na nagbibigay-daan sa iyong tumutok sa code. Ang syntax ay ipinahayag tulad ng sa ibaba:
may pakana. ito . to_templated ( fig , laktawan = ( 'title' , 'text' ) )
Ang mga parameter ng function ay:
- Fig – tumutukoy sa figure object na ang estilo ay gusto mong ilipat sa isang template.
- Laktawan – tumutukoy sa isang koleksyon ng mga pangalan ng mga katangian na nais mong ibukod kapag inililipat ang estilo sa isang template. Bilang default, ang title property lang ang kasama. Pinipigilan nito ang teksto ng figure, tulad ng mga pamagat ng axis, na ma-import ng ibang mga figure.
Ang figure ay nagbabalik ng isang kopya ng figure na ang estilo ay inilipat sa isang template. Ang uri ng pagbabalik ng go.Figure.
Halimbawa
Ilarawan natin kung paano natin magagamit ang to_templated() function para i-export ang styling ng isang partikular na figure sa isang template.
Magsimula tayo sa paggawa ng figure na may custom na istilo. Ang isang halimbawang code ay ipinapakita sa ibaba:
angkat may pakana. ipahayag bilang pxdf = px. datos . iris ( )
fig = px. magkalat ( df , x = 'sepal_length' , Y = 'sepal_width' , kulay = 'species' ,
pamagat = 'Pasadyang Pag-istilo' )
fig. update_layout (
font_family = 'Courier New, monospace' ,
font_color = 'pula' ,
font_size = 18 ,
pamagat_font_pamilya = 'Times New Roman' ,
title_font_color = 'bughaw' ,
legend_title_font_color = 'berde'
)
fig. update_xaxes ( pamagat_font_pamilya = 'Arial' )
fig. palabas ( )
Sa halimbawang ito, gumawa kami ng scatter plot na may custom na text styling gaya ng font family, kulay ng font, laki ng font, atbp.
Ang code sa itaas ay dapat magbalik ng isang simpleng scatter plot tulad ng ipinapakita:
Maaari naming i-convert ang figure na ito sa isang figure na may template ng estilo gamit ang to_template() function.
Ang isang halimbawang code ay tulad ng ipinapakita:
angkat may pakana. ito bilang itofig_templated = ito. to_templated ( fig )
Sa code sa itaas, magsisimula tayo sa pamamagitan ng pag-import ng plotly io module bilang io. Pagkatapos ay gumawa kami ng kopya ng figure na may naka-save na istilo sa isang custom na template gamit ang to_templated() function.
Maaari naming tingnan ang template sa pamamagitan ng pagpapatakbo ng code:
fig_templated. layout . templateDapat itong ibalik ang isang diksyunaryo na may mga katangian na tumutukoy sa estilo ng figure. Ang isang halimbawang halaga ng output ay tulad ng ipinapakita:
layout. Template ( {'data' : { 'bar' : [ { 'error_x' : { 'kulay' : '#2a3f5f' } ,
'error_y' : { 'kulay' : '#2a3f5f' } ,
'pananda' : { 'linya' : { 'kulay' : '#E5ECF6' , 'lapad' : 0.5 } ,
'pattern' : { 'fillmode' : 'overlay' , 'laki' : 10 , 'katatagan' : 0.2 } } ,
--------------------------------------naputol ang output----------- -----------------------------
Maaari mong ipakita ang figure sa pamamagitan lamang ng pagtawag sa naka-save na template bilang:
fig_templatedDapat itong ipakita ang figure na naka-save sa template.
Gumawa ng Figure gamit ang Template
Kapag na-save na namin ang styling ng isang figure sa isang custom na template, magagamit namin ang template na iyon para ilapat ang styling sa isa pang figure.
Ang isang halimbawang code ay tulad ng ipinapakita:
angkat may pakana. graph_objectsas pumunta kabagong_fig = pumunta ka. Pigura ( layout = {
'template' : fig_templated. layout . template
} )
bagong_fig
Sa halimbawa sa itaas, magsisimula tayo sa pamamagitan ng pag-import ng graph_objects module mula sa Plotly. Sa kasong ito, gumagamit kami ng graph_objects bilang nais naming lumikha ng isang walang laman na figure ngunit ginagamit lamang ang estilo.
Gamit ang function na go.Figure(), ipinapasa namin ang parameter ng layout at tinutukoy ang target na template gamit ang property na 'template'.
Maaari nating ipakita ang resultang figure sa pamamagitan ng pagtawag sa new_fig. Dapat itong bumalik:
Tandaan na ang figure sa itaas ay hindi naglalaman ng anumang data o text. Kasama lang dito ang pag-istilo, gaya ng kulay ng text, pamilya ng font, laki ng font, atbp.
Upang lumikha ng isang scatter plot gamit ang template na ito, maaari naming gamitin ang code tulad ng ipinapakita:
angkat may pakana. graph_objectsas pumunta kaangkat numpyas np
N = 1000
t = hal. linspace ( 0 , 10 , limampu )
Y = hal. wala ( t )
fig = pumunta ka. Pigura ( datos = pumunta ka. Magkakalat ( x = t , Y = Y , mode = 'mga marker' ) , layout = {
'template' : fig_templated. layout . template
} )
fig. palabas ( )
Ang halimbawa sa itaas ay dapat magbalik ng figure tulad ng ipinapakita:
Tandaan na ang kulay ng font, pamilya at laki ay katulad ng isang set sa template.
Nagse-save ng Pinangalanang Template
Maaari naming i-save ang custom na template gamit ang template object tulad ng ipinapakita sa code sa ibaba:
angkat may pakana. ito bilang itoito. mga template [ 'my_custom_template' ] = fig_templated. layout . template
Ise-save ng code sa itaas ang template sa ilalim ng pangalang 'my_custom_template'. Maaari mong gamitin ang pangalang ito upang tukuyin ang template na gusto mong gamitin:
layout = {'template' : 'my_custom_template'
}
Konklusyon
Sa tutorial na ito, natutunan namin kung paano gumawa ng figure na may naka-save na styling sa custom na template. Sinasaklaw din namin kung paano gamitin ang template sa ibang mga figure at i-save ang template para magamit sa ibang pagkakataon.