xiaohongshu
xiaohongshu
hecras_compute_remote
Distributed HEC-RAS execution across remote workers (PsExec, Docker, SSH, cloud). Handles worker initialization, queue scheduling, and result aggregation. Use when setting up remote execution, distributed computation, cloud workflows, scaling HEC-RAS across machines, parallel processing on multip...
Full skill instructions
Execute HEC-RAS plans across multiple remote machines using distributed workers.
PRIMARY SOURCES: This skill is a lightweight navigator. For complete details, see:
ras_commander/remote/AGENTS.md- Coding conventions, architecture.claude/rules/hec-ras/remote.md- Machine setup (Group Policy, Registry, session_id)examples/500_remote_execution_psexec.ipynb- Complete PsExec workflow
from ras_commander import init_ras_project, init_ras_worker, compute_parallel_remote
# Initialize project
init_ras_project("/path/to/project", "6.6")
# Create PsExec worker (Windows remote)
worker = init_ras_worker(
"psexec",
hostname="192.168.1.100",
share_path=r"\\192.168.1.100\RasRemote",
session_id=2, # CRITICAL: Query with "query session /server:hostname"
cores_total=16,
cores_per_plan=4
)
# Execute plans remotely
results = compute_parallel_remote(
plan_numbers=["01", "02", "03"],
workers=[worker],
num_cores=4
)
# Check results
for plan_num, result in results.items():
if result.success:
print(f"Plan {plan_num}: SUCCESS ({result.execution_time:.1f}s)")
print(f" HDF: {result.hdf_path}")
else:
print(f"Plan {plan_num}: FAILED - {result.error_message}")
HEC-RAS is a GUI application and REQUIRES session-based execution:
worker = init_ras_worker(
"psexec",
hostname="192.168.1.100",
share_path=r"\\192.168.1.100\RasRemote",
session_id=2, # CRITICAL: NOT system account
...
)
NEVER use system_account=True - HEC-RAS will hang without desktop session.
Query from controlling machine:
query session /server:192.168.1.100
# Output:
# SESSIONNAME USERNAME ID STATE
# console Administrator 2 Active
# ^
# Use this value
Typical Values:
See ras_commander/remote/AGENTS.md lines 97-101 for critical implementation notes.
Parallel execution on local machine:
worker = init_ras_worker(
"local",
worker_folder="C:/RasRemote",
cores_total=8,
cores_per_plan=2
)
Windows remote via network share:
worker = init_ras_worker(
"psexec",
hostname="192.168.1.100",
share_path=r"\\192.168.1.100\RasRemote", # UNC path from controlling machine
worker_folder=r"C:\RasRemote", # Local path on remote machine
session_id=2, # CRITICAL: Query with "query session"
cores_total=16,
cores_per_plan=4
)
Setup Requirements (see REMOTE_WORKER_SETUP_GUIDE.md):
C:\RasRemote shared as \\hostname\RasRemote)LocalAccountTokenFilterPolicy=1Container execution (local or remote):
# Local Docker
worker = init_ras_worker(
"docker",
docker_image="hecras:6.6",
cores_total=8,
cores_per_plan=4,
preprocess_on_host=True # Windows preprocessing, Linux execution
)
# Remote Docker via SSH
worker = init_ras_worker(
"docker",
docker_image="hecras:6.6",
docker_host="ssh://[email protected]",
ssh_key_path="~/.ssh/docker_worker",
share_path=r"\\192.168.1.100\DockerShare",
remote_staging_path=r"C:\DockerShare",
cores_total=8,
cores_per_plan=4
)
Docker Prerequisites:
pip install docker paramikoras-commander-cloud repo)results = compute_parallel_remote(
plan_numbers=["01", "02", "03"], # Plans to execute
workers=[worker1, worker2], # List of initialized workers
num_cores=4, # Cores per plan execution
clear_geompre=False, # Clear geometry preprocessor files
max_concurrent=None, # Max simultaneous executions (default: all slots)
autoclean=True # Delete temp folders after execution
)
Returns: Dict[str, ExecutionResult]
plan_number - Plan that was executedworker_id - Worker that executed the plansuccess - True if successfulhdf_path - Path to output HDF fileerror_message - Error message if failedexecution_time - Execution time in secondsWorkers execute in priority order (lower queue_priority first):
# Local workers execute first (priority 0)
local = init_ras_worker("local", queue_priority=0, cores_total=8, cores_per_plan=2)
# Remote workers used when local full (priority 1)
remote = init_ras_worker("psexec", hostname="...", queue_priority=1, ...)
# Cloud workers for overflow (priority 2)
cloud = init_ras_worker("docker", docker_host="...", queue_priority=2, ...)
# Plans fill local slots first, then remote, then cloud
results = compute_parallel_remote(
plan_numbers=["01", "02", "03", "04", "05", "06"],
workers=[local, remote, cloud]
)
Worker Slots: Workers with max_parallel_plans > 1 create multiple slots:
cores_total=16 and cores_per_plan=4 → 4 parallel slotsmax_parallel_plansCombine local, remote, and cloud workers:
# Local worker (priority 0)
local = init_ras_worker(
"local",
worker_folder="C:/RasRemote",
cores_total=8,
cores_per_plan=2,
queue_priority=0
)
# Remote PsExec worker (priority 1)
remote = init_ras_worker(
"psexec",
hostname="192.168.1.100",
share_path=r"\\192.168.1.100\RasRemote",
session_id=2,
cores_total=16,
cores_per_plan=4,
queue_priority=1
)
# Docker worker (priority 2)
docker = init_ras_worker(
"docker",
docker_image="hecras:6.6",
docker_host="ssh://[email protected]",
ssh_key_path="~/.ssh/docker",
cores_total=8,
cores_per_plan=4,
queue_priority=2
)
# Execute with queue-aware scheduling
results = compute_parallel_remote(
plan_numbers=["01", "02", "03", "04", "05", "06", "07", "08"],
workers=[local, remote, docker]
)
results = compute_parallel_remote(plan_numbers=["01", "02"], workers=[worker])
for plan_num, result in results.items():
print(f"\nPlan {plan_num}:")
print(f" Worker: {result.worker_id}")
print(f" Success: {result.success}")
print(f" Time: {result.execution_time:.1f}s")
if result.success:
print(f" HDF: {result.hdf_path}")
# Verify HDF
from ras_commander import HdfResultsPlan
msgs = HdfResultsPlan.get_compute_messages(result.hdf_path)
if "completed successfully" in msgs.lower():
print(f" Status: Verified successful")
else:
print(f" Error: {result.error_message}")
Symptom: No error, HDF not created
Diagnosis:
# Check session ID
query session /server:192.168.1.100
# Verify user is Administrator
net localgroup Administrators
# Check Remote Registry service
sc query RemoteRegistry
Fix: Ensure session_id=2 (or correct session) and all configuration requirements met.
See REMOTE_WORKER_SETUP_GUIDE.md for complete setup instructions.
Symptom: "Access is denied"
Fix: Check:
LocalAccountTokenFilterPolicy=1Symptom: Cannot access \\hostname\share
Diagnosis:
# Test from controlling machine
dir \\192.168.1.100\RasRemote
# Check firewall (port 445 SMB)
Test-NetConnection -ComputerName 192.168.1.100 -Port 445
# Verify Remote Registry running
sc \\192.168.1.100 query RemoteRegistry
Symptom: Cannot connect to Docker daemon
Diagnosis:
# Test Docker locally
docker ps
# Test remote Docker via SSH
ssh [email protected] "docker info"
Fix: Ensure Docker Desktop running (local) or SSH keys configured (remote)
See ras_commander/remote/AGENTS.md for complete module structure and coding conventions.
ras_commander/remote/
├── __init__.py # Exports all public classes and functions
├── RasWorker.py # RasWorker base dataclass + init_ras_worker()
├── PsexecWorker.py # PsexecWorker (IMPLEMENTED)
├── LocalWorker.py # LocalWorker (IMPLEMENTED)
├── DockerWorker.py # DockerWorker (IMPLEMENTED, requires docker+paramiko)
├── SshWorker.py # SshWorker (stub, requires paramiko)
├── WinrmWorker.py # WinrmWorker (stub, requires pywinrm)
├── SlurmWorker.py # SlurmWorker (stub)
├── AwsEc2Worker.py # AwsEc2Worker (stub, requires boto3)
├── AzureFrWorker.py # AzureFrWorker (stub, requires azure-*)
├── Execution.py # compute_parallel_remote() + helpers
└── Utils.py # Shared utilities
# Top-level factory function (recommended)
worker = init_ras_worker(worker_type, **config)
# Lazy imports and routing to worker-specific functions
# See RasWorker.py lines 84-92 for implementation
Workers with optional dependencies implement check_*_dependencies():
pip install docker paramikopip install paramikopip install boto3See ras_commander/remote/AGENTS.md lines 58-68 for lazy loading pattern.
ras_commander/remote/AGENTS.md (156 lines)
examples/500_remote_execution_psexec.ipynb
.claude/rules/hec-ras/remote.md
executing-plans - Local plan executionprocessing-hdf-results - Results analysisxiaohongshu
technical spec
product ux expert
database patterns
Conduct multi-agent task orchestration and workflow coordination.
Initialize project with Conductor artifacts (product definition,
Expert in web animations, transitions, and motion design using Framer Motion and CSS
Creates Mermaid and ASCII diagrams for flowcharts, architecture, ERDs, state machines, mindmaps, and more. Use when user mentions diagram, flowchart, mermaid, ASCII diagram, text diagram, terminal diagram, visualize, C4, mindmap, architecture diagram, sequence diagram, ERD, or needs visual docume...
PostgreSQL bindings for H3 hexagonal grid system. Use when working with H3 cells in Postgres, including spatial indexing, geometry/geography integration, and raster analysis.
Context-Driven Development skill for projects using Conductor. Use this skill when you detect a `conductor/` directory in the project, when working on tasks defined in a `plan.md` file, or when the user asks about tracks, specs, or plans. Automatically applies TDD workflow, tracks task completion...
Display project status, active tracks, and next actions
Official Stakpak application containerization standard operating procedure, a step-by-step guidline to properly dockerize applications. This is a rule book curated by the Stakpak Team.
Generate, edit, and beat-sync AI video with leading models in one workspace.
The world's fastest calendar for remote work
Transform Your Design with AI Designer by ImgCreator.ai
Revolutionizing Video Production with AI-Powered Creativity
Extend an image past the frame and let AI fill the new aspect ratio.
Discover your celebrity doppelgänger with StarByFace!
ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.
Opus.ai: Revolutionize Your Web Experience