adding UTC_offset_hours for array of longitudes

Author: gregory-halverson

pyproject.toml

@@ -3,7 +3,7 @@ requires = ["setuptools>=60", "setuptools-scm>=8.0", "wheel"]
 
 [project]
 name = "solar_apparent_time"
-version = "1.2.0"
+version = "1.3.0"
 description = "methods to translate Python datetime between solar apparent time and Coordinate Universal Time (UTC)"
 readme = "README.md"
 authors = [

solar_apparent_time/solar_apparent_time.py

@@ -1,3 +1,5 @@
+from typing import Union
+
 from datetime import datetime, timedelta
 import numpy as np
 import rasters as rt
@@ -28,6 +30,19 @@ def solar_to_UTC(time_solar: datetime, lon: float) -> datetime:
     """
     return time_solar - timedelta(hours=(np.radians(lon) / np.pi * 12))
 
+def UTC_offset_hours(lon: Union[float, np.ndarray]) -> Union[float, np.ndarray]:
+    """
+    Calculates the offset in hours from UTC based on the given longitude.
+
+    Args:
+        lon (Union[float, np.ndarray]): The longitude in degrees.
+
+    Returns:
+        Union[float, np.ndarray]: The calculated offset in hours from UTC.
+    """
+    # Convert longitude to radians and calculate the offset in hours from UTC
+    return np.radians(lon) / np.pi * 12
+
 def UTC_offset_hours_for_area(geometry: rt.RasterGeometry) -> rt.Raster:
     """
     Calculates the UTC offset in hours for a given raster geometry.

solar_apparent_time/version.txt

@@ -1 +1 @@
-1.2.0
+1.3.0