KOIIAAI Ready Data 처음으로

홈›활용 사례›도시가스 유효일수 시계열 구성

시계열검증 완료

도시가스 유효일수 시계열 구성

질문 날짜마다 도시가스 수요가 평일 대비 어느 수준인지(요일 · 공휴일 효과)를 수요예측 모델에 별도 처리 없이 활용할 수 있는가?

원천 6종 · 1개 기관 · 연결 기준 날짜 · 용도

한국가스공사 일별 · 월별 원천 6종을 한 체계로 통일하고, 시간 순서대로 학습 · 검증 · 평가 구간을 분할했습니다.

6원천 데이터일별 3종 · 월별 3종
50,403일별 행1985~2030 · 용도 3가지
522개월일별 합계 = 월별 원천최대 차이 0.005
5,547행예측 구간 별도 표시관측값이 아닌 달력 산정값

지금 선택 2/9(금)~2/12(월) · 발전용 최저 -35% · 주요 변동 사례

주요 변동 사례 결과 보기

팩 데이터에서 찾은 변동 사례 15건입니다.
탐지 규칙평가 구간 관측일 가운데 같은 해 같은 요일 중앙값보다 10% 이상 낮은 날이 이틀 이상 계속되거나(2일 간격 허용), 하루라도 25% 이상 낮은 날. 판정 문장은 측정값으로 만든 규칙 문장이며 원인을 단정하지 않습니다.
달력 요인
선택 상태날짜 = 2024-02-09~2024-02-12월 = 2024-02 현재 선택의 주소
  1. 변화 내용

    2024-02-09 ~ 2024-02-12(4일): 발전용 유효일수가 같은 해 같은 요일보다 최대 35% 낮았습니다. 이 기간은 평가 구간입니다.

    2024-02-09 앞뒤 10일 · 용도별 일 유효일수(파란 띠 = 사건 기간)
    표로 보기
    날짜민수용산업용발전용
    01/301.005281.005281.00024
    01/311.005281.005281.00024
    02/011.005281.005281.00024
    02/021.005281.005281.00024
    02/030.97210.837920.94077
    02/040.954110.718290.85285
    02/051.005180.943990.96609
    02/061.005281.005281.00024
    02/071.005281.005281.00024
    02/081.005281.005281.00024
    02/091.005281.005280.73888
    02/100.97210.837920.60661
    02/110.954110.718290.61417
    02/121.005180.943990.68493
    02/131.005281.005280.91905
    02/141.005281.005281.00024
    02/151.005281.005281.00024
    02/161.005281.005281.00024
    02/170.97210.837920.94069
    02/180.954110.718290.85285
    02/191.005180.943990.96609
    02/201.005281.005281.00024
    02/211.005281.005281.00024
    02/221.005281.005281.00024
  2. 변화 요인

    연결 기준날짜용도

    달력 요인: 용도별 반응이 다릅니다. 민수용 0%, 산업용 0%, 발전용 -35%(같은 해 같은 요일 중앙값 대비 최저). 민수용 · 산업용은 거의 변화가 없습니다. 팩에 이 차이가 날짜 · 용도별 값으로 포함되어 있어 공휴일 표를 별도로 작성할 필요가 없습니다.

    용도별 최저 하락률(같은 해 같은 요일 중앙값 대비, %)
    표로 보기
    구분%
    민수용0
    산업용0
    발전용35.5
  3. 같은 기준으로 연결된 값

    연결 기준날짜 → 월

    일 값을 월로 더하면 달력 효과가 월 합계에 그대로 드러납니다. 2024-02와 1년 전 같은 달을 비교합니다(공휴일이 다른 달로 옮겨 가면 차이가 커집니다).

    표 보기
    용도2024-02 합계2023-02 합계차이
    민수용28.8227.811.01
    산업용27.0926.091.01
    발전용26.8527.05-0.2
  4. 팩 안의 근거 행

    연결 기준datesectorsource_row_uid
    근거 행 · 코드 보기
    날짜용도유효일수평소 대비source_row_uid
    2024-02-09민수용1.005280%14283_69153097
    2024-02-09산업용1.005280%14283_737e9a1f
    2024-02-09발전용0.73888-26%14283_412088fd
    2024-02-10민수용0.97210%14284_a8ecccde
    2024-02-10산업용0.837920%14284_2dd83661
    2024-02-10발전용0.60661-35%14284_762e1d2f
    2024-02-11민수용0.954110%14285_d5aad5f1
    2024-02-11산업용0.718290%14285_011f338d
    2024-02-11발전용0.61417-28%14285_6f9144c8
    2024-02-12민수용1.005180%14286_32acd681
    2024-02-12산업용0.943990%14286_5d62ee45
    2024-02-12발전용0.68493-29%14286_5c1229bd
    import pandas as pd
    d = pd.read_csv("data/daily_effective_days.csv")
    d[(d.date >= "2024-02-09") & (d.date <= "2024-02-12")].pivot(index="date", columns="sector", values="effective_day")

    재현: 팩 압축 해제 폴더의 data/daily_effective_days.csv

  5. 원본 파일로 처리할 때

    원천 파일로 같은 결론을 얻으려면 필요한 작업

    • 일별 원천 3종(민수 · 산업 · 발전)의 날짜 형식과 용도 이름 통일
    • 요일 · 연휴마다 평소 수준을 직접 계산하여 하락 구간 탐지
    • 원천 공개일 이후 날짜(사전 산정한 값) 별도 구분

    이 팩에서는

    • daily_effective_days 표 1개에 날짜 · 용도 · 값 · 분할 포함
    • 왼쪽 코드 3줄로 이 기간의 값 재산출 가능
    • 예측 구간(is_future)이 사전 표시되어 평가에서 제외 가능

    이 팩으로 확인할 수 없는 것: 이 팩에는 공휴일 이름이 포함되어 있지 않습니다. 어떤 공휴일 · 연휴인지는 달력으로 확인해야 하며, 용도별 반응 차이의 원인은 원천 기관의 산정 방식에 있습니다.

조건별 탐색 결과 보기

자동 요약은 규칙 기반 문장입니다(생성형 AI 미사용).

불러오는 중…

요약 차트

팩으로 집계한 결과 · 펼치기
불러오는 중…

AI Ready Data(AIRD) 처리 내용

  1. 01 통일월별 「총발전량」 ↔ 일별 「발전용」 대응
  2. 02 대조일별을 월로 더해 월별 원천과 비교
  3. 03 분할시간 기준 분할 · 미래 날짜 분리
원본으로 받을 때와 비교 · 시간 순서대로 분할한 구간 자세히
원본을 내려받으면 직접 처리해야 하는 작업이 팩에서는
일별 · 월별 원천의 용도 이름 대응 관계 직접 확인「총발전량」 = 「발전용」으로 대응(일별 합계로 확인)
미래 날짜 값의 관측값 혼재 여부 확인 불가is_future 표시, 예측 구간 5,547행 분리
일별 값과 월별 공식 값의 일치 여부 확인522개월 모두 0.01 이내로 일치
학습 · 평가 구간 지정split 열로 제공

시간 순서대로 분할한 구간

  • 학습 1985~2018 37,254행 · 73.9%
  • 검증 2019~2021 3,288행 · 6.5%
  • 평가 2022~2025-12 4,314행 · 8.6%
  • 예측 구간 원천 공개일(2025-12-08) 이후 5,547행 · 11.0%

무작위 분할 대신 시간 순서로 분할하여, 과거 데이터로 미래를 예측하는 실제 조건을 재현합니다.

효과 근거 · 점검

원천의 용도 이름이 일별 · 월별로 달라 원본 그대로 연결하면 3개 용도 중 2개만 일치합니다. 팩은 「총발전량 = 발전용」을 일별 합계로 확인(522개월 모두 0.01 이내)하여 3개를 모두 연결하고, 원천 공개일 이후의 산정값은 학습 · 평가에서 제외했습니다.

효과 판단 근거: 용도 결합: 원본 이름 그대로 2/3 → AIRD 3/3, 522개월 대조 일치

점검 6항목 · 통과 6 항목별 결과 보기
점검 항목결과값
표준 필수 메타데이터와 목적별 필수 항목통과모두 기재
원천이 모두 품질 확인 단계통과Quality-Ready
행마다 원천 추적 가능통과100%
같은 대상 · 같은 시점 중복통과0건
측정값 빈 값통과0건
일별 합계와 월별 원천 일치통과일치

받아서 쓰기 실험 재현

팩 zip 하나를 내려받아 엑셀이나 분석 도구로 열 수 있습니다 — 팩 내려받기 1.3 MB. 코드나 AI 에이전트로 활용하는 방법은 아래에서 설명합니다.

코드 · AI 에이전트로 쓰기 개발자용

코드로

  1. 팩 내려받기 gas-effective-days-Stats-1.0.0.zip 1.3 MB
  2. 압축을 풀고 폴더로 이동
    cd gas-effective-days-Stats
  3. 필요한 패키지 설치 팩의 guide/requirements.txt
    pip install pandas==2.3.3 pyarrow==25.0.1
  4. 실행
    import pandas as pd
    d = pd.read_csv("data/daily_effective_days.csv", parse_dates=["date"])
    train = d[d.split == "train"]
    future = d[d.split == "forecast_horizon"]  # 예측 입력으로만 사용
  5. 실행 결과
    d: 50,403행 × 7열
    train: 37,254행 × 7열
    future: 5,547행 × 7열

    실행 환경: Python 3.13.16 · pandas 2.3.3 · pyarrow 25.0.1

추가 예시: guide/notebook.ipynb

AI 에이전트로

  1. AIRD 서버 연결 Claude Code 기준 · 다른 도구는 연결 방법
    claude mcp add --transport http aird https://aird.idx.or.kr/mcp
  2. 질문 예시

    「날짜마다 도시가스 수요가 평일 대비 어느 수준인지(요일 · 공휴일 효과)를 수요예측 모델에 별도 처리 없이 활용할 수 있는가?」

  3. 에이전트가 사용하는 도구 get_pack

    팩 정보 · 내려받기 주소 · 무결성 값 · 변동 사례와 그 근거 질의를 반환합니다. 행 단위 분석은 내려받은 팩으로 수행합니다.

  4. 답변 보기

    이 도구 호출 →

팩에 포함된 파일

CSV 2종(일별 · 월별) · 1.3 MB

파일 목록 2개 + 설명 · 검증 파일 4개 보기
데이터 파일대상크기형식
data/daily_effective_days민수용 · 산업용 · 발전용 일별 유효일수를 단일 표로 통합50,403행 · 7열CSVPARQUET
data/monthly_effective_days월별 유효일수: 「총발전량」을 일별 「발전용」에 대응522행 · 5열CSVPARQUET

설명 · 검증 파일

  • 표준 메타데이터 · 파일별 무결성 값(manifest.json)
  • 목적 적합성 판정(G3) · 점검 결과
  • 시작 노트북(guide/)
  • README(만든 방법 · 한계)

팩 zip 무결성 값(SHA-256) e9f4b38680d5eed343b71e371158ffa274d639d61323f7fc776608c6709894d9

이 팩을 만든 원천 6종

원천 목록 6종 데이터 · 기관 · 포함된 행 보기
원천 데이터기관팩에 포함된 행
daily_effective_days 민수용 · 산업용 · 발전용 일별 유효일수를 단일 표로 통합
한국가스공사_도시가스 민수용 일별 유효일수 이 선택한국가스공사16,801행
한국가스공사_도시가스 산업용 일별 유효일수 이 선택한국가스공사16,801행
한국가스공사_발전용 일별 유효일수 이 선택한국가스공사16,801행
monthly_effective_days 월별 유효일수: 「총발전량」을 일별 「발전용」에 대응
한국가스공사_도시가스 민수용 월별 유효일수한국가스공사174행
한국가스공사_도시가스 산업용 월별 유효일수한국가스공사174행
한국가스공사_총발전량 월별 유효일수한국가스공사174행

이 팩으로 가능한 분석

수요 예측의 보조 자료

보유한 일별 수요 데이터에 날짜 기준으로 결합하여 요일 · 공휴일 효과를 반영할 수 있습니다(예: 산업용 일요일 평균 0.712).

용도별 비교

같은 날짜의 민수 · 산업 · 발전 유효일수를 나란히 비교할 수 있습니다.

주요 변동 사례에서 근거와 함께 보기 →

유의점 수요량 자체는 포함하지 않습니다. 공개 시점 이후 날짜의 값은 관측값이 아닌 달력 기준 산정값입니다.