ras-commander 0.61.0__py3-none-any.whl → 0.65.0__py3-none-any.whl

ras_commander/RasPrj.py

@@ -161,47 +161,100 @@ class RasPrj:
 
         This method initializes DataFrames for plan, flow, unsteady, and geometry entries
         by calling the _get_prj_entries method for each entry type.
+        Also extracts unsteady_number and geometry_number from plan files and adds them to plan_df.
+        Now includes Geom Path, Flow Path, and other required columns.
         """
-        # Initialize DataFrames
+        # Load unsteady first to ensure consistent handling of unsteady numbers
+        self.unsteady_df = self._get_prj_entries('Unsteady')
         self.plan_df = self._get_prj_entries('Plan')
         self.flow_df = self._get_prj_entries('Flow')
-        self.unsteady_df = self._get_prj_entries('Unsteady')
-        self.geom_df = self.get_geom_entries()  # Use get_geom_entries instead of _get_prj_entries
+        self.geom_df = self.get_geom_entries()
         
-        # Add Geom_File to plan_df
-        self.plan_df['Geom_File'] = self.plan_df.apply(lambda row: self._get_geom_file_for_plan(row['plan_number']), axis=1)
+        # Set geometry and flow paths
+        for idx, row in self.plan_df.iterrows():
+            try:
+                # Add Geom Path
+                if row['Geom File'] is not None:
+                    geom_hdf_path = self.project_folder / f"{self.project_name}.g{row['Geom File']}"
+                    self.plan_df.at[idx, 'Geom Path'] = str(geom_hdf_path)
+                
+                # Add Flow Path
+                if row['Flow File'] is not None:
+                    # Determine if this is a steady or unsteady flow file
+                    if row['unsteady_number'] is not None:
+                        flow_path = self.project_folder / f"{self.project_name}.u{row['Flow File']}"
+                    else:
+                        flow_path = self.project_folder / f"{self.project_name}.f{row['Flow File']}"
+                    self.plan_df.at[idx, 'Flow Path'] = str(flow_path)
+                
+                    if not self.suppress_logging:
+                        logger.info(f"Plan {row['plan_number']} paths set up")
+            except Exception as e:
+                logger.error(f"Error processing plan file {row['plan_number']}: {e}")
 
-    
-    def _get_geom_file_for_plan(self, plan_number):
+    def _get_geom_file_from_plan(self, plan_file_path):
         """
-        Get the geometry file path for a given plan number.
+        Extract the geometry number from a plan file by finding the Geom File value
+        and stripping the leading 'g'.
         
-        Args:
-            plan_number (str): The plan number to find the geometry file for.
+        Parameters:
+        -----------
+        plan_file_path : str or Path
+            Path to the plan file.
         
         Returns:
-            str: The full path to the geometry HDF file, or None if not found.
+        --------
+        tuple: (str, str)
+            A tuple containing (geometry_number, full_hdf_path) or (None, None) if not found.
+            geometry_number is the number after 'g' in the Geom File value
+            full_hdf_path is the path to the geometry HDF file
+        """
+        content, encoding = read_file_with_fallback_encoding(plan_file_path)
+        
+        if content is None:
+            return None, None
+        
+        try:
+            match = re.search(r'Geom File=g(\d+)', content)
+            if match:
+                geom_number = match.group(1)  # This gets just the number after 'g'
+                geom_file = f"g{geom_number}"
+                geom_hdf_path = self.project_folder / f"{self.project_name}.{geom_file}.hdf"
+                if geom_hdf_path.exists():
+                    return geom_number, str(geom_hdf_path)
+        except Exception as e:
+            logger.error(f"Error extracting geometry number from {plan_file_path}: {e}")
+        
+        return None, None
+
+    def _get_flow_file_from_plan(self, plan_file_path):
+        """
+        Extract the Flow File value from a plan file.
+        
+        Parameters:
+        -----------
+        plan_file_path : str or Path
+            Path to the plan file.
+        
+        Returns:
+        --------
+        str or None
+            The Flow File value or None if not found.
         """
-        plan_file_path = self.project_folder / f"{self.project_name}.p{plan_number}"
         content, encoding = read_file_with_fallback_encoding(plan_file_path)
         
         if content is None:
             return None
         
         try:
-            for line in content.splitlines():
-                if line.startswith("Geom File="):
-                    geom_file = line.strip().split('=')[1]
-                    geom_hdf_path = self.project_folder / f"{self.project_name}.{geom_file}.hdf"
-                    if geom_hdf_path.exists():
-                        return str(geom_hdf_path)
-                    else:
-                        return None
+            match = re.search(r'Flow File=([^\s]+)', content)
+            if match:
+                return match.group(1)
         except Exception as e:
-            logger.error(f"Error reading plan file for geometry: {e}")
+            logger.error(f"Error extracting Flow File from {plan_file_path}: {e}")
+        
         return None
 
-
     @staticmethod
     @log_call
     def get_plan_value(
@@ -376,19 +429,16 @@ class RasPrj:
         
         return plan_info
 
+    @log_call
     def _get_prj_entries(self, entry_type):
         """
         Extract entries of a specific type from the HEC-RAS project file.
-
+        
         Args:
             entry_type (str): The type of entry to extract (e.g., 'Plan', 'Flow', 'Unsteady', 'Geom').
-
+        
         Returns:
             pd.DataFrame: A DataFrame containing the extracted entries.
-
-        Note:
-            This method reads the project file and extracts entries matching the specified type.
-            For 'Unsteady' entries, it parses additional information from the unsteady file.
         """
         entries = []
         pattern = re.compile(rf"{entry_type} File=(\w+)")
@@ -400,28 +450,101 @@ class RasPrj:
                     if match:
                         file_name = match.group(1)
                         full_path = str(self.project_folder / f"{self.project_name}.{file_name}")
+                        entry_number = file_name[1:]  # Extract number portion without prefix
+                        
                         entry = {
-                            f'{entry_type.lower()}_number': file_name[1:],
+                            f'{entry_type.lower()}_number': entry_number,
                             'full_path': full_path
                         }
-
-                        if entry_type == 'Plan':
-                            plan_info = self._parse_plan_file(Path(full_path))
-                            entry.update(plan_info)
-                            
-                            hdf_results_path = self.project_folder / f"{self.project_name}.p{file_name[1:]}.hdf"
-                            entry['HDF_Results_Path'] = str(hdf_results_path) if hdf_results_path.exists() else None
-
+                        
                         if entry_type == 'Unsteady':
+                            entry['unsteady_number'] = entry_number
                             unsteady_info = self._parse_unsteady_file(Path(full_path))
                             entry.update(unsteady_info)
+                        else:
+                            entry.update({
+                                'unsteady_number': None,
+                                'geometry_number': None
+                            })
+                        
+                        if entry_type == 'Plan':
+                            plan_info = self._parse_plan_file(Path(full_path))
+                            if plan_info:
+                                # Handle Flow File (unsteady) number
+                                flow_file = plan_info.get('Flow File')
+                                if flow_file and flow_file.startswith('u'):
+                                    entry['unsteady_number'] = flow_file[1:]
+                                    entry['Flow File'] = flow_file[1:]
+                                else:
+                                    entry['unsteady_number'] = None
+                                    entry['Flow File'] = flow_file[1:] if flow_file and flow_file.startswith('f') else None
+                                    
+                                # Handle Geom File number
+                                geom_file = plan_info.get('Geom File')
+                                if geom_file and geom_file.startswith('g'):
+                                    entry['geometry_number'] = geom_file[1:]
+                                    entry['Geom File'] = geom_file[1:]
+                                else:
+                                    entry['geometry_number'] = None
+                                    entry['Geom File'] = None
+                                
+                                # Add all plan key information with exact same names
+                                for key, value in plan_info.items():
+                                    if key not in ['Flow File', 'Geom File']:
+                                        entry[key] = value
+                        
+                            # Add HDF results path
+                            hdf_results_path = self.project_folder / f"{self.project_name}.p{entry_number}.hdf"
+                            entry['HDF_Results_Path'] = str(hdf_results_path) if hdf_results_path.exists() else None
 
                         entries.append(entry)
+        
+            df = pd.DataFrame(entries)
+            
+            if not df.empty and entry_type == 'Plan':
+                # Set required column order
+                first_cols = ['plan_number', 'unsteady_number', 'geometry_number']
+                
+                # Standard plan key columns in the exact order specified
+                plan_key_cols = [
+                    'Plan Title', 'Program Version', 'Short Identifier', 'Simulation Date',
+                    'Std Step Tol', 'Computation Interval', 'Output Interval', 'Instantaneous Interval',
+                    'Mapping Interval', 'Run HTab', 'Run UNet', 'Run Sediment', 'Run PostProcess',
+                    'Run WQNet', 'Run RASMapper', 'UNET Use Existing IB Tables', 'HDF_Results_Path',
+                    'UNET 1D Methodology', 'Write IC File', 'Write IC File at Fixed DateTime',
+                    'IC Time', 'Write IC File Reoccurance', 'Write IC File at Sim End'
+                ]
+                
+                # Additional convenience columns
+                file_path_cols = ['Geom File', 'Geom Path', 'Flow File', 'Flow Path']
+                
+                # Build the final column list
+                all_cols = first_cols.copy()
+                for col in plan_key_cols:
+                    if col in df.columns:
+                        all_cols.append(col)
+                
+                # Add any remaining columns not explicitly specified
+                other_cols = [col for col in df.columns if col not in all_cols + file_path_cols + ['full_path']]
+                all_cols.extend(other_cols)
+                all_cols.extend(file_path_cols)
+                
+                # Rename plan_number column
+                df = df.rename(columns={f'{entry_type.lower()}_number': 'plan_number'})
+                
+                # Fill in missing columns with None
+                for col in all_cols:
+                    if col not in df.columns:
+                        df[col] = None
+                
+                # Return DataFrame with specified column order
+                return df[all_cols]
+            
+            return df
         except Exception as e:
+            logger.error(f"Error in _get_prj_entries for {entry_type}: {e}")
             raise
 
-        return pd.DataFrame(entries)
-
     def _parse_unsteady_file(self, unsteady_file_path):
         """
         Parse an unsteady flow file and extract critical information.
@@ -811,6 +934,28 @@ class RasPrj:
         
         return bc_info, unparsed_lines
 
+    @log_call
+    def get_unsteady_numbers_from_plans(self):
+        """
+        Get all plans that use unsteady flow files.
+        
+        Returns:
+        --------
+        pd.DataFrame
+            A DataFrame containing only plan entries that use unsteady flow files.
+        
+        Raises:
+        -------
+        RuntimeError: If the project has not been initialized.
+        """
+        self.check_initialized()
+        
+        # Filter plan_df to only include plans with unsteady_number not None
+        unsteady_plans = self.plan_df[self.plan_df['unsteady_number'].notna()].copy()
+        
+        logger.info(f"Found {len(unsteady_plans)} plans using unsteady flow files")
+        
+        return unsteady_plans
 
 # Create a global instance named 'ras'
 # Defining the global instance allows the init_ras_project function to initialize the project.
@@ -881,8 +1026,8 @@ def get_ras_exe(ras_version=None):
     
     Args:
         ras_version (str, optional): Either a version number or a full path to the HEC-RAS executable.
-                                     If None, the function will attempt to use the version from the global 'ras' object
-                                     or a default path.
+                                     If None, the function will first check the global 'ras' object for a path.
+                                     If the global 'ras' object is not initialized or doesn't have a path, a default path will be used.
     
     Returns:
         str: The full path to the HEC-RAS executable.

ras_commander/__init__.py

@@ -10,7 +10,7 @@ try:
     __version__ = version("ras-commander")
 except PackageNotFoundError:
     # package is not installed
-    __version__ = "0.54.0"
+    __version__ = "0.65.0"
 
 # Set up logging
 setup_logging()
@@ -23,8 +23,6 @@ from .RasUnsteady import RasUnsteady
 from .RasUtils import RasUtils
 from .RasExamples import RasExamples
 from .RasCmdr import RasCmdr
-from .RasGpt import RasGpt
-from .RasToGo import RasToGo
 from .HdfFluvialPluvial import HdfFluvialPluvial
 
 # HDF handling
@@ -41,7 +39,6 @@ from .HdfXsec import HdfXsec
 from .HdfPump import HdfPump
 from .HdfPipe import HdfPipe
 from .HdfInfiltration import HdfInfiltration
-from .RasMapper import RasMapper
 
 # Plotting functionality
 from .HdfPlot import HdfPlot
@@ -52,14 +49,13 @@ __all__ = [
     # Core functionality
     'RasPrj', 'init_ras_project', 'get_ras_exe', 'ras',
     'RasPlan', 'RasGeo', 'RasUnsteady', 'RasUtils',
-    'RasExamples', 'RasCmdr', 'RasGpt', 'RasToGo',
-    'HdfFluvialPluvial',
+    'RasExamples', 'RasCmdr', 'HdfFluvialPluvial',
     
     # HDF handling
     'HdfBase', 'HdfBndry', 'HdfMesh', 'HdfPlan',
     'HdfResultsMesh', 'HdfResultsPlan', 'HdfResultsXsec',
     'HdfStruc', 'HdfUtils', 'HdfXsec', 'HdfPump',
-    'HdfPipe', 'HdfInfiltration', 'RasMapper',
+    'HdfPipe', 'HdfInfiltration',
     
     # Plotting functionality
     'HdfPlot', 'HdfResultsPlot',

{ras_commander-0.61.0.dist-info → ras_commander-0.65.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: ras-commander
-Version: 0.61.0
+Version: 0.65.0
 Summary: A Python library for automating HEC-RAS 6.x operations
 Home-page: https://github.com/gpt-cmdr/ras-commander
 Author: William M. Katzenmeyer, P.E., C.F.M.
@@ -35,22 +35,25 @@ Dynamic: summary
 RAS Commander is a Python library for automating HEC-RAS operations, providing a set of tools to interact with HEC-RAS project files, execute simulations, and manage project data. This library was initially conceptualized in the Australian Water School course "AI Tools for Modelling Innovation", and subsequently expanded to cover the basic functionality of the HECRASController COM32 interface using open-source python libraries.  This library uses a Test Driven Development strategy, leveraging the publicly-available HEC-RAS Example projects to create repeatable demonstration examples.  The "Commmander" moniker is inspired by the "Command Line is All You Need" approach to HEC-RAS automation that was first implemented in the HEC-Commander Tools repository. 
 
 ## Repository Author:
-(William Katzenmeyer, P.E., C.F.M.)[https://engineeringwithllms.info]
+[William Katzenmeyer, P.E., C.F.M.](https://engineeringwithllms.info)
+-----  
 
-## Don't Ask Me, Ask GPT! 
+## Don't Ask Me, Ask GPT!
 
 This repository has several methods of interaction with Large Language Models and LLM-Assisted Coding built right in: 
 
-1. **[RAS Commander Library Assistant GPT](https://chatgpt.com/g/g-TZRPR3oAO-ras-commander-library-assistant)**: A specialized GPT model with access to the ras-commander codebase and library, available for answering queries and providing code suggestions.   You can even upload your own plan, unsteady and HDF files to inspect and help determine how to automate your workflows or visualize your results, although this ability is still limited by OpenAI's GPT frameworks and may not be useful for long conversations.
+1. **[Purpose-Built Knowledge Base Summaries](https://github.com/gpt-cmdr/ras-commander/tree/main/ai_tools/llm_knowledge_bases)**: Up-to-date compilations of the documentation and codebase for use with large language models like Claude, ChatGPT, Gemini or Grok. Look in 'ai_tools/assistant_knowledge_bases/' in the repo.  The repo's codebase (without documentation and examples) has been curated to stay within the current ~200k context window limitations of frontier models, and for tasks that do not need an understanding of the underlying code, the Comprehensive Library Guide and any relevant examples from the example folder should be adequate context for leveraging the ras-commander API to complete tasks. 
 
-2. **[Purpose-Built Knowledge Base Summaries](https://github.com/gpt-cmdr/ras-commander/tree/main/ai_tools/assistant_knowledge_bases)**: Up-to-date compilations of the documentation and codebase for use with large language models like Claude or GPT-4. Look in 'ai_tools/assistant_knowledge_bases/' in the repo.  The repo's codebase (without documentation and examples) has been curated to stay within the current ~200k context window limitations of frontier models, and for tasks that do not need an understanding of the underlying code, the Comprehensive Library Guide and any relevant examples from the example folder should be adequate context for leveraging the ras-commander API to complete tasks. 
+2. **[Cursor IDE Integration](https://github.com/gpt-cmdr/ras-commander/blob/main/.cursorrules)**: Custom rules(.cursorrules) for the Cursor IDE to provide context-aware suggestions and documentation.  Just open the repository folder in Cursor to recognize these instructions.  You can create your own folders "/workspace/, "/projects/", or "my_projects/" as these are already in the .gitignore, and place your custom scripts there for your projects.  This will allow easy referencing of the ras-commander documents and individual repo files, the automatic loading of the .cursorrules file.  Alternatvely, download the github repo into your projects folder to easily load documents and use cursor rules files.
 
-3. **[Cursor IDE Integration](https://github.com/gpt-cmdr/ras-commander/blob/main/.cursorrules)**: Custom rules(.cursorrules) for the Cursor IDE to provide context-aware suggestions and documentation.  Just open the repository folder in Cursor to recognize these instructions.  You can create your own folders "/workspace/, "/projects/", or "my_projects/" as these are already in the .gitignore, and place your custom scripts there for your projects.  This will allow easy referencing of the ras-commander documents and individual repo files, the automatic loading of the .cursorrules file.  Alternatvely, download the github repo into your projects folder to easily load documents and use cursor rules files.
+3. **[RAS-Commander Library Assistant](https://github.com/gpt-cmdr/ras-commander/tree/main/ai_tools/library_assistant)**: A full-featured interface for multi-turn conversations, using your own API keys and the ras-commander library for context.  The library assistant allows you to load your own scripts and chat with specific examples and/or function classes in the RAS-Commander library to effectively utilize the library's functions in your workflow.  To reduce hallucinations, a file browser is included which adds full files to the conversation to ensure grounded responses.  A dashboard shows you the total context and estimated cost of each request.  **Now with support for Claude 3.7, OpenAI's o1 and o3-mini, and Deepseek V3 and R1 models using US-based Together.ai**
+
+
+4. **[RAS Commander Library Assistant on ChatGPT](https://chatgpt.com/g/g-TZRPR3oAO-ras-commander-library-assistant)**: A specialized ChatGPT "GPT" with access to the ras-commander codebase and library, available for answering queries and providing code suggestions.   You can even upload your own plan, unsteady and HDF files to inspect and help determine how to automate your workflows or visualize your results.  _NOTE: GPT's are still quite limited by OpenAI's GPT frameworks and may not be useful for long conversations.  Code interpreter cannot run HEC-RAS but can open and view smaller HDF files and projects for demonstration purposes_
 
-5. **[RAS-Commander Library Assistant](https://github.com/gpt-cmdr/ras-commander/blob/main/library_assistant)**: A full-featured interface for multi-turn conversations, using your own API keys and the ras-commander library for context.  The library assistant allows you to load your own scripts and chat with specific examples and/or function classes in the RAS-Commander library to effectively utilize the library's functions in your workflow.  To reduce hallucinations, a file browser is included which adds full files to the conversation to ensure grounded responses.  A dashboard shows you the total context and estimated cost of each request.  **Now with support for OpenAI's o1 and o3-mini, and Deepseek V3 and R1 models using US-based Together.ai**
 
 ## Background
-The ras-commander library emerged from the initial test-bed of AI-driven coding represented by the HEC-Commander tools Python notebooks. These notebooks served as a proof of concept, demonstrating the value proposition of automating HEC-RAS operations. The transition from notebooks to a structured library aims to provide a more robust, maintainable, and extensible solution for water resources engineers.
+The ras-commander library emerged from the initial test-bed of AI-driven coding represented by the [HEC-Commander tools](https://github.com/gpt-cmdr/HEC-Commander) Python notebooks. These notebooks served as a proof of concept, demonstrating the value proposition of automating HEC-RAS operations. In 2024, I taught a series of progressively more complex webinars demonstrating how to use simple prompting, example projects and natural language instruction to effectively code HEC-RAS automation workflows, culminating in a 6 hour course.  The library published for utilization in that course, [awsrastools](https://github.com/gpt-cmdr/awsrastools) served as a foundation of examples which were iteratively extended into the full RAS-Commander library.  Unlike the original notebook by the same name, this library is not focused on parallel execution across multiple machines.  Instead, it is focused on providing a general-purpose python API for interacting with HEC-RAS projects, and building an AI-friendly library that will allow new users to quickly scaffold their own workflows into a python script. Example notebooks are provided, but the intention is to empower engineers, software developers, GIS personnel and data analysts to more easily access and interact with HEC-RAS data in a python environment.  Also, by publishing these examples publicly, with complete working code examples and LLM optimization, future users can readily rewrite they key functions of the library for inclusion in into their own preferred libraries, languages or return formats.
 
 ## Features
 
@@ -92,7 +95,13 @@ In your virtual environment, install ras-commander using pip:
 pip install --upgrade ras-commander
 ```
 If you have dependency issues with pip (especially if you have errors with numpy), try clearing your local pip packages 'C:\Users\your_username\AppData\Roaming\Python\' and then creating a new virtual environment.  
-   
+
+Dependencies can also be manually installed: 
+```
+pip install h5py numpy pandas requests tqdm scipy xarray geopandas matplotlib shapely pathlib rasterstats rtree
+```
+
+
 #### Work in a Local Copy
 
 If you want to make revisions and work actively in your local version of ras-commander, just skip the pip install rascommander step above and clone a fork of the repo to your local machine using Git (ask ChatGPT if you need help).  Most of the notebooks and examples in this repo have a code segment similar to the one below, that works as long as the script is located in a first-level subfolder of the ras-commander repository:
@@ -135,24 +144,27 @@ Using the default 'ras" object, othewise substitute your_ras_project for muli-pr
 ```
 print("\nPlan Files DataFrame:")
 ras.plan_df
-
+```
+```
 print("\nFlow Files DataFrame:")
 ras.flow_df
-
+```
+```
 print("\nUnsteady Flow Files DataFrame:")
 ras.unsteady_df
-
+```
+```
 print("\nGeometry Files DataFrame:")
 ras.geom_df
-
-print("\nHDF Entries DataFrame:")
-ras.get_hdf_entries()
-
+```
+```
 print("\nBoundary Conditions DataFrame:")
 ras.boundaries_df
-
 ```
-
+```
+print("\nHDF Entries DataFrame:")
+ras.get_hdf_entries()
+```
 
 
 
@@ -265,6 +277,11 @@ This is useful for comparing different river systems, running scenario analyses
 
 ```
 ras_commander
+├── ai_tools
+│   ├── [AI Knowledge Bases](https://github.com/gpt-cmdr/ras-commander/tree/main/ai_tools/llm_knowledge_bases) 
+│   └── [Library Assistant](https://github.com/gpt-cmdr/ras-commander/tree/main/ai_tools/library_asssistant)
+├── examples
+│   └── [Examples Notebooks](https://github.com/gpt-cmdr/ras-commander/tree/main/ras_commander)
 ├── ras_commander
 │   ├── __init__.py
 │   ├── _version.py
@@ -277,8 +294,6 @@ ras_commander
 │   ├── RasPrj.py
 │   ├── RasUnsteady.py
 │   ├── RasUtils.py
-│   ├── RasToGo.py
-│   ├── RasGpt.py
 │   ├── HdfBase.py
 │   ├── HdfBndry.py
 │   ├── HdfMesh.py
@@ -292,28 +307,13 @@ ras_commander
 │   ├── HdfFluvialPluvial.py
 │   ├── HdfPlot.py
 │   └── HdfResultsPlot.py
-├── examples
-│   ├── 00_Using_RasExamples.ipynb
-│   ├── 01_project_initialization.ipynb
-│   ├── 02_plan_and_geometry_operations.ipynb
-│   ├── 03_unsteady_flow_operations.ipynb
-│   ├── 04_multiple_project_operations.ipynb
-│   ├── 05_single_plan_execution.ipynb
-│   ├── 06_executing_plan_sets.ipynb
-│   ├── 07_sequential_plan_execution.ipynb
-│   ├── 08_parallel_execution.ipynb
-│   └── 09_plan_parameter_operations.ipynb
-├── tests
-│   └── ... (test files)
 ├── .gitignore
 ├── LICENSE
 ├── README.md
 ├── STYLE_GUIDE.md
 ├── Comprehensive_Library_Guide.md
 ├── pyproject.toml
-├── setup.cfg
 ├── setup.py
-└── requirements.txt
 ```
 
 ### Accessing HEC Examples through RasExamples
@@ -335,6 +335,8 @@ projects = ras_examples.list_projects("Steady Flow")
 extracted_paths = ras_examples.extract_project(["Bald Eagle Creek", "Muncie"])
 ```
 
+The RasExamples class is used to provide an alternative to traditional unit testing, with example notebooks doubling as tests and in-context examples for the end user.  This increases interpretability by LLM's, reducing hallucinations.  
+
 ### RasPrj
 
 The `RasPrj` class is central to managing HEC-RAS projects within the ras-commander library. It handles project initialization, data loading, and provides access to project components.
@@ -459,18 +461,11 @@ The ras-commander library is an ongoing project. Future plans include:
 - [GPT-Commander YouTube Channel](https://www.youtube.com/@GPT_Commander)
 - [ChatGPT Examples for Water Resources Engineers](https://github.com/gpt-cmdr/HEC-Commander/tree/main/ChatGPT%20Examples)
 
-## Contributing
-
-We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details on how to submit pull requests, report issues, and suggest improvements.
 
 ## Style Guide
 
 This project follows a specific style guide to maintain consistency across the codebase. Please refer to the [Style Guide](STYLE_GUIDE.md) for details on coding conventions, documentation standards, and best practices.
 
-## License
-
-ras-commander is released under the MIT License. See the license file for details.
-
 ## Acknowledgments
 
 RAS Commander is based on the HEC-Commander project's "Command Line is All You Need" approach, leveraging the HEC-RAS command-line interface for automation. The initial development of this library was presented in the HEC-Commander Tools repository. In a 2024 Australian Water School webinar, Bill demonstrated the derivation of basic HEC-RAS automation functions from plain language instructions. Leveraging the previously developed code and AI tools, the library was created. The primary tools used for this initial development were Anthropic's Claude, GPT-4, Google's Gemini Experimental models, and the Cursor AI Coding IDE.
@@ -488,7 +483,7 @@ Additionally, we would like to acknowledge the following notable contributions a
    Xiaofeng Liu, Ph.D., P.E.,    Associate Professor, Department of Civil and Environmental Engineering
    Institute of Computational and Data Sciences, Penn State University
 
-3. Attribution: The[ffrd\rashdf'](https://github.com/fema-ffrd/rashdf) project by FEMA-FFRD (FEMA Future of Flood Risk Data) was incorporated, revised, adapted and extended in rascommander's RasHDF libaries (where noted). 
+3. Attribution: The [ffrd\rashdf'](https://github.com/fema-ffrd/rashdf) project by FEMA-FFRD (FEMA Future of Flood Risk Data) was incorporated, revised, adapted and extended in rascommander's RasHDF libaries (where noted). 
 
 These acknowledgments recognize the contributions and inspirations that have helped shape RAS Commander, ensuring proper attribution for the ideas and code that have influenced its development.
 
@@ -499,19 +494,25 @@ These acknowledgments recognize the contributions and inspirations that have hel
 ## Official RAS Commander AI-Generated Songs:
 
 [No More Wait and See (Bluegrass)](https://suno.com/song/16889f3e-50f1-4afe-b779-a41738d7617a)  
-
+  
+  
 [No More Wait and See (Cajun Zydeco)](https://suno.com/song/4441c45d-f6cd-47b9-8fbc-1f7b277ee8ed)  
-
+  
 ## Other Resources
 
-Notebook version of RAS-Commander: [RAS-Commander Notebook in the HEC-Commander Tools Repository](https://github.com/gpt-cmdr/HEC-Commander/tree/main/RAS-Commander)
+Notebook version of RAS-Commander: [RAS-Commander Notebook in the HEC-Commander Tools Repository](https://github.com/gpt-cmdr/HEC-Commander/tree/main/RAS-Commander)  
+
 Youtube Tutorials for HEC-Commander Tools and RAS-Commander: [GPT-Commander on YouTube](https://www.youtube.com/@GPT_Commander/videos)
 
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details on how to submit pull requests, report issues, and suggest improvements.
+
 ## LICENSE
 
 This software is released under the MIT license.
 
 ## Contact
 
-For questions, suggestions, or support, please contact:
+For questions, suggestions, or support, please contact:  
 William Katzenmeyer, P.E., C.F.M. - heccommander@gmail.com

{ras_commander-0.61.0.dist-info → ras_commander-0.65.0.dist-info}/RECORD

@@ -1,18 +1,18 @@
 ras_commander/Decorators.py,sha256=0UIYc-hzmBVS7tovSLMzDp2NIhwrZvOYNrQSvETxhEE,6538
 ras_commander/HdfBase.py,sha256=Jws6Y8JFkharuiM6Br5ivp6MS64X2fL6y87FOpe3FQw,14219
-ras_commander/HdfBndry.py,sha256=m81NdCu_ER-AAZpEkQPQka7pYv3sm7vEZevq3SIt2pw,12545
+ras_commander/HdfBndry.py,sha256=FBNFoTz4sXVB-MOsbHJBP8P0dMqJUfBROloKTaxmzCo,16377
 ras_commander/HdfFluvialPluvial.py,sha256=dlqoFX5i7uSA2BvuRNrV-Fg-z2JaeUxY86_fbZAdGqI,25933
-ras_commander/HdfInfiltration.py,sha256=QVigQJjYeQNutbazGHhbTmEuIVCb9gIb2f4yM-wyUtQ,15269
+ras_commander/HdfInfiltration.py,sha256=SB8EsB-w1zrUHXqn3G8ihEahViTIZF7c7AyPHIrSrOU,15473
 ras_commander/HdfMesh.py,sha256=zI_4AqxDxb2_31G9RUmWibyld6KDMGhDpI3F8qwzVAw,19139
 ras_commander/HdfPipe.py,sha256=m-yvPL2GIP23NKt2tcwzOlS7khvgcDPGAshlTPMUAeI,32154
-ras_commander/HdfPlan.py,sha256=NW6g2kS74y44Ci1P9iMo7IKUfR0eYOaJn1QbzsRM1co,10415
+ras_commander/HdfPlan.py,sha256=jCNeyMHlaiMjn6wgGjVXrRElMSh3xwlmFJxHMzOkanM,12317
 ras_commander/HdfPlot.py,sha256=7MNI5T9qIz-Ava1RdlnB6O9oJElE5BEB29QVF5Y2Xuc,3401
 ras_commander/HdfPump.py,sha256=Vc2ff16kRISR7jwtnaAqxI0p-gfBSuZKzR3rQbBLQoE,12951
-ras_commander/HdfResultsMesh.py,sha256=T1afgFsJ1NaqmOJEJfMUBm1ZZ5pwbd82aAqeEkHNaLk,30959
-ras_commander/HdfResultsPlan.py,sha256=3FMaVrN_Bj3EZOJn7WZQ83e9en2LUwZ2sq5e6O03XOM,15823
+ras_commander/HdfResultsMesh.py,sha256=nO2dGYEvQiUWr19MAkkVAkU5AW3kKcps8d0zgox73u4,31738
+ras_commander/HdfResultsPlan.py,sha256=L3IOdF6R3XiA7mbFAyLdczrZJQJogd8hhl7UYJWT5fY,16246
 ras_commander/HdfResultsPlot.py,sha256=ylzfT78CfgoDO0XAlRwlgMNRzvNQYBMn9eyXyBfjv_w,7660
 ras_commander/HdfResultsXsec.py,sha256=-P7nXnbjOLAeUnrdSC_lJQSfzrlWKmDF9Z5gEjmxbJY,13031
-ras_commander/HdfStruc.py,sha256=-Nyb9IhxTB1HdNLpn5lIRQ4j9_gZZc_ekNp_YOFe7Ik,12711
+ras_commander/HdfStruc.py,sha256=SznjPvBWiqNVtviZvfCdjB_iwZF4UXxlIxITD8kwjP4,13733
 ras_commander/HdfUtils.py,sha256=VkIKAXBrLwTlk2VtXSO-W3RU-NHpfHbE1QcZUZgl-t8,15248
 ras_commander/HdfXsec.py,sha256=flREnFFrIZu4SSKGRQeX9w3SS49q0UWPJnq4zO7DbUM,27342
 ras_commander/LoggingConfig.py,sha256=gWe5K5XTmMQpSczsTysAqpC9my24i_IyM8dvD85fxYg,2704
@@ -20,15 +20,15 @@ ras_commander/RasCmdr.py,sha256=2i9gR5koFfBLwvhYAbNgQFNKKUKqxD1Hf6T9SN9sx-s,2655
 ras_commander/RasExamples.py,sha256=6IZ96LcAsk5LYFehdD0zDW5wyZWxQa6OQu2N9upxWXA,17536
 ras_commander/RasGeo.py,sha256=M0sVNKlWmmbve8iMXLWq25WgbxqLWBo7_1oDg_rALzU,5607
 ras_commander/RasGpt.py,sha256=N_7p2nucWrBBXdB2k2ZKvOeOdXNmFD9dIY3W7_5i5nw,1206
-ras_commander/RasMapper.py,sha256=A7xupixCmgXFiSfQs3oWBMBstrO8XcxieMeZWKTcbPQ,3271
-ras_commander/RasPlan.py,sha256=1HAn31oyz0hGv2r7GVNCLWcAZFcRjYTBNdL19mabvmw,53651
-ras_commander/RasPrj.py,sha256=epORKnwdzAovAO-whadvkOhJ8ruXPqmPjGCouHdqzuo,37783
+ras_commander/RasMapper.py,sha256=LO_blvQnd4pwkEU8A30-RoE-CYIoU3s_fNLHBoM8ljw,613
+ras_commander/RasPlan.py,sha256=9RbOzQyz0_BCRa-gds_ca3_DImNMeX6n5NslkjpfT1w,62477
+ras_commander/RasPrj.py,sha256=b0d0A5WKkUXRtQobUcDPBTTGymtM_EWZwFbpOrNjqfY,44731
 ras_commander/RasToGo.py,sha256=TKujfaV1xQhFaOddF4g2ogGy6ky-CLlfelSMPD2J3Nk,1223
 ras_commander/RasUnsteady.py,sha256=KfCXAag-_bPwwS3JbPZH-s4hbaoHACO0mlRnGrzbFgA,32092
 ras_commander/RasUtils.py,sha256=P2-aBL61kdRINsjnBpstZVD6VVc7hI_D3RUXqr6ldmc,34863
-ras_commander/__init__.py,sha256=mceEWRQJkDBi1o3zVg7DpG2qMrMnKHwwuK3GwyxoVr4,2132
-ras_commander-0.61.0.dist-info/LICENSE,sha256=_pbd6qHnlsz1iQ-ozDW_49r86BZT6CRwO2iBtw0iN6M,457
-ras_commander-0.61.0.dist-info/METADATA,sha256=FmTSLA-khuKDSyKxmVQYa6jX0aADR1tKmtX9k2iTOhI,25045
-ras_commander-0.61.0.dist-info/WHEEL,sha256=52BFRY2Up02UkjOa29eZOS2VxUrpPORXg1pkohGGUS8,91
-ras_commander-0.61.0.dist-info/top_level.txt,sha256=i76S7eKLFC8doKcXDl3aiOr9RwT06G8adI6YuKbQDaA,14
-ras_commander-0.61.0.dist-info/RECORD,,
+ras_commander/__init__.py,sha256=Aojks8MKjFZceg9TEaTqrr6RsgLeJAh6iZrRZVoOdg0,2001
+ras_commander-0.65.0.dist-info/LICENSE,sha256=_pbd6qHnlsz1iQ-ozDW_49r86BZT6CRwO2iBtw0iN6M,457
+ras_commander-0.65.0.dist-info/METADATA,sha256=7Ddh7KnY46exroA1XG0YC77l3YKdQJqiNZuyZIUtOPE,26233
+ras_commander-0.65.0.dist-info/WHEEL,sha256=52BFRY2Up02UkjOa29eZOS2VxUrpPORXg1pkohGGUS8,91
+ras_commander-0.65.0.dist-info/top_level.txt,sha256=i76S7eKLFC8doKcXDl3aiOr9RwT06G8adI6YuKbQDaA,14
+ras_commander-0.65.0.dist-info/RECORD,,