1 DeepLEX

• Base data
  • Preexisting data
• New data
  • COPENS
  • lexicoR
    • environment for querying and adding new entries to DeepLEX

2 lexicoR

2.1 目的

提供一個開發環境，讓使用者能以 (簡單的) coding 查詢、分析、新增(包含新變項與新詞條) DeepLEX 詞庫資訊 (new tabular data)

e.g. 提供新變項 (小孩使用頻率)：

2.2 問題

1. Workflow：使用者會如何使用 lexicoR？
   • 實驗心理語言

     • (查詢資料) > 選用刺激 > 實驗產生新資料 > 回饋新資料

     • 問題：資料的產生過程(e.g. 輸入資料)應不應該在 lexicoR 的環境內？

   • 計算語言
   • 社會語言
   • 歷史語言
   • 依據使用者可能的使用流程，訂定輸入 lexicoR 的資料格式
     • Expected data shape

     Unit	new data 1	new data 2
     term1	d11	d12
     term2	d21	d22
     term3	d31	d32

     • lexicoR 提供使用者分析(DeepLEX + new data)、貢獻資料

2. Documentation & Credit System

   • 問題：使用者新增變項後，如何提供變項說明 (documentation 機制)？

     • README 格式
       • 說明
       • 論文連結
       • 相關研究 GitHub repo
       • lexicoR 協助撰寫：免除學習 Markdown 語法的負擔，同時也固定格式
     • 透過 GitHub API 提出 pull request, README 內容上傳至 pull request commit message
   • Credit
     • GitHub account、ORCID

2.3 提供功能

1. query & analyze data
   • query data
   • merge & analyze DeepLEX data + user-provided data (local)
2. contribute data
   • Upload new data for DeepLEX
     • Abstractalize pull request? GitHub API wrapper
   • Interactive documentation writing
   • Incentive: Reports generated using DeepLEX + user-provided data
     • data, Rmd source, PDF, HTML > zip file during travis build

2.4 初步構想

• DataBase on server: R pull data from DB
• github
  • data repo
    • Host main data (.csv)
    • pull request to create user edited data (small .csv) and documentation
    • Travis CI to check compatability
      e.g. check whether: new variables are unique, important columns overwritten, duplicated rows, etc.
    • merge pull request to DeepLEX after review
• lexicoR funtions
  • Abstractalize GitHub API
  • Write data documentation (decide format)
  • import new data (dealing with noisy data, e.g. fancy excel) > R object (fits data format)
  • quick summary functions (analyze data)

  lexicoR	Action
  data_doc()	facilitate writing documention
  upload_data()	GitHub: fork + upload data & doc + pull request
  read_excel()	Helper to import (pick) data from .xlsx (match excel intuition)
  …	…

3 Resources

• R
  • R GiHub API wrapper
  • R GitHub Workflow example
  • readxl
• R Markdown
  • Parameterized Reports
• GitHub API
  • getting started
  • pull request API