hossam 0.3.20__py3-none-any.whl → 0.4.1__py3-none-any.whl

hossam/hs_stats.py

@@ -35,6 +35,8 @@ from statsmodels.stats.diagnostic import linear_reset, het_breuschpagan, het_whi
 from statsmodels.stats.outliers_influence import variance_inflation_factor
 from statsmodels.stats.multitest import multipletests
 from statsmodels.stats.stattools import durbin_watson
+from statsmodels.regression.linear_model import RegressionResultsWrapper
+from statsmodels.discrete.discrete_model import BinaryResults
 
 from pingouin import anova, pairwise_tukey, welch_anova, pairwise_gameshowell
 
@@ -58,21 +60,22 @@ def missing_values(data: DataFrame, *fields: str):
             - missing_rate (float): 전체 행에서 결측치의 비율(%)
 
     Examples:
-        전체 컬럼에 대한 결측치 확인:
-
-        >>> from hossam import missing_values
-        >>> import pandas as pd
-        >>> df = pd.DataFrame({'x': [1, 2, None, 4], 'y': [10, None, None, 40]})
-        >>> result = missing_values(df)
-        >>> print(result)
-
-        특정 컬럼만 분석:
-
-        >>> result = missing_values(df, 'x', 'y')
-        >>> print(result)
+        ```python
+        from hossam import *
+        from pandas import DataFrame
+
+        # 전체 컬럼에 대한 결측치 확인:
+        df = DataFrame({'x': [1, 2, None, 4], 'y': [10, None, None, 40]})
+        result = hs_stats.missing_values(df)
+        print(result)
+
+        # 특정 컬럼만 분석:
+        result = hs_stats.missing_values(df, 'x', 'y')
+        print(result)
+        ```
     """
     if not fields:
-        fields = data.columns
+        fields = tuple(data.columns)
 
     result = []
     for f in fields:
@@ -121,18 +124,20 @@ def outlier_table(data: DataFrame, *fields: str):
             - outlier_rate (float): 이상치 비율(%)
 
     Examples:
-        전체 숫자형 컬럼에 대한 이상치 경계 확인:
+        ```python
+        from hossam import *
+        from pandas import DataFrame
 
-        >>> from hossam import outlier_table
-        >>> import pandas as pd
-        >>> df = pd.DataFrame({'x': [1, 2, 3, 100], 'y': [10, 20, 30, 40]})
-        >>> result = outlier_table(df)
-        >>> print(result)
+        df = DataFrame({'x': [1, 2, 3, 100], 'y': [10, 20, 30, 40]})
 
-        특정 컬럼만 분석:
+        # 전체 숫자형 컬럼에 대한 이상치 경계 확인:
+        result = hs_stats.outlier_table(df)
+        print(result)
 
-        >>> result = outlier_table(df, 'x', 'y')
-        >>> print(result[['Q1', 'Q3', 'UP', 'DOWN']])
+        # 특정 컬럼만 분석:
+        result = hs_stats.outlier_table(df, 'x', 'y')
+        print(result[['q1', 'q3', 'up', 'down']])
+        ```
 
     Notes:
         - DOWN 미만이거나 UP 초과인 값은 이상치(outlier)로 간주됩니다.
@@ -140,7 +145,7 @@ def outlier_table(data: DataFrame, *fields: str):
         - Tukey의 1.5 * IQR 규칙을 사용합니다 (상자그림의 표준 방법).
     """
     if not fields:
-        fields = data.columns
+        fields = tuple(data.columns)
 
     result = []
     for f in fields:
@@ -195,80 +200,160 @@ def outlier_table(data: DataFrame, *fields: str):
 
 
 # ===================================================================
-# 범주형 변수 분석 (Categorical Variable Analysis)
+# 확장된 기술통계량 (Extended Descriptive Statistics)
 # ===================================================================
-def category_table(data: DataFrame, *fields: str):
-    """데이터프레임의 명목형(범주형) 변수에 대한 기술통계를 반환한다.
+def describe(data: DataFrame, *fields: str, columns: list | None = None):
+    """데이터프레임의 연속형 변수의 단위 및 현실성을 평가하기 위해 확장된 기술통계량을 반환한다.
 
-    각 명목형 컬럼의 범주값별 빈도수와 비율을 계산하여 데이터프레임으로 반환한다.
+    각 연속형(숫자형) 컬럼의 기술통계량(describe)을 구하고, 이에 사분위수 범위(IQR),
+    이상치 경계값(UP, DOWN), 왜도(skew), 이상치 개수 및 비율, 분포 특성, 로그변환 필요성을
+    추가하여 반환한다.
 
     Args:
         data (DataFrame): 분석 대상 데이터프레임.
-        *fields (str): 분석할 컬럼명 목록. 지정하지 않으면 모든 명목형 컬럼을 처리.
+        *fields (str): 분석할 컬럼명 목록. 지정하지 않으면 모든 숫자형 컬럼을 처리.
+        columns (list, optional): 반환할 통계량 컬럼 목록. None이면 모든 통계량 반환.
 
     Returns:
-        DataFrame: 각 컬럼별 범주값의 빈도와 비율 정보를 포함한 데이터프레임.
-            인덱스는 FIELD(컬럼명)와 CATEGORY(범주값)이며, 다음 컬럼을 포함:
+        DataFrame: 각 필드별 확장된 기술통계량을 포함한 데이터프레임.
+            행은 다음과 같은 통계량을 포함:
 
-            - count (int): 해당 범주값의 빈도수
-            - rate (float): 전체 행에서 해당 범주값의 비율(%)
+            - count (float): 비결측치의 수
+            - mean (float): 평균값
+            - std (float): 표준편차
+            - min (float): 최소값
+            - 25% (float): 제1사분위수 (Q1)
+            - 50% (float): 제2사분위수 (중앙값)
+            - 75% (float): 제3사분위수 (Q3)
+            - max (float): 최대값
+            - iqr (float): 사분위 범위 (Q3 - Q1)
+            - up (float): 이상치 상한 경계값 (Q3 + 1.5 * IQR)
+            - down (float): 이상치 하한 경계값 (Q1 - 1.5 * IQR)
+            - skew (float): 왜도
+            - outlier_count (int): 이상치 개수
+            - outlier_rate (float): 이상치 비율(%)
+            - dist (str): 분포 특성 ("극단 우측 꼬리", "거의 대칭" 등)
+            - log_need (str): 로그변환 필요성 ("높음", "중간", "낮음")
 
     Examples:
-        전체 명목형 컬럼에 대한 기술통계:
-
-        >>> from hossam import category_table
-        >>> import pandas as pd
-        >>> df = pd.DataFrame({
-        ...     'color': ['red', 'blue', 'red', 'green', 'blue', 'red'],
-        ...     'size': ['S', 'M', 'L', 'M', 'S', 'M'],
-        ...     'price': [100, 200, 150, 300, 120, 180]
-        ... })
-        >>> result = category_table(df)
-        >>> print(result)
+        ```python
+        from hossam import *
+        from pandas import DataFrame
+
+        df = DataFrame({
+            'x': [1, 2, 3, 4, 5, 100],
+            'y': [10, 20, 30, 40, 50, 60],
+            'z': ['a', 'b', 'c', 'd', 'e', 'f']
+        })
 
-        특정 컬럼만 분석:
+        # 전체 숫자형 컬럼에 대한 확장된 기술통계:
+        result = hs_stats.describe(df)
+        print(result)
 
-        >>> result = category_table(df, 'color', 'size')
-        >>> print(result)
+        # 특정 컬럼만 분석:
+        result = hs_stats.describe(df, 'x', 'y')
+        print(result)
+        ```
 
     Notes:
-        - 숫자형 컬럼은 자동으로 제외됩니다.
-        - 각 범주값별로 별도의 행으로 반환됩니다.
-        - NaN 값도 하나의 범주로 포함됩니다.
+        - 숫자형이 아닌 컬럼은 자동으로 제외됩니다.
+        - 결과는 필드(컬럼)가 행으로, 통계량이 열로 구성됩니다.
+        - Tukey의 1.5 * IQR 규칙을 사용하여 이상치를 판정합니다.
+        - 분포 특성은 왜도 값으로 판정합니다.
+        - 로그변환 필요성은 왜도의 절댓값 크기로 판정합니다.
     """
     if not fields:
-        # 명목형(범주형) 컬럼 선택: object, category, bool 타입
-        fields = data.select_dtypes(include=['object', 'category', 'bool']).columns
+        fields = tuple(data.select_dtypes(include=['int', 'int32', 'int64', 'float', 'float32', 'float64']).columns)
 
-    result = []
+    # 기술통계량 구하기
+    desc = data[list(fields)].describe().T
+    # 각 컬럼별 결측치 수(null_count) 추가
+    null_counts = data[list(fields)].isnull().sum()
+    desc.insert(1, 'null_count', null_counts)
+
+    # 추가 통계량 계산
+    additional_stats = []
     for f in fields:
-        # 숫자형 컬럼은 건너뜀
-        if data[f].dtypes in [
-            "int",
-            "int32",
-            "int64",
-            "float",
-            "float32",
-            "float64",
+        # 숫자 타입이 아니라면 건너뜀
+        if data[f].dtype not in [
+            'int',
+            'int32',
+            'int64',
+            'float',
+            'float32',
+            'float64',
+            'int64',
+            'float64',
+            'float32'
         ]:
             continue
 
-        # 각 범주값의 빈도수 계산 (NaN 포함)
-        value_counts = data[f].value_counts(dropna=False)
+        # 사분위수
+        q1 = data[f].quantile(q=0.25)
+        q3 = data[f].quantile(q=0.75)
 
-        for category, count in value_counts.items():
-            rate = (count / len(data)) * 100
+        # 이상치 경계 (Tukey's fences)
+        iqr = q3 - q1
+        down = q1 - 1.5 * iqr
+        up = q3 + 1.5 * iqr
 
-            iq = {
-                "field": f,
-                "category": category,
-                "count": count,
-                "rate": rate
-            }
+        # 왜도
+        skew = data[f].skew()
 
-            result.append(iq)
+        # 이상치 개수 및 비율
+        outlier_count = ((data[f] < down) | (data[f] > up)).sum()
+        outlier_rate = (outlier_count / len(data)) * 100
 
-    return DataFrame(result).set_index(["field", "category"])
+        # 분포 특성 판정 (왜도 기준)
+        abs_skew = abs(skew)
+        if abs_skew < 0.5:
+            dist = "거의 대칭"
+        elif abs_skew < 1.0:
+            if skew > 0:
+                dist = "약한 우측 꼬리"
+            else:
+                dist = "약한 좌측 꼬리"
+        elif abs_skew < 2.0:
+            if skew > 0:
+                dist = "중간 우측 꼬리"
+            else:
+                dist = "중간 좌측 꼬리"
+        else:
+            if skew > 0:
+                dist = "극단 우측 꼬리"
+            else:
+                dist = "극단 좌측 꼬리"
+
+        # 로그변환 필요성 판정
+        if abs_skew < 0.5:
+            log_need = "낮음"
+        elif abs_skew < 1.0:
+            log_need = "중간"
+        else:
+            log_need = "높음"
+
+        additional_stats.append({
+            'field': f,
+            'iqr': iqr,
+            'up': up,
+            'down': down,
+            'outlier_count': outlier_count,
+            'outlier_rate': outlier_rate,
+            'skew': skew,
+            'dist': dist,
+            'log_need': log_need
+        })
+
+    additional_df = DataFrame(additional_stats).set_index('field')
+
+    # 결과 병합
+    result = concat([desc, additional_df], axis=1)
+
+    # columns 파라미터가 지정된 경우 해당 컬럼만 필터링
+    if columns is not None:
+        result = result[columns]
+
+    return result
 
 
 # ===================================================================
@@ -284,7 +369,8 @@ def category_describe(data: DataFrame, *fields: str):
         *fields (str): 분석할 컬럼명 목록. 지정하지 않으면 모든 명목형 컬럼을 처리.
 
     Returns:
-        DataFrame: 각 컬럼별 최다/최소 범주 정보를 포함한 데이터프레임.
+        tuple[DataFrame, DataFrame]: 각 컬럼별 최다/최소 범주 정보를 포함한 데이터프레임과
+            각 범주별 빈도/비율 정보를 포함한 데이터프레임을 튜플로 반환.
             다음 컬럼을 포함:
 
             - 변수 (str): 컬럼명
@@ -294,22 +380,22 @@ def category_describe(data: DataFrame, *fields: str):
             - 최소_비율(%) (float): 최소 범주의 비율
 
     Examples:
-        전체 명목형 컬럼에 대한 분포 편향 요약:
-
-        >>> from hossam import category_describe
-        >>> import pandas as pd
-        >>> df = pd.DataFrame({
-        ...     'cut': ['Ideal', 'Premium', 'Good', 'Ideal', 'Premium'],
-        ...     'color': ['E', 'F', 'G', 'E', 'F'],
-        ...     'price': [100, 200, 150, 300, 120]
-        ... })
-        >>> result = category_describe(df)
-        >>> print(result)
+        ```python
+        from hossam import *
+        from pandas import DataFrame
+
+        df = DataFrame({
+            'cut': ['Ideal', 'Premium', 'Good', 'Ideal', 'Premium'],
+            'color': ['E', 'F', 'G', 'E', 'F'],
+            'price': [100, 200, 150, 300, 120]
+        })
 
-        특정 컬럼만 분석:
+        # 전체 명목형 컬럼에 대한 요약:
+        result, summary = hs_stats.category_describe(df)
 
-        >>> result = category_describe(df, 'cut', 'color')
-        >>> print(result)
+        # 특정 컬럼만 분석:
+        result, summary = hs_stats.category_describe(df, 'cut', 'color')
+        ```
 
     Notes:
         - 숫자형 컬럼은 자동으로 제외됩니다.
@@ -320,6 +406,7 @@ def category_describe(data: DataFrame, *fields: str):
         fields = data.select_dtypes(include=['object', 'category', 'bool']).columns
 
     result = []
+    summary = []
     for f in fields:
         # 숫자형 컬럼은 건너뜀
         if data[f].dtypes in [
@@ -335,40 +422,35 @@ def category_describe(data: DataFrame, *fields: str):
         # 각 범주값의 빈도수 계산 (NaN 포함)
         value_counts = data[f].value_counts(dropna=False)
 
+        # 범주별 빈도/비율 정보 추가 (category_table 기능)
+        for category, count in value_counts.items():
+            rate = (count / len(data)) * 100
+            result.append({
+                "변수": f,
+                "범주": category,
+                "빈도": count,
+                "비율(%)": round(rate, 2)
+            })
+
         if len(value_counts) == 0:
             continue
 
-        # 최다 범주 (첫 번째)
+        # 최다/최소 범주 정보 추가 (category_describe 기능)
         max_category = value_counts.index[0]
         max_count = value_counts.iloc[0]
         max_rate = (max_count / len(data)) * 100
-
-        # 최소 범주 (마지막)
         min_category = value_counts.index[-1]
         min_count = value_counts.iloc[-1]
         min_rate = (min_count / len(data)) * 100
-
-        iq = {
+        summary.append({
             "변수": f,
             "최다_범주": max_category,
             "최다_비율(%)": round(max_rate, 2),
             "최소_범주": min_category,
             "최소_비율(%)": round(min_rate, 2)
-        }
-
-        result.append(iq)
-
-    return DataFrame(result)
+        })
 
-# -------------------------------------------------------------------
-# Backward-compatibility alias for categorical summary
-# 기존 함수명(category_summary)을 계속 지원합니다.
-def category_summary(data: DataFrame, *fields: str):
-    """Deprecated alias for category_describe.
-
-    기존 코드 호환을 위해 유지됩니다. 내부적으로 category_describe를 호출합니다.
-    """
-    return category_describe(data, *fields)
+    return DataFrame(result), DataFrame(summary).set_index("변수")
 
 # ===================================================================
 # 정규성 검정 (Normal Test)
@@ -403,19 +485,25 @@ def normal_test(data: DataFrame, columns: list | str | None = None, method: str
         ValueError: 메서드가 "n" 또는 "s"가 아닐 경우.
 
     Examples:
-        >>> from hossam.analysis import normal_test
-        >>> import pandas as pd
-        >>> import numpy as np
-        >>> df = pd.DataFrame({
-        ...     'x': np.random.normal(0, 1, 100),
-        ...     'y': np.random.exponential(2, 100)
-        ... })
-        >>> # 모든 수치형 컬럼 검정
-        >>> result = normal_test(df, method='n')
-        >>> # 특정 컬럼만 검정 (리스트)
-        >>> result = normal_test(df, columns=['x'], method='n')
-        >>> # 특정 컬럼만 검정 (문자열)
-        >>> result = normal_test(df, columns='x, y', method='n')
+        ```python
+        from hossam import *
+        from pandas import DataFrame
+        import numpy as np
+
+        df = DataFrame({
+            'x': np.random.normal(0, 1, 100),
+            'y': np.random.exponential(2, 100)
+        })
+
+        # 모든 수치형 컬럼 검정
+        result = hs_stats.normal_test(df, method='n')
+
+        # 특정 컬럼만 검정 (리스트)
+        result = hs_stats.normal_test(df, columns=['x'], method='n')
+
+        # 특정 컬럼만 검정 (문자열)
+        result = hs_stats.normal_test(df, columns='x, y', method='n')
+        ```
     """
     if method not in ["n", "s"]:
         raise ValueError(f"method는 'n' 또는 's'여야 합니다. 입력값: {method}")
@@ -515,22 +603,29 @@ def equal_var_test(data: DataFrame, columns: list | str | None = None, normal_di
         ValueError: 수치형 컬럼이 2개 미만일 경우 (검정에 최소 2개 필요).
 
     Examples:
-        >>> from hossam.analysis import equal_var_test
-        >>> import pandas as pd
-        >>> import numpy as np
-        >>> df = pd.DataFrame({
-        ...     'x': np.random.normal(0, 1, 100),
-        ...     'y': np.random.normal(0, 1, 100),
-        ...     'z': np.random.normal(0, 2, 100)
-        ... })
-        >>> # 모든 수치형 컬럼 자동 판별
-        >>> result = equal_var_test(df)
-        >>> # 특정 컬럼만 검정 (리스트)
-        >>> result = equal_var_test(df, columns=['x', 'y'])
-        >>> # 특정 컬럼만 검정 (문자열)
-        >>> result = equal_var_test(df, columns='x, y')
-        >>> # 명시적 지정
-        >>> result = equal_var_test(df, normal_dist=True)
+        ```python
+        from hossam import *
+        from pandas import DataFrame
+        import numpy as np
+
+        df = DataFrame({
+            'x': np.random.normal(0, 1, 100),
+            'y': np.random.normal(0, 1, 100),
+            'z': np.random.normal(0, 2, 100)
+        })
+
+        # 모든 수치형 컬럼 자동 판별
+        result = hs_stats.equal_var_test(df)
+
+        # 특정 컬럼만 검정 (리스트)
+        result = hs_stats.equal_var_test(df, columns=['x', 'y'])
+
+        # 특정 컬럼만 검정 (문자열)
+        result = hs_stats.equal_var_test(df, columns='x, y')
+
+        # 명시적 지정
+        result = hs_stats.equal_var_test(df, normal_dist=True)
+        ```
     """
     # columns가 문자열인 경우 리스트로 변환
     if isinstance(columns, str):
@@ -627,15 +722,19 @@ def ttest_1samp(data, mean_value: float = 0.0) -> DataFrame:
             - interpretation (str): 검정 결과 해석 문자열
 
     Examples:
-        >>> from hossam.hs_stats import ttest_1samp
-        >>> import pandas as pd
-        >>> import numpy as np
-        >>> # 리스트 데이터로 검정
-        >>> data = [5.1, 4.9, 5.3, 5.0, 4.8]
-        >>> result = ttest_1samp(data, mean_value=5.0)
-        >>> # Series 데이터로 검정
-        >>> s = pd.Series(np.random.normal(5, 1, 100))
-        >>> result = ttest_1samp(s, mean_value=5)
+        ```python
+        from hossam import *
+        from pandas import Series
+        import numpy as np
+
+        # 리스트 데이터로 검정
+        data = [5.1, 4.9, 5.3, 5.0, 4.8]
+        result = hs_stats.ttest_1samp(data, mean_value=5.0)
+
+        # Series 데이터로 검정
+        s = Series(np.random.normal(5, 1, 100))
+        result = hs_stats.ttest_1samp(s, mean_value=5)
+        ```
     """
     # 데이터를 Series로 변환하고 이름 감지
     if isinstance(data, Series):
@@ -724,17 +823,21 @@ def ttest_ind(x, y, equal_var: bool | None = None) -> DataFrame:
             - interpretation (str): 검정 결과 해석
 
     Examples:
-        >>> from hossam.hs_stats import ttest_ind
-        >>> import pandas as pd
-        >>> import numpy as np
-        >>> # 리스트로 검정
-        >>> group1 = [5.1, 4.9, 5.3, 5.0, 4.8]
-        >>> group2 = [5.5, 5.7, 5.4, 5.6, 5.8]
-        >>> result = ttest_ind(group1, group2)
-        >>> # Series로 검정
-        >>> s1 = pd.Series(np.random.normal(5, 1, 100))
-        >>> s2 = pd.Series(np.random.normal(5.5, 1, 100))
-        >>> result = ttest_ind(s1, s2, equal_var=False)
+        ```python
+        from hossam import *
+        from pandas import Series, DataFrame
+        import numpy as np
+
+        # 리스트로 검정
+        group1 = [5.1, 4.9, 5.3, 5.0, 4.8]
+        group2 = [5.5, 5.7, 5.4, 5.6, 5.8]
+        result = hs_stats.ttest_ind(group1, group2)
+
+        # Series로 검정
+        s1 = Series(np.random.normal(5, 1, 100))
+        s2 = Series(np.random.normal(5.5, 1, 100))
+        result = hs_stats.ttest_ind(s1, s2, equal_var=False)
+        ```
     """
     # 데이터를 Series로 변환
     if isinstance(x, Series):
@@ -835,17 +938,21 @@ def ttest_rel(x, y, parametric: bool | None = None) -> DataFrame:
             - interpretation (str): 검정 결과 해석
 
     Examples:
-        >>> from hossam.hs_stats import ttest_rel
-        >>> import pandas as pd
-        >>> import numpy as np
-        >>> # 리스트로 검정
-        >>> before = [5.1, 4.9, 5.3, 5.0, 4.8]
-        >>> after = [5.5, 5.2, 5.7, 5.3, 5.1]
-        >>> result = ttest_rel(before, after)
-        >>> # Series로 검정
-        >>> s1 = pd.Series(np.random.normal(5, 1, 100))
-        >>> s2 = pd.Series(np.random.normal(5.3, 1, 100))
-        >>> result = ttest_rel(s1, s2, parametric=False)
+        ```python
+        from hossam import *
+        from pandas import Series
+        import numpy as np
+
+        # 리스트로 검정
+        before = [5.1, 4.9, 5.3, 5.0, 4.8]
+        after = [5.5, 5.2, 5.7, 5.3, 5.1]
+        result = hs_stats.ttest_rel(before, after)
+
+        # Series로 검정
+        s1 = Series(np.random.normal(5, 1, 100))
+        s2 = Series(np.random.normal(5.3, 1, 100))
+        result = hs_stats.ttest_rel(s1, s2, parametric=False)
+        ```
     """
     # 데이터를 Series로 변환
     if isinstance(x, Series):
@@ -958,11 +1065,11 @@ def vif_filter(
         DataFrame: VIF가 threshold 이하인 변수만 남은 데이터프레임 (원본 컬럼 순서 유지)
 
     Examples:
-        기본 사용 예:
-
-        >>> from hossam.analysis import vif_filter
-        >>> filtered = hs_vif_filter(df, yname="target", ignore=["id"], threshold=10.0)
-        >>> filtered.head()
+        ```python
+        # 기본 사용 예
+        from hossam import *
+        filtered = hs_stats.vif_filter(df, yname="target", ignore=["id"], threshold=10.0)
+        ```
     """
 
     df = data.copy()
@@ -1038,15 +1145,6 @@ def vif_filter(
 
     return result
 
-# -------------------------------------------------------------------
-# Backward-compatibility alias for describe (typo support)
-# 오타(discribe)로 사용된 경우를 지원하여 혼란을 줄입니다.
-def discribe(data: DataFrame, *fields: str, columns: list = None):
-    """Deprecated alias for describe.
-
-    내부적으로 describe를 호출합니다.
-    """
-    return describe(data, *fields, columns=columns)
 
 
 # ===================================================================
@@ -1065,12 +1163,12 @@ def trend(x: any, y: any, degree: int = 1, value_count: int = 100) -> Tuple[np.n
         tuple: (v_trend, t_trend)
 
     Examples:
-        2차 다항 회귀 추세선:
-
-        >>> from hossam.analysis import trend
-        >>> vx, vy = hs_trend(x, y, degree=2, value_count=200)
-        >>> len(vx), len(vy)
-        (200, 200)
+        ```python
+        # 2차 다항 회귀 추세선
+        from hossam import *
+        vx, vy = hs_stats.trend(x, y, degree=2, value_count=200)
+        print(len(vx), len(vy)) # 200, 200
+        ```
     """
     # [ a, b, c ] ==> ax^2 + bx + c
     x_arr = np.asarray(x)
@@ -1116,14 +1214,18 @@ def ols_report(fit, data, full=False, alpha=0.05):
             - 회귀계수 표 (`rdf`, DataFrame)
 
     Examples:
-        >>> import statsmodels.api as sm
-        >>> y = data['target']
-        >>> X = sm.add_constant(data[['x1', 'x2']])
-        >>> fit = sm.OLS(y, X).fit()
-        >>> # 전체 리포트
-        >>> pdf, rdf, result_report, model_report, variable_reports, eq = ols_report(fit, data)
-        >>> # 간단한 버전 (회귀계수 테이블만)
-        >>> rdf = ols_report(fit, data, full=False)
+        ```python
+        from hossam import *
+
+        df = hs_util.load_data("some_data.csv")
+        fit = hs_stats.ols(df, yname="target")
+
+        # 전체 리포트
+        pdf, rdf, result_report, model_report, variable_reports, eq = hs_stats.ols_report(fit, data, full=True)
+
+        # 간단한 버전 (성능지표, 회귀계수 테이블만)
+        pdf, rdf = hs_stats.ols_report(fit, data)
+        ```
     """
 
     # summary2() 결과에서 실제 회귀계수 DataFrame 추출
@@ -1270,7 +1372,7 @@ def ols_report(fit, data, full=False, alpha=0.05):
     if full:
         return pdf, rdf, result_report, model_report, variable_reports, equation_text
     else:
-        return pdf
+        return pdf, rdf
 
 
 # ===================================================================
@@ -1309,23 +1411,26 @@ def ols(df: DataFrame, yname: str, report=False):
             - equation_text: 회귀식 문자열 (str)
 
     Examples:
-        >>> from hossam.analysis import linear
-        >>> import pandas as pd
-        >>> import numpy as np
-        >>> df = pd.DataFrame({
-        ...     'target': np.random.normal(100, 10, 100),
-        ...     'x1': np.random.normal(0, 1, 100),
-        ...     'x2': np.random.normal(0, 1, 100)
-        ... })
-        >>> # 적합 결과만 반환
-        >>> fit = hs_ols(df, 'target')
-        >>> print(fit.summary())
-
-        >>> # 요약 리포트 반환
-        >>> fit, result, features = hs_ols(df, 'target', report=1)
-
-        >>> # 풀 리포트 반환
-        >>> fit, pdf, rdf, result_report, model_report, var_reports, eq = hs_ols(df, 'target', report=2)
+        ```python
+        from hossam import *
+        from pandas import DataFrame
+        import numpy as np
+
+        df = DataFrame({
+            'target': np.random.normal(100, 10, 100),
+            'x1': np.random.normal(0, 1, 100),
+            'x2': np.random.normal(0, 1, 100)
+        })
+
+        # 적합 결과만 반환
+        fit = hs_stats.ols(df, 'target')
+
+        # 요약 리포트 반환
+        fit, pdf, rdf = hs_stats.ols(df, 'target', report=1)
+
+        # 풀 리포트 반환
+        fit, pdf, rdf, result_report, model_report, var_reports, eq = hs_stats.ols(df, 'target', report=2)
+        ```
     """
     x = df.drop(yname, axis=1)
     y = df[yname]
@@ -1340,7 +1445,7 @@ def ols(df: DataFrame, yname: str, report=False):
         return linear_fit
     elif report == 1 or report == 'summary':
         # 요약 리포트 (full=False)
-        pdf, rdf, result_report, model_report, variable_reports, equation_text = ols_report(linear_fit, df, full=True, alpha=0.05)
+        pdf, rdf = ols_report(linear_fit, df, full=False, alpha=0.05)
         return linear_fit, pdf, rdf
     elif report == 2 or report == 'full' or report is True:
         # 풀 리포트 (full=True)
@@ -1378,14 +1483,26 @@ def logit_report(fit, data, threshold=0.5, full=False, alpha=0.05):
             - 회귀계수 표 (`rdf`, DataFrame)
 
     Examples:
-        >>> import statsmodels.api as sm
-        >>> y = data['target']
-        >>> X = sm.add_constant(data[['x1', 'x2']])
-        >>> fit = sm.Logit(y, X).fit(disp=0)
-        >>> # 전체 리포트
-        >>> cdf, rdf, result_report, model_report, variable_reports, cm = hs_logit_report(fit, data)
-        >>> # 간단한 버전 (주요 테이블만)
-        >>> cdf, rdf = hs_logit_report(fit, data, full=False)
+        ```python
+        from hossam import *
+        from pandas import DataFrame
+        import numpy as np
+
+        df = DataFrame({
+            'target': np.random.binomial(1, 0.5, 100),
+            'x1': np.random.normal(0, 1, 100),
+            'x2': np.random.normal(0, 1, 100)
+        })
+
+        # 로지스틱 회귀 적합
+        fit = hs_stats.logit(df, yname="target")
+
+        # 전체 리포트
+        cdf, rdf, result_report, model_report, variable_reports, cm = hs_stats.logit_report(fit, df, full=True)
+
+        # 간단한 버전 (주요 테이블만)
+        cdf, rdf = hs_stats.logit_report(fit, df)
+        ```
     """
 
     # -----------------------------
@@ -1567,23 +1684,26 @@ def logit(df: DataFrame, yname: str, report=False):
             - variable_reports: 변수별 보고 문장 리스트 (list[str])
 
     Examples:
-        >>> from hossam.analysis import logit
-        >>> import pandas as pd
-        >>> import numpy as np
-        >>> df = pd.DataFrame({
-        ...     'target': np.random.binomial(1, 0.5, 100),
-        ...     'x1': np.random.normal(0, 1, 100),
-        ...     'x2': np.random.normal(0, 1, 100)
-        ... })
-        >>> # 적합 결과만 반환
-        >>> fit = hs_logit(df, 'target')
-        >>> print(fit.summary())
-
-        >>> # 요약 리포트 반환
-        >>> fit, rdf, result_report, var_reports = hs_logit(df, 'target', report=1)
-
-        >>> # 풀 리포트 반환
-        >>> fit, cdf, rdf, result_report, model_report, var_reports = hs_logit(df, 'target', report=2)
+        ```python
+        from hossam import *
+        from pandas import DataFrame
+        import numpy as np
+
+        df = DataFrame({
+            'target': np.random.binomial(1, 0.5, 100),
+            'x1': np.random.normal(0, 1, 100),
+            'x2': np.random.normal(0, 1, 100)
+        })
+
+        # 적합 결과만 반환
+        fit = hs_stats.logit(df, 'target')
+
+        # 요약 리포트 반환
+        fit, rdf, result_report, var_reports = hs_stats.logit(df, 'target', report='summary')
+
+        # 풀 리포트 반환
+        fit, cdf, rdf, result_report, model_report, var_reports = hs_stats.logit(df, 'target', report='full')
+        ```
     """
     x = df.drop(yname, axis=1)
     y = df[yname]
@@ -1636,12 +1756,11 @@ def ols_linearity_test(fit, power: int = 2, alpha: float = 0.05) -> DataFrame:
                    - 해석: 선형성 판정 (문자열)
 
     Examples:
-        >>> import statsmodels.api as sm
-        >>> X = sm.add_constant(df[['x1', 'x2']])
-        >>> y = df['y']
-        >>> fit = sm.OLS(y, X).fit()
-        >>> result = linearity_test(fit)
-        >>> print(result)
+        ```python
+        from hossam import *
+        fit = hs_stats.logit(df, 'target')
+        result = hs_stats.ols_linearity_test(fit)
+        ```
 
     Notes:
         - p-value > alpha: 선형성 가정을 만족 (귀무가설 채택)
@@ -1736,12 +1855,11 @@ def ols_normality_test(fit, alpha: float = 0.05) -> DataFrame:
                    - 해석: 정규성 판정 (문자열)
 
     Examples:
-        >>> import statsmodels.api as sm
-        >>> X = sm.add_constant(df[['x1', 'x2']])
-        >>> y = df['y']
-        >>> fit = sm.OLS(y, X).fit()
-        >>> result = normality_test(fit)
-        >>> print(result)
+        ```python
+        from hossam import *
+        fit = hs_stats.logit(df, 'target')
+        result = hs_stats.ols_normality_test(fit)
+        ```
 
     Notes:
         - Shapiro-Wilk: 샘플 크기가 작을 때 (< 5000) 강력한 검정
@@ -1831,12 +1949,11 @@ def ols_variance_test(fit, alpha: float = 0.05) -> DataFrame:
                    - 해석: 등분산성 판정 (문자열)
 
     Examples:
-        >>> import statsmodels.api as sm
-        >>> X = sm.add_constant(df[['x1', 'x2']])
-        >>> y = df['y']
-        >>> fit = sm.OLS(y, X).fit()
-        >>> result = homoscedasticity_test(fit)
-        >>> print(result)
+        ```python
+        from hossam import *
+        fit = hs_stats.logit(df, 'target')
+        result = hs_stats.ols_variance_test(fit)
+        ```
 
     Notes:
         - Breusch-Pagan: 잔차 제곱과 독립변수의 선형관계 검정
@@ -1922,22 +2039,11 @@ def ols_independence_test(fit, alpha: float = 0.05) -> DataFrame:
             - 해석: 검정 결과 해석
 
     Examples:
-        >>> import pandas as pd
-        >>> import statsmodels.api as sm
-        >>> from hossam.hs_stats import ols_independence_test
-        >>>
-        >>> # 예제 데이터
-        >>> df = pd.DataFrame({
-        ...     'x': range(100),
-        ...     'y': [i + np.random.randn() for i in range(100)]
-        ... })
-        >>> X = sm.add_constant(df['x'])
-        >>> model = sm.OLS(df['y'], X)
-        >>> fit = model.fit()
-        >>>
-        >>> # 독립성 검정
-        >>> result = ols_independence_test(fit)
-        >>> print(result)
+        ```python
+        from hossam import *
+        fit = hs_stats.logit(df, 'target')
+        result = hs_stats.ols_independence_test(fit)
+        ```
 
     Notes:
         - Durbin-Watson 통계량 해석:
@@ -1975,92 +2081,6 @@ def ols_independence_test(fit, alpha: float = 0.05) -> DataFrame:
 
     return result_df
 
-
-# ===================================================================
-# 상관계수 히트맵
-# ===================================================================
-def corr(data: DataFrame, *fields: str) -> tuple[DataFrame, DataFrame]:
-    """데이터프레임의 연속형 변수들에 대한 상관계수 히트맵과 상관계수 종류를 반환한다.
-
-    정규성 검정을 통해 피어슨 또는 스피어만 상관계수를 자동 선택하여 계산한다.
-    선택된 상관계수 종류를 별도의 데이터프레임으로 교차표(행렬) 형태로 반환한다.
-
-    Args:
-        data (DataFrame): 분석 대상 데이터프레임.
-        *fields (str): 분석할 컬럼명 목록. 지정하지 않으면 모든 숫자형 컬럼을 사용.
-
-    Returns:
-        tuple[DataFrame, DataFrame]: 상관계수 행렬과 사용된 상관계수 종류 정보를 포함한 두 개의 데이터프레임.
-
-            - 첫 번째 DataFrame: 상관계수 행렬 (각 변수 쌍의 상관계수 값)
-            - 두 번째 DataFrame: 상관계수 종류 (교차표 형태)
-                - 행과 열: 변수명
-                - 셀의 값: 각 변수 쌍에 사용된 상관계수 종류 ('Pearson' 또는 'Spearman')
-
-    Examples:
-        >>> import pandas as pd
-        >>> import numpy as np
-        >>> df = pd.DataFrame({
-        ...     'x1': np.random.normal(0, 1, 100),
-        ...     'x2': np.random.normal(0, 1, 100),
-        ...     'x3': np.random.normal(0, 1, 100),
-        ... })
-        >>> # 모든 연속형 변수에 대해 상관계수 계산
-        >>> corr_matrix, corr_types = corr(df)
-        >>> print(corr_matrix)
-        >>>     x1   x2   x3
-        >>> x1 1.00 0.12 -0.05
-        >>> x2 0.12 1.00  0.08
-        >>> x3 -0.05 0.08 1.00
-        >>> print(corr_types)
-        >>>       x1       x2       x3
-        >>> x1  Pearson Pearson Pearson
-        >>> x2  Pearson Pearson Pearson
-        >>> x3  Pearson Pearson Pearson
-
-        >>> # 특정 컬럼만 분석
-        >>> corr_matrix, corr_info = corr(df, 'x1', 'x2')
-        >>> print(corr_matrix)
-    """
-    # 분석 대상 컬럼 결정
-    if fields:
-        # 지정된 컬럼만 사용
-        numeric_cols = list(fields)
-    else:
-        # 모든 숫자형 컬럼 선택
-        numeric_cols = data.select_dtypes(include=[np.number]).columns.tolist()
-
-    # 분석 데이터 추출
-    analysis_data = data[numeric_cols].copy()
-
-    # 샘플 크기에 따라 자동으로 shapiro 또는 normaltest 선택
-    test_method = 's' if len(analysis_data) <= 5000 else 'n'
-    normality_results = normal_test(analysis_data, columns=numeric_cols, method=test_method)
-
-    # 정규성 결과를 딕셔너리로 변환
-    normality_info = dict(zip(normality_results['column'], normality_results['is_normal']))
-
-    # 상관계수 계산: 모든 변수가 정규분포를 따르면 Pearson, 하나라도 아니면 Spearman 사용
-    all_normal = all(normality_info.values())
-    if all_normal:
-        # Pearson 상관계수
-        corr_matrix = analysis_data.corr(method='pearson')
-        selected_corr_type = 'Pearson'
-    else:
-        # Spearman 상관계수
-        corr_matrix = analysis_data.corr(method='spearman')
-        selected_corr_type = 'Spearman'
-
-    # 상관계수 정보 데이터프레임 생성 (교차표 형태 - 상관행렬과 동일한 구조)
-    corr_info_df = DataFrame(
-        selected_corr_type,
-        index=numeric_cols,
-        columns=numeric_cols
-    )
-
-    return corr_matrix, corr_info_df
-
-
 # ===================================================================
 # 쌍별 상관분석 (선형성/이상치 점검 후 Pearson/Spearman 자동 선택)
 # ===================================================================
@@ -2099,13 +2119,16 @@ def corr_pairwise(
             [1] corr_matrix: 상관계수 행렬 (행과 열에 변수명, 값에 상관계수)
 
     Examples:
-        >>> from hossam.hs_stats import corr_pairwise
-        >>> import pandas as pd
-        >>> df = pd.DataFrame({'x1': [1,2,3,4,5], 'x2': [2,4,5,4,6], 'x3': [10,20,25,24,30]})
-        >>> # 전체 숫자형 컬럼에 대해 상관분석
-        >>> result_df, corr_matrix = corr_pairwise(df)
-        >>> # 특정 컬럼만 분석
-        >>> result_df, corr_matrix = corr_pairwise(df, fields=['x1', 'x2'])
+        ```python
+        from hossam import *
+        from pandas import DataFrame
+
+        df = DataFrame({'x1': [1,2,3,4,5], 'x2': [2,4,5,4,6], 'x3': [10,20,25,24,30]})
+        # 전체 숫자형 컬럼에 대해 상관분석
+        result_df, corr_matrix = hs_stats.corr_pairwise(df)
+        # 특정 컬럼만 분석
+        result_df, corr_matrix = hs_stats.corr_pairwise(df, fields=['x1', 'x2'])
+        ```
     """
 
     # 0) 컬럼 선정 (숫자형만)
@@ -2289,17 +2312,22 @@ def oneway_anova(data: DataFrame, dv: str, between: str, alpha: float = 0.05) ->
             - posthoc_report (str): 사후검정 유무와 유의한 쌍 정보를 요약한 보고 문장.
 
     Examples:
-        >>> from hossam import oneway_anova
-        >>> import pandas as pd
-        >>> df = pd.DataFrame({
-        ...     'score': [5.1, 4.9, 5.3, 5.0, 4.8, 5.5, 5.2, 5.7, 5.3, 5.1],
-        ...     'group': ['A', 'A', 'A', 'A', 'A', 'B', 'B', 'B', 'B', 'B']
-        ... })
-        >>> anova_df, anova_report, posthoc_df, posthoc_report = oneway_anova(df, dv='score', between='group')
-        >>> print(anova_report)
-        >>> if posthoc_df is not None:
-        ...     print(posthoc_report)
-        ...     print(posthoc_df.head())
+        ```python
+        from hossam import *
+        from pandas import DataFrame
+
+        df = DataFrame({
+            'score': [5.1, 4.9, 5.3, 5.0, 4.8, 5.5, 5.2, 5.7, 5.3, 5.1],
+            'group': ['A', 'A', 'A', 'A', 'A', 'B', 'B', 'B', 'B', 'B']
+        })
+
+        anova_df, anova_report, posthoc_df, posthoc_report = hs_stats.oneway_anova(df, dv='score', between='group')
+
+        # 사후검정결과는 ANOVA가 유의할 때만 생성됨
+        if posthoc_df is not None:
+            print(posthoc_report)
+            print(posthoc_df.head())
+        ```
 
     Raises:
         ValueError: dv 또는 between 컬럼이 데이터프레임에 없을 경우.
@@ -2636,20 +2664,19 @@ def predict(fit, data: DataFrame | Series) -> DataFrame | Series | float:
         Exception: 데이터와 모형의 특성 불일치로 인한 predict 실패.
 
     Examples:
-        >>> import statsmodels.api as sm
-        >>> # 선형회귀 (상수항 자동 추가)
-        >>> X = sm.add_constant(df[['x1', 'x2']])
-        >>> y = df['y']
-        >>> fit_ols = sm.OLS(y, X).fit()
-        >>> pred = predict(fit_ols, df_new[['x1', 'x2']])  # DataFrame 반환
-
-        >>> # 로지스틱 회귀 (상수항 자동 추가)
-        >>> fit_logit = sm.Logit(y_binary, X).fit()
-        >>> pred_prob = predict(fit_logit, df_new[['x1', 'x2']])  # DataFrame 반환 (해석 포함)
-    """
-    from statsmodels.regression.linear_model import RegressionResultsWrapper
-    from statsmodels.discrete.discrete_model import BinaryResults
+        ```python
+        from hossam import *
+
+        df = hs_util.load_data("some_data.csv")
+        fit1 = hs_stats.ols(df, yname="target")
 
+        pred = hs_stats.predict(fit1, df_new[['x1', 'x2']])  # DataFrame 반환
+
+        # 로지스틱 회귀 (상수항 자동 추가)
+        fit2 = hs_stats.logit(df, yname="target")
+        pred_prob = hs_stats.predict(fit2, df_new[['x1', 'x2']])  # DataFrame 반환 (해석 포함)
+        ```
+    """
     # fit 객체의 타입 확인
     fit_type = type(fit).__name__
 
@@ -2724,158 +2751,6 @@ def predict(fit, data: DataFrame | Series) -> DataFrame | Series | float:
         )
 
 
-# ===================================================================
-# 확장된 기술통계량 (Extended Descriptive Statistics)
-# ===================================================================
-def describe(data: DataFrame, *fields: str, columns: list = None):
-    """데이터프레임의 연속형 변수에 대한 확장된 기술통계량을 반환한다.
-
-    각 연속형(숫자형) 컬럼의 기술통계량(describe)을 구하고, 이에 사분위수 범위(IQR),
-    이상치 경계값(UP, DOWN), 왜도(skew), 이상치 개수 및 비율, 분포 특성, 로그변환 필요성을
-    추가하여 반환한다.
-
-    Args:
-        data (DataFrame): 분석 대상 데이터프레임.
-        *fields (str): 분석할 컬럼명 목록. 지정하지 않으면 모든 숫자형 컬럼을 처리.
-        columns (list, optional): 반환할 통계량 컬럼 목록. None이면 모든 통계량 반환.
-
-    Returns:
-        DataFrame: 각 필드별 확장된 기술통계량을 포함한 데이터프레임.
-            행은 다음과 같은 통계량을 포함:
-
-            - count (float): 비결측치의 수
-            - mean (float): 평균값
-            - std (float): 표준편차
-            - min (float): 최소값
-            - 25% (float): 제1사분위수 (Q1)
-            - 50% (float): 제2사분위수 (중앙값)
-            - 75% (float): 제3사분위수 (Q3)
-            - max (float): 최대값
-            - iqr (float): 사분위 범위 (Q3 - Q1)
-            - up (float): 이상치 상한 경계값 (Q3 + 1.5 * IQR)
-            - down (float): 이상치 하한 경계값 (Q1 - 1.5 * IQR)
-            - skew (float): 왜도
-            - outlier_count (int): 이상치 개수
-            - outlier_rate (float): 이상치 비율(%)
-            - dist (str): 분포 특성 ("극단 우측 꼬리", "거의 대칭" 등)
-            - log_need (str): 로그변환 필요성 ("높음", "중간", "낮음")
-
-    Examples:
-        전체 숫자형 컬럼에 대한 확장된 기술통계:
-
-        >>> from hossam import summary
-        >>> import pandas as pd
-        >>> df = pd.DataFrame({
-        ...     'x': [1, 2, 3, 4, 5, 100],
-        ...     'y': [10, 20, 30, 40, 50, 60],
-        ...     'z': ['a', 'b', 'c', 'd', 'e', 'f']
-        ... })
-        >>> result = summary(df)
-        >>> print(result)
-
-        특정 컬럼만 분석:
-
-        >>> result = summary(df, 'x', 'y')
-        >>> print(result)
-
-    Notes:
-        - 숫자형이 아닌 컬럼은 자동으로 제외됩니다.
-        - 결과는 필드(컬럼)가 행으로, 통계량이 열로 구성됩니다.
-        - Tukey의 1.5 * IQR 규칙을 사용하여 이상치를 판정합니다.
-        - 분포 특성은 왜도 값으로 판정합니다.
-        - 로그변환 필요성은 왜도의 절댓값 크기로 판정합니다.
-    """
-    if not fields:
-        fields = data.select_dtypes(include=['int', 'int32', 'int64', 'float', 'float32', 'float64']).columns
-
-    # 기술통계량 구하기
-    desc = data[list(fields)].describe().T
-
-    # 추가 통계량 계산
-    additional_stats = []
-    for f in fields:
-        # 숫자 타입이 아니라면 건너뜀
-        if data[f].dtype not in [
-            'int',
-            'int32',
-            'int64',
-            'float',
-            'float32',
-            'float64',
-            'int64',
-            'float64',
-            'float32'
-        ]:
-            continue
-
-        # 사분위수
-        q1 = data[f].quantile(q=0.25)
-        q3 = data[f].quantile(q=0.75)
-
-        # 이상치 경계 (Tukey's fences)
-        iqr = q3 - q1
-        down = q1 - 1.5 * iqr
-        up = q3 + 1.5 * iqr
-
-        # 왜도
-        skew = data[f].skew()
-
-        # 이상치 개수 및 비율
-        outlier_count = ((data[f] < down) | (data[f] > up)).sum()
-        outlier_rate = (outlier_count / len(data)) * 100
-
-        # 분포 특성 판정 (왜도 기준)
-        abs_skew = abs(skew)
-        if abs_skew < 0.5:
-            dist = "거의 대칭"
-        elif abs_skew < 1.0:
-            if skew > 0:
-                dist = "약한 우측 꼬리"
-            else:
-                dist = "약한 좌측 꼬리"
-        elif abs_skew < 2.0:
-            if skew > 0:
-                dist = "중간 우측 꼬리"
-            else:
-                dist = "중간 좌측 꼬리"
-        else:
-            if skew > 0:
-                dist = "극단 우측 꼬리"
-            else:
-                dist = "극단 좌측 꼬리"
-
-        # 로그변환 필요성 판정
-        if abs_skew < 0.5:
-            log_need = "낮음"
-        elif abs_skew < 1.0:
-            log_need = "중간"
-        else:
-            log_need = "높음"
-
-        additional_stats.append({
-            'field': f,
-            'iqr': iqr,
-            'up': up,
-            'down': down,
-            'outlier_count': outlier_count,
-            'outlier_rate': outlier_rate,
-            'skew': skew,
-            'dist': dist,
-            'log_need': log_need
-        })
-
-    additional_df = DataFrame(additional_stats).set_index('field')
-
-    # 결과 병합
-    result = concat([desc, additional_df], axis=1)
-
-    # columns 파라미터가 지정된 경우 해당 컬럼만 필터링
-    if columns is not None:
-        result = result[columns]
-
-    return result
-
-
 # ===================================================================
 # 상관계수 및 효과크기 분석 (Correlation & Effect Size)
 # ===================================================================
@@ -2902,13 +2777,16 @@ def corr_effect_size(data: DataFrame, dv: str, *fields: str, alpha: float = 0.05
             - Effect_Size (str): 효과크기 분류 ('Large', 'Medium', 'Small', 'Negligible')
 
     Examples:
-        >>> from hossam import hs_stats
-        >>> import pandas as pd
-        >>> df = pd.DataFrame({'age': [20, 30, 40, 50],
-        ...                     'bmi': [22, 25, 28, 30],
-        ...                     'charges': [1000, 2000, 3000, 4000]})
-        >>> result = hs_stats.corr_effect_size(df, 'charges', 'age', 'bmi')
-        >>> print(result)
+        ```python
+        from hossam import *
+        from pandas import DataFrame
+
+        df = DataFrame({'age': [20, 30, 40, 50],
+                   'bmi': [22, 25, 28, 30],
+                   'charges': [1000, 2000, 3000, 4000]})
+
+        result = hs_stats.corr_effect_size(df, 'charges', 'age', 'bmi')
+        ```
     """
 
     # fields가 지정되지 않으면 수치형 컬럼 중 dv 제외 모두 사용