Networks

Grade downstream

Lowers a named point value over outgoing directed links for Hops rounds. Cost is sampled once per directed link with this point upstream and the other point downstream, then clamped to zero or above. Missing endpoint values and non-finite costs impose no constraint. Only selected points are written.

network.point_grade

Grade downstreamValue namelevelHops8Which pointsOutputDownstream cost

What it does

Lower stored point heights to prepare a valley profile along a directed network. Each point can be pulled down by a downstream neighbour, with an allowed rise supplied by the cost field.

Choose the stored height name in Value name, then connect the allowed rise to Downstream cost. The cost is read for each directed link, with the current point upstream and its neighbour downstream. Run Output in Pass; the named value must already exist at both ends for a link to constrain the result.

Start with few Hops, which are rounds that let the constraint reach further through the network. Increase them only when the profile needs to follow more distant neighbours. Only selected points receive the final values, though other points can still influence them.

Inputs and outputs

NameTypeDefaultWhat it changes
Inputs
Which pointsPoint selectorThe points whose stored values are updated; other points still participate.
Downstream costDensityThe allowed rise above the downstream value for each directed link.
Settings
Value nameTextlevelThe existing named point value to lower.
HopsInteger8 · 1–1024More rounds carry downstream constraints further and increase construction work.
Output
OutputPoint actionThe grading action to run in a Pass.

Good to know

Orient the links before grading

Undirected links do not constrain the heights; two-way links constrain both directions. Check the network direction if the profile stays unchanged.

Keep the allowed rise meaningful

Negative costs are treated as zero. A non-finite cost leaves that link unconstrained, so check the cost field before increasing Hops.

See also