Differences
This shows you the differences between two versions of the page.
tseries:doc [2014-01-16 10:18:27] juergens [DATAVIEWS] |
tseries:doc [2022-05-31 09:29:32] |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | |||
- | |||
- | ====== T-series Manual ====== | ||
- | | ||
- | =====MENUBAR===== | ||
- | |||
- | ====File==== | ||
- | |||
- | * **Print:** Print the current diagram to a printer or postscript-file. | ||
- | * **Save Image:** Save the current diagram as an png-image. | ||
- | * **Change Filter:** Create a local filter for positions. | ||
- | * **Change Observation Filter:** Create a filter for observations parameters. Marked parameters will not be requested and are excluded from the view. | ||
- | * **Change //Fimex// Filter:** Create a filter for //FIMEX// parameters. Marked parameters will not be interpolated and are excluded from the view. | ||
- | * **Change Observation start time:** The observation view reads the last 300 hours of observations by default. Here one can choose a fixed start date for the observations. The start date will not be logged. At restart - the default applies. | ||
- | * **Quit:** Quits the program and writes configuration information to ~/ | ||
- | |||
- | ====Preferences==== | ||
- | * **Reset Preferences: | ||
- | * **Save Preferences: | ||
- | * **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 // | ||
- | * **Show icons (DIANA):** Show icons for all positions in the //Diana// map. | ||
- | * **Show Timemark:** Show a grey line marking now. | ||
- | * **Show Gridlines: | ||
- | * **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: | ||
- | | ||
- | ====Help==== | ||
- | * **Manual:** Shows this page | ||
- | |||
- | |||
- | =====BOTTOM TOOLBAR===== | ||
- | The Bottom Toolbar is dynamically connected to the sidebar. The Toolbar is altered when the | ||
- | sidebar VIEW is changed. | ||
- | ^ Icon ^ Title ^ Description | ||
- | |{{: | ||
- | | {{: | ||
- | |{{: | ||
- | |{{: | ||
- | |{{: | ||
- | | {{: | ||
- | | {{: | ||
- | |||
- | |||
- | =====DATAVIEWS===== | ||
- | |||
- | The Sidebar contains the data control interface. There are three different VIEWS to access data **STATION VIEW** , **DATABASE VIEW** and **FIELD VIEW**. | ||
- | At the top of the Statusbar the user can choose the datainput by the | ||
- | * Diagramtype (Meteogram/ | ||
- | * The Model (ECMWF, Arome etc) | ||
- | * The runtime of the model or the filename if a runtime is missing | ||
- | |||
- | The timeframe of the diagram can be selected by the " | ||
- | the bottom. The 0 hour refers to the first time of the model. In case there are observations | ||
- | available, the " | ||
- | The label under the time sliders displays information on the closest observation site (name, height and distance to the | ||
- | current position), above the sliders is information (coordinates) on the current position. | ||
- | |||
- | |||
- | ====STATION VIEW==== | ||
- | In this view, //Tseries// shows preprocessed point data from hdf or ASCII files. | ||
- | The Station lists are extracted from the current datafile and cannot be changed for that specific stream. | ||
- | {{: | ||
- | |||
- | ==== DATABASE VIEW ==== | ||
- | |||
- | Since Version 5.0, Tseries is able to connect to a //WDB// database to retrieve data, interpolated on demand. | ||
- | The Database-Tab title is similar to the database-server which is used in the connection. | ||
- | |||
- | The user interface is coordinate based, the user can choose coordinates | ||
- | 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 | ||
- | the specific coordinates. | ||
- | All the modelnames, | ||
- | When the database connection fails, the database-tab is disabled. | ||
- | |||
- | {{: | ||
- | |||
- | === Cache === | ||
- | The database interpolates data on demand, to achieve this, the server | ||
- | has to read all the fields necessary to generate the requested diagram. | ||
- | If the selection process becomes too slow (default > 1.5s) the cache button | ||
- | becomes active. By pushing the cache button, a request is send to the server | ||
- | to read all needed fields into memory. This will speeding up the interpolation. | ||
- | The caching process is running in background and takes up to one minute. It is | ||
- | finished when the red blinking icon vanishes. | ||
- | |||
- | ===Bookmarks=== | ||
- | 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 | ||
- | into directories. First, create a new folder by the " | ||
- | Now drag positions from the other folders there, positions in the record folder can be dragged in as well. | ||
- | Rename the bookmarks appropriately. There are some distributed folders with given positions. | ||
- | These can be edited, but will be restored after restart. Private created folders | ||
- | will be stored locally and saved at exit | ||
- | All positions can be dragged into trash for removal. Empty private folders are | ||
- | automatically removed after restart. | ||
- | |||
- | |||
- | ====FIELDS VIEW==== | ||
- | |||
- | Since version 6.0 Tseries is able to interpolate data from fields (netCDF, | ||
- | using the //Fimex// library. | ||
- | |||
- | {{: | ||
- | |||
- | === Interpolation === | ||
- | |||
- | To create a simple Meteogram, //Tseries// usually needs nine parameters ( U, V, HH , 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 interpolate a single chart. The interpolation 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. Because of this, //Tseries// interpolates all known Bookmarks immediately when data are requested, | ||
- | ie the user has to wait up 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, that needs additional parameters, only the | ||
- | missing parameters are added to the cache. Interpolation happens in a specific thread. The user can watch | ||
- | other diagrams meanwhile. //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. | ||
- | * The map shows a green ring around current position. | ||
- | |||
- | |||
- | ===Editing Positions=== | ||
- | The system contains directories and sites, just like in //WDB// tab . | ||
- | The sites can be freely edited by the user : | ||
- | |||
- | * Create new directories by pressing the plus. | ||
- | * Move positions around the directories and rename them . | ||
- | * Right click to get a ' Copy , Paste , Cut, Delete " popup-menu . | ||
- | * Use standard editing keys" Ctrl - C ", " CTRL -X ", " CTRL - V" and " | ||
- | * Mark positions with the mouse or arrow keys + SHIFT or CTRL. | ||
- | |||
- | |||
- | |||
- | ===Local positions === | ||
- | Local directories are saved on exit. Common directories can be altered, but | ||
- | they are not saved , they are reset on restart. Empty directories that are deleted automatically on exit. | ||
- | The local positions 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 positions === | ||
- | 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 ", the red button at the bottom. | ||
- | When the " | ||
- | positions. | ||
- | |||
- | == Workflow to create new positions in Tseries == | ||
- | |||
- | * Connect //Tseries// with //Diana// | ||
- | * 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 Recording Mode | ||
- | |||
- | |||
- | 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. | ||
- | |||
- | |||
- | |||
- | =====DIANA CONNECTION===== | ||
- | |||
- | T-series can be connected to the //Diana// meteorological workstation. | ||
- | 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 | ||
- | activate the //connect// button in both applications. All positions from //Tseries// are send to | ||
- | //Diana// and will be displayed in the map. when a position is choosen in //Diana//, //Tseries// will display | ||
- | the requested Diagram for that position. | ||
- | | ||