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 kinetic SCADA topology fields — getSelfId,
getSourceId, getSubnetworkAnchorId, getNetworkId,
getKind, getSpeed, hasSource,
isOverstressed.
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. Every other
kinetic peripheral in this addon (propellers, bearings, gearshifts, motors,
etc.) instead exposes per-block values under the distinct names
getStressImpact (draw) and getStressContribution (capacity
added). Per-block methods are intentionally absent on the Stressometer —
they would always be 0 on a gauge.
| getStress() | Get the current total stress demand on this block's kinetic network. |
|---|---|
| getStressCapacity() | Get the current total stress capacity of this block's kinetic network — sum of every source's contribution. |
| getSelfId() | Get this block's opaque self-id within the kinetic SCADA topology. |
| getSourceId() | Get the id of the block whose rotation this gauge is reading from (the upstream kinetic source one hop away). |
| getSubnetworkAnchorId() | Get the id of the speed-zone anchor this gauge belongs to. |
| getNetworkId() | Get the id of the entire kinetic network this gauge is part of. |
| getKind() | Get the SCADA kind classifier for this block. |
| getSpeed() | Get the gauge's current shaft speed in RPM (signed). |
| hasSource() | Check whether the gauge currently has a kinetic source feeding it. |
| isOverstressed() | Check whether the kinetic network this gauge is on is overstressed. |
- 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
numberThe 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
getStressContributionexposed on every other kinetic peripheral in this addon, which reports a single block's own contribution.Returns
numberThe network's total stress capacity.
- getSelfId()Source
Get this block's opaque self-id within the kinetic SCADA topology. Stable identity for cross-peripheral grouping; equality-comparable with
getSourceId/getNetworkIdon neighbours.Returns
stringThe self-id.
- getSourceId()Source
Get the id of the block whose rotation this gauge is reading from (the upstream kinetic source one hop away). Nil when no source.
Returns
stringThe source id, or nil.
- getSubnetworkAnchorId()Source
Get the id of the speed-zone anchor this gauge belongs to. Every block within a single speed-zone reports the same anchor — useful for grouping peripherals into rotation-coherent regions. Anchor resolution walks the kinetic graph through neighbouring block entities, so it must run on the server thread.
Returns
stringThe subnetwork anchor id.
- getNetworkId()Source
Get the id of the entire kinetic network this gauge is part of. All peripherals on the same network — across all speed zones — share this id.
Returns
stringThe network id.
- getKind()Source
Get the SCADA kind classifier for this block. Stressometers report
"passthrough"(they read from the network without modifying speed or topology).Returns
stringThe kind classifier.
- getSpeed()Source
Get the gauge's current shaft speed in RPM (signed). Same value Create exposes natively.
Returns
numberThe current speed in RPM.
- hasSource()Source
Check whether the gauge currently has a kinetic source feeding it. False on a disconnected gauge or one in a stalled network.
Returns
booleanTrue if a source is present.
- isOverstressed()Source
Check whether the kinetic network this gauge is on is overstressed. Mirrors the
overstressedevent but pollable on demand.Returns
booleanTrue if overstressed.