TheAlgorithms/Python · error · Exception

green should be between 0 and 255

Error message

green should be between 0 and 255

What it means

Raised by rgb_to_hsv() in conversions/rgb_hsv_conversion.py when the green channel is < 0 or > 255 — the second per-channel range check after red. Raised as bare Exception.

Source

Thrown at conversions/rgb_hsv_conversion.py:116

    True
    >>> approximately_equal_hsv(rgb_to_hsv(0, 255, 0), [120, 1, 1])
    True
    >>> approximately_equal_hsv(rgb_to_hsv(0, 0, 255), [240, 1, 1])
    True
    >>> approximately_equal_hsv(rgb_to_hsv(255, 0, 255), [300, 1, 1])
    True
    >>> approximately_equal_hsv(rgb_to_hsv(64, 128, 128), [180, 0.5, 0.5])
    True
    >>> approximately_equal_hsv(rgb_to_hsv(193, 196, 224), [234, 0.14, 0.88])
    True
    >>> approximately_equal_hsv(rgb_to_hsv(128, 32, 80), [330, 0.75, 0.5])
    True
    """
    if red < 0 or red > 255:
        raise Exception("red should be between 0 and 255")

    if green < 0 or green > 255:
        raise Exception("green should be between 0 and 255")

    if blue < 0 or blue > 255:
        raise Exception("blue should be between 0 and 255")

    float_red = red / 255
    float_green = green / 255
    float_blue = blue / 255
    value = max(float_red, float_green, float_blue)
    chroma = value - min(float_red, float_green, float_blue)
    saturation = 0 if value == 0 else chroma / value

    if chroma == 0:
        hue = 0.0
    elif value == float_red:
        hue = 60 * (0 + (float_green - float_blue) / chroma)
    elif value == float_green:
        hue = 60 * (2 + (float_blue - float_red) / chroma)
    else:

View on GitHub (pinned to f5988cc097)

Solutions

  1. Clamp each channel: g = max(0, min(255, g)).
  2. Verify argument order rgb_to_hsv(red, green, blue) — hue values like 300 belong in HSV->RGB, not here.
  3. Round and cast intermediate float results to int before calling.

Example fix

# before
rgb_to_hsv(0, 300, 0)  # Exception: green should be between 0 and 255

# after
rgb_to_hsv(0, max(0, min(255, 300)), 0)  # [120, 1, 1]
Defensive patterns

Strategy: validation

Validate before calling

g = max(0, min(255, int(g)))
if not 0 <= g <= 255:
    raise ValueError('green out of range')
rgb_to_hsv(r, g, b)

Type guard

def valid_rgb8(r: int, g: int, b: int) -> bool:
    return all(isinstance(c, (int, float)) and 0 <= c <= 255 for c in (r, g, b))

Try / catch

try:
    rgb_to_hsv(r, g, b)
except Exception as e:  # bare Exception from the library
    if 'green should be' in str(e):
        rgb_to_hsv(r, max(0, min(255, int(g))), b)
    else:
        raise

Prevention

When it happens

Trigger: Calling rgb_to_hsv(0, 300, 0), rgb_to_hsv(0, -1, 0), or blending results where only the green channel overflowed.

Common situations: Green-heavy filters or blending operations producing > 255; swapped argument order putting an out-of-range hue/saturation value in the green position; unclamped image-processing output.

Related errors


AI-assisted analysis of TheAlgorithms/Python@f5988cc097 (2026-08-14). Data as JSON: /api/errors/f500f14a2ba5e40f. Report an issue: GitHub.