ForHosting KIT · Ciencia

Fracción iluminada de la Luna

Sepa cuánto de la cara de la Luna está iluminado a partir del ángulo Sol-Luna-observador: con un ángulo de fase de 90 grados brilla justo la mitad del disco, un cuarto. Con 0 grados es luna llena; con 180, luna nueva. Gratis en su navegador.

  • Gratis
  • Funciona en su navegador
  • Sin registro
  • Sus datos no salen de su equipo
Úselo desde WebAPIEmailTelegramApp pronto
Si escribe
Ángulo de fase
90
Obtiene
Ángulo de fase (°)
90 deg
Ángulo de fase (rad)
1,5707963268
Coseno del ángulo de fase
0
Fracción iluminada
0,5

La fracción iluminada del disco lunar es la porción de la cara aparente de la Luna que el Sol ilumina vista desde la Tierra. Observadores, fotógrafos y docentes suelen necesitar esa fracción a partir de un ángulo de fase conocido, no de una fecha de calendario. Esta calculadora de fracción iluminada de la Luna toma el ángulo de fase i de la geometría Sol–Luna–observador y devuelve k igual a uno más el coseno de i, todo entre dos: la relación clásica de los textos de fotometría lunar y efemérides. A cero grados el disco está totalmente iluminado (plenilunio); a noventa grados la mitad del disco brilla (cuarto); a ciento ochenta grados la cara nocturna mira a la Tierra (novilunio).

Qué significa el ángulo de fase y cómo se define la fracción iluminada

En geometría lunar el ángulo de fase i es el ángulo en la Luna entre las direcciones al Sol y al observador. Cuando el Sol, la Luna y la Tierra están casi alineados con la Tierra en el medio, i ronda cero y la cara cercana queda totalmente iluminada: plenilunio. Cuando la Luna se sitúa a unos noventa grados del Sol en el cielo, i es de unos noventa grados y la mitad del disco brilla: cuarto creciente o menguante.

Cuando la Luna queda entre la Tierra y el Sol, i se acerca a ciento ochenta grados y el hemisferio nocturno nos mira: novilunio. La fracción iluminada clásica del disco aparente es k igual a (1 + cos i) / 2. Esa identidad se deduce del área proyectada de un cuerpo esférico: el terminador divide la esfera de modo que la porción soleada del disco es la mitad de uno más el coseno del ángulo de fase.

El resultado está siempre entre cero y uno, extremos incluidos. Esta capacidad evalúa solo esa fórmula; no convierte fechas de calendario en i, no corrige libración ni atmósfera y no modela el resplandor terrestre. Si ya dispone de i desde una efeméride, un propagador orbital o un problema de libro, obtiene k de inmediato.

Si necesita el nombre de la fase o la iluminación solo a partir de una fecha civil, use una herramienta de fase lunar por fecha: esta página cubre el paso de ángulo a fracción que esas tuberías aún requieren como función pura.

Para qué sirve conocer la fracción iluminada

Los planificadores fotográficos y los cuadernos de exposición convierten ángulos de fase conocidos en un factor de relleno para objetivos de histograma y brackets HDR. Los laboratorios de aula piden al alumnado calcular k a partir de valores tabulados de i; un oráculo que rechaza ángulos fuera de rango enseña el dominio físico en lugar de recortar en silencio.

Los scripts de órbita y análisis de misión ya integran vectores solares y lunares y solo necesitan k igual a (1 + cos i) / 2 para marcas de iluminación del disco en informes. Los sitios de contenido que posicionan por calculadora de fracción iluminada de la Luna se benefician de una ruta gratuita en el navegador que coincide con la automatización de pago sobre el mismo módulo puro. La validación fallida no consume saldo.

Mantenga las solicitudes pequeñas, fije la fracción redondeada en las pruebas y obtendrá iluminación de disco reproducible para educación, medios y edge workers sin montar una efeméride lunar completa solo para evaluar un coseno.

Postprocesado de efemérides

Convierta un ángulo de fase de cualquier efeméride lunar en la fracción iluminada del disco k = (1 + cos i) / 2 para paneles e informes.

Comprobación de clase y deberes

Permita que el alumnado envíe i en grados o radianes y verifique k, el porcentaje y los errores fuera de rango frente a la geometría lunar del libro.

Fotografía y planificación de exposición

Convierta ángulos de fase conocidos en fracciones de relleno para objetivos de histograma, brackets HDR y listas de imagen lunar.

¿Esta calculadora usa la fecha o la edad de la Luna?

No. Solo evalúa k a partir de un ángulo de fase dado. Para la fase desde una fecha civil, use una herramienta aparte de fase lunar por fecha y, si necesita solo la fórmula de la fracción, pase i aquí.

¿Qué es el ángulo de fase de la Luna?

Es el ángulo medido en la Luna entre la dirección al Sol y la dirección al observador. Un ángulo pequeño indica que la cara que usted ve está iluminada; uno grande, que está casi a oscuras.

¿Cuánta Luna se ve iluminada con un ángulo de fase de 90 grados?

Exactamente la mitad, una fracción iluminada de 0,5, es decir, el 50 %. Corresponde al cuarto creciente o menguante, cuando la Luna está a unos noventa grados del Sol en el cielo.

¿Qué ángulo de fase corresponde a la luna llena y cuál a la nueva?

Con 0 grados el disco está totalmente iluminado: luna llena. Con 180 grados la cara nocturna mira hacia la Tierra y no se ve nada iluminado: luna nueva.

¿Puedo escribir el ángulo en radianes?

Sí. Por defecto se usan grados, pero puede elegir radianes. El ángulo debe quedar entre 0 y 180 grados, o entre 0 y pi si lo da en radianes.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/astro/moon-illumination-fraction

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

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}'
{
  "phase_angle": 90
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "astro.moon_illumination_fraction",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Los ángulos fuera del rango físico se rechazan con invalid_input para que la automatización no trate una geometría imposible como un cero silencioso.

Contrato de entrada, unidades, rangos y forma de la respuesta

Los ángulos ausentes, en blanco o no finitos también fallan. Los números se redondean a doce decimales para goldens estables entre entornos. Combine la fracción con su propio modelo de magnitud o exposición si necesita brillo aparente; este extremo se detiene en la fracción geométrica del disco. Envíe por POST un cuerpo JSON con phase_angle, un número finito, y opcionalmente unit en deg (valor por defecto) o rad. Se aceptan los alias i, phase, angle y phase_angle_deg para el campo del ángulo. Cuando unit es deg, phase_angle debe estar en el intervalo cerrado de cero a ciento ochenta; cuando unit es rad, en el intervalo cerrado de cero a π. Los valores por debajo del límite inferior o por encima del superior fallan con invalid_input y un mensaje que nombra la condición fuera de rango: esos fallos no se facturan. En caso de éxito el cuerpo repite phase_angle y phase_angle_deg en grados, phase_angle_rad en radianes, la unidad usada, cos_phase_angle, illuminated_fraction k en forma de cero a uno, illuminated_percent como cien veces k, un phase_hint grueso (full, gibbous, quarter, crescent o new), la cadena de la fórmula, una ecuación sustituida y un mensaje breve. Ejemplo: phase_angle noventa con unit deg produce illuminated_fraction cero coma cinco e illuminated_percent cincuenta, coherente con un cuarto geométrico.

Dónde aporta valor una API de fracción iluminada por ángulo de fase

Los planetarios y los sitios de divulgación muestran widgets en vivo de «cuánto de la Luna está iluminada» cuando una efeméride ya ha producido i; llamar a una API de parseo pequeña evita reimplementar la fórmula del coseno en cada lenguaje de front-end. Como la implementación es parse puro de nivel A, cada llamada correcta cuesta el precio base publicado $0.002 sin tokens de modelo ni red saliente.

¿Cómo se calcula la fracción iluminada de la Luna a partir del ángulo de fase?

Envíe phase_angle i (0–180° por defecto, o 0–π rad con unit rad). La API devuelve k = (1 + cos i) / 2 como illuminated_fraction e illuminated_percent.

¿Cuál es el rango permitido para phase_angle?

Con unit deg (por defecto): de 0 a 180 inclusive. Con unit rad: de 0 a π inclusive. Los valores fuera de ese rango fallan con invalid_input y no se facturan.

¿Qué significan phase_angle 0°, 90° y 180°?

0° → plenilunio (k = 1); 90° → cuarto geométrico (k = 0.5); 180° → novilunio (k = 0). Los valores intermedios dan fracciones gibosas o crecientes.

¿Cuánto cuesta la calculadora de fracción iluminada de la Luna?

La herramienta del navegador es gratuita. Las solicitudes API usan saldo prepago KIT a $0.002 por llamada correcta; la entrada inválida no se factura.

Ver la documentación completa del KIT →