hsi-preprocessing-toolkit 2.0.0a2__tar.gz → 2.1.0__tar.gz

{hsi_preprocessing_toolkit-2.0.0a2 → hsi_preprocessing_toolkit-2.1.0}/PKG-INFO

@@ -1,20 +1,19 @@
 Metadata-Version: 2.4
 Name: hsi-preprocessing-toolkit
-Version: 2.0.0a2
+Version: 2.1.0
 Summary: HSI Preprocessing Toolkit
 Author: songyz2023
 Author-email: songyz2023 <songyz2023dlut@outlook.com>
 License-Expression: AGPL-3.0-only
 Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: Implementation :: CPython
-Requires-Dist: einops>=0.8.1
-Requires-Dist: gradio>=5.35.0
-Requires-Dist: matplotlib>=3.10.3
-Requires-Dist: rasterio>=1.4.3
+Requires-Dist: einops>=0.8.0
+Requires-Dist: gradio>=5.50.0,<6.0.0
+Requires-Dist: matplotlib>=3.10.0
+Requires-Dist: rasterio>=1.4.0
 Requires-Dist: rs-fusion-datasets>=0.16.0
-Requires-Dist: scipy>=1.15.3
+Requires-Dist: scipy>=1.16.0
 Requires-Python: >=3.13
 Project-URL: Documentation, https://github.com/songyz2019/hsi-preprocessing-toolkit#readme
 Project-URL: Issues, https://github.com/songyz2019/hsi-preprocessing-toolkit/issues
@@ -23,8 +22,6 @@ Description-Content-Type: text/markdown
 
 # HSI Preprocessing Toolkit
 
-![](asset/screenshot.jpg)
-
 
 [![PyPI - Version](https://img.shields.io/pypi/v/hsi-preprocessing-toolkit.svg)](https://pypi.org/project/hsi-preprocessing-toolkit)
 [![PyPI - Downloads](https://img.shields.io/pypi/dm/hsi-preprocessing-toolkit)](https://pypi.org/project/hsi-preprocessing-toolkit)
@@ -32,36 +29,38 @@ Description-Content-Type: text/markdown
 ![GitHub Created At](https://img.shields.io/github/created-at/songyz2019/hsi-preprocessing-toolkit)
 ![GitHub License](https://img.shields.io/github/license/songyz2019/hsi-preprocessing-toolkit)
 
+![](asset/screenshot.jpg)
 
-A Hyperspectral Preprocessing Toolkit that
+HSI Preprocessing Toolkit (HPT, formerly HDR2MAT) is a hyperspectral image preprocessing toolset that:
 1. Read the raw data from the HSI camera, and convert it into `.mat` file
 2. Read the `.mat` file
 3. Preview HSI, and convert it to RGB `.png` file
 4. Crop and rotate the HSI and preview in realtime
 5. Select spectrals of interest visually and save them into a `.mat` file
-6. Mix multiple HSI image with layers. (coming in v2.0.0, now availabe in git)
+6. Mix multiple HSI images with layers.
+7. Some other utils
 
 
 ## Usage
 ### Manual
-1. Download from GitHub release
-2. Double click the `start.cmd` file. Make sure you have internet access during the first start.
+1. Download [hpt.cmd](https://github.com/songyz2019/hsi-preprocessing-toolkit/blob/main/script/hpt.cmd) from GitHub release
+2. Double click the `hpt.cmd` file. 
 
-### Install with pip
-```sh
-pip install hsi-preprocessing-toolkit
-hsi_preprocessing_toolkit
-```
+> **TIPS**: Make sure you have internet access during the first start
 
 ### Install with uv
-```sh
-uvx hsi_preprocessing_toolkit
-```
-or install as a tool
-```sh
-uv tool install hsi-preprocessing-toolkit
-hsi_preprocessing_toolkit
-```
+1. Install [uv](https://docs.astral.sh/uv/) directly or with pip: `pip install uv`
+2. Install HPT: `uv tool install hsi-preprocessing-toolkit`
+3. Start HPT: `hsi_preprocessing_toolkit`
+
+### Install with pip
+1. Install HPT: `pip install hsi-preprocessing-toolkit`
+2. Start HPT: `hsi_preprocessing_toolkit`
+
+> **TIPS**: It's not recommend to install CLI tools directly with pip, please use [uv tool](https://docs.astral.sh/uv/guides/tools/) or [pipx](https://pipx.pypa.io/) to install python applications in isolated environments.
+
+
+## Document
 
 
 ## Credit
@@ -89,4 +88,4 @@ GNU Affero General Public License for more details.
 
 You should have received a copy of the GNU Affero General Public License
 along with this program.  If not, see <https://www.gnu.org/licenses/>.
-```
+```

{hsi_preprocessing_toolkit-2.0.0a2 → hsi_preprocessing_toolkit-2.1.0}/README.md

@@ -1,7 +1,5 @@
 # HSI Preprocessing Toolkit
 
-![](asset/screenshot.jpg)
-
 
 [![PyPI - Version](https://img.shields.io/pypi/v/hsi-preprocessing-toolkit.svg)](https://pypi.org/project/hsi-preprocessing-toolkit)
 [![PyPI - Downloads](https://img.shields.io/pypi/dm/hsi-preprocessing-toolkit)](https://pypi.org/project/hsi-preprocessing-toolkit)
@@ -9,36 +7,38 @@
 ![GitHub Created At](https://img.shields.io/github/created-at/songyz2019/hsi-preprocessing-toolkit)
 ![GitHub License](https://img.shields.io/github/license/songyz2019/hsi-preprocessing-toolkit)
 
+![](asset/screenshot.jpg)
 
-A Hyperspectral Preprocessing Toolkit that
+HSI Preprocessing Toolkit (HPT, formerly HDR2MAT) is a hyperspectral image preprocessing toolset that:
 1. Read the raw data from the HSI camera, and convert it into `.mat` file
 2. Read the `.mat` file
 3. Preview HSI, and convert it to RGB `.png` file
 4. Crop and rotate the HSI and preview in realtime
 5. Select spectrals of interest visually and save them into a `.mat` file
-6. Mix multiple HSI image with layers. (coming in v2.0.0, now availabe in git)
+6. Mix multiple HSI images with layers.
+7. Some other utils
 
 
 ## Usage
 ### Manual
-1. Download from GitHub release
-2. Double click the `start.cmd` file. Make sure you have internet access during the first start.
+1. Download [hpt.cmd](https://github.com/songyz2019/hsi-preprocessing-toolkit/blob/main/script/hpt.cmd) from GitHub release
+2. Double click the `hpt.cmd` file. 
 
-### Install with pip
-```sh
-pip install hsi-preprocessing-toolkit
-hsi_preprocessing_toolkit
-```
+> **TIPS**: Make sure you have internet access during the first start
 
 ### Install with uv
-```sh
-uvx hsi_preprocessing_toolkit
-```
-or install as a tool
-```sh
-uv tool install hsi-preprocessing-toolkit
-hsi_preprocessing_toolkit
-```
+1. Install [uv](https://docs.astral.sh/uv/) directly or with pip: `pip install uv`
+2. Install HPT: `uv tool install hsi-preprocessing-toolkit`
+3. Start HPT: `hsi_preprocessing_toolkit`
+
+### Install with pip
+1. Install HPT: `pip install hsi-preprocessing-toolkit`
+2. Start HPT: `hsi_preprocessing_toolkit`
+
+> **TIPS**: It's not recommend to install CLI tools directly with pip, please use [uv tool](https://docs.astral.sh/uv/guides/tools/) or [pipx](https://pipx.pypa.io/) to install python applications in isolated environments.
+
+
+## Document
 
 
 ## Credit
@@ -66,4 +66,4 @@ GNU Affero General Public License for more details.
 
 You should have received a copy of the GNU Affero General Public License
 along with this program.  If not, see <https://www.gnu.org/licenses/>.
-```
+```

{hsi_preprocessing_toolkit-2.0.0a2 → hsi_preprocessing_toolkit-2.1.0}/pyproject.toml

@@ -1,23 +1,22 @@
 [project]
 name = "hsi-preprocessing-toolkit"
-version = "2.0.0a2"
+version = "2.1.0" # This will be changed by dunami according to git tag when releasing.
 description = "HSI Preprocessing Toolkit"
 readme = "README.md"
 requires-python = ">=3.13"
 dependencies = [
-    "einops>=0.8.1",
-    "gradio>=5.35.0",
-    "matplotlib>=3.10.3",
-    "rasterio>=1.4.3",
+    "einops>=0.8.0",
+    "gradio>=5.50.0,<6.0.0",
+    "matplotlib>=3.10.0",
+    "rasterio>=1.4.0",
     "rs-fusion-datasets>=0.16.0",
-    "scipy>=1.15.3",
+    "scipy>=1.16.0",
 ]
 authors = [
   { name = "songyz2023", email = "songyz2023dlut@outlook.com" },
 ]
 classifiers = [
   "Programming Language :: Python",
-  "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
   "Programming Language :: Python :: Implementation :: CPython",
 ]
@@ -33,7 +32,7 @@ url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple"
 default = true
 
 [build-system]
-requires = ["uv_build >= 0.8.0, <0.10.0"]
+requires = ["uv_build >= 0.9.0, <0.10.0"]
 build-backend = "uv_build"
 
 [tool.hatch.build.targets.wheel]

hsi_preprocessing_toolkit-2.1.0/src/hsi_preprocessing_toolkit/__main__.py

@@ -0,0 +1,29 @@
+import matplotlib.pyplot as plt
+import gradio as gr
+from .page.scanner_calc import ScannerCalcTab
+from .page.about import AboutTab
+from .page.hsi_preprocessing import HSIProcessingTab
+from .component.create_logger import create_gr_logger
+from .common import i18n, DEBUG, MULTI_USER, LOGGER_MEMORY_HANDLER, APP_NAME
+
+
+def main():
+    # Global State
+    plt.rcParams['font.family'] = 'SimHei'
+    theme = gr.themes.Default(primary_hue='cyan').set(
+        button_primary_background_fill='#39c5bb',
+        button_primary_background_fill_hover="#30A8A0",
+    )
+
+    with gr.Blocks(title=APP_NAME, theme=theme) as demo: # title=i18n("about.title")
+        HSIProcessingTab()
+        ScannerCalcTab()
+        AboutTab()
+        if not MULTI_USER:
+            create_gr_logger(LOGGER_MEMORY_HANDLER)
+
+    demo.launch(debug=DEBUG, share=False, inbrowser=True, i18n=i18n, favicon_path="asset/icon.ico") # , theme=theme
+
+
+if __name__ == "__main__":
+    main()

{hsi_preprocessing_toolkit-2.0.0a2 → hsi_preprocessing_toolkit-2.1.0}/src/hsi_preprocessing_toolkit/algorithm.py

@@ -1,17 +1,13 @@
 from scipy.ndimage import rotate
 import numpy as np
-import logging
 from copy import deepcopy
-
-logging.basicConfig(level=logging.INFO)
-logger = logging.getLogger(__name__)
-logger.info("started")
+from .common import LOGGER
 
 # Return A HWC Image, the C should work with both RGB and HSI
 def composite_img(imgs :list[np.ndarray], transforms:list[dict]):
     imgs = deepcopy(imgs)
     # Transform
-    logger.info(f"{transforms=}")
+    LOGGER.info(f"{transforms=}")
     for i, (img,trans) in enumerate(zip(imgs, transforms)):
         rotate_deg = trans['rotation']
         if rotate_deg % 360 != 0:
@@ -33,7 +29,7 @@ def composite_img(imgs :list[np.ndarray], transforms:list[dict]):
     sizes = [ ((h+abs(x)),w+abs(y)) for (h,w,_),(x,y) in zip(shapes, offsets)]
     canvas_h, canvas_w = ( max([x[0] for x in sizes]), max([x[1] for x in sizes]) )
     canvas_shape = (canvas_h, canvas_w, canvas_c)
-    logger.info(f"{sizes=} {canvas_shape=} {shapes=}")
+    LOGGER.info(f"{sizes=} {canvas_shape=} {shapes=}")
     canvas = np.zeros(shape=canvas_shape, dtype=imgs[0].dtype)
 
     # 合成 Compositing

hsi_preprocessing_toolkit-2.1.0/src/hsi_preprocessing_toolkit/asset/page/about.en.md

@@ -0,0 +1,31 @@
+# Hyperspectral Preprocessing Toolkit
+    
+A Hyperspectral Image Preprocessing Toolkit from HSI Camera to Machine Learning Dataset.
+
+## 帮助
+- [Homepage](https://github.com/songyz2019/hsi-preprocessing-toolkit)
+- [BUG Report](https://github.com/songyz2019/hsi-preprocessing-toolkit/issues)
+- [Help](https://github.com/songyz2019/hsi-preprocessing-toolkit/wiki)
+
+## Check for update
+![](https://img.shields.io/badge/Current-v${VERSION}-blue?style=for-the-badge)  
+![](https://img.shields.io/pypi/v/hsi-preprocessing-toolkit?label=Latest&style=for-the-badge)
+
+
+# License
+```text
+Copyright (C) 2025  songyz2019
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.
+```

hsi_preprocessing_toolkit-2.1.0/src/hsi_preprocessing_toolkit/asset/page/about.zh.md

@@ -0,0 +1,33 @@
+# Hyperspectral Preprocessing Toolkit
+    
+高光谱数据处理工具箱
+
+## 帮助
+- [主页](https://github.com/songyz2019/hsi-preprocessing-toolkit)
+- [问题反馈](https://github.com/songyz2019/hsi-preprocessing-toolkit/issues)
+- [帮助文档](https://github.com/songyz2019/hsi-preprocessing-toolkit/wiki)
+
+## 检查更新
+![](https://img.shields.io/badge/当前版本-v${VERSION}-blue?style=for-the-badge)  
+![](https://img.shields.io/pypi/v/hsi-preprocessing-toolkit?label=%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC&style=for-the-badge)
+
+
+## 许可
+```text
+Copyright (C) 2025  songyz2019
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.
+```
+
+

hsi_preprocessing_toolkit-2.1.0/src/hsi_preprocessing_toolkit/common.py

@@ -0,0 +1,137 @@
+import gradio as gr
+import logging
+import logging.handlers
+import os
+import importlib.metadata
+import platform
+
+# 全局信息
+APP_NAME='hsi-preprocessing-toolkit'
+APP_VERSION = importlib.metadata.version(APP_NAME)
+
+# 全局参数
+DEBUG = os.environ.get('HPT_DEBUG','FALSE').upper() in ['1', 'TRUE', 'YES']
+MULTI_USER = os.environ.get('HPT_MULTI_USER','FALSE').upper() in ['1', 'TRUE', 'YES']
+
+# I18N
+TRANSLATION = {
+    'en': {
+        "about.tab_title": "About",
+        "about.title": "HSI Preprocessing Toolkit",
+
+        "hsi_processing.tab_title": "HSI Processing",
+        "hsi_processing.load": "Load",
+        "hsi_processing.loading": "Loading, this could take minutes...",
+        "hsi_processing.loaded": "Loaded",
+        "hsi_processing.current_layer": "Selected Layer",
+        "hsi_processing.upload_instructions": "**Upload one of the following formats:**\n1. One .hdr file + one raw data file without extension\n2. One .mat file",
+        "hsi_processing.input_format": "Input Image Shape Format",
+        "hsi_processing.data_files": "Data Files",
+        "hsi_processing.manual_normalize": "Manual Normalize (affects preview only)",
+        "hsi_processing.normalize_min": "Normalize Min",
+        "hsi_processing.normalize_max": "Normalize Max",
+        "hsi_processing.wavelength_start": "Wavelength Range Start",
+        "hsi_processing.wavelength_end": "Wavelength Range End",
+        "hsi_processing.processing": "Processing",
+        "hsi_processing.crop": "Crop",
+        "hsi_processing.top": "Top",
+        "hsi_processing.bottom": "Bottom",
+        "hsi_processing.left": "Left",
+        "hsi_processing.right": "Right",
+        "hsi_processing.rotate": "Rotate",
+        "hsi_processing.rotate_degree": "Rotate Degree",
+        "hsi_processing.translate_offset": "Traslate",
+        "hsi_processing.translate_x": "X",
+        "hsi_processing.translate_y": "Y",
+        "hsi_processing.preview": "Preview",
+        "hsi_processing.apply_processing": "Apply Processing Effects",
+        "hsi_processing.mat_data_type": "MAT Data Type",
+        "hsi_processing.mat_format": "MAT Image Shape Format",
+        "hsi_processing.mat_key": "Key of MAT file",
+        "hsi_processing.compress_mat": "Produce Compressed MAT File",
+        "hsi_processing.spectral_selection": "Spectral Selection",
+        "hsi_processing.spectral_selection_help": "Click on the image to select pixels for spectral data extraction. The selected pixels will be plotted in the spectral plot below.",
+        "hsi_processing.spectral_plot": "Spectral Plot",
+        "hsi_processing.style": "Style",
+        "hsi_processing.clear": "Clear",
+        "hsi_processing.download": "Download",
+        "hsi_processing.output_results": "Output Results",
+        "hsi_processing.mat_file": "MAT File",
+        "hsi_processing.info": "Info",
+        "hsi_processing.same_as_input": "Same",
+        "hsi_processing.auto_detect": "Auto Detect",
+        "hsi_processing.applying_transforms": "Applying Transforms...",
+        "hsi_processing.applied_transforms": "Transforms Done",
+        "hsi_processing.no_converted_data_for_clicking": "No transforms applied data, apply transforms first",
+
+        "scanner_calc.tab_title": "Scanner Parameters",
+    },
+    'zh-CN' : {
+        "about.tab_title": "关于",
+        "about.title": "HPT高光谱处理工具箱",
+
+        "hsi_processing.tab_title": "高光谱图像处理",
+        "hsi_processing.current_layer": "选中图层",
+        "hsi_processing.load": "加载",
+        "hsi_processing.loading": "加载中,这可能需要几分钟...",
+        "hsi_processing.loaded": "加载完成",
+        "hsi_processing.upload_instructions": "**应上传以下两种格式中的一种**\n1. 同时上传一个.hdr文件 + 一个无后缀的数据文件\n2. 一个.mat文件",
+        "hsi_processing.input_format": "输入数据形状",
+        "hsi_processing.data_files": "数据文件",
+        "hsi_processing.manual_normalize": "手动归一化(仅影响预览结果)",
+        "hsi_processing.normalize_min": "归一化最小值",
+        "hsi_processing.normalize_max": "归一化最大值",
+        "hsi_processing.wavelength_start": "波长范围起始",
+        "hsi_processing.wavelength_end": "波长范围结束",
+        "hsi_processing.processing": "处理",
+        "hsi_processing.crop": "裁切",
+        "hsi_processing.top": "上",
+        "hsi_processing.bottom": "下",
+        "hsi_processing.left": "左",
+        "hsi_processing.right": "右",
+        "hsi_processing.rotate": "旋转",
+        "hsi_processing.rotate_degree": "旋转角度",
+        "hsi_processing.translate_offset": "平移",
+        "hsi_processing.translate_x": "X轴",
+        "hsi_processing.translate_y": "Y轴",
+        "hsi_processing.preview": "预览",
+        "hsi_processing.apply_processing": "应用处理效果",
+        "hsi_processing.mat_data_type": "mat文件数据类型",
+        "hsi_processing.mat_format": "mat文件格式",
+        "hsi_processing.mat_key": "mat文件的key",
+        "hsi_processing.compress_mat": "启用mat文件压缩",
+        "hsi_processing.spectral_selection": "光谱选择",
+        "hsi_processing.spectral_selection_help": "点击预览图像图像中的像素进行光谱数据提取。选中的像素将在下方的光谱图中绘制。",
+        "hsi_processing.spectral_plot": "光谱图",
+        "hsi_processing.style": "样式",
+        "hsi_processing.clear": "清空",
+        "hsi_processing.download": "下载",
+        "hsi_processing.output_results": "输出结果",
+        "hsi_processing.mat_file": "MAT文件",
+        "hsi_processing.info": "信息",
+        "hsi_processing.same_as_input": "与输入相同",
+        "hsi_processing.auto_detect": "自动检测",
+        "hsi_processing.applying_transforms": "应用变换中...",
+        "hsi_processing.applied_transforms": "变换完成",
+        "hsi_processing.no_converted_data_for_clicking": "没有应用变换后的数据,请先应用变换",
+
+        "scanner_calc.tab_title": "推扫仪计算",
+    }
+}
+i18n = gr.I18n(**TRANSLATION)
+
+# 日志
+LOGGER = logging.getLogger(TRANSLATION['en']['about.title']) # 全局唯一LOGGER
+LOGGER_MEMORY_HANDLER :logging.handlers.MemoryHandler|None = None
+if not MULTI_USER:
+    LOGGER_MEMORY_HANDLER = logging.handlers.MemoryHandler(10_000, flushLevel=logging.WARNING) # 用于在UI中显示LOGGING信息
+    LOGGER.addHandler(LOGGER_MEMORY_HANDLER)
+
+logging.basicConfig(
+    level=logging.DEBUG if DEBUG else logging.INFO,
+    format='[%(levelname)s %(asctime)s] %(name)s: %(message)s',
+    datefmt='%Y-%m-%d %H:%M:%S'
+)
+
+# 初始化完成
+LOGGER.info(f"{APP_NAME} v{APP_VERSION} initalized. {DEBUG=} {MULTI_USER=} Gradio=v{gr.__version__} Python=v{platform.python_version()} OS={platform.platform()}")

hsi_preprocessing_toolkit-2.1.0/src/hsi_preprocessing_toolkit/component/create_logger.py

@@ -0,0 +1,39 @@
+from ..util import records_to_html
+import gradio as gr
+import logging
+# from functools import partial
+
+# def _one_timer_tick(handler, state_n_line):
+#     n_line = len(handler.buffer)
+#     print(f"{n_line=} {state_n_line=}")
+#     if n_line == state_n_line:
+#         print("SKIP")
+#         return gr.skip(), state_n_line   
+#     else:
+#         return gr.update(value=records_to_html(handler.buffer, with_pre_tag=True)), n_line
+
+# Gradio 5.50中存在一个BUG，timer.tick中的show_progress="hidden"和gr.skip依然会触发loading动画，通过一个state来workaround
+
+def create_gr_logger(handler :logging.handlers.MemoryHandler):
+    state_n_line = gr.State(0)
+    timer = gr.Timer(value=2)
+    html = gr.HTML(
+        value="Loading.....",
+        label='Logging',
+        show_label=True,
+        container=True,
+        min_height=50, 
+        max_height=100,
+    )
+    state_n_line.change(
+        fn=lambda: records_to_html(handler.buffer, with_pre_tag=True),
+        inputs=[],
+        outputs=[html],
+        show_progress="hidden"
+    )
+    timer.tick(
+        fn=lambda: len(handler.buffer),
+        inputs=[],
+        outputs=[state_n_line],
+        show_progress="hidden"
+    )

hsi_preprocessing_toolkit-2.1.0/src/hsi_preprocessing_toolkit/component/logging_box.py

@@ -0,0 +1,43 @@
+# import gradio as gr
+# import logging
+# from collections import deque
+
+# We assume that there're limited users. Since every user *SHOULD* have a copy of logging info in server.
+# But actually, it is only creatd once when opening multiple tabs in browsers, wierd...
+
+# class _DequeLogHandler(logging.Handler):
+#     def __init__(self, max_logging_lines: int):
+#         super().__init__()
+#         self.buffer = deque([], maxlen=max_logging_lines)
+
+#     def emit(self, record):
+#         msg = self.format(record)
+#         self.buffer.appendleft(msg) # Some how auto scroll not work :(, we have to use a upside-down logging textbox
+    
+#     def get_logging(self, seprator='\n'):
+#         return seprator.join(self.buffer)
+    
+
+# def create_gr_logging_box(handler :logging.handlers.BufferingHandler, max_logging_lines=10_000, **kwargs) -> [logging.Handler, gr.Textbox]:
+#     # Somehow extend gr.Textbox block the UI, we do not wanna dive deeply, just a quick workaround
+#     """
+#     Usage: 
+#     handler, widget = create_gr_logging() # with any kwargs for gr.Textbox you need
+#     logger.add_handler(handler)
+
+#     """
+#     kwargs |= {
+#         'label': 'Logging',
+#         'every': 0.5,
+#         'buttons': ['copy'],
+#         'lines': 10,
+#         'max_lines': 10,
+#         'autoscroll': False
+#     }
+#     textbox = gr.Textbox(
+#         value=lambda: handler.get_logging(),
+#         **kwargs
+#     )
+
+#     return handler, textbox
+

hsi_preprocessing_toolkit-2.1.0/src/hsi_preprocessing_toolkit/page/about.py

@@ -0,0 +1,35 @@
+import gradio as gr
+from ..common import i18n, APP_VERSION
+
+from importlib import resources
+from string import Template
+
+def load_about_md(lang :str):
+    if lang.startswith('zh'):
+        lang = 'zh'
+    else:
+        lang = 'en'
+    text = resources.files("hsi_preprocessing_toolkit.asset.page").joinpath(f"about.{lang}.md").read_text(encoding="utf-8")
+    return Template(text).safe_substitute(
+        VERSION=APP_VERSION
+    )
+
+def AboutTab():
+    with gr.Tab(i18n('about.tab_title')):
+        # lang_state = gr.State()
+
+        # gr.HTML(
+        #     "<script defer>document.querySelector('#language_holder').innerHTML=navigator.language;</script>",
+        #     elem_id="language_holder",
+        # ).change(
+        #     lambda x:x,
+        #     outputs=lang_state
+        # )
+        about_content = gr.Markdown(load_about_md('zh')  + '\n\n' + load_about_md('en'))
+
+        # lang_state.change(
+        #     fn = load_about_md,
+        #     inputs=[lang_state],
+        #     outputs=[about_content]
+        # )
+