별자리 탐험기 (Constellation Explorer)

3D 공간에서 별자리를 다양한 각도로 관찰할 수 있는 웹 애플리케이션입니다.

주요 기능

• 88개 공식 IAU 별자리 시각화
• 3D 회전 및 확대/축소 - 마우스로 자유롭게 별자리를 회전하고 관찰
• 실제 천문 데이터 - HYG Database의 실제 별 좌표 사용
• 정확한 별자리 패턴 - index.json의 공식 IAU 별자리 라인 데이터 사용
• TypeScript - 타입 안정성과 더 나은 개발 경험

기술 스택

• TypeScript - 타입 안전성
• Three.js - 3D 렌더링
• esbuild - 빠른 번들링
• HYG Database v4.1 - 실제 천문 데이터
• IAU Constellation Patterns - 공식 별자리 패턴

프로젝트 구조

constellationExplorer/
├── src/
│   ├── types.ts              # TypeScript 타입 정의
│   ├── app.ts                # 메인 애플리케이션 (브라우저)
│   └── convertCSVtoJSON.ts   # 데이터 변환 스크립트 (Node.js)
├── dist/
│   └── app.js                # 컴파일된 JavaScript
├── hygdata_v41.csv           # HYG 별 데이터베이스
├── index.json                # IAU 별자리 패턴 정의
├── constellations_data.json  # 생성된 별자리 데이터
├── index.html                # 메인 HTML
├── tsconfig.json             # TypeScript 설정
└── package.json              # npm 패키지 설정

설치 및 실행

1. 의존성 설치

npm install

2. 데이터 변환 (필요시)

npm run convert

이 명령은 hygdata_v41.csv와 index.json을 읽어서 constellations_data.json을 생성합니다.

3. TypeScript 빌드

npm run build

또는 개발 중 자동 빌드:

npm run build:watch

4. 웹 서버 실행

브라우저에서 index.html을 열거나, 로컬 웹 서버를 사용하세요:

# Python을 사용하는 경우
python3 -m http.server 8000

# Node.js http-server를 사용하는 경우
npx http-server

그런 다음 브라우저에서 http://localhost:8000을 열어주세요.

사용 방법

1. 별자리 선택: 왼쪽 패널에서 별자리를 검색하거나 선택
2. 회전: 마우스 드래그로 별자리를 회전
3. 확대/축소: 마우스 스크롤로 확대/축소

개발 스크립트

# TypeScript 빌드
npm run build

# TypeScript 빌드 (watch 모드)
npm run build:watch

# 데이터 변환 스크립트 실행
npm run convert

# TypeScript 타입 체크
npm run type-check

데이터 소스

• HYG Database v4.1: 119,000+ 별의 실제 천문 데이터
• IAU Constellation Patterns: 88개 공식 별자리의 라인 패턴
• Hipparcos Catalog: 별 식별을 위한 HIP ID 사용

별자리 데이터 통계

• 총 별자리: 88개
• 총 별 개수: ~730개 (패턴에 사용되는 별만)
• 데이터 파일 크기: ~120KB
• 정확한 별자리 패턴: IAU 공식 정의 사용

예시

• 황소자리: 12개 별
• 오리온자리: 21개 별
• 큰곰자리: 18개 별

라이선스

ISC

기여

이슈 및 풀 리퀘스트는 환영합니다!