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

pydae/bmapu/lines/temp_xy_0.json

@@ -0,0 +1,7 @@
+{
+    "V_1": 1.0,
+    "theta_1": 0.0,
+    "V_2": 1.0,
+    "theta_2": 0.0,
+    "omega_coi": 1.0
+}

pydae/bmapu/lines/xy_0.json

@@ -0,0 +1,7 @@
+{
+    "V_1": 1.0,
+    "theta_1": 0.0,
+    "V_2": 1.0,
+    "theta_2": 0.0,
+    "omega_coi": 1.0
+}

pydae/build_cffi.py

@@ -1083,7 +1083,7 @@ class builder():
         ffi.compile()
         print(f'Compilation time: {time.time()-t_0:0.2f} s')
         
-    def build(self):
+    def build(self, API=False):
 
         sys = self.sys
         name = self.name

pydae/utils/dates.py

@@ -0,0 +1,285 @@
+import datetime 
+import pytz
+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:
+    """
+    Calculates the absolute hour of the year (0-indexed) for a given date and hour,
+    correctly handling Daylight Saving Time (DST) shifts.
+
+    Args:
+        month: The month (1-12).
+        day: The day of the month (1-31).
+        day_hour: The hour of the day (0-23).
+        year: The year for the calculation.
+        timezone_name: The IANA time zone string (e.g., 'Europe/Madrid', 'America/New_York').
+
+    Returns:
+        The absolute hour of the year (0-indexed).
+    """
+    try:
+        # 1. Define the time zone
+        tz = pytz.timezone(timezone_name)
+
+        # 2. Create the start-of-year time (Jan 1st, 00:00), making it time zone-aware
+        start_of_year = tz.localize(datetime(year, 1, 1, 0, 0, 0))
+
+        # 3. Create the target time, making it time zone-aware
+        # Note: localize handles ambiguous times (the hour repeated when clocks fall back)
+        # by defaulting to the first occurrence (is_dst=False), which is generally safe.
+        target_naive = datetime.datetime(year, month, day, day_hour)
+        target_time = tz.localize(target_naive)
+
+        # 4. Calculate the difference (timedelta)
+        time_difference = target_time - start_of_year
+
+        # 5. Convert the difference to total hours
+        # This conversion correctly uses the total elapsed seconds, accounting for
+        # the 23-hour or 25-hour days caused by DST shifts.
+        total_hours = int(time_difference.total_seconds() / 3600)
+
+        return total_hours
+
+    except pytz.UnknownTimeZoneError:
+        print(f"Error: Unknown time zone '{timezone_name}'.")
+        return -1
+    except ValueError as e:
+        print(f"Error: Invalid date/time input. {e}")
+        return -1
+
+
+
+
+def datetime_to_hour_of_year(date_input: datetime.datetime) -> Optional[int]:
+    """
+    Calculates the absolute hour of the year (0-indexed) for a given date.
+    It uses the timezone already attached to the input object for the calculation.
+
+    Args:
+        date_input: A timezone-aware datetime object (tzinfo MUST be set).
+
+    Returns:
+        The absolute hour of the year (0-indexed) as an integer, or None on error.
+    """
+    
+    # 🚨 Input Validation: Check if the input is timezone-aware
+    target_tz = date_input.tzinfo
+    if target_tz is None or target_tz.utcoffset(date_input) is None:
+        print("Error: Invalid date/time input. Input 'date_input' MUST be a timezone-aware datetime object.")
+        return None
+
+    try:
+        # 1. The target timezone is extracted directly from the input object (target_tz)
+        
+        # 2. Create the start-of-year time (Jan 1st, 00:00) in the input's timezone
+        start_of_year_naive = datetime.datetime(date_input.year, 1, 1, 0, 0, 0)
+        
+        # We must use localize() here since start_of_year_naive is, by definition, naive.
+        start_of_year_aware = target_tz.localize(start_of_year_naive)
+
+        # 3. The target time is already aware (date_input), so no conversion is needed.
+        target_time_aware = date_input
+
+        # 4. Calculate the difference (timedelta)
+        # This calculation is safe because both datetimes are aware and use the same tzinfo.
+        time_difference = target_time_aware - start_of_year_aware
+
+        # 5. Convert the difference to total hours
+        total_hours = int(time_difference.total_seconds() / 3600)
+
+        return total_hours
+    
+    except pytz.exceptions.UnknownTimeZoneError:
+        # This catch is mostly for safety, though the tzinfo should be valid if set by pytz initially.
+        print(f"Error: Timezone attached to the input is not recognized.")
+        return None
+    except Exception as e:
+        print(f"An unexpected error occurred: {e}")
+        return None
+    
+
+def parse_datetime(date_string: str, timezone_name: str) -> Optional[datetime.datetime]:
+    """
+    Attempts to parse a date string using a predefined list of common formats.
+
+    Args:
+        date_string: The raw string input from the user (e.g., '2025-11-22 10:30').
+        timezone_name: The timezone to apply (e.g., 'Europe/Madrid').
+
+    Returns:
+        A timezone-aware datetime object if successful, otherwise None.
+    """
+    
+    # 1. Define the list of formats to try (from most specific/common to least)
+    common_formats = [
+        # Full date and time
+        "%Y-%m-%d %H:%M:%S",  # 2025-11-22 10:30:00
+        "%Y-%m-%d %H:%M",     # 2025-11-22 10:30
+        "%d/%m/%Y %H:%M:%S",  # 22/11/2025 10:30:00
+        "%d/%m/%Y %H:%M",     # 22/11/2025 10:30
+        
+        # Date only (assuming midnight)
+        "%Y-%m-%d",           # 2025-11-22
+        "%d/%m/%Y",           # 22/11/2025
+        "%m/%d/%Y",           # 11/22/2025 (Common in US)
+    ]
+
+    # --- Timezone Setup ---
+    try:
+        # Get the timezone object using pytz
+        tz = pytz.timezone(timezone_name)
+    except pytz.exceptions.UnknownTimeZoneError:
+        print(f"Error: Timezone '{timezone_name}' is not recognized.")
+        return None
+        
+    # --- Iteration and Parsing ---
+    for fmt in common_formats:
+        try:
+            # 1. Try to parse the string with the current format
+            naive_dt = datetime.datetime.strptime(date_string, fmt)
+            
+            # 2. **Safety Net**: Ensure the object is naive before localization. 
+            #    (Though strptime is expected to return a naive object, this is safe practice)
+            naive_dt = naive_dt.replace(tzinfo=None)
+            
+            # 3. Localize the naive datetime object (make it timezone-aware)
+            localized_dt = tz.localize(naive_dt)
+            
+            # 4. Success! Return the localized object immediately
+            print(f"✅ Successfully parsed '{date_string}' using format: '{fmt}'")
+            return localized_dt
+            
+        except ValueError:
+            # If the parsing fails for this format, simply continue to the next one
+            continue
+            
+    # If the loop finishes without returning, no format worked
+    print(f"❌ Could not parse '{date_string}' with any known format.")
+    return None
+
+
+def list_full_hours_between(start_dt: datetime, end_dt: datetime) -> List[datetime]:
+    """
+    Lists all full hours (on the hour mark) between a start and end datetime.
+    The list includes the hour of the start_dt, but excludes the hour of the end_dt.
+
+    Args:
+        start_dt: The starting datetime object (must be timezone-aware).
+        end_dt: The ending datetime object (must be timezone-aware).
+
+    Returns:
+        A list of timezone-aware datetime objects, all set to the start of the hour.
+    
+    Raises:
+        ValueError: If datetimes are not timezone-aware or start_dt is after end_dt.
+    """
+    
+    # --- Input Validation ---
+    if start_dt.tzinfo is None or start_dt.tzinfo.utcoffset(start_dt) is None:
+        raise ValueError("Start datetime must be timezone-aware (tzinfo is required).")
+    if end_dt.tzinfo is None or end_dt.tzinfo.utcoffset(end_dt) is None:
+        raise ValueError("End datetime must be timezone-aware (tzinfo is required).")
+    if start_dt >= end_dt:
+        return []
+
+    # --- 1. Find the first full hour mark to start the iteration ---
+    # Set the minute and second to zero for the start_dt's hour
+    current_dt = start_dt.replace(minute=0, second=0, microsecond=0)
+    
+    # If the start_dt itself was not exactly on the hour, we must include it
+    # as the first item in the list, otherwise, the next iteration would skip it.
+    if start_dt.minute > 0 or start_dt.second > 0:
+        pass # current_dt now represents the start of the hour containing start_dt
+        
+    hours_list = []
+    
+    # --- 2. Iterate hour by hour until the end_dt is reached ---
+    one_hour = datetime.timedelta(hours=1)
+    
+    while current_dt < end_dt:
+        # Append the current full hour to the list
+        hours_list.append(current_dt)
+        
+        # Move to the next hour
+        current_dt += one_hour
+        
+    return hours_list
+
+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__':
+
+    result_1 = parse_datetime('31/12/2024 23:00', 'Europe/Paris')
+    print(datetime_to_hour_of_year(result_1))
+
+    result_ini = parse_datetime( '1/12/2024 23:00', 'Europe/Paris')
+    result_end = parse_datetime('31/12/2024 23:00', 'Europe/Paris')
+
+    print(list_full_hours_between(result_ini,result_end))
+
+    print(absolute_hours_list('1/1/2024 00:00','31/1/2024 23:00'))
+

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

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

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

@@ -1,9 +1,9 @@
 pydae/.gitignore,sha256=c1jUQV9WXX3PWrlOzHiKvUWFomLJUrfYogbU7nYwAwc,288
-pydae/__init__.py,sha256=A32mD4kI6nx5itPtqfG-zWIa5VO-UGCHxGW6qDcnU_M,106
+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
-pydae/build_cffi.py,sha256=o-l7xV5wH4sg0PuWq8Qll53phuXpRB2H04BDkYRuSzk,43879
+pydae/build_cffi.py,sha256=jzsAIT_D3bWQHR6mpJQ4O99F2yR9iPtA6OdKfwKxxgs,43890
 pydae/build_cffi_mp.py,sha256=gJSQ9Ff_g09zqBvDQQBfMA4DTU6U0mtrV3ac4MLkP5A,44276
 pydae/build_test_cffi.c,sha256=5DtNrpLj8_dWHKrVaffSEIitG1PYFO37In__abX9jDQ,106204
 pydae/build_v2.py,sha256=ctx4Q6KxZr7LyDkbMPlnXRWESV-4CAZn50l-l8sAnr8,67240
@@ -47,7 +47,8 @@ pydae/transformers.py,sha256=tVei7P88EFJWx-68NjscVL8eYFJYECpQtRgS6BH_3B0,17289
 pydae/xy_0.json,sha256=uX-p5beHXjMDIkSTd5egfdq2UOq4n37oHpB8XJbpUts,240
 pydae/.ipynb_checkpoints/models-checkpoint.py,sha256=N8-m1Dk6HdmgpELHhEudVGup3ZO_b_DrJls7nanY4O8,58246
 pydae/bmapu/__init__.py,sha256=r7mgVYduCfuZ_pqaNXp_Y6Y-L3wcOKT4dzBLPsr8oak,105
-pydae/bmapu/bmapu_builder.py,sha256=ekIjvqEDGG7Nr1Zlnd7NFlER_i0LsKcRFOY-yE8FzuI,27488
+pydae/bmapu/bmapu_builder.py,sha256=xuLXpO5OpfXAxMXjYz3bWUf_U6epWpWXbFqpoNNYlrY,26807
+pydae/bmapu/bmapu_builder_line_exp.py,sha256=QljQTMT24enZPCvoQyxtN4uSzhmgWQWkdR3qnKYDxDE,21974
 pydae/bmapu/avrs/__init__.py,sha256=JhpeBVii27qLqxJqimWLBYwjPgXrz3hYq7PQQf2ssGs,99
 pydae/bmapu/avrs/avr_antiw.py,sha256=WtezvBDcr82VEqEmbSMdfKS_jdeI-ZcBan5FWqTURd4,15589
 pydae/bmapu/avrs/avrs.py,sha256=sWz29mcLMPcK7N0NiCtkF7MszAkv-RNAvo8Vst81m2A,1104
@@ -89,7 +90,14 @@ pydae/bmapu/govs/temp_xy_0.json,sha256=s1NHn0VvC_-yKfF5ZWR3c45AbF-2wyHxQHfEtavNp
 pydae/bmapu/govs/tgov1.py,sha256=FBpgHh9n__9Z4PdVolU6dTx-qpi887Km89939k3qNVU,2799
 pydae/bmapu/govs/xy_0.json,sha256=s1NHn0VvC_-yKfF5ZWR3c45AbF-2wyHxQHfEtavNpYQ,325
 pydae/bmapu/lines/__init__.py,sha256=oqQul2vN-ptslMdLyvGd7_KLLYgCV5beQvOICuavTRA,189
-pydae/bmapu/lines/lines.py,sha256=y0pjz63NIgwdDbmS58k9VV69FHcujeHzlZtBqXaTrXI,2331
+pydae/bmapu/lines/lib_dtr.py,sha256=cen93cIFMQDWV92tt2GTKVwS2dEfg8IGmzwD49lgDkE,15675
+pydae/bmapu/lines/lines.py,sha256=HJldB_qECtnOZD2k_KCqaEtjbYveHKqLkg7aT8z9CNM,11430
+pydae/bmapu/lines/temp.py,sha256=NX7WzyKRAMqUFNLY6briw5DHwiz871iAvqYYUfVuNzU,61118
+pydae/bmapu/lines/temp_ini_cffi.c,sha256=fkVX3FKuznEXZy7RcpzaNLKVb0e1MhkAflq0zcUSFIM,45210
+pydae/bmapu/lines/temp_run_cffi.c,sha256=IwLffjIAYi-sfkTfB-tFfOBuNkQb6rHfpZGIT-SA_9U,45210
+pydae/bmapu/lines/temp_trap_cffi.c,sha256=8fYuXK1AtdWQcQkU4T2M2tP9BMeycnd4Gz1GQLh-jjI,35014
+pydae/bmapu/lines/temp_xy_0.json,sha256=CPFm4uAYlOUHuONVUyrJCc-ecch9fHk-I6HXmKH7k8A,102
+pydae/bmapu/lines/xy_0.json,sha256=CPFm4uAYlOUHuONVUyrJCc-ecch9fHk-I6HXmKH7k8A,102
 pydae/bmapu/loads/__init__.py,sha256=rh5unTQUN14OzJ7B98byS7szyklhxQyipKDZdxN9pno,77
 pydae/bmapu/loads/load_zip.py,sha256=Y8DOXsDCTdznWH0mycZ0Zd6PG8f3HJo0ssfCnleMeVc,4734
 pydae/bmapu/loads/loads.py,sha256=7xDg4c5JjKWJKkMT4qWEGIoiU_eDu1GQ4q5Fky9bcls,1085
@@ -727,14 +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/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.56.5.dist-info/licenses/COPYING,sha256=QWnWoslbTjQmtlFSRoGF3wxJEJuTJdlEMZ7lHtbGAeQ,1139
-pydae-0.56.5.dist-info/licenses/LICENSE,sha256=8hQe1oM4ySdliF3R-NEvR6HqrcGDKvsLFJC3gA1sNjY,1108
-pydae-0.56.5.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
-pydae-0.56.5.dist-info/METADATA,sha256=5BgEFFF3DBXyuF7qDDIwdfFpQo0WSZrkDY1bbYMJjQU,1090
-pydae-0.56.5.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,,