# 行星数据库 WebUI 用户指南

## 1. 登录与数据库分区

- 使用账户密码或有效令牌登录。
- 普通数据库用户只能进入已授权的数据库分区，并可查看、绘图、导入和导出数据。
- 访客账户只能查看和绘图。
- 忘记密码、临时登录和重置密码需要管理员签发的令牌。

## 2. 数据绘图

1. 选择数据库、X 数据区与字段、Y 数据区与字段。
2. 在 Level 1、Level 2、Level 3 中多选标签；未选择时不限制该层级。
3. 选择“追加图层”可保留现有图，并从相同或不同数据库继续添加数据。
4. 数据描述符含 `err`、`Error`、`uncertainty`、`1Sigma` 或 `2Sigma` 等字段时，绝对误差会作为误差棒绘制。
5. 鼠标悬停在数据点上可查看样品名、标签、数值与误差信息。
6. 可设置 X/Y 轴范围、线性或对数坐标，并临时输入手工点进行比较。

## 3. 导入数据

- 支持 `.json`、`.xlsx` 和 `.xls`。
- 每次导入必须填写身份或批次戳，用于追踪数据来源。
- Excel 只读取第一张工作表，前三行是固定的三层字段路径。
- 第一层示例：`Major`、`Trace`、`Isotope`、`Mineral`、`Age`、`Location`。
- 第二层填写元素、氧化物、同位素体系或坐标名称，例如 `MgO`、`La`、`d18O`、`Latitude`。
- 第三层填写 `Value`、`Unit`、`err` 或 `Reference`。
- `err` 必须填写绝对误差，不填写相对百分比。例：`7.257 +/- 0.042 wt%` 应写为 Value=`7.257`、Unit=`wt%`、err=`0.042`。
- 常用单位：主量元素 `wt%`；微量元素 `ppm` 或 `ppb`；同位素 `per mil` 或 `ratio`；年龄 `Ma` 或 `Ga`；坐标 `degree`；高程 `m`。
- 缺失数据留空，不要填写 `0`、`-`、`n/a` 或检测限文本。
- `Reference` 建议填写 DOI、公开网址或可核查的文献说明。

## 4. Classification 层级

Excel 中每一条 Classification 路径占一列：

```text
Row 1: Classification
Row 2: Lunar basalt
Row 3: A11
Data : Type B crystalline rock
```

如需不同分类路径，请复制该列并修改第 2、3 行。样品只在适用的分类列中填写值。

## 5. Excel 转 JSON

1. 先在“输入文件导入”上传 Excel。
2. 在“Excel 转 JSON”中选择该文件。
3. 填写身份或批次戳和输出文件名。
4. 点击“生成”。未写 `.json` 后缀时系统会自动补充。

## 6. 筛选导出

1. 选择数据库。
2. 按 Level 标签多选需要的样品范围。
3. 选择要导出的数据列。
4. 导出时所选字段的单位、绝对误差与参考文献会一并输出。

## 7. 公开示例说明

- Apollo 10017 主量数据来自 NASA SP-214, Table 5-III。
- BHVO-2 主量和微量数据来自 USGS BHVO-2 Information Sheet，误差为表中给出的绝对不确定度。
- BHVO-2 坐标采用 USGS Kilauea 页面公布的火山顶点坐标，仅作为公开地点坐标示例，不是样品级 GPS 测量。