pyzemrpc 1.2.0__py3-none-any.whl

pyzemrpc-1.2.0.data/data/data/pyzemrpc/conf/config.yml

@@ -0,0 +1,12 @@
+pyzemrpc:
+  version: 1.0.0
+  output_dir: ./data/appout
+
+  virtual_zem:
+    img_dtype: np.uint16
+    simu_timeout: 0             # 随机数小于该值模拟超时
+    simu_busy: 0                # 随机数小于该值模拟设备忙
+    replay_zem:
+      enable: False
+      # cap_roi_task: D:/tmp/2025/x20250613_diatom/replay_zem-tasks/cap_roi-20250714_120555
+      cap_roi_task: E:/days/2025/x20250613_diatom/replay_zem-tasks/cap_roi-20250715_093056

pyzemrpc-1.2.0.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 ZEPTOOLS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyzemrpc-1.2.0.dist-info/METADATA

@@ -0,0 +1,124 @@
+Metadata-Version: 2.1
+Name: pyzemrpc
+Version: 1.2.0
+Summary: zeptools zem remote api.
+Home-page: https://gitee.com/zeyou-anhui/pyzemrpc.git
+Author: tribf
+Author-email: tribf@tribf.com
+License: MIT
+Keywords: SEM,Calibration,Utilities
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Unix
+Classifier: Operating System :: MacOS
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: jgb >=0.2.1
+Requires-Dist: PySide6 >=6.7.2
+Requires-Dist: QtPy >=2.4.1
+Requires-Dist: opencv-contrib-python >=4.10.0.84
+Requires-Dist: opencv-python >=4.10.0.84
+Requires-Dist: tenacity >=8.5.0
+Requires-Dist: loguru >=0.7.2
+Requires-Dist: pydantic >=2.8.2
+Requires-Dist: pyqtgraph >=0.13.7
+Requires-Dist: anytree >=2.12.0
+Requires-Dist: blinker >=1.9.0
+Requires-Dist: requests >=2.32.3
+
+![pyzemrpc Banner](./doc/pyzemrpc_banner.png)
+
+# pyzemrpc
+
+**ZEM远程控制接口（python版本）**
+
+`pyzemrpc` 是安徽泽攸深科（ZEPTOOLS）扫描电镜（SEM）的Python远程控制接口与工具集。它提供了一套Python API，允许开发者通过代码控制SEM设备，以及一个图形用户界面（GUI）用于交互式操作。
+
+---
+
+## ✨ 特性 (Features)
+
+*   **远程控制**: 支持对ZEM系列扫描电镜的远程操作与监控。
+*   **Python API**: 提供友好的Python接口，便于集成到自动化脚本或第三方软件中。
+*   **图形界面**: 内置 `pyzemrpc` GUI 工具，开箱即用。
+*   **配置灵活**: 基于 YAML 和 数据库 的灵活配置管理。
+
+## 🚀 安装 (Installation)
+
+### 依赖环境
+*   Python 3.10+
+*   Windows / Linux / MacOS
+
+### 安装步骤
+
+1.  克隆仓库：
+    ```bash
+    git clone https://gitee.com/zeyou-anhui/pyzemrpc.git
+    cd pyzemrpc
+    ```
+
+2.  安装依赖并安装包：
+    ```bash
+    pip install .
+    ```
+
+    或者使用开发模式安装：
+    ```bash
+    pip install -e .
+    ```
+
+3.  或者使用pypi安装
+    ```bash
+    pip install pyzemrpc
+    ```
+
+
+
+## 🖥️ 使用 (Usage)
+
+### 启动 GUI
+安装完成后，可以直接在终端运行以下命令启动图形界面：
+```bash
+pyzemrpc
+```
+
+### 命令行工具
+查看相关信息：
+```bash
+pyzemrpc_info
+```
+
+### Python 开发
+在您的 Python 脚本中导入 `zemrpc`：
+
+```python
+import zemrpc
+from zemrpc import app_cfg
+
+# 示例代码 (具体API参考文档)
+print(f"pyzemrpc version: {app_cfg.version}")
+```
+
+## 📄 文档 (Documentation)
+更多详细文档和配置说明，请查阅 [doc](./doc) 目录。
+
+## 🤝 贡献 (Contributing)
+欢迎提交 Issue 或 Pull Request 来改进本项目。
+
+## 📃 许可证 (License)
+本项目采用 [MIT License](LICENSE) 开源。
+
+---
+Copyright © 2024-2026 ZEPTOOLS

pyzemrpc-1.2.0.dist-info/RECORD

@@ -0,0 +1,42 @@
+pyzemrpc-1.2.0.data/data/data/pyzemrpc/conf/config.yml,sha256=rZcUJMNMb0Yb60UyG_hNj7SLotFvOesjTUI6H_y3yIo,466
+zemrpc/__commit__.py,sha256=HgWFXXnSfqK75E5edkqM1NWaCqEjWyhCAvVOmPIvZHU,55
+zemrpc/__init__.py,sha256=MZKx7AtlnYO53wcdsZUGVawowVWT-EhvvYKkeXDHP_Y,2128
+zemrpc/__version__.py,sha256=Hjc7T6q7mvv6SehLwZF6goeyQ-ZIsaJ2eMb0eYzZgA8,361
+zemrpc/gui/__init__.py,sha256=i3OYuJ6cY6JR8Helt-KdJtN7ZOxM4hZaS_Li_-AOHDY,2112
+zemrpc/gui/style.qss,sha256=jIKkAuO2ZuIEk23-spCT_wth-nfcJaoMkWXDD_HmFfM,250
+zemrpc/gui/ui_utils.py,sha256=wmacUOny7YXcfpSTdpoTBoevVdlsEwoa1Da7fILdHH0,1325
+zemrpc/gui/zemrpc_main.py,sha256=qrH51YLnCkSGeopKAw3PyAAYV-lnFw5g2souEk4_NDU,1263
+zemrpc/gui/zemrpc_win.py,sha256=j80_1XOVVbqqWzXTPfTQPooyrQeFJvd7kXSveUq_avs,14688
+zemrpc/gui/zemrpc_win_ui.py,sha256=mXimvUo2kJlE9bPIt4YD-_v1TmKcWt7_zBWORfDeZLc,34597
+zemrpc/gui/widgets/__init__.py,sha256=V-xn7sDg8Mv03JYDkrF2uq8nn4VUyRl8ia4xtf8hFfs,74
+zemrpc/gui/widgets/nav_img_viewer.py,sha256=peFxod7F0pVt0qFhjrAzIxbMpumjdVG9-8Xl4PqvNHk,7483
+zemrpc/gui/widgets/zem_img_viewer.py,sha256=nA55DEF2w53g3EuPj3joTgw3M5m1-hiJ7qoai8H41n0,2544
+zemrpc/tools/__init__.py,sha256=V-xn7sDg8Mv03JYDkrF2uq8nn4VUyRl8ia4xtf8hFfs,74
+zemrpc/tools/zemrpc_info.py,sha256=GDURnPhySVuMjI0TFgSAVFhTzQPlCVb7XqUzK_hy-WQ,2126
+zemrpc/tools/zemrpc_show_img_meta.py,sha256=nJr3ICysVGR8qOBuV_ExNZMn6wi1WiEIdj-bd1QiyGM,2250
+zemrpc/tools/virtual_zem/__init__.py,sha256=V-xn7sDg8Mv03JYDkrF2uq8nn4VUyRl8ia4xtf8hFfs,74
+zemrpc/tools/virtual_zem/__main__.py,sha256=kRcQNwspF_jB7seZ8tOdR-zZ2raz-1C8H4I6TY_uMpg,267
+zemrpc/tools/virtual_zem/jsonrpc_server.py,sha256=0NDyfqmK7MqHfvmbtfZbrRfovkqGLuDxutcauLa0eYE,1772
+zemrpc/tools/virtual_zem/main.py,sha256=1mcCHPpoEa_dp9p1ov8FIRKChISoDXWF5G7G4FAlg4E,862
+zemrpc/tools/virtual_zem/virtual_zem.py,sha256=iTJPuCqRPNUm-baFpvKmpBiF2HJ4SFe2n9C5i84GOHk,42702
+zemrpc/tools/virtual_zem/virtual_zem_mgr.py,sha256=O4Js0twqwC_ppaQoQbjm97rg2bt6xrPoCDLhyU3in6Q,4876
+zemrpc/zem/__init__.py,sha256=V-xn7sDg8Mv03JYDkrF2uq8nn4VUyRl8ia4xtf8hFfs,74
+zemrpc/zem/context.py,sha256=fNOdidGzNxmHMvo1RcKVpHLlAfQxruXNGgc4XUYSQWQ,533
+zemrpc/zem/ip_util.py,sha256=08pnL-G31XMg9iIoAiJwrE9Wa4_IQt-8HnWcv08xT44,5778
+zemrpc/zem/models.py,sha256=XC5hezD6fbsqTO3albvoKxoRrKCqctSCzh4Gsdo430Q,10207
+zemrpc/zem/zem_api.py,sha256=hVpjJnBjbk7KV8UaqiHEdcaFzNnXnIsc5yLKgXoTrTo,13628
+zemrpc/zem/zem_image_meta.py,sha256=OhMakNt2V8FuhV3Ln-Wu_IrHaEo9g4vF4-RajfO57xY,10000
+zemrpc/zem/zem_image_processor.py,sha256=iMl2Sm3lNh03LfbSV5ZI8LSUGxyPdHLJdG-QHMJmY6s,3566
+zemrpc/zem/zem_rpc_device.py,sha256=_P40oqxsKbk4CbM-xXuSVXgxhjImqz9nDG508t0fDy0,36611
+zemrpc/zem/zem_util.py,sha256=FYLMI4iv8nBLlAWK8Mh3ORpcJyKMYggSp3MX_-QZ_cs,962
+zemrpc/zem/conn/__init__.py,sha256=V-xn7sDg8Mv03JYDkrF2uq8nn4VUyRl8ia4xtf8hFfs,74
+zemrpc/zem/conn/img_receiver.py,sha256=vklffj7PSMO7dCCMMic0FEoj1TA4-JUMNEhoYQtgLsc,2970
+zemrpc/zem/conn/protocol.py,sha256=lnKBhsj90c6f_Thkq2Q5QudQk9qK44fHO_-5vjs-cdI,33243
+zemrpc/zem/conn/rpc_protocol.py,sha256=eFVetVBgglhiz_AXuiYuQx7Pisc3dNwNW-CUfBVvKco,3064
+pyzemrpc-1.2.0.dist-info/LICENSE,sha256=SPviBjCp6i_RvxZabbX8HJvHY1eDYhuqVrZBnKG60Vw,1091
+pyzemrpc-1.2.0.dist-info/METADATA,sha256=VQ5C0GFNvg-RvlDPekr6Yx36cRkiZOch3cwyApPDG98,3428
+pyzemrpc-1.2.0.dist-info/WHEEL,sha256=OVMc5UfuAQiSplgO0_WdW7vXVGAt9Hdd6qtN4HotdyA,91
+pyzemrpc-1.2.0.dist-info/entry_points.txt,sha256=mLV5blOYbGlLtniosy4TeOc-qsC2NMJfwg0yLLKLwRc,240
+pyzemrpc-1.2.0.dist-info/top_level.txt,sha256=KsBHoGQ_4r9fbPw7stFSUQQ5F8-7Wb5psfq2pXNEflo,7
+pyzemrpc-1.2.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+pyzemrpc-1.2.0.dist-info/RECORD,,

pyzemrpc-1.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.2.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pyzemrpc-1.2.0.dist-info/entry_points.txt

@@ -0,0 +1,7 @@
+[console_scripts]
+pyzemrpc_info = zemrpc.tools.zemrpc_info:main
+pyzemrpc_show_img_meta = zemrpc.tools.zemrpc_show_img_meta:main
+pyzemrpc_virtual_zem = zemrpc.tools.virtual_zem.main:main
+
+[gui_scripts]
+pyzemrpc = zemrpc.gui.zemrpc_main:main

pyzemrpc-1.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+zemrpc

pyzemrpc-1.2.0.dist-info/zip-safe

@@ -0,0 +1 @@
+

zemrpc/__commit__.py

@@ -0,0 +1 @@
+GIT_INFO = "22d6e40ee5df4f9b9ca3551ef348dce6b230e808"

zemrpc/__init__.py

@@ -0,0 +1,74 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# tr!bf tribf@tribf.com
+
+import sys
+import addict
+from pathlib import Path
+
+from jgb.util import app_util, db_util, addict_util, file_util
+
+from zemrpc.__commit__ import GIT_INFO
+from zemrpc.__version__ import __title__, __version__
+
+
+class CfgDb:
+    def __init__(self, app_name, cfg: addict.Dict, **kwargs):
+        self.cfg = cfg
+        if (db_file := kwargs.get("db_file", None)) is None:
+            db_file = app_util.resolve_app_home(app_name, None, None) / "cfg.db"
+        self.kv_db = db_util.KvDataBase(db_file)
+        self.update()
+
+    def update(self):
+        for k in self.kv_db.db.keys():
+            if not k.startswith("cfg."):
+                continue
+            addict_util.update_addict(self.cfg, k[4:], self.kv_db.get_pkl(k))
+
+
+class AppConfig(app_util.BaseAppConfig):
+    def __init__(self):
+        src_home = Path(__file__).resolve().parents[1]
+        super().__init__(src_home, app_name=__title__, pkg_name="zemrpc", author="Zeptools", version=__version__)
+
+    def after_init(self):
+        if cfg_db := self.cfg.get("cfg_db", None):
+            db_file = self.app_home / cfg_db
+        else:
+            db_file = None
+
+        self.cfg_db = CfgDb(self.app_name, self.cfg, db_file=db_file)
+
+    def init_cfg(self):
+        assert self.run_type != app_util.AppRunType.DEV
+        in_dir = Path(sys.prefix) / f"data/{__title__}"
+        files = [
+            (in_dir / "conf/config.yml", self.app_home / "conf/config.yml"),
+        ]
+
+        for src, dst in files:
+            if dst.exists():
+                continue
+
+            print(f"copy {src} -> {dst}")
+            file_util.copy(src, dst)
+
+    @property
+    def outdir(self) -> Path:
+        return self.app_home / self.cfg.output_dir
+
+    @property
+    def log_dir(self) -> Path:
+        return self.outdir / "logs"
+
+    @property
+    def about(self):
+        s = [
+            f"<p>版本: {self.version}</p>",
+            f"<p>哈希: {GIT_INFO}</p>",
+        ]
+        return "".join(s)
+
+
+app_cfg = AppConfig()

zemrpc/__version__.py

@@ -0,0 +1,10 @@
+__title__ = "pyzemrpc"
+__version__ = "1.2.0"
+__description__ = "zeptools zem remote api."
+__keywords__ = "SEM,Calibration,Utilities"
+__url__ = "https://gitee.com/zeyou-anhui/pyzemrpc.git"
+__author__ = "tribf"
+__author_email__ = "tribf@tribf.com"
+__license__ = "MIT"
+__copyright__ = "Copyright 2024-2026 ZEPTOOLS"
+__cake__ = "\u2728 \U0001f370 \u2728"

zemrpc/gui/__init__.py

@@ -0,0 +1,51 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# tr!bf tribf@tribf.com
+import sys
+from loguru import logger
+from qtpy import QtCore, QtWidgets
+import traceback
+
+
+def show_exception_box(log_msg):
+    """Checks if a QApplication instance is available and shows a messagebox with the exception message.
+    If unavailable (non-console application), log an additional notice.
+    """
+    if QtWidgets.QApplication.instance() is not None:
+        errorbox = QtWidgets.QMessageBox()
+        errorbox.setText("Oops. An unexpected error occured:\n{0}".format(log_msg))
+        errorbox.exec_()
+    else:
+        logger.debug("No QApplication instance available.")
+
+
+class UncaughtHook(QtCore.QObject):
+    _exception_caught = QtCore.Signal(object)
+
+    def __init__(self, *args, **kwargs):
+        super(UncaughtHook, self).__init__(*args, **kwargs)
+        sys.excepthook = self.exception_hook
+        # connect signal to execute the message box function always on main thread
+        self._exception_caught.connect(show_exception_box)
+
+    def exception_hook(self, exc_type, exc_value, exc_traceback):
+        """Function handling uncaught exceptions.
+        It is triggered each time an uncaught exception occurs.
+        """
+        if issubclass(exc_type, KeyboardInterrupt):
+            # ignore keyboard interrupt to support console applications
+            sys.__excepthook__(exc_type, exc_value, exc_traceback)
+        else:
+            log_msg = "\n".join(["".join(traceback.format_tb(exc_traceback)), "{0}: {1}".format(exc_type.__name__, exc_value)])
+
+            exc_info = (exc_type, exc_value, exc_traceback)
+            # log.critical("Uncaught exception:\n {0}".format(log_msg), exc_info=exc_info)
+            # logger.warning("Uncaught exception:\n {0}".format(log_msg), exc_info=exc_info)
+            logger.exception("Uncaught exception:\n {0}".format(log_msg))
+
+            # trigger message box show
+            self._exception_caught.emit(log_msg)
+
+
+# create a global instance of our class to register the hook
+qt_exception_hook = UncaughtHook()

zemrpc/gui/style.qss

@@ -0,0 +1,15 @@
+QMenu {
+    color: #111;
+    background-color: #f4f4f4;
+    border: 1px solid #c7c7c7;
+}
+
+QMenu::item {
+    padding: 4px 16px;
+    background: transparent;
+}
+
+QMenu::item:selected {
+    background-color: #2d6cdf;
+    color: #ffffff;
+}

zemrpc/gui/ui_utils.py

@@ -0,0 +1,53 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# tr!bf tribf@tribf.com
+
+from typing import Dict
+
+cbox_style = "QComboBox QAbstractItemView::item { min-height: 15px; min-width: 50px; }QListView::item:selected { color: black; background-color: lightgray}"
+
+
+def get_api_cmds():
+    from zemrpc.zem.conn.protocol import EnumCmd
+
+    cbox_cmds = {}  # type: Dict[str, EnumCmd]
+    for c in EnumCmd:
+        if c in {EnumCmd.InvalidCmd, EnumCmd.Handshake, EnumCmd.HandshakeResp}:
+            continue
+        cbox_cmds[c.name_cn] = c
+    return cbox_cmds
+
+
+def parse_mag_str(mag_str):
+    tbl = {"k": 1000, "w": 10000, "x": 1}
+    return int(mag_str[:-1]) * tbl[mag_str[-1]]
+
+
+def stage_pos_str(x: float, y: float):
+    return f"{x:.3f},{y:.3f}"
+
+
+def parse_stage_pos(pos_str: str):
+    return list(map(float, pos_str.replace("，", ",").split(",")))
+
+
+def get_snap_size():
+    from zemrpc.zem.models import EnumImageSize
+
+    sizes = {}
+    for s in EnumImageSize:
+        if s == EnumImageSize.Unk:
+            continue
+        sizes[s.name_cn] = s
+    return sizes
+
+
+def get_beam_size():
+    from zemrpc.zem.models import EnumBeamSize
+
+    sizes = []
+    for s in EnumBeamSize:
+        if s == EnumBeamSize.Unk:
+            continue
+        sizes.append(s)
+    return sizes

zemrpc/gui/widgets/__init__.py

@@ -0,0 +1,3 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# tr!bf tribf@tribf.com

zemrpc/gui/widgets/nav_img_viewer.py

@@ -0,0 +1,180 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# tr!bf tribf@tribf.com
+
+import math
+import functools
+import numpy as np
+from qtpy.QtGui import QCursor, QIcon
+from qtpy.QtWidgets import QMenu, QToolButton
+from matplotlib.patches import Circle, Rectangle
+from matplotlib.backend_bases import MouseButton, MouseEvent, PickEvent
+from loguru import logger
+
+from jgb.gui.qt import qt_util
+from jgb.gui.qt.widgets.mpl_qpanel import QMplPanelWithToolbar
+
+from zemrpc.zem.models import FieldWithLoc, NavImage
+from zemrpc.zem.zem_api import zem_api
+
+
+class NavCircleMarker:
+    def __init__(self):
+        self.gid_nav_circle_mark = "nav_circle_mark"
+        self.gid_nav_circle_mark_c = "nav_circle_mark_c"
+        self.gid_nav_circle_mark_r = "nav_circle_mark_r"
+        self.center = (0, 0)
+        self.radius = 500
+
+
+class NavImgViewer:
+    def __init__(self, panel):
+        self.widget, self.layout = qt_util.init_panel_with_widget(panel, QMplPanelWithToolbar)
+        self.canvas = self.widget.plot_canvas
+
+        self.btn = QToolButton(self.widget.navi_toolbar)
+        self.btn.setIcon(QIcon(":/pyzemrpc/images/clear.png"))
+        self.btn.clicked.connect(self._slot_clear_mark)
+        self.widget.navi_toolbar.addWidget(self.btn)
+
+        self._picked_gid = None  # type: str
+        self.gid_nav_img = "nav_img"
+        self.gid_nav_cmarker = "nav_center_marker"
+
+        self.gid_stage_pos_xy = "stage_pos_xy"
+        self.gid_stage_rect = "stage_pos_scan_field"
+
+        self.gid_nav_poit_mark = "nav_poit_mark-"
+        self.nav_poit_marks = []
+
+        self.nav_circle_marker = NavCircleMarker()
+
+        self.canvas.init_ss(self)
+
+    def update_nav_img(self, nav_img: NavImage):
+        if nav_img is None or nav_img.img is None:
+            self.canvas.clear_ui(self.gid_nav_img)
+            self.canvas.clear_ui("stage_pos")
+            self.canvas.draw()
+            return
+
+        x_min, y_min, x_max, y_max = nav_img.bounds
+        self.canvas.update_ui(self.gid_nav_img, self.canvas.axes.imshow(nav_img.img, extent=(x_max, x_min, y_max, y_min)))
+        self.canvas.set_lims((x_max, x_min), (y_max, y_min))
+        self.canvas.update_ui(self.gid_nav_cmarker, self.canvas.axes.scatter(0, 0, c="green", marker="+", zorder=10))
+        self.canvas.draw()
+
+        self.widget.navi_toolbar.update()
+        self.widget.navi_toolbar.push_current()
+
+    def on_click(self, event: MouseEvent):
+        if event.xdata is None or event.ydata is None:
+            return
+
+        if not self.canvas.has_ui(self.gid_nav_img):
+            return
+
+        if event.button == MouseButton.RIGHT:
+            self._popup_menu(
+                [
+                    ("移动至此", functools.partial(self._slot_goto, (event.xdata, event.ydata))),
+                    ("添加标记", functools.partial(self._slot_mark, (event.xdata, event.ydata))),
+                ]
+            )
+
+    def _popup_menu(self, items):
+        menu = QMenu(self.canvas)
+        for label, callback in items:
+            action = menu.addAction(label)
+            action.triggered.connect(callback)
+        menu.exec(QCursor.pos())
+
+    def _slot_goto(self, xy, checked: bool = False):
+        zem_api.stage_xy_goto(xy)
+
+    def _slot_mark(self, xy, checked: bool = False):
+        gid = f"{self.gid_nav_poit_mark}{len(self.nav_poit_marks)}"
+        self.canvas.update_ui(gid, self.canvas.axes.scatter(xy[0], xy[1], s=20, marker="*", c="blue", picker=True, zorder=10))
+        self.nav_poit_marks.append(xy)
+        self.canvas.draw()
+
+    def _update_nav_point_mark(self, gid: str, x, y):
+        idx = int(gid.split("-")[-1])
+        self.nav_poit_marks[idx] = (x, y)
+        self.canvas.ui_items[gid].set_offsets(np.array((x, y), dtype=np.float32))
+        self.canvas.draw()
+
+    def _slot_clear_mark(self, checked: bool = False):
+        self.canvas.clear_uis(self.gid_nav_poit_mark)
+        self.nav_poit_marks.clear()
+
+        self.canvas.clear_uis(self.nav_circle_marker.gid_nav_circle_mark)
+        self.canvas.draw()
+
+    def on_release(self, event: MouseEvent):
+        self._picked_gid = None
+
+    def on_pick(self, event: PickEvent):
+        if event.mouseevent.button != 1:
+            return
+        gid = event.artist.get_gid()
+        logger.debug("pick: index={} gid={}".format(event.ind, gid))
+        self._picked_gid = gid
+
+    def on_move(self, event: MouseEvent):
+        if event.xdata is None or event.ydata is None or self._picked_gid is None:
+            return
+
+        x, y = event.xdata, event.ydata
+
+        if self._picked_gid.startswith(self.gid_nav_poit_mark):
+            self._update_nav_point_mark(self._picked_gid, x, y)
+
+        match self._picked_gid:
+            case self.nav_circle_marker.gid_nav_circle_mark_c:
+                self._update_nav_circle_mark_c(x, y)
+            case self.nav_circle_marker.gid_nav_circle_mark_r:
+                self._update_nav_circle_mark_r(x, y)
+
+    def update_field_and_loc(self, field_with_loc: FieldWithLoc):
+        x, y = field_with_loc.pos.x, field_with_loc.pos.y
+        scan_um = field_with_loc.scan_info.scan_um
+
+        if self.canvas.has_ui(self.gid_stage_pos_xy):
+            w_pos = self.canvas.ui_items[self.gid_stage_pos_xy]
+            w_pos.set_offsets((x, y))
+
+            w_rect = self.canvas.ui_items[self.gid_stage_rect]  # type: Rectangle
+            w_rect.xy = (x - scan_um / 2, y - scan_um / 2)
+            w_rect.set_width(scan_um)
+            w_rect.set_height(scan_um)
+        else:
+            rect = Rectangle((x - scan_um / 2, y - scan_um / 2), scan_um, scan_um, facecolor="None", edgecolor="red", linewidth=1, zorder=10)
+            self.canvas.update_ui(self.gid_stage_rect, rect)
+            self.canvas.update_ui(self.gid_stage_pos_xy, self.canvas.axes.scatter(x, y, c="green", marker="+", zorder=10))
+        self.canvas.draw()
+
+    def add_circle_mark(self, center, radius):
+        ncm = self.nav_circle_marker
+        ncm.center = center
+        ncm.radius = radius
+        self.canvas.update_ui(ncm.gid_nav_circle_mark, Circle(center, radius=radius, facecolor="None", edgecolor="blue", label="circle roi", linestyle="--", linewidth=2, zorder=10))
+        self.canvas.update_ui(ncm.gid_nav_circle_mark_c, self.canvas.axes.scatter(center[0], center[1], s=20, marker="+", c="blue", picker=True, zorder=10))
+        self.canvas.update_ui(ncm.gid_nav_circle_mark_r, self.canvas.axes.scatter(center[0] + radius, center[1], s=20, marker="x", c="red", picker=True, zorder=10))
+        self.canvas.draw()
+
+    def _update_nav_circle_mark_c(self, x, y):
+        self.nav_circle_marker.center = (x, y)
+        self._update_nav_circle_mark()
+
+    def _update_nav_circle_mark_r(self, x, y):
+        self.nav_circle_marker.radius = math.sqrt((x - self.nav_circle_marker.center[0]) ** 2 + (y - self.nav_circle_marker.center[1]) ** 2)
+        self._update_nav_circle_mark()
+
+    def _update_nav_circle_mark(self):
+        ncm = self.nav_circle_marker
+        self.canvas.ui_items[ncm.gid_nav_circle_mark].center = ncm.center
+        self.canvas.ui_items[ncm.gid_nav_circle_mark].radius = ncm.radius
+        self.canvas.ui_items[ncm.gid_nav_circle_mark_c].set_offsets(ncm.center)
+        self.canvas.ui_items[ncm.gid_nav_circle_mark_r].set_offsets((ncm.center[0] + ncm.radius, ncm.center[1]))
+        self.canvas.draw()