--- layout: docs title: Observed Time History Data permalink: /docs/observeddata/ published: true --- Observed Time History Data, is data measured in time. On import of observed time history data, ResInsight translates the data to make it similar to summary data. Observed time history data can be plotted along with summary data in **Summary Plots**. ## Import Observed Time History Data Importing observed time history data to ResInsight may be performed in two different ways: - By selecting the main menu item **File -> Import -> Import Observed Time History Data** - By using the context command **Import Observed Time History Data** on the **Observed Time History Data** item in the **Plot Main Window Project Tree** The following file types are supported: - RSM observed time history data file (_\*.rsm_) - Column based (Comma Separated Values, CSV) time history data file (_\*.csv/\*.txt_) The imported ![]({{ site.baseurl }}/images/Default.png) Observed Time History Data files will be added to ![]({{ site.baseurl }}/images/Folder.png)**Observed Time History Data**. See [Import Observed Time History Data]({{site.baseurl}}/docs/importobstimehistdata) for details. Which summaries that has been detected in a Observed Time History Data file can be read in an Observed Time History Data's **Property Editor**. In the image below, time and year info has been found together with the summary "WBP9L" for the well "OP-1". ![]({{ site.baseurl }}/images/observedDataProperty.png) ## File Formats ### Import CSV/txt Observed Time History Data CSV/txt files are generic ascii files which may have slightly different formatting. When importing these types of files the user is presented a dialog, where the user may tell ResInsight how to import the selected file(s). If more than one file is selected, the dialog appears once for each file. #### CSV/txt Import Options Dialog ![]({{ site.baseurl }}/images/ImportObservedTimeHistoryDataDialog.png) Dialog fields description: - **Cell Separator** -- Select the correct cell separator character. ResInsight will try to set the correct value as default. - **Decimal Separator** -- Select the correct decimal separator. ResInsight will try to set the correct value as default. - **Selected Time Column** -- Select the column that contains the time/date information. The first column is default. - **Use Custom Date Time Format** -- Check this box if the Date Format and/or Time Format in the file do not match any of the most common formats. - **Custom Date Time Format** -- Enter date time format to match the time information in the file. This field is visible only when the above check box checked. A tooltip will tell the user how to enter the correct information. - **Date Format** -- Select the date format matching the date information in the file. - **Time Format** -- Select the time format matching the time information in the file. If the file contains dates only, this field is ignored by ResInsight. - **Preview** -- Preview the first 30 lines of the file contents. The view will reflect the currently selected Cell Separator and the selected time column is marked in yellow. ### Import RSM observed time history data To import RSM files, the only action needed from the user is to select one or more RSM files. When the import is finished, one tree node for each file will appear under the **Observed Time History Data** node in the project tree. RSM files can be either *Column based* or *Keyword based*. #### Column Based File Format If a column based file is presented, ResInsight first tries to identify if its header has fixed width or not. Further, the header is interpreted by looking for specific lines. The first line must have one or more vector mnemonics. The initial letter(s) in a mnemonic specify which summary data type the column represents. For instance, *FVPT* and *FWPT* are of type *Field*, as they both have an initial *F*. *WWCTH* and *WGORH* are well data types. See *Vector naming convention* in **Eclipse: File Formats Reference Manual** for a full overview of supported mnemonics. The next lines can define units, well/group names, region names, LGR names and block numbers and the local cell number. They do not have to appear in any particular order. Scale factors can also be included, but will be ignored by ResInsight. All lines starting with _*--*_ will also be ignored. ##### Column Based with Fixed Header Width When interpreting column based files with fixed header width, ResInsight looks for left aligned column entries. These type of files are interpreted as we naturally read them. More than one table can be present in each file. ``` 1 ------------------------------------------------------------------------- SUMMARY ------------------------------------------------------------------------- DATE FGIRH FVPT FWPT FOPT FLPT SM3/DAY RM3 SM3 SM3 SM3 *10**3 *10**3 *10**3 *10**3 ------------------------------------------------------------------------- 6-NOV-1997 0 0 0 0 0 7-NOV-1997 0 5.749954 0.004548 4.379801 4.384350 8-NOV-1997 0 13.76883 0.010841 10.48852 10.49936 9-NOV-1997 0 19.38692 0.015243 14.76847 14.78372 10-NOV-1997 0 24.07161 0.018914 18.33751 18.35642 11-NOV-1997 0 28.79427 0.022613 21.93558 21.95819 ``` ##### Column Based with Random Header Width Column Based with Random Header Width will try to be parsed in the same way as fixed width, but it might fail in situations like the one below. We can see that SM3/SM3 *probably* belongs to WGORH, but it is parsed to WWCTH, as it is the second entry on that line. ``` TIME WWCTH WGORH DAYS SM3/SM3 A-5HP A-5HP 1 0.000 0.000 2 0.000 0.000 3 0.000 0.000 ``` #### Keyword Based File Format If the non-comment line includes the word "VECTOR", the file is interpreted as a keyword based file. In keyword based files, the content of the one-column tables is described in each header. Tables should be associated with a table containing time stamps. In the example below, *S-1AH-GOR* is associated with *YEARX*, since their origin is equal. ResInsight always interpret *ORIGIN* as well name, and look for a table with the line "VECTOR YEARX" to associate with it. ``` ---------------------------------------------- -- GOR data ---------------------------------------------- VECTOR S-122AH-GOR UNITS SM3/SM3 ORIGIN GORS-122AH 330.6601 257.7500 335.9894 301.4388 260.4193 306.0298 280.2883 VECTOR YEARX ORIGIN GORS-112AH UNITS YEAR 1999.7902 1999.8446 1999.9285 2000.0391 2000.0800 2000.0862 2000.1285 ---comment ---------------------------------------------- -- GOR data ---------------------------------------------- VECTOR S-211H-GOR UNITS SM3/SM3 ORIGIN GORS-211H 293.8103 293.1634 304.0000 334.5932 306.4610 293.7571 VECTOR YEARX ORIGIN GORS-22H UNITS YEAR 1999.8255 2000.1274 2000.2075 2000.2367 2000.4033 2000.4966 ``` Please seek "User data file formats" in **Eclipse: File Formats Reference Manual** for details. ## Viewing Observed Time History Data ![]({{ site.baseurl }}/images/observedDataCurveCreator.png) To plot Observed Time History Data, choose **New Summary Plot** in the context menu of **Summary Plots**, in **Plot Object Project Tree**. Observed time history data will appear in **Sources** together with summary cases. How to use the Plot Editor is covered in [Summary Plot Editor]({{site.baseurl}}/docs/summaryploteditor). Observed time history data points are plotted without lines by default.