This is documentation for Mathematica 8, which was
based on an earlier version of the Wolfram Language.
View current documentation (Version 11.2)

TSV (.tsv)

MIME type: text/tab-separated-values
TSV tabular data format.
Stores records of numerical and textual information as lines, using tab characters to separate fields.
TSV is an acronym for Tab-Separated Values.
Plain text format.
Similar to CSV.
  • Import and Export fully support the TSV format and provide various data conversion and formatting options.
  • Import automatically recognizes common number formats, including C and Fortran notations.
  • Numbers without decimal points are imported as integers.
  • Import imports a TSV file, returning a list of lists.
  • Export exports a two-dimensional array to a TSV file.
  • Import returns a two-dimensional array of strings and numbers, representing the rows and columns stored in the file.
  • Export creates a TSV file from an array expr, using the CForm of non-numeric table elements.
  • Mathematica automatically transforms arbitrary expressions to a list of lists when exporting to TSV.
  • Import imports the specified element from a TSV file.
  • Import imports multiple elements.
  • Export creates a TSV file by treating expr as specifying element elem.
  • Export treats each as specifying the corresponding .
  • Export exports expr with the specified option elements taken to have the specified values.
  • Export uses rules to specify the elements to be exported.
  • See the reference pages for full general information on Import and Export.
  • Save Selection As exports the selected part of a notebook as a TSV file.
"Elements"list of elements and options available in this file
"Rules"full list of rules for each element and option
"Options"list of rules for options, properties and settings
  • Data representation elements:
"Data"two-dimensional array, representing the rows and columns of a TSV file
"Grid"table data as a Grid object
AlignmentNonehow data is aligned within table columns
CharacterEncoding"UTF8"raw character encoding used in the file
CharacterEncoding"ASCII"raw character encoding used in the file
"EmptyField"""how to represent empty fields
"TextDelimiters"Automaticstring or list of strings used to delimit non-numeric fields
  • By default, Export delimits text fields containing tab characters with double-quote characters.
  • With an explicit setting of , Export always uses the specified string tokens to delimit text fields, effectively cycling through the list of delimiters.
  • puts double-quotes around each text field when exporting to TSV.
  • With , Export wraps each text field in parentheses.
  • Double-quote characters delimiting text fields are not imported by default.
"CurrencyTokens"{{"$", "£", "¥", "€"}, {"c", "¢", "p", "F"}}currency units to be skipped when importing numerical values
"DateStringFormat"Nonedate format, given as a DateString specification
"IgnoreEmptyLines"Falsewhether to ignore empty lines
"Numeric"Truewhether to import data fields as numbers if possible
"NumberPoint""."string to use for a decimal point
"NumberSigns"{"-","+"}strings to use for signs of negative and positive numbers
"HeaderLines"0number of lines to skip at the beginning of the file
  • Import converts table entries formatted as specified by the option to a DateList representation of the form .
  • With False, numbers will be imported as strings in the form they appear in the file.
  • Import automatically recognizes all common conventions for the encoding of line separator characters.
"TableHeadings"Noneheadings for table columns and rows
  • can be set to the following values:
Noneno labels
Automaticgives successive integer labels for columns and rows
{"col1","col2",...}list of column labels
{rhead, chead}specifies separate labels for the rows and columns
  • Export encodes line separator characters using the convention of the computer system on which Mathematica is being run.
This imports an entire TSV file:
Format the previous output as a Grid:
Read this file, ignoring the first line:
Mathematica automatically converts expressions to a list of lists when exporting to TSV:
This imports an entire TSV file:
In[1]:=
Click for copyable input
Out[1]=
Format the previous output as a Grid:
In[2]:=
Click for copyable input
Out[2]=
Read this file, ignoring the first line:
In[3]:=
Click for copyable input
Out[3]=
 
Mathematica automatically converts expressions to a list of lists when exporting to TSV:
In[1]:=
Click for copyable input
Out[1]=
In[2]:=
Click for copyable input
Out[2]=