Files
Bithumb/scripts/02_ground_truth_futures.py
dsyoon 2dedfae82d feat: 현물 GT 기반 선물 Ground Truth 차트 v1~v3 추가
현물 GT 타점을 롱·숏 4색 마커(상·하방 매수·매도)로 변환해 futures HTML 차트를 생성한다.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-09 19:06:08 +09:00

111 lines
3.7 KiB
Python

#!/usr/bin/env python3
"""선물 Ground Truth 차트 — 현물 GT 타점을 롱·숏 4색 마커로 시각화."""
from __future__ import annotations
import argparse
import json
import logging
import sys
from pathlib import Path
from typing import Any
ROOT = Path(__file__).resolve().parents[1]
SRC = ROOT / "src"
if str(SRC) not in sys.path:
sys.path.insert(0, str(SRC))
from deepcoin.config import Settings, load_settings
from deepcoin.ground_truth.futures_chart import render_futures_ground_truth_chart
TIER_DESCRIPTIONS = {
"v1": "스윙만 (최소 매수·매도)",
"v2": "스윙 + 눌림목",
"v3": "스윙 + 눌림목 + 돌파 + 다이버전스",
}
def _configure_logging(verbose: bool) -> None:
"""로깅 레벨을 설정한다."""
level = logging.DEBUG if verbose else logging.INFO
logging.basicConfig(
level=level,
format="%(asctime)s [%(levelname)s] %(message)s",
datefmt="%Y-%m-%d %H:%M:%S",
)
def _tier_targets(settings: Settings, tier_arg: str) -> list[tuple[str, Path, Path]]:
"""생성할 티어 목록 (tier, spot_json_path, futures_chart_path)."""
all_tiers: dict[str, tuple[Path, Path]] = {
"v1": (settings.ground_truth_v1_file, settings.ground_truth_futures_chart_v1_file),
"v2": (settings.ground_truth_v2_file, settings.ground_truth_futures_chart_v2_file),
"v3": (settings.ground_truth_file, settings.ground_truth_futures_chart_v3_file),
}
if tier_arg == "all":
return [(t, *paths) for t, paths in all_tiers.items()]
return [(tier_arg, *all_tiers[tier_arg])]
def _load_gt(json_path: Path) -> dict[str, Any]:
"""현물 GT JSON을 로드한다."""
with json_path.open(encoding="utf-8") as fp:
return json.load(fp)
def _print_summary(tier: str, gt_result: dict[str, Any], chart_path: Path) -> None:
"""티어별 선물 차트 요약을 출력한다."""
meta = gt_result["meta"]
summary = gt_result["summary"]
print(f"\n=== 선물 GT 차트 {tier.upper()} ({TIER_DESCRIPTIONS[tier]}) ===")
print(f"대상: {meta['symbol']} ({meta['interval_label']})")
print(f"GT 기간: {meta['data_from']} ~ {meta['data_to']}")
print(
f"현물 GT 타점: 매수 {summary['buy_count']} / 매도 {summary['sell_count']} "
f"→ 선물 상방·하방 각 {summary['buy_count']}/{summary['sell_count']} 마커"
)
print(f"차트: {chart_path}")
def main() -> int:
"""CLI 진입점."""
parser = argparse.ArgumentParser(
description="현물 GT 기반 선물 Ground Truth 차트 (롱·숏 4색)"
)
parser.add_argument(
"--tier",
choices=("v1", "v2", "v3", "all"),
default="all",
help="대상 GT 버전",
)
parser.add_argument("-v", "--verbose", action="store_true")
args = parser.parse_args()
_configure_logging(args.verbose)
settings = load_settings()
tiers = _tier_targets(settings, args.tier)
print("\n=== 선물 Ground Truth 차트 생성 ===")
print("현물 GT 타점 → L↑상방매수 L↓상방매도 S↓하방매수 S↑하방매도")
for tier, json_path, chart_path in tiers:
if not json_path.exists():
logging.error("현물 GT JSON 없음: %s — 먼저 02_ground_truth.py 실행", json_path)
return 1
gt_result = _load_gt(json_path)
render_futures_ground_truth_chart(
db_path=settings.db_path,
symbol=settings.symbol,
gt_result=gt_result,
output_path=chart_path,
chart_lookback_days=settings.download_days,
)
_print_summary(tier, gt_result, chart_path)
return 0
if __name__ == "__main__":
raise SystemExit(main())