TS1 File Format: Difference between revisions

Content deleted Content added
Created page with "=Introduction= This page contains information about the .ts1 file format used by TUFLOW for inputting boundary data. The Convert_to_st1 can be used to co..."
 
No edit summary
 
(6 intermediate revisions by 4 users not shown)
Line 1:
=Introduction=
This page contains information about the .ts1 file format used by TUFLOW for inputting boundary data. The <u>[[Convert_to_TS1 | Convert_to_st1Convert to TS1 Utility]]</u> can be used to convert a number of hydrologic model outputs to the .ts1 format. However, the format is relatively simple variant of a .csv file. It contains more information on the size and number of time-series and this makes it much faster to read into a TUFLOW model, particularly if there are a large number of input time-series. It could be readily scripted using a variety of tools such as Excel, Python or Matlab.
 
=File Format=
Line 1 !comment line<br>
Line 10 ⟶ 11:
Each data line is of the following format:<br>
Time (in minutes). n time-series x data
 
An example is below, it contains three time-series, with a maximum of 10 output times. The last time-seriesonly contains five data points, all start at the first timestep, although this is not necessary.<br>
===Character Restrictions===
 
The TS1 file has the following character restrictions:
 
<ul>
<li> Total line length cannot exceed 100,000 characters
<li> Boundary names cannot exceed 100 characters
<li> Boundary names are comma delimited. Spaces, dashes, underscores (and most characters) are allowed
<li> Boundary names should not contain commas e.g. putting a name inside quotes won’t stop any commas inside the quotes from being treated as a delimiter
<li> Quotation marks are not stripped from boundary names
<li> Tab characters are stripped from anywhere in the boundary name e.g. <tt>“example\tinflow”</tt> would become <tt>“exampleinflow”</tt>
</ul>
 
===Example===
 
An example is below, it contains three time-series, with a maximum of 10 output times. The last time-seriesonlyseries only contains five data points, all start at the first timestep, although this is not necessary.<br>
'''Note: The time in the 1st column should be in minutes'''. Please check the _bc_tables_check.csv files to ensure that the file has been read in correctly.<br>
In the example above the data has been written with a fixed column width for readability, however, this is not necessary in the .ts1 file.<br>