Create_Stressometer

Drop-in replacement for Create's Create_Stressometer peripheral.

Preserved from Create (verbatim): getStress, getStressCapacity, and the overstressed / stress_change events. Existing scripts that rely on these names and semantics keep working.

Added (Avionics): the full kinetic SCADA pack, inherited from KineticScadaSurface via KineticPeripheral — getSelfId, getSourceId, getSubnetworkAnchorId, getNetworkId, getKind (returns "passthrough" on a Stressometer), getSpeed, hasSource, isOverstressed, getStressImpact (per-block draw, always 0 on a gauge), getStressContribution (per-block capacity contribution, always 0 on a gauge).

Stress methods on this peripheral are network-wide totals. getStress and getStressCapacity sum across every consumer and source on the network — Create's gauge semantics, preserved. The per-block getStressImpact / getStressContribution inherited from the SCADA pack are distinct from these and report 0 on a Stressometer (gauges neither draw nor add stress).

getStress()Source

Get the current total stress demand on this block's kinetic network.

This is a network-wide total, summed across every consumer on the network — not this block's own draw. Stressometers are the only peripherals that expose network totals; on any other kinetic peripheral the per-block stress is getStressImpact.

Returns

1. number The network's total stress demand.

getStressCapacity()Source

Get the current total stress capacity of this block's kinetic network — sum of every source's contribution. Distinct from the per-block getStressContribution exposed on every other kinetic peripheral in this addon, which reports a single block's own contribution.

Returns

1. number The network's total stress capacity.

getSelfId()Source

Get this block's id. Other peripherals' getSourceId or getSubnetworkAnchorId return this same id when they refer to this block.

Returns

1. string The block's id.

getSourceId()Source

Get the id of the block immediately driving this one, or nil if this block has no source.

Returns

1. string The parent's id, or nil.

getSubnetworkAnchorId()Source

Get the id of this block's speed-zone anchor — the gearshift / clutch / speed controller / generator that defines the start of this speed zone. Two blocks share an anchor iff they're in the same speed zone. A generator or split-shaft returns its own getSelfId.

Returns

1. string The anchor block's id, or nil.

getNetworkId()Source

Get the id of this block's kinetic network. Same value for every block on the same network regardless of how many speed zones lie between them. Nil if this block isn't on a network.

Returns

1. string The network id, or nil.

getKind()Source

Get this block's role on the kinetic graph: one of "generator", "split_shaft", "consumer", or "passthrough".

Returns

1. string The role string.

getSpeed()Source

Get the local rotational speed at this block. Signed; same value across a speed zone, changes across a split-shaft.

Returns

1. number The local speed.

hasSource()Source

Check whether this block is connected to a kinetic source.

Returns

1. boolean True if a source is connected.

isOverstressed()Source

Check whether the block's network is overstressed.

Returns

1. boolean True if overstressed.

getStressImpact()Source

Get the stress impact of this block on its network — how much stress it draws while running. Speed-dependent; zero for sources and pure conduit blocks. Matches the "Stress Impact" value shown by goggles.

Returns

1. number The stress impact.

getStressContribution()Source

Get this block's contribution to its network's stress capacity. Non-zero for sources only. Parallel to getStressImpact (per-block draw) and distinct from Create_Stressometer#getStressCapacity, which reports the network total.

Returns

1. number The per-block stress contribution.