mirror/astronomy
1
0
Fork 0
mirror of https://github.com/cosinekitty/astronomy.git synced 2026-03-11 19:19:04 -04:00
Code Issues Packages Projects Releases Wiki Activity

Miscellaneous documentation fixes.

Browse Source 
While working on the Kotlin implementation, I have
found a few documentation mistakes in the other language
implementations. These have been accumulating in the
`kotlin` branch. I migrated these changes back into
the released code for now, because I don't want to wait
until Kotlin is ready.
This commit is contained in:
Don Cross
2022-04-02 16:52:54 -04:00
parent 608a7a8dca
commit 9d6294d7fe
22 changed files with 361 additions and 465 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
source/python/astronomy/astronomy.py
View File

@@ -5080,7 +5080,7 @@ def InverseRefractionAngle(refraction, bent_altitude):
"""Calculates the inverse of an atmospheric refraction angle.
Given an observed altitude angle that includes atmospheric refraction,
calculate the negative angular correction to obtain the unrefracted
calculates the negative angular correction to obtain the unrefracted
altitude. This is useful for cases where observed horizontal
coordinates are to be converted to another orientation system,
but refraction first must be removed from the observed position.
@@ -6995,7 +6995,7 @@ def InverseRotation(rotation):
"""Calculates the inverse of a rotation matrix.
Given a rotation matrix that performs some coordinate transform,
this function returns the matrix that reverses that trasnform.
this function returns the matrix that reverses that transform.
Parameters
----------
@@ -7376,7 +7376,7 @@ def Rotation_HOR_EQJ(time, observer):
Returns
-------
RotationMatrix
A rotation matrix that converts HOR to EQD at `time` and for `observer`.
A rotation matrix that converts HOR to EQJ at `time` and for `observer`.
"""
hor_eqd = Rotation_HOR_EQD(time, observer)
eqd_eqj = Rotation_EQD_EQJ(time)
@@ -8272,7 +8272,7 @@ class LunarEclipseInfo:
Returned by #SearchLunarEclipse or #NextLunarEclipse
to report information about a lunar eclipse event.
When a lunar eclipse is found, it is classified as penumbral, partial, or total.
Penumbral eclipses are difficult to observe, because the moon is only slightly dimmed
Penumbral eclipses are difficult to observe, because the Moon is only slightly dimmed
by the Earth's penumbra; no part of the Moon touches the Earth's umbra.
Partial eclipses occur when part, but not all, of the Moon touches the Earth's umbra.
Total eclipses occur when the entire Moon passes into the Earth's umbra.
@@ -8324,9 +8324,6 @@ class GlobalSolarEclipseInfo:
Returned by #SearchGlobalSolarEclipse or #NextGlobalSolarEclipse
to report information about a solar eclipse event.
Field `peak` holds the date and time of the peak of the eclipse, defined as
the instant when the axis of the Moon's shadow cone passes closest to the Earth's center.
The eclipse is classified as partial, annular, or total, depending on the
maximum amount of the Sun's disc obscured, as seen at the peak location
on the surface of the Earth.
@@ -8349,7 +8346,8 @@ class GlobalSolarEclipseInfo:
kind : EclipseKind
The type of solar eclipse: `EclipseKind.Partial`, `EclipseKind.Annular`, or `EclipseKind.Total`.
peak : Time
The date and time of the eclipse at its peak.
The date and time when the solar eclipse is darkest.
This is the instant when the axis of the Moon's shadow cone passes closest to the Earth's center.
distance : float
The distance between the Sun/Moon shadow axis and the center of the Earth, in kilometers.
latitude : float
@@ -8381,7 +8379,7 @@ class EclipseEvent:
(a "local" solar eclipse), a series of events occur. In addition
to the time of each event, it is important to know the altitude of the Sun,
because each event may be invisible to the observer if the Sun is below
the horizon (i.e. it at night).
the horizon.
If `altitude` is negative, the event is theoretical only; it would be
visible if the Earth were transparent, but the observer cannot actually see it.