프로젝트 소개

stockstats는 pandas 기반의 Python 라이브러리로, 주식 통계 및 기술적 지표를 계산합니다. 이 라이브러리의 StockDataFrame은 기존 pandas DataFrame을 감싸서, CSV나 yfinance와 같은 소스에서 OHLCV 데이터를 로드한 후 지표별 열 이름으로 접근할 수 있게 합니다. 지원되는 지표 그룹은 다음과 같습니다: 이동평균(SMA, EMA, SMMA, TEMA, KAMA, VWMA, DMA), 모멘텀(RSI, StochRSI, MACD, PPO, KDJ, ROC, CMO, KST, Coppock, AO, BOP, CTI, Inertia, PSL), 추세(Supertrend, Aroon, Ichimoku, DMI, TRIX, Wave Trend), 변동성(Bollinger Bands, ATR, TR, CCI, Williams %R, Choppiness Index, Z-Score, MAD), 거래량(VR, MFI, PVO, VWMA), 오실레이터(QQE, RVGI, Elder-Ray, Fisher Transform)입니다. 데이터 프레임은 일반적으로 대소문자 구분 없는 close, high, low, volume 열을 포함해야 하며, 선택적으로 date 열이 있을 수 있습니다. 데이터는 wrap 또는 StockDataFrame.retype으로 감싸고, unwrap으로 일반 DataFrame으로 되돌릴 수 있습니다. 지표는 close_20_sma, high_10_ema, rsi_6, atr, macd, boll과 같은 명명 패턴을 사용하여 첫 접근 시 계산됩니다. MACD나 Bollinger Bands 같은 다중 출력 지표는 신호선, 히스토그램 또는 밴드에 대한 관련 열을 생성합니다. 또한 이 라이브러리는 델타, 이동, 로그 수익률, 범위 통계, 순열, 상향/하향 교차 감지, 크거나 같음 임계값 비교와 같은 유틸리티 계산도 제공합니다. 단축 지표는 init_all로 함께 초기화할 수 있지만, 이 경우 많은 열이 생성됩니다. 기본 창과 일부 매개변수는 전역적으로 조정할 수 있으며, 캐시된 지표 열을 삭제하여 재계산을 강제할 수 있습니다. 설치는 pip install stockstats로 수행합니다. 이 프로젝트는 Python 3.9 이상이 필요하며 BSD-3-Clause 라이선스로 배포됩니다.