Matplotlibでグラフのカスタムラベルを設定しているときに、「UserWarning: FixedFormatter should only be used together with FixedLocator」という警告が出て、地味に気になっていた経験はありませんか？
この警告が出ている状態で放置すると、コードの意図が不明瞭になり、将来的なバグの温床になりかねません。
今回は、この警告を根本から解決するための、オブジェクト指向的な設定方法を試した話です。
何が起きたか（課題）
この警告は、Matplotlibが内部でティック（目盛り）の位置とラベルの対応付けに失敗していることを示唆しています。発生する主なリスクは以下の通りです。
- 設計思想からの逸脱: ライブラリの推奨するAPI（オブジェクト指向API）から外れた使い方をしているサインである。
- 保守性の低下: 簡便な手続き型API（pyplot）を使うことで、複雑な設定変更時に予期せぬ挙動を引き起こす可能性がある。
- 警告の蓄積: 多数のプロットを生成する環境では、警告ログが煩雑になり、本当に重要なメッセージが埋もれる。
Matplotlibの軸設定は、どこに目盛りを打つか（Locator）と、その位置に何を表記するか（Formatter）の二層構造になっています。plt.xticks()のような簡略化された関数を使うと、この二者の整合性が崩れやすくなります。
どう解決したか（概要）
警告を恒久的に解消するためのベストプラクティスは、Axesオブジェクト（ax）を直接操作し、FixedLocator と FixedFormatter を明示的にセットで設定することです。これにより、軸設定の意図がMatplotlibに対して明確になります。
解決のステップは以下の二点に絞られます:
- Axesオブジェクトから
xaxis.set_major_locator()を呼び出し、ティックを表示させたい正確な位置をFixedLocatorで指定する。 - 続けて
xaxis.set_major_formatter()を呼び出し、その位置に対応するラベルのリストをFixedFormatterで指定する。
このペアリングにより、Matplotlibは自動調整を試みず、指定された通りに描画するため、警告は発生しなくなります。
以下は、警告が発生した手続き型コードの例と、推奨されるオブジェクト指向APIを使った修正コードの対比です。
問題のコードでは、plt.xticks([1, 2, 3, 4, 5], ['Apple', 'Banana', ...]) のように一度に指定することで、LocatorとFormatterが暗黙的に処理され、不整合が生じやすい状態でした。
推奨される修正コードでは、まず FixedLocator で位置を固定し、次に FixedFormatter でラベルを固定するという明確な流れを取ります。
このアプローチは、単に警告を消すだけでなく、カテゴリデータのような非等間隔なデータのプロット時に、軸ラベルを完全にコントロール下に置くために必須のテクニックです。
効果（Before/After）
この修正を適用することで、コードの意図が明確になり、実行時に煩わしいUserWarningが出なくなります。特に、データセットが頻繁に入れ替わるような分析パイプラインにおいて、コードの安定性が向上しました。
| 観点 | 非推奨の方法 (plt.xticks) |
推奨される方法 (FixedLocator/FixedFormatter) |
|---|---|---|
| 警告の有無 | 発生する（ノイズ） | 完全にゼロになる |
| APIスタイル | 手続き型（pyplot） | オブジェクト指向型（Axes） |
| メンテナンス性 | 低い | 高い（意図が明確） |
カテゴリデータのプロット例では、X軸が0, 1, 2, 3, 4という数値インデックスになっているのに対し、ラベルが正しくカテゴリ名（A, B, C, D, E）として表示されるようになり、グラフの可読性が向上しました。
🚀 詳細な設定とコードはこちら
具体的なWAFのルール設定や、より詳細なログ解析データは元のブログで公開しています。