UT_VESSEL — Level → volume, percent, mass

Converts a level into contents for common tank and silo shapes. For odd shapes
use a strapping table with UT_LINEARISE. Replaces
SiloVolumeCalculator, DividedSiloVolumeCalculator and volumeToWeight.

Pins

Record UT_VESSEL_DATA

How it works

• The level is measured up from the bottom (CONE: from the hopper outlet) and
  clamped: below 0 is empty, above the top is full with overfull set.
• The partial cone volume is computed at the actual fill height. This fixes the
  overestimate in the original.
• Units. The dimensions are in the same unit as the level, so the tank
  drawing and the transmitter can be typed in as they are: with
  levelUnit := UT_LEVEL_MM a 2.4 m tank is diameter := 2400.0. With
  UT_LEVEL_PCT the level is a share of the full height and the dimensions are
  in metres (the % needs the real size to give a volume). The volumes and the
  mass each have their own unit setting, so an HMI showing litres or tonnes
  needs no maths in the program. Density is always kg/m³ (SG × 1000).
• Example: a 2400 mm × 3000 mm vertical water tank, radar in mm, HMI in litres:
  levelUnit := UT_LEVEL_MM, diameter := 2400.0, height := 3000.0, volumeUnit := UT_VOL_L. A level of 1500 mm gives 6786 L (50 %). The same tank
  with the radar scaled 0–100 %: levelUnit := UT_LEVEL_PCT, diameter := 2.4, height := 3.0, and 50 % gives the same 6786 L.
• wrnConfig is set, and every output is 0 (nothing divides by zero), when a
  needed dimension is 0, negative, not a number or over 10 km (10 000 000 mm), fraction is not
  above 0 and up to 1, density is negative, an outlet is wider than the
  silo, the dead volume fills the whole vessel, or a unit is unknown.
• Level % (levelPct) is not the same as percent: percent is the share
  of the volume, levelPct the level within a working range, e.g. an effluent
  sump with pctLow := 500.0 (L, mm) and pctHigh := 1800.0 (overflow) shows
  0 % at the stop level and 100 % at overflow. levelOffset is added to both,
  as to Level. A range that is not a number or not rising uses the whole
  height and shows Setting: level % range; the volumes are not affected.

Status codes

statusCode is a UT_STATUS and faultId a UT_FAULT (an HMI reads their numbers);
statusText is the two in words, changed only when one of them changes.