# data/ — catálogo de estrelas: origem, modificações e licença

## Origem

**HYG Database v4.1** — David Nash / Astronexus.
Repositório: <https://github.com/astronexus/HYG-Database>
Licença do original: **Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)** — <https://creativecommons.org/licenses/by-sa/4.0/>

Aviso original, reproduzido de `data/raw/LICENSE` (o arquivo que acompanha a cópia do catálogo):

> This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

A cópia original (`data/raw/hygdata_v41.csv`, ~34 MB) fica fora do site publicado; só os derivados abaixo vão pro deploy.

## Modificações (material adaptado)

Os arquivos desta pasta NÃO são o catálogo original: foram gerados a partir dele pelos scripts `tools/build_catalog.py` e `tools/build_named_stars.py` (outubro de 2026).

**`stars.bin`** — 109.400 estrelas; Float32 little-endian, 5 valores por estrela (x, y, z, log10 L, log10 T).
- Filtro: mantidas só as linhas com `0 < dist < 99999` pc (o HYG usa 100000 pc pra paralaxe desconhecida) e `lum > 0`; linhas sem dist/lum/x/y/z numéricos são descartadas. O Sol sai (id 0; dist = 0).
- Coordenadas: equatoriais em parsecs (x, y, z do HYG) → galácticas em anos-luz (matriz J2000; 1 pc = 3,261563777 al).
- Luminosidade: `log10(lum)`, com `lum` em unidades solares como vem no HYG.
- Temperatura efetiva (campo que não existe no original): estimada de B−V (Ballesteros 2012) quando −0,4 < B−V < 2,5; senão pela letra do tipo espectral (O 35.000 K … M 3.400 K; padrão G 5.600 K).
- Removidos: todos os demais campos (identificadores HIP/HD/HR, nomes, magnitudes, movimento próprio, velocidade radial, constelação…).

**`stars_names.json`** — nome próprio das estrelas de `stars.bin` com `mag < 2,5` (índice → nome).

**`named_stars.json`** — estrelas com nome próprio OU designação Bayer com `mag < 4,0` (e `0 < dist < 99999` pc): nome, Bayer, constelação, HIP, tipo espectral, mag, distância em al, posição galáctica e geometria em relação à rota Terra → M16 (`along_ly`, `miss_ly`, campos calculados que não existem no original).

## Licença dos derivados

Estes derivados (`stars.bin`, `stars_names.json`, `named_stars.json`) são distribuídos sob a **mesma licença, CC BY-SA 4.0** — <https://creativecommons.org/licenses/by-sa/4.0/> — como exige a cláusula share-alike (§3(b)). Quem reutilizar deve manter a atribuição (HYG Database v4.1, David Nash / Astronexus, link acima), indicar as modificações feitas e licenciar o resultado sob CC BY-SA 4.0 ou licença compatível.

O código do site (`index.html`, `src/`) e os textos do diário de bordo não derivam do catálogo e não estão cobertos por esta nota.