Repolode
gunerguner

gunerguner/AdAstra

장소와 시간에 따른 밤하늘을 브라우저에서 재현하는 오프라인 지원 인터랙티브 웹 앱입니다.

대체할 수 있는 제품:Stellarium

스타
138
포크
13
열린 이슈
0
마지막 커밋
7일 전

어떤 프로젝트인가요?

Ad Astra는 브라우저에서 실행되는 천체 시뮬레이터입니다. 미리 설정된 도시 목록에서 관측 장소를 고르거나 위도와 경도를 직접 입력하고, 시간을 지정하면 됩니다. 앱은 지구의 자전과 공전에 따라 바뀌는 지역의 하늘을 그려 줍니다. 밝은 별과 별자리 선, 태양, 달, 수성부터 해왕성까지의 행성을 볼 수 있습니다.

화면을 드래그하거나 확대·축소할 수 있고, 동서남북이나 천정 방향으로 바로 이동할 수도 있습니다. 타임라인에서 약 8시간의 흐름을 재생하거나 일시 정지하고 원하는 시점으로 이동할 수 있으며, 시간·일·년·십 년·세기 단위로 앞뒤로 건너뛸 수 있습니다. 은하수, 황도, 천구 적도, 좌표 격자 등의 레이어를 켜고 끌 수 있고, 하늘 색은 낮과 박명, 밤에 따라 달라집니다. 프로덕션 빌드에는 Service Worker가 포함되어 있어 처음 로드한 뒤에는 오프라인에서도 열 수 있습니다.

이 프로젝트는 별자리와 낮밤의 주기를 배우기 위한 대중 과학 시뮬레이션으로, 전문적인 관측이나 항법용은 아닙니다. 런타임 백엔드가 없는 정적 프런트엔드이며, React, TypeScript, WebGL2를 사용하는 Three.js, Web Worker에서 실행되는 Astronomy Engine으로 만들었습니다.

핵심 기능

  • 01선택한 장소와 시간에 따른 밝은 별, 별자리 선, 태양, 달, 행성을 표시합니다.
  • 02도시 프리셋을 사용하거나 위도와 경도를 직접 입력할 수 있습니다.
  • 03타임라인 재생 속도는 실시간부터 초당 100년까지 지원합니다.
  • 04은하수, 황도, 좌표 격자 등의 레이어를 켜고 끌 수 있습니다.
  • 05박명의 단계에 따라 하늘 색과 별의 가시성이 태양의 고도를 반영합니다.
  • 06Service Worker를 통해 처음 로드한 뒤 오프라인에서도 사용할 수 있습니다.

활용 사례

  • 별자리와 계절에 따른 위치를 알아봅니다.
  • 낮과 밤, 박명에 따라 하늘이 어떻게 달라지는지 이해합니다.
  • 특정 장소와 날짜에 하늘이 어떤 모습이었는지 살펴봅니다.
  • 교실이나 과학 대중화 행사에서 지구의 자전과 공전이 관측되는 하늘에 미치는 영향을 보여 줍니다.

빠른 시작

  1. 1

    저장소를 클론합니다

    git clone https://github.com/gunerguner/AdAstra.git
  2. 2

    프로젝트 폴더로 이동합니다

    cd AdAstra
  3. 3

    종속성을 설치합니다

    pnpm install --frozen-lockfile
  4. 4

    개발 서버를 시작하고 로컬 URL을 엽니다

    pnpm dev

사용 전 알아둘 점

  • 이 앱은 과학 대중화를 위한 시뮬레이션으로, 전문적인 관측, 항법 또는 연구에는 적합하지 않습니다.
  • Node.js 20.19+ 또는 22.12+, pnpm 10, WebGL2를 지원하는 브라우저가 필요합니다.
  • 메타데이터에 라이선스가 표시되어 있지 않아 README에 MIT라고 명시되어 있어도 재사용 조건은 불분명합니다.

토픽

자주 묻는 질문

AdAstra은(는) 무엇인가요?
장소와 시간에 따른 밤하늘을 브라우저에서 재현하는 오프라인 지원 인터랙티브 웹 앱입니다. Ad Astra는 브라우저에서 실행되는 천체 시뮬레이터입니다. 미리 설정된 도시 목록에서 관측 장소를 고르거나 위도와 경도를 직접 입력하고, 시간을 지정하면 됩니다. 앱은 지구의 자전과 공전에 따라 바뀌는 지역의 하늘을 그려 줍니다. 밝은 별과 별자리 선, 태양, 달, 수성부터 해왕성까지의 행성을 볼 수 있습니다.
AdAstra은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
AdAstra에는 명시된 라이선스가 없습니다. 코드는 공개되어 있지만 라이선스가 없으면 재사용 허가가 명확하지 않으므로, 사용 전에 작성자에게 문의하는 것이 좋습니다.
AdAstra은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. AdAstra의 마지막 커밋은 2026년 10월 13일입니다.
AdAstra은(는) 어디에 사용할 수 있나요?
별자리와 계절에 따른 위치를 알아봅니다. 낮과 밤, 박명에 따라 하늘이 어떻게 달라지는지 이해합니다. 특정 장소와 날짜에 하늘이 어떤 모습이었는지 살펴봅니다. 교실이나 과학 대중화 행사에서 지구의 자전과 공전이 관측되는 하늘에 미치는 영향을 보여 줍니다.
AdAstra는 어떻게 설치하나요?
저장소를 클론합니다: git clone https://github.com/gunerguner/AdAstra.git 프로젝트 폴더로 이동합니다: cd AdAstra 종속성을 설치합니다: pnpm install --frozen-lockfile 개발 서버를 시작하고 로컬 URL을 엽니다: pnpm dev
AdAstra은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/gunerguner/AdAstra

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트