LS CRUDE
WTI 원유 선물과 이어질 수 있는 실물 활동 데이터를 찾아 기록하고, 쿠싱 활동 지수(Cushing Activity Index, CAI v0.1)를 만들어 예측에 보탬이 되는지 검정한 2인 팀 연구입니다.
CAI 대시보드 · 연구 기록 화면 · 연구 브리프 · 산식·자료·재현 · 종료 기록
요약
| 구분 | 내용 |
|---|
| 질문 | 쿠싱(미국 오클라호마) 인근의 실물 활동 흔적을 결합하면 다음 5거래일 WTI 상승 여부에 정보를 더할 수 있을까? |
| 데이터 | 물류·운영·소비 활동 후보를 카드로 기록했습니다. CAI 입력은 쿠싱 인근 도로의 일별 전체 차량 통행량(TMAS AVC040)과 South STP 월별 신고 방류유량(DMR) 2개입니다. 가격은 Yahoo Finance WTI 연속선물(CL=F)을 씁니다. |
| 방법 | 후보마다 가설·출처·접근 조건을 남기고 KEEP·PARK·KILL로 판정했습니다. CAI는 두 자료의 표준화 점수를 50:50으로 결합한 과거 자료 지수입니다. 예측 실험은 2015~2020년 학습(753행), 2023년 평가(245행)의 고정 시간 분할로 기준선 1개와 로지스틱 모델 5개를 비교했습니다. |
| 결과 | 후보 73건을 KEEP 7 · PARK 54 · KILL 12로 기록했습니다. CAI v0.1은 2023-12-29 기준 43.1/100입니다. 시장정보에 CAI를 더한 두 비교 모두 확률오차(log loss)가 줄지 않았습니다. 예측 개선은 없었고, 이 결과를 그대로 공개합니다. |
- 진행 순서: 1 아이디어 → 2 쿠싱 후보 → 3 수집 → 4 전처리 → 5 지수·학습·평가 → 6 결과·대시보드. CAI는 자료 폴더 106개에서 쿠싱 후보·보조자료 33개를 고르고, 준비된 입력 2개로 만들었습니다.
- 연구 원장 73건과 CAI 작업표 33개는 단위가 달라 합산하지 않습니다.
- CAI의 50은 두 자료가 기준 평균 수준일 때의 값입니다. 43.1은 과거 자료로 계산한 상대 점수이며, 가동률이나 유가 상승 확률과는 다른 값입니다.
- KEEP은 후속 연구 대상 배정입니다. 2024년 이후 구간은 최종 검증용으로 잠가 두었습니다.
팀과 역할
오태환(Noah) × 손성찬 · 2026-09-01~09-14
| 담당 | 맡은 일 |
|---|
| 오태환(Noah) | 데이터 수집·피처(research/src/ls_crude/data/, research/src/ls_crude/features/), 대시보드(app/), 기록·데모 |
| 손성찬 | 모델·백테스트(research/src/ls_crude/models/, research/src/ls_crude/backtest/), 검정·반증, 숙박세·사용세·공항 자료와 월별 실험 |
역할 배정 제안은 PM 계획에 있습니다(Noah 데이터·기록·데모, 성찬 검정·반증, 상호 검토). 두 사람은 2026-09-11에 역할을 수락했습니다. 코드 담당 범위는 CODEOWNERS에 있습니다.
실행 방법
명령은 저장소 루트 기준입니다.
- 후보 원장 검사(Python 표준 라이브러리만 사용)
python3 research/scripts/sync_candidate_ledger.py --check
- 연구 환경과 회귀 검사
cd research
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pip install -e .
python -m pytest tests/test_splits.py tests/test_wiki_pageviews_asof.py
- CAI v0.1 재현. 해시가 일치하는 입력 파일이 필요하며, 입력 확보는 공동 작업 안내를 따릅니다.
research/.venv/bin/python research/scripts/build_cai_v01.py --check
research/.venv/bin/python -m pytest research/tests/test_cai_v01.py -q
- 대시보드 앱(선택). 환경변수 없이 읽기 전용 스냅샷으로 실행합니다. Supabase 설정은 앱 안내에 있습니다.
cd app
npm ci
npm run dev -- --port 5173
python -m ls_crude.build와 market_snapshot은 네트워크 수집과 앱 산출물 변경을 포함하므로 점검 명령으로 쓰지 않습니다.- 인샘플 선택은 2015-01-01~2023-12-31에서만 합니다. 2024-01-01 이후 구간은 규칙을 동결한 뒤 한 번만 씁니다(검정 규약).
연구 기록
