Table of Contents TABLE OF CONTENTS...I TABLE OF TABLES... II D - DATA PRESENTATION, REGRAPH AND EXPORTING...22 E - CHANGE AND VERSION RECORD...

Transcription

1 Table of Contents TABLE OF CONTENTS...I TABLE OF TABLES... II A - DISCUSSION...1 A.1 - Cautions...3 A.2 - Behavior in a Branch Loop...8 A.3 - Sensor Data...10 B - MAIN SETUP...12 B.1 - Setup Dialog...13 B.2 - Description...14 B.3 - Controls...16 C - PLOT SETUP...18 C.1 - Setup Dialog...19 C.2 - Description...19 C.3 - Controls...20 D - DATA PRESENTATION, REGRAPH AND EXPORTING...22 D.1 - Data Presentation...22 D.2 - A note on the Task Report...24 D.3 - Archive Regraph...31 D.4 - Data Exporting...35 D.5 - Export Setup...47 E - CHANGE AND VERSION RECORD...48 I

2 Table of Tables Figure A.1 - Multi-Trace Average Filter Task Sample Data Filtering Figure A Averaged Hysteresis Data of Different Lengths - Mismatched Axes... 4 Figure A Parametric View of Mismatched Hysteresis Data... 6 Figure A Mismatched Data Type Test Definition... 7 Figure A Placement of MTA Filter with Accumulate Enabled Figure B Multi-Trace Average Filter Task Configuration Dialog Figure B Multi-Trace Average Filter Task Configuration Dialog. Vision Data File Configuration Figure C Multi-Trace Average Filter Task Plot Configuration Dialog Figure D Hysteresis Multi-Voltage Data Averaged and Plotted by the MTA Filter.22 Figure D Adjusting the Plot Figure D Customization Dialog Figure D Test Definition that Produced the Data of Figure Figure D Test Definition for the Example Task Report Figure D Test Definition for the Example Accumulate Task Report Figure D Recall the MTA Filter Task from a DataSet Archive Figure D MTA Filter Task Configuration Dialog Recalled from a DataSet Archive Figure D MTA Filter Task Plot Configuration Dialog. Dialog is Active Figure D MTA Filter Task Data Recalled from a DataSet Archive Figure D Export Dialog with Printer Configuration Selected Figure D Standard Windows Printer Configuration Dialog Figure D Export Dialog with Text Configuration Selected Figure D Multi-Trace Average Filter Task Sample Text Export File. Upper Portion Figure D Multi-Trace Average Filter Task Sample Text Export File. Lower Portion Figure D Export Dialog with Excel Configuration Selected Figure D Multi-Trace Average Filter Task Sample Excel Export Output. Upper Portion Figure D Multi-Trace Average Filter Task Sample Excel Export Output. Lower Portion Figure D Export Dialog with Word Configuration Selected Figure D Multi-Trace Average Filter Task Sample Word Export Output. Upper Portion Figure D Multi-Trace Average Filter Task Sample Word Export Output. Lower Portion Figure D Utility of Vision Data File Exporting II

3 A - Discussion NOTE: The Multi-Trace Averaging Filter Task should not be confused with the Multi- Trace Loop Averaging Filter Task that has been added as of Version The Multi-Trace Averaging Filter Task belongs to a category of Vision Tasks known as Filters. Although there are exceptions, in general Filters are Tasks that perform four functions... Collect data from one or more Measurement Tasks or other Filters with which the Filter Task is associated. Perform operations on the collected data. Store the collected and manipulated data. Optionally plot the manipulated data during execution. The Multi-Trace Averaging Filter is a standard Filter in that it meets all of these criteria. Τhe Filter collects data from two or more input Tasks of like type. These may be Measurement Tasks or other Filters. A complete list of the currently associated Tasks is given below. From the input data, the Multi-Trace Averaging Filter produces a single trace that is the average of the values of the input traces. Both the dependent Y data (normally sample response - Polarization [µc/cm 2 ], for example) and the independent X data (normally sample stimulus voltage) are averaged. 1

4 Figure A.1 - Multi-Trace Average Filter Task Sample Data Fil- 2

5 tering. To date, the following Tasks may be associated with and provide data to the Single Trace Filter. Hysteresis Remanent Hysteresis Charge Leakage I/V C/V Advanced C/V Custom Measurement Piezo Piezo-D PUND Simple Pulse General Pulse Multi-Trace Averaging Filter Pass-Through Filter Hysteresis Filter Single-Trace Math Filter Two-Trace Math Filter RT6000 Import Filter RT66A Import Filter Single-Trace Loop Average Filter Multi-Trace Loop Averaging Filter Sensor Pass-Through Filter Parasitics Measurement Parasitics Compensation Filter A.1 - Cautions The Multi-Trace Averaging Filter Task places three simple restrictions on the user. 1. Two or more input Tasks must be associated with the Filter. 2. All input Tasks must be of the same type. 3

6 3. The input Tasks must come from the list presented above. The lack of further restrictions allows a great deal of freedom in programming the Test Definition. This freedom places an additional burden on the user to ensure that the Test Definition is programmed in a way that will produce data that make sense. There are two primary issues. Mismatched X (Independent) Axis Size. The Multi-Trace Averaging Task allows input data vectors of varying lengths to be averaged and plotted. The length of the output data will be determined by the length of the shortest input vector. For example if traces of 300, 500 and 1000 points are associated with the Filter, the first 300 points of each trace will be averaged. Any remaining points will be discarded. This can lead to unexpected results. In Figure A.1.1, actual Hysteresis data were taken at 300 µs and 300 ms. The 300 µs measurement contains 300 points and the 300 ms measurement 1000 points. 300 points were averaged. All of the 300 µs data were included in the average while less than 1/3 the 300 ms data are included. The result is a peculiarly shaped plot, that vaguely resembles a Hysteresis loop with data shifted heavily to the right and making more than one complete loop. Figure A Averaged Hysteresis Data of Different Lengths - 4

7 Mismatched Axes. These results may be somewhat better understood by breaking the averaged loop into its component parts. In the two figures below, the drive voltages and polarizations are shown for both input traces as a function of the sample number up to 300 points. Also shown are the averaged values for these traces. Note that the 300 µs data is complete while the 300 ms data shows the first leg and a small portion of the second leg, just past the VMax point. 5

8 Figure A Parametric View of Mismatched Hysteresis 6

9 Data. As a consequence of this discussion, care should be taken that either all input vectors will have the same length or that the departure from this rule will behave in a predictable and decipherable way. Mismatched Input Task Type - All Tasks that provide input data to a single instance of a Multi-Trace Average must be of the same type. However, mismatched input types can be indirectly provided to the Filter if two or Filter Tasks provide the input data. Consider the Test Definition shown in Figure A Figure A Mismatched Data Type Test Definition. The red arrows in the figure show the link between the three Multi-Trace Average Filters in the Test Definition and the Tasks that they are associated with. The Test Definition consists of three identical Hysteresis loops associated with a Multi-Trace Average Task. Then three identical PUND Tasks are associated with a second Multi-Trace Average. A third Multi-Trace Average Filter collects and averages the data that have been averaged in the two previous Filters. This configuration is perfectly legal and will operate, produce an averaged trace and plot the data. However, the mismatch of indirect data input types will generate a Filter trace that has no significant meaning. In this case, the dependent measured values happen to have the same type - Polarization (µc/cm 2 ). (Other matches - for example, Hysteresis and Leakage measurement - will produce averages of values of different unit types.) However, while Hysteresis data are plotted as a function of the stimulus voltage at the sample point, PUND data are plotted in a synthetic way, with P*, P*r, P^, P^r, -P*, -P*r, -P^ and -P^r shown sequentially from left to right in the plot (giving a pseudo-time X value). The X value for the PUND is fixed for all PUND plots and is set to display the measured value over 7

10 an X distance that spans two points with the endpoints of each PUND measured value overlapping the previous and following measured value. The data acquired by the "MTA Input Average" Filter (where "MTA" means "Multi-Trace Average") are limited in vector size by the PUND Task whose number of points is fixed at seventeen. For the Hysteresis data, there is little variation, either in Voltage or Polarization, from one sample point to another, so that the results will appear similar to a PUND measurement, with slight X and Y variations at the endpoints for each measured value. The values themselves will normally be near 1/2 the measured PUND values and placed at an X increment near 1/2 normal, since the averaged Hysteresis terms from 0 to 17 will not normally be large for traces with a large number of points. (In other words, the PUND X and Y values are being averaged with near-zero values for the Hysteresis measurements.) A sample of the "MTA Input Average" Filter is given in the figure. The data in the figure are averaged from synthetically-generated values that are not intended to simulate actual measured values. Figure A Mixed PUND and Hysteresis Data Averaged Together. A.2 - Behavior in a Branch Loop 8

11 A primary purpose of Filter Tasks is to display data that they accumulate and operate on during execution. One reason that this function has been divorced from most Measurement Tasks is to reduce the number of display windows opened to a number that is manageable and useful for data interpretation. (Another is to allow data acquired by more than one Task to be compared directly on the same plot.) Were Measurement Tasks to plot their own data, one mechanism that would result in the unacceptable proliferation of plotting windows would be the placement of the Measurement Task into a Branch Loop. Since plotting has been moved under the purview of Filter Tasks the issue of how Filters behave in a Branch Loop becomes important. While this discussion will focus on how data are plotted when the Multi-Trace Averaging Filter is in a Branch Loop, the analysis also applies to how data are accumulated and stored, even if the Filter run-time plotting option is disabled. There are three options available to the Multi-Trace Averaging Filter when it is located in a Branch Loop. Default (Accumulate Disabled, Append Disabled) - In this option no special Branch Loop handling is enabled. If plotting is enabled, a new plot will be generated at each loop iteration. Each new plot will contain a single trace that is the average of the input data acquired by the input Tasks during that loop iteration. That is to say, each subsequent plot will contain the average of the most recently acquired data. This option is most useful when the loop will contain few iterations or when plotting is disabled and when there is no need to directly compare data from one loop iteration to another. This option has the advantage of providing the slowest size growth of the DataSet since no averaged data vector is stored more than once. This option may be used to save DataSet size and speed even when data acquired from iteration to iteration must be directly compared. In this case, the Tasks to be compared will be recalled from the DataSet Archive and each will have their data individually exported into a format such as Excel in which the data can be merged and compared. Disadvantages of this method include the proliferation of plots and the lack of immediate direct comparison of data from various iterations. Accumulate (Accumulate Enabled, Append Disabled) - For a Multi-Trace Averaging Filter located within a Branch Loop and with Accumulate enabled, a new plot will be generated at each loop iteration. Each new plot will contain a number of traces equal to the loop count (one trace for the first iteration, two traces for the second, etc.). The traces on each plot represent the entire history of the operation of the Filter Task. In the first iteration, the plot will show the average computed at that iteration. In the second, the plot will show the average computed at the first iteration and the average of the most recent acquisitions. In this way, the entire history of the execution is always directly compared on a single plot. An advantage to this is the direct comparison. A second advantage is that earlier plots are not overwritten but maintain the history of comparisons. Disadvantages include the proliferation of plots and a data structure that rapidly grows in size as earlier 9

12 acquired data are repeatedly stored in subsequent executions. Data are not accumulated by maintaining older data and appending the most recently acquired. Instead at each new iteration, the entire history of the input Tasks is called up from the data base and the historical averages are recomputed. This fact allows the Task to be used in a way that eliminates the disadvantages of multiple plots and repeated storage of identical data. By programming the input Tasks into the Branch Loop, but placing the Multi-Trace Averaging Task outside the loop, the Tasks will execute only once. It will mine the input Task data from the data base and construct a complete set of historical averages. These will be plotted together on a single plot and stored in a single data structure with no redundancy in data storage. The disadvantages here include the fact that the Filter will not plot anything until the Branch Loop completes. Furthermore, all iterations are compared at once. No early comparisons with reduced numbers of traces are available. A simple example of such a Test Definition is shown in the figure. Figure A Placement of MTA Filter with Accumulate Enabled. Append (Append Enabled, Accumulate Enabled or Disabled) - This option produces a single plot during the first iteration. At each subsequent iteration, the most recently averaged data are appended to the plot and to the Task data structure. This is likely the most practical approach to plotting data within a Branch Loop. (No practical application is gained by placing the Task configured this way outside the Branch Loop.) It has the advantage of producing only a single plot and offering the immediate direct comparison of the entire history of Task execution. The disadvantage is that data are stored redundantly to the DataSet Archive. Any historical comparison can be recalled from the DataSet Archive during a Regraph. A.3 - Sensor Data Sensor data are not collected, averaged or plotted by the Multi-Trace Averaging Filter Task. The reason is simply that there is no requirement that all of the input Tasks have their Sensor option enabled. If Sensor averaging were permitted and some, but not all, of the input Tasks had Sensor acquisition enabled, the processing of Sensor data would be 10

13 ill-defined. 11

14 B - Main Setup Task Name: Multi-Trace Averaging Filter Version: Last Update: 5 October 2005 In QuikLook Menu: No Folder: Filters Subfolder: Generic Subsubfolder: Averaging Window Name: Multi-Trace Averaging Filter Setup::Multi-Trace Average Filter Change Record: Go to Change Record Known Bugs: None User Variables Added: None 12

15 B.1 - Setup Dialog Figure B Multi-Trace Average Filter Task Configuration Dialog. 13

16 Figure B Multi-Trace Average Filter Task Configuration Dialog. Vision Data File Configuration. B.2 - Description Filters are Tasks that perform four functions Assemble data acquired by previous Tasks. 14

17 Perform operations on the assembled data Store the assembled, modified data Optionally display the data upon execution. A Filter may receive its data from any number of preceding Measurement Tasks of a single type, (Hysteresis, Pulse Tasks, etc.) or from Filter Tasks. With daisy-chained Filters, operations on data can be performed step-by-step. With the optional plot capability, the results of each operational stage can be observed. Normally filter provides the only means of manipulating the data or viewing the results of a measurement during the execution of a Current Test Definition (CTD). (Exceptions are made for Tasks that perform measurements extended in time. These include: Fatigue, Retain, Chamber, PFatigue, etc..) Measurement Tasks do not perform any self-plotting during execution. The Measurement Task does self-plot as the result of the execution of a QuikLook operation or when double-clicked (reopened) in the DataSet Archive. The Multi-Trace Averaging Filter is an Averaging Filter that takes input from two or more associated Tasks and averages those data into a single trace. If the plot option is selected, plot behavior within a Branch Loop is of concern. Two controls affect both the number of plots and the data on those plots. With no controls enabled, a new plot will be generated for each loop iteration. That plot will show only the most recent measurement from each of the selected Tasks. An Accumulate control modifies this sequence. With that control enabled, each new loop iteration will produce a new plot, but the plot will show all of the measurements made by selected Tasks. That is, each subsequent iteration will display all of the data displayed in all of the previous iterations as well as the most recent measurement. This option will rapidly increase the number of traces and slow down processing for large loops and/or multiple Task selections. Note that the accumulate option applies even if data are not plotted. The assembled and stored data maintain the accumulation. Keep in mind the fact that the plotting facility will only show up to 14 total traces. If more than 14 traces are sent to the plot, only the first 14 traces will be shown, but processing will be considerably slowed as the plot tool adjusts to the extra data. Any 14 traces can be reviewed and plotted by manipulating the plot customization dialog one the Test Definition has terminated. If plotting is enabled (by selecting the plot option on the Plot Setup page) an Append option becomes available on the Plot Setup tab. In this case only a single plot is generated regardless of the number of loops. Each iteration will add a new data trace that is the result of the operation on the most recent iteration of the associated Task(s). The main setup dialog permits the user to select a Task type to be associated. All of the preceding Tasks of that type will be listed in the Task Selector control. (If "Hysteresis" is selected, Hysteresis, Remanent Hysteresis and Check Hysteresis Tasks will appear in Task Selector.) In general any subset of the available Tasks may be associated with the Filter by highlighting them in Task Selector and clicking Add Task. At least two Tasks 15

18 must be added in this way. Please see the Discussion page for a detailed description of the restrictions on the Multi-Trace Averaging Filter Task. With the release of Version 4.0.0, a new exporting option has been introduced. Once a Multi-Trace Loop Averaging Filter Task has been executed it can have its configuration parameters and data exported to a Vision data file. Subsequent Multi-Trace Loop Averaging Filter Tasks can be configured to read from the data file in lieu of making a new measurement. This feature allows data taken from multiple DataSets to be imported into other DataSets, where additional Filters can then be applied as though the Task were taking new data. Configuration of the Multi-Trace Loop Averaging Filter Task to import Vision Data File data is shown in Figure B.1.2, above. For details, see the exporting tutorial. Other changes pertaining to Version include the elimination of the "Eye" icon and extending the character limit for the Comments control from 255 to 511. B.3 - Controls Name Type Default Description Task Name Text Multi-Trace Average:# This serves as a root identifier for this instance of the Multi-Trace Averaging Filter Task. The Task will be identified with this value in the Editor and the CTD. Executed Tasks will be displayed and stored with this name with a. and an execution number appended to it. Each new instance of a Multi-Trace Averaging Filter Task within the Editor should have a unique Task Name assigned. 30-character limit Accumulate Boolean False If the measure-task/filter pair are within a loop, this control allows each new iteration of the filter to assemble data from ALL previous instances of the measurement. If disabled, only the most recent measurement is taken. Data Type List Filter This control is used to specify the type of task from which input data are to be taken. Only a single selection is available from this control. Options are listed in the Discussion page. Task Selector List None This control will display all preceding tasks of the type chosen in the task selector. Two or more tasks may be selected using the Control and/or Shift keys. At least two tasks must be selected or the dialog will not exit. These tasks will be the ones that are used to assemble data. If the Data Type selection is changed and returned to the selected type, the task must be reselected. Selected tasks are indicated with an appended (x). Tasks must be selected by both highlighting them, then pressing the Add Task control. Add Task Button N/A Select the tasks highlighted in the Task Selector control. This causes the highlighted Tasks to have "(X)" appended to their names in the Task Selector list. 16

19 Read Data from Vision File Browse to File Check Box Unchecked Checking this box instructs the Multi-Trace Average Filter Task to read its data in from a file specified in File Name rather than importing from an associated Task and Multi-Trace Average Data File. The file is a binary Vision Data File in Multi-Trace Average Filterspecific format. If this control is unchecked, File Name and Browse to File are hidden. If the control is checked, File Name and Browse to File are shown and all controls except Task Name and Comments are disabled. That is because the controlled values will be read in from the input file. If the control is checked, Browse to File must be used to locate and identify an Multi-Trace Average Filter-formatted Vision Data File. Button Unpressed Clicking on this button opens a standard Windows browser dialog that must be used to locate and identify a Multi-Trace Average-formatted Vision Data File. By default, the browser filters for *.vis files, although the file may have any name and extension. Once identified, the file path and file name are displayed in File Name. This control is hidden if Read Data From Vision File is unchecked. File Name Text "" Read-only. This control shows the file path and file name of the Multi-Trace Average Filter-formatted Vision Data File to be read for measured data and configuration parameters on Task execution. The control is updated using Browse to File. This control is hidden if Read Data From Vision File is unchecked. Comments String A string of up to 511 characters to be written at the user s discretion. Intended to allow a detailed description of the design decision to include the Multi-Trace Averaging Filter Task. Export Button Unpressed This control initiates a dialog used to configure the exporting of the measured data into a format external to Vision. This is discussed in detail in the Data Recall page. Help Button Unpressed Read this Help page. OK Button Unpressed Close the dialog. Accept the configured Multi-Trace Averaging Filter values and append the Task to the Test Definition. Cancel Button Unpressed Close the dialog. Do not add the Task to the Test Definition. 17

20 C - Plot Setup Task Name: Multi-Trace Averaging Filter Version: Last Update: 5 October 2005 In QuikLook Menu: No Folder: Filters Subfolder: Generic Subsubfolder: None Window Name: Multi-Trace Averaging Filter Setup::Plot Setup Change Record: Go to Change Record Known Bugs: None 18

21 C.1 - Setup Dialog Figure C Multi-Trace Average Filter Task Plot Configuration Dialog. C.2 - Description 19

22 The Filter Task will optionally plot the data that it operates on during execution. This dialog page enables the plotting and sets up the various plot labels that will be displayed to specify the data. An Append control helps establish the behavior of the Task in a Branch Loop. C.3 - Controls Name Type Default Description Plot These Data Check Box Unchecked This control enables the plotting of the accumulated and manipulated input data during the execution of the Filter. If the control is disabled, no data display will occur until data are recalled from the DataSet Archive. When disabled all other controls on the dialog page except Help are disabled. All controls are enabled when Plot These Data are enabled. Append Data Check Box Unchecked This control affects the behavior of the Filter Task when displaying its data in a Branch Loop. With this control unchecked (and disregarding the Accumulate control in the main dialog) the Filter will generate a new plot window at each loop iteration. The new window will display the accumulated and manipulated data of the most recent execution of the input Tasks. With the Append Data control selected, a single plot window will be opened on the first loop iteration. Subsequent loop iterations will add the accumulated and manipulated data to the existing data on the plot window. This control is disabled if Plot These Data is not checked. Plot Title Text "" 60-Characters maximum. Allows a textual description of the displayed data to be entered by the user. The description will appear at the top of the plotted data. This control is disabled if Plot These Data is not checked. Plot Subtitle Text "" 60-Characters maximum. Allows a supplemental textual description of the displayed data to be entered by the user, giving the user additional space for description. The description will appear at the top of the plotted data just beneath the text specified in Plot Title. This control is disabled if Plot These Data is not checked. Plot X Axis Label Plot Y Axis Label Text "" 60-Characters maximum. The user specifies text that is placed adjacent to the X-Axis, normally describing the units represented by that axis. Unlike most Tasks, the nature of the independent variable cannot be inferred and so no default value is provided. This control is disabled if Plot These Data is not checked. Text "" 60-Characters maximum. The user specifies text that is placed adjacent to the Y-Axis, normally describing the units represented by that axis. Unlike most Tasks, the nature of the dependent variable cannot be inferred and so no default value is provided. This control is disabled if Plot These Data is not checked. Data Label Text "" 32-Characters maximum. The user specifies text that is to be associated with the symbol and line type of the data being plotted. This is used to distinguish the data in a plot containing more than one data trace. This control is disabled if Plot These Data is not checked. Help Button Unpressed Read this Help page. OK Button Unpressed Close the dialog. Accept the configured Multi-Trace Averaging Filter 20

23 Cancel values and append the Task to the Test Definition. Button Unpressed Close the dialog. Do not add the Task to the Test Definition. 21

24 D - Data Presentation, Regraph and Exporting D.1 - Data Presentation Figure 1 shows the plot that appears as a result of the execution of the Multi-Trace Averaging Filter. The data shown represent the average of three sets of Hysteresis Task data taken at different voltages. This does not necessarily represent a practical use of the MTA Filter Task. Figure D Hysteresis Multi-Voltage Data Averaged and Plotted by the MTA Filter. The left portion of the window shows the plotted data. The plot is labeled with text established in the Plot Setup configuration dialog. The right portion of the window contains a text control that shows the Task Report for both the Filter and the associated input Tasks. This window is scrollable and can become lengthy, especially for Tasks located in a Branch Loop. Delays in displaying the window are usually associated with writing this control. See the discussion of the Task Report given below. Beneath the Task Report control is a control that shows the type of Tasks associated with the Filter. The plot display can be modified by a set of standard tools. These tools are accessed by right-clicking with the cursor placed in the plot window. A popup menu will appear as shown in the figure below. Selecting "Customization Dialog..." opens a dialog that can be 22

25 used to change several parameters at once. See the Step-by-Step instructions in the main Help pages for a detailed description of the use of these features. Figure D Adjusting the Plot. 23

26 Figure D Customization Dialog. D.2 - A note on the Task Report The Task Report shown in the right portion of the plot window is constructed by creating a text header for the Multi-Trace Average Filter. This consists of the Task Type, the Task Name and an indication of the execution count. This final value will vary from '1' only if the Task is located in a Branch Loop. The value indicates the loop count. To this header is appended the Task Report acquired from each of the Input Tasks. These generally consist of a Task-specific header, Task configuration information and acquired data information. Tasks append their Task Reports to the Filter Task report in reverse order of execution so that the most recently executed Task (and that most adjacent to the Filter) will appear first. In the simple Test Definition shown in Figure D.2.1, the 7.0-Volt Hysteresis Task will append its Task Report First. This is also apparent on the in the plot of Figure D

27 Figure D Test Definition that Produced the Data of Figure 1. To understand how the Task report will appear in a Branch Loop, consider the complex Test Definition shown in Figure 5. Assume that the Branch Loop executes three times. It is the Task Report displayed by "MTA Input Average" that is to be examined. Figure D Test Definition for the Example Task Report. If data are neither accumulated nor appended, a new plot will appear at each loop iteration. The Task Report for each iteration will contain the most recently created Task Report from each input Task. Note that since the Filter is taking data from other Filters that take their data from Measurement Tasks, the Task Report is built recursively and contains information from all Tasks as follows. Loop Iteration 1 - Plot 1 "MTA Input Average" header - Iteration 1 "PUND Input Average" header - Iteration 1 25

28 Loop Iteration 2 - Plot 2 "MTA Input Average" header - Iteration 2 "Hysteresis Input Average" header "PUND Input Average" header - Iteration 2 "Hysteresis Input Average" header - Iteration 2 26 "PUND Measurement 3" header "PUND Measurement 2" header "PUND Measurement 1" header "10 ms Hyst Loop 3" header and setup and acquired data information "10 ms Hyst Loop 2" header and setup and acquired data information "10 ms Hysteresis Loop" header "PUND Measurement 3" header - Iteration 2 "PUND Measurement 2" header - Iteration 2 "PUND Measurement 1" header - Iteration 2 "10 ms Hyst Loop 3" header and setup and acquired data information - Iteration 2 "10 ms Hyst Loop 2" header and setup and acquired data information - Iteration 2 "10 ms Hysterias Loop" header - Iteration 2

29 Loop Iteration 3 - Plot 3 "MTA Input Average" header - Iteration 3 "PUND Input Average" header - Iteration 3 "Hysteresis Input Average" header - Iteration 3 "PUND Measurement 3" header - Iteration 3 "PUND Measurement 2" header - Iteration 3 "PUND Measurement 1" header - Iteration 3 "10 ms Hyst Loop 3" header and setup and acquired data information - Iteration 3 "10 ms Hyst Loop 2" header and setup and acquired data information - Iteration 3 "10 ms Hysteresis Loop" header - Iteration 3 The table above also represents the construction of the Task Report for each iteration of the Branch Loop if the data Append option is selected. For either of these configurations, the plot will show the final iteration Task Report only when execution terminates. To recover earlier Task Reports, regraph the Task from an earlier iteration in the DataSet Archive. In the Accumulate mode, with the Filter placed inside the Branch Loop, each subsequent Branch Loop iteration will produce a new plot window. The Task Report for each plot window will contain the entire history of the measurements executed to date in the Test Definition. The sequencing of Task Reports is slightly peculiar as shown in the table Loop Iteration 1 - Plot 1 "MTA Input Average" header - Iteration 1 "PUND Input Average" header - 27

30 Loop Iteration 2 - Plot 2 "MTA Input Average" header - Iteration 2 Iteration 1 "Hysteresis Input Average" header "PUND Input Average" header - Iteration 1 "PUND Input Average" header - Iteration 2 28 "PUND Measurement 3" header "PUND Measurement 2" header "PUND Measurement 3" header "10 ms Hyst Loop 3" header and setup and acquired data information "10 ms Hyst Loop 2" header and setup and acquired data information "10 ms Hysteresis Loop" header "PUND Measurement 3" header "PUND Measurement 2" header "PUND Measurement 1" header "PUND Measurement 3" header - Iteration 2 "PUND Measurement 2" header - Iteration 2 "PUND Measurement 1" header - Iteration 2

31 Loop Iteration 3 - Plot 3 "MTA Input Average" header - Iteration 3 "Hysteresis Input Average" header "Hysteresis Input Average" header - Iteration 2 "PUND Input Average" header - Iteration 1 "PUND Input Average" header - Iteration 2 29 "10 ms Hyst Loop 3" header and setup and acquired data information "10 ms Hyst Loop 2" header and setup and acquired data information "10 ms Hysteresis Loop" header "10 ms Hyst Loop 3" header and setup and acquired data information - Iteration 2 "10 ms Hyst Loop 2" header and setup and acquired data information - Iteration 2 "10 ms Hysteresis Loop" header - Iteration 2 "PUND Measurement 3" header "PUND Measurement 2" header "PUND Measurement 1" header "PUND Measurement 3" header - Iteration 2 "PUND Measurement 2" header - Iteration 2 "PUND Measurement 1" header and setup and acquired data infor-

32 "PUND Input Average" header - Iteration 3 "Hysteresis Input Average" header "Hysteresis Input Average" header - Iteration 2 "Hysteresis Input Average" header - Iteration 3 mation - Iteration 2 "PUND Measurement 3" header - Iteration 3 "PUND Measurement 2" header - Iteration 3 "PUND Measurement 1" header - Iteration 3 "10 ms Hyst Loop 3" header and setup and acquired data information "10 ms Hyst Loop 2" header and setup and acquired data information "10 ms Hysteresis Loop" header "10 ms Hyst Loop 3" header and setup and acquired data information - Iteration 2 "10 ms Hyst Loop 2" header and setup and acquired data information - Iteration 2 "10 ms Hysteresis Loop" header - Iteration 2 "10 ms Hyst Loop 3" header and setup and acquired data information - Iteration 3 "10 ms Hyst Loop 2" header and setup and acquired data information - Iteration 3 "10 ms Hysteresis Loop" header - Iteration 3 30

33 If the Accumulate-configured Filter is placed outside the loop as in Figure D.2.3, the Task Report history of all Hysteresis executions is maintained. The Task Report appears as in the table Figure D Test Definition for the Example Accumulate Task Report. "Average of Hysteresis Tasks" header Iteration 1 D.3 - Archive Regraph "10.0 ms Hysteresis" header "10.0 ms Hysteresis" header - Iteration 2 "10.0 ms Hysteresis" header - Iteration 3 "1.0 ms Hysteresis" header "1.0 ms Hysteresis" header - Iteration 2 "1.0 ms Hysteresis" header - Iteration 3 As with all Tasks, the Multi-Trace Averaging Filter Task is recalled from a DataSet Archive by browsing to the measurement in the Archive portion of the tree in the DataSet tab of the DataSet Explorer. Double-click on the Task in the Tab to open the configuration dialog. 31

34 Figure D Recall the MTA Filter Task from a DataSet Archive. 32

35 Figure D MTA Filter Task Configuration Dialog Recalled from a DataSet Archive. The configuration dialog is opened for review. Most controls are disabled. Help is available. Cancel is active to allow the dialog to be closed and the Archive Regraph to continue. The plotting tab has controls enabled so that titles can be set. The Export button is 33

36 active to all data to be transferred out of Vision as discussed below. The "Multi-Trace Average Plot Setup Tab" is accessible. Controls on the tab are enabled to allow the regraphed data to be configured for plotting. Although all controls are enabled, only the label controls will adjust the plot. Disabling Plot These Data will not prevent the data from being plotted. Figure D MTA Filter Task Plot Configuration Dialog. Dialog is Active. 34

37 Figure D MTA Filter Task Data Recalled from a DataSet Archive. D.4 - Data Exporting All Tasks can have their data exported to one of four targets outside of Vision when recalled from a DataSet Archive after the execution of a the Test Definition in which they are programmed. In order to perform the exporting during the execution of the Test Definition, the Multi-Trace Loop Average Filter Task must be associated with a Print/Export Filter. Targets are: Printer - This is the default selection. Pre-formatted text is sent to the printer attached to the Precision Tester (Workstation and Premier testers) or the tester host computer (all others) when the configuration dialog is closed. As of version 4.0.0, Line Spacing, Left Margin and Tab Spacing controls are shown on the dialog when "Print" is selected in Select Option. These allow text horizontal and vertical placement to be adjusted, through trial-and-error, for the particular printer. A Header Only option restricts the output to Task configuration information, eliminating extensive lists of measured data and reducing the output length. Before output begins, the appropriate Window printer configuration dialog will appear as in Figure D

38 Figure D Export Dialog with Printer Configuration Selected. 36

39 Figure D Standard Windows Printer Configuration Dialog. Text File - Selecting this option enables the Browse for File Name button. Clicking this button will open a standard browser dialog in which a file name and path must be selected. If the file already exists, the output will be appended to existing text. An output file name must be specified for this export. The figures show a partial sample of the text export from a file generated using the data recalled from the DataSet Archive. When the Multi-Trace Average Filter is executing in a Branch Loop in Append mode and the recalled file is not the first, all of the appended data will be exported. 37

40 Figure D Export Dialog with Text Configuration Selected. 38

41 Figure D Multi-Trace Average Filter Task Sample Text Export File. Upper Portion. Figure D Multi-Trace Average Filter Task Sample Text Export File. Lower Portion. 39

42 Excel - Selecting this option enables the Browse for File Name button. Clicking this button will open a standard browser dialog in which a file name and path may be selected. Specifying a file name is optional when the Task is recalled from a DataSet Archive. However, if specified, a unique file name/file path must be created or an overwrite situation will occur. Data are not appended to existing files. When the configuration dialog is closed, the Excel program will be started and a spread sheet created. When Excel is closed, the data will be written to the specified file name, or the user will be prompted to save if the file is not specified. Programmatic techniques for producing Excel '97 files were provided by Lacoude and Ketema 2. Office '97 or Office 2000 must be loaded for this option. Office is not provided as standard with the tester or Vision software. Utilities to write to Office 2003 or Office XP are not yet available. The figures show a sample of the Excel export file. Office 2000 exporting has been added as of Version Figure D Export Dialog with Excel Configuration Selected. 40

43 Figure D Multi-Trace Average Filter Task Sample Excel Export Output. Upper Portion. 41

44 Figure D Multi-Trace Average Filter Task Sample Excel Export Output. Lower Portion. Word - Selecting this option enables the Browse for File Name button. Clicking this button will open a standard browser dialog in which a file name and path may be selected. Specifying a file name is optional. The Word program will be opened and written when the regraph dialogs have been closed. If a new file name is specified, the document will be saved immediately. Word export to Office '97 depends on two template files - "Template.doc" and "Template2.doc"- located in "D:\DataSets" (C:\DataSets for the Precision LC tester family.). These are blank Word files. Template.doc is in portrait orientation with tabs at 1", 2.5", and 4". Template2.doc is in landscape orientation with tabs at 1", 2.5", 4" and 6". Both pages are set to Times New Roman 12 pt font. Word export output is formatted to align properly with these settings. Care must be taken not to overwrite the templates. If no file name is specified, the user will be prompted to save the documents when closed. If the documents are saved, the template file will be overwritten. In this event, the file should be renamed appropriately and a new template file 42

45 created with the specifications given above. Exporting to Word 2000 does not depend on the template files. Office '97 or Office 2000 must be loaded for this option. Office is not provided with the tester or Vision software. Utilities to write to Office 2003 or Office XP are not yet available. The Word export option has been added as of Version Office 2000 exporting is available as of Version The Header Only option appears when Word selected. Checking this control (default) suppresses the point-by-point output of measured data. This eliminates many pages of document that simply reflect columns of numbers, greatly reducing document size and clutter. The sample figures show the output with Header Only unchecked. Figure D Export Dialog with Word Configuration Selected. 43

46 Figure D Multi-Trace Average Filter Task Sample Word Export Output. Upper Portion. 44

47 Figure D Multi-Trace Average Filter Task Sample Word Export Output. Lower Portion. Vision Data File - In this option, added as of Version , the Task configuration parameters and measured data are written to a formatted binary file. Subsequent instances of the Single-Trace Average Filter Task can be configured to import the data from the file, on execution, rather than making a new measurement. In this way, data can be moved from one DataSet to another where they can be grouped with other data and filtered. This utility is demonstrated in Figure D Selecting this option enables the Browse for File Name button. Clicking this button will open a standard browser dialog in which a file name and path may be selected. Specifying a file name is required. 45

48 Figure D Utility of Vision Data File Exporting. 46

49 D.5 - Export Setup Name Type Default Description Select Option List Box Header Only Check Box "Print" Select between the "Print", "Export Text", "Export Word", "Export Excel" and "Export Vision" options. This control enables the Browse for File Name button for all selections except the "Print" option. Checked This control appears when Select Option is set to "Print" or "Export Word". Otherwise it is hidden. When checked, the output of the pointby-point drive voltage and measured data is suppressed. This shortens the document and eliminates what is likely to be superfluous data. Line Spacing Integer 100 This control appears when Select Option is set to "Print". Otherwise it is hidden. Increasing or decreasing this value will increase or decrease the vertical spacing of lines on the printed page. Experimentation will fix the value for any given printer. Left Margin Integer 100 This control appears when Select Option is set to "Print". Otherwise it is hidden. Increasing or decreasing this value will increase or decrease the left start point of text on the printed page. Experimentation will fix the value for any given printer. Tab Spacing Integer 200 This control appears when Select Option is set to "Print". Otherwise it is hidden. Increasing or decreasing this value will increase or decrease the horizontal spacing of tabbed sections of text on the printed page. Experimentation will fix the value for any given printer. Browse for File Name Button Unpressed This control is enabled for all export options except "Print". For the remaining options, this control must be selected. The browser dialog will appear where a path and filename must be specified for the export output. File Name Text "" This control is always disabled and cannot be used to specify the file name or path for Text, Word or Excel export. Once the browser is used to selected a path and file name, those will be displayed in this control for review. Note that a path and file name MUST be specified for the "Text" and "Vision" export options and may be specified for "Excel" or "Word". Help Button Unpressed Open this help document for review. OK Button Unpressed Accept the configured export and close the dialog. Exporting will occur when the main data regraph dialog is closed. Cancel Button Unpressed Close the export dialog. Do not export. 47

50 E - Change and Version Record This page specifically lists changes that are visible to the user. Often the software is changed in ways that are not directly apparent to the user. These changes may adjust the version number, in which case they are listed simply as "Internal Changes". Such changes may be indirectly evident in speed and performance improvements or the change of the Task file size. Version Initial Release - 3/21/01 - SPC May Adjusted the Task so that its output can be included as input to other Filters. SPC July Added the Sensor Pass-Through Filter as and input Task. SPC. Version Set the Task version to for development of the next release. 17 December SPC. Version Set to Version for release - 3/14/02 - SPC. 2. Initial Word Export feature was added. 2 April SPC. 3. Allowed for input files that change length as the Task iterates in a Branch Loop. 31 July SPC. Version Set to Version to reflect changes - 4 October 02 - SPC. 2. Eliminated the "Eye" icon - 4 October 02 - SPC. 3. Adjusted text control sizes on the plot configuration dialog - 4 October 02 - SPC. 4. Set the subfolder to "Averaging" instead of "Generic" - 4 November 02 - SPC. 5. Eliminated the Data Label control - 4 November 02 - SPC. 6. Added Tool Tips - 12 December 02 - SPC. 7. Allowed the Filter to accept input data from a single source Task. This allows the Task to average a single trace, putting out an unaltered data vector. This gives the Task a secondary capability. It can act as a single-input Pass-Through Filter. The advantage is that there is now a form of the Pass-Through Filter that can be associated with the Accumulate/Average Filter and the Two-Trace Math Filter

51 December 02 - SPC. 8. Added Word 2000 and Excel 2000 Exporting - 12 February 03 - SPC. Version Set to Version to prepare the next release - 30 April 03 - SPC. 2. Allow for the chance that an input vector will increase, then decrease in size in a Branch Loop - 22 July 03 - SPC. 3. Add custom text spacing to printer exporting - 11 August 03 - SPC. 4. Added Parasitics and Parasitics Compensation Filter Tasks as data input associates - 11 November 03 - SPC. 5. Fixed a bug in which data were not being plotted during execution - 11 November 03 - SPC. 6. Added the Check Hysteresis Task as a data input associate - 1 January 04 - SPC. 7. Added the Header-Only option to Word and printer exporting - 10 May 04 - SPC. 8. Added the Vision Data File I/O - 14 October 04 - SPC. 9. Added capability to adjust associated Tasks' icons to reflect the Filter association. Added the same capability to the Multi-Trace Average Task when other Filters or Branch Tasks assign it as an associate. - 2 May 05- SPC. 10. Added the Multi-Trace Loop Average Filter Task as an associated input source - 5 October SPC. 11. Renamed all references to the Accumulate/Average Filter to Single-Trace Loop Averaging Filter - 5 October 05 - SPC. 49