Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
tseries:doc [2014-01-15 12:13:08] juergens |
tseries:doc [2022-05-31 09:29:32] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | |||
+ | |||
====== T-series Manual ====== | ====== T-series Manual ====== | ||
| | ||
=====MENUBAR===== | =====MENUBAR===== | ||
- | ====File==== | + | ====The File Menu==== |
- | * **Print:** Print the current diagram to a printer or postscript-file | + | ^ Title ^ Description ^ |
- | | + | | **Print** |
- | | + | | **Save Image** |
- | | + | | **Change Filter** |
- | | + | | **Change Observation Filter** |
- | | + | | **Change |
- | | + | | **Change Observation start time** |
+ | | **Quit** | ||
- | ====Preferences==== | + | ==== The Preferences |
- | * **Reset Preferences** reset the original preferences (including window size/ | + | |
- | * **Save Preferences** save the current preferences to the conf-file. | + | |
- | * **Save at exit** Saves the current preferences automatically at exit. | + | |
- | * **Show positions (DIANA)** Show the position names in //Diana// when //Tseries// is connected to //Diana// | + | |
- | * **Show active position** Show the name of the current position in //Diana// | + | |
- | * **Show icons (DIANA)** Show icons for all positions in the //Diana// map | + | |
- | * **Show Timemark** Show a grey line marking now | + | |
- | * **Show Gridlines** Switch the Grid in the diagram on and off | + | |
- | * **Lat/Lon in decimal** represent latitude and longitude as float instead of Degrees and Minutes | + | |
- | * **Lock hours to model** Change length of the diagram when changing the model | + | |
- | * **Font** Change the GUI font | + | |
- | * **Language** Change language for the GUI | + | |
- | + | ||
- | ====Help==== | + | |
- | * **Manual** shows this page | + | |
+ | ^ Title ^ Description ^ | ||
+ | | **Reset Preferences** | Reset the original preferences (including window size/ | ||
+ | | **Save Preferences** | Save the current preferences to the conf-file.| | ||
+ | | **Save at exit** | Saves the current preferences automatically at exit.| | ||
+ | | **Show positions (DIANA)** | Show the position names in //Diana// when //Tseries// is connected to //Diana//.| | ||
+ | | **Show active position** | Show the name of the current position in //Diana// | | ||
+ | | **Show icons (DIANA)** | Show icons for all positions in the //Diana// map.| | ||
+ | | **Show Timemark** | Show a grey line marking now.| | ||
+ | | **Show Gridlines** | Switch the Grid in the diagram on and off.| | ||
+ | | **Lat/Lon in decimal** | Represent latitude and longitude as float instead of Degrees and Minutes.| | ||
+ | | **Lock hours to model** | Change length of the diagram when changing the model.| | ||
+ | | **Font** | Change the GUI font.| | ||
+ | | **Language** | Change language for the GUI.| | ||
+ | |||
+ | |||
+ | |||
+ | ====The Help Menu==== | ||
+ | ^ Title ^ Description ^ | ||
+ | | **Manual** | Opens a Web browser with this page. | | ||
+ | | **News** | ||
+ | | **About** | ||
=====BOTTOM TOOLBAR===== | =====BOTTOM TOOLBAR===== | ||
The Bottom Toolbar is dynamically connected to the sidebar. The Toolbar is altered when the | The Bottom Toolbar is dynamically connected to the sidebar. The Toolbar is altered when the | ||
sidebar VIEW is changed. | sidebar VIEW is changed. | ||
- | + | ^ Icon ^ Title ^ Description | |
- | | + | |{{: |
- | | + | | {{: |
- | | + | |{{: |
- | | + | |{{: |
- | | + | |{{: |
- | | + | | {{: |
- | | + | | {{: |
=====DATAVIEWS===== | =====DATAVIEWS===== | ||
- | The Sidebar contains the data control interface. There are three different VIEWS to | + | The Sidebar contains the data control interface. There are three different VIEWS to access data **STATION VIEW** , **DATABASE VIEW** and **FIELD VIEW**. |
- | access data **stations**, **database** and **Fields. | + | At the top of the Statusbar |
- | At the top of the statusbar | + | |
* Diagramtype (Meteogram/ | * Diagramtype (Meteogram/ | ||
* The Model (ECMWF, Arome etc) | * The Model (ECMWF, Arome etc) | ||
- | * The runtime of the model | + | * The runtime of the model or the filename if a runtime is missing |
- | The timeframe of the diagram can be selected by the start, and hours sliders at | + | The timeframe of the diagram can be selected by the "start", and "hours" |
- | the bottom. The 0 hour refers to the runtime | + | the bottom. The 0 hour refers to the first time of the model. In case there are observations |
- | available, the time slider | + | available, the " |
- | The label under the time sliders displays information on the closest observation site, above | + | The label under the time sliders displays information on the closest observation site (name, height and distance to the |
- | the sliders is information (coordinates) on the current position. | + | current position), above the sliders is information (coordinates) on the current position. |
- | ====Stations==== | + | ====STATION VIEW==== |
In this view, //Tseries// shows preprocessed point data from hdf or ASCII files. | In this view, //Tseries// shows preprocessed point data from hdf or ASCII files. | ||
- | The Station lists are extracted from the current datafile and static | + | The Station lists are extracted from the current datafile and cannot be changed |
+ | {{: | ||
- | ==== Database - Tseries 5.0 and higher | + | ==== DATABASE VIEW ==== |
- | Tseries is able to connect to a WDB database | + | Since Version 5.0, Tseries is able to connect to a //WDB// database |
The Database-Tab title is similar to the database-server which is used in the connection. | The Database-Tab title is similar to the database-server which is used in the connection. | ||
- | The user interface is coordinate based, | + | The user interface is coordinate based, |
by the lat/lon sliders, write them directly into the Lat/Lon text-fields | by the lat/lon sliders, write them directly into the Lat/Lon text-fields | ||
or click into any given place in the diana map to get the diagram for | or click into any given place in the diana map to get the diagram for | ||
Line 77: | Line 85: | ||
All the modelnames, | All the modelnames, | ||
When the database connection fails, the database-tab is disabled. | When the database connection fails, the database-tab is disabled. | ||
+ | |||
+ | {{: | ||
=== Cache === | === Cache === | ||
- | The database interpolates data on demand, | + | The database interpolates data on demand, |
- | has to read all the fields necessary to generate | + | has to read all the fields necessary to generate |
- | is to slow (default > 1.5s) the cache button becomes active. By pushing | + | If the selection process becomes too slow (default > 1.5s) the cache button |
- | the cache button, a request is send to the server to take all needed fields | + | becomes active. By pushing the cache button, a request is send to the server |
- | into memory | + | to read all needed fields into memory. This will speeding up the interpolation. |
- | is running in background and takes up to one minute. It is finished when the | + | The caching process is running in background and takes up to one minute. It is |
- | red blinking icon vanishes. | + | finished when the red blinking icon vanishes. |
===Bookmarks=== | ===Bookmarks=== | ||
- | In the Database View, stations are represented as Bookmarks (name and coordinated) | + | In the Database View, stations are represented as Bookmarks (name and coordinates) |
Additionally to common bookmarks, the user can define a set of local bookmarks and group them | Additionally to common bookmarks, the user can define a set of local bookmarks and group them | ||
- | into directories. | + | into directories. |
- | Now drag positions from the other folders | + | * Create |
- | Rename the bookmarks appropriately. There are some distributed folders with given positions. | + | * Rename |
- | These can be edited, but will be restored after restart. | + | * Drag positions from the other folders |
- | will be stored locally | + | |
- | All positions can be dragged into trash for removal. Empty private | + | There are some distributed folders with preset bookmarks. These can be edited, but will be restored after restart. |
+ | will be kept and saved at exit | ||
+ | All positions can be dragged into trash for removal. Empty local folders are | ||
automatically removed after restart. | automatically removed after restart. | ||
- | ====Fimex Tseries | + | ====FIELDS VIEW==== |
+ | |||
+ | Since version | ||
+ | using the //Fimex// library. | ||
+ | |||
+ | |||
+ | |||
+ | {{: | ||
+ | === Interpolation === | ||
+ | |||
+ | To create a simple Meteogram, //Tseries// usually needs nine parameters ( U, V, T , CH , CL , etc.). | ||
+ | Assuming 66 times in a timeseries, //Tseries// has to interpolate in 594 FIELDS to read a single Meteogram. . | ||
+ | Prior to interpolation, | ||
+ | It may take 40 seconds to retrieve the data required to generate a single Diagram. The interpolation itself is very fast, | ||
+ | most of the time is spent on retrieving data. Therefore it does not make any difference whether //Tseries// interpolates one | ||
+ | chart or thousands. To take advantage of this, //Tseries// interpolates all known Bookmarks immediately when data are requested. | ||
+ | The user has to wait the first time data for a certain set are requested, after that //Tseries// takes the | ||
+ | interpolated data from the internal cache. //Tseries// reduces the data retrieval to the data needed to | ||
+ | show the requested diagram. If the user chooses a different style, with additional parameters, only the | ||
+ | missing parameters are added to the cache. Interpolation happens in a specific thread. The user can watch | ||
+ | other diagrams while //Tseries// is building the cache for a stream. //Tseries// does not allow several dataread threads. | ||
+ | When a new position is requested, //Tseries// will interpolate the entire list again ( 40s latency ). | ||
+ | |||
+ | |||
+ | |||
+ | === Connection to Diana === | ||
+ | * When //Tseries// is connected to //Diana// in the //Fimex// view, only the positions that are visible in //Tseries// will be shown in //Diana// as well. | ||
+ | * In the map, a green ring around the current position is displayed. | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===Bookmarks=== | ||
+ | In the Fields View, stations are represented as Bookmarks (name and coordinates) | ||
+ | Additionally to common bookmarks, the user can define a set of local bookmarks and group them | ||
+ | into directories. | ||
+ | * Create a new folder with the "New Directory" | ||
+ | * Rename the folder. | ||
+ | * Drag positions from the other folders into the new folder, positions in the record folder can be dragged in as well. | ||
+ | * Rename the bookmarks appropriately. | ||
+ | There are some distributed folders with preset bookmarks. These can be edited, but will be restored after restart. Locally created folders | ||
+ | will be kept and saved at exit | ||
+ | All positions can be dragged into trash for removal. Empty local folders are | ||
+ | automatically removed after restart. | ||
+ | The local bookmarks are stored in a file ~/ | ||
+ | The file can be changed by the user to import bigger position lists \\ | ||
+ | **NB:** all //Tseries// instances are sharing the same file. I.e. if several //Tseries// are running simultanously, | ||
+ | |||
+ | |||
+ | === Creating new bookmarks === | ||
+ | A single interpolation is expensive, the option to click freely on the //Diana// map would cost 40s each time. | ||
+ | Because of this, there is a " Recording Mode ". | ||
+ | When the " | ||
+ | bookmarks. | ||
+ | |||
+ | == Workflow to create new fields-bookmarks in Tseries == | ||
+ | |||
+ | * Connect //Tseries// to // | ||
+ | * Select " | ||
+ | * Click on the //Diana// map to select new positions. | ||
+ | * The new positions appear in the RECORDS folder. | ||
+ | * Move positions, rename them, etc. If necessary delete them again. | ||
+ | * Turn off the " | ||
+ | The RECORD folder is limited to 20 positions. When leaving the recording mode, the RECORD folder | ||
+ | is automatically closed. Positions can be used directly in the RECORD folder, but the folder | ||
+ | keeps data only temporary and is emptied on exit. No data will be interpolated for the new positions | ||
+ | until //Tseries// is missing data to create a diagram ( like if the user chooses one of the new bookmarks to get a diagram). | ||
+ | === Filtering bookmarks === | ||
+ | By searching in the filter-field, | ||
+ | tseries picks automatically the first valid place from the filter to display the connected diagram. | ||
+ | One can open or close all folders by the " | ||
+ | if the place cannot be found, the user can search on the halo website by pushing the search button inside the | ||
+ | search field. This will fetch places into the SEARCH folder. Places in the SEARCH folder are treated as RECORDs. | ||
Line 112: | Line 197: | ||
The connection is controlled by an external application (coserver) which is socket based. | The connection is controlled by an external application (coserver) which is socket based. | ||
Coserver starts automatically when requested. The user can connect T-series and DIANA by | Coserver starts automatically when requested. The user can connect T-series and DIANA by | ||
- | activate | + | activating |
//Diana// and will be displayed in the map. when a position is choosen in //Diana//, //Tseries// will display | //Diana// and will be displayed in the map. when a position is choosen in //Diana//, //Tseries// will display | ||
the requested Diagram for that position. | the requested Diagram for that position. | ||
| | ||