Hadi dalalım.
İşlev Sözdizimi
İşlev, koda odaklanmanızı sağlayan basit bir sözdizimi sağlar. Sözdizimi aşağıdaki gibi ifade edilir:
planlı bir şekilde. Bu . to_template ( incir , atlamak = ( 'Başlık' , 'Metin' ) )
Fonksiyon parametreleri şunlardır:
- Şekil – stilini bir şablona taşımak istediğiniz şekil nesnesini belirtir.
- Atla – stili bir şablona taşırken hariç tutmak istediğiniz özelliklerin adlarının bir koleksiyonunu belirtir. Varsayılan olarak, yalnızca title özelliği dahil edilir. Bu, eksen başlıkları gibi şeklin metninin diğer şekiller tarafından içe aktarılmasını engeller.
Şekil, stilin bir şablona taşındığı şeklin bir kopyasını döndürür. go.Şekil dönüş türü.
Örnek
Belirli bir şeklin stilini bir şablona aktarmak için to_template() işlevini nasıl kullanabileceğimizi gösterelim.
Özel stille bir figür oluşturarak başlayalım. Örnek bir kod aşağıda gösterilmiştir:
içe aktarmak planlı bir şekilde. ifade etmek olarak pikseldf = piksel. veri . iris ( )
incir = piksel. saçılma ( df , x = 'sepal_uzunluk' , Y = 'sepal_genişlik' , renk = 'Türler' ,
Başlık = 'Özel Stil' )
incir. update_layout (
font ailesi = 'Kurye Yeni, monospace' ,
yazı rengi = 'kırmızı' ,
yazı Boyutu = 18 ,
title_font_family = 'Times New Roman' ,
title_font_color = 'mavi' ,
legend_title_font_color = 'Yeşil'
)
incir. update_xaxes ( title_font_family = 'Arya' )
incir. göstermek ( )
Bu örnekte, yazı tipi ailesi, yazı tipi rengi, yazı tipi boyutu vb. gibi özel metin stilleriyle bir dağılım grafiği oluşturuyoruz.
Yukarıdaki kod, gösterildiği gibi basit bir dağılım grafiği döndürmelidir:
to_template() işlevini kullanarak bu şekli bir stil şablonuyla bir şekle dönüştürebiliriz.
Örnek bir kod gösterildiği gibidir:
içe aktarmak planlı bir şekilde. Bu olarak Buincir_template = Bu. to_template ( incir )
Yukarıdaki kodda, plotly io modülünü io olarak import ederek başlıyoruz. Ardından, to_template() işlevini kullanarak özel bir şablona kaydedilen stil ile şeklin bir kopyasını oluştururuz.
Kodu çalıştırarak şablonu görüntüleyebiliriz:
incir_template. Yerleşim . şablonBu, şeklin stilini tanımlayan özelliklere sahip bir sözlük döndürmelidir. Örnek bir çıktı değeri gösterildiği gibidir:
Yerleşim. Şablon ( {'veri' : { 'çubuk' : [ { 'hata_x' : { 'renk' : '#2a3f5f' } ,
'hata_y' : { 'renk' : '#2a3f5f' } ,
'işaretleyici' : { 'astar' : { 'renk' : '#E5ECF6' , 'Genişlik' : 0,5 } ,
'model' : { 'doldurma modu' : 'kaplama' , 'boyut' : 10 , 'sağlamlık' : 0,2 } } ,
-------------------------------------- çıktı kesildi---------- ----------------------------------
Kaydedilen şablonu şu şekilde çağırarak şekli görüntüleyebilirsiniz:
incir_templateBu, şablona kaydedilen şekli göstermelidir.
Şablonla Bir Şekil Oluşturun
Bir şeklin stilini özel bir şablona kaydettikten sonra, stili başka bir şekle uygulamak için bu şablonu kullanabiliriz.
Örnek bir kod gösterildiği gibidir:
içe aktarmak planlı bir şekilde. grafik_nesneler Gityeni_incir = Git. Figür ( Yerleşim = {
'şablon' : incir_template. Yerleşim . şablon
} )
yeni_incir
Yukarıdaki örnekte, Plotly'den graph_objects modülünü içe aktararak başlıyoruz. Bu durumda, boş bir şekil oluşturmak istediğimiz için graph_objects kullanıyoruz ama sadece stili kullanıyoruz.
go. Figure() fonksiyonunu kullanarak layout parametresini geçiyoruz ve 'template' özelliğini kullanarak hedef şablonu belirliyoruz.
Daha sonra ortaya çıkan rakamı new_fig'i çağırarak görüntüleyebiliriz. Bu dönmelidir:
Yukarıdaki şeklin herhangi bir veri veya metin içermediğini unutmayın. Yalnızca metin rengi, yazı tipi ailesi, yazı tipi boyutu vb. gibi stilleri içerir.
Bu şablonla bir dağılım grafiği oluşturmak için aşağıdaki kodu kullanabiliriz:
içe aktarmak planlı bir şekilde. grafik_nesneler Gitiçe aktarmak numpyas np
N = 1000
t = Örneğin. çizgi uzayı ( 0 , 10 , elli )
Y = Örneğin. olmadan ( t )
incir = Git. Figür ( veri = Git. dağılım ( x = t , Y = Y , mod = 'işaretçiler' ) , Yerleşim = {
'şablon' : incir_template. Yerleşim . şablon
} )
incir. göstermek ( )
Yukarıdaki örnek, gösterildiği gibi bir rakam döndürmelidir:
Yazı tipi renginin, ailesinin ve boyutunun şablonda ayarlanana benzer olduğuna dikkat edin.
Adlandırılmış Bir Şablonu Kaydetme
Aşağıdaki kodda gösterildiği gibi şablonlar nesnesini kullanarak özel şablonu kaydedebiliriz:
içe aktarmak planlı bir şekilde. Bu olarak BuBu. şablonlar [ 'my_custom_template' ] = incir_template. Yerleşim . şablon
Yukarıdaki kod, şablonu 'my_custom_template' adı altında kaydedecektir. Ardından, kullanmak istediğiniz şablonu belirtmek için bu adı kullanabilirsiniz:
Yerleşim = {'şablon' : 'my_custom_template'
}
Çözüm
Bu öğreticide, stilin özel bir şablona kaydedilmesiyle bir figürün nasıl oluşturulacağını öğrendik. Ayrıca şablonun diğer şekillerde nasıl kullanılacağını ve şablonu daha sonra kullanmak üzere nasıl saklayacağımızı da ele aldık.