.. title:: Pythonで心理実験 目次
Pythonで心理実験
======================
はじめに
--------
さまざまなOSでフリーで利用できるpythonを使った心理実験プログラム入門?です。 今まで何度かきちんとしたものを作ろうとして挫折しているので、挫折しないように深く考えずテキトーに書き散らかしています。 解説中では一応pythonの文法について簡単な説明がありますが、かなりいい加減な記述もありますので、まっとうなpythonの入門書も参考にしながら読んでください。
.. note::
追記 (2019年6月)
「例題1」を書いてから約10年の月日が流れ、Pythonでの心理実験作成を取り巻く状況も大きく変化しました。例題17まではVisionEggを使うことを前提として書いていたのですが、現在のPC環境でVisionEggを使用することが困難になってきたため、それらの記述は今から学ぶ人にとってほとんど役に立たないものとなってしまいました。最近は内容を更新するための時間をほとんど確保できないので削除することも考えましたが、ctypes関連など今でも利用できる情報が残っていますのでひとまず残しておくことにしました。
これから学ぶ人はPsychoPyを利用することをお勧めします。
+ PsychoPyの一部であるPsychoPy Builderというアプリケーションを用いて実験を作成したい方は、 `「PsychoPy Builderで作る心理学実験」 `_ をご覧ください。PsychoPyのインストールから初歩的な実験の作成、Pythonのコードを併用した高度な実験の作成まで、用語の解説などを交えながら解説しています。この文書の概要を :doc:`例題24-1 <24-1>` で紹介しています。
+ この「Pythonで心理実験」では例題18以降でPsychoPyの解説をしています。
+ 朝倉書店より `心理学実験プログラミング: Python/PsychoPyによる実験作成・データ処理 `_ という本が出ておりますので、そちらもご参照ください。
+ `関西学院大学の小川先生のサイト `_ でも詳しく解説されています。
+ 大学の計算機室のPCなど、PythonをインストールできないWindows機で作業したい方向けに :ref:`Windows用Portable PsychoPy/VisionEgg ` を用意しています。USBメモリなどに入れてご利用ください。
準備編:PythonとVisionEggのインストール
------------------------------------------------------
Windows XP/Vistaを例として、pythonで心理実験プログラムを書くための準備を説明しています。 Unix系OSを使う人はここに書いてあることくらい知っているだろう…という偏見に基づいてUnix系OSの説明はバッサリ省いています。 あ、そういえばMacOSもXからUnix系OSになりましたね。MacOS Xのpythonってどうなんだろう?
.. toctree::
:maxdepth: 1
00-1
00-2
例題1:いきなりリーディングスパンテストを作ってみる
----------------------------------------------------
無謀にもpythonの基本的な文法の解説すら無いままいきなりリーディングスパンテストのプログラムを作ってみます。 最低限の用語は **ごくいい加減に** 解説していますが、きちんとしたpythonの教科書や `pythonドキュメントの日本語訳 `_ などで確認していただいた方がよいと思います。 いずれはきちんとした説明を…書けたらいいなあ。
.. toctree::
:maxdepth: 1
01-0
01-1
01-2
01-3
01-4
01-5
例題2:この音とあの音を足すとどんな音?
----------------------------------------
**先にきちんと説明しとくべきことがもっとあるだろ** というツッコミもあるかと思いますが、唐突にpythonでwavファイルを作ったり鳴らしたりしてみます。 計画性のかけらもないのがばればれです。
.. toctree::
:maxdepth: 1
02-1
02-2
例題3:変数3分間クッキング
----------------------------
ようやくと言うか何と言うか、さすがに文法の話も少しはしておかないと例題を作るのも大変なので、演算子の解説です。 全てのデータ型や演算子を網羅するよりも、 **独断と偏見に基づいて** 私自身が実験プログラムの作成に使うものを中心に解説しています。
.. toctree::
:maxdepth: 1
03-1
03-2
03-3
03-4
例題4:データを保存してあれこれ
--------------------------------
データをテキスト形式で出力、分析する方法について解説する予定です(作成中)。 ファイルをまとめて処理する方法などは心理実験に限らずさまざまな場面で使えると思います。 本当は正規表現なんかも解説したいんですが、果たしていつになることやら。
.. toctree::
:maxdepth: 1
04-1
04-2
例題5:徹底的に使いまわす
--------------------------
ここでの目標は関数の作り方とクラスの継承の方法を習得する事です。どちらも初めてプログラムを学ぶ人には少し難しいと思いますが、 ステップアップのためには絶対に身につけなければならない技術です。 すでにpython以外の言語で関数をマスターしている人には大した事のない内容かもしれませんが、pythonの変数スコープや関数引数は独特な面がありますので、さらっと読んでおかれるとつまらない事で躓かずに済むかも知れません。 ちなみに私はC++からpythonに移ってすぐの頃にしっかり躓きました。
.. toctree::
:maxdepth: 1
05-1
05-2
05-3
05-4
05-5
例題6:複雑な刺激はテクスチャにお任せ
--------------------------------------
Motion Induced Blindnessのデモを題材に、画像ファイルの表示とアニメーション速度の調節を解説します。 というと大げさですが、速度の調節なんかは他の言語で実験プログラムを書いたことがある人にとっては目新しいことはなにもないはず。 さらっと済ませる予定。
.. toctree::
:maxdepth: 1
06-1
06-2
例題7:VisionEggのサンプルを読む
------------------------------------------
例題7にもなっていまさらですが、VisionEggはサンプルプログラムも配布されています。 これらのサンプルプログラムで頻繁に利用されているVisionEgg.FlowControl.Presentationについてごく簡単に解説します。
.. toctree::
:maxdepth: 1
07-1
例題8:テクスチャ自由自在
--------------------------
本来なら例題6-2の続きとすべき内容ですが、気まぐれで例題7を入れてしまったので例題8として仕切り直しです。行き当たりばったり感満載です。 まあ図らずも例題7で解説した知識が必要なサンプルプログラムが出てくるので勘弁してください。
.. toctree::
:maxdepth: 1
08-1
08-2
08-3
例題9: [上級] C言語用ライブラリでもpythonで
--------------------------------------------------------
C言語用ライブラリをpythonから呼び出すという極悪…じゃない、頼もしいパッケージctypesを使ってみます。 この例題程度の用途ならCで書いた方が早いかもしれませんが、最近は何をするにしてもほとんどpythonとmatlabなので、pythonで書けるというのはやはりありがたい。
.. toctree::
:maxdepth: 1
09-1
09-2
例題10: インタラクティブに使う
----------------------------------
心理実験に利用できる有名な開発環境のひとつとしてMatlabが挙げられます。 個人的には言語としてのMatlabはあまり好きじゃないんですがその開発環境のインタラクティブ性は非常に魅力的だと思います。 例題10ではpythonをMatlabみたいにインタラクティブに使用することができるipythonとspyderを紹介します。
それにしてもいくら行き当たりばったりとはいえhelp()はもっと早い段階で紹介しとくべきだったな…
.. toctree::
:maxdepth: 1
10-1
10-2
10-3
例題11: 細かく言いだすと大変な反応時間の測定
------------------------------------------------
予定を変更してずっと先延ばしにしていた反応時間の問題を取り上げます。なんかストレスがたまっていて一気に吐き出すように書いたので全然推敲してません。他の例題は推敲してんのかといわれるとご想像通りしていなかったりするわけですが。 PCでの反応時間測定はおおらかな心でいれば簡単ですが、細かいことを言い出すと本当に厄介です。
.. toctree::
:maxdepth: 1
11-1
11-2
例題12:小ネタ一掃作戦
------------------------
今まで堆積していた小ネタを放出します。 行き当たりばったりで全然「次回予告」通りにできないので、次回予告するのはやめます…。
.. toctree::
:maxdepth: 1
12-1
12-2
12-3
12-4
12-5
例題13: [上級] 反応時間再び
----------------------------------
例題11の完結編です。手を付け始めるともっと高速、高精度を求めたくなる性分なのですが、本業の研究がおろそかになりっぱなしなのでこのくらいで自重します…
.. toctree::
:maxdepth: 1
13-1
例題14: 実践!データ処理
----------------------------
例題12-5で紹介した実験プログラムを使って取ったデータを処理してみます。適当に済ませるつもりだったんですが、いざ書きだすと「あれも、これも」という感じで盛りだくさんの内容になってしまいました。 Matlabと似て非なる点がたくさん出てくるので、Matlabからの引っ越しを検討されている方には参考になるかもしれません。 なお、この例題ではpylabをimportして作業しているのでnumpyのクラスや関数がpylab.ほげほげ という名前で出てきますのでご注意ください(e.g. numpy.array → pylab.array)。
.. toctree::
:maxdepth: 1
14-1
14-2
14-3
14-4
14-5
例題15:続・準備編
--------------------
WindowsでUSBメモリにPythonをインストールして持ち運べる「Portable Python」でVisionEggを動かそうという話です。大学の授業でPythonを使用する場合にとても便利だと思ったので、急遽例題15として取り上げることにしました。ついで?と言っては何ですがUbuntuにVisionEggをセットアップする例も書いておきます。
.. toctree::
:maxdepth: 1
15-1
15-2
例題16:刺激のカタログ
------------------------
VisionEggに準備されている視覚刺激のうち、まだ解説していないものをとりとめもなく紹介します。
.. toctree::
:maxdepth: 1
16-1
16-2
16-3
16-4
16-5
例題17:Webカメラで記録をとろう
------------------------------------
唐突ですがWebカメラをPythonから利用します。ディスプレイのリフレッシュレートの約数のfpsで安定して撮れるモデルであれば刺激と映像の同期を(おおざっぱですが)取れるのでそこそこ便利なのではないでしょうか。
.. toctree::
:maxdepth: 1
17-1
17-2
17-3
例題18:ついPsychoPyに手を出してしまったりなんかして
--------------------------------------------------------------
満を持して(?)PsychoPyの登場です。VisionEggと同じように心理学実験の作成、実施をサポートするpythonパッケージですが、VisionEggとはかなり考え方が異なります。
.. toctree::
:maxdepth: 1
18-1
18-2
18-3
18-4
18-5
18-6
18-7
例題19:PsychoPyで遊ぶ
--------------------------------
別にPsychoPyに乗り換えたわけでもなんでもないんですが、もうすこしPsychoPyを扱います。
.. toctree::
:maxdepth: 1
19-1
19-2
19-3
19-4
19-5
19-6
19-7
例題20:チュートリアルワークショップ@JPA77ご報告
--------------------------------------------------------
例題20は記念ということで何を取り上げようかなあと思っていたのですが、去る2013年9月19日に行った日本心理学会第77回大会チュートリアルワークショップ「心理学研究のための Python 活用法」のご報告をさせていただくことにしました。今後ともよろしくお願い申し上げます。
.. toctree::
:maxdepth: 1
20-1
20-2
例題21:つながる、つながる
----------------------------
チュートリアルワークショップでも質問があった外部機器との接続を取り上げます。
.. toctree::
:maxdepth: 1
21-1
21-2
21-3
21-4
例題22:Pythonでのデータ解析をもっと便利に
--------------------------------------------------
えーと、没原稿の供養です。エサを与えないでください、じゃなくて尋ねないでください。
.. toctree::
:maxdepth: 1
22-1
22-2
22-3
例題23:チュートリアルワークショップ@JPA78ご報告
--------------------------------------------------------
2014年9月11日に行った日本心理学会第78回大会チュートリアルワークショップ「PsychoPy Builderにおける 実験の動的な制御の方法」のご報告です。それにしてもこの1年で例題21、22しか書いていないのかと思うとがっくり。
.. toctree::
:maxdepth: 1
23-1
例題24:「PsychoPy Builderで作る心理学実験」イントロダクション
--------------------------------------------------------------------------------
この「Pythonで心理実験」にはPsychoPyをこれから始めようという人向けのコンテンツがない!ということで作成したPDF文書「PsychoPy Builderで作る心理学実験」のイントロダクションです。 どんなことが書いてあるのか気になるけどページ数が多くて目を通すのが大変、という方はまずはご覧ください。
.. toctree::
:maxdepth: 1
24-1
24-2
例題25:パッケージの管理
--------------------------
PsychoPy 1.82.02のリリースに向けて急を要すると思って書いたのですが…。結果的に急ぐ必要がなくなってしまいました。うぅ。
.. toctree::
:maxdepth: 1
25-1
例題26:やれやれ、また反応時間だよ
------------------------------------------
ものすごく久しぶりの更新です。PsychoPy 3.1で導入されたPsychToolbox由来のキーボードモジュールを試します。
.. toctree::
:maxdepth: 1
26-1
例題27:JavaScriptで心理実験?
------------------------------------------
PsychoPy Builderのオンライン実験作成機能で出力されたJavaScriptのコードを読みます。これって「Pythonで心理実験」に含めちゃっていいのかな…
.. toctree::
:maxdepth: 1
27-1
27-2