axes_transform — ANNOTATE plot op

• 資料種類:無 → axes(僅由參數決定的運算子 —— 不接受影像或資料輸入)

• 呼叫: import fullseye as fs; fs.ledger.axes_transform(rect, xlim, ylim, invert_y=True, xscale='linear', yscale='linear')(要直接呼叫實作,import annotate; annotate.axes_transform(rect, xlim, ylim, invert_y=True, xscale='linear', yscale='linear');從台帳取用則 opsannotate.get("axes_transform"))

用法

建構資料座標 → 像素座標的(閉合式)映射。

把影像的事實 row 向下 與圖表的慣例 y 向上 之間的偏差,只在這 1 處吸收。繪圖程式碼隨身攜帶這個字典。

px = x0 + (x - xmin)/(xmax - xmin) * (w - 1)

py = y0 + (h - 1) - (y - ymin)/(ymax - ymin) * (h - 1) # invert_y

Parameters

rect : (x, y, w, h)

繪圖區(以左上為基準,像素)。

xlim, ylim : (lo, hi)

資料範圍。lo == hi 會使斜率為無窮大,所以拋出 ValueError。

也允許 lo > hi(反轉軸) —— 用於上下顛倒地繪製深度或排名。

invert_y : bool

True(預設)時 ylim[0] 位於下端 = 普通的圖表。

False 時為影像原本的方向(上端是 ylim[0])。

xscale, yscale : {'linear','log'}

'log' 為常用對數。範圍內含 0 以下的值則 ValueError

(把 0 傳給 log 軸、把 -inf 當作「端」來畫的圖是謊言)。

Returns

dict

{"rect", "xlim", "ylim", "invert_y", "xscale", "yscale"}。

Raises

ValueError

矩形不正確,範圍非有限或寬度為零,w 或 h 小於 2,

未知的 scale,log 軸的範圍含 0 以下。

詳細使用指南

• figure_annotation 族使用指南

背景知識指南(該運算子背後的物理與規範)

• dataset_conventions — 訓練資料集規範知識 —— COCO / YOLO / VOC 及外觀檢測中的陷阱

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

• 演算法的正典(作者、年份)與用途見上面的族使用指南。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• annotate_gallery — py -3.11 examples/annotate_gallery.py

• annotate_paper_tour — py -3.11 examples/annotate_paper_tour.py

• poc_beam_modal_video — py -3.11 examples/poc_beam_modal_video.py

• poc_camera_calibration — py -3.11 examples/poc_camera_calibration.py

• poc_camera_shake_deblur — py -3.11 examples/poc_camera_shake_deblur.py

• poc_crack_width_timeseries — py -3.11 examples/poc_crack_width_timeseries.py

• poc_dehazing — py -3.11 examples/poc_dehazing.py

• poc_dic_strain — py -3.11 examples/poc_dic_strain.py

• poc_driving_decisions — py -3.11 examples/poc_driving_decisions.py

• poc_driving_traffic — py -3.11 examples/poc_driving_traffic.py

• poc_focus_stacking — py -3.11 examples/poc_focus_stacking.py

• poc_interferometry_step — py -3.11 examples/poc_interferometry_step.py

• poc_measurement_system_analysis — py -3.11 examples/poc_measurement_system_analysis.py

• poc_motion_magnification — py -3.11 examples/poc_motion_magnification.py

• poc_panorama_drift — py -3.11 examples/poc_panorama_drift.py

• poc_particle_tracking — py -3.11 examples/poc_particle_tracking.py

• poc_photoelasticity — py -3.11 examples/poc_photoelasticity.py

• poc_pxrd_phase_peel — py -3.11 examples/poc_pxrd_phase_peel.py

• poc_registration_basin — py -3.11 examples/poc_registration_basin.py

• poc_river_surface_velocity — py -3.11 examples/poc_river_surface_velocity.py

• poc_strain_history — py -3.11 examples/poc_strain_history.py

• poc_structure_4d_deterioration — py -3.11 examples/poc_structure_4d_deterioration.py

• poc_superresolution_limits — py -3.11 examples/poc_superresolution_limits.py

• poc_template_tracking — py -3.11 examples/poc_template_tracking.py

• poc_timelapse_growth — py -3.11 examples/poc_timelapse_growth.py

• poc_wound_area_tracking — py -3.11 examples/poc_wound_area_tracking.py

• poc_xyt_event_surface — py -3.11 examples/poc_xyt_event_surface.py

型別可銜接的下一個運算子(可接受 axes 作為輸入)

data_to_pixel · axes_frame · grid_lines · ticks · plot_series

同類別(plot)

data_to_pixel · nice_ticks · axes_frame · grid_lines · ticks · plot_series


*Provenance: annotate.py — ANNOTATE 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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