上传数据的格式要求
一句话:把文件整理成平台能一次读懂的样子——支持哪些格式、表格怎么排、各分析模块分别要什么,照着做少返工。
支持哪些文件类型
按您要做的事情选文件类型,各类型的用途和要求如下:
| 文件类型 | 用途 | 要求 |
|---|---|---|
PDF、Word(.doc / .docx) | 文献、报告入库(专题知识库);科研问答上传附件 | 文字可选中的原生文档更利于精读与检索,纯扫描图片版效果会打折 |
Excel(.xls / .xlsx)、CSV(.csv) | 智能统计、智能绘图 | 一张整洁数据表,按下方「表格数据的通用要求」整理 |
| Excel、CSV、TSV(制表符分隔文本) | 组学分析的表达矩阵 + 分组表 | 两个文件,样本名要一一对齐 |
| 图片(PNG、JPG / JPEG 等) | 科研问答多模态提问、结果配图 | 图面清晰、内容可辨 |
单文件大小、文件数量与总容量上限以上传页面的提示为准;总容量额度随成长等级提升而增加。
表格数据的通用要求
统计、绘图、组学都要读您的表格,下面这几条对所有表格通用——照着自查一遍,能省掉大部分上传报错:
| 要求 | 怎么做 | 常见错误 |
|---|---|---|
| 表头在第一行 | 每列一个变量,列名唯一、简短,尽量用英文或拼音 | 列名重复、留空、以数字开头 |
| 每行一个样本 | 一行对应一个样本或一次观测;分组、批次各占一列 | 把分组、批次信息塞进样本名里 |
| 样本名前后一致 | 同一样本在各表里的写法完全相同 | Ctrl_1 与 ctrl-1 被当成两个样本 |
| 数值列只放数字 | 单位、备注、文字另开一列存放 | 数值里混进单位或文字,整列被当成文本,分析跑不动 |
| 缺失值统一处理 | 缺的地方留空,或统一写 NA | 「-」「/」「未测」各写各的 |
| 不用表格花样 | 一个工作表只放一张表,多张表分开存 | 合并单元格、跨行标题、行内小计、用颜色承载信息 |
[ 待补充 · 图 ] 一张「整洁数据表」示例:表头在第一行,每列一个变量、每行一个样本,分组单独成列。
各分析模块的具体要求
通用要求之外,不同模块对文件的组织方式还有一点差别:
| 模块 | 需要的文件 | 关键要求 |
|---|---|---|
| 智能统计 / 智能绘图 | 一张整洁数据表(Excel / CSV) | 每列一个变量、每行一个样本,分组作为其中一列,整理好直接上传 |
| 组学智能体 | 表达矩阵 + 分组表 | 矩阵行是基因 / 特征、列是样本;两份文件的样本名一一对齐 |
| 分析工具箱 | 按各工具卡的输入说明 | 每张工具卡对输入格式有具体要求,以卡片内说明为准 |
| 公共数据挖掘 | 内置公共数据集,可选联合您的自有数据 | 自有数据同样按上方整洁表整理后再联合分析 |
| 科研问答 | 图片 / PDF / Word / Excel | 作多模态提问的附件,非结构化文件也可以 |
组学的表达矩阵与分组表怎么一步步整理、怎么核对样本名,见 表达矩阵与分组表怎么准备。至于某个数值该用原始 count 还是归一化值、某种分析适不适合您的数据——这些属于方法学,请看 表达矩阵整理 等教程。
常见格式报错与排查
| 现象 | 多半原因 | 怎么办 |
|---|---|---|
| 提示格式不符 | 文件类型不在支持范围,或 Excel 里夹了多余工作表、图表对象 | 换成上表支持的类型;删掉多余工作表与嵌入对象再传 |
| 样本名对不上(组学常见) | 表达矩阵的列名与分组表的样本名不一致 | 逐个核对大小写、空格、下划线和多余字符 |
| 数值列被读成文本 | 该列混进了单位、文字或全角符号 | 清成纯数字,把全角符号改成半角 |
| 文件过大或数量超限 | 超过上传页面提示的上限 | 先压缩文件,或按分组、批次把大表拆成多个文件分别上传 |
更多排查思路见 常见问题。