hydroanomaly 0.4.0__py3-none-any.whl → 0.5.0__py3-none-any.whl

hydroanomaly/__init__.py

@@ -5,21 +5,21 @@ A Python package for hydro anomaly detection, USGS data retrieval,
 time series visualization, and Sentinel satellite data analysis.
 """
 
-__version__ = "0.4.0"
+__version__ = "0.5.0"
 __author__ = "Your Name"
 __email__ = "your.email@example.com"
 
 # Import main modules for easy access
 from .hello import greet
 from .math_utils import add, multiply
-from .usgs_data import get_usgs_data, USGSDataRetriever
+from .usgs_data import get_usgs_data, get_usgs_simple, USGSDataRetriever
 from .plotting import plot_usgs_data, plot_multiple_gages, quick_plot, WaterDataPlotter
 
 # Base exports
 __all__ = [
     'greet',
     'add', 'multiply',
-    'get_usgs_data', 'USGSDataRetriever',
+    'get_usgs_data', 'get_usgs_simple', 'USGSDataRetriever',
     'plot_usgs_data', 'plot_multiple_gages', 'quick_plot', 'WaterDataPlotter',
     'get_discharge', 'get_temperature', 'get_water_level'
 ]

hydroanomaly/usgs_data.py

@@ -309,3 +309,81 @@ def get_usgs_data(
         retriever.save_data(data, save_to_file, parameter_name)
     
     return data
+
+
+def get_usgs_simple(site_number: str, parameter_code: str, start_date: str, end_date: str, plot: bool = True) -> pd.DataFrame:
+    """
+    🚀 SIMPLE USGS DATA RETRIEVAL WITH AUTOMATIC PLOTTING
+    
+    This is the main function users should use for easy USGS data retrieval.
+    Just provide site, parameter, dates and get data + plot automatically!
+    
+    Args:
+        site_number (str): USGS site number (e.g., "294643095035200")
+        parameter_code (str): Parameter code (e.g., "63680" for turbidity)
+        start_date (str): Start date as "YYYY-MM-DD"
+        end_date (str): End date as "YYYY-MM-DD"
+        plot (bool): Whether to automatically create a plot (default: True)
+        
+    Returns:
+        pd.DataFrame: Time series data with datetime index and values
+        
+    Example:
+        >>> data = get_usgs_simple("294643095035200", "63680", "2020-01-01", "2024-12-30")
+        >>> # Automatically retrieves turbidity data and shows a plot!
+    """
+    import matplotlib.pyplot as plt
+    import matplotlib.dates as mdates
+    from datetime import datetime
+    
+    print("🌊 USGS Data Retrieval - Simple Mode")
+    print("=" * 50)
+    print(f"📍 Site: {site_number}")
+    print(f"📊 Parameter: {parameter_code}")
+    print(f"📅 Date Range: {start_date} to {end_date}")
+    print()
+    
+    try:
+        # Get the data using existing function
+        retriever = USGSDataRetriever()
+        data = retriever.retrieve_data(site_number, parameter_code, start_date, end_date)
+        
+        if data is None or len(data) == 0:
+            print("❌ No data retrieved")
+            return pd.DataFrame()
+        
+        # Data summary
+        print(f"✅ Success! Retrieved {len(data)} data points")
+        print(f"📈 Data range: {data.index.min()} to {data.index.max()}")
+        print(f"📊 Values: {data.iloc[:, 0].min():.2f} to {data.iloc[:, 0].max():.2f}")
+        print()
+        
+        # Create automatic plot if requested
+        if plot:
+            plt.figure(figsize=(12, 6))
+            plt.plot(data.index, data.iloc[:, 0], linewidth=1, alpha=0.8)
+            
+            # Format the plot
+            plt.title(f'USGS Time Series Data\nSite: {site_number} | Parameter: {parameter_code}', 
+                     fontsize=14, fontweight='bold')
+            plt.xlabel('Date', fontsize=12)
+            plt.ylabel(f'Parameter {parameter_code}', fontsize=12)
+            plt.grid(True, alpha=0.3)
+            
+            # Format x-axis dates
+            plt.gca().xaxis.set_major_formatter(mdates.DateFormatter('%Y-%m'))
+            plt.gca().xaxis.set_major_locator(mdates.MonthLocator(interval=6))
+            plt.xticks(rotation=45)
+            
+            # Improve layout
+            plt.tight_layout()
+            plt.show()
+            
+            print("📊 Plot created successfully!")
+        
+        return data
+        
+    except Exception as e:
+        print(f"❌ Error: {str(e)}")
+        print("💡 Please check your inputs and try again")
+        return pd.DataFrame()

{hydroanomaly-0.4.0.dist-info → hydroanomaly-0.5.0.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: hydroanomaly
-Version: 0.4.0
-Summary: A Python package for hydro anomaly detection
+Version: 0.5.0
+Summary: A Python package for hydro anomaly detection with simple USGS data retrieval
 Home-page: https://github.com/yourusername/hydroanomaly
 Author: Your Name
 Author-email: Your Name <your.email@example.com>

hydroanomaly-0.5.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+hydroanomaly/__init__.py,sha256=082rQhjdrRTN4uSSsdQB6emJa9OFS8U2O8omxFgGa9Q,4920
+hydroanomaly/hello.py,sha256=AhK7UKF_3TyZcWL4IDlZq_BXdKQzUP-is-jv59fgqk4,566
+hydroanomaly/math_utils.py,sha256=CDOGWAiRlb2PK5SNFysumnzp7_LbZ9aleHLR_3lsGrs,856
+hydroanomaly/plotting.py,sha256=YZW6-Sb_IrhbHKFeoh1d86Ef4Ev5Gpq55lEv8XX0v20,13504
+hydroanomaly/sentinel_data.py,sha256=C5T1ycyTcAGvR6KEukDHJe2kEDbFXgh0yVXi8QrjFXs,17870
+hydroanomaly/usgs_data.py,sha256=ig7Diht106-gEiGFNfKzbj-mUn1RiC4GYoOKacz1Uaw,14674
+hydroanomaly-0.5.0.dist-info/licenses/LICENSE,sha256=OphKV48tcMv6ep-7j-8T6nycykPT0g8ZlMJ9zbGvdPs,1066
+hydroanomaly-0.5.0.dist-info/METADATA,sha256=1CD8vliaRj34Jr8bT1gRXd_iyIhKCSWh7_Ji6dQkoQg,11873
+hydroanomaly-0.5.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+hydroanomaly-0.5.0.dist-info/top_level.txt,sha256=t-5Lc-eTLlkxIhR_N1Cpp6_YZafKS3xLLk9D2CtbE7o,13
+hydroanomaly-0.5.0.dist-info/RECORD,,

hydroanomaly-0.4.0.dist-info/RECORD

@@ -1,11 +0,0 @@
-hydroanomaly/__init__.py,sha256=5X78u2gwZFugrWfMtXv9bV4QNIj8yA36sJTSkk_qb4w,4884
-hydroanomaly/hello.py,sha256=AhK7UKF_3TyZcWL4IDlZq_BXdKQzUP-is-jv59fgqk4,566
-hydroanomaly/math_utils.py,sha256=CDOGWAiRlb2PK5SNFysumnzp7_LbZ9aleHLR_3lsGrs,856
-hydroanomaly/plotting.py,sha256=YZW6-Sb_IrhbHKFeoh1d86Ef4Ev5Gpq55lEv8XX0v20,13504
-hydroanomaly/sentinel_data.py,sha256=C5T1ycyTcAGvR6KEukDHJe2kEDbFXgh0yVXi8QrjFXs,17870
-hydroanomaly/usgs_data.py,sha256=zUvfu3go-7cQuFtD8Hbm7pABpw_RPWuJxE66NhxYmIU,11631
-hydroanomaly-0.4.0.dist-info/licenses/LICENSE,sha256=OphKV48tcMv6ep-7j-8T6nycykPT0g8ZlMJ9zbGvdPs,1066
-hydroanomaly-0.4.0.dist-info/METADATA,sha256=6JGNAS0GWcMflIOidfmZEz71IqZmc_IJxybtdDmGz3o,11841
-hydroanomaly-0.4.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-hydroanomaly-0.4.0.dist-info/top_level.txt,sha256=t-5Lc-eTLlkxIhR_N1Cpp6_YZafKS3xLLk9D2CtbE7o,13
-hydroanomaly-0.4.0.dist-info/RECORD,,