Fração iluminada da Lua
Saiba quanto da face da Lua está iluminado pelo ângulo Sol-Lua-observador: com ângulo de fase de 90 graus brilha exatamente metade do disco, um quarto. Com 0 grau é lua cheia; com 180, lua nova. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Ângulo de fase
- 90
- Ângulo de fase (°)
- 90 deg
- Ângulo de fase (rad)
- 1,5707963268
- Cosseno do ângulo de fase
- 0
- Fração iluminada
- 0,5
A fração iluminada do disco lunar é a parte da face aparente da Lua iluminada pelo Sol vista da Terra. Observadores, fotógrafos e educadores costumam precisar dessa fração a partir de um ângulo de fase conhecido, e não de uma data de calendário. Esta calculadora da fração iluminada da Lua recebe o ângulo de fase i da geometria Sol–Lua–observador e devolve k igual a um mais o cosseno de i, tudo dividido por dois — a relação clássica dos textos de fotometria lunar e efemérides. A zero graus o disco está totalmente iluminado (lua cheia); a noventa graus metade do disco brilha (quarto); a cento e oitenta graus o lado noturno olha para a Terra (lua nova).
O que significa o ângulo de fase e como se define a fração iluminada
Na geometria lunar o ângulo de fase i é o ângulo na Lua entre as direções ao Sol e ao observador. Quando o Sol, a Lua e a Terra estão quase alinhados com a Terra no meio, i fica perto de zero e o lado próximo fica totalmente iluminado — lua cheia. Quando a Lua fica a cerca de noventa graus do Sol no céu, i é cerca de noventa graus e metade do disco está brilhante — primeiro ou último quarto.
Quando a Lua fica entre a Terra e o Sol, i se aproxima de cento e oitenta graus e o hemisfério noturno nos encara — lua nova. A fração iluminada clássica do disco aparente é k igual a (1 + cos i) / 2. Essa identidade decorre da área projetada de um corpo esférico: o terminador divide a esfera de modo que a porção iluminada do disco seja a metade de um mais o cosseno do ângulo de fase.
O resultado está sempre entre zero e um, inclusive. Esta capacidade avalia apenas essa fórmula; não converte datas civis em i, não corrige libração nem atmosfera e não modela o brilho da Terra. Se você já tem i de uma efeméride, de um propagador orbital ou de um problema de livro, obtém k imediatamente.
Se precisar do nome da fase ou da iluminação só a partir de uma data civil, use uma ferramenta de fase lunar por data — esta página cobre o passo de ângulo para fração que esses pipelines ainda precisam como função pura.
Para que serve saber a fração iluminada
Planejadores fotográficos e cadernos de exposição convertem ângulos de fase conhecidos em um fator de preenchimento para alvos de histograma e brackets HDR. Laboratórios de sala pedem aos alunos calcular k a partir de valores tabulados de i; um oráculo que rejeita ângulos fora da faixa ensina o domínio físico em vez de recortar em silêncio. Scripts de órbita e análise de missão já integram vetores solares e lunares e precisam apenas de k igual a (1 + cos i) / 2 para flags de iluminação do disco em relatórios.
Sites de conteúdo que ranqueiam por calculadora de fração iluminada da Lua se beneficiam de um caminho gratuito no navegador que coincide com a automação paga no mesmo módulo puro. A validação com falha não consome saldo. Mantenha as solicitações pequenas, fixe a fração arredondada nos testes e obtenha iluminação de disco reprodutível para educação, mídia e edge workers sem montar uma efeméride lunar completa só para avaliar um cosseno.
Casos de uso
Pós-processamento de efemérides
Transforme um ângulo de fase de qualquer efeméride lunar na fração iluminada do disco k = (1 + cos i) / 2 para painéis e relatórios.
Verificação em sala e deveres
Deixe os alunos enviarem i em graus ou radianos e verifiquem k, o percentual e os erros fora da faixa frente à geometria lunar do livro.
Fotografia e planejamento de exposição
Converta ângulos de fase conhecidos em frações de preenchimento para alvos de histograma, brackets HDR e listas de imagem lunar.
Perguntas frequentes
Esta calculadora usa a data ou a idade da Lua?
Não. Ela só avalia k a partir de um ângulo de fase dado. Para fase a partir de uma data civil, use uma ferramenta separada de fase lunar por data e, se precisar só da fórmula da fração, passe i aqui.
O que é o ângulo de fase da Lua?
É o ângulo medido na Lua entre a direção do Sol e a direção do observador. Um ângulo pequeno indica que a face voltada para você está iluminada; um grande, que está quase toda escura.
Quanto da Lua fica iluminado com ângulo de fase de 90 graus?
Exatamente metade, uma fração iluminada de 0,5, ou 50 %. É o quarto crescente ou minguante, quando a Lua está a cerca de noventa graus do Sol no céu.
Qual ângulo de fase corresponde à lua cheia e qual à lua nova?
Com 0 grau o disco fica totalmente iluminado: lua cheia. Com 180 graus o lado noturno fica voltado para a Terra e nada aparece iluminado: lua nova.
Posso informar o ângulo em radianos?
Sim. O padrão é graus, mas você pode escolher radianos. O ângulo precisa ficar entre 0 e 180 graus, ou entre 0 e pi em radianos.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/astro/moon-illumination-fraction \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"phase_angle":90}'const res = await fetch("https://api.kit.forhosting.com/astro/moon-illumination-fraction", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"phase_angle": 90
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/astro/moon-illumination-fraction",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"phase_angle": 90
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/astro/moon-illumination-fraction", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"phase_angle":90}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"phase_angle":90}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/astro/moon-illumination-fraction", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"phase_angle": 90
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "astro.moon_illumination_fraction",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Ângulos fora do intervalo físico são rejeitados com invalid_input para que a automação nunca trate uma geometria impossível como um zero silencioso.
Contrato de entrada, unidades, faixas e forma da resposta
Ângulos ausentes, em branco ou não finitos também falham. Os números são arredondados a doze casas decimais para goldens estáveis entre runtimes. Envie por POST um corpo JSON com phase_angle, um número finito, e opcionalmente unit igual a deg (padrão) ou rad. Os aliases i, phase, angle e phase_angle_deg são aceitos para o campo do ângulo. Quando unit é deg, phase_angle deve ficar no intervalo fechado de zero a cento e oitenta; quando unit é rad, no intervalo fechado de zero a π. Valores abaixo do limite inferior ou acima do superior falham com invalid_input e uma mensagem que nomeia a condição fora da faixa — essas falhas não são cobradas. Em sucesso o corpo ecoa phase_angle e phase_angle_deg em graus, phase_angle_rad em radianos, a unidade usada, cos_phase_angle, illuminated_fraction k na forma de zero a um, illuminated_percent como cem vezes k, um phase_hint grosso (full, gibbous, quarter, crescent ou new), a string da fórmula, uma equação substituída e uma mensagem curta. Exemplo: phase_angle noventa com unit deg produz illuminated_fraction zero vírgula cinco e illuminated_percent cinquenta, coerente com um quarto geométrico. Combine a fração com o seu próprio modelo de magnitude ou exposição se precisar de brilho aparente; este endpoint para na fração geométrica do disco.
Onde uma API de fração iluminada por ângulo de fase vale a pena
Planetários e sites de divulgação exibem widgets ao vivo de «quanto da Lua está iluminada» quando uma efeméride já produziu i; chamar uma pequena API de parse evita reimplementar a fórmula do cosseno em cada linguagem de front-end. Como a implementação é parse puro tier A, cada chamada bem-sucedida custa o preço base publicado US$ 0,002 sem tokens de modelo e sem rede de saída.
Perguntas técnicas
Como calcular a fração iluminada da Lua a partir do ângulo de fase?
Envie phase_angle i (0–180° por padrão, ou 0–π rad com unit rad). A API devolve k = (1 + cos i) / 2 como illuminated_fraction e illuminated_percent.
Qual é a faixa permitida para phase_angle?
Com unit deg (padrão): de 0 a 180 inclusive. Com unit rad: de 0 a π inclusive. Valores fora dessa faixa falham com invalid_input e não são cobrados.
O que significam phase_angle 0°, 90° e 180°?
0° → lua cheia (k = 1); 90° → quarto geométrico (k = 0.5); 180° → lua nova (k = 0). Valores intermediários dão frações gibosas ou crescentes.
Quanto custa a calculadora da fração iluminada da Lua?
A ferramenta do navegador é gratuita. Solicitações API usam saldo pré-pago KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.