maps-visualizer

DWARF 모델이 생성한 규칙 파일(.py)을 받아
규칙 정렬 → 라벨 인코딩 변환 → HTML 트리 시각화 까지
세 단계를 자동으로 처리하는 패키지입니다.

설치

pip install maps-visualizer

빠른 시작

from maps_visualizer import DwarfVisualizer

column_dict = {
    "island": "Categorical",
    "bill_length_mm": "Numerical",
    "bill_depth_mm": "Numerical",
    "flipper_length_mm": "Numerical",
    "body_mass_g": "Numerical",
    "sex": "Categorical",
    "year": "Numerical",
    "Decision": "Decision",
}

viz = DwarfVisualizer(
    data_path   = "./data/penguins/5_fold/penguins_fold_1_train.csv",
    rule_path   = "./outputs/rules/penguins_C4.5_1_99.63.py",
    column_dict = column_dict,
    html_out    = "penguins_output.html",
)

viz.run()   # 전체 파이프라인 한 번에 실행

단계별 실행

viz.sort_rules()       # 1단계: Less_/Greater_ 구간 오름차순 정렬
viz.transform_rules()  # 2단계: 데이터 전처리 + 라벨 인코딩 + 규칙 치환
viz.visualize()        # 3단계: HTML 트리 시각화 생성

메서드 체이닝도 가능합니다:

viz.sort_rules().transform_rules().visualize()

파라미터

출력물

• <html_out> — 브라우저에서 바로 열 수 있는 인터랙티브 트리 HTML
• order_rule.py — 정렬된 규칙 파일 (중간 산출물)
• order_rule_viz.py — 인코딩 변환된 규칙 파일 (중간 산출물)
• <rule_name>_viz.csv — 시각화용 전처리 CSV (중간 산출물)

의존성

• pandas >= 1.5
• numpy >= 1.23
• scikit-learn >= 1.1
• supertree >= 0.3