Pythonでパスのエラーが出てしまいます。何が原因なのでしょう？

Question

実現したいこと

相対パスを用いても以下のソースコードをが正常に動作できるようにしたいです。

発生している問題・分からないこと

tkinterを用いたアプリ作りで画像を表示させたいのですがエラーが起こってしまいます。
絶対パスだと正常に動作しますが相対パスを使うとエラーが出てしまいます。
教本の通りに書いたのですが何が原因なのでしょう？
わかる方はぜひ教えてください。よろしくお願いします。

エラーメッセージ

    bg = tkinter.PhotoImage(file="otimono/image/neko_bg.png")
         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Library/Frameworks/Python.framework/Versions/3.12/lib/python3.12/tkinter/__init__.py", line 4151, in __init__
    Image.__init__(self, 'photo', name, cnf, master, **kw)
  File "/Library/Frameworks/Python.framework/Versions/3.12/lib/python3.12/tkinter/__init__.py", line 4098, in __init__
    self.tk.call(('image', 'create', imgtype, name,) + options)
_tkinter.TclError: couldn't open "otimono/image/neko_bg.png": no such file or directory

該当のソースコード

bg = tkinter.PhotoImage(file="otimono/image/neko_bg.png")
cursor = tkinter.PhotoImage(file="otimono/image/neko_cursor.png")
img_neko = [
    None,
    tkinter.PhotoImage(file="otimono/image/neko1.png"),
    tkinter.PhotoImage(file="otimono/image/neko2.png"),
    tkinter.PhotoImage(file="otimono/image/neko3.png"),
    tkinter.PhotoImage(file="otimono/image/neko4.png"),
    tkinter.PhotoImage(file="otimono/image/neko5.png"),
    tkinter.PhotoImage(file="otimono/image/neko6.png"),
    tkinter.PhotoImage(file="otimono/image/neko_niku.png")
]

試したこと・調べたこと

• teratailやGoogle等で検索した
• ソースコードを自分なりに変更した
• 知人に聞いた
• その他

上記の詳細・結果

パスの書き方を間違えていないかなど調べてみましたが、初心者なので勝手がわかりません。

補足

ファイル構造です。参考にしてください。

Comments

[melian]

> パスのエラーが出てしまいます。何が原因なのでしょう？
> 相対パスを用いても以下のソースコードをが正常に動作できるようにしたい

相対パスの起点となるカレントディレクトリが想定しているディレクトリとは異なっているのでしょう。
対応としてはカレントディレクトリを変更するとよいかと思います。質問にあるディレクトリ構成の画像を見る限り、otimono.py があるディレクトリに image ディレクトリがある様なので、そのディレクトリに移動します。また、file="otimono/image/..." という指定から "otimono/" を除去します。

import os

os.chdir(os.path.dirname(os.path.abspath(__file__)))

bg = tkinter.PhotoImage(file="image/neko_bg.png")
　　　:

[boom]

コメントありがとうございます。

Answer 1

すでに回答が出てますが、「相対パス」の起点は「カレントディレクトリ」であり、「カレントディレクトリ」は「プログラムのファイルがあるディレクトリ」とは直接には何の関係もありません(下記注)。

Wikipedia:カレントディレクトリ ( https://ja.wikipedia.org/wiki/%E3%82%AB%E3%83%AC%E3%83%B3%E3%83%88%E3%83%87%E3%82%A3%E3%83%AC%E3%82%AF%E3%83%88%E3%83%AA )

カレントディレクトリ起点でなく、プログラムソース(各.pyファイル)のあるディレクトリ起点の相対パスでファイルを指定したい場合：

案1：__file__でそれを含む.pyファイルの絶対パスが取れるので（Pythonのバージョンと起動方法によってはカレントディレクトリからの相対パスだが気にしなくていい)、あとは、パス名を処理するライブラリを使って、ディレクトリを求めて、それと「プログラムソースのあるディレクトリ起点の相対パス」を連結すれば良い。
ただし、この場合は、最終的には絶対パスでアクセスしていることになります（Pythonのバージョンと(以下略))。

案2：案1に書いた方法で、.pyファイルのあるディレクトリのパスを得て、そこにos.chdir()でカレントディレクトリを変更し、「.pyファイルのあるディレクトリ」と「カレントディレクトリ」を一致させる。
あとは、普通に相対パスで指定すれば良い。
ただし、他の部分でカレントディレクトリに依存した処理があると、カレントディレクトリの変更により、その部分で期待しない結果になるかも知れません。普通は意図的に書かないとそういうコードは無いと思いますけど。

(注：WindowsのExplorerのようなGUI環境でアイコンクリックでプログラムを起動したようなケースでは、その起動されたプログラムプロセスのカレントディレクトリの初期値はそのアイコンのあったディレクトリになるようです。全GUIツールがそうなのかは知らないけど。あと、ウェブアプリのプログラムプロセスの初期値も。なので「相対パスの起点はプログラムファイルの場所」と誤解している人が多いのかと思います。）

Comments

[boom]

回答ありがとうございます。今後の参考にさせていただきます。

Answer 2

otimonoディレクトリ内で

python otimono.py

のような実行をしてないでしょうか？

相対パス指定の場合はファイルからみたパスではなく、カレントディレクトリからみたパスになりますので
otimonoディレクトリの1つ上のディレクトリから

python otimono/otimono.py

のようにすればパスは合うのではないかと思います。

カレントディレクトリに関わらず、スクリプト配置上の相対パスを取得したい場合は __file__ とpathlibを組み合わせるなどの対応が必要です。

Comments

[boom]

回答ありがとうございます。無事解決しました。
助言していただいた通り__file__を使うと解決することができました。