0

早く知っておきたかったmatplotlibの基礎知識、あるいは見た目の調整が捗るArtistの話 - Qiita
を読んでいます。

print('ax.xaxis:', ax.xaxis)

となっており、私も実際に下記のコードを書いて動くことを確かめました。

fig = plt.figure()
ax = fig.add_subplot(1,1,1)
print('ax.xaxis:', ax.xaxis)

結果:

ax.xaxis: XAxis(54.0,36.0)

より詳細なことを見に行こうと

https://matplotlib.org/stable/api/axes_api.html

を見たところ

Attributes: 
  dataLimBbox:
    The bounding box enclosing all data displayed in the Axes.

  viewLimBbox:
     The view limits in data coordinates.

となっており、てっきり Attributes に XAxis についての記述があるかと思ったのですが載っていません。

親クラスは、_AxesBase のようですが、ソースコードが掲載されているページしか見つけられませんでした。
https://matplotlib.org/stable/_modules/matplotlib/axes/_base.html

また参考資料に下記のようにAxesSubplotについての言及があります。

AxesSubplotはplt.subplotsで作った場合のAxesオブジェクトと思って問題ありません。

このAxesSubplotドキュメントなら何か記載があるかと思ったのですが、ドキュメントどころかソースコードのページも見つかりません(もしかしたらGitHubをあされば見つかるのかも?)

そもそも、実際に私も色々表示させてみると AxesSubplot というは見たことありますが、Axesと表示されているのは見たことがありません。

オブジェクトが持っているインスタンス変数やメソッドの一覧が見れないと、ソースコードを書くのが結構きついです。
ドキュメントにどこか記載されていないものでしょうか?

質問タイトルについて:
よく使われる変数名axに本来はAxesSubplotが入っているのでしょうが、AxesSubplotAxesの違いも理解があやふやなので、なんと書いていいかわからず、一般的に使われている変数名axを使用しています。


追記:
質問背景としては、x軸の設定方法がaxから直接する方法と、axxaxisを使う方法の2種類の方法がネットにあるようだからです。

例1

import pandas as pd
import matplotlib.pyplot as plt
import seaborn as sns
    
tips = sns.load_dataset('tips')
count_df = tips.groupby('day').day.count().to_frame('count').reset_index()

ax = count_df.plot.bar()
ax.set_xticklabels(count_df.day) # <--- axから直接ティックラベル設定

例2

...
ax.xaxis.set_ticklabels(count_df.day) # <--- axのxaxisからティックラベル設定
...

さらにgetterでxaxisを取得して設定する 例3(この方法はネットで見かけたことがない気がする)

...
ax.get_xaxis().set_ticklabels(count_df.day)  # <--- getterで取得してからティックラベル設定
...

オブジェクト指向インタフェースというからにはオブジェクトごとに役割が決まっているのかと思ったのですが、axから直接X軸の設定ができたり混乱する要素が多いです(まあこれはこれでそこまで変な設計ではないと思いますが)。

私にはプロパティでX軸にアクセスする ax.xaxis.set_ticklabels(count_df.day) の書き方が、1番自然と感じられたのですが、ドキュメントには xaxisプロパティの記載がなく、このようにxaxisプロパティに直接アクセスしていいもののか?とすこし疑問に思ったからです(ドキュメントに記載がなくてもアクサスできちゃうのであればアクセスしても何の問題もないとは思いますが)。

きっと、私がまだmatplotlibのドキュメントに慣れておらず、AxesSubplotのドキュメント(あるのであれば)や、_AxesBaseといった親クラスにxaxisプロパティの存在が記載されているのではないかと推測していました。

1
  • Jupyter Notebook 上ですと表示されるかどうか不明ですが、コマンドラインからでは help(ax.axis) を実行すると XAxis モジュールに関するドキュメントが表示されます。
    – user39889
    2021年6月15日 8:09

1 件の回答 1

2

その参照している matplotlib.axes のページに色々と出てきていますが、それらのことでは不足なのでしょうか?


例えば最初の方の説明(太字化は回答者)

The Axes contains most of the figure elements: Axis, Tick, Line2D, Text, Polygon, etc., and sets the coordinate system.

sharex, sharey : Axes, optional
The x or y axis is shared with the x or y axis in the input Axes.

あるいは下の方の表?にいくつもaxisが出てきます。

Text and annotations

Appearance

Axis / limits

ここの最初に以下があり、AxesからXAxisが取得出来るようです。

Axes.get_xaxis Return the XAxis instance.

以後の表にもいっぱいaxisが出てきています。


XとかYの付かないAxisの説明はこちらのページで、これを継承してXAxisがあるという図になっています。
matplotlib.axis


コメントに対して:

最初に参照している 早く知っておきたかったmatplotlibの基礎知識、あるいは見た目の調整が捗るArtistの話 の記事で、Figure, Axes, Axisは階層構造になっている の部分に、そうしたアクセスの例が記述されています。

fig = plt.figure()
ax = fig.add_subplot(1,1,1) # 何もプロットしていないAxesでもAxisは自動的に作られる
print('fig.axes:', fig.axes)
print('ax.figure:', ax.figure)
print('ax.xaxis:', ax.xaxis)
print('ax.yaxis:', ax.yaxis)
print('ax.xaxis.axes:', ax.xaxis.axes)
print('ax.yaxis.axes:', ax.yaxis.axes)
print('ax.xaxis.figure:', ax.xaxis.figure)
print('ax.yaxis.figure:', ax.yaxis.figure)
print('fig.xaxis:', fig.xaxis)

その次の グラフに表示されているものは全てArtist のところで、データ構造の階層図の直後にこう書かれています。

前項のサンプルコードの結果を見るとわかりますが、Axisは実際にはXAxisとYAxisという名前です。Axisの下にはさらTickという目盛り関連の線や文字のためのcontainerがあります。containerはその名の通りprimitiveを入れる箱を持っています。このとき、containerの階層構造にあった「一つしか持てない」という制限はなく、いくつでもおなじprimitiveを持つことができます。

そしてmatplotlibの Appearance の表にある以下が、「Axisは実際にはXAxisとYAxisという名前です。」を表しているのかもしれません。
(同じく太字化は回答者)

Axes.axis Convenience method to get or set some axis properties.

それだと、確かに公式ドキュメントでは端折りすぎていて説明不足な感じですね。
今のところ明確には書かれていない感じでしょうか。


ちなみに他にこんな記事があります。
matplotlibのめっちゃまとめ
6. 軸の設定

グラフの軸は、横軸Axes.xaxisと縦軸Axes.yaxisと、グラフの枠Axes.spinesでできている。

以後の説明でax.xaxis.xxxxというのがいっぱい使われています。

2
  • get_xaxis があることは実は気づいていたのですが、これはgetterメソッドですよね。getterメソッドがあるくらいだから 直接 xaxis も叩けるだろう。Axis について言及も多いので xaxis を直接呼べるにちがいないくらいの認識で読むとよさそうでしょうか? 2021年6月15日 8:54
  • 質問のタイトルに「持っている」と書いたのがよくなかったですね。確かに内部的にX軸を表現するオブジェクトを持っているのはわかるのですが、直接プロパティ名としてxaxisがあるかどうかドキュメントから不明ということを書きたかったです。 2021年6月15日 8:58

この質問に回答するには、ログインする必要があります。

求めていた回答ではありませんか? のタグが付いた他の質問を参照する。