pylunar 0.7.4__py3-none-any.whl → 0.8.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,57 @@
+# 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
+from typing import Dict
+
+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

@@ -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-0.7.4.dist-info → pylunar-0.8.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pylunar
-Version: 0.7.4
+Version: 0.8.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
@@ -27,6 +27,7 @@ Requires-Dist: build==1.2.2.post1; extra == "build"
 Requires-Dist: twine==5.1.1; extra == "build"
 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"

pylunar-0.8.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+pylunar/__init__.py,sha256=1HgvGZdShUOeanMLMf2vNzdtyvcyAGtjvsytGxbaW00,1116
+pylunar/altitude_dict.py,sha256=NEpnNvKmnOFlEF9VxXBANbsf1ks7G7xnu6ul_DfMpAo,1582
+pylunar/helpers.py,sha256=UgEFvBGGZxTBaKx16-CjOO8hkqPA_GLRZN8SOgshZFs,1327
+pylunar/lunar_feature.py,sha256=cqNFA7ED-u13H1rayo029GrQfPR3g1cYL-m_Q0zYNuQ,5532
+pylunar/lunar_feature_container.py,sha256=dcV9Thd7AdQTllhkIKJ_lYGWW5jsj7a1ZpqTjq7BQ6Y,2810
+pylunar/moon_info.py,sha256=n9sMgk8lDM18_D6hbC8AG0I9yQ7-FfwwQccah-LrqCs,20833
+pylunar/pkg_types.py,sha256=DbPCc9_kzRuSOxOfeKaLJdWfykdbzRPnOTY-EN2xrsc,973
+pylunar/data/lunar.db,sha256=y2u5wR_DpHjPYH7fuR-T_q0nbPzN1GuP8_OXorjVr14,28672
+pylunar-0.8.0.dist-info/AUTHORS.rst,sha256=mqGQzrJPFGm44DZxZFs0d080QDWXdtfFlv1i_fdJerg,332
+pylunar-0.8.0.dist-info/LICENSE,sha256=EF_CKfNhkKjEynpn9Msb6HaGNIBN9VfeGyrJFJQ5FYk,1479
+pylunar-0.8.0.dist-info/METADATA,sha256=uafi1dvpjSpMogwlBYmbf2ch-0v9YaWfHY4Fktrh4gk,3277
+pylunar-0.8.0.dist-info/WHEEL,sha256=P9jw-gEje8ByB7_hXoICnHtVCrEwMQh-630tKvQWehc,91
+pylunar-0.8.0.dist-info/top_level.txt,sha256=vEQZCgYlUuoq6D4q99Kj5fSpNs2Mo-jW8vKV3dnpI-U,8
+pylunar-0.8.0.dist-info/RECORD,,

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

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.2.0)
+Generator: setuptools (75.3.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,,