annotate_colorbar — ANNOTATE paper op

데이터 종류: image2d × image2dimage2d

호출: import annotate; annotate.annotate_colorbar(img, field, rect, lut=None, vmin=None, vmax=None, alpha=0.6, mask=None, unit='', label_fmt='{:.3g}', orientation='vertical', font_size=12, scheme='okabe_ito', font_path=None, text_color=None, nan_transparent=False)(또는 opsannotate.get("annotate_colorbar"))

사용법

이미지(image2d)를 돌려줍니다: 스칼라장을 LUT 로 색 입혀 겹치고 컬러바를 붙입니다.

> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.

`t = (field - vmin)/(vmax - vmin) を [0,1] に**クリップ**し lut[round(t*(n-1))]`

で色にする(範囲外の値は端の色 —— カラーバーの端と同じなので嘘にならない)。

重ねは `alpha の α 合成、mask` を渡せばその画素だけ。

Parameters

----------

field : (H, W)

画像と同じ大きさのスカラ場。非有限は `nan_transparent=True` のときだけ

透明として許す(既定は ValueError)。

lut : (n, 3) or None

None なら :func:palette.diverging_lut の 256 段。

vmin, vmax : float or None

None なら場の(有限値の)最小・最大。等しければ ValueError。

Raises

------

ValueError

形の不一致、非有限(許可なし)、vmin == vmax、alpha が [0,1] の外、

バーの矩形が画像外、LUT の形。

자세한 사용 가이드

figure_annotation 패밀리 가이드

배경 지식 가이드(이 연산자 앞에 있는 물리·규약)

dataset_conventions — 学習データセット規約の知識 — COCO / YOLO / VOC と外観検査での落とし穴

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

paper_figurepy -3.11 examples/paper_figure.py

타입이 이어지는 다음 연산자(image2d 를 입력으로 받는 것)

text_box · arrow · leader_line · label_points · crosshair · legend_box · color_bar · scale_bar

같은 카테고리(paper)

annotate_leader_layout · annotate_leader · annotate_markers · annotate_legend · annotate_dimension_layout · annotate_dimension · annotate_angle_layout · annotate_angle


*Provenance: annotate.py — ANNOTATE 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.