Differences

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

--- tseries:doc [2014-01-15 13:06:23]
juergens
+++ 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 </a>
-  * **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 ~/.tseries/tseries.conf
-====Preferences====
-  * **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
-=====BOTTOM TOOLBAR=====
-The Bottom Toolbar is dynamically connected to the sidebar. The Toolbar is altered when the
-sidebar VIEW is changed.
-  * **enable/disable observation** Showing observations (if available) //ALL VIEWS//
-  * **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//
-  * **Show Position(DIANA)** shows a big red cross in the //Diana// Map over the current position  //DATABASE AND STATION VIEW//
-  * **Connect** Connect to //Diana// //ALL VIEWS//
-  * **New directory** Add a new directory for locally stored positions //DATABASE AND FIMEX VIEW//
-  * **Cache query** Send a query to the database to cache in the dataset (enabled if the request is too slow) //DATABASE VIEW//
-  * **Record** record positions while clicking at the diana Map //FIELDS VIEW//
-=====DATAVIEWS=====
-The Sidebar contains the data control interface. There are three different VIEWS to access data **stations** , **database** and **Fields**.
-At the top of the statusbar the user can choose the datainput by the
-  * Diagramtype (Meteogram/Marinogram etc)
-  * The Model (ECMWF, Arome etc)
-  * The runtime of the model
-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
-available, the time slider maybe drawn to a negative value.
-The label under the time sliders displays information on the closest observation site, above
-the sliders is information (coordinates) on the current position.
-====Stations====
-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.
-==== Database ====
-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, you 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,times and coordinate borders are selected from the database.
-When the database connection fails, the database-tab is disabled.
-=== Cache ===
-The database interpolates data on demand, for this, the server
-has to read all the fields necessary to generate your diagram. If this
-is to slow (default > 1.5s) the cache button becomes active. By pushing
-the cache button, a request is send to the server to take all needed fields
-into memory - 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 coordinated)
-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.
-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.
-====Fimex====
-Since version 6.0 Tseries is able to interpolate data from fields, 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, the fields are read from disk and disk and uncompressed.
-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 "Delete " .
-  *  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  ~/.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.
-=== 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 little red button at the bottom.
-When the "Recording Mode" is active //Tseries// is not reading any data. In this case the focus aims  creating new
-positions.
-== Workflow to create new positions in Tseries ==
-  * Connect //Tseries// with //Diana//
-  * Select "Recording Mode"
-  * 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.