경제 원자료 시계열 차트

공개 호출 방식

import dartlab
from dartlab.viz import emitChart

indicator = "FEDFUNDS"
df = dartlab.gather("macro", indicator)

rows = []
if df is not None and len(df) > 0:
    recent = df.tail(60)
    dates = [str(v)[:10] for v in recent.get_column("date").to_list()]
    values = [float(v) for v in recent.get_column("value").to_list() if v is not None]
    rows = [{"date": d, "value": v} for d, v in zip(dates[-len(values):], values)]

if rows:
    emitChart({
        "chartType": "line",
        "title": f"{indicator} 최근 추이",
        "categories": [row["date"] for row in rows],
        "series": [{"name": indicator, "data": [row["value"] for row in rows]}],
        "evidenceIds": [f"gather:macro:{indicator}"],
    })

emit_result(
    table=rows,
    values={"indicator": indicator, "points": len(rows), "latest": rows[-1]["value"] if rows else None},
    date=rows[-1]["date"] if rows else None,
)

호출 동작

1. dartlab.gather("macro", indicator) 로 원자료 시계열을 가져온다.
2. UI 과부하를 막기 위해 최근 60개 관측치만 차트화한다.
3. emitChart 에 chartType, categories, series, evidenceIds 를 넣어 stdout 마커를 낸다.
4. emit_result 에 같은 rows를 tableRef 로 남겨 차트와 표가 같은 근거를 공유하게 한다.

대표 반환 형태

• chartSpec: line chart.
• tableRef: date/value rows.
• valueRef: indicator, points, latest.
• dateRef: 최신 관측일.

연계 절차

1. 금리곡선이면 recipes.macro.yieldCurveStress 로 해석한다.
2. 물가 계열이면 recipes.macro.inflationBreadthWatch 로 확산성을 확인한다.
3. 차트가 필요한 모든 gather-first recipe에서 이 패턴을 재사용한다.

기본 검증

• rows 가 비어 있으면 차트를 emit 하지 않는다.
• evidenceIds 는 반드시 gather:macro:{@html String.fromCharCode(123)}indicator{@html String.fromCharCode(125)} 형식으로 남긴다.
• 차트와 emit_result.table 의 행이 같은 원자료에서 나온 것인지 확인한다.