Spr set head spray
spr_set_head_sprayConfigure or reset per-head sprinkler spray settings for pipe-network, obstacle, and DEVC heads by IDs, groups, or networks, and link them to shared profiles.
Instructions
Set per-head spray settings on one or many sprinkler heads — pipe-network heads, obstacle sprinklers and DEVC sprinklers alike (the GUI spray dialog "this head only" path). Pick heads with all / group (interlock or deluge group) / network_of_node / head_ids / node_ids / obstacle_ids / device_ids. profile_id links them to a shared profile (pipe heads take its K, activation temperature and RTI unless keep_head_values). prop / part override single FDS keys for these heads only; inherit lists keys to hand back to the profile (prop/part keys or orientation, rotation, pipe_index, activation); reset drops every override. orientation / rotation / pipe_index / activation are DEVC values. head_type applies to pipe heads (upright still sprays down). All heads are checked first; if any would be an FDS error nothing changes. Pipe heads whose K changed need spr_run_calc then spr_apply_to_fds. [bulc-mcp rules] DEVC-001, SPR-010, SPR-011 — bulc_knowledge_search ""
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| all | No | every sprinkler head in the project (pipe network, obstacle and DEVC sprinklers) | |
| part | No | Per-head &PART droplet overrides — same keys and units as spr_upsert_spray_profile.part | |
| prop | No | Per-head &PROP overrides — same keys and units as spr_upsert_spray_profile.prop | |
| group | No | sprinkler interlock/deluge group id or name — all its members | |
| reset | No | Drop every per-head spray override first (pipe heads: K / activation / RTI back to the profile) | |
| inherit | No | Keys to remove from the heads so they follow the profile again | |
| head_ids | No | pipe-network head ids (spr_list_summary) | |
| node_ids | No | pipe-network sprinkler node ids (all heads on them) | |
| rotation | No | DEVC ROTATION (deg) | |
| head_type | No | Pipe-network head type | |
| activation | No | How the head opens: link (heat, default), time (DEVC TIME + SETPOINT), ctrl (CTRL_ID), initial (open at t=0). | |
| device_ids | No | DEVC sprinklers (add_sprinkler / list_devices) | |
| pipe_index | No | DEVC PIPE_INDEX (pipe network number for PRESSURE_RAMP / OPEN NOZZLES) | |
| profile_id | No | Link the heads to this spray profile | |
| orientation | No | DEVC ORIENTATION spray axis (default [0,0,-1]; sidewall e.g. [1,0,0]) | |
| obstacle_ids | No | obstacle sprinklers (list_obstacles) | |
| network_of_node | No | pipe node id — every head in the pipe network connected to it | |
| keep_head_values | No | With profile_id: pipe heads keep their own K / activation temperature / RTI |