Mari selami.
Sintaks Fungsi
Fungsi ini menyediakan sintaks mudah yang membolehkan anda memfokus pada kod. Sintaks dinyatakan seperti di bawah:
secara plot. ini . to_templated ( ara , ponteng = ( 'tajuk' , 'teks' ) )
Parameter fungsi adalah:
- Rajah – menentukan objek rajah yang gayanya ingin anda alihkan ke templat.
- Langkau – menentukan koleksi nama sifat yang ingin anda kecualikan apabila mengalihkan penggayaan ke templat. Secara lalai, hanya harta hak milik disertakan. Ini menghalang teks angka, seperti tajuk paksi, daripada diimport oleh angka lain.
Angka itu mengembalikan salinan rajah dengan gaya dialihkan ke templat. Jenis pulangan pergi.Rajah.
Contoh
Mari kita jelaskan bagaimana kita boleh menggunakan fungsi to_templated() untuk mengeksport penggayaan angka tertentu kepada templat.
Mari mulakan dengan mencipta angka dengan gaya tersuai. Contoh kod ditunjukkan di bawah:
import secara plot. ekspres sebagai pxdf = px. data . iris ( )
ara = px. berselerak ( df , x = 'panjang_sepal' , Y = 'sepal_width' , warna = 'spesies' ,
tajuk = 'Penggayaan Tersuai' )
ara. kemas kini_susun atur (
font_family = 'Kurier Baharu, monospace' ,
font_color = 'merah' ,
Saiz huruf = 18 ,
title_font_family = 'Times New Roman' ,
title_font_color = 'biru' ,
legend_title_font_color = 'hijau'
)
ara. kemas kini_xaxes ( title_font_family = 'Arial' )
ara. tunjuk ( )
Dalam contoh ini, kami mencipta plot taburan dengan penggayaan teks tersuai seperti keluarga fon, warna fon, saiz fon, dsb.
Kod di atas harus mengembalikan plot taburan mudah seperti yang ditunjukkan:
Kita boleh menukar angka ini kepada angka dengan templat penggayaan menggunakan fungsi to_template().
Contoh kod adalah seperti yang ditunjukkan:
import secara plot. ini sebagai inifig_templated = ini. to_templated ( ara )
Dalam kod di atas, kita mulakan dengan mengimport modul plotly io sebagai io. Kami kemudian membuat salinan angka dengan penggayaan yang disimpan pada templat tersuai menggunakan fungsi to_templated().
Kita boleh melihat templat dengan menjalankan kod:
fig_templated. susun atur . templatIni harus mengembalikan kamus dengan sifat yang mentakrifkan penggayaan angka tersebut. Contoh nilai output adalah seperti yang ditunjukkan:
susun atur. templat ( {'data' : { 'bar' : [ { 'error_x' : { 'warna' : '#2a3f5f' } ,
'error_y' : { 'warna' : '#2a3f5f' } ,
'penanda' : { 'baris' : { 'warna' : '#E5ECF6' , 'lebar' : 0.5 } ,
'corak' : { 'fillmode' : 'tindih' , 'saiz' : 10 , 'keteguhan' : 0.2 } } ,
---------------------------------------output dipenggal------------------------ -----------------------------
Anda boleh memaparkan angka itu hanya dengan memanggil templat yang disimpan sebagai:
fig_templatedIni sepatutnya memaparkan angka yang disimpan dalam templat.
Buat Rajah dengan Templat
Sebaik sahaja kami telah menyimpan penggayaan angka pada templat tersuai, kami boleh menggunakan templat itu untuk menggunakan penggayaan pada angka lain.
Contoh kod adalah seperti yang ditunjukkan:
import secara plot. graph_objectsas perginew_fig = pergi. Rajah ( susun atur = {
'template' : fig_templated. susun atur . templat
} )
new_fig
Dalam contoh di atas, kita mulakan dengan mengimport modul graph_objects daripada Plotly. Dalam kes ini, kami menggunakan graph_objects kerana kami ingin mencipta angka kosong tetapi hanya menggunakan penggayaan.
Menggunakan fungsi go.Figure(), kami lulus parameter reka letak dan menentukan templat sasaran menggunakan sifat 'template'.
Kami kemudiannya boleh memaparkan angka yang terhasil dengan memanggil new_fig. Ini sepatutnya kembali:
Ambil perhatian bahawa rajah di atas tidak mengandungi sebarang data atau teks. Ia hanya termasuk penggayaan, seperti warna teks, keluarga fon, saiz fon, dsb.
Untuk membuat plot taburan dengan templat ini, kita boleh menggunakan kod seperti yang ditunjukkan:
import secara plot. graph_objectsas pergiimport numpyas np
N = 1000
t = cth. linspace ( 0 , 10 , lima puluh )
Y = cth. tanpa ( t )
ara = pergi. Rajah ( data = pergi. berselerak ( x = t , Y = Y , mod = 'penanda' ) , susun atur = {
'template' : fig_templated. susun atur . templat
} )
ara. tunjuk ( )
Contoh di atas harus mengembalikan angka seperti yang ditunjukkan:
Perhatikan warna fon, keluarga dan saiz adalah serupa dengan set dalam templat.
Menyimpan Templat Bernama
Kami boleh menyimpan templat tersuai menggunakan objek templat seperti yang ditunjukkan dalam kod di bawah:
import secara plot. ini sebagai iniini. templat [ 'my_custom_template' ] = fig_templated. susun atur . templat
Kod di atas akan menyimpan templat di bawah nama 'my_custom_template'. Anda kemudian boleh menggunakan nama ini untuk menentukan templat yang ingin anda gunakan:
susun atur = {'template' : 'my_custom_template'
}
Kesimpulan
Dalam tutorial ini, kami belajar cara mencipta angka dengan penggayaan yang disimpan pada templat tersuai. Kami juga membincangkan cara menggunakan templat dalam angka lain dan menyimpan templat untuk kegunaan kemudian.