Hãy đi sâu vào.
Cú pháp hàm
Hàm cung cấp một cú pháp đơn giản cho phép bạn tập trung vào mã. Cú pháp được thể hiện như sau:
có âm mưu. đây . to_templated ( quả sung , nhảy = ( 'Tiêu đề' , 'chữ' ) )
Các tham số của hàm là:
- Hình - chỉ định đối tượng hình có kiểu dáng mà bạn muốn chuyển sang một mẫu.
- Bỏ qua - chỉ định một tập hợp tên của các thuộc tính bạn muốn loại trừ khi di chuyển kiểu sang một mẫu. Theo mặc định, chỉ có thuộc tính tiêu đề được bao gồm. Điều này ngăn văn bản của hình, chẳng hạn như tiêu đề trục, được nhập bởi các hình khác.
Hình trả về một bản sao của hình với kiểu được chuyển sang một mẫu. Kiểu trả về của go.
Thí dụ
Hãy để chúng tôi minh họa cách chúng tôi có thể sử dụng hàm to_templated () để xuất kiểu dáng của một hình cụ thể sang một mẫu.
Hãy bắt đầu bằng cách tạo một figure với kiểu dáng tùy chỉnh. Một mã ví dụ được hiển thị bên dưới:
nhập khẩu có âm mưu. bày tỏ như pxdf = px. dữ liệu . mống mắt ( )
quả sung = px. tiêu tan ( df , x = 'sepal_length' , Y = 'sepal_width' , màu sắc = 'loài' ,
Tiêu đề = 'Tạo kiểu tùy chỉnh' )
quả sung. update_layout (
font_family = 'Chuyển phát nhanh mới, monospace' ,
màu phông chữ = 'màu đỏ' ,
cỡ chữ = 18 ,
title_font_family = 'Times New Roman' ,
title_font_color = 'màu xanh da trời' ,
Legend_title_font_color = 'màu xanh lá'
)
quả sung. update_xaxes ( title_font_family = 'Arial' )
quả sung. buổi bieu diễn ( )
Trong ví dụ này, chúng tôi tạo một biểu đồ phân tán với kiểu văn bản tùy chỉnh như họ phông chữ, màu phông chữ, kích thước phông chữ, v.v.
Đoạn mã trên sẽ trả về một biểu đồ phân tán đơn giản như được hiển thị:
Chúng ta có thể chuyển đổi hình này thành một hình với mẫu tạo kiểu bằng cách sử dụng hàm to_template ().
Một mã ví dụ như được hiển thị:
nhập khẩu có âm mưu. đây như đâyfig_templated = đây. to_templated ( quả sung )
Trong đoạn mã ở trên, chúng ta bắt đầu bằng cách nhập mô-đun io âm mưu làm io. Sau đó, chúng tôi tạo một bản sao của hình với kiểu dáng được lưu vào một mẫu tùy chỉnh bằng cách sử dụng hàm to_templated ().
Chúng ta có thể xem mẫu bằng cách chạy mã:
Fig_templated. cách trình bày . mẫuĐiều này sẽ trả về một từ điển với các thuộc tính xác định kiểu dáng của hình. Giá trị đầu ra ví dụ như được hiển thị:
cách trình bày. Mẫu ( {'dữ liệu' : { 'quán ba' : [ { 'error_x' : { 'màu sắc' : '# 2a3f5f' } ,
'error_y' : { 'màu sắc' : '# 2a3f5f' } ,
'đánh dấu' : { 'hàng' : { 'màu sắc' : '# E5ECF6' , 'bề rộng' : 0,5 } ,
'họa tiết' : { 'fillmode' : 'lớp phủ' , 'kích thước' : 10 , 'sự vững chắc' : 0,2 } } ,
-------------------------------------- đầu ra bị cắt ngắn ---------- -------------------------------
Bạn có thể hiển thị hình này đơn giản bằng cách gọi mẫu đã lưu là:
fig_templatedĐiều này sẽ hiển thị hình được lưu trong mẫu.
Tạo một Hình với Mẫu
Khi chúng tôi đã lưu kiểu dáng của một hình vào một mẫu tùy chỉnh, chúng ta có thể sử dụng mẫu đó để áp dụng kiểu cho một hình khác.
Một mã ví dụ như được hiển thị:
nhập khẩu có âm mưu. graph_objectsas đinew_fig = đi. Nhân vật ( cách trình bày = {
'mẫu' : fig_templated. cách trình bày . mẫu
} )
new_fig
Trong ví dụ trên, chúng ta bắt đầu bằng cách nhập mô-đun graph_objects từ Plotly. Trong trường hợp này, chúng tôi đang sử dụng graph_objects như chúng tôi muốn để tạo một hình rỗng nhưng chỉ sử dụng kiểu dáng.
Sử dụng hàm go.Figure (), chúng tôi truyền tham số bố cục và chỉ định mẫu đích bằng thuộc tính ‘template’.
Sau đó, chúng ta có thể hiển thị con số kết quả bằng cách gọi new_fig. Điều này sẽ trả về:
Lưu ý rằng hình trên không chứa bất kỳ dữ liệu hoặc văn bản nào. Nó chỉ bao gồm kiểu dáng, chẳng hạn như màu văn bản, họ phông chữ, kích thước phông chữ, v.v.
Để tạo biểu đồ phân tán với mẫu này, chúng ta có thể sử dụng mã như được hiển thị:
nhập khẩu có âm mưu. graph_objectsas đinhập khẩu numpyas np
N = 1000
t = ví dụ. linspace ( 0 , 10 , năm mươi )
Y = ví dụ. không có ( t )
quả sung = đi. Nhân vật ( dữ liệu = đi. Tiêu tan ( x = t , Y = Y , cách thức = 'điểm đánh dấu' ) , cách trình bày = {
'mẫu' : fig_templated. cách trình bày . mẫu
} )
quả sung. buổi bieu diễn ( )
Ví dụ trên sẽ trả về một hình như được hiển thị:
Lưu ý rằng màu chữ, họ và kích thước tương tự như một bộ trong mẫu.
Lưu mẫu được đặt tên
Chúng tôi có thể lưu mẫu tùy chỉnh bằng cách sử dụng đối tượng mẫu như được hiển thị trong mã bên dưới:
nhập khẩu có âm mưu. đây như đâyđây. mẫu [ 'my_custom_template' ] = Fig_templated. cách trình bày . mẫu
Đoạn mã trên sẽ lưu mẫu dưới tên ‘my_custom_template’. Sau đó, bạn có thể sử dụng tên này để chỉ định mẫu bạn muốn sử dụng:
cách trình bày = {'mẫu' : 'my_custom_template'
}
Sự kết luận
Trong hướng dẫn này, chúng ta đã học cách tạo một hình với kiểu dáng được lưu vào một mẫu tùy chỉnh. Chúng tôi cũng đã trình bày cách sử dụng mẫu trong các hình khác và lưu mẫu để sử dụng sau này.