BSC 專題課程
把別人公開的程式碼在自己的電腦上重跑一次,逐項判斷「對上了沒有」,再做作者沒做的檢查
scripts/video_slides.py,影片由 scripts/make_video.py 產生,規格記在 out/video_meta.json;scripts/video_check.py 檢查「投影片上寫的每一點,旁白有沒有講到」。影片本身也可以直接下載。run_all.sh,按一次就把 PART 3、4 全部跑完;PART 6 把它執行到的每一支程式讀一遍。連結體怎麼變成一個會動的模型,要四個零件:連結體本身、神經元方程式(神經元怎麼放電;放電是神經元之間唯一的訊號)、輸入編碼(遊戲回報的敵人方位怎麼換成視覺神經元的刺激)、讀出規則(神經元的放電怎麼變成按鍵)。並逐項分清楚哪些來自資料、哪些是人為設定:例如哪幾顆神經元的放電對應「開火」鍵,是作者決定的,不在連結體資料裡。
概念為主 · 不需程式基礎 · 已完成
PART 2 準備環境與資料建三個互不干擾的 Python 執行環境(套件是別人寫好、直接拿來用的程式零件,版本不同,算出來的結果就可能不同;執行環境是裝好特定版本套件的一個隔離空間,用 conda 這個工具建;為什麼要三個,第 4 節講)。固定三個東西的版本:作者的程式碼(固定到某一次存檔)、幾個互相衝突的套件、以及遊戲引擎(實際跑 Doom 這個遊戲的軟體,叫 ViZDoom);最會影響結果的是遊戲引擎:版本不固定,每一局的擊殺數就對不上,見下方〈先看數字〉第三格。還有一個會讓結果悄悄改變的陷阱:電腦上另外裝過的 Python 套件會混進環境,而且不會有任何警告。
實作 · 要會用終端機 · 已完成
PART 3 重現 fruitfly-lab六個步驟(代號 FF1–FF6,FF 指 fruitfly-lab,是本課自己編的),每一步先訂「怎樣算對上」再跑。結果:七種大腦各玩 10 局,每一局的擊殺數都與作者相同。七種大腦是作者設的七個條件:完整接線、損毀一對神經元、損毀兩對、打亂接線(兩種設定,差別在把放電換成按鍵的「門檻」怎麼訂,PART 4 卡片講;本頁其他地方說的打亂接線都是作者拿來當主要對照的那一種)、不用大腦每格隨機按鍵(格:遊戲每更新一次畫面算一格,一秒 35 格)、不用大腦直接照敵人位置瞄準;一局是從開始到玩家死亡。
FF1–FF6 · 要會用終端機 · 已完成
PART 4 作者沒做的檢查重現成功只代表「照作者的做法會得到作者的數字」。再往前一步做四項作者沒做的檢查(代號 E1–E4,本課自己編的)。先認識幾個名字。迴路裡的訊號從眼睛往身體傳,要經過幾站(站:接力的一群神經元):視覺神經元 LC10a 之後是並排的兩對中間神經元 AOTU019 與 AOTU025,各自接到出口那一站 DNa02(腦把命令送往身體的下行神經元);作者的程式讀 DNa02 與 AOTU019 兩站的放電來決定按鍵。把放電換成按鍵時,放電率(每秒放電幾次,單位 Hz)要高過一個數值才算按下,這個數值叫門檻;門檻不是人訂的,是把假想敵人放在各個方位、量神經元的反應後算出來的,這個步驟叫校準。四項檢查。E1 把 10 局加大到 50 局,因為作者只跑 10 局、p 值剛好壓線(見下方〈先看數字〉第二格)。E2 給打亂接線一個公平的對照:門檻是對某一套接線量出來的,換一套接線,同樣的放電率可能太高或太低,拿別套接線的門檻會讓打亂接線平白按不出鍵或亂按,成績可能被低估;作者的打亂接線每一局用不同的一種打亂,門檻卻只在其中一種上校準、再套到每一局。改成每一種打亂各自校準之後,50 局平均 1.16,仍遠低於完整接線的 9.86。E3 只讀出口那一站 DNa02、不讀 AOTU019,看迴路算出來的瞄準有沒有送到出口。發現:在敵人正前方、模型瞄準開火的那些時刻,DNa02 完全沒有放電,開火全靠中間那一站 AOTU019;DNa02 只在敵人偏到側邊時放電,管的是轉身。作者沒有說出口神經元其實沒參與開火。這不推翻「完整接線比打亂接線好用」,但「果蠅大腦在瞄準」要縮小成「迴路前半段在作者定的讀法下瞄準」;讀法就是 PART 1 說的那件人為設定:拿哪幾顆神經元的放電對應哪個鍵,不在連結體資料裡。E4 追一件重現時看到、作者沒討論的事:刺激右眼時,切出來的迴路裡右邊那顆 DNa02 只放電 4.4 Hz,全腦模型(Shiu 等人 2024 年把 FlyWire,一份雌果蠅全腦的連結體資料,全部 13 萬多顆神經元一起模擬的版本,見頁尾〈出處〉)裡同一顆有 61.6 Hz,差了十幾倍。拿切出來的迴路和全腦模型比,是看切的時候有沒有少掉重要的輸入;DNa02 的放電是轉身的命令,右邊太弱,敵人在右邊時可能轉不過去。在看過的那一局裡沒看到轉錯方向,對遊戲結果的影響本課沒有確定。
E1–E4 · 要會用終端機 · 已完成
PART 5 逐格看迴路怎麼打把重現時錄下的 Doom 畫面與 8 組神經元(迴路裡的四種神經元各分左右)的放電逐格對齊:完整接線、損毀一對神經元(讓它們整場不放電)、打亂接線三種大腦並排播放。
互動播放 · 不需程式基礎 · 已完成
PART 6 讀程式:一鍵重跑到底跑了什麼從 run_all.sh 開始,順著「誰叫了誰」往下讀三層:第一層是本課寫的兩支 shell script(一個文字檔,裡面是一行一行的終端機指令),第二層是它們叫到的八支 Python 程式(四支本課寫的、四支作者的),第三層是作者的神經元方程式檔。每一段程式先說在做什麼、為什麼要有,再逐行標記。本課寫的檔案在下載包裡全文放;作者的只在頁面上引片段,想看全文再去 GitHub 取。不用先跑過 PART 2 也能讀。讀完,PART 1 那四個零件(連結體、神經元方程式、輸入編碼、讀出規則)各在哪個檔案、哪幾行就對得上。
讀程式 · 不需終端機、不教語法 · 已完成
想自己核對的人:本課頁面上每個數字都來自本機實跑的輸出檔,收在本課網站的程式倉庫(repo:GitHub 上的一個程式資料夾)的 out/ 資料夾,不在下載包裡;這四格依序出自 out/fruitfly/local_doom_vizdoom130/、out/fruitfly/ext_vizdoom1.3.0/E1.json、out/fruitfly/ext_vizdoom1.3.2/E1.json(E1 這項檢查在兩個引擎版本下各跑一次)、out/fruitfly/ext_vizdoom1.3.0/E3.json。怎麼得到這些數字,見 PART 3–4。
| 專案 | 固定的版本 | 用的資料 | 授權 |
|---|---|---|---|
| webergithub/fruitfly-lab | commit 8c27fe8 | FlyWire v783 雌果蠅全腦連結體(FlyWire:從一隻雌果蠅全腦的電子顯微鏡影像重建出每一顆神經元與突觸的計畫,v783 是資料版本)。fruitfly-lab 不直接讀 FlyWire,而是用 Shiu 等人 2024 年全腦模型附的連線表(從 FlyWire 整理成「每一對神經元之間有幾個突觸」的一張表)來建迴路,並用 Shiu 的全腦模型做一次驗證(PART 3 FF3) | repo 裡沒有授權檔 |
表裡的名詞:repo 是 GitHub 上一個專案的程式碼倉庫;commit 是倉庫在某個時間點的快照,8c27fe8 這類代號是它的編號,固定它才能保證重跑的是同一份程式。
fruitfly-lab 沒有附授權檔——沒寫明允許怎麼用,法律上預設不能轉發——所以本課的下載包不附它的任何檔案,由學員自己從 GitHub 取得;頁面上只引用必要的短片段並標明出處。Shiu 等人的全腦模型是 MIT 授權(允許任何人複製、修改、散布)。
延伸:另一個同類的公開專案 fly-blackjack 是另一堂獨立的課:蕈狀體學 21 點:重現 fly-blackjack。
out/ 底下),所有圖都由 scripts/make_figures.py 從那些輸出畫出來。實跑環境:Linux、12 核 CPU、不用 GPU。