Package org.djutils.data.csv

Class TSVData

java.lang.Object
org.djutils.data.csv.TSVData
public final class TSVData
extends Object
TSVData takes care of reading and writing of table data in Tab-Separated-Value format. The class can be used, e.g., as follows: 
 DataTable dataTable = new ListDataTable("data", "dataTable", columns);
 Writer writer = new FileWriter("c:/data/data.tsv");
 Writer metaWriter = new FileWriter("c:/data/data.meta.tsv");
 TSVData.writeData(writer, metaWriter, dataTable);
Copyright (c) 2020-2020 Delft University of Technology, Jaffalaan 5, 2628 BX Delft, the Netherlands. All rights reserved. See for project information https://djutils.org. The DJUTILS project is distributed under a three-clause BSD-style license, which can be found at https://djutils.org/docs/license.html.
Author:
Alexander Verbraeck, Peter Knoppers, Wouter Schakel

  • Method Details

    • writeData

      public static void writeData​(Writer writer, Writer metaWriter, DataTable dataTable) throws IOException, TextSerializationException
      Write the data from the data table in TSV format. The writer writes the data, whereas the metaWriter writes the metadata. The metadata consists of a TSV file with three columns: the id, the description, and the class. The first row after the header contains the id, description, and class of the data table itself. The second and further rows contain information about the columns of the data table.
      Parameters:
      writer - Writer; the writer that writes the data, e.g. to a file
      metaWriter - Writer; the writer for the metadata
      dataTable - the data table to write
      Throws:
      IOException - on I/O error when writing the data
      TextSerializationException - on unknown data type for serialization

    • writeData

      public static void writeData​(String filename, String metaFilename, DataTable dataTable) throws IOException, TextSerializationException
      Write the data from the data table in TSV format.
      Parameters:
      filename - String; the file name to write the data to
      metaFilename - String; the file name to write the metadata to
      dataTable - the data table to write
      Throws:
      IOException - on I/O error when writing the data
      TextSerializationException - on unknown data type for serialization

    • readData

      public static DataTable readData​(Reader reader, Reader metaReader) throws IOException, TextSerializationException
      Read the data from the TSV-file into the data table. Use the metadata to reconstruct the data table.
      Parameters:
      reader - Reader; the reader that can read the data, e.g. from a file
      metaReader - Reader; the writer for the metadata
      Returns:
      dataTable the data table reconstructed from the meta data and filled with the data
      Throws:
      IOException - on I/O error when reading the data
      TextSerializationException - on unknown data type for serialization

    • readData

      public static DataTable readData​(String filename, String metaFilename) throws IOException, TextSerializationException
      Read the data from the TSV-file into the data table. Use the metadata to reconstruct the data table.
      Parameters:
      filename - String; the file name to read the data from
      metaFilename - String; the file name to read the metadata from
      Returns:
      dataTable the data table reconstructed from the meta data and filled with the data
      Throws:
      IOException - on I/O error when reading the data
      TextSerializationException - on unknown data type for serialization