tseries:doc

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
tseries:doc [2014-01-15 13:06:23]
juergens 		tseries:doc [2022-05-31 09:29:32] (current)
Line 5: Line 5:
 =====MENUBAR===== =====MENUBAR=====
  
-====File====+====The File Menu====
  
-  * **Print:** Print the current diagram to a printer or postscript-file  +^ Title ^ Description ^ 
-  * **Save Image:** Save the current diagram as an png-image. +| **Print** | Print the current diagram to a printer or postscript-file. | 
-  * **Change Filter** Create a local filter for positions </a> +| **Save Image** | Save the current diagram as an png-image.      | 
-  * **Change Observation Filter** Create a filter for observations parameters. Marked parameters will not be requested and are excluded from the view +| **Change Filter** | Create a local filter for positions. | 
-  * **Change //Fimex// Filter** Create a filter for //FIMEX// parameters. Marked parameters will not be interpolated and are excluded from the view +| **Change Observation Filter** | Create a filter for observations parameters. \\ Marked parameters will not be requested 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. +| **Change //Fimex// Filter** | Create a filter for //FIMEX// parameters. \\ Marked parameters will not be interpolated and are excluded from the view. | 
-  * **Quit** quits the program and writes configuration information to ~/.tseries/tseries.conf+| **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 ~/.tseries/tseries.conf. |
  
-====Preferences==== +==== The Preferences Menu====
-  * **Reset Preferences** reset the original preferences (including window size/position) from the configuration +
-  * **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/position) from the configuration.|
 +| **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**   | Opens a web browser with the changelog on [[tseries:news|news]]| |
 +| **About**  | Displays the version number. |
  
 =====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                         ^ VIEW ^                
-  * **enable/disable observation** Showing observations (if available) //ALL VIEWS// +|{{:tseries:synop.png?20}} |**Enable/disable observation** | Showing observations (if available) | ALL  | 
-  * **Position filter** apply a filter on the position list, only the positions that exist in the datasource and in the filterlist will be shown. //STATION VIEW// +| {{:tseries:filter.png?20}}|**Position filter**            | Apply a filter on the position list, only the positions \\ that exist in the datasource and in the filterlist will be shown. | STATION | 
-  * **Show Position(DIANA)** shows a big red cross in the //Diana// Map over the current position  //DATABASE AND STATION VIEW// +|{{:tseries:ts_find.png?20}} | **Show Position(DIANA)**   | Shows a big red cross in the //Diana// \\ Map to highlight the current position | DATABASE AND STATION  | 
-  * **Connect** Connect to //Diana// //ALL VIEWS// +|{{:tseries:disconn.png?20}} | **Connect** | Connect to //Diana// | ALL | 
-  * **New directory** Add a new directory for locally stored positions //DATABASE AND FIMEX VIEW// +|{{:tseries:list-add.png?20}} | **New directory** | Add a new directory for locally stored positions | DATABASE AND FIELDS |  
-  * **Cache query** Send a query to the database to cache in the dataset (enabled if the request is too slow) //DATABASE VIEW// +| {{:tseries:view-refresh.png?20}}| **Cache query** | Send a query to the database to cache in the \\ dataset (enabled if the request is too slow) | DATABASE |  
-  * **Record** record positions while clicking at the diana Map //FIELDS VIEW// +| {{:tseries:media-record.png?20}}| **Record** | Record positions while clicking at the diana Map |FIELDS |
  
  
 =====DATAVIEWS===== =====DATAVIEWS=====
  
-The Sidebar contains the data control interface. There are three different VIEWS to access data **stations** , **database** and **Fields**. +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+At the top of the Statusbar the user can choose the datainput by the
   * Diagramtype (Meteogram/Marinogram etc)   * Diagramtype (Meteogram/Marinogram etc)
   * 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" sliders at 
-the bottom. The 0 hour refers to the runtime of the model. In case there are observations +the bottom. The 0 hour refers to the first time of the model. In case there are observations 
-available, the time slider maybe drawn to a negative value. +available, the "start" slider can be drawn to a negative value. 
-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 for that file.+The Station lists are extracted from the current datafile and cannot be changed for that specific stream.
  
 +{{:tseries:tseries-sidebar-station-view.png?200}}
  
-==== Database ====+==== DATABASE VIEW ====
  
-Since Version 5.0, Tseries is able to connect to a //WDB// database to retrieve data interpolated on demand.+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 Database-Tab title is similar to the database-server which is used in the connection.
  
-The user interface is coordinate based, you can choose coordinates+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 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 78: Line 85:
 All the modelnames,times and coordinate borders are selected from the database. All the modelnames,times and coordinate borders are selected from the database.
 When the database connection fails, the database-tab is disabled. When the database connection fails, the database-tab is disabled.
 +
 +{{:tseries:tseries-sidebar-db-view.png?200}}
  
 === Cache === === Cache ===
-The database interpolates data on demand, for this, the server +The database interpolates data on demand, to achieve this, the server 
-has to read all the fields necessary to generate your diagram. If this +has to read all the fields necessary to generate the requested diagram.  
-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 - speeding up the interpolation. The caching process +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. First, create a new folder by the "+" button and rename the folder. +into directories.  
-Now drag positions from the other folders there, positions in the record folder can be dragged in as well. +  * Create a new folder with the "New Directory" button  
-Rename the bookmarks appropriately. There are some distributed folders with given positions. +  * Rename the folder. 
-These can be edited, but will be restored after restart. Private created folders +  * Drag positions from the other folders into the new folder, positions in the record folder can be dragged in as well. 
-will be stored locally and saved at exit +  * Rename the bookmarks appropriately.  
-All positions can be dragged into trash for removal. Empty private folders are+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. automatically removed after restart.
  
  
-====Fimex==== +====FIELDS VIEW====
-Since version 6.0 Tseries is able to interpolate data from fields, using the //Fimex// library.+
  
 +Since version 6.0 Tseries is able to interpolate data from fields (netCDF,ncml etc), 
 +using the //Fimex// library.
  
  
 +
 +{{:tseries:fimex-tab-en.png?nolink&200}}
 === Interpolation === === Interpolation ===
  
-To create a simple Meteogram, //Tseries// usually needs nine parameters ( U, V, HH , CH , CL , etc.). +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. . Assuming 66 times in a timeseries, //Tseries// has to interpolate in  594 FIELDS to read a single Meteogram. .
-Prior to interpolation, the fields are read from disk and disk and uncompressed.  +Prior to interpolation, the fields are read from disk and uncompressed.  
-It may take 40 seconds to interpolate a single chart. The interpolation is very fast, most of the +It may take 40 seconds to retrieve the data required to generate a single Diagram. The interpolation itself is very fast,  
-time is spent on retrieving data. Therefore it does not make any difference whether //Tseries// interpolates one  +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,  +chart or thousands. To take advantage 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+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 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+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  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.+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 ). When a new position is requested, //Tseries// will interpolate the entire list again ( 40s latency ).
  
Line 124: Line 138:
 === Connection to Diana === === 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.   * 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.+  * In the map, a green ring around the current position is displayed.
  
  
-===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 "Delete " . 
-  *  Mark positions with the mouse or arrow keys + SHIFT or CTRL. 
  
  
- +===Bookmarks=== 
-===Local positions === +In the Fields View, stations are represented as Bookmarks (name and coordinates) 
-Local directories are saved on exit. Common directories can be altered, but +Additionally to common bookmarks, the user can define a set of local bookmarks and group them  
-they are not saved , they are reset on restart. Empty directories that are deleted automatically on exit. +into directories.  
-The local positions are stored in a file  ~/.tseries/bookmarks.fimex . +  * Create a new folder with the "New Directory" button  
-The file can be changed by the user to import bigger position lists+  * 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  ~/.tseries/bookmarks.fimex . 
 +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, the last one exiting will overwrite the lists from the others. **NB:** all //Tseries// instances are sharing the same file. I.e. if several //Tseries// are running simultanously, the last one exiting will overwrite the lists from the others.
  
  
-=== Creating new positions ===+=== Creating new bookmarks ===
 A single interpolation is expensive, the option to click freely on the //Diana// map would cost 40s each time. 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 little red button at the bottom. +Because of this, there is a " Recording Mode ". 
-When the "Recording Mode" is active //Tseries// is not reading any data. In this case the focus aims  creating new +When the "Recording Mode" is active //Tseries// is not reading any data. In this case the focus aims on creating new 
-positions.+bookmarks.
  
-== Workflow to create new positions in Tseries ==+== Workflow to create new fields-bookmarks in Tseries ==
  
-  * Connect //Tseries// with //Diana// +  * Connect //Tseries// to //Diana//. 
-  * Select "Recording Mode" +  * Select "Recording Mode" by choosing the "Record" button. 
-  * Click on the //Diana// map to select new positions +  * Click on the //Diana// map to select new positions. 
-  * The new positions appear in the RECORDS folder +  * The new positions appear in the RECORDS folder. 
-  * Move positions, rename them, etc. If necessary delete them again +  * Move positions, rename them, etc. If necessary delete them again. 
-  * Turn off the Recording Mode+  * Turn off the "Recording Mode".
  
  
Line 166: Line 180:
 is automatically closed. Positions can be used directly in the RECORD folder, but the 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 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.+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, the open bookmarks folders will be filtered by the given string. 
 +tseries picks automatically the first valid place from the filter to display the connected diagram. 
 +One can open or close all folders by the "open/close all buttons {{:tseries:open-close.png?nolink&100}}. 
 +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 176: 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 the //connect// button in both applications. All positions from //Tseries// are send to+activating 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 //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.
      
  
  • tseries/doc.1389791183.txt.gz
  • Last modified: 2022-05-31 09:23:29
  • (external edit)