飛び込みましょう。
関数の構文
この関数は、コードに集中できる単純な構文を提供します。構文は次のように表されます。
陰謀的に。 これ . to_templated ( 図 、 スキップ = ( '題名' 、 '文章' ) )
関数のパラメーターは次のとおりです。
- Fig – スタイル設定をテンプレートに移動する Figure オブジェクトを指定します。
- Skip – スタイルをテンプレートに移動するときに除外するプロパティの名前のコレクションを指定します。デフォルトでは、タイトル プロパティのみが含まれます。これにより、軸タイトルなどの Figure のテキストが他の Figure によってインポートされるのを防ぎます。
Figure は、スタイリングがテンプレートに移動された Figure のコピーを返します。 go.Figure の戻り型。
例
to_templated() 関数を使用して、特定の図のスタイルをテンプレートにエクスポートする方法を説明しましょう。
カスタム スタイルを使用して図を作成することから始めましょう。コード例を以下に示します。
輸入 陰謀的に。 特急 なので ピクセルdf = px. データ . 虹彩 ( )
図 = px. 散らばる ( df 、 バツ = 'がく片の長さ' 、 よ = 'sepal_width' 、 色 = '種族' 、
題名 = 「カスタムスタイリング」 )
図。 update_layout (
フォントファミリー = 「クーリエニュー、モノスペース」 、
font_color = '赤' 、
フォントサイズ = 18 、
title_font_family = 「タイムズ・ニュー・ロマン」 、
title_font_color = '青い' 、
legend_title_font_color = '緑'
)
図。 update_xaxes ( title_font_family = 「アリエル」 )
図。 見せる ( )
この例では、フォント ファミリー、フォントの色、フォント サイズなどのカスタム テキスト スタイルで散布図を作成します。
上記のコードは、次のような単純な散布図を返します。
to_template() 関数を使用して、この図をスタイリング テンプレート付きの図に変換できます。
コード例は次のとおりです。
輸入 陰謀的に。 これ なので これfig_templated = これ。 to_templated ( 図 )
上記のコードでは、plotly io モジュールを io としてインポートすることから始めます。次に、to_templated() 関数を使用してカスタム テンプレートに保存されたスタイリングで Figure のコピーを作成します。
次のコードを実行して、テンプレートを表示できます。
fig_templated. レイアウト . テンプレートこれにより、Figure のスタイルを定義するプロパティを含む辞書が返されます。出力値の例は次のとおりです。
レイアウト。 テンプレート ( {'データ' : { 'バー' : [ { 「エラー_x」 : { '色' : 「#2a3f5f」 } 、
「エラー_y」 : { '色' : 「#2a3f5f」 } 、
'マーカー' : { 'ライン' : { '色' : 「#E5ECF6」 、 '幅' : 0.5 } 、
'パターン' : { 「フィルモード」 : 'かぶせる' 、 'サイズ' : 10 、 「堅牢性」 : 0.2 } } 、
--------------------------------------出力が切り捨てられました---------- -------------------------------
保存したテンプレートを次のように呼び出すだけで、Figure を表示できます。
fig_templatedこれにより、テンプレートに保存された図が表示されます。
テンプレートを使用して図を作成する
Figure のスタイル設定をカスタム テンプレートに保存したら、そのテンプレートを使用して別の Figure にスタイル設定を適用できます。
コード例は次のとおりです。
輸入 陰謀的に。 graph_objectsas 行くnew_fig = 行く。 形 ( レイアウト = {
'テンプレート' : fig_templated. レイアウト . テンプレート
} )
new_fig
上記の例では、Plotly から graph_objects モジュールをインポートすることから始めます。この場合、空の図を作成したいがスタイリングだけを使用したいので、graph_objects を使用しています。
go.Figure() 関数を使用してレイアウト パラメータを渡し、「template」プロパティを使用してターゲット テンプレートを指定します。
次に、new_fig を呼び出して結果の Figure を表示できます。これは次のように返されます。
上の図にはデータやテキストが含まれていないことに注意してください。テキストの色、フォント ファミリー、フォント サイズなどのスタイルのみが含まれます。
このテンプレートで散布図を作成するには、次のコードを使用できます。
輸入 陰謀的に。 graph_objectsas 行く輸入 numpyas np
N = 1000
t = 例えば linspace ( 0 、 10 、 50 )
よ = 例えば それなし ( t )
図 = 行く。 形 ( データ = 行く。 散布 ( バツ = t 、 よ = よ 、 モード = 「マーカー」 ) 、 レイアウト = {
'テンプレート' : fig_templated. レイアウト . テンプレート
} )
図。 見せる ( )
上記の例では、次のような図が返されます。
フォントの色、ファミリ、およびサイズは、テンプレートで設定されているものと似ていることに注意してください。
名前付きテンプレートの保存
以下のコードに示すように、テンプレート オブジェクトを使用してカスタム テンプレートを保存できます。
輸入 陰謀的に。 これ なので これこれ。 テンプレート [ 'my_custom_template' ] = fig_templated. レイアウト . テンプレート
上記のコードは、テンプレートを「my_custom_template」という名前で保存します。この名前を使用して、使用するテンプレートを指定できます。
レイアウト = {'テンプレート' : 'my_custom_template'
}
結論
このチュートリアルでは、スタイル設定をカスタム テンプレートに保存して Figure を作成する方法を学びました。また、他の図でテンプレートを使用する方法と、後で使用するためにテンプレートを保存する方法についても説明しました。