ras-commander 0.21.0__tar.gz → 0.22.0.dev0__tar.gz

{ras_commander-0.21.0 → ras_commander-0.22.0.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ras_commander
-Version: 0.21.0
+Version: 0.22.0.dev0
 Summary: A library for automating HEC-RAS operations using python functions.
 Author-email: "William Katzenmeyer, P.E., C.F.M." <heccommander@gmail.com>
 Project-URL: Homepage, https://github.com/yourusername/ras_commander
@@ -11,164 +11,7 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 
-## RAS-Commander Library Organization
-
-| Directory/File | Purpose |
-|---|---|
-| ras_commander/__init__.py | Initializes the library and defines the public API. |
-| ras_commander/RasCommander.py | Handles execution of HEC-RAS simulations. |
-| ras_commander/RasFileOps.py | Provides functions for reading and parsing HEC-RAS project files. |
-| ras_commander/RasGeo.py | Provides functions for manipulating geometry files. |
-| ras_commander/RasPlan.py | Provides functions for modifying and updating plan files. |
-| ras_commander/RasPrj.py | Defines the RasPrj class for managing project-level information. |
-| ras_commander/rasinit.py | Provides the `init_ras_project` function to initialize a project. |
-| ras_commander/RasPrj.py | Provides functions for managing HEC-RAS projects (e.g., copying files, updating project file). |
-| ras_commander/RasUnsteady.py | Provides functions for manipulating unsteady flow files. |
-| ras_commander/RasUtils.py | Provides general utility functions (e.g., file backup, directory creation). |
-
-## Project Organization Diagram
-
-```
-ras_commander
-├── .github
-│   └── workflows
-│       └── python-package.yml
-├── ras_commander
-│   ├── __init__.py
-│   ├── RasCommander.py
-│   ├── RasFileOps.py
-│   ├── RasGeo.py
-│   ├── RasPlan.py
-│   ├── RasPrj.py
-│   ├── rasinit.py
-│   ├── RasPrj.py
-│   ├── RasUnsteady.py
-│   └── RasUtils.py
-├── tests
-│   └── ... (test files)
-├── .gitignore
-├── LICENSE
-├── README.md
-├── pyproject.toml
-├── setup.cfg
-└── setup.py
-```
-
-## Functions Overview
-
-| Function | Arguments | Purpose |
-|---|---|---|
-| `init_ras_project` | `ras_project_folder`, `ras_exe_path` | Initializes a HEC-RAS project by setting up the `RasPrj` with project details. |
-| `compute_plan` | `plan_file` | Executes a HEC-RAS plan file. |
-| `compute_plan_from_folder` | `test_plan_file`, `test_folder_path` | Execute a single HEC-RAS plan from a folder other than the project path. |
-| `compute_test_mode` | `project_folder` | Recreates the -test function from the HEC-RAS interface, primarily by copying the project directory, forcing recomputation, and running each plan. |
-| `compute_parallel` | `config`, `max_workers`, `cores_per_run` | Run HEC-RAS plans in parallel. |
-| `compute_parallel_all` | `project_folder`, `ras_exe_path` | Run all HEC-RAS plans in parallel from a project folder path. | 
-
-[The rest of the function list remains the same, just ensure the class names are updated to their new lowercase versions]
-
-## Potential Uses of RAS-Commander Functions
-
-[This section remains unchanged]
-
-## GitHub Actions
-
-[This section remains unchanged]
-
-## Basic Usage Instructions
-
-To get started with RAS-Commander, follow these steps:
-
-1. Install the library:
-   ```
-   pip install ras-commander
-   ```
-
-2. Import the necessary modules:
-   ```python
-   from ras_commander import rasinit, RasFileOps, RasPrj, RasPlan, RasGeo, RasUnsteady, RasCommander, RasUtils
-   ```
-
-3. Initialize a HEC-RAS project:
-   ```python
-   project_folder = r"C:\path\to\your\project"
-   ras_exe_path = r"C:\Program Files (x86)\HEC\HEC-RAS\6.5\Ras.exe"
-   config = rasinit(project_folder, ras_exe_path)
-   ```
-
-4. Perform operations on your HEC-RAS project. For example:
-
-   - Execute a single plan:
-     ```python
-     plan_file = RasPlan.get_plan_path("01")
-     RasCommander.compute_plan(plan_file)
-     ```
-
-   - Run multiple plans in parallel:
-     ```python
-     max_workers = 2
-     cores_per_run = 1
-     results = RasCommander.compute_parallel(config, max_workers, cores_per_run)
-     ```
-
-   - Copy and modify geometry files:
-     ```python
-     RasGeo.clone_geom(config.project_folder, "01")
-     plan_file = RasPlan.get_plan_path("01")
-     RasGeo.set_geom(plan_file, "02")
-     ```
-
-   - Work with unsteady flow files:
-     ```python
-     new_unsteady_number = RasUnsteady.clone_unsteady(config.project_folder, "01")
-     plan_file = RasPlan.get_plan_path("01")
-     RasUnsteady.set_unsteady(plan_file, new_unsteady_number)
-     ```
-
-5. Access project information:
-   ```python
-   print(f"Project name: {config.project_name}")
-   print(f"Project file: {config.prj_file}")
-   print(f"Project folder: {config.project_folder}")
-   ```
-
-For more detailed examples and advanced usage, refer to the function documentation and the examples provided in the repository.
-
-
-
-
-NOTES: INCORPORATE INTO THE README.MD FILE ABOVE UNDER A NEW SECTION FOR CURRENT USES AND ROADMAP ITEMS, THEN DELETE THIS NOTE
-
-
-Potential Uses of HEC-RAS Automation Functions
-This set of functions provides a powerful foundation for automating various aspects of HEC-RAS modeling workflows. Here are some potential applications:
-1. Calibration and Sensitivity Analysis:
-Automated Parameter Variation: Users can create multiple simulation scenarios with varying parameters (e.g., Manning's n values, boundary conditions, initial conditions) to calibrate their model against observed data.
-Sensitivity Testing: Evaluate the impact of different input parameters on model outputs by generating a range of scenarios and analyzing the results. This helps identify critical parameters that require more attention during calibration.
-2. Real-time Forecasting:
-Dynamic Model Updates: Integrate with external data sources (e.g., weather forecasts, streamflow observations) to automatically update boundary conditions and initial conditions in unsteady flow files before running the simulation.
-Ensemble Forecasting: Generate multiple forecasts by incorporating uncertainty in input data and model parameters. This provides a more comprehensive understanding of potential future flow conditions.
-3. Scenario Analysis:
-Land Use Change Impacts: Evaluate the effects of land use changes on flood risk by modifying Manning's n values using extract_2d_mannings_tables, modify_2d_mannings_table, and write_2d_mannings_tables and running simulations with updated geometry files.
-Climate Change Impacts: Analyze the potential impacts of projected climate changes on flood risk by adjusting precipitation patterns and other relevant parameters in unsteady flow files.
-4. Batch Processing and High-Performance Computing:
-Large-scale Model Runs: Utilize run_plans_parallel to execute multiple simulations concurrently on a multi-core system, significantly reducing processing time for large-scale models or complex scenarios.
-Automated Report Generation: Integrate with Python libraries like matplotlib and bokeh to automatically generate customized reports summarizing simulation results, including tables, figures, and maps.
-5. Model Development and Testing:
-Rapid Prototyping: Quickly set up and run new model configurations using template files and automated workflows, facilitating rapid model development and testing.
-Regression Testing: Ensure model integrity and consistency after code changes or updates by automatically running a predefined set of simulations and comparing results with expected outputs.
-6. User-Friendly Interfaces:
-GUI Development: Integrate with Python GUI libraries like Tkinter or PyQt to create user-friendly interfaces for automating HEC-RAS workflows, allowing non-programmers to access the power of automation.
-
-
-
-
-
-
-Certainly! I'll create an updated README.md for the ras_commander library, incorporating the information you've provided and the context from the previous HEC-Commander tools. Here's the updated README.md:
-
-```markdown
-# ras_commander
+# RAS-Commander (ras_commander)
 
 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 is an evolution of the RAS-Commander 1.0 Python Notebook Application previously released under the HEC-Commander tools.
 
@@ -186,13 +29,13 @@ ras_commander is a Python library for automating HEC-RAS operations, providing a
 Install ras_commander using pip:
 
 ```bash
-pip install ras_commander
+pip install ras-commander
 ```
 
 ## Requirements
 
 - Python 3.9+
-- HEC-RAS 6.5 (other versions may work but are not officially supported)
+- HEC-RAS 6.2 or later (other versions may work, all testing was done with version 6.2 and above)
 
 For a full list of dependencies, see the `requirements.txt` file.
 
@@ -297,9 +140,10 @@ ras_commander
 ├── setup.cfg
 ├── setup.py
 └── requirements.txt
+```
 
 
-## Inclusion of .cursorrules for AI-driven Coding Experience
+## Inclusion of .cursorrules and ai_tools for AI-driven Coding Experience
 
 Open the ras_commander folder in the Cursor IDE, and it will automatically include the .cursorrules file in your instructions.  Additionally, two other provided methods for interacting with the library though your current AI subscriptions: 
 
@@ -308,6 +152,7 @@ Open the ras_commander folder in the Cursor IDE, and it will automatically inclu
    - Entire code base: LINK HERE (TOKEN COUNT) (for Claude or Gemini)
    - Examples and Function Docstrings Only: LINK HERE (TOKEN COUNT) (for GPT-4o, o1 or Llama 3.1 405b)
 - Cursor IDE through .cursorrules file
+- 'rascommander_code_assistant.ipynb' notebook in the ras_commander folder, which allows for dynamic summarization of the code base and API chatting directly through the notebook. 
 
 There are a series of scripts provided in the "llm_summaries" folder that provide summaries of the code base, and the docstrings of the functions.  They can be run in your local environment, or provided to ChatGPT's code interpreter for execution.  
 
@@ -324,8 +169,6 @@ We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) f
 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.
@@ -340,3 +183,36 @@ ras_commander is based on the HEC-Commander project's "Command Line is All You N
 
 For questions, suggestions, or support, please contact:
 William Katzenmeyer, P.E., C.F.M. - billk@fenstermaker.com
+
+
+
+
+
+
+
+
+
+NOTES: INCORPORATE INTO THE README.MD FILE ABOVE UNDER A NEW SECTION FOR CURRENT USES AND ROADMAP ITEMS, THEN DELETE THIS NOTE
+
+
+Potential Uses of HEC-RAS Automation Functions
+This set of functions provides a powerful foundation for automating various aspects of HEC-RAS modeling workflows. Here are some potential applications:
+1. Calibration and Sensitivity Analysis:
+Automated Parameter Variation: Users can create multiple simulation scenarios with varying parameters (e.g., Manning's n values, boundary conditions, initial conditions) to calibrate their model against observed data.
+Sensitivity Testing: Evaluate the impact of different input parameters on model outputs by generating a range of scenarios and analyzing the results. This helps identify critical parameters that require more attention during calibration.
+2. Real-time Forecasting:
+Dynamic Model Updates: Integrate with external data sources (e.g., weather forecasts, streamflow observations) to automatically update boundary conditions and initial conditions in unsteady flow files before running the simulation.
+Ensemble Forecasting: Generate multiple forecasts by incorporating uncertainty in input data and model parameters. This provides a more comprehensive understanding of potential future flow conditions.
+3. Scenario Analysis:
+Land Use Change Impacts: Evaluate the effects of land use changes on flood risk by modifying Manning's n values using extract_2d_mannings_tables, modify_2d_mannings_table, and write_2d_mannings_tables and running simulations with updated geometry files.
+Climate Change Impacts: Analyze the potential impacts of projected climate changes on flood risk by adjusting precipitation patterns and other relevant parameters in unsteady flow files.
+4. Batch Processing and High-Performance Computing:
+Large-scale Model Runs: Utilize run_plans_parallel to execute multiple simulations concurrently on a multi-core system, significantly reducing processing time for large-scale models or complex scenarios.
+Automated Report Generation: Integrate with Python libraries like matplotlib and bokeh to automatically generate customized reports summarizing simulation results, including tables, figures, and maps.
+5. Model Development and Testing:
+Rapid Prototyping: Quickly set up and run new model configurations using template files and automated workflows, facilitating rapid model development and testing.
+Regression Testing: Ensure model integrity and consistency after code changes or updates by automatically running a predefined set of simulations and comparing results with expected outputs.
+6. User-Friendly Interfaces:
+GUI Development: Integrate with Python GUI libraries like Tkinter or PyQt to create user-friendly interfaces for automating HEC-RAS workflows, allowing non-programmers to access the power of automation.
+
+

{ras_commander-0.21.0 → ras_commander-0.22.0.dev0}/README.md

@@ -1,161 +1,4 @@
-## RAS-Commander Library Organization
-
-| Directory/File | Purpose |
-|---|---|
-| ras_commander/__init__.py | Initializes the library and defines the public API. |
-| ras_commander/RasCommander.py | Handles execution of HEC-RAS simulations. |
-| ras_commander/RasFileOps.py | Provides functions for reading and parsing HEC-RAS project files. |
-| ras_commander/RasGeo.py | Provides functions for manipulating geometry files. |
-| ras_commander/RasPlan.py | Provides functions for modifying and updating plan files. |
-| ras_commander/RasPrj.py | Defines the RasPrj class for managing project-level information. |
-| ras_commander/rasinit.py | Provides the `init_ras_project` function to initialize a project. |
-| ras_commander/RasPrj.py | Provides functions for managing HEC-RAS projects (e.g., copying files, updating project file). |
-| ras_commander/RasUnsteady.py | Provides functions for manipulating unsteady flow files. |
-| ras_commander/RasUtils.py | Provides general utility functions (e.g., file backup, directory creation). |
-
-## Project Organization Diagram
-
-```
-ras_commander
-├── .github
-│   └── workflows
-│       └── python-package.yml
-├── ras_commander
-│   ├── __init__.py
-│   ├── RasCommander.py
-│   ├── RasFileOps.py
-│   ├── RasGeo.py
-│   ├── RasPlan.py
-│   ├── RasPrj.py
-│   ├── rasinit.py
-│   ├── RasPrj.py
-│   ├── RasUnsteady.py
-│   └── RasUtils.py
-├── tests
-│   └── ... (test files)
-├── .gitignore
-├── LICENSE
-├── README.md
-├── pyproject.toml
-├── setup.cfg
-└── setup.py
-```
-
-## Functions Overview
-
-| Function | Arguments | Purpose |
-|---|---|---|
-| `init_ras_project` | `ras_project_folder`, `ras_exe_path` | Initializes a HEC-RAS project by setting up the `RasPrj` with project details. |
-| `compute_plan` | `plan_file` | Executes a HEC-RAS plan file. |
-| `compute_plan_from_folder` | `test_plan_file`, `test_folder_path` | Execute a single HEC-RAS plan from a folder other than the project path. |
-| `compute_test_mode` | `project_folder` | Recreates the -test function from the HEC-RAS interface, primarily by copying the project directory, forcing recomputation, and running each plan. |
-| `compute_parallel` | `config`, `max_workers`, `cores_per_run` | Run HEC-RAS plans in parallel. |
-| `compute_parallel_all` | `project_folder`, `ras_exe_path` | Run all HEC-RAS plans in parallel from a project folder path. | 
-
-[The rest of the function list remains the same, just ensure the class names are updated to their new lowercase versions]
-
-## Potential Uses of RAS-Commander Functions
-
-[This section remains unchanged]
-
-## GitHub Actions
-
-[This section remains unchanged]
-
-## Basic Usage Instructions
-
-To get started with RAS-Commander, follow these steps:
-
-1. Install the library:
-   ```
-   pip install ras-commander
-   ```
-
-2. Import the necessary modules:
-   ```python
-   from ras_commander import rasinit, RasFileOps, RasPrj, RasPlan, RasGeo, RasUnsteady, RasCommander, RasUtils
-   ```
-
-3. Initialize a HEC-RAS project:
-   ```python
-   project_folder = r"C:\path\to\your\project"
-   ras_exe_path = r"C:\Program Files (x86)\HEC\HEC-RAS\6.5\Ras.exe"
-   config = rasinit(project_folder, ras_exe_path)
-   ```
-
-4. Perform operations on your HEC-RAS project. For example:
-
-   - Execute a single plan:
-     ```python
-     plan_file = RasPlan.get_plan_path("01")
-     RasCommander.compute_plan(plan_file)
-     ```
-
-   - Run multiple plans in parallel:
-     ```python
-     max_workers = 2
-     cores_per_run = 1
-     results = RasCommander.compute_parallel(config, max_workers, cores_per_run)
-     ```
-
-   - Copy and modify geometry files:
-     ```python
-     RasGeo.clone_geom(config.project_folder, "01")
-     plan_file = RasPlan.get_plan_path("01")
-     RasGeo.set_geom(plan_file, "02")
-     ```
-
-   - Work with unsteady flow files:
-     ```python
-     new_unsteady_number = RasUnsteady.clone_unsteady(config.project_folder, "01")
-     plan_file = RasPlan.get_plan_path("01")
-     RasUnsteady.set_unsteady(plan_file, new_unsteady_number)
-     ```
-
-5. Access project information:
-   ```python
-   print(f"Project name: {config.project_name}")
-   print(f"Project file: {config.prj_file}")
-   print(f"Project folder: {config.project_folder}")
-   ```
-
-For more detailed examples and advanced usage, refer to the function documentation and the examples provided in the repository.
-
-
-
-
-NOTES: INCORPORATE INTO THE README.MD FILE ABOVE UNDER A NEW SECTION FOR CURRENT USES AND ROADMAP ITEMS, THEN DELETE THIS NOTE
-
-
-Potential Uses of HEC-RAS Automation Functions
-This set of functions provides a powerful foundation for automating various aspects of HEC-RAS modeling workflows. Here are some potential applications:
-1. Calibration and Sensitivity Analysis:
-Automated Parameter Variation: Users can create multiple simulation scenarios with varying parameters (e.g., Manning's n values, boundary conditions, initial conditions) to calibrate their model against observed data.
-Sensitivity Testing: Evaluate the impact of different input parameters on model outputs by generating a range of scenarios and analyzing the results. This helps identify critical parameters that require more attention during calibration.
-2. Real-time Forecasting:
-Dynamic Model Updates: Integrate with external data sources (e.g., weather forecasts, streamflow observations) to automatically update boundary conditions and initial conditions in unsteady flow files before running the simulation.
-Ensemble Forecasting: Generate multiple forecasts by incorporating uncertainty in input data and model parameters. This provides a more comprehensive understanding of potential future flow conditions.
-3. Scenario Analysis:
-Land Use Change Impacts: Evaluate the effects of land use changes on flood risk by modifying Manning's n values using extract_2d_mannings_tables, modify_2d_mannings_table, and write_2d_mannings_tables and running simulations with updated geometry files.
-Climate Change Impacts: Analyze the potential impacts of projected climate changes on flood risk by adjusting precipitation patterns and other relevant parameters in unsteady flow files.
-4. Batch Processing and High-Performance Computing:
-Large-scale Model Runs: Utilize run_plans_parallel to execute multiple simulations concurrently on a multi-core system, significantly reducing processing time for large-scale models or complex scenarios.
-Automated Report Generation: Integrate with Python libraries like matplotlib and bokeh to automatically generate customized reports summarizing simulation results, including tables, figures, and maps.
-5. Model Development and Testing:
-Rapid Prototyping: Quickly set up and run new model configurations using template files and automated workflows, facilitating rapid model development and testing.
-Regression Testing: Ensure model integrity and consistency after code changes or updates by automatically running a predefined set of simulations and comparing results with expected outputs.
-6. User-Friendly Interfaces:
-GUI Development: Integrate with Python GUI libraries like Tkinter or PyQt to create user-friendly interfaces for automating HEC-RAS workflows, allowing non-programmers to access the power of automation.
-
-
-
-
-
-
-Certainly! I'll create an updated README.md for the ras_commander library, incorporating the information you've provided and the context from the previous HEC-Commander tools. Here's the updated README.md:
-
-```markdown
-# ras_commander
+# RAS-Commander (ras_commander)
 
 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 is an evolution of the RAS-Commander 1.0 Python Notebook Application previously released under the HEC-Commander tools.
 
@@ -173,13 +16,13 @@ ras_commander is a Python library for automating HEC-RAS operations, providing a
 Install ras_commander using pip:
 
 ```bash
-pip install ras_commander
+pip install ras-commander
 ```
 
 ## Requirements
 
 - Python 3.9+
-- HEC-RAS 6.5 (other versions may work but are not officially supported)
+- HEC-RAS 6.2 or later (other versions may work, all testing was done with version 6.2 and above)
 
 For a full list of dependencies, see the `requirements.txt` file.
 
@@ -284,9 +127,10 @@ ras_commander
 ├── setup.cfg
 ├── setup.py
 └── requirements.txt
+```
 
 
-## Inclusion of .cursorrules for AI-driven Coding Experience
+## Inclusion of .cursorrules and ai_tools for AI-driven Coding Experience
 
 Open the ras_commander folder in the Cursor IDE, and it will automatically include the .cursorrules file in your instructions.  Additionally, two other provided methods for interacting with the library though your current AI subscriptions: 
 
@@ -295,6 +139,7 @@ Open the ras_commander folder in the Cursor IDE, and it will automatically inclu
    - Entire code base: LINK HERE (TOKEN COUNT) (for Claude or Gemini)
    - Examples and Function Docstrings Only: LINK HERE (TOKEN COUNT) (for GPT-4o, o1 or Llama 3.1 405b)
 - Cursor IDE through .cursorrules file
+- 'rascommander_code_assistant.ipynb' notebook in the ras_commander folder, which allows for dynamic summarization of the code base and API chatting directly through the notebook. 
 
 There are a series of scripts provided in the "llm_summaries" folder that provide summaries of the code base, and the docstrings of the functions.  They can be run in your local environment, or provided to ChatGPT's code interpreter for execution.  
 
@@ -311,8 +156,6 @@ We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) f
 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.
@@ -327,3 +170,36 @@ ras_commander is based on the HEC-Commander project's "Command Line is All You N
 
 For questions, suggestions, or support, please contact:
 William Katzenmeyer, P.E., C.F.M. - billk@fenstermaker.com
+
+
+
+
+
+
+
+
+
+NOTES: INCORPORATE INTO THE README.MD FILE ABOVE UNDER A NEW SECTION FOR CURRENT USES AND ROADMAP ITEMS, THEN DELETE THIS NOTE
+
+
+Potential Uses of HEC-RAS Automation Functions
+This set of functions provides a powerful foundation for automating various aspects of HEC-RAS modeling workflows. Here are some potential applications:
+1. Calibration and Sensitivity Analysis:
+Automated Parameter Variation: Users can create multiple simulation scenarios with varying parameters (e.g., Manning's n values, boundary conditions, initial conditions) to calibrate their model against observed data.
+Sensitivity Testing: Evaluate the impact of different input parameters on model outputs by generating a range of scenarios and analyzing the results. This helps identify critical parameters that require more attention during calibration.
+2. Real-time Forecasting:
+Dynamic Model Updates: Integrate with external data sources (e.g., weather forecasts, streamflow observations) to automatically update boundary conditions and initial conditions in unsteady flow files before running the simulation.
+Ensemble Forecasting: Generate multiple forecasts by incorporating uncertainty in input data and model parameters. This provides a more comprehensive understanding of potential future flow conditions.
+3. Scenario Analysis:
+Land Use Change Impacts: Evaluate the effects of land use changes on flood risk by modifying Manning's n values using extract_2d_mannings_tables, modify_2d_mannings_table, and write_2d_mannings_tables and running simulations with updated geometry files.
+Climate Change Impacts: Analyze the potential impacts of projected climate changes on flood risk by adjusting precipitation patterns and other relevant parameters in unsteady flow files.
+4. Batch Processing and High-Performance Computing:
+Large-scale Model Runs: Utilize run_plans_parallel to execute multiple simulations concurrently on a multi-core system, significantly reducing processing time for large-scale models or complex scenarios.
+Automated Report Generation: Integrate with Python libraries like matplotlib and bokeh to automatically generate customized reports summarizing simulation results, including tables, figures, and maps.
+5. Model Development and Testing:
+Rapid Prototyping: Quickly set up and run new model configurations using template files and automated workflows, facilitating rapid model development and testing.
+Regression Testing: Ensure model integrity and consistency after code changes or updates by automatically running a predefined set of simulations and comparing results with expected outputs.
+6. User-Friendly Interfaces:
+GUI Development: Integrate with Python GUI libraries like Tkinter or PyQt to create user-friendly interfaces for automating HEC-RAS workflows, allowing non-programmers to access the power of automation.
+
+

ras_commander-0.22.0.dev0/ai_tools/README.md

@@ -0,0 +1,3 @@
+# AI Tools and Scripts for the RAS Commander Repository
+
+This folder contains AI tools and scripts for the RAS Commander repository.

ras_commander-0.22.0.dev0/ai_tools/llmsummarize 1. full repo.py

@@ -0,0 +1,66 @@
+from pathlib import Path
+
+# Get the name of this script
+this_script = Path(__file__).name
+print(f"Script name: {this_script}")
+
+# Define the subfolder to summarize
+summarize_subfolder = Path(__file__).parent.parent
+print(f"Subfolder to summarize: {summarize_subfolder}")
+
+# Define the output file name based on the folder name
+output_file_name = f"{summarize_subfolder.name}.txt"
+output_file_path = Path(__file__).parent / "llm_summary" / output_file_name
+print(f"Output file path: {output_file_path}")
+
+# Ensure the output directory exists
+output_file_path.parent.mkdir(parents=True, exist_ok=True)
+print(f"Output directory ensured to exist: {output_file_path.parent}")
+
+# Define folders to omit
+omit_folders = ["Bald Eagle Creek", "__pycache__", ".git", ".github", "tests", "build", "dist", "ras_commander.egg-info", "venv", "example_projects", "llm_summary", "misc",]
+print(f"Folders to omit: {omit_folders}")
+
+# Define files or extensions to omit
+omit_files = [".pyc", ".pyo", ".pyd", ".dll", ".so", ".dylib", ".exe", ".bat", ".sh", ".log", ".tmp", ".bak", ".swp", ".DS_Store", "Thumbs.db", "example_projects.zip", "Example_Projects_6_5.zip", "example_projects.ipynb",]
+print(f"Files or extensions to omit: {omit_files}")
+
+# Open the output file
+with open(output_file_path, 'w', encoding='utf-8') as outfile:
+    print(f"Opened output file: {output_file_path}")
+    # Iterate over all files and subfolders in the summarize_subfolder directory
+    for filepath in summarize_subfolder.rglob('*'):
+        # Check if the file is not this script, not in the omit_folders, and not in omit_files
+        if (filepath.name != this_script and 
+            not any(omit_folder in filepath.parts for omit_folder in omit_folders) and
+            not any(filepath.suffix == ext or filepath.name == ext for ext in omit_files)):
+            # Write the filename or folder name
+            if filepath.is_file():
+                outfile.write(f"File: {filepath}\n")
+                print(f"Writing file: {filepath}")
+            else:
+                outfile.write(f"Folder: {filepath}\n")
+                print(f"Writing folder: {filepath}")
+            outfile.write("="*50 + "\n")  # Separator
+            
+            # If it's a file, open and read the contents of the file
+            if filepath.is_file():
+                try:
+                    with open(filepath, 'r', encoding='utf-8') as infile:
+                        content = infile.read()
+                        print(f"Reading content of file: {filepath}")
+                except UnicodeDecodeError:
+                    with open(filepath, 'rb') as infile:
+                        content = infile.read()
+                        content = content.decode('utf-8', errors='ignore')
+                        print(f"Reading and converting content of file: {filepath}")
+                
+                # Write the contents to the output file
+                outfile.write(content)
+                print(f"Written content of file: {filepath}")
+            
+            # Write a separator after the file contents or folder name
+            outfile.write("\n" + "="*50 + "\n\n")
+            print(f"Written separator for: {filepath}")
+
+print(f"All files and folders have been combined into '{output_file_path}'")

ras_commander-0.22.0.dev0/ai_tools/llmsummarize 2. docs and code only.py

@@ -0,0 +1,66 @@
+from pathlib import Path
+
+# Get the name of this script
+this_script = Path(__file__).name
+print(f"Script name: {this_script}")
+
+# Define the subfolder to summarize
+summarize_subfolder = Path(__file__).parent.parent
+print(f"Subfolder to summarize: {summarize_subfolder}")
+
+# Define the output file name based on the folder name
+output_file_name = f"{summarize_subfolder.name}_code_only.txt"
+output_file_path = Path(__file__).parent / "llm_summary" / output_file_name
+print(f"Output file path: {output_file_path}")
+
+# Ensure the output directory exists
+output_file_path.parent.mkdir(parents=True, exist_ok=True)
+print(f"Output directory ensured to exist: {output_file_path.parent}")
+
+# Define folders to omit
+omit_folders = ["Bald Eagle Creek", "__pycache__", ".git", ".github", "tests", "build", "dist", "ras_commander.egg-info", "venv", "example_projects", "llm_summary", "misc", "future", ".github"]
+print(f"Folders to omit: {omit_folders}")
+
+# Define files or extensions to omit
+omit_files = [".pyc", ".pyo", ".pyd", ".dll", ".so", ".dylib", ".exe", ".bat", ".sh", ".log", ".tmp", ".bak", ".swp", ".DS_Store", "Thumbs.db", "example_projects.zip", "11_accessing_example_projects.ipynb", "Example_Projects_6_5.zip"]
+print(f"Files or extensions to omit: {omit_files}")
+
+# Open the output file
+with open(output_file_path, 'w', encoding='utf-8') as outfile:
+    print(f"Opened output file: {output_file_path}")
+    # Iterate over all files and subfolders in the summarize_subfolder directory
+    for filepath in summarize_subfolder.rglob('*'):
+        # Check if the file is not this script, not in the omit_folders, and not in omit_files
+        if (filepath.name != this_script and 
+            not any(omit_folder in filepath.parts for omit_folder in omit_folders) and
+            not any(filepath.suffix == ext or filepath.name == ext for ext in omit_files)):
+            # Write the filename or folder name
+            if filepath.is_file():
+                outfile.write(f"File: {filepath}\n")
+                print(f"Writing file: {filepath}")
+            else:
+                outfile.write(f"Folder: {filepath}\n")
+                print(f"Writing folder: {filepath}")
+            outfile.write("="*50 + "\n")  # Separator
+            
+            # If it's a file, open and read the contents of the file
+            if filepath.is_file():
+                try:
+                    with open(filepath, 'r', encoding='utf-8') as infile:
+                        content = infile.read()
+                        print(f"Reading content of file: {filepath}")
+                except UnicodeDecodeError:
+                    with open(filepath, 'rb') as infile:
+                        content = infile.read()
+                        content = content.decode('utf-8', errors='ignore')
+                        print(f"Reading and converting content of file: {filepath}")
+                
+                # Write the contents to the output file
+                outfile.write(content)
+                print(f"Written content of file: {filepath}")
+            
+            # Write a separator after the file contents or folder name
+            outfile.write("\n" + "="*50 + "\n\n")
+            print(f"Written separator for: {filepath}")
+
+print(f"All files and folders have been combined into '{output_file_path}'")