RGB Projector White Balance

Calculate raw and peak-normalized RGB projector gains from measured and target channel outputs.

Description

RGB gain balancing scales each measured channel toward its target.

RGB gain balancing scales each measured channel toward its target. Peak normalization makes the largest required gain equal to one.^[1]

Calculate raw and peak-normalized RGB projector gains from measured and target channel outputs.

When to use RGB Projector White Balance

Use this tool to calculate raw and peak-normalized RGB projector gains from measured and target channel outputs.

Prepare the optical measurements, geometry, fitted coefficients or caller-selected thresholds requested. Confirm wavelength, radius/diameter, pulse-width, angle and unit conventions before running the calculation.

How to use RGB Projector White Balance and understand its results

Prepare the optical measurements, geometry, fitted coefficients or caller-selected thresholds requested. Confirm wavelength, radius/diameter, pulse-width, angle and unit conventions before running the calculation.
Enter measuredRed, measuredGreen, measuredBlue, targetRed, targetGreen, targetBlue using the field table and calculation rules, then run the tool.
Read rawChannelGains, normalizedChannelGains. The explanation below defines the units, signs, ordering and any flags or placeholder values.
If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.

Input field	Meaning	Value type; see rules below	Requirement
measuredRed	Measured red output	number; minimum: 0	Required
measuredGreen	Measured green output	number; minimum: 0	Required
measuredBlue	Measured blue output	number; minimum: 0	Required
targetRed	Target red output	number; minimum: 0	Required
targetGreen	Target green output	number; minimum: 0	Required
targetBlue	Target blue output	number; minimum: 0	Required

Enter positive measured RGB outputs and nonnegative target outputs. Return arrays in red, green, blue order. If all targets are zero, return three zero normalized gains.

rawGain_channel=target/measured; normalized=raw/max(raw)

Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.

Output field	Meaning	Value type
rawChannelGains	Raw RGB gains	list of number
normalizedChannelGains	Normalized RGB gains	list of number

json

{
  "input": {
    "measuredRed": 0.8,
    "measuredGreen": 1,
    "measuredBlue": 0.5,
    "targetRed": 1,
    "targetGreen": 1,
    "targetBlue": 1
  },
  "output": {
    "rawChannelGains": [
      1.25,
      1,
      2
    ],
    "normalizedChannelGains": [
      0.625,
      0.5,
      1
    ]
  }
}

Limitations and assumptions

No colorimetric matrix, gamma, white-point coordinates or hardware headroom is modeled.

Numeric inputs must be finite. Follow the calculation-specific rules for overflow, underflow and exceptional cases. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors.

Alternative or Complementary methods

Use Flow-Cytometry Line Coverage: Match required flow-cytometry excitation lines to available lines within a supplied tolerance. For a complementary task, use Power-Beaming Efficiency: Calculate end-to-end optical power-beaming efficiency and power loss.

References

RGB Projector White Balance — tool.io

Similar or alternative tools

Flow-Cytometry Line Coverage
Match required flow-cytometry excitation lines to available lines within a supplied tolerance.
Power-Beaming Efficiency
Calculate end-to-end optical power-beaming efficiency and power loss.