該Python應用目的在於解析「集中市場普通股競價交易即時行情資訊」的二進位資料,並根據動態的條件略過部分數據。使用者可以通過提供不同的情境條件,來控制哪些資料應該被處理或略過。
- 解析「集中市場普通股競價交易即時行情資訊」的原始二進位資料。
- 轉換資料為「即時交易資訊傳輸規格書說明」的格式。
- 支援自定義的情境條件,用以跳過或處理資料。
- 運行程式: 使用命令列運行主程式,傳入必要的參數。
python3 src/main.py <input_file> <output_file> --scenarios <scenarios>
參數說明:
- <input_file>: 要解析的原始檔案名稱,位於 data/raw 目錄。
- <output_file>: 解析後的 JSON 檔案名稱,將儲存至 data/processed 目錄。
- --scenarios: 用逗號分隔的情境條件列表(例如:“1:include,2:exclude,3:include”)。
- 情境條件(選填): 情境條件用於指定哪些資料應該被跳過。每個條件由情境和模式組成,由「:」分隔。情境是該註記的情境種類,模式包括 include(包含)或 exclude(排除)。
- 情境條件如果未填寫,表示對所有資料皆進行處理;如果填寫,則必須指定 3個位置的參數 (揭示項目註記, 漲跌停註記, 狀態註記)
- 每個參數接受兩種形式:
- 情境:模式。如,「1:include」,表示該註記要挑選出情境1的資料。
- 0。表示跳過該註記。
情境說明:
- 揭示項目註記
- 情境1:無成交價、成交量
- 情境2:有成交價、成交量
- 漲跌停註記
- 情境1:一般成交
- 情境2:跌停成交
- 情境3:漲停成交
- 狀態註記
- 情境1:一般揭示
- 情境2:試算揭示
- 處理所有資料: 假設有一個 f6_01000001_01001000_TP03.new 的原始資料,並希望將解析後的結果保存為 parsed_data.json:
python3 src/main.py f6_01000001_01001000_TP03.new parsed_data.json
- 使用情境條件: 假設有一個 f6_01000001_01001000_TP03.new 的原始資料,並希望將解析後的結果保存為 parsed_data_limitUp.json。其中,只要挑選出「漲停成交」的資料:
python3 src/main.py f6_01000001_01001000_TP03.new parsed_data_limitUp.json --scenarios 0,3:include,0