analyser_hj3415 3.2.1__py3-none-any.whl → 3.3.0__py3-none-any.whl

analyser_hj3415/analyser/eval/growth.py

@@ -1,5 +1,5 @@
 import os
-from dataclasses import dataclass, asdict
+from dataclasses import dataclass
 
 from utils_hj3415 import tools, setup_logger
 from db_hj3415 import myredis
@@ -13,6 +13,21 @@ expire_time = tools.to_int(os.getenv('DEFAULT_EXPIRE_TIME_H', 48)) * 3600
 
 @dataclass()
 class GrowthData:
+    """
+    기업의 성장 데이터를 저장하는 데이터 클래스.
+
+    이 클래스는 기업의 성장 데이터를 관리하며, 매출액 증가율 및 영업이익률 데이터를 포함합니다.
+    또한, 평가 점수와 관련된 날짜 데이터를 관리합니다.
+
+    속성:
+        code (str): 기업의 종목 코드 (6자리 숫자 문자열).
+        name (str): 기업명.
+        매출액증가율_r (float): 최신 매출액 증가율.
+        매출액증가율_dict (dict): 매출액 증가율과 관련된 과거 데이터.
+        영업이익률_c106 (dict): c106 데이터를 기반으로 한 영업이익률 데이터.
+        score (list): 평가 점수.
+        date (list): 성장 데이터와 관련된 날짜 목록.
+    """
     code: str
     name: str
 
@@ -26,6 +41,19 @@ class GrowthData:
 
 
 class Growth:
+    """
+    기업의 성장 데이터를 계산하고 관리하는 클래스.
+
+    이 클래스는 기업의 매출액 증가율, 영업이익률 등과 같은 성장 지표를 계산하며,
+    Redis 캐시를 통해 데이터를 저장하고 재사용할 수 있도록 지원합니다.
+
+    속성:
+        c101 (myredis.C101): 기업 정보와 데이터를 가져오기 위한 객체.
+        c104 (myredis.C104): 매출액 증가율 데이터를 관리하기 위한 객체.
+        c106 (myredis.C106): 영업이익률 데이터를 관리하기 위한 객체.
+        name (str): 기업명.
+        _code (str): 기업 종목 코드.
+    """
     def __init__(self, code: str):
         assert tools.is_6digit(code), f'Invalid value : {code}'
         mylogger.debug(f"Growth : 종목코드 ({code})")
@@ -42,10 +70,27 @@ class Growth:
 
     @property
     def code(self) -> str:
+        """
+        현재 기업의 종목 코드를 반환합니다.
+
+        반환값:
+            str: 기업의 종목 코드 (6자리 숫자 문자열).
+        """
         return self._code
 
     @code.setter
     def code(self, code: str):
+        """
+        기업의 종목 코드를 변경합니다.
+
+        종목 코드 변경 시 관련된 데이터 객체(c101, c104, c106)의 코드도 함께 변경됩니다.
+
+        매개변수:
+            code (str): 변경할 종목 코드 (6자리 숫자 문자열).
+
+        예외:
+            AssertionError: 종목 코드가 6자리 숫자 문자열이 아닐 경우 발생.
+        """
         assert tools.is_6digit(code), f'Invalid value : {code}'
         mylogger.debug(f"Growth : 종목코드 변경({self.code} -> {code})")
 
@@ -60,6 +105,21 @@ class Growth:
         return [0,]
 
     def _generate_data(self, refresh=False) -> GrowthData:
+        """
+        성장 데이터를 계산하여 GrowthData 객체를 생성합니다.
+
+        이 함수는 매출액 증가율, 영업이익률 등의 데이터를 계산하고,
+        이를 GrowthData 객체로 정리하여 반환합니다.
+
+        매개변수:
+            refresh (bool, optional): 데이터를 새로고침할지 여부. 기본값은 False.
+
+        반환값:
+            GrowthData: 계산된 성장 데이터를 포함하는 객체.
+
+        예외:
+            ValueError: 날짜 데이터가 없을 경우 기본값으로 빈 날짜 리스트를 설정.
+        """
         self.c104.page = 'c104y'
         _, 매출액증가율_dict = self.c104.find('매출액증가율', remove_yoy=True, refresh=refresh)
 
@@ -95,9 +155,20 @@ class Growth:
 
     def get(self, refresh = False, verbose = True) -> GrowthData:
         """
-        GrowthData 형식의 데이터를 계산하여 리턴하고 레디스 캐시에 저장한다.
-        :param refresh:
-        :return:
+        GrowthData 객체를 Redis 캐시에서 가져오거나 새로 생성하여 반환합니다.
+
+        캐시에서 데이터를 검색하고, 없을 경우 `_generate_data`를 호출하여 데이터를 생성합니다.
+        생성된 데이터는 Redis 캐시에 저장되어 재사용됩니다.
+
+        매개변수:
+            refresh (bool, optional): 캐시 데이터를 무시하고 새로 계산할지 여부. 기본값은 False.
+            verbose (bool, optional): 실행 중 상세 정보를 출력할지 여부. 기본값은 True.
+
+        반환값:
+            GrowthData: Redis 캐시에서 가져오거나 새로 생성된 GrowthData 객체.
+
+        로그:
+            - 캐시 검색 상태와 새로 생성된 데이터를 출력합니다.
         """
         redis_name = f"{self.code}_growth"
         mylogger.info(f"{self} GrowthData를 레디스캐시에서 가져오거나 새로 생성합니다.. refresh : {refresh}")
@@ -105,6 +176,6 @@ class Growth:
             print(f"{self} redisname: '{redis_name}' / refresh : {refresh} / expire_time : {expire_time/3600}h")
 
         def fetch_generate_data(refresh_in: bool) -> dict:
-            return asdict(self._generate_data(refresh_in))
+            return self._generate_data(refresh_in) # type: ignore
 
-        return GrowthData(**myredis.Base.fetch_and_cache_data(redis_name, refresh, fetch_generate_data, refresh, timer=expire_time))
+        return myredis.Base.fetch_and_cache_data(redis_name, refresh, fetch_generate_data, refresh, timer=expire_time)

analyser_hj3415/analyser/eval/mil.py

@@ -1,5 +1,5 @@
 import os
-from dataclasses import dataclass, asdict
+from dataclasses import dataclass
 from typing import Tuple
 import math
 
@@ -15,6 +15,32 @@ expire_time = tools.to_int(os.getenv('DEFAULT_EXPIRE_TIME_H', 48)) * 3600
 
 @dataclass
 class MilData:
+    """
+    기업의 주요 재무 데이터를 나타내는 데이터 클래스.
+
+    이 클래스는 기업의 다양한 재무 데이터를 포함하며,
+    이를 통해 투자 수익률, 가치 지표, 현금 흐름 등을 분석할 수 있습니다.
+
+    속성:
+        code (str): 기업의 종목 코드 (6자리 숫자 문자열).
+        name (str): 기업명.
+        시가총액억 (float): 기업의 시가총액 (억 단위).
+        주주수익률 (float): 재무활동 현금흐름을 기반으로 계산된 주주 수익률.
+        재무활동현금흐름 (float): 재무활동으로 인한 현금흐름.
+        이익지표 (float): 기업의 이익지표.
+        영업활동현금흐름 (float): 영업활동으로 인한 현금흐름.
+        지배주주당기순이익 (float): 지배주주에게 귀속된 당기순이익.
+        roic_r (float): ROIC(투하자본이익률).
+        roic_dict (dict): ROIC와 관련된 데이터.
+        roe_r (float): ROE(자기자본이익률).
+        roe_106 (dict): ROE와 관련된 상세 데이터.
+        roa_r (float): ROA(총자산이익률).
+        fcf_dict (dict): FCF(자유 현금 흐름) 관련 데이터.
+        pfcf_dict (dict): PFCF(주가 대비 자유 현금 흐름 비율) 관련 데이터.
+        pcr_dict (dict): PCR(주가 대비 현금 흐름 비율) 관련 데이터.
+        score (list): 계산된 평가 점수.
+        date (list): 재무 데이터와 관련된 날짜 목록.
+    """
     code: str
     name: str
 
@@ -44,6 +70,21 @@ class MilData:
 
 
 class Mil:
+    """
+    기업의 재무 데이터를 분석하고 계산하는 클래스.
+
+    이 클래스는 주어진 종목 코드에 대해 다양한 재무 데이터를 수집하고,
+    이를 기반으로 주요 재무 지표(예: ROIC, ROE, 이익지표 등)를 계산합니다.
+    또한 Redis 캐시를 활용하여 계산된 데이터를 저장하고 재사용할 수 있습니다.
+
+    속성:
+        c101 (myredis.C101): 기업 정보 및 최근 데이터 접근 객체.
+        c103 (myredis.C103): 재무 상태표 데이터 접근 객체.
+        c104 (myredis.C104): 투자 지표 데이터 접근 객체.
+        c106 (myredis.C106): ROE 관련 데이터 접근 객체.
+        name (str): 기업명.
+        _code (str): 기업 종목 코드.
+    """
     def __init__(self, code: str):
         assert tools.is_6digit(code), f'Invalid value : {code}'
         mylogger.debug(f"Mil : 종목코드 ({code})")
@@ -78,8 +119,16 @@ class Mil:
 
     def get_marketcap억(self, refresh: bool) -> float:
         """
-        시가총액(억원) 반환
-        :return:
+        기업의 시가총액(억 단위)을 반환합니다.
+
+        매개변수:
+            refresh (bool): 데이터를 새로고침할지 여부.
+
+        반환값:
+            float: 기업의 시가총액 (억 단위).
+
+        로그:
+            - 계산된 시가총액 정보를 출력합니다.
         """
         c101r = self.c101.get_recent(refresh)
         시가총액 = tools.to_int(tools.to_float(c101r.get('시가총액', math.nan)) / 100000000)
@@ -87,6 +136,19 @@ class Mil:
         return 시가총액
 
     def _calc주주수익률(self, 시가총액_억: float, refresh: bool) -> Tuple[str, float, float]:
+        """
+        주주수익률을 계산합니다.
+
+        매개변수:
+            시가총액_억 (float): 기업의 시가총액 (억 단위).
+            refresh (bool): 데이터를 새로고침할지 여부.
+
+        반환값:
+            Tuple[str, float, float]: 최근 날짜, 주주수익률, 재무활동 현금흐름.
+
+        예외:
+            ZeroDivisionError: 시가총액이 0일 경우 주주수익률을 계산하지 못합니다.
+        """
         self.c103.page = 'c103현금흐름표q'
         d, 재무활동현금흐름 = self.c103.sum_recent_4q('재무활동으로인한현금흐름', refresh)
         try:
@@ -97,6 +159,19 @@ class Mil:
         return d, 주주수익률, 재무활동현금흐름
 
     def _calc이익지표(self, 시가총액_억: float, refresh: bool) -> Tuple[str, float, float, float]:
+        """
+        이익지표를 계산합니다.
+
+        매개변수:
+            시가총액_억 (float): 기업의 시가총액 (억 단위).
+            refresh (bool): 데이터를 새로고침할지 여부.
+
+        반환값:
+            Tuple[str, float, float, float]: 최근 날짜, 이익지표, 영업활동 현금흐름, 지배주주 당기순이익.
+
+        예외:
+            ZeroDivisionError: 시가총액이 0일 경우 이익지표를 계산하지 못합니다.
+        """
         d1, 지배주주당기순이익 = Tools.calc당기순이익(self.c103, refresh)
         self.c103.page = 'c103현금흐름표q'
         d2, 영업활동현금흐름 = self.c103.sum_recent_4q('영업활동으로인한현금흐름', refresh)
@@ -113,6 +188,15 @@ class Mil:
         return date , 이익지표, 영업활동현금흐름, 지배주주당기순이익
 
     def _calc투자수익률(self, refresh: bool) -> tuple:
+        """
+        ROIC, ROE, ROA 등의 투자 수익률을 계산합니다.
+
+        매개변수:
+            refresh (bool): 데이터를 새로고침할지 여부.
+
+        반환값:
+            tuple: 계산된 ROIC, ROE, ROA 및 관련 데이터.
+        """
         self.c104.page = 'c104q'
         self.c106.page = 'c106q'
         d1, roic_r = self.c104.sum_recent_4q('ROIC', refresh)
@@ -131,13 +215,16 @@ class Mil:
 
     def _calcFCF(self, refresh: bool) -> dict:
         """
-        FCF 계산
-        Returns:
-            dict: 계산된 fcf 딕셔너리 또는 영업현금흐름 없는 경우 - {}
+        자유 현금 흐름(FCF)을 계산합니다.
+
+        매개변수:
+            refresh (bool): 데이터를 새로고침할지 여부.
 
-        Note:
-            CAPEX 가 없는 업종은 영업활동현금흐름을 그대로 사용한다.\n
+        반환값:
+            dict: 계산된 FCF 딕셔너리. 영업활동 현금흐름 데이터가 없는 경우 빈 딕셔너리를 반환합니다.
 
+        참고:
+            - CAPEX가 없는 업종의 경우, 영업활동 현금흐름을 그대로 사용합니다.
         """
         self.c103.page = 'c103현금흐름표y'
         _, 영업활동현금흐름_dict = self.c103.find('영업활동으로인한현금흐름', remove_yoy=True, del_unnamed_key=True, refresh=refresh)
@@ -172,13 +259,16 @@ class Mil:
         return dict(sorted(fcf_dict.items(), reverse=False))
 
     def _calcPFCF(self, 시가총액_억: float, fcf_dict: dict) -> dict:
-        """Price to Free Cash Flow Ratio(주가 대비 자유 현금 흐름 비율)계산
+        """
+        PFCF(Price to Free Cash Flow Ratio)를 계산합니다.
 
-            PFCF = 시가총액 / FCF
+        매개변수:
+            시가총액_억 (float): 기업의 시가총액 (억 단위).
+            fcf_dict (dict): 자유 현금 흐름(FCF) 데이터.
 
-            Note:
-                https://www.investopedia.com/terms/p/pricetofreecashflow.asp
-            """
+        반환값:
+            dict: 계산된 PFCF 딕셔너리.
+        """
         if math.isnan(시가총액_억):
             mylogger.warning(f"{self} - 시가총액이 nan으로 pFCF를 계산할수 없습니다.")
             return {}
@@ -259,9 +349,20 @@ class Mil:
 
     def get(self, refresh = False, verbose = True) -> MilData:
         """
-        MilData 형식의 데이터를 계산하여 리턴하고 레디스 캐시에 저장한다.
-        :param refresh:
-        :return:
+        MilData 객체를 Redis 캐시에서 가져오거나 새로 생성하여 반환합니다.
+
+        캐시에서 데이터를 검색하고, 없을 경우 `_generate_data`를 호출하여 데이터를 생성합니다.
+        생성된 데이터는 Redis 캐시에 저장되어 재사용됩니다.
+
+        매개변수:
+            refresh (bool): 캐시를 무시하고 새로 데이터를 계산할지 여부. 기본값은 False.
+            verbose (bool): 실행 중 상세 정보를 출력할지 여부. 기본값은 True.
+
+        반환값:
+            MilData: Redis 캐시에서 가져오거나 새로 생성된 MilData 객체.
+
+        로그:
+            - 캐시 검색 상태와 새로 생성된 데이터를 출력합니다.
         """
         redis_name = f"{self.code}_mil"
         mylogger.info(f"{self} MilData를 레디스캐시에서 가져오거나 새로 생성합니다.. refresh : {refresh}")
@@ -269,6 +370,6 @@ class Mil:
             print(f"{self} redisname: '{redis_name}' / refresh : {refresh} / expire_time : {expire_time/3600}h")
 
         def fetch_generate_data(refresh_in: bool) -> dict:
-            return asdict(self._generate_data(refresh_in))
+            return self._generate_data(refresh_in) # type: ignore
 
-        return MilData(**myredis.Base.fetch_and_cache_data(redis_name, refresh, fetch_generate_data, refresh, timer=expire_time))
+        return myredis.Base.fetch_and_cache_data(redis_name, refresh, fetch_generate_data, refresh, timer=expire_time)

analyser_hj3415/analyser/eval/red.py

@@ -1,5 +1,5 @@
 import os
-from dataclasses import dataclass, asdict
+from dataclasses import dataclass
 from typing import Tuple
 import math
 
@@ -16,34 +16,31 @@ expire_time = tools.to_int(os.getenv('DEFAULT_EXPIRE_TIME_H', 48)) * 3600
 @dataclass
 class RedData:
     """
-    A data structure for financial data representation and calculations.
-
-    This class is designed to encapsulate financial details related to a company,
-    including calculations for business value, property value, debt evaluation, and
-    associated metrics. It validates specific attributes upon initialization and is
-    useful for financial data analysis.
-
-    Attributes:
-        code (str): A 6-digit numeric string representing the company or entity's code.
-        name (str): The name of the company or entity.
-        사업가치 (float): Business value calculated as net income attributable to controlling
-            shareholders divided by expected return rate.
-        지배주주당기순이익 (float): Net income attributable to controlling shareholders.
-        expect_earn (float): Expected return rate.
-        재산가치 (float): Property value calculated as current assets minus 1.2
-            times current liabilities, plus fixed assets under investment properties.
-        유동자산 (float): Current assets of the company.
-        유동부채 (float): Current liabilities of the company.
-        투자자산 (float): Investment assets within fixed assets.
-        투자부동산 (float): Investment real estate property.
-        부채평가 (float): Debt evaluation, specifically focusing on non-current liabilities.
-        발행주식수 (int): Number of issued shares by the company.
-        date (list): List of dates relevant to the financial data.
-        red_price (float): Red price associated with the company or entity.
-        score (int): Score or rating given to the company or entity.
-
-    Raises:
-        ValueError: If the 'code' attribute is not a 6-digit numeric string.
+    재무 데이터를 표현하고 계산하기 위한 데이터 구조.
+
+    이 클래스는 기업의 재무 데이터를 관리하며, 사업가치, 재산가치, 부채평가 등 다양한 재무
+    지표를 포함합니다. 초기화 시 특정 속성 값을 검증하며, 재무 데이터 분석에 유용하게 활용됩니다.
+
+    속성:
+        code (str): 기업의 6자리 숫자 코드.
+        name (str): 기업명.
+        사업가치 (float): 지배주주 당기순이익 / 기대수익률로 계산된 사업가치.
+        지배주주당기순이익 (float): 지배주주에게 귀속된 당기순이익.
+        expect_earn (float): 기대수익률.
+        재산가치 (float): 유동자산 - (유동부채 * 1.2) + 고정자산(투자자산, 투자부동산)으로 계산된 재산가치.
+        유동자산 (float): 기업의 유동자산.
+        유동부채 (float): 기업의 유동부채.
+        투자자산 (float): 투자자산.
+        투자부동산 (float): 투자부동산.
+        부채평가 (float): 비유동부채를 평가한 값.
+        발행주식수 (int): 발행된 주식 수.
+        date (list): 재무 데이터와 관련된 날짜 목록.
+        주가 (float): 최근 주가.
+        red_price (float): 계산된 레드 가격.
+        score (int): 최근 주가와 레드 가격 간 괴리율로 산출된 점수.
+
+    예외:
+        ValueError: 'code'가 6자리 숫자 문자열이 아닌 경우 발생.
     """
     code: str
     name: str
@@ -78,17 +75,18 @@ class RedData:
 
 class Red:
     """
-    Represents a financial analysis object with methods to calculate metrics
-    and gather data related to a specific code.
-
-    The Red class is designed to interact with specific data sources and provide
-    tools for financial calculations and analysis. This includes fetching and
-    processing information related to liabilities, assets, stock prices, and
-    other financial indicators. The class facilitates both specific calculations
-    such as 비유동부채(Non-current Liability) and the generation of comprehensive
-    financial datasets.
-    """
+    특정 기업의 재무 데이터를 계산하고 분석하기 위한 클래스.
+
+    이 클래스는 주어진 종목 코드에 대해 데이터를 가져오고, 사업가치, 재산가치, 부채평가 등 다양한
+    재무 지표를 계산하며, Redis 캐시를 활용하여 데이터 저장 및 재사용을 관리합니다.
 
+    속성:
+        c101 (myredis.C101): 기업 정보 및 데이터 접근을 위한 객체.
+        c103 (myredis.C103): 재무 상태표 데이터 접근을 위한 객체.
+        name (str): 기업명.
+        recent_price (float): 최근 주가.
+        expect_earn (float): 기대수익률. 기본값은 0.06 (6%).
+    """
 
     def __init__(self, code: str, expect_earn: float = 0.06):
         assert tools.is_6digit(code), f'Invalid value : {code}'
@@ -121,10 +119,23 @@ class Red:
         self._code = code
 
     def _calc비유동부채(self, refresh: bool) -> Tuple[str, float]:
-        """유효한 비유동부채 계산
+        """
+        비유동부채를 계산합니다.
+
+        기본적으로 재무 상태표에서 비유동부채 데이터를 가져오며, 만약 데이터가 누락되었거나 NaN인 경우
+        직접 계산하여 반환합니다.
+
+        매개변수:
+            refresh (bool): 데이터 새로고침 여부. True일 경우 최신 데이터를 가져옵니다.
 
-        일반적인 경우로 비유동부채를 찾아서 반환한다.\n
-        금융기관의 경우는 간접적으로 계산한다.\n
+        반환값:
+            Tuple[str, float]: 가장 최근 날짜와 계산된 비유동부채 값.
+
+        예외:
+            ValueError: 필요한 데이터가 누락된 경우 발생.
+
+        로그:
+            - 비유동부채 데이터가 없을 경우 경고 메시지를 출력합니다.
         """
         mylogger.info(f'In the calc비유동부채... refresh : {refresh}')
         self.c103.page = 'c103재무상태표q'
@@ -154,11 +165,18 @@ class Red:
             return d, 비유동부채
 
     def _score(self, red_price: int) -> int:
-        """red price와 최근 주가의 괴리율 파악
+        """
+        최근 주가와 레드 가격 간 괴리율을 계산하여 점수를 반환합니다.
+
+        매개변수:
+            red_price (int): 계산된 레드 가격.
+
+        반환값:
+            int: 괴리율 기반 점수. 양수는 저평가, 음수는 과대평가를 나타냅니다.
 
-            Returns:
-                int : 주가와 red price 비교한 괴리율
-            """
+        로그:
+            - 최근 주가와 레드 가격, 괴리율, 계산된 점수를 출력합니다.
+        """
         if math.isnan(self.recent_price):
             return 0
 
@@ -174,6 +192,24 @@ class Red:
         return score
 
     def _generate_data(self, refresh: bool) -> RedData:
+        """
+        RedData 객체를 생성하기 위해 재무 데이터를 계산합니다.
+
+        내부적으로 사업가치, 재산가치, 비유동부채 등을 계산하며, 계산된 결과를 RedData 객체로 반환합니다.
+
+        매개변수:
+            refresh (bool): 데이터 새로고침 여부. True일 경우 최신 데이터를 가져옵니다.
+
+        반환값:
+            RedData: 계산된 재무 데이터를 포함하는 RedData 객체.
+
+        예외:
+            ZeroDivisionError: 발행 주식 수가 0인 경우 발생.
+            ValueError: 필요한 날짜 데이터가 없는 경우 발생.
+
+        로그:
+            - 각 단계의 계산 결과와 주요 값을 출력합니다.
+        """
         d1, 지배주주당기순이익 = Tools.calc당기순이익(self.c103, refresh)
         mylogger.debug(f"{self} 지배주주당기순이익: {지배주주당기순이익}")
         d2, 유동자산 = Tools.calc유동자산(self.c103, refresh)
@@ -230,35 +266,28 @@ class Red:
 
     def get(self, refresh = False, verbose = True) -> RedData:
         """
-        RedData 형식의 데이터를 계산하여 리턴하고 레디스 캐시에 저장한다.
-
-        redis_name = f"{self.code}_red_data"
-
-        Fetch or create RedData from Redis cache.
+        RedData 객체를 Redis 캐시에서 가져오거나, 새로 계산하여 반환합니다.
 
-        This function attempts to retrieve the RedData from a Redis cache. If the data is
-        not available or if a refresh is requested, it generates new data and caches
-        them back in Redis. The function logs its operations and can provide
-        verbose output when specified.
+        캐시에서 데이터를 검색하고, 없을 경우 `_generate_data`를 호출하여 새로운 데이터를 생성한 후,
+        캐시에 저장합니다.
 
-        Parameters:
-        refresh : bool, optional
-            Whether to refresh and generate new data instead of using the cached data.
-        verbose : bool, optional
-            Whether to enable verbose logging/display of additional runtime information.
+        매개변수:
+            refresh (bool, optional): 캐시 데이터를 무시하고 새로 계산 여부. 기본값은 False.
+            verbose (bool, optional): 실행 중 상세 정보를 출력 여부. 기본값은 True.
 
-        Returns:
-        RedData
-            The RedData object either retrieved from the cache or newly generated.
+        반환값:
+            RedData: Redis 캐시에서 가져오거나 새로 생성된 RedData 객체.
 
+        로그:
+            - 캐시 검색 상태와 새로 계산된 데이터를 출력합니다.
         """
         redis_name = f"{self.code}_red_data"
         mylogger.info(f"{self} RedData를 레디스캐시에서 가져오거나 새로 생성합니다.. refresh : {refresh}")
         if verbose:
             print(f"{self} redisname: '{redis_name}' / expect_earn: {self.expect_earn} / refresh : {refresh} / expire_time : {expire_time/3600}h")
 
-        def fetch_generate_data(refresh_in: bool) -> dict:
-            return asdict(self._generate_data(refresh_in))
+        def fetch_generate_data(refresh_in: bool) -> RedData:
+            return self._generate_data(refresh_in) # type: ignore
 
-        return RedData(**myredis.Base.fetch_and_cache_data(redis_name, refresh, fetch_generate_data, refresh, timer=expire_time))
+        return myredis.Base.fetch_and_cache_data(redis_name, refresh, fetch_generate_data, refresh, timer=expire_time)
 

analyser_hj3415/analyser/tsa/__init__.py

@@ -1,15 +1,3 @@
 from analyser_hj3415.analyser.tsa.lstm import *
 from analyser_hj3415.analyser.tsa.prophet import *
-
-MIs = {
-        "wti": "CL=F",
-        "gold": "GC=F",
-        "silver": "SI=F",
-        "usdidx": "DX-Y.NYB",
-        "usdkrw": "KRW=X",
-        "sp500": "^GSPC",
-        "kospi": "^KS11",
-        "nikkei": "^N225",
-        "china": "^HSI",
-        "irx": "^IRX",
-    }
+from analyser_hj3415.analyser.tsa import common

analyser_hj3415/analyser/tsa/common.py

@@ -0,0 +1,33 @@
+import numpy as np
+
+
+def is_up_by_OLS(data: dict) -> bool:
+    if not data:
+        # 데이터가 비어있으면 추세를 판단할 수 없음
+        return False
+
+    # 1) 날짜(키) 기준 오름차순 정렬
+    sorted_dates = sorted(data.keys())
+    values = [data[d] for d in sorted_dates]
+
+    # 2) x 축을 0,1,2... 형태로 부여 (날짜 간격을 동일하게 가정)
+    x = np.arange(len(values), dtype=float)
+    y = np.array(values, dtype=float)
+
+    # 3) 선형 회귀(최소제곱법)로 기울기(slope) 계산
+    x_mean = np.mean(x)
+    y_mean = np.mean(y)
+
+    # 분자: sum((xi - x_mean) * (yi - y_mean))
+    numerator = np.sum((x - x_mean) * (y - y_mean))
+    # 분모: sum((xi - x_mean)^2)
+    denominator = np.sum((x - x_mean) ** 2)
+
+    if denominator == 0:
+        # 데이터가 1개 이하인 경우 등
+        return False
+
+    slope = numerator / denominator
+
+    # 4) 기울기가 양수면 "우상향 추세"로 판별
+    return slope > 0