光谱分析工具

光谱数据分析

01数据通道
00已绘制曲线
0参与平均的文件

数据与通道

0 已选 / 0 个文件
先选择文件,再绘制平均光谱

平均光谱

暂无光谱数据

波长 / nm

服务器通道更新状态

通道名称通道状态
正在读取服务器通道…

从 ZIP 直接导入服务器

这是独立的服务器导入入口,不需要先选择、新建或导入本地通道,也不使用顶部“上传到”选项。

煤样自动归入“大同现阶段”,实验自动归入“实验相关”;无法识别的目录跳过。LIBS 筛选后平均,NIRS 直接平均,分别存储。确认清单后直接保存到服务器并更新缓存。

煤样编号不含日期,请确认此日期;实验使用目录名称中的日期。

操作帮助

第一次使用?先按“快速开始”操作;需要处理自己的文件时,再看“选择导入方式”。选中通道不等于显示曲线,图例才控制曲线显隐。

1. 快速开始:先看到一张图

  1. 登录:按提示输入访问口令。打开页面后会读取服务器已有通道及缓存,曲线默认全部隐藏,图上空白不代表没有数据。
  2. 显示曲线:点击右侧图表下方的通道图例;变淡的图例代表隐藏,再点一次即可显示。可以同时显示多个通道进行比较。
  3. 如果没有图例:在左侧选择通道,确认已选择文件,再点击“绘制平均光谱”。若服务器通道没有缓存,也可查看下方状态表并点击顶部“更新数据”。
  4. 查看强度变化:点击右侧“强度变化图”,即可对比当前可见通道的平均强度;点击“平均光谱”切换回来。
  5. 保存图片:点击“导出 PNG”,保存当前图表类型的图片。隐藏通道不参与图片导出。

只看服务器已有结果,不需要重新导入文件,也不需要每次点击“更新数据”。

2. 处理自己的文件:先选对导入方式

你想做什么点击哪个按钮得到什么
每个样品文件夹各画一条平均光谱,比较多个样品导入主文件夹…每个包含 CSV 的最底层文件夹建立通道;同时包含 LIBS、NIRS 时拆为两个通道
先对子文件夹分别平均,再按 LIBS / NIRS 汇总通道导入平均后文件…批量选择时每个直接子文件夹生成一个平均 CSV;直接选择样品文件夹时生成一个同名平均 CSV

独立服务器入口:ZIP 直导服务器(与顶部“导入数据”并列)

  1. 点击顶部“ZIP 直导服务器…”,无需先导入或选中本地通道。在弹窗中设置“煤样采样日期”(默认今天)。J 开头煤样编号不含日期,必须确认此日期;实验使用目录名称中的日期。
  2. 点击弹窗内“选择 ZIP 并导入服务器…”选择普通 ZIP。允许有外层包装目录,数据文件可以嵌套在样品目录内部;加密、分卷和 ZIP64 不支持。
  3. 系统在浏览器本地解压、识别并准备 CSV。J 开头且后接数字或数字分组的目录(如 J2604035-5)视为煤样,每个煤样生成一个 LIBS 平均 CSV 和/或 NIRS 平均 CSV,全部合并到 大同现阶段/月.日-正常采样-大同现阶段LIBS 和对应的 NIRS 通道。LIBS 最大强度须严格大于 1000 后参与平均;NIRS 不做强度过滤。
  4. 实验目录支持 10-28-1-煤饼 或 10.28-煤饼-1 格式,实验项目包括高度调整、上下午对比、干煤、煤饼、钛板、光纤调整实验。每个目录按类型拆成独立通道;煤饼、钛板保存全部原始 CSV,不预先过滤或平均,其他实验生成平均 CSV。结果保存到 实验相关/10.28-煤饼-1LIBS 或对应 NIRS 通道。原始 CSV 保留可读文件名,NIR 统一为 NIRS,嵌套目录展开为“子目录__文件名.csv”;重名时附加稳定标识,不改变光谱内容。
  5. 检查“ZIP 导入明细”及确认窗口后才会上传。无法识别、同编号重复、类型不明、文件损坏或平均波长不匹配的目录不会保存,并列出原因。实验命名冲突的目录也会跳过。
  6. 依次上传并更新缓存,已有同名同内容 CSV 跳过;不同内容跳过并保留服务器原文件,继续导入其他文件。失败不撤销之前已写入的数据,查看明细后可重试。此功能不受顶部“上传到”选项影响。

ZIP 最大 256 MiB、最多 20,000 个条目,解压后 CSV 总量不设固定上限,但大包仍可能因浏览器内存不足而失败,单个 CSV 最多 16 MiB。请使用新版 Chrome / Edge。已有平均标记的 CSV 不会再次按强度阈值筛除。煤样汇总通道的平均光谱按每个煤样等权计算。

混合数据自动拆分:同一煤样可以同时包含 LIBS 和 NIRS。两种导入方式都会将其拆成独立通道,不能混合求平均。优先识别平均文件类型标记、文件名中的 LIBS / NIR / NIRS,无标识时按可识别的波长范围判断;无法识别时会提示补充标识。原始文件不移动、不修改。

方式 A:导入主文件夹

  1. 点击“导入主文件夹…”,在文件选择窗口中选择主文件夹,并允许浏览器读取文件。
  2. 系统为每个包含 CSV 的最底层文件夹建立通道,通道名称默认取该文件夹名称;非最底层目录中的 CSV 会跳过。
  3. 在左侧选中要处理的通道;需要过滤低强度光谱时,将“文件类型”选为“LIBS-filter”,等待筛选结束,确认已选文件,再点击“绘制平均光谱”。对其他通道重复此步骤即可叠加比较。

方式 B:导入平均后文件

例如选择下面的“实验批次”文件夹:

实验批次/
  样品1/  → 多个原始 LIBS CSV
  样品2/  → 多个原始 LIBS CSV
  样品10/ → 多个原始 LIBS CSV
  1. 点击“导入平均后文件…”,选择“实验批次”。
  2. 浏览器分别读取每个直接子文件夹中的 CSV(包括更深层目录),LIBS 先按 LIBS-filter 筛选,NIRS 不做强度筛选,再按各自数据列逐波长求平均。
  3. 只有一种类型时生成名为“实验批次”的通道;混合类型生成“实验批次-LIBS”“实验批次-NIRS”两个通道,各自包含“样品1.csv”“样品2.csv”“样品10.csv”。这些文件先保留在当前页面,并不会自动下载或上传。
  4. 选择需要的平均 CSV,点击“绘制平均光谱”;如需保存到服务器,再点击顶部“导入数据”。

也可以直接选择一个样品文件夹

如果“样品1”内部直接存放原始 CSV,无需额外套一层主文件夹:点击“导入平均后文件…”,直接选择“样品1”,即可按类型分别平均。单一类型生成“样品1”通道;混合类型生成“样品1-LIBS”和“样品1-NIRS”,每个通道各有一个“样品1.csv”。

系统自动识别:有子文件夹包含 CSV 时使用批量模式,并提示忽略根目录 CSV;没有子文件夹 CSV 时,处理所选文件夹根目录的 CSV。无合格文件的子文件夹会提示并跳过;同一子文件夹中参与平均的波长轴或分段不一致,会终止本次导入,保留原通道。生成的平均 CSV 不会再次按强度阈值筛除。煤饼、钛板的原始 LIBS 在第一轮 Data 峰值严格 >1000 后,再以剩余峰值的(最小值+最大值)/2 为阈值,保留峰值 ≥ 阈值的整条光谱;其他 LIBS 只做第一轮。NIRS 不过滤。已平均 CSV 不重复过滤,也不参与第二轮阈值计算。 样品类型根据通道名及文件夹路径中的“煤饼”“钛板”识别,请保留这些关键词。再对这些平均 CSV 求平均时,每个子文件夹权重相同,不按原始文件数量加权。

3. 文件筛选、选择与计算

  • NIRS:不使用强度阈值筛选,所有有效光谱直接逐点平均;默认优先 REF,没有时使用文件中可用的数据列。仍检查数值、波长轴、数据列和分段是否一致,不会强行平均不匹配的文件。
  • LIBS-filter 的准确规则:只保留文件名含 LIBS(不区分大小写),且光谱最大强度严格大于 1000 的原始 CSV。等于或低于 1000 的文件不参与平均。这里是筛掉整条光谱,不是删除低强度采样点。煤饼、钛板的原始 LIBS 在第一轮 Data 峰值严格 >1000 后,再以剩余峰值的(最小值+最大值)/2 为阈值,保留峰值 ≥ 阈值的整条光谱;其他 LIBS 只做第一轮。NIRS 不过滤。已平均 CSV 不重复过滤,也不参与第二轮阈值计算。
  • 按哪一列筛选:有 Data 列时使用 Data;没有时使用默认数据列。横向格式使用最后一个非空行的强度,不按波长或 REF 数值判断。
  • 其他类型:“全部 CSV”不做 LIBS 强度阈值筛选;“LIBS”和“NIR / NIRS”按文件名识别。文件名搜索只缩小列表,不会自动取消搜索前已选的文件;计算前请核对“已选”数量。
  • 选择操作:单击选一个;Ctrl(Mac 为 ⌘)加单击追加或取消;Shift 加单击连续选择;也可拖动框选。全选、反选针对当前显示的列表;“清空”取消当前通道的全部选择。
  • 计算:选择“数据列”,再点击“绘制平均光谱”。对选中文件按相同波长逐点求算术平均,不做插值,且不能混用不同波长轴或不同分段。
  • 修改后重算:改变文件选择、文件类型或数据列后,原图不会自动替换。看到“选择已变更,请重新生成曲线”时,请再次点击“绘制平均光谱”。

4. 查看图表、比较通道与导出

  • 左侧通道筛选:可按日期、实验项目、名称或说明关键词组合筛选所有通道(包括尚未计算的通道)。它与右侧可选光谱筛选完全独立;仅缩小左侧列表,不切换当前编辑通道,不改变文件选择或曲线显隐。当前通道不匹配时会保留编辑内容并显示提示;点击左侧“重置筛选”恢复全部通道。
  • 左侧通道标签:切换当前操作对象,用来改文件、名称、颜色和左右纵轴;不会单独显示或隐藏曲线。左右轴适合比较量级不同的数据。
  • 快速找到光谱:在右图下方按“日期”“实验项目”筛选,也可输入名称或说明关键词;多个条件同时生效。“重置筛选”恢复全部图例。筛选只缩小下方可选光谱列表,不会隐藏已经显示的曲线,也不改变导出范围;需要隐藏曲线时点击对应图例。无法识别日期或项目的旧通道可选“未识别”查看。
  • 图表下方图例:控制该通道是否可见;两种图表共用相同的显隐状态。点击“绘制平均光谱”会显示该通道结果。
  • 清空绘图:位于“复位”左侧,一键隐藏所有通道,同时清空平均光谱图、强度变化图与单条光谱峰值图;不删除通道、文件或计算结果。需要恢复时点击下方图例。“复位”只恢复缩放,不清空曲线。
  • 平均光谱:横坐标为波长,纵坐标为所选数据列的平均值。滚轮缩放波长范围,拖动平移,悬停查看最近采样点,双击或点击“复位”恢复视图。
  • 单条光谱峰值:先通过“导入主文件夹”导入煤样原始光谱,选择左侧通道并勾选文件,再切换到“单条光谱峰值”。无需先绘制平均光谱:每个文件单独取所选数据列的最高强度,按文件名中的数字(包含小数)升序连线;悬停查看文件名、最高强度和峰值波长。切换通道、勾选文件或更换数据列时自动重算。LIBS-filter 使用上述按样品类型区分的规则;第二轮阈值根据当前通道全部原始 LIBS 计算,不随勾选或搜索改变。NIRS 不设阈值。点击“导出 PNG”保存此图;“导出强度值变化图”仍导出通道平均强度图。已平均 CSV 只能展示该平均文件的峰值,无法恢复原始各条光谱。读取失败文件不参与作图;上方状态显示失败数量。
  • 强度变化图:每个可见通道一个点,提取通道名称中的所有数字(小数作为完整数值),从左到右比较,跳过相同数值,以第一个不同数值从小到大排列,例如“2026实验-2、2026实验-2.1、2026实验-2.3、2026实验-3.1”。名称中的横杠作为分隔符,不作为负号;多个数值位置变化时依次比较,前面数值都相同时,数字项较少的排在前面。数值全部相同则按名称自然排序;不含数字的名称排在含数字的名称之后,再按名称自然排序。横坐标等间距排列并连线。纵坐标为该通道整条平均光谱所有采样点强度的算术平均,不是峰值,也不是积分面积。此模式不使用光谱图的左右轴、缩放和平移。
  • 比较前注意:LIBS 强度与 NIRS 的 REF 等数据量纲不同,不建议直接比较二者的强度变化值;可先按类型筛选图例,再点击图例控制显示。尽量使用相同数据列及可比的波长范围和采样方式;名称中的数字只决定顺序,横坐标并不代表真实浓度或时间间距。
按钮导出内容
导出 PNG当前图表类型:平均光谱模式保存可见光谱;强度变化图模式保存可见通道的强度变化图。
导出 CSV全部已计算通道,包括隐藏通道的逐波长平均光谱,并包含通道名称、数据列、纵轴和文件数量。不是原始 CSV 打包,也不是强度汇总表。
导出强度值变化图不论当前在哪种视图,都导出当前可见通道的强度变化图 PNG,按名称中的数值升序排列。

5. 保存到服务器:“导入数据”与“更新数据”不同

导入数据=上传当前通道

  1. 在左侧选中需要保存的通道,核对通道名称和文件列表。
  2. 在顶部“上传到”选择服务器分类文件夹(例如天津、大同1、实验相关),再点击“导入数据”,核对目标路径和 CSV 数量后确认。
  3. 服务器按“所选分类文件夹/通道名称/CSV 名称”保存,并自动更新该通道缓存;等待上传和缓存更新结束后查看提示。

上传范围是当前通道的全部 CSV,不是仅勾选的文件,也不受文件名搜索影响。“导入平均后文件”创建的通道上传的是生成的平均 CSV,不是原始文件夹中的所有文件。导入与求平均在浏览器本地进行,只有点击顶部“导入数据”并确认后才会上传;顶部“ZIP 直导服务器”是独立入口,会在确认清单后直接上传 CSV(煤饼、钛板为原始文件,煤样为平均文件)。

  • 上传接口也会将同批混合 LIBS / NIRS 自动拆成“原名称-LIBS”“原名称-NIRS”,逐通道更新缓存;网页导入时已拆分的通道分别上传即可。只向所选分类文件夹内的同名同类型通道追加;不同分类的同名通道相互独立。切换分类上传会新增或追加目标分类中的通道,不会移动或删除原通道。同名同内容文件跳过,同名但内容不同则跳过该文件并保留服务器原文件,继续导入其他文件。原始 CSV 可能按服务器规则规范化名称;生成的子文件夹平均 CSV 保留原名称。
  • 单次最多上传 1000 个 CSV,单个不超过 16 MiB;编码后的整次请求不超过 64 MiB,实际可上传的原文件总量会更小。

更新数据=处理服务器待更新通道

  • 下方状态表只列出服务器通道。“待更新”表示文件新增、改变、缓存缺失、处理规则升级或计算失败;“更新完毕”表示该通道缓存处理完成,不代表一定有可绘制曲线。
  • 服务器目录中的数据发生变化后,点击顶部“更新数据”。它只对待更新通道规范文件名并重建默认平均光谱缓存(LIBS 筛选后平均,NIRS 不做强度筛选直接平均),不重复计算未变化通道,也不上传本地通道。
  • 通过“导入数据”上传后会自动更新目标通道,一般无需再点“更新数据”;其他待更新通道仍需单独触发更新。若直接从磁盘上传文件,请等全部传完再点更新,避免读取未完成文件。
  • 刷新页面只加载现有缓存,不会自动重算。更新操作不修改电脑上选择的本地原始文件。

6. 通道命名与历史数据整理

推荐格式为月.日-实验项目-说明,日期补齐两位,例如“10.27-高度调整-2.3cm”“10.27-上下午对比-上午3cm”“10.22-正常采样-煤样”。实验项目包括:高度调整、上下午对比、干煤、煤饼、钛板、光纤调整实验、正常采样。

历史通道由管理员使用离线工具预览并备份后整理,网页“更新数据”不会批量更改通道名称。正常采样煤样的内部 CSV 已是单样平均光谱,保留文件名和内容;其他实验将合格 LIBS 逐点平均为一个 CSV,NIRS 原样保留。命名不明确、目标重名或波长不匹配的通道不强制修改,留待确认。

7. 常见问题:遇到这些情况怎么办?

有通道,但图上空白?
首次打开时曲线默认隐藏,先点图表下方图例。如果没有图例,检查已选文件数量,点击“绘制平均光谱”,或检查服务器通道是否待更新。强度变化图也只展示可见通道。
选择了文件夹,但没有文件或少了很多文件?
确认有 CSV,检查文件类型和文件名搜索。“导入主文件夹”只处理最底层目录;“导入平均后文件”支持直接选择含 CSV 的样品文件夹;如果选择的主文件夹包含子文件夹 CSV,则使用批量模式并提示忽略根目录 CSV。LIBS-filter 还会排除峰值不大于 1000、非 LIBS 或无法解析的文件。
服务器旧通道中仍混有 LIBS 和 NIRS?
系统不会擅自移动磁盘文件,也不会只计算其中一种而漏掉另一种。此类通道保持待更新并提示需要拆分。可重新导入原文件夹,自动拆出两个通道后分别上传。
“绘制平均光谱”是灰色的?
先选中文件;如果正在筛选、计算或更新服务器数据,请等待结束。留意左侧文件列表下方的状态和错误提示。
提示波长轴或分段不一致?
不要把不同波长轴或不同分段的文件放在一起平均。请分成不同通道处理;如果是导入平均后文件,请先整理发生错误的子文件夹。系统不会自动插值对齐。
上传失败、同名冲突或请求过大?
查看页面错误提示。同名异内容文件会跳过并保留原文件,不会中止其他文件上传;请查看导入报告中的冲突清单,需要保存不同版本时换一个明确的新通道名称。过大时拆分通道后分批上传;若提示 413,请联系管理员检查服务器代理的上传限制。
刷新后,本地导入的通道不见了?
未上传的文件、选择和自定义设置只保留在当前页面。需要服务器长期保存的 CSV,请在刷新或关闭页面前点击“导入数据”。导出 PNG 或 CSV 仅保存下载文件,不等于上传到服务器。
删除通道会删除服务器文件吗?
不会。通道旁“×”只从当前页面移除该通道;服务器上的文件仍在,刷新后会重新载入。服务器数据删除需由管理员处理。页面至少保留一个通道,最后一个通道不能删除。

输入访问口令