• Функция binarize(M, [lowThresh, [highThresh, inValue, outValue]]) возвращает преобразованную в двоичный формат матрицу M, где пикселы, имеющие значение меньшее или равное lowThresh, устанавливаются в 0, а пикселы со значениями большими, чем порог lowThresh — в 1.
При преобразовании в двоичную форму получается изображение только с двумя уровнями серого, которое при подходящем выборе порога может использоваться, чтобы подчеркнуть особенности изображения. Преобразование в двоичную форму может быть также полезно как первый шаг при анализе изображений.
• Если все дополнительные аргументы опущены, то порог будет задан автоматически при допущении, что имеется бимодальное распределение пикселов "переднего плана" и "фона". В алгоритме используется критерий, который, согласно Киттлеру и Иллингворту, минимизирует аппроксимацию между фактической гистограммой пикселов и принятым бимодальным распределением (см. R.M. Harlick, L.G. Shapiro, "Computer and Robot Vision" (Р.М. Гарлик, Л.Дж. Шапиро. Зрение компьютеров и роботов), Vol. 1, Addison-Wesley, 1992).
• Если задан только аргумент lowThresh, то он будет использоваться как порог для установки элементов выходной матрицы в 0 или 1.
• Если задан аргумент highThresh, требуется задать inValue и outValue.
• Если заданы все четыре дополнительных аргумента, то для всех уровней между lowThresh и highThresh будет устанавливаться значение inValue, а для всех остальных — значение outValue. Значения входных параметров произвольны и не должны непременно быть в интервале от 0 до 255. Если значения inValue и outValue совпадают, все изображение будет помещено на один уровень.