lớp Histogram -- Đối tượng Histogram¶

Đối tượng histogram được trả về bởi Image.get_histogram(). Tên lớp cơ bản là histogram.

Đối với ảnh thang xám, histogram có một kênh duy nhất gồm các bin. Đối với ảnh RGB565, histogram có ba kênh bao phủ các trục L, A, và B của CIE-LAB. Trong cả hai trường hợp, mỗi kênh được chuẩn hóa sao cho tổng các bin bằng 1.0.

Danh sách bin theo từng kênh được hiển thị dưới dạng cả phương thức gắn kết (hist.bins()) và ký hiệu chỉ số (hist[0]). Các phép rút gọn cấp cao get_percentile(), get_threshold(), và get_statistics() trả về các attrtuple tương ứng Percentile, Threshold, và Statistics.

class image.histogram¶

Vui lòng gọi Image.get_histogram() để tạo đối tượng này. Nó không có phương thức khởi tạo công khai.

bins() → list[float]¶

Trả về danh sách bin cho histogram thang xám. Mỗi phần tử nằm trong khoảng 0.0 đến 1.0 và tổng các phần tử bằng 1.0.

Tương đương với histogram[0].

l_bins() → list[float]¶

Trả về danh sách bin cho kênh L LAB của histogram RGB565. Mỗi phần tử nằm trong khoảng 0.0 đến 1.0 và tổng các phần tử bằng 1.0.

Tương đương với histogram[0].

a_bins() → list[float]¶

Trả về danh sách bin cho kênh A LAB của histogram RGB565. Mỗi phần tử nằm trong khoảng 0.0 đến 1.0 và tổng các phần tử bằng 1.0.

Tương đương với histogram[1].

b_bins() → list[float]¶

Trả về danh sách bin cho kênh B LAB của histogram RGB565. Mỗi phần tử nằm trong khoảng 0.0 đến 1.0 và tổng các phần tử bằng 1.0.

Tương đương với histogram[2].

get_percentile(percentile: float) → image.percentile¶

Tính CDF của mỗi kênh histogram và trả về giá trị bin tại percentile được yêu cầu (một số thực trong khoảng 0.0 -- 1.0).

Hữu ích để tìm giá trị min/max của phân phối màu sắc trong khi bỏ qua các điểm ngoại lệ (get_percentile(0.05) và get_percentile(0.95) cho min/max bền vững).

Trả về một attrtuple Percentile.

get_threshold() → image.threshold¶

Sử dụng Phương pháp Otsu trên mỗi kênh để tìm giá trị ngưỡng tốt nhất chia phân phối của mỗi kênh thành nửa "nền" và nửa "tiền cảnh". Các ngưỡng được trả về rất phù hợp để đưa trực tiếp vào Image.binary() hoặc bất kỳ phương thức nào nhận ngưỡng màu L/A/B LAB.

Trả về một attrtuple Threshold.

get_statistics() → image.statistics¶

Tính giá trị trung bình, trung vị, yếu vị, độ lệch chuẩn, min, max, tứ phân vị dưới, và tứ phân vị trên của mỗi kênh histogram.

Trả về một attrtuple Statistics.

get_stats() → image.statistics¶: Bí danh cho get_statistics().

statistics() → image.statistics¶: Bí danh cho get_statistics().