pydae 0.57.1__py3-none-any.whl → 0.57.2__py3-none-any.whl

pydae/__init__.py

@@ -7,5 +7,5 @@ Differential Algebraic Equations in Python
 
 """
 
-__version__ = "0.57.1"
+__version__ = "0.57.2"
  

pydae/utils/dates.py

@@ -270,7 +270,56 @@ def hour_index_to_date_components(absolute_hour_index: int, timezone_name: str)
         return None
     
 
+def day_to_absolute_hour(day_of_year: int, target_year: int, timezone_name: str = 'Europe/Madrid') -> int:
+    """
+    Calculates the absolute hour of the year (based on UTC) for a specific day 
+    at 00:00 local time, correctly accounting for time zone and DST changes.
+
+    Args:
+        day_of_year: The sequential day of the year (1 for Jan 1st, 365/366 for Dec 31st).
+        target_year: The year for the calculation (e.g., 2024).
+        timezone_name: The target time zone string (e.g., 'Europe/London', 'America/New_York'). 
+                       Defaults to 'UTC'.
+
+    Returns:
+        The total number of hours elapsed from the beginning of the year 
+        (Jan 1st 00:00 UTC) up to the specified date and time (converted to UTC).
+    
+    Raises:
+        pytz.UnknownTimeZoneError: If the provided timezone_name is invalid.
+    """
+    
+    # 1. Define the start of the year and the target date (unlocalized)
+    start_of_year = datetime.datetime(target_year, 1, 1, 0, 0, 0)
+    
+    # Calculate the target date (00:00 local time)
+    # We subtract 1 from day_of_year because Jan 1st is day 1, but represents 0 days of offset.
+    target_date = start_of_year + datetime.timedelta(days=day_of_year - 1)
 
+    try:
+        # 2. Localize the dates
+        tz = pytz.timezone(timezone_name)
+        
+        # Localize the date to the target timezone (this handles DST shift at 00:00 if any)
+        # .localize() is the safe way to assign timezone awareness.
+        start_of_year_local = tz.localize(start_of_year)
+        target_date_local = tz.localize(target_date)
+
+        # 3. Convert both localized times to UTC
+        start_of_year_utc = start_of_year_local.astimezone(pytz.utc)
+        target_date_utc = target_date_local.astimezone(pytz.utc)
+
+        # 4. Calculate the difference in hours
+        time_difference = target_date_utc - start_of_year_utc
+        
+        # Convert total seconds in the timedelta to total hours (integer result)
+        absolute_hour = int(time_difference.total_seconds() / 3600)
+        
+        return absolute_hour
+
+    except pytz.UnknownTimeZoneError:
+        raise pytz.UnknownTimeZoneError(f"Time zone '{timezone_name}' is not recognized by pytz.")
+    
 if __name__ == '__main__':
 
     result_1 = parse_datetime('31/12/2024 23:00', 'Europe/Paris')

{pydae-0.57.1.dist-info → pydae-0.57.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pydae
-Version: 0.57.1
+Version: 0.57.2
 Summary: =====
 Keywords: engineering
 Author-email: Juan Manuel Mauricio <jmmauricio6@gmail.com>

{pydae-0.57.1.dist-info → pydae-0.57.2.dist-info}/RECORD

@@ -1,5 +1,5 @@
 pydae/.gitignore,sha256=c1jUQV9WXX3PWrlOzHiKvUWFomLJUrfYogbU7nYwAwc,288
-pydae/__init__.py,sha256=AooVv7ncEnuMOCQXzdgZBl_YmdIa5ILy7R4W22vxoNw,106
+pydae/__init__.py,sha256=fUy1IioPTAmI5CGTEuu5wHj1YqgbZ1bjvpvdZA2X7eM,106
 pydae/b_pu.py,sha256=FdRRVieJLQDYPwYNWhbXJ0SXvf4jtPdbvIZTKWi16I0,6775
 pydae/bpu.py,sha256=FdRRVieJLQDYPwYNWhbXJ0SXvf4jtPdbvIZTKWi16I0,6775
 pydae/build.py,sha256=ECfc_doyK9PhrjEAlWJGLfirQmpT24XuYNxUgtrXI74,46151
@@ -735,15 +735,15 @@ pydae/urisi/vsgs/vsg_lpf_ib.hjson,sha256=xpuo5fPCdO5Ze0X-KDCsa_eRpde5f5KDDFoDkWI
 pydae/urisi/vsgs/vsgs.py,sha256=v17sLm7EaaAyBVJk9-8DnLtxPDtXmkyizFlGhgqyFEE,644
 pydae/urisi/vsgs/xy_0.json,sha256=Q6qWPIqEP-w5Qu2twd3S4PX4zMggpNpG2W62e7ry70g,851
 pydae/utils/__init__.py,sha256=kwp76qeU2mnwrCexDSF15id9ih12Q0VRL3l-_c6omcQ,184
-pydae/utils/dates.py,sha256=wWVhgprZ6Iu8garC8BASKrPWDtXtZY1_ss3iDMLE2mA,11349
+pydae/utils/dates.py,sha256=bx3NyCkyWFbp3hlsOTbUSXSbXDAqYGIWA8aXoslE0_I,13612
 pydae/utils/ss_num2sym.py,sha256=ZA-x01y1mEWk1HdlpNv9rNspFdH0RBlTq_JRDHmjlpU,3209
 pydae/utils/svg2pdf.py,sha256=6tNORhlu_cMPDp264Kg3X_eBORfT9Q1cqAcWaWgDs7k,1861
 pydae/utils/tools.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pydae/utils/types_converter.py,sha256=3eAWwELgG1d6iFX8sn8iGPIp6NBaX4I-eyUriRDOFyE,7929
 pydae/utils/utils.py,sha256=AI0wZr4PJ3Td3vjfAW06FJdgcK01TpUAukhG37gZP5g,1079
 pydae/utils/emtp/readPL4.py,sha256=R59KhXTmFrqtdv-9nv5tkdHoTs9uoofGqEfBCF4fGEY,3088
-pydae-0.57.1.dist-info/licenses/COPYING,sha256=QWnWoslbTjQmtlFSRoGF3wxJEJuTJdlEMZ7lHtbGAeQ,1139
-pydae-0.57.1.dist-info/licenses/LICENSE,sha256=8hQe1oM4ySdliF3R-NEvR6HqrcGDKvsLFJC3gA1sNjY,1108
-pydae-0.57.1.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
-pydae-0.57.1.dist-info/METADATA,sha256=JFOPnyIcoXWAmiFg-hoAZwyQ_QrkH-hKD45FgPG9vrs,1090
-pydae-0.57.1.dist-info/RECORD,,
+pydae-0.57.2.dist-info/licenses/COPYING,sha256=QWnWoslbTjQmtlFSRoGF3wxJEJuTJdlEMZ7lHtbGAeQ,1139
+pydae-0.57.2.dist-info/licenses/LICENSE,sha256=8hQe1oM4ySdliF3R-NEvR6HqrcGDKvsLFJC3gA1sNjY,1108
+pydae-0.57.2.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+pydae-0.57.2.dist-info/METADATA,sha256=pPD7BWSoPod5OcSfSLQh_E3EJjDn3n8UynyO4l9reUM,1090
+pydae-0.57.2.dist-info/RECORD,,