Markオブジェクトのプロパティ#
座標プロパティ#
x, y, xmin, xmax, ymin, ymax#
座標プロパティは、マークがプロット上にどこに描画されるかを決定します。標準的には、x
座標は水平位置、y
座標は垂直位置です。いくつかのマークは、1つまたは両方の変数に対して範囲(つまり、min
、max
)パラメータ化を受け入れます。その他はx
とy
を受け入れる場合がありますが、範囲を示すbaseline
パラメータも使用します。レイヤーのorient
パラメータは、これがどのように機能するかを決定します。
変数が数値データを含まない場合、そのスケールは変換を適用して、データを画面上に描画できるようにします。例えば、Nominal
スケールは、各異なるカテゴリに整数インデックスを割り当て、Temporal
スケールは、参照「エポック」からの日数として日付を表します。

Continuous
スケールは、データ値と空間位置の間に非線形変換を適用することもできます。

カラープロパティ#
color, fillcolor, edgecolor#
すべてのマークにはcolor
を指定でき、多くのマークはマークの「エッジ」と「塗りつぶし」の色を区別します。多くの場合、単にcolor
を使用すると両方が設定されますが、より具体的なプロパティを使用すると、さらに制御できます。

colorプロパティがマッピングされると、デフォルトのパレットはスケールのタイプによって異なります。名義スケールは離散的な、順序付けられていない色相を使用し、連続スケール(時間スケールを含む)は連続的な勾配を使用します。

注記
デフォルトの連続スケールは、識別性を向上させるために将来のリリースで変更される可能性があります。
カラースケールは、'viridis'
、'rocket'
、または'deep'
などのパレットの名前でパラメータ化されます。一部のパレット名には、単純なグラデーション(例:'dark:blue'
)やcubehelixシステム(例:'ch:start=.2,rot=-.4`
)を含むパラメータを含めることができます。適切な選択を行うためのガイダンスについては、カラーパレットチュートリアルを参照してください。
連続スケールは、スケールが補間する色のタプルによってもパラメータ化できます。名義スケールを使用する場合は、パレットの名前(必要に応じて離散的にサンプリングされます)、個々の色の値のリスト、またはデータ値を色に直接マッピングする辞書のいずれかを指定できます。
個々の色は幅広いフォーマットで指定できます。これらには、現在のカラーサイクルへのインデックス参照('C0'
)、1文字の省略形('b'
)、グレースケール値('.4'
)、RGBヘックスコード('#4c72b0'
)、X11カラー名('seagreen'
)、およびXKCDカラー調査名('purpleish'
)が含まれます。

alpha, fillalpha, edgealpha#
alpha
プロパティは、マークの不透明度を決定します。alphaを下げると、オーバープロットの場合に密度を表すのに役立ちます。

alpha
プロパティをマッピングすることは、マークが重ならない場合でも役立ちます。これは重要性を伝えることができ、color
スケールと組み合わせて2つの変数を表すことができます。さらに、アルファ値の低い色は彩度が低く見え、大きな塗りつぶされたマーク(棒グラフなど)の見栄えが向上します。
color
と同様に、一部のマークは追加の制御のために別々のedgealpha
とfillalpha
プロパティを定義します。
スタイルプロパティ#
fill#
fill
プロパティは、エッジと内部を区別するマークに関連し、内部が表示されるかどうかを決定します。これはブール値の状態です。fill
はTrue
またはFalse
のみに設定できます。

marker#
marker
プロパティは、ドットマークと一部のラインマークに関連します。マーカを指定するためのAPIは非常に柔軟で、matplotlib APIドキュメントに詳細に記載されています。matplotlib.markers
.
マーカは、いくつかの簡単な文字列コードを使用して指定できます。

また、(num_sides, fill_style, angle)
タプルを使用してプログラム的に生成することもできます。

mathtex文字コード('$...$'
)や頂点の配列など、追加のフォーマットについては、matplotlibのドキュメントを参照してください。
マーカプロパティは常に名義スケールでマッピングされます。異なる形状には固有の順序付けはありません。スケールが提供されない場合、プロットはプログラム的に適切なサイズのユニークなマーカのセットを生成します。

これにより、形状は技術的に区別されますが、多くの場合、1つのプロットで少数のマーカ以上を使用すると、マーカを区別することは困難です。
注記
デフォルトのマーカスケールは、識別性を向上させるために将来のリリースで変更される可能性があります。
linestyle, edgestyle#
linestyle
プロパティはラインマークに関連し、edgestyle
プロパティは「エッジ」を持つ多くのマークに関連します。どちらのプロパティも、オンオフセグメントに関して線の「破線」を決定します。
破線は、少数の省略形コード('-'
、'--'
、'-.'
、および':'
)または(on, off, ...)
タプルを使用してプログラム的に指定できます。タプル指定では、単位は線の幅に等しくなります。

サイズプロパティ#
pointsize#
pointsize
プロパティはドットマークと、個々のデータポイントにマーカを表示できるラインマークに関連します。単位は、ポイント単位のマークの直径に対応します。
パラメータ化は直径に対応していますが、スケールは平方根変換を使用して適用されるため、データ値は面積に比例します。

linewidth#
linewidth
プロパティはラインマークに関連し、その太さを決定します。値は非負で、ポイント単位です。

edgewidth#
edgewidth
プロパティはlinewidth
と似ていますが、線ではなく、縁/塗りつぶしのあるマークに適用されます。また、尺度で使用する場合、デフォルトの範囲が異なります。単位は同じです。

stroke#
stroke
プロパティはedgewidth
と似ていますが、ドットマークが塗りつぶしではなくストロークで定義されている場合に適用されます。デフォルトの尺度範囲がわずかに異なりますが、それ以外は同様に動作します。

テキストプロパティ#
halign, valign#
halign
およびvalign
プロパティは、テキストマークの水平および垂直方向の配置を制御します。水平方向の配置のオプションは'left'
、'right'
、'center'
であり、垂直方向の配置のオプションは'top'
、'bottom'
、'center'
、'baseline'
、'center_baseline'
です。

fontsize#
fontsize
プロパティは、テキストマークのサイズを制御します。値はポイント単位です。

offset#
offset
プロパティは、テキストマークとそのアンカー位置の間隔を制御します。center
配置を使用しない場合(つまり、left/rightまたはtop/bottomを使用する場合)に適用されます。値はポイント単位です。

その他のプロパティ#
text#
text
プロパティは、テキストマークの内容を設定するために使用されます。常に文字通り使用され(マップされません)、必要に応じて文字列に変換されます。
group#
group
プロパティは、マークの外観を何も変更しませんが、変換が独立して操作する追加のデータサブセットを定義するという点で特殊です。