TSV (.tsv)

背景

    • MIME 类型：text/tab-separated-values
    • TSV 表格数据格式.
    • 按行存储数值和文本信息，使用制表符分隔字段.
    • TSV 是 Tab-Separated Values 的缩写.
    • 纯文本格式.
    • 类似于 CSV.

Import 与 Export

  • Import["file.tsv"] 返回字符串和数字的二维数组，表示存储在文件中的行列.
  • Import["file.tsv",elem] 从一个 TSV 文件中导入指定的参数.
  • Import["file.tsv",{elem,sub1,…}] 导入子参数，特别是有助于导入部分数据的参数.
  • 导入格式可以用 Import["file","TSV"] 或 Import["file",{"TSV",elem,…}] 指定.
  • Export["file.tsv",expr] 从 expr 创建 TSV 文件.
  • 支持的 expr 表达式包括：
  • {v1,v2,…}单列数据
    {{v11,v12,…},{v21,v22,…},…}数据行列表
    array数组包括 SparseArray、QuantityArray 等
    tseriesTimeSeries、EventSeries 或 TemporalData 对象
    Dataset[…]数据集
  • 请到以下参考页面了解完整的基本信息：
  • Import, Export从文件导入或导出到文件
    CloudImport, CloudExport从云对象导入或导出到云对象
    ImportString, ExportString从字符串导入或导出到字符串
    ImportByteArray, ExportByteArray从字节数组导入或导出到字节数组

Import 参数

  • Import 通用参数：
  • "Elements"该文件可用的参数和选项列表
    "Rules"所有可用参数的规则列表
    "Summary"文件摘要
  • 表示数据的参数：
  • "Data"二维数组
    "Grid"作为 Grid 对象的表格数据
    "RawData"二维数组字符串
    "Dataset"作为 Dataset 列表数据
  • 默认情况下，Import 与 Export 使用 "Data" 参数.
  • 对于部分数据导入，任何数据表示参数 elem 可用 {elem, rows, cols} 格式指定行和列，其中 rows 和 cols 可为以下任意：
  • n第 n 行或列
    -n从末尾计数
    n;;m从 n 到 m
    n;;m;;s从 n 到 m 步长为 s
    {n1,n2,…}特定的行和列 ni
  • 元数据参数：
  • "Dimensions"行数列表和最大列数
    "MaxColumnCount"最大列数
    "RowCount"行数

选项

  • Import 与 Export 选项：
  • "EmptyField"""如何表示空白字段
    "TextDelimiters""\""用于分隔非数值字段的字符串或字符串列表
  • 数据区域内包含逗号或行分隔符通常用双引号字符包围. 默认情况下，Export 使用创引号字符作为分隔符. 指定不同字符使用 "TextDelimiters".
  • 默认情况下，并不导入双引号字符分隔的文本字段.
  • Import 选项：
  • CharacterEncoding"UTF8ISOLatin1"文件中行字符串使用的编码
    "CurrencyTokens"{{"$", "£", "¥", "€"}, {"c", "¢", "p", "F"}}当导入数值值时会跳过货币单位
    "DateStringFormat"None日期格式，按 DateString 规范给出
    "FillRows"Automatic是否将行按最大列长填满
    "HeaderLines"0假设为开头的行数
    "IgnoreEmptyLines"False是否忽略空白行
    "NumberPoint""."小数点字符串
    "Numeric"Automatic如果可以的话是否将数据字段导入为数字
    "SkipLines"0文件开头处跳过的行数
  • 在默认情况下，Import 尝试将数据解释为 "UTF8" 编码文本. 如何文件中存储的任意位数序列不能用 "UTF8" 表示，则 Import 使用 "ISOLatin1" 替代.
  • 用 CharacterEncoding -> Automatic, Import 将尝试推断文件的字符编码.
  • 以下为 "HeaderLines" 和 "SkipLines" 的可能设定：
  • n逃过 n 行或作为 Dataset 标题使用
    {rows,cols}跳过行和列或作为标题使用
  • Import 把由 "DateStringFormat" 选项指定格式化的表格项转换 DateObject.
  • Export 选项：
  • AlignmentNone数据如何在表格行中对应
    CharacterEncoding"UTF8"文件中行字符串使用的编码
    "FillRows"False是否将行按最大列长填满
    "TableHeadings"None表格行和列的标题
  • Alignment 的可用设定为 None、Left、Center 和 Right.
  • "TableHeadings" 可设置为以下值：
  • None没有标签
    Automatic对列和行给出连续的整数标签
    {"col1","col2",…}列标签列表
    {rhead,chead}指定行和列的单独标签
  • Export 使用运行 Wolfram 语言的计算机系统的常用规范编码行分隔字符.

范例

打开所有单元关闭所有单元

基本范例  (3)

以下导入整个 TSV 文件：

将 TSV 文件导入为有开头的 Dataset：

将表达式数组导出为 TSV：

范围  (4)

导出一个 Dataset：

用 Values 从数据集中去除标题：

使用 "HeaderLines" 选项导入表格标题：

导出一个 TimeSeries：

导出一个 EventSeries：

导出一个 QuantityArray：

导入参数  (17)

"Data"  (6)

导入 TSV 文件为值的二维列表：

以下为默认参数：

导入 TSV 文件的单行：

导入 TSV 文件的部分指定行：

导入 TSV 文件的前 3 行：

从 TCV 文件导入单行和列：

从 TCV 文件导入单列：

"Dataset"  (3)

导入 TSV 文件为 Dataset：

用 "HeaderLines" 将首行作为列开头使用：

用 "SkipLines" 仅导入需要的数据：

"Dimensions"  (1)

从 TSV 文件导入维数：

若文件中的所有行不含有相同列数，将使用最大行数：

"Grid"  (1)

导入 TSV 数据为 Grid：

"MaxColumnCount"  (1)

从 TCV 文件获取最大列数：

"RawData"  (3)

导入 TSV 数据为原始字符串：

对比 "Data"：

默认情况下对于 "RawData"，使用 "Numeric"->False：

使用 "Numeric"->True：

默认情况下对于 "RawData"，使用 "FillRows"->True：

使用 "FillRows"->False：

"RowCount"  (1)

从 TSV 文件中获取行数：

"Summary"  (1)

TSV 文件摘要：

导入选项  (10)

CharacterEncoding  (1)

字符串编码可用 $CharacterEncodings 设定为任意值：

"CurrencyTokens"  (1)

自动忽略货币符号：

使用 "CurrencyTokens"->None 来包含货币符号：

"DateStringFormat"  (1)

用指定的数据格式将数据转换为 DateObject:

默认情况下，没有发生转换：

"EmptyField"  (1)

对 TSV 数据中的控字段指定默认值：

"FillRows"  (1)

对于 "Data" 参数，行长度自动被保存：

对齐行：

对于 "RawData" 参数，默认导入完整数组：

"HeaderLines"  (1)

默认情况下，没有行或列设定为标题行：

指定列标题：

指定行标题：

指定行和列标题：

"IgnoreEmptyLines"  (1)

使用 "IgnoreEmptyLines" 从导入数据中去除没有数据的行：

"Numeric"  (1)

使用 "Numeric"->True 解释数字：

默认情况下，将全部导入为字符串：

"SkipLines"  (1)

TSV 文件可能包括注释行：

跳过注释行：

跳过注释行，并用下一行作为 Dataset 标题：

"TextDelimiters"  (1)

默认文本分隔符为双引号：

不同字符可以作为文本分隔符使用：

导出选项  (7)

排列  (1)

默认情况下，对于任何排列不添加附加字符：

左对齐列的值：

中间对其列的值：

CharacterEncoding  (1)

字符串编码可通过 $CharacterEncodings 设置任意值：

"EmptyField"  (1)

默认情况下，空白参数导出为空白字符串：

对空白参数指定不同值：

"FillRows"  (1)

默认情况下，导出完整数组：

用 "FillRows"->False 保持行的长度：

"TableHeadings"  (1)

用自定义列标题导出数据：

用自动以列和行标题导出数据：

用成功整合的列和行的标签导出数据：

"TextDelimiters"  (2)

非数值参数的分隔符为双引号：

指定不同分隔符字符：

用 "TextDelimiters"->"" 使任何文本分隔符无效：

默认情况下，数值参数没有任何分隔符字符：

应用  (1)

将欧洲国家和其人口列表导出至 TSV 文件：

导回数据并转换为表达式：

可能问题  (5)

由旧版本 Wolfram 语言生成的部分 TSV 数据可能含有不正确的文本分割区域，且在版本 11.2 中无法按预期导入：

使用 "TextDelimiters""" 将会给出之前预测的结果：

默认情况下，全部数组用双引号 "TextDelimiters" 导出：

用 "TextDelimiters""" 和 "FillRows"False 导出 TSV 数据与 11.2 之前版本类似：

格式输入 "nnnDnnn" 或 "nnnEnnn" 被诠释为科学计数法的数字：

使用 "Numeric" 选项来控制该诠释：

在导入行列标题的 Dataset 时，左上角数据丢失：

Dataset 根据数据维数不同可能会有不同显示：