hsi-preprocessing-toolkit 2.0.0a2__tar.gz → 2.1.1.dev5__tar.gz

{hsi_preprocessing_toolkit-2.0.0a2 → hsi_preprocessing_toolkit-2.1.1.dev5}/PKG-INFO

@@ -1,20 +1,20 @@
 Metadata-Version: 2.4
 Name: hsi-preprocessing-toolkit
-Version: 2.0.0a2
+Version: 2.1.1.dev5
 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-Dist: webui2>=2.5.6
 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 +23,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 +30,43 @@ 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
+3. Preview HSI and convert it to RGB `.png` file
+4. Crop, rotate, transform 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. Generate Spectral Profiles for visualization.
+8. Some other utils
 
 
 ## Usage
+### Prerequisites
+1. A Chromium-based browser
+2. A modern OS
+
 ### 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 +94,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.1.dev5}/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,43 @@
 ![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
+3. Preview HSI and convert it to RGB `.png` file
+4. Crop, rotate, transform 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. Generate Spectral Profiles for visualization.
+8. Some other utils
 
 
 ## Usage
+### Prerequisites
+1. A Chromium-based browser
+2. A modern OS
+
 ### 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 +71,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.1.dev5}/pyproject.toml

@@ -1,23 +1,23 @@
 [project]
 name = "hsi-preprocessing-toolkit"
-version = "2.0.0a2"
+version = "2.1.1.dev5" # 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",
+    "webui2>=2.5.6",
 ]
 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 +33,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]
@@ -41,4 +41,4 @@ packages = ["hsi-preprocessing-toolkit/__main__.py"]
 
 
 [project.scripts]
-hsi_preprocessing_toolkit = "hsi_preprocessing_toolkit.__main__:main"
+hsi_preprocessing_toolkit = "hsi_preprocessing_toolkit.__main__:main"

hsi_preprocessing_toolkit-2.1.1.dev5/src/hsi_preprocessing_toolkit/__main__.py

@@ -0,0 +1,55 @@
+import matplotlib.pyplot as plt
+import gradio as gr
+import os
+
+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, LOGGER
+
+
+
+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, 
+        prevent_thread_lock=True, # 不阻塞主线程，配合webui/webbrowser
+        share=False, 
+        inbrowser=False, 
+        i18n=i18n, 
+        favicon_path="asset/icon.ico"
+    )
+    try:
+        from webui import webui
+        window = webui.Window()
+        window.show_browser(demo.local_url, webui.browser.ChromiumBased) # 这里的行为有些奇怪，启动成功了但依然会返回false
+        LOGGER.info('Launched in webui mode successfully')
+        window.set_minimum_size(1024, 768)
+        webui.wait() # wait似乎有bug
+        input("Running ...") # wait bug的quick dirty fix
+        # window.destroy()
+        # demo.close()
+        # os._exit(0)
+    except Exception as err:
+        window.destroy()
+        LOGGER.warning(f'Fallback to browser mode, {err}')
+        import webbrowser
+        webbrowser.open_new(demo.local_url)
+        input("Running ...") # quick dirty fix
+        
+if __name__ == "__main__":
+    main()

hsi_preprocessing_toolkit-2.1.1.dev5/src/hsi_preprocessing_toolkit/algorithm.py

@@ -0,0 +1,86 @@
+from scipy.ndimage import rotate
+import numpy as np
+from copy import deepcopy
+from .common import LOGGER
+import matplotlib
+import matplotlib.pyplot as plt
+import matplotlib.transforms as mtransforms
+import einops
+
+# 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=}")
+    for i, (img,trans) in enumerate(zip(imgs, transforms)):
+        rotate_deg = trans['rotation']
+        if rotate_deg % 360 != 0:
+            img = rotate(img, angle=rotate_deg, axes=(0, 1), reshape=True)
+
+        # Crop
+        crop_top, crop_left, crop_bottom, crop_right = trans['crop']
+        if crop_top > 0 or crop_left > 0 or crop_bottom > 0 or crop_right > 0:
+            crop_bottom = None if crop_bottom == 0 else -crop_bottom
+            crop_right  = None if crop_right == 0  else -crop_right
+            img = img[crop_top:crop_bottom, crop_left:crop_right, :]
+        
+        imgs[i] = img
+        
+    # Caclate canvas size
+    shapes = [x.shape for x in imgs]
+    offsets = [ x['location'] for x in transforms ]
+    canvas_c = imgs[0].shape[-1]
+    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=}")
+    canvas = np.zeros(shape=canvas_shape, dtype=imgs[0].dtype)
+
+    # 合成 Compositing
+    for img,trans in zip(imgs, transforms):
+        x,y = trans['location']
+        h,w,_ = img.shape
+        canvas[x:x+h, y:y+w] = img
+    return canvas
+
+def _min_max_normalize(x :np.ndarray):
+    r = x.max()-x.min()
+    if r<=np.finfo(x.dtype).eps:
+        return np.zeros_like(x, dtype=x.dtype)
+    return (x-x.min())/r
+
+def compose_spectral_profile(x: np.ndarray) -> np.ndarray:
+    '''
+    x: a [H C] or [W C] array, any dtype
+    return: HW4 RGBA Uint8 Image (0~225), x (as row direction) is height or width, y (as col direction) is spectral
+    '''
+    x = x.transpose(1,0) # convert to [C X]
+    x = _min_max_normalize(x)
+    mapper = matplotlib.colormaps.get_cmap('viridis')
+    rgb = mapper(x)
+    rgb = (rgb*255).astype('uint8')
+    return rgb
+
+
+
+
+def compose_bread_edge(hsi: np.ndarray) -> (np.ndarray, np.ndarray): # input HWC, output HWC
+    top = _min_max_normalize(hsi[:,0,:])   # H C
+    right = _min_max_normalize(hsi[0,:,:]) # W C
+    
+    # top_fig = plt.figure()
+    # top_im = plt.imshow(top, cmap='viridis')
+    # plt.axis('off')
+    # plt.subplots_adjust(top=1, bottom=0, right=1, left=0, hspace=0, wspace=0)
+    # # top_tr = mtransforms.Affine2D()
+    # # top_tr.rotate_deg(45).scale(1, 0.5)
+    # # top_im.set_transform(top_tr)
+    # # top_im.set_clip_on(False)
+
+    # right_fig = plt.figure()
+    # plt.imshow(right, cmap='viridis')
+    # plt.axis('off')
+    # plt.margins(0, 0)
+
+    return compose_spectral_profile(top), compose_spectral_profile(right)
+    

hsi_preprocessing_toolkit-2.1.1.dev5/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.
+
+## Help
+- [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.1.dev5/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.1.dev5/src/hsi_preprocessing_toolkit/common.py

@@ -0,0 +1,159 @@
+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
+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
+    )
+
+TRANSLATION = {
+    'en': {
+        "about.tab_title": "About",
+        "about.title": "HSI Preprocessing Toolkit",
+        "about.content": _load_about_md('en'),
+
+        "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",
+        "hsi_processing.spectral_profiles": "Spectral Profiles",
+        "hsi_processing.spectral_profiles.generate": "Generate Spectral Profiles",
+        "hsi_processing.spectral_profiles.x_lambda_plane": "x-λ",
+        "hsi_processing.spectral_profiles.y_lambda_plane": "y-λ",
+
+        "scanner_calc.tab_title": "Scanner Parameters",
+    },
+    'zh-CN' : {
+        "about.tab_title": "关于",
+        "about.title": "HPT高光谱处理工具箱",
+        "about.content": _load_about_md('zh'),
+
+        "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": "没有应用变换后的数据,请先应用变换",
+        "hsi_processing.spectral_profiles": "光谱剖面",
+        "hsi_processing.spectral_profiles.generate": "生成光谱剖面",
+        "hsi_processing.spectral_profiles.x_lambda_plane": "x-λ剖面",
+        "hsi_processing.spectral_profiles.y_lambda_plane": "y-λ剖面",
+
+        "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.1.dev5/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.1.dev5/src/hsi_preprocessing_toolkit/page/about.py

@@ -0,0 +1,24 @@
+import gradio as gr
+from ..common import i18n, 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
+        # )
+        gr.Markdown(i18n('about.content'))
+
+        # lang_state.change(
+        #     fn = load_about_md,
+        #     inputs=[lang_state],
+        #     outputs=[about_content]
+        # )
+