Mari selami.
Sintaks Fungsi
Fungsi ini menyediakan sintaks sederhana yang memungkinkan Anda untuk fokus pada kode. Sintaksnya dinyatakan seperti di bawah ini:
dengan licik. ini . ke_template ( ara , melewati = ( 'judul' , 'teks' ) )
Parameter fungsi adalah:
- Fig – menentukan objek gambar yang gayanya ingin Anda pindahkan ke template.
- Lewati – menentukan kumpulan nama properti yang ingin Anda kecualikan saat memindahkan gaya ke template. Secara default, hanya properti judul yang disertakan. Ini mencegah teks gambar, seperti judul sumbu, diimpor oleh gambar lain.
Gambar mengembalikan salinan gambar dengan gaya yang dipindahkan ke template. Jenis kembalinya go.Gambar.
Contoh
Mari kita ilustrasikan bagaimana kita dapat menggunakan fungsi to_templated() untuk mengekspor gaya gambar tertentu ke template.
Mari kita mulai dengan membuat gambar dengan gaya kustom. Contoh kode ditunjukkan di bawah ini:
impor dengan licik. cepat sebagai pxdf = px. data . iris ( )
ara = px. menyebarkan ( df , x = 'panjang_sepal' , kamu = 'lebar_sepal' , warna = 'jenis' ,
judul = 'Gaya Kustom' )
ara. update_layout (
font_family = 'Kurir Baru, monospace' ,
warna huruf = 'merah' ,
ukuran huruf = 18 ,
judul_font_keluarga = 'Waktu Romawi Baru' ,
judul_font_warna = 'biru' ,
legenda_title_font_color = 'hijau'
)
ara. update_xaxes ( judul_font_keluarga = 'Arial' )
ara. menunjukkan ( )
Dalam contoh ini, kami membuat plot sebar dengan gaya teks khusus seperti keluarga font, warna font, ukuran font, dll.
Kode di atas harus mengembalikan plot sebar sederhana seperti yang ditunjukkan:
Kita dapat mengonversi gambar ini menjadi gambar dengan template gaya menggunakan fungsi to_template() .
Contoh kode seperti yang ditunjukkan:
impor dengan licik. ini sebagai inigambar_template = ini. ke_template ( ara )
Pada kode di atas, kita mulai dengan mengimpor modul plotly io sebagai io. Kami kemudian membuat salinan gambar dengan gaya yang disimpan ke template khusus menggunakan fungsi to_templated() .
Kita dapat melihat template dengan menjalankan kode:
gambar_template. tata letak . templatIni akan mengembalikan kamus dengan properti yang menentukan gaya gambar. Contoh nilai output seperti yang ditunjukkan:
tata letak. Templat ( {'data' : { 'batang' : [ { 'kesalahan_x' : { 'warna' : '#2a3f5f' } ,
'kesalahan_y' : { 'warna' : '#2a3f5f' } ,
'penanda' : { 'garis' : { 'warna' : '#E5ECF6' , 'lebar' : 0,5 } ,
'pola' : { 'mode isi' : 'hamparan' , 'ukuran' : 10 , 'kepadatan' : 0.2 } } ,
---------------------------------------keluaran terpotong---------- -------------------------------
Anda dapat menampilkan gambar hanya dengan memanggil template yang disimpan sebagai:
gambar_templateIni akan menampilkan gambar yang disimpan dalam template.
Buat Gambar dengan Template
Setelah kita menyimpan gaya gambar ke template kustom, kita bisa menggunakan template itu untuk menerapkan gaya ke gambar lain.
Contoh kode seperti yang ditunjukkan:
impor dengan licik. graph_objectsas Pergilahgambar_baru = Pergilah. Angka ( tata letak = {
'templat' : fig_templated. tata letak . templat
} )
gambar_baru
Pada contoh di atas, kita mulai dengan mengimpor modul graph_objects dari Plotly. Dalam hal ini, kami menggunakan graph_objects karena kami ingin membuat gambar kosong tetapi hanya menggunakan styling.
Dengan menggunakan fungsi go.Figure(), kita meneruskan parameter layout dan menentukan template target menggunakan properti 'template'.
Kami kemudian dapat menampilkan gambar yang dihasilkan dengan memanggil new_fig. Ini harus kembali:
Perhatikan bahwa gambar di atas tidak mengandung data atau teks. Ini hanya mencakup gaya, seperti warna teks, keluarga font, ukuran font, dll.
Untuk membuat scatter plot dengan template ini, kita dapat menggunakan kode seperti yang ditunjukkan:
impor dengan licik. graph_objectsas Pergilahimpor numpyas np
N = 1000
t = misalnya linspace ( 0 , 10 , lima puluh )
kamu = misalnya tanpa ( t )
ara = Pergilah. Angka ( data = Pergilah. Menyebarkan ( x = t , kamu = kamu , mode = 'penanda' ) , tata letak = {
'templat' : fig_templated. tata letak . templat
} )
ara. menunjukkan ( )
Contoh di atas harus mengembalikan angka seperti yang ditunjukkan:
Perhatikan warna font, keluarga, dan ukurannya mirip dengan yang ada di template.
Menyimpan Template Bernama
Kita dapat menyimpan template kustom menggunakan objek templates seperti yang ditunjukkan pada kode di bawah ini:
impor dengan licik. ini sebagai iniini. template [ 'my_custom_template' ] = gambar_template. tata letak . templat
Kode di atas akan menyimpan template dengan nama 'my_custom_template'. Anda kemudian dapat menggunakan nama ini untuk menentukan template yang ingin Anda gunakan:
tata letak = {'templat' : 'my_custom_template'
}
Kesimpulan
Dalam tutorial ini, kita belajar cara membuat gambar dengan gaya yang disimpan ke template kustom. Kami juga membahas cara menggunakan template pada gambar lain dan menyimpan template untuk digunakan nanti.