To start the DOI tool, log into a DESY server (e.g. flashuser2) and type the following commands:
NOTE: The DOI Tool can also be launched from a button in the lower right corner of the '9mA Tuning' DDD display.
The DOI main window is illustrated below:
DAQ Data Directory
The directory that contains the DAQ data is specified in this field. Popular directories for 9mA DAQ repositories are available through the pull down menu. To view the exact “runs” in the selected directory, press the Show “Runs” button.
T-start / T-stop
The time range of DAQ data to retrieve is specified in these fields. Enter the desired times while maintaining the displayed format.
DAQ Channel Group Files
Select one or more Channel Group Files to specify the DAQ channels to retrieve. To display the entire list of selected channels, depress the Show Channel List radial button. To add or edit a DAQ Channel Group File, hit the File Editor button.
DAQ Channel Names
Individual channel names may be added to the channel list by typing them into the DAQ Channel Names box and then hitting Enter Names. These added names will also show up in the Channel List pane (if it is being displayed).
While selecting the time range and the desired channels, monitor the Est. Data (MB) field which provides an estimate of the amount of DAQ data being requested. If the estimated data size exceeds 15000 MB, be prepared to wait a long time for the retrieval and storing of the data.
Test for 2s of Valid DAQ Data
This button attempts to fetch two seconds of DAQ data for the specified channel list (using T-stop as the reference). This provides a quick test to ensure that there is valid data for the parameters specified. The returned data is not stored. If no data existed for one or more channels, a dialog box is presented and asks if you want to determine which channels did not have data. If answered 'Yes', each channel is tested by itself and an entire list is displayed at the end indicating which channels successfully retrieved data. Results of the operation are displayed in the Status Line at the bottom of the display.
Fetch DAQ Data
This button fetches the DAQ data for the specified parameters and stores the result in an uncompressed format (for speed) in the sub-directory DAQ_data. The file name used is derived from the user name … DOI_<user>_temp.mat. Note that this file will be overwritten each time Fetch DAQ Data is depressed (see Create DOI File for storing a uniquely named copy of the data).
Create DOI File …
When a desirable set of data is successfully specified and retrieved, a uniquely named .mat file may be created so that this data can be conveniently accessed (or moved to another site). The fields in the Data of Interest File area allow one to enter unique comments, specify a directory, and then create the data file (Create DOI File). The .mat file is stored using compression to minimize the file size. Be patient, for large files may take a long time to store.
The window in the Analysis Scripts area shows matlab files that are located in the DOI_analysis sub-directory. These analysis scripts are written using the template file DOI_z_analysis_template.m . By using this template, the DOI tool can introspect the analysis scripts to extract the DAQ Channel Group Files that are needed for the script. For example, when an analysis script is selected, the appropriate Channel Group Files (which contain specific channel names) are automatically selected … which specifies a Channel List that is compatible with the analysis script. The template also allows for data files to be introspected to ensure that they contain the necessary channels for each script to run.
By using the template, an analysis script can be written so that it is very convenient to select the script, specify the DAQ parameters (directory and time of interest), then fetch the data and immediately pass it to the analysis script.
Depressing this button displays a brief description of each selected script.
Fetch DAQ Data and Run Script …
This button fetches the DAQ data and then executes each selected analysis script using the returned data.