JNU_helicorder_status

본 프로젝트는 충청·전라 내륙 지진관측소의 파형 데이터를 활용하여 일일 자동 헬리코더(Helicorder) 시각화 시스템을 구축하는 것을 목표로 합니다.

---

✨ Features

• 지정 경로 내 다수의 지진파형(MSEED Format) 자동 탐색 및 시각화
• HTML 기반 Interactive Helicorder 생성 (날짜별·관측소별 검색 지원)
• 진폭 임계값 초과 시 빨간 선으로 시각적 강조
• uv 또는 conda 환경에서 간편한 설치 및 실행 지원

---

📦 Installation

1. Using uv

uv는 빠르고 가벼운 Python 패키지 및 가상환경 관리 도구입니다.

# uv 설치
curl -LsSf https://astral.sh/uv/install.sh | sh

# 저장소 Clone
git clone https://github.com/1epss/JNU_helicorder_status.git
cd JNU_helicorder_status

# Python 3.12.3 설치
uv python install 3.12.3

# 가상환경 및 프로젝트 의존성 설치
uv sync

2. Using Conda

conda 환경에서도 uv를 함께 사용할 수 있습니다.

# conda 환경 생성
conda create -n jnu-helicorder-status python=3.12.3 -y
conda activate jnu-helicorder-status

# uv 설치
pip install uv

# 프로젝트 의존성 설치
uv sync --no-venv

---

🚀 Usage

가상환경을 활성화한 후 다음 명령으로 실행합니다.

# uv를 이용한 실행
uv run python draw_helicorder_v2.py

또는

# uv 가상환경을 수동 활성화 후 실행
source .venv/bin/activate
python draw_helicorder_v2.py

실행 결과:

• 실행 후 plots/ 내 helicorder_<Station>_<YYYYmmdd0000>_<Component>.png 파일이 생성됩니다.

---

🧩 Scripts

plot_helicorder.py

• 지정 경로 내 저장된 지진파형(MSEED Format)으로부터 일일 Helicorder 이미지 자동 생성
• 실행일 기준 이전 날짜 의 데이터를 불러와 처리
• --date 옵션을 통해 특정 날짜(YYYYMMDD 형식)를 지정 가능
• 관측소별 진폭 스케일(station_scale) 및 진폭 임계값(threshold_raw)을 설정 가능
• 출력 이미지는 helicorder_<STATION>_<YYYYMMDD>0000_<CHANNEL>.png 형식으로 저장됨

---

plot_ppsd.py

• WIP

---

helicorder_one_station.html

• 특정 관측소명, 날짜 범위, 성분(Z/N/E)을 기준으로 경로 내 Helicorder 이미지 검색
• 검색 결과로 표시된 그래프는 클릭 시 새 창에서 원본 이미지로 열리며, 저장 가능

---

helicorder_all_stations.html

• 특정 날짜를 기준으로 모든 관측소의 Helicorder 이미지 검색
• 검색 결과로 표시된 그래프는 클릭 시 새 창에서 원본 이미지로 열리며, 저장 가능

---

🧾 License

이 프로젝트는 MIT 라이선스에 따라 배포됩니다. 자세한 내용은 LICENSE 파일을 참고하세요.