בואו נצלול פנימה.
תחביר פונקציות
הפונקציה מספקת תחביר פשוט המאפשר לך להתמקד בקוד. התחביר מבוטא כך:
עלילתית. זֶה . ל-templated ( תאנה , לדלג = ( 'כותרת' , 'טֶקסט' ) )
הפרמטרים של הפונקציה הם:
- איור - מציין את אובייקט הדמות שאת הסגנון שלו ברצונך להעביר לתבנית.
- דלג - מציין אוסף של שמות של המאפיינים שברצונך לא לכלול בעת העברת הסגנון לתבנית. כברירת מחדל, רק מאפיין הכותרת כלול. זה מונע את יבוא הטקסט של הדמות, כגון כותרות הציר, על ידי דמויות אחרות.
הדמות מחזירה עותק של הדמות כשהסטיילינג הועבר לתבנית. סוג ההחזרה של go.Figure.
דוגמא
הבה נמחיש כיצד אנו יכולים להשתמש בפונקציה to_templated() כדי לייצא את הסגנון של דמות ספציפית לתבנית.
בואו נתחיל ביצירת דמות עם סטיילינג מותאם אישית. קוד לדוגמה מוצג להלן:
יְבוּא עלילתית. אֶקְסְפּרֶס כפי ש פיקסליםdf = פיקסלים נתונים . קַשׁתִית ( )
תאנה = פיקסלים לְפַזֵר ( df , איקס = 'אורך_לוחית' , י = 'רוחב_גליד' , צֶבַע = 'מִין' ,
כותרת = 'סטיילינג מותאם אישית' )
תאנה. update_layout (
משפחת גופן = 'שליח חדש, מונוספייס' ,
צבע גופן = 'אָדוֹם' ,
גודל גופן = 18 ,
title_font_family = 'Times New Roman' ,
title_font_color = 'כָּחוֹל' ,
legend_title_font_color = 'ירוק'
)
תאנה. update_xaxes ( title_font_family = 'אריאל' )
תאנה. הופעה ( )
בדוגמה זו, אנו יוצרים עלילת פיזור עם סגנון טקסט מותאם אישית כגון משפחת גופנים, צבע גופן, גודל גופן וכו'.
הקוד למעלה אמור להחזיר עלילת פיזור פשוטה כפי שמוצג:
אנו יכולים להמיר את הדמות הזו לדמות עם תבנית סטיילינג באמצעות הפונקציה to_template() .
קוד לדוגמה הוא כפי שמוצג:
יְבוּא עלילתית. זֶה כפי ש זֶהfig_templated = זֶה. ל-templated ( תאנה )
בקוד שלמעלה, אנו מתחילים בייבוא המודול io plotly כ-io. לאחר מכן אנו יוצרים עותק של הדמות עם הסגנון שמור בתבנית מותאמת אישית באמצעות הפונקציה to_templated() .
נוכל לראות את התבנית על ידי הפעלת הקוד:
fig_templated. מַעֲרָך . תבניתזה אמור להחזיר מילון עם מאפיינים המגדירים את הסגנון של הדמות. ערך פלט לדוגמה הוא כפי שמוצג:
מַעֲרָך. תבנית ( {'נתונים' : { 'בָּר' : [ { 'error_x' : { 'צֶבַע' : '#2a3f5f' } ,
'error_y' : { 'צֶבַע' : '#2a3f5f' } ,
'סַמָן' : { 'קַו' : { 'צֶבַע' : '#E5ECF6' , 'רוֹחַב' : 0.5 } ,
'תבנית' : { 'מצב מילוי' : 'כיסוי' , 'גודל' : 10 , 'מוּצָקוּת' : 0.2 } } ,
--------------------------------------פלט קטוע---- ------------------------------------
אתה יכול להציג את הדמות פשוט על ידי קריאה לתבנית השמורה בתור:
fig_templatedזה אמור להציג את הדמות שנשמרה בתבנית.
צור דמות עם התבנית
לאחר ששמרנו את הסגנון של דמות בתבנית מותאמת אישית, נוכל להשתמש בתבנית זו כדי להחיל את הסגנון על דמות אחרת.
קוד לדוגמה הוא כפי שמוצג:
יְבוּא עלילתית. graph_objectsas ללכתnew_fig = ללכת. דמות ( מַעֲרָך = {
'תבנית' : fig_templated. מַעֲרָך . תבנית
} )
new_fig
בדוגמה שלמעלה, אנו מתחילים בייבוא המודול graph_objects מ-Plotly. במקרה זה, אנו משתמשים ב-graph_objects מכיוון שאנו רוצים ליצור דמות ריקה אך רק להשתמש בעיצוב.
באמצעות הפונקציה go.Figure(), אנו מעבירים את פרמטר הפריסה ומציינים את תבנית היעד באמצעות המאפיין 'template'.
לאחר מכן נוכל להציג את הדמות המתקבלת על ידי קריאה ל-new_fig. זה אמור להחזיר:
שימו לב שהאיור שלמעלה אינו מכיל נתונים או טקסט. זה כולל רק את הסגנון, כגון צבע טקסט, משפחת גופנים, גודל גופן וכו'.
כדי ליצור עלילת פיזור עם תבנית זו, נוכל להשתמש בקוד כפי שמוצג:
יְבוּא עלילתית. graph_objectsas ללכתיְבוּא numpyas np
נ = 1000
ט = לְמָשָׁל linspace ( 0 , 10 , חמישים )
י = לְמָשָׁל לְלֹא ( ט )
תאנה = ללכת. דמות ( נתונים = ללכת. לְפַזֵר ( איקס = ט , י = י , מצב = 'סמנים' ) , מַעֲרָך = {
'תבנית' : fig_templated. מַעֲרָך . תבנית
} )
תאנה. הופעה ( )
הדוגמה שלמעלה אמורה להחזיר דמות כפי שמוצג:
שים לב שצבע הגופן, המשפחה והגודל דומים לזה שנקבע בתבנית.
שמירת תבנית עם שם
אנו יכולים לשמור את התבנית המותאמת אישית באמצעות אובייקט התבניות כפי שמוצג בקוד שלהלן:
יְבוּא עלילתית. זֶה כפי ש זֶהזֶה. תבניות [ 'התבנית_המותאמת_שלי' ] = fig_templated. מַעֲרָך . תבנית
הקוד שלמעלה ישמור את התבנית תחת השם 'התבנית_מותאמת אישית שלי'. לאחר מכן תוכל להשתמש בשם זה כדי לציין את התבנית שבה ברצונך להשתמש:
מַעֲרָך = {'תבנית' : 'התבנית_המותאמת_שלי'
}
סיכום
במדריך זה, למדנו כיצד ליצור דמות כשהסגנון נשמר בתבנית מותאמת אישית. כיסינו גם כיצד להשתמש בתבנית באיורים אחרים ולשמור את התבנית לשימוש מאוחר יותר.