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

pydae/__init__.py

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

pydae/utils/dates.py

@@ -1,6 +1,6 @@
 import datetime 
 import pytz
-from typing import Optional,List
+from typing import Optional,List,Tuple
 
 def get_absolute_hour_of_year_with_dst(month: int, day: int, day_hour: int, year: int, timezone_name: str) -> int:
     """
@@ -205,18 +205,70 @@ def list_full_hours_between(start_dt: datetime, end_dt: datetime) -> List[dateti
         
     return hours_list
 
-def absolute_hours_list(datetime_list,time_zone='Europe/Paris'):
-
-    result_ini = parse_datetime( '1/12/2024 23:00', 'Europe/Paris')
-    result_end = parse_datetime('31/12/2024 23:00', 'Europe/Paris')
+def absolute_hours_list(date_ini,date_end,time_zone='Europe/Paris'):
 
+    result_ini = parse_datetime(date_ini, time_zone)
+    result_end = parse_datetime(date_end, time_zone)
 
     hours_list = []
     for item in list_full_hours_between(result_ini,result_end):
         hours_list += [datetime_to_hour_of_year(item)]
 
     return hours_list
+
+        
+
+def hour_index_to_date_components(absolute_hour_index: int, timezone_name: str) -> Optional[Tuple[int, int]]:
+    """
+    Converts an absolute hour of the year index (0-indexed) to the corresponding 
+    day of the year and hour of the day, respecting DST rules.
+
+    Args:
+        absolute_hour_index: The 0-indexed hour of the year (e.g., 8759 is the last hour).
+        timezone_name: The IANA time zone string (e.g., 'Europe/Madrid').
+
+    Returns:
+        A tuple (day_of_year, hour_of_day) as integers, or None on error.
+    """
+    
+    current_year = datetime.datetime.now().year # Use the current year for the calculation
+    
+    try:
+        # 1. Define the time zone
+        tz = pytz.timezone(timezone_name)
+
+        # 2. Create the start-of-year time (Jan 1st, 00:00)
+        # This is the reference point for hour index 0.
+        start_of_year_naive = datetime.datetime(current_year, 1, 1, 0, 0, 0)
         
+        # Localize the start of the year to make it aware
+        start_of_year_aware = tz.localize(start_of_year_naive)
+
+        # 3. Create the time difference
+        # Multiplying the hour index by 3600 gives the exact number of seconds 
+        # that have elapsed since the start_of_year_aware.
+        time_difference = datetime.timedelta(hours=absolute_hour_index)
+
+        # 4. Calculate the target time
+        # This addition operation correctly handles DST shifts. If 25 hours have
+        # passed since Jan 1st, and one hour was lost due to DST, the target time 
+        # will only be advanced by 24 clock hours.
+        target_time_aware = start_of_year_aware + time_difference
+        
+        # 5. Extract the required components
+        # %j gives the 1-indexed day of the year (1-366).
+        day_of_year = int(target_time_aware.strftime('%j'))
+        hour_of_day = target_time_aware.hour # 0-23
+        
+        return (day_of_year, hour_of_day)
+    
+    except pytz.exceptions.UnknownTimeZoneError:
+        print(f"Error: Timezone '{timezone_name}' is not recognized.")
+        return None
+    except Exception as e:
+        print(f"An unexpected error occurred: {e}")
+        return None
+    
 
 
 if __name__ == '__main__':
@@ -229,5 +281,5 @@ if __name__ == '__main__':
 
     print(list_full_hours_between(result_ini,result_end))
 
-    print(absolute_hours_list('1/12/2024 23:00','1/12/2024 23:00'))
+    print(absolute_hours_list('1/1/2024 00:00','31/1/2024 23:00'))
 

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

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

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

@@ -1,5 +1,5 @@
 pydae/.gitignore,sha256=c1jUQV9WXX3PWrlOzHiKvUWFomLJUrfYogbU7nYwAwc,288
-pydae/__init__.py,sha256=RO7L59GtEqyO3RIZ2ZKEMR8WFEua04JOz4qlCqq10q4,104
+pydae/__init__.py,sha256=AooVv7ncEnuMOCQXzdgZBl_YmdIa5ILy7R4W22vxoNw,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=gIJAVlZxLcGoahS_eMzowyqS6a-CUtgWsqpOOIQkl8U,9175
+pydae/utils/dates.py,sha256=wWVhgprZ6Iu8garC8BASKrPWDtXtZY1_ss3iDMLE2mA,11349
 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.dist-info/licenses/COPYING,sha256=QWnWoslbTjQmtlFSRoGF3wxJEJuTJdlEMZ7lHtbGAeQ,1139
-pydae-0.57.dist-info/licenses/LICENSE,sha256=8hQe1oM4ySdliF3R-NEvR6HqrcGDKvsLFJC3gA1sNjY,1108
-pydae-0.57.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
-pydae-0.57.dist-info/METADATA,sha256=RtYLcND2I5k6bKSbUwwBUCnwB8ILrJr7jsEQmLXigjY,1088
-pydae-0.57.dist-info/RECORD,,
+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,,