心理科學研究必用神器2 ~ Open Science Framework
前言
開放科學平台(Open Science Framework)是2013年開放科學中心(Center for Open Science)開始經營的科學研究協作平台,到了2018年7月已經有十萬名註冊使用者。雖然界面語言只有英文,世界各地能使用網路的研究者都知曉這個平台提供研究資料保存與協同合作服務。本人接觸的華文地區有不少科學研究者知道OSF服務,但是一直缺乏學習與使用機會,雖然我還沒有看到官方的正式統計,約略估計華文使用者運用OSF共享及版本控制等服務的普及率,應該低歐美各國使用者不只一倍。
寫作這篇網誌為本人教學與推廣使用。使用的OSF介面截圖取自COS官方功能介紹網頁,如果使用過程有任何問題,可至官方網頁查詢。
註冊、登入與帳戶設定
初次使用請註冊帳號,只要按下如下圖的註冊(Sign up),就會進入註冊頁面。
註冊頁面只要輸入個人完整姓名(建議使用英文),個人常用電子郵件信箱,以及自訂密碼能完成。請留意註冊網頁有防BOT機制(下圖1),按下創建帳戶(下圖2),再到個人電子郵件信箱查看確認信,按下確認連結就完成創建程序。
創建帳戶之後,你隨時可從任何可上網的網頁瀏覽器登入個人OSF帳戶。只要從首頁按下登入(Sign in)即可。
登入畫面輸入註冊的個人電子郵件信箱與密碼,正確即可登入。目前也支援使用者以ORCID登入,如果使用者是專業學術工作者,建議登錄一個專屬ORCID,好處稍後會提到。
帳戶設定
首次登入使用者建議先花點時間在帳戶設定頁面(Profile),填入個人重要資訊,帳戶設定頁面開啟途徑如下圖:
帳戶設定頁面如下圖,不過初次使用或未設定者應該是沒有任何資訊。要填入資訊請點一下如下圖的地方:
個人資訊有四大項,首先是真實姓名(Name)。這個部分建議比照學術寫作格式建立姓名資訊,頁面下方還有預覽APA與MLA格式的姓名呈現,確認無誤就按Save
。如此一來,你所建立的專案就能使用合乎規範的格式於任何報告中引用,或者充實個人履歷的項目。
第二大項集合個人有實際使用的社群平台帳號(Social),包括個人網頁、推特等。稍早提到的ORCID也是在此輸入,儲存後就能使用ORCID登入OSF。
第三大項是工作經歷(Employment),你希望在OSF公開的經歷都可以依下圖欄位填入,正在從事的職位只要勾選Ongoing。
最後一項是學歷(Education),你希望在OSF公開的學歷都可以依下圖欄位填入,在學中的學校只要勾選Ongoging。
個人展望
由於OSF支授ORCID登入,我個人希望OSF下一次改版能讓使用者直接由ORCID匯入。因為ORCID是專屬個人的學術經歷工作帳號,你希望公開讓人檢索的資訊都已經在建立於ORCID,並串連個人的學術作品。此外,ORCID有提供多國語言界面,未來OSF朝向多語界面改版,也能經由讀取使用者ORCID預設語言,自動切換為對應的語言介面。
專案儀表板(Dashboard)
所有使用者登入OSF第一個看到的是如下圖的這個頁面。當使用者創建或協作的專案越多,頁面顯示的專案欄位就越多,欄位預設排序是以專案更新時間,由上至下排列。下圖中每欄的粗體字是專案頁面標題,有些以斜槓(/)區隔的標題,代表該項主專案之下的物件(Component)。在這個頁面你想找比較舊的專案,可以頁面上方的搜尋欄(Search your projects),找出你要維護的專案。
如果要用比較有系統的方式整理與尋找專案,只要按如下圖的My Projects,切換到專案管理介面。
專案管理介面如下圖。下圖畫面是先點選左側分割視的All my projects,在右側分割視窗顯示所有參與的專案,使用者可以先點選一個專案使其標題反白(下圖1),然後按一下右上角的箭頭(下圖2)。
按下箭頭後會跳出如下圖的視窗,顯示已被選擇的專案摘要資訊,讓使用者檢視是否為要找的專案。
專案管理介面和作業系統的檔案管理視窗類似,使用者可以自訂依專案名稱排序,或者依更新時間排序。
與專案儀表板主頁一樣,使雨者可以由過濾對話框(Filter displyaed projects),讓這個頁面只顯示符合目標關鍵詞的專案。
如果你的專案有其他協作者,可由左側視窗選擇協作者姓名,過濾出與該位協作者合作的專案。如果有在專案主頁設定標籤(Tags),也可帶此使用標籤選擇要管理的專案。
以協作者姓名或標籤選擇專案後,可以繼續增減過濾條件,參考下圖2。
OSF的專案管理介面已預設歸類使用者已發佈預印本的專案(All my preprints),以及已註冊的專案(All my registrations)。只要從左側視窗選擇這些歸類,就會只顯示這類專案。
使用者可以自訂專案分類,從點選下圖標示的+開始:
接著會出現如下圖的對話視窗,輸入使用者自訂的分類名稱即可:
已建好的分類可隨時更改名稱或刪除,只要點選下圖的地方。要增加專案至自訂分類,滑鼠點擊按住要加入的專案欄位,反白後拖入自訂分類。
要從自訂分類移除某個專案,按照下圖三個步驟即可。移出自訂分類的專案還是存在於專案儀表板。
看到其他使用者的公開專案值得參考,可用專案書籤收藏。只要在該專案主頁,點選如下圖的功能按鈕。
接著從專案管理介面,左側視窗Bookmarks分類就會看到曾收藏的專案,使用者也可以由此拖放專案到自訂分類。
創建與管理研究專案
OSF平台的每個研究專案(Project)像是個人硬碟裡的一個資料夾,OSF專案提供更多元的資料管理功能,善用這些功能能有效紀錄個人或團隊的研究過程,其他研究者能使用公開專案內容重現研究。
創建新專案
- 建立空白專案
從頭開始建立一個專案很簡單,由專案儀表板按下創建按鈕即可,如下圖提示:
接著出現如下圖對話視窗,預設只要輸入專案標題(Title)即可。不過使用者可以打開More
,輸入專案描述,或者選擇已存在的專案做為模板。基本上只要輸入標題,就可按下Create
:
創建完成可以選擇直接去專案主頁面(Go to new project
),或者留在專案儀表板:
新建好的專案主頁面,下圖是以現存專案做模板建立的新專案,如果是空白專案,不會存在任可檔案(Files)與物件(Component)。
- 使用公開專案創建新專案
當使用者要計畫一項再現研究,或者讓學生規劃一項研究專案,最適合使用這種方法創建專案。進入做為模板的專案主頁面,從下圖標示的按鈕開始:
按下後會出現如下圖的子視窗,選擇中間的Duplicate template
:
確定要就此創建新專案,直接按下Create
管理專案
使用者自建的專案可以隨時變更專案名稱。只要移動滑鼠到標題區域,快速點擊兩下。
標題就會變成如下圖的對話框,使用者可以更改到滿意為止,按下綠色勾勾就完成更改。
如果這個專案現在或未來要公開,使用者可以在主頁面決定授權方式,讓其他使用者了解合理使用專案內容的方法。授權設定從下圖標記處開始:
接著出現如下圖的選單視窗,使用者可選擇一個最適合的授權方式,進行適當編輯後儲存,即可完成授權。
每個專案物件(Component)類似一個子資料夾,創建方法與專案大同小異。以下是創建空白物件的方法,從下圖標記處開始:
下圖與創建空白專案的對話視窗差不多,只有最小面多了物件分類選單,使用者可以根據自訂的物件功能,給予合適的分類:
設定完成後,可自行選擇要去新建的物件頁面(Go to new component
),還是留在專案主頁面。
到物件頁面會發現標題有些不一樣,斜槓之前是主專案標題,並且是一個超連結,讓使用者能回到專案主頁面:
專案隱私設定
每一個OSF專案與物件的隱私設定都是個別調整,預設都是不公開。要改為公開,只要在專案與物件主頁面的如下圖標示處,按下按鈕:
如果是在專案主頁面,會出現如下圖是否要繼續的提示訊息。
接著會出現如下圖的對話視窗,列出專案之下的所有物件,可由此設定那些物件要公開,那些不公開。選好再按繼續鈕。
確認要改成公開的專案與物件,無誤按Confirm
就大功告成。如果要重新選擇請按Back
。
已設為公開的專案與物件也可以改回不公開,按下圖標示處的按鈕,再走一次上面的選擇步驟即可。
專案協作者權限設定
每個OSF專案與物件都可以指定協作者,合作管理專案與物件的內容。官方網站有詳細說明,以下簡單說明OSF的三種權限設定:
Read:有此權限的協作者只能檢閱專案與物件內容,由專案管理者新加入的協作者皆有此權限。 Read+Write:有此權限的協作者可以增加與刪除存放於專案的檔案與wiki,調整外掛與建立物件,也可以修改專案頁面的協作者機構資訊。 Administrator:專案創建者有全部管理者權限,包括調整專案與物件的隱私設定,專案的預先註冊等功能。
在專案與物件頁面列名的協作者不一定是有參與權限的協作者,可由協作者設定頁面安排。有列名的協作者是bibliographic,未列名的協作者是non-bibliographic。
由專案主頁面設定
要增加與刪減協作者,有管理者權限的協作者先按一下下圖標記處,進入協作者設定頁面。
要加入有OSF帳號的協作者,從下圖箭頭標示處按Add
開始:
接著出現如下圖的搜尋視窗,只要在搜尋對話框裡,輸入協作者註冊的全名。
有找到就會出現如下圖的搜尋結果,確認是這個使用者就按標記的+
號。協作者註冊時提供的個人資訊越完整,越容易找到。
如果協作者沒有OSF帳號,會出現如下圖的提示訊息,可以點擊連結進入設定頁面。
未註冊協作者的設定頁面只要輸入全名與電子郵件信箱,之後這位協作者只要在註冊頁面輸入這些資訊,就能快速完成帳戶創建,並在專案儀表板看到這項專案。
確定要加入協作者會變成如下圖的畫面。管理者可在此設定協作者權限,包括是否列名。設定完成按Add
繼續。
如果是從專案主頁面增加協作者,而且專案之下還有物件,上圖畫面會變成如下圖的提示按鈕:
接著從以下畫面,設定是否要讓協作者在每個物件裡有與專案主頁面相同的權限:
增加完成回到協作者設定頁面,管理者隨時可在此更改設定,以及移除協作者。
由專案物件頁面設定協作者權限
與專案主頁面一樣,按一下下圖標記處進入協作者設定頁面:
在協作者設定頁面按下如下圖的Add
按鈕,就可以增加已註冊或未註冊的協作者,步驟與專案的操作相同。
確認加入協作者之前,也可以調整管理與列名權限。
物件的協作者設定頁面也可以隨時調整每位協作者權限。
移除協作者專案管理權限
如果要將某依協作者從專案或物件中移除,從協作者設定頁面,按下要移除的協作者右邊的X
即可。
確認要移除該位協作者,在下圖的提示視窗按下Remove
。如果是在專案主頁面進行這項操作,還可以選擇是否一併移除物件的管理權限。管理者權限也可以使用這種功能在協作者之間交接。
專案協作項目
一起進行研究計畫的團隊人員要經常分析的資訊有資料檔案,執行紀錄與報告等。資料媒介因研究性質而異。OSF提供可協作維護的Wiki與檔案系統,讓協作者根據實際需要設定與增修內容。
Wiki
OSF wiki是一套線上動態文件編輯與展示功能,使用者只要運用Markdown與MathJax兩套語法編輯文件內容,就可以在網頁展示頁看到編輯結果。希望運用動態文件紀錄研究過程與編輯報告元素的使用者,我建議花些時間去學習Markdown與MathJax。
要檢視一份Wiki的完整畫面,從如下圖畫面標記的兩個地方任何一處,點擊即可開啟全視窗畫面。
Wiki全視窗畫面如下圖,有編輯權限的使用者能在此看到各種與Wiki有關的功能。每個OSF專案與物件預設必有一個名為Home的Wiki文件,如果用者需要增加其他Wiki文件,按一下下圖箭頭指示的New:
接著會出現如下圖的對話視窗,請使用者輸入新Wiki文件的名稱,輸入完成按Add
。
今天增加的Wiki文件叫做“Daily Lab Notes”,新增成功會變成以下畫面。中間是預覽視窗,最右邊是編輯視窗。
Wiki編輯視窗輸入的內容馬上可在預覽視窗看到結果,以下畫面有Markdown與MathJax的編輯與預覽結果。更多編輯技巧請參考官網說明。
OSF Wiki編輯支援多人協作編輯,以及隨編隨存,使用者不必打幾個字就存一次檔。建議使用者設定編輯目標,達成才存檔。每存一次就會在預覽視窗最上方看到最近存檔時間,並且能與前次存檔比較版本差異,比較功能按下如下圖的Compare
即可開啟:
開啟後中間與右邊視窗可切換版本,比較不同版本內容差異。如果研究團隊約定每日更新研究紀錄,只要每日在Wiki記載指定事項,累積數日後可運用版本比較功能,檢視初期紀錄至今的內容變化。
如果日後專案要公開,團隊想把流水帳式的Wiki文字紀錄另外存檔。想要刪除原始Wiki文件,只要從全螢幕畫面選擇要刪除的Wiki,然後點擊如下圖的Delete
按鈕:
確認要刪除請按下如下圖視窗中的Delete
。
檔案(Files)
如果使用者能接受專案是資料夾,就不難理解OSF專案與物件的檔案管理,與個人電腦作業系統無太大差異。除此之外還要知道的是檔案的版本控制(Version Control),這是運用OSF做專案備份的基本須知。
只要按一下下圖的區域,就可切換到全視窗的檔案檢視畫面。
如果是在專案主頁面切換至此,會見到專案之下物件的檔案儲存節點。下圖畫面中每個OSF Storage
是上傳檔案到專案與物件的連結,需要備份的檔案,請在備份前規劃好要保存在專案與物件之中的檔案清單。
上傳檔案之前,先選好要存放的OSF Storage
,點選後會出現如下圖的功能清單。按下Upload會出現檔案選擇清單,請選擇要從你的硬碟上傳的檔案,一次不限一個。
上傳成功就會如下圖,在檔案清單看到剛剛選擇的檔案。
如果上傳的檔案是Word、試算表、簡報等文件檔,以及常見格式的圖片檔案,可以從OSF網頁檢視內容。只要選擇要檢視的檔案,然後點擊兩下。
就可以開啟檢視畫面,如pdf檔可切換成全螢幕檢視或列印。
如果使用者要增加檔案資料夾,在檔案檢視畫面功能選單有Create Folder
按鈕。選好要增加的資料夾的OSF Storage
,再按按鈕。
按下後會出現如下圖的對話框,輸入使用者設定的資料夾名稱。
現在有許多支援遠端協同作業的個人雲端服務,運用OSF的附加功能(Add-on),使用者能把在雲端服務編輯的檔案,轉移到OSF專案備份。使用者可自行查詢OSF支援的雲端服務,以下用Google雲端為例示範。
首先從專案主頁面的下圖標記處,開啟附加功能設定頁面。
從設定頁面選擇要附加的雲端服務,點一下Enable開啟功能。
以下畫面是雲端服務附加事項說明,確認要使用就按箭頭標示處。
回到設定畫面會出現如下圖的欄位,再按箭頭指示的連結,正式連結OSF與個人Google雲端。
Google雲端通常也有很多資料夾,可在以下畫面選擇要附加到這個OSF專案的資料夾。
成功的話回到OSF專案檔案檢視畫面,會看到除了OSF Storage
,還多了Google Drive
。
如果使用者要將個人雲端的檔案或資料夾移動到OSF專案,請參考下面GIF動畫。
OSF檔案檢視頁面的功能選單有壓縮下載功能Download as zip
,選擇要下載檔案的資料夾,再按這個按鈕,就會下載zip壓縮檔。這個功能適用大量資料檔備份於OSF,分析前要一次下載的狀況。
OSF最重要的檔案版本控制是使用者必知的功能,善用此功能可減少產生重覆檔案。下圖的檔案檢視畫面有個R程式碼檔案,版本(Version)這一欄顯示3,表示使用者已做了三次編輯,每次編輯後都上傳到這個OSF專案。
如果再更新一次並上傳,OSF就會判定為第4版。從檔案內容檢視畫面,使用者可以使用畫面上方功能選單裡的Revisions
,檢視檔案版本更新歷程。
按下Revisions
就出現如下圖的畫面,如果使用者有需要找出之前曾修改的內容,可以下載想看的版本。由此可知OSF對每一份檔案的每一次更新,都有保留備份。
如果使用者想防止檔案進一步更改,可以使用檔案檢視畫面的Check out file
功能。
確定Check out,OSF不會接受這份檔案的更新上傳。
要解除禁止更改,只要使用Check in file
這項功能。
專案註冊程序
OSF最為人熟知的功能是提供各式預先註冊的服務,也就是加上時間標章與研究者註解的檔案備份服務。前面的檔案功能已知OSF會備份使用者上傳檔案的每一份更新,如果這份檔案是要做預先註冊或已通過註冊報告第一階段評審的計畫書,OSF提供的註冊(Registration),實際操作就是使用者要選擇合適的備份註解加上檔案快照服務。手上正有研究計畫的讀者,如果不清楚要使用那一種備份註解,或者說較合適的預先註冊範本,請看我的演講投影片:預先註冊範本建議
同時建議參考這段演講錄影,歡迎讀者於這篇文章留言,討論實際操作的任何疑問與心得:
註冊實作1:由專案主頁面進行
這種方式適用預先註冊,例如實驗團隊以自我要求執行研究計畫,OSF備份資料可做投稿附件;各式研究方法的教學專案;參與跨實驗室合作案的個別單位;自行測試註冊內容。
從以下畫面箭頭所指的Registration開始,只要使用者按下,就會切換到註冊紀錄畫面。
準備第一次註冊的註冊紀錄畫面,按下New registration
就可以開始填寫註冊程序。如果這個專案有註冊程序尚未完成,可切換到Draft Registrations檢視,看是否要繼續完成。
註冊程序第一步,選擇合適的範本。確定了就按Create draft
。
每個範本都有需要填寫的註解資訊,下圖是最簡單的Open-Ended Registration,只要在欄位中寫下說明即可。如果這次編輯使用者還未寫完或需要修改,需要中途離開的話請按Save draft
,下次再從Draft Registrations頁面繼續編輯。如果已寫完該留資訊,就按Preview for submission
,預覽程序完成後,會看到的檔案備份註解資訊。
檔案備份註解資訊預覽畫面。如果覺得不滿意,可按Continue editing
返回上一個頁面編輯。如果滿意,按Register
準備完成註冊程序。
正式完成註冊程序前,OSF問你要將備份的專案立刻公開,還是設定預定公開日期(embargo)。如果是立即,按下Submit
後,這份專案備份完成後,立刻在OSF完整公開。
如果是設定預定公開日期,OSF會設定備份的專案在公開日期之前,隱私設定為不公開。直到公開日期才會調整為公開。
以下畫面是註冊程序完成後,備份專案的主頁面。按View Registration Form
會看到註冊程序中寫的備份註解,其中的wiki,檔案任何人都不能更動或刪除。使用者可以繼續更新原來的專案。
註冊實作2:OSF RR專頁
這種方式適用註冊報告,就是正在準備或已經投稿註冊報告期刊之計畫書及論文,特別是已獲得期刊接受的第一階段計畫書,使用者可以由RR專頁創建專案與完成註冊程序。
RR專頁的立意是提供研究者與期刊編輯評審,在公開平台檢視通過第一階段評審的計畫書,研究者按照計畫執行的實際達成度,因此以下畫面中的箭頭是從第二階段指向創建專案的按鈕。
如果研究者的計畫在投稿第一階段評審之前,研究材料與分析程序已經準備到位,建議就以此專頁創建專案。按下書面左邊大按鈕,即出現輸入專案標題的對話框,再按下Create
,就完成空白專案創建。
接著會進入計畫及專案註解頁面,這套註冊程序的步驟比從專案主頁面啟動來得多。建議先存為草稿,到專案頁面編輯wiki與上傳必要檔案,如計畫書與最後論文等。未完成的註冊程序,隨時可由RR專頁,按下中間的大按鈕,回來繼續註冊程序。
到了完成填寫註解之前,研究者同樣可以預覽或儲存草稿,離開一陣子再回來繼續。
確認完成註冊程序的預覽畫面,確定完成就按Register
。
同樣可以設定立刻公開,或者設定預定公開日期。這個情況可以預估收到期刊回覆的時間。
註冊報告的備份專案,基本上與預先註冊的備份沒什麼差別,差異在於完成註冊程序的準備與經歷。
!登入個人github帳號就能留言!