pylunar 0.7.4__py3-none-any.whl → 0.9.0__py3-none-any.whl

pylunar/__init__.py

@@ -9,6 +9,7 @@
 # license that can be found in the LICENSE file.
 
 __all__ = [
+    "AltitudeDict",
     "__author__",
     "__email__",
     "__version__",
@@ -36,6 +37,7 @@ version_info = __version__.split(".")
 Use this for version comparison.
 """
 
+from .altitude_dict import AltitudeDict
 from .helpers import mjd_to_date_tuple, tuple_to_string
 from .lunar_feature import LunarFeature
 from .lunar_feature_container import LunarFeatureContainer

pylunar/altitude_dict.py

@@ -0,0 +1,56 @@
+# This file is part of pylunar.
+#
+# Developed by Michael Reuter.
+#
+# See the LICENSE file at the top-level directory of this distribution
+# for details of code ownership.
+#
+# Use of this source code is governed by a 3-clause BSD-style
+# license that can be found in the LICENSE file.
+
+"""Module for the AltitudeDict class."""
+
+from __future__ import annotations
+
+import sys
+
+if sys.version_info >= (3, 10):
+    from importlib.resources import files
+else:
+    from importlib_resources import files
+
+import sqlite3
+
+from .lunar_feature import LunarFeature
+from .moon_info import MoonInfo
+
+__all__ = ["AltitudeDict"]
+
+
+class AltitudeDict(dict[str, float]):
+    """Dictionary for the Lunar II features requiring solar altitude."""
+
+    def load(self, moon_info: MoonInfo) -> None:
+        """Provide solar altitude for the Lunar II features.
+
+        Parameters
+        ----------
+        moon_info : :class:`pylunar.MoonInfo`
+            Instance of the Lunar information class.
+        """
+        features = ["Byrgius A", "Proclus", "Rupes Recta", "Tycho"]
+        dbname = str(files("pylunar.data").joinpath("lunar.db"))
+        conn = sqlite3.connect(dbname)
+        cur = conn.cursor()
+
+        sql = f"select * from Features where Name in {str(tuple(features))}"
+        cur.execute(sql)
+
+        feature_list = []
+        for row in cur:
+            feature_list.append(LunarFeature.from_row(row))
+
+        for feature in sorted(feature_list, key=lambda x: x.name):
+            self[feature.name] = moon_info.solar_altitude(feature)
+
+        cur.close()

pylunar/lunar_feature.py

@@ -108,7 +108,7 @@ class LunarFeature:
 
         Returns
         -------
-        :class:`.LunarFeature`
+        :class:`pylunar.LunarFeature`
             Class initialized from database row.
         """
         return cls(*row[1:])

pylunar/lunar_feature_container.py

@@ -15,8 +15,8 @@ from __future__ import annotations
 __all__ = ["LunarFeatureContainer"]
 
 import collections
+from collections.abc import Generator
 import sys
-from typing import Generator
 
 if sys.version_info >= (3, 10):
     from importlib.resources import files
@@ -52,7 +52,7 @@ class LunarFeatureContainer:
 
         Yields
         ------
-        :class:`.LunarFeature`
+        :class:`pylunar.LunarFeature`
             The current lunar feature.
         """
         yield from self.features.values()
@@ -72,7 +72,7 @@ class LunarFeatureContainer:
 
         Parameters
         ----------
-        moon_info : :class:`.MoonInfo`, optional
+        moon_info : :class:`pylunar.MoonInfo`, optional
             Instance of the Lunar information class.
         limit : int, optional
             Restrict the number of features read to the given value.

pylunar/moon_info.py

@@ -266,7 +266,7 @@ class MoonInfo:
 
         Parameters
         ----------
-        feature : :class:`.LunarFeature`
+        feature : :class:`pylunar.LunarFeature`
             The lunar feature instance to check.
 
         Returns
@@ -291,7 +291,7 @@ class MoonInfo:
 
         Parameters
         ----------
-        feature : :class:`.LunarFeature`
+        feature : :class:`pylunar.LunarFeature`
             The lunar feature instance to check.
 
         Returns
@@ -556,6 +556,29 @@ class MoonInfo:
 
         return sorted_times
 
+    def solar_altitude(self, feature: LunarFeature) -> float:
+        """Find the altitude of the sun over a given feature.
+
+        Sunrise is near zero degrees, noon is near 90 degrees and sunset is
+        near 180 degrees.
+
+        Parameters
+        ----------
+        feature : :class:`pylunar.LunarFeature`
+            Feature to calculate solar altitude.
+
+        Returns
+        -------
+        float
+            Solar altitude over feature in degrees.
+        """
+        rad_ss_lat = math.radians(self.subsolar_lat())
+        rad_feature_lat = math.radians(feature.latitude)
+        term1 = math.sin(rad_ss_lat) * math.sin(rad_feature_lat)
+        term2a = math.cos(rad_ss_lat) * math.cos(rad_feature_lat)
+        term2b = math.sin(math.radians(self.colong() + feature.longitude))
+        return math.degrees(math.asin(term1 + term2a * term2b))
+
     def subsolar_lat(self) -> float:
         """Latitude in degress on the moon where the sun is overhead.
 

pylunar/pkg_types.py

@@ -19,13 +19,13 @@ if sys.version_info >= (3, 10):
 else:
     from typing_extensions import TypeAlias
 
-from typing import List, Tuple, Union
+from typing import Union
 
-DateTimeTuple: TypeAlias = Tuple[int, int, int, int, int, Union[int, float]]
-MoonPhases: TypeAlias = List[Tuple[str, Union[DateTimeTuple, str]]]
-DmsCoordinate: TypeAlias = Tuple[int, int, int]
-Range: TypeAlias = Tuple[float, float]
-LunarFeatureList: TypeAlias = Tuple[
+DateTimeTuple: TypeAlias = Union[tuple[int, ...], tuple[int, int, int, int, int, float]]
+MoonPhases: TypeAlias = list[tuple[str, Union[DateTimeTuple, str]]]
+DmsCoordinate: TypeAlias = tuple[int, int, int]
+Range: TypeAlias = tuple[float, float]
+LunarFeatureList: TypeAlias = tuple[
     str, float, float, float, float, float, str, str, str, str, Union[str, None]
 ]
-FeatureRow: TypeAlias = Tuple[int, str, float, float, float, float, float, str, str, str, str, str]
+FeatureRow: TypeAlias = tuple[int, str, float, float, float, float, float, str, str, str, str, str]

{pylunar-0.7.4.dist-info → pylunar-0.9.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pylunar
-Version: 0.7.4
+Version: 0.9.0
 Summary: Information for completing the Astronomical League's Lunar and Lunar II observing programs.
 Author-email: Michael Reuter <mareuternh@gmail.com>
 Project-URL: Documentation, http://pylunar.readthedocs.io
@@ -10,34 +10,33 @@ Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: BSD License
 Classifier: Natural Language :: English
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 License-File: AUTHORS.rst
 Requires-Dist: ephem==4.1.6
-Requires-Dist: pytz==2024.2
 Requires-Dist: importlib-resources==6.4.5; python_version < "3.10"
 Requires-Dist: typing-extensions==4.12.2; python_version < "3.10"
-Provides-Extra: build
-Requires-Dist: build==1.2.2.post1; extra == "build"
-Requires-Dist: twine==5.1.1; extra == "build"
+Requires-Dist: pytz==2024.2
 Provides-Extra: dev
 Requires-Dist: pylunar[build,docs,lint,test]; extra == "dev"
+Requires-Dist: scriv==1.5.1; extra == "dev"
 Requires-Dist: tox==4.23.2; extra == "dev"
-Provides-Extra: docs
-Requires-Dist: sphinx~=7.1; extra == "docs"
-Requires-Dist: sphinx-rtd-theme==2.0.0; extra == "docs"
-Provides-Extra: lint
-Requires-Dist: pre-commit==3.5.0; python_version < "3.9" and extra == "lint"
-Requires-Dist: pre-commit==3.8.0; python_version >= "3.9" and extra == "lint"
 Provides-Extra: test
+Requires-Dist: coverage[toml]==7.6.9; extra == "test"
 Requires-Dist: pytest==8.3.3; extra == "test"
-Requires-Dist: coverage[toml]==7.6.1; python_version < "3.9" and extra == "test"
-Requires-Dist: coverage[toml]==7.6.4; python_version >= "3.9" and extra == "test"
+Provides-Extra: lint
+Requires-Dist: pre-commit==4.0.1; extra == "lint"
+Provides-Extra: build
+Requires-Dist: build==1.2.2.post1; extra == "build"
+Requires-Dist: twine==5.1.1; extra == "build"
+Provides-Extra: docs
+Requires-Dist: sphinx~=7.1; extra == "docs"
+Requires-Dist: sphinx_rtd_theme==3.0.2; extra == "docs"
 
 =============================
 Python Lunar

pylunar-0.9.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+pylunar/__init__.py,sha256=1HgvGZdShUOeanMLMf2vNzdtyvcyAGtjvsytGxbaW00,1116
+pylunar/altitude_dict.py,sha256=x0nsR9ZeyyEl10tvSDXSqfUx_4q2hmwckWzEmpjoE7Q,1558
+pylunar/helpers.py,sha256=UgEFvBGGZxTBaKx16-CjOO8hkqPA_GLRZN8SOgshZFs,1327
+pylunar/lunar_feature.py,sha256=cqNFA7ED-u13H1rayo029GrQfPR3g1cYL-m_Q0zYNuQ,5532
+pylunar/lunar_feature_container.py,sha256=ci5MXPLqKhghh3k9HCti5csvkohfu3GV9LHnI6rLio0,2819
+pylunar/moon_info.py,sha256=n9sMgk8lDM18_D6hbC8AG0I9yQ7-FfwwQccah-LrqCs,20833
+pylunar/pkg_types.py,sha256=o5LVdgosUo9Vy6OS2Hi1HkVcgUStlPV-AnEYimyxlIo,972
+pylunar/data/lunar.db,sha256=y2u5wR_DpHjPYH7fuR-T_q0nbPzN1GuP8_OXorjVr14,28672
+pylunar-0.9.0.dist-info/AUTHORS.rst,sha256=mqGQzrJPFGm44DZxZFs0d080QDWXdtfFlv1i_fdJerg,332
+pylunar-0.9.0.dist-info/LICENSE,sha256=EF_CKfNhkKjEynpn9Msb6HaGNIBN9VfeGyrJFJQ5FYk,1479
+pylunar-0.9.0.dist-info/METADATA,sha256=2QqOXzrBsu6onsZzuMbM3ePz8PJZGaGg-JzO_OzEKIo,3064
+pylunar-0.9.0.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+pylunar-0.9.0.dist-info/top_level.txt,sha256=vEQZCgYlUuoq6D4q99Kj5fSpNs2Mo-jW8vKV3dnpI-U,8
+pylunar-0.9.0.dist-info/RECORD,,

{pylunar-0.7.4.dist-info → pylunar-0.9.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.2.0)
+Generator: setuptools (75.6.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

pylunar-0.7.4.dist-info/RECORD

@@ -1,13 +0,0 @@
-pylunar/__init__.py,sha256=-I-kK_YCtnOkwYPs2Qe9mCaanU5XJLnXxhHzNbKJpAk,1056
-pylunar/helpers.py,sha256=UgEFvBGGZxTBaKx16-CjOO8hkqPA_GLRZN8SOgshZFs,1327
-pylunar/lunar_feature.py,sha256=7geZ5cY_JPOS3F2Zyr4qutQi_fHzl-wXTCNEy80ox8w,5525
-pylunar/lunar_feature_container.py,sha256=ud8-B_CqQ_0x9FSbkj2eHMPRT5PAwSai6D6tU9dGkQY,2796
-pylunar/moon_info.py,sha256=fD6r0zcX2Q990zqHpYZt7I14HJOPEZyOBqmJx6FKjxI,19962
-pylunar/pkg_types.py,sha256=DbPCc9_kzRuSOxOfeKaLJdWfykdbzRPnOTY-EN2xrsc,973
-pylunar/data/lunar.db,sha256=y2u5wR_DpHjPYH7fuR-T_q0nbPzN1GuP8_OXorjVr14,28672
-pylunar-0.7.4.dist-info/AUTHORS.rst,sha256=mqGQzrJPFGm44DZxZFs0d080QDWXdtfFlv1i_fdJerg,332
-pylunar-0.7.4.dist-info/LICENSE,sha256=EF_CKfNhkKjEynpn9Msb6HaGNIBN9VfeGyrJFJQ5FYk,1479
-pylunar-0.7.4.dist-info/METADATA,sha256=KVJo7EM7lIj-W4x0TLY7BwV5JvSQ4-3Wx1qQMmhFxB0,3233
-pylunar-0.7.4.dist-info/WHEEL,sha256=OVMc5UfuAQiSplgO0_WdW7vXVGAt9Hdd6qtN4HotdyA,91
-pylunar-0.7.4.dist-info/top_level.txt,sha256=vEQZCgYlUuoq6D4q99Kj5fSpNs2Mo-jW8vKV3dnpI-U,8
-pylunar-0.7.4.dist-info/RECORD,,