Fraction illuminée de la Lune

Observateurs, photographes et enseignants ont souvent besoin de cette fraction à partir d'un angle de phase connu, et non d'une date de calendrier. Ce calculateur de fraction illuminée de la Lune prend l'angle de phase i de la géométrie Soleil–Lune–observateur et renvoie k égal à un plus le cosinus de i, le tout divisé par deux — la relation classique des manuels de photométrie lunaire et d'éphémérides. Les angles hors de la plage physique sont rejetés avec invalid_input afin que l'automatisation ne traite jamais une géométrie impossible comme un zéro silencieux.

Ce que signifie l'angle de phase et comment la fraction illuminée est définie

En géométrie lunaire l'angle de phase i est l'angle à la Lune entre les directions vers le Soleil et vers l'observateur. Cette identité découle de l'aire projetée d'un corps sphérique : le terminateur divise la sphère de sorte que la portion ensoleillée du disque égale la moitié de un plus le cosinus de l'angle de phase. Si vous avez besoin du nom de phase ou de l'illumination à partir d'une date civile seule, utilisez un outil de phase lunaire par date — cette page cible l'étape angle-vers-fraction que ces pipelines exigent encore comme fonction pure.

Contrat d'entrée, unités, plages et forme de la réponse

Les angles manquants, vides ou non finis échouent aussi. Les nombres sont arrondis à douze décimales pour des goldens stables entre runtimes. Associez la fraction à votre propre modèle de magnitude ou d'exposition si vous avez besoin de la brillance apparente ; ce point d'accès s'arrête à la fraction géométrique du disque. Envoyez par POST un corps JSON avec phase_angle, un nombre fini, et optionnellement unit égal à deg (par défaut) ou rad. Les alias i, phase, angle et phase_angle_deg sont acceptés pour le champ d'angle. Lorsque unit vaut deg, phase_angle doit se situer dans l'intervalle fermé de zéro à cent quatre-vingts ; lorsque unit vaut rad, dans l'intervalle fermé de zéro à π. Les valeurs sous la borne inférieure ou au-dessus de la borne supérieure échouent avec invalid_input et un message qui nomme la condition hors plage — ces échecs ne sont pas facturés. En cas de succès le corps renvoie phase_angle et phase_angle_deg en degrés, phase_angle_rad en radians, l'unité utilisée, cos_phase_angle, illuminated_fraction k sous forme zéro-à-un, illuminated_percent comme cent fois k, un phase_hint grossier (full, gibbous, quarter, crescent ou new), la chaîne de formule, une équation substituée et un court message. Exemple : phase_angle quatre-vingt-dix avec unit deg donne illuminated_fraction zéro virgule cinq et illuminated_percent cinquante, cohérent avec un quartier géométrique.

Où une API de fraction illuminée par angle de phase s'avère utile

Les planétariums et les sites de médiation affichent des widgets en direct « quelle part de la Lune est éclairée » une fois qu'une éphéméride a produit i ; appeler une petite API de parse évite de réimplémenter la formule du cosinus dans chaque langage front-end. Comme l'implémentation est parse pur tier A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant.