Markオブジェクトのプロパティ#

座標プロパティ#

x, y, xmin, xmax, ymin, ymax#

座標プロパティは、マークがプロット上にどこに描画されるかを決定します。標準的には、x座標は水平位置、y座標は垂直位置です。いくつかのマークは、1つまたは両方の変数に対して範囲(つまり、minmax)パラメータ化を受け入れます。その他はxyを受け入れる場合がありますが、範囲を示すbaselineパラメータも使用します。レイヤーのorientパラメータは、これがどのように機能するかを決定します。

変数が数値データを含まない場合、そのスケールは変換を適用して、データを画面上に描画できるようにします。例えば、Nominalスケールは、各異なるカテゴリに整数インデックスを割り当て、Temporalスケールは、参照「エポック」からの日数として日付を表します。

../_images/properties_3_0.png

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

../_images/properties_5_0.png

カラープロパティ#

color, fillcolor, edgecolor#

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

../_images/properties_8_0.png

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

../_images/properties_10_0.png

注記

デフォルトの連続スケールは、識別性を向上させるために将来のリリースで変更される可能性があります。

カラースケールは、'viridis''rocket'、または'deep'などのパレットの名前でパラメータ化されます。一部のパレット名には、単純なグラデーション(例:'dark:blue')やcubehelixシステム(例:'ch:start=.2,rot=-.4`)を含むパラメータを含めることができます。適切な選択を行うためのガイダンスについては、カラーパレットチュートリアルを参照してください。

連続スケールは、スケールが補間する色のタプルによってもパラメータ化できます。名義スケールを使用する場合は、パレットの名前(必要に応じて離散的にサンプリングされます)、個々の色の値のリスト、またはデータ値を色に直接マッピングする辞書のいずれかを指定できます。

個々の色は幅広いフォーマットで指定できます。これらには、現在のカラーサイクルへのインデックス参照('C0')、1文字の省略形('b')、グレースケール値('.4')、RGBヘックスコード('#4c72b0')、X11カラー名('seagreen')、およびXKCDカラー調査名('purpleish')が含まれます。

../_images/properties_12_0.png

alpha, fillalpha, edgealpha#

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

../_images/properties_14_0.png

alphaプロパティをマッピングすることは、マークが重ならない場合でも役立ちます。これは重要性を伝えることができ、colorスケールと組み合わせて2つの変数を表すことができます。さらに、アルファ値の低い色は彩度が低く見え、大きな塗りつぶされたマーク(棒グラフなど)の見栄えが向上します。

colorと同様に、一部のマークは追加の制御のために別々のedgealphafillalphaプロパティを定義します。

スタイルプロパティ#

fill#

fillプロパティは、エッジと内部を区別するマークに関連し、内部が表示されるかどうかを決定します。これはブール値の状態です。fillTrueまたはFalseのみに設定できます。

../_images/properties_18_0.png

marker#

markerプロパティは、ドットマークと一部のラインマークに関連します。マーカを指定するためのAPIは非常に柔軟で、matplotlib APIドキュメントに詳細に記載されています。matplotlib.markers.

マーカは、いくつかの簡単な文字列コードを使用して指定できます。

../_images/properties_21_0.png

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

../_images/properties_23_0.png

mathtex文字コード('$...$')や頂点の配列など、追加のフォーマットについては、matplotlibのドキュメントを参照してください。

マーカプロパティは常に名義スケールでマッピングされます。異なる形状には固有の順序付けはありません。スケールが提供されない場合、プロットはプログラム的に適切なサイズのユニークなマーカのセットを生成します。

../_images/properties_25_0.png

これにより、形状は技術的に区別されますが、多くの場合、1つのプロットで少数のマーカ以上を使用すると、マーカを区別することは困難です。

注記

デフォルトのマーカスケールは、識別性を向上させるために将来のリリースで変更される可能性があります。

linestyle, edgestyle#

linestyleプロパティはラインマークに関連し、edgestyleプロパティは「エッジ」を持つ多くのマークに関連します。どちらのプロパティも、オンオフセグメントに関して線の「破線」を決定します。

破線は、少数の省略形コード('-''--''-.'、および':')または(on, off, ...)タプルを使用してプログラム的に指定できます。タプル指定では、単位は線の幅に等しくなります。

../_images/properties_28_0.png

サイズプロパティ#

pointsize#

pointsizeプロパティはドットマークと、個々のデータポイントにマーカを表示できるラインマークに関連します。単位は、ポイント単位のマークの直径に対応します。

パラメータ化は直径に対応していますが、スケールは平方根変換を使用して適用されるため、データ値は面積に比例します。

../_images/properties_31_0.png

linewidth#

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

../_images/properties_33_0.png

edgewidth#

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

../_images/properties_35_0.png

stroke#

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

../_images/properties_37_0.png

テキストプロパティ#

halign, valign#

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

../_images/properties_40_0.png

fontsize#

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

../_images/properties_42_0.png

offset#

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

../_images/properties_44_0.png

その他のプロパティ#

text#

textプロパティは、テキストマークの内容を設定するために使用されます。常に文字通り使用され(マップされません)、必要に応じて文字列に変換されます。

group#

groupプロパティは、マークの外観を何も変更しませんが、変換が独立して操作する追加のデータサブセットを定義するという点で特殊です。