run_simulation
Queue high-fidelity physics simulations for disaster scenarios using digital twin technology. Monitor progress via subscription and retrieve results from NeoFS upon completion.
Instructions
Trigger a Digital Twin physics simulation for disaster scenario modeling.
Queues a high-fidelity simulation job and returns immediately with a job ID. Clients should subscribe to the simulation resource URI for real-time progress updates and result notification.
Workflow: 1. Validate simulation request parameters 2. Generate unique simulation ID 3. Queue job to DTSOP backend (Unity/Unreal Engine) 4. Store job metadata in simulation registry 5. Return simulation ID and subscription URI 6. Background processor updates status → processing → completed 7. Client fetches results from NeoFS when completed
Args: request: SimulationRequest with: - scenario_id: Unique scenario identifier - sector_id: Geographic sector to simulate - disaster_type: Physics model (flood/wildfire/earthquake) - parameters: Scenario params (wind_speed, water_level, etc.) - priority: "standard" or "urgent" ctx: Optional FastMCP context for logging.
Returns: str: Message with simulation ID and subscription instructions: "Simulation queued with ID: SIM-XXXXXXXX. Subscribe to resq://simulations/SIM-XXXXXXXX for updates."
Example: >>> from resq_mcp.models import SimulationRequest >>> request = SimulationRequest( ... scenario_id="flood-001", ... sector_id="Sector-1", ... disaster_type="flood", ... parameters={"water_level": 2.5}, ... priority="urgent" ... ) >>> result = await run_simulation(request) >>> print(result) # "Simulation queued with ID: SIM-ABCD1234..."
Integration: Production would: - Validate request against simulation templates - Check cluster capacity and queue position - Store job in Redis with priority - Submit to Unity/Unreal Engine processing cluster - Return estimated completion time
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| request | Yes | Request for high-fidelity physics simulation in digital twin. Part of DTSOP system. Triggers physics-based simulation in Unity/Unreal Engine for accurate disaster propagation modeling and strategy validation. Attributes: scenario_id: Unique scenario identifier for this simulation. sector_id: Geographic sector to simulate. disaster_type: Type of disaster to model (e.g., "flood", "wildfire"). parameters: Simulation parameters (e.g., {"wind_speed": 15.5, "water_level": 2.3}). priority: Processing priority (standard queued, urgent fast-tracked). Note: Simulations run asynchronously. Monitor progress via the returned simulation ID and resource subscription (resq://simulations/{id}). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |