Inputs | Outputs

Static Product Builder

The Static Product Builder provides an interface for creating, editing, displaying and exporting ODTK reports and graphs. A list of data products (reports and graphs) appears in the left pane of the Static Product Builder window. You can rename a product by clicking on the default or current name and typing in a new one. To launch the Static Product Builder select it from the View menu or click the button on the toolbar.

If you are using a product style (report or graph) created with a prior version of ODTK, it may need to be updated to the current version. Please refer to the Transition Matters section of the release notes for the current version.

You can also write scripts using the Static Product Builder. See the attached PDF file for a brief guide to attributes used in scripting with the Static Product Builder, with an example in VBScript.

NOTE - Large File Limitations: Due to an addressing limitation in WIN32, graphs can fail when any data file size exceeds 2 GB. This limitation applies to any file, including the input database or the intermediate file constructed by ProEssentials from the database. If the intermediate file is too large, the suggested recourse is to use data limiting or reduce the time period on the inputs tab of the Static Product Builder.

If a question mark (?) appears next to the product name, it means that a valid combination of Product Style and Data Source has not yet been defined for that product.

The Static Product Builder has two toolbars with buttons that let you perform various operations:

Static Product Builder Toolbar Buttons
Button Action
Add a data product to the list.
Remove the selected data product(s) from the list.
Make a copy of the selected data product.
Move the selected data product toward the beginning of the list.
Move the selected data product toward the end of the list.
Generate all data products in the list.
Generate all data products that are selected in the list.
Halt generation of data products.
Create a new data products list. A message window gives you the option to save the current list before creating the new one.
Open an existing list of data products. If you have made changes in the currently displayed list, a message window gives you the option to save that list before opening the new one.
Save the currently displayed list. Not available if the currently displayed products have not previously been saved as a list. See note below on automatic reloading of previously saved data products lists.
Save the currently displayed products to a specified file name. Enter the path and file name in the dialog that displays. See note below on automatic reloading of previously saved data products lists.

NOTE: If you load a data products list and then save the scenario and close it, the data products list will be reloaded automatically when you re-open the scenario if (1) the .dpl file has the same name as the scenario (i.e. <Scenario name>.dpl) , (2) the .dpl file is in the <USER HOME>\Styles directory, and (3) the Static Product Builder is open. The latter condition means that if you exit ODTK and re-start it, the default workbook must display the Static Product builder in order for the data product list to reload automatically when you open the scenario.

Inputs

Click the Inputs tab, select a data product in the left pane of the Static Product Builder window, and then proceed as follows:

In the Data Source area, click the Add button, and then click in the Filename field to select a file (e.g. a *.simrun or *.filrun file) to be used as the source of data for the report or graph. To delete a file from the list, select it and click the Remove button. A Remove All button is also provided. To disable a data source (for the selected data product) without removing it from the list, set the Enabled field to false.

If no selections are made in the Data Limiting area, all available satellites, trackers and measurement types in the data source file will, as appropriate, be used in the report or graph. To limit the data product to specific satellites, trackers and/or measurement types, move the desired items from the Available column to the Selected column by double-clicking them or highlighting them and using the > button. If you change your mind about an item, you can double-click it in the Selected column, or highlight it and use the < button, to move it back. To move all items from one column to the other, use the >> and << buttons.

Selecting all items in a given category is equivalent to making no selection at all, except that you force the Static Product Builder to check the Selected list for a given category if you make a selection. Thus, for example, if you intend to use all satellites in the data source file, it is more efficient not to make any selection in the Satellite Name category.

Selection of cross-correlations works differently: a cross-correlation element is selected only if it is moved to the Selected column. At least two cross-correlation elements must be selected for a cross-correlation to be defined. If more than two are selected, cross-correlations are computed pairwise for each possible pair in the set.

By default the time period for the report is that of the data in the data source file. To limit it to a shorter period, click the Use Time Period box and enter the desired Start and Stop times. If this box is not checked Start and Stop times are set by default to the span of the input run files. If the box is checked the values entered by the user will be preserved.

The Start Time and Stop Time will limit the amount of data drawn from the data file. They also set the scaling of the X axis. This can be very helpful when creating a number of graphs of differing values. All the start times can be aligned even if some of the data appears at a significant time after other data.

Outputs

Click the Outputs tab and select a report or graph style in the Product Styles list. If the selected style is supported by a valid data source file, the question mark to the left of the data product name in the left pane of the Static Product Builder window will be replaced by a report or graph icon. It is possible to see no selection in the list of outputs while the location field is showing a selection. This occurs when a product is selected on a different tab.

The following options are grouped into two menu buttons that appear below the Product Styles list:

Product Styles Management
Option Description
Edit... Launches the Report Designer if a report style is selected, the Graph Designer if a graph style is selected, or the Export Designer if an export style is selected.
Copy Lets you copy the selected product style as a convienient starting point for defining a new one.

If one or more copies of the selected style already exist, the name of the new copy is formed by prefixing the phrase "Copy of" to the name of the most recently created copy.

Copy To... Lets you specify where and under what name to save a copy of the currently selected report or graph.
Delete Removes the selected product style from the list.
Add Graph Opens a dialog that lets you select a database table for a new graph style. When you make your selection and close the dialog, the new graph style appears under a default name (e.g. New Graph 1) in the Product Styles list.
Add Report Opens a dialog that lets you select a new combination of available database tables for a new report style. When you make your selections and close the dialog, the new report style appears under a default name (e.g. New Report 1) in the Product Styles list.
Add Export Launches the Export Designer.

Manage Product Styles

You can add tabs to the Product Styles section of the Output tab to create and manage sets of product styles within the Static Product Builder. Click on the Edit Tabs button to create or open the 'ODTK Style Catagories.xml' file. The default sample file, when first created, looks like this:

        <?xml version = "1.0" standalone = "yes"?>
        <Style_Catagories version = "1.0">
            <Residuals>
                <Report name = "Residuals with Bias" />
                <Graph name = "Residuals" />
            </Residuals>
            <Satellite>
                <Report name = "Satellite*" />
            </Satellite>
        </Style_Catagories>
        

Follow the simple XML formatting to add new tabs and/or specific reports and graphs. Notice the use of the asterisk (*) as a wildcard character. Save the file and press the F5 key to refresh the list and to see newly created tabs. Styles can be dragged and dropped onto other tabs to add them to a list or dragged out of the list window area to remove them. List items generated from wildcard characters cannot be removed by dragging. The XML file must be edited to remove these items.

Select one of the following output options:

Output Options
Option Description
Display Product Display the report or graph when the Run All or Run Selected button is clicked.
Export Product

Export reports to Adobe PDF, Microsoft Word, Microsoft Excel, CSV, or XML formats when the Run All or Run Selected button is clicked. Export graphs to EMF, WMF, BMP, JPG or PNG format when the Run All or Run Selected button is clicked. For the selected Format specify the Destination type and file Location in the provided fields.

The default export size for graphs is 800 by 500 pixels. Use the X and Y size fields to customize the size of exported graphs.

ODTK 6.5