STL 模型体积与质量计算 Python 工具使用指南
STL 体积模型计算器是一款专为 3D 打印爱好者和工程师设计的 Python 命令行工具，能够快速精准地计算 STL、NIfTI 和 DICOM 格式 3D 模型的体积、表面积、边界框尺寸以及多种材料的质量估算。
为什么选择 STL 体积计算工具？核心价值解析
全格式支持，告别兼容性烦恼
- STL 全能解析：完美处理二进制和 ASCII 两种格式的 STL 文件
- 医疗影像兼容：支持 NIfTI 和 DICOM 医学图像格式
- 跨平台运行：基于 Python 开发，Windows/macOS/Linux 全支持
一站式分析，数据一目了然
默认运行即可获得：
- 文件大小与三角形数量统计
- 三维边界框尺寸（长×宽×高）
- 表面积精确计算（支持 cm²单位）
- 体积自动换算（默认 cm³，可选英寸单位）
- 20+ 材料质量估算（含 PLA、ABS、金属等常见材质）
灵活输出，满足多样化需求
- 美观表格视图：控制台输出自动格式化，数据清晰易读
- JSON 格式导出：支持与其他脚本/应用无缝集成
- 按需计算：可指定仅计算体积或表面积，提升自动化效率
安装方法：快速上手
准备 Python 环境
确保已安装Python 3.6+（推荐 3.8 及以上版本），可从 Python 官网下载最新版本。
克隆代码仓库
打开终端，执行以下命令：
git clone [代码仓库地址]
cd STL-Volume-Model-Calculator
安装依赖包
通过 pip 一键安装所有必要组件：
pip install .
安装完成后，输入 volume-calculator --help 验证是否成功，将显示完整命令帮助信息。
高效使用技巧：快速上手实战
基础用法：一键全量分析
只需指定文件路径，工具自动完成所有计算：
volume-calculator 你的模型文件.stl
进阶操作：精准控制计算参数
指定填充率计算质量
volume-calculator model.stl --infill 50 # 使用 50% 填充率计算质量
（默认 20% 填充率，同时显示 100% 实体质量作为参考）
仅计算体积并导出 JSON
volume-calculator part.stl --calculation volume --output-format json
查看所有支持材料
volume-calculator --list-materials
