aggipp/vmext

VMEXT：数学表达式树可视化工具

镜像概述

数学表达式可表示为函数（非叶节点）及其参数（函数节点的子节点）构成的树结构，这种表达式树是存储和处理数学表达式的重要概念，也是最常用的数学表达式结构可视化方式。通常研究人员使用非数学优化的通用工具可视化表达式树，过程繁琐、冗余且易出错，因为可视化反映的是研究者对表达式标记的理解而非实际标记。VMEXT是一款从并行MathML自动可视化数学表达式树的工具，通过可视化实际标记，帮助内容提供者快速发现不影响表达式呈现的Content MathML标记问题，还支持基于任意相似度度量可视化两个表达式的相似或相同元素，助力数学信息检索系统的设计与交互优化。

核心功能

1. 从并行MathML自动生成数学表达式树的可视化
2. 识别Content MathML标记中不影响呈现的潜在问题
3. 基于任意相似度度量，可视化两个表达式的相似或相同元素
4. 帮助理解数学信息检索系统中相似度度量的逻辑（替代仅提供标量相似度得分）

使用场景

• 内容提供者：快速检查并行MathML标记的准确性，发现不易察觉的标记问题
• 数学信息检索系统开发者：设计和调试相似度度量，优化系统交互逻辑
• 研究人员：直观理解数学表达式的结构及其相似性

配置说明

基础安装（非Docker方式参考）

• 使用npm：npm i && npm start
• 使用Yarn：先安装Yarn（参考https://yarnpkg.com/en/docs/install%EF%BC%89%EF%BC%8C%E7%84%B6%E5%90%8E%E6%89%A7%E8%A1%8C%60yarn%60%E5%AE%89%E8%A3%85%E4%BE%9D%E8%B5%96%EF%BC%8C%60yarn start`启动服务
• 本地Mathoid配置：从npm安装本地Mathoid，修改config.yaml中的mathoidUrl

调试

运行yarn run debug，将生成的链接复制到浏览器，使用Chrome DevTools调试

模块管理

• lib目录包含核心库，通过app-module-path包简化模块引用（如require('lib/logger')）

Docker部署示例

Docker Run命令

bash
docker run -d -p 3000:3000 aggipp/vmext

（假设容器内服务端口为3000，映射到主机3000端口，可根据实际配置调整）

Docker Compose示例（可选）

yaml
version: '3'
services:
  vmext:
    image: aggipp/vmext
    ports:
      - "3000:3000"
    restart: always