ioannis@56: Products ioannis@56: ======== ioannis@37: ulalume3@58: There are two ways that a product can be related to a system: *directly* or *indirectly*. ulalume3@58: ulalume3@58: A **directly** connected product (or **primary** product) is linked to a ulalume3@58: system. When a measurement is processed, a file will be created containing the ulalume3@58: retrieved quantities of this product. ulalume3@58: ulalume3@58: A **indirectly** connected product (or **secondary** product) is used in the ulalume3@58: definition of a composite, more complex, product. For example, an "extinction" product ulalume3@58: can be used to define a "lidar ratio and extinction" product. In this case the ulalume3@58: "lidar ratio and extinction" product is the *primary* product (directly linked ulalume3@58: to a system), and the "extinction" product is the *secondary* product (only liked to ulalume3@58: the "lidar ratio and extinction" product). The output of a secondary product is not stored in a ulalume3@58: file. ulalume3@58: ulalume3@58: .. warning:: ulalume3@58: You should avoid linking a product both *directly* and *indirectly* to the ulalume3@58: same system. If you link a *secondary* product directly to a system, ulalume3@58: the output of the SCC could be wrong, as two products could attempt to write ulalume3@58: their output on the same file. ulalume3@58: ulalume3@58: In the product list view, these information are summarized in two columns, labeled ulalume3@58: "Directly connected" and "Parent products". ulalume3@58: ulalume3@58: Directly connected ulalume3@58: Will be green for **primary** products, i.e. if the product is directly ulalume3@58: linked to a system. ulalume3@58: ulalume3@58: Parent products ulalume3@58: If the product is a **secondary** product (i.e. it is part of a composite product) ulalume3@58: this column will have a links to the related *primary* products. ulalume3@58: ulalume3@58: .. note:: ulalume3@58: **For administrators**: These two columns can be used to quickly spot "orphan" ulalume3@58: products, i.e. products that are neither linked to a system nor to a composite ulalume3@58: product. These products will not be available to any user to use, and should ulalume3@58: be either connected to a system, or deleted. Orphan products will have *red* ulalume3@58: in the *Directly connected* column and "-" in the *Parent products* column. ulalume3@58: ulalume3@58: Adding a product ulalume3@58: ---------------- ulalume3@58: ioannis@56: Depending on the product you need to produce, some of the following tables need to be filled. ioannis@56: ioannis@37: ioannis@37: .. note:: ioannis@37: ioannis@56: This section is not up-to-date to the latest interface version. ioannis@37: ioannis@56: .. note:: ioannis@56: ulalume3@58: Each product should be connected to a system, either directly or indirectly, ulalume3@58: before being saved. ioannis@56: ioannis@37: ioannis@37: Backscatter products ulalume3@58: ~~~~~~~~~~~~~~~~~~~~ ioannis@37: The following tables need to be filed for the various backscatter products. ioannis@37: ioannis@37: Backscatter calibrations ulalume3@58: ~~~~~~~~~~~~~~~~~~~~~~~~ ioannis@37: For backscatter (product types: Raman backscatter, Combined Raman backscatter and extinction, Elastic backscatter retrieval ioannis@37: ioannis@37: LowestHeight ioannis@37: in meters, lowest height for reference height search ioannis@37: ioannis@37: TopHeight ioannis@37: in meters, maximum height for reference height search ioannis@37: ioannis@37: WindowWidth ioannis@37: in meters, width of the reference height interval ioannis@37: ioannis@37: calValue ioannis@37: backscatter ratio, e.g. 1 or 1.01 ioannis@37: ioannis@37: calRangeSearchMethod ID: ioannis@37: always 0 ioannis@37: ioannis@37: ioannis@37: If done, you have to remember the ID for your backscatter calibration options an go the the specific tables below, ioannis@37: ioannis@37: for product type 0 and 2: Raman_backscatter_options ulalume3@58: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ioannis@37: ioannis@37: Raman calculation method ioannis@37: at the moment, only 1 ioannis@37: ioannis@37: bsc cal options ioannis@37: insert ID from previous step ioannis@37: ioannis@37: error method ID: ioannis@37: at the moment, only 1 ioannis@37: ioannis@37: for product type 3: elast_backscatter_options ulalume3@58: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ioannis@37: ioannis@37: elast bsc method ID ioannis@37: at the moment, only 1 (iterative approach) ioannis@37: ioannis@37: bsc cal options ioannis@37: insert ID from previous step ioannis@37: ioannis@37: error method ID: ioannis@37: at the moment, only 1 ioannis@37: ioannis@37: lr input id: ioannis@37: at the moment, only 1 (fixed LR) ioannis@37: ioannis@37: fixed_lr ioannis@37: ... in sr, value of the used lidar ratio ioannis@37: ioannis@37: iter_bsc_options ioannis@37: if, iterative approach is used, go to table iter_bsc_options and remember ID and insert here ioannis@37: ioannis@37: iter_bsc_options ulalume3@58: ~~~~~~~~~~~~~~~~ ioannis@37: ioannis@37: iter conv crit ioannis@37: ...e.g. 0.1 (=10%) The iteration is stopped when the RELATIVE difference between the actual and the previous column integrated backscatter coefficients is below this value ioannis@37: ioannis@37: ram bsc method id ioannis@37: at the moment, only 1 ioannis@37: ioannis@37: max iteration count: ioannis@37: maximum number of iteration steps ioannis@37: ioannis@37: for product type 1: Extinction options ulalume3@58: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ioannis@37: ioannis@37: Extinction method: ioannis@37: Standard: 1, (0 weighted linear fit, 1 non-weighted linear fit, 2 difference quotient, 3 polynomial sec order fit, 4 quadratic function, 5 Savitzky-Golay filter, 6 Russo) ioannis@37: ioannis@37: error method ID: ioannis@37: at the moment, only 1 ioannis@37: ioannis@37: overlap file ID: ioannis@37: if overlap file is available, enter ID here ioannis@37: ioannis@37: angstroem: ioannis@37: used angström value for the extinction calculation, e.g. 0,1, or 1.5 ioannis@37: ioannis@37: for product type 2: Ext bsc options ulalume3@58: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ioannis@37: ioannis@37: product ID ioannis@37: ID of product type 2 ioannis@37: ioannis@37: extinction option product ID ioannis@37: ID of the extinction product (see table products) ioannis@37: ioannis@37: raman backscatter options product ID ioannis@37: ID of the Raman backscatter product (see table products) ioannis@37: ioannis@37: error method ID: ioannis@37: at the moment, only 1 ioannis@37: