IADS Batch Server User Guide. Version July 2014 SYMVIONICS Document SSD-IADS SYMVIONICS, Inc. All rights reserved.

Transcription

1 IADS Batch Server User Guide Version July 2014 SYMVIONICS Document SSD-IADS SYMVIONICS, Inc. All rights reserved.

2 Table of Contents 1. IADS Batch Server Batch Server TestInfo Command Search Command DataExport Command Config Command Archive Command Statistic Command (Work in Progress) DataImport Command Data Group Setup and Export Options ii

3 1. IADS Batch Server 1.1. Batch Server The IADS Batch Server is a Post Test application that allows the end user to create various informational output files from an IADS archive data set. These files can be CSV or binary data depending on the command and the selected output type Each functional area has a unique set of commands that are performed by the IADS Batch Server entered using the application command line, which is handy for scripting, from the GUI, or from a run file when multiple commands are desired. In addition, certain commands can be chained together where the output file from one command can be used as input to a follow-on command. Batch Server Command Types: TestInfo - The Test Information command is used to output CSV compatible files of a variety of data collected during a test. Search - The Search command is used to output event times from a single IADS test set or multiple IADS test sets to a CSV file. Any conditional statement that is valid in IADS can also be used as an equation in the Search command. DataExport - The Export command is used to output parameter data within user specified time segments. Config - The Config command can be used to import or export IADS Analysis Windows or Desktops from an IADS configuration file. Archive - The Archive command is used to combine, split or convert IADS data files. Statistic (Work in Progress) DataImport The DataImport command is used to create a data set (IADS data files and config) from a CSV file that defines measurements for usage in the IADS Playback Client. To create a run file with multiple commands: A run file have two halves separated by an equal = sign. The left side is the command name and the right side has the arguments. An entry in the run file preceded by an asterisk * will be commented out. Click on a link above to see all the command options for that type. 1. Open Notepad on your computer. 2. Enter Batch Server commands. 3. Save the file. 1

4 IADS Help To run the IADS Batch Server using a run file: 1. Double-click the IADS Batch Server icon on the Desktop. 2. Click the File menu > Open. 3. Navigate to the run file and click Open. To re-load a run file: Click the File menu > Reload Run File. To run the IADS Batch Server using a single command: 1. Double-click the IADS Batch Server icon on the Desktop. 2. Click the drop down at the bottom of the dialog to select a command type such as TestInfo, Search, DataExport, Config or Archive. 3. Enter a corresponding command for that command type. For example, click the drop down to select TestInfo and in the blank field enter: ExportDataGroups c:\iadsposttestdata\pfconfig c:\datagroups.csv 4. Click the Execute button. Command rules: 1. In a Run file commands are executed serially from top to bottom. 2. Spaces in an argument must be enclosed in quotes " ". 3. Double quotes in text must be preceded with another quote "". To save a Batch Server log file: Click the File menu > Send to Log File. The IadsBatchServer.log is created in the directory that contains the IadsBatchServer.exe. 2

5 IADS Batch Server To execute a run file or command from the Command Prompt Commands on the application command line have a "/" to designate the command, and the arguments separated by spaces; or use /runfile. For example: c:\program Files\IADS\BatchServer\IadsBatchServer /runfile c:\iadsbatchserver\runfile.txt STDOUT (standard output stream) can be used as an argument for the TestInfo, Search and DataExport commands in lieu of an output file. For example: c:\programfiles\iads\batchserver>iadsbatchserver /Hide /TestInfo Export DataGroups c:\iadsposttestdata\pfconfig STDOUT > c:\output.txt Miscellaneous Commands Hide command /Hide entered at the command prompt before the batch server command will prevent the Batch Server GUI from opening. For example: IadsBatchServer /Hide /TestInfo Export TestPoints D:\PostTestData\TestSet\pfconfig D:\test\TestPoints.csv Version command /Version returns the version number of the IADS Batch Server application in the Batch Server window. For example: IadsBatchServer /Version. 3

6 IADS Help 1.2. TestInfo Command The Test Information command is used to output (export) CSV compatible files of a variety of data collected during a test that is contained in the IADS Configuration file. You can then use the TestInfo data file that was exported as an input (import) file. The distinction between export or import is declared in the first argument. TestInfo Type DataGroup DataGroups EventMarkers Description Output (only) a single DataGroup to/from a CSV file. The Parameters and Properties are serialized in the output file. Output/Input the DataGroups table to/from a CSV file. Output/Input the Event Markers table to/from a CSV file. MissionAttributes Output/Input the Mission Attributes table to/from a CSV file. Parameters Output (only) selected columns of the Parameter Defaults table to/from a CSV file. ParameterDefaults Output/Input all columns of the Parameter Defaults table to/from a CSV file. Selections TestInfo TestPoints Thresholds Output/Input the Selections table to/from a CSV file. Output (only) the Flight, Test and Tail Number, the Flight Date and the Archive Start and End times to/from a CSV file. Output/Input the Test Points table to/from a CSV file. Output/Input the Thresholds table to/from a CSV file. TimeSegmentLog Output/Input the TimeSegmentLog table to/from a CSV file. TestInfo command arguments: Arg1 - Export or Import Arg2 - TestInfo Type (see TestInfo Table above) Arg3 - The IADS configuration file name and path Arg4 - The CSV input or output file name and path Arg5 - [Optional for TestInfo = DataGroup] MyGroupName Arg5 - [Required for TestInfo = Parameters] True or False. True adds three columns to the output file: StartTime, EndTime and Valid, otherwise False. TestInfo run file examples: Copy/paste to a Run (Text) file to get started; change name, path, etc as applicable To use a single command in the IADS Batch Server Dialog, enter that part of the command after the = TestInfo = Export DataGroup c:\iadsposttestdata\pfconfig c:\datagroup.csv DG1 Note: There is no Import option for the TestInfo Type = DataGroup command TestInfo = Export DataGroups c:\iadsposttestdata\pfconfig c:\datagroups.csv 4

7 IADS Batch Server TestInfo = Import DataGroups c:\iadsposttestdata\import\pfconfig c:\datagroups.csv TestInfo = Export EventMarkers c:\posttestdata\pfconfig c:\eventmarkers.csv TestInfo = Import EventMarkers c:\posttestdata\import\pfconfig c:\eventmarkers.csv TestInfo = Export MissionAttributes c:\iadsposttestdata\pfconfig c:\missionattributes.csv TestInfo = Import MissionAttributes c:\iadsposttestdata\import\pfconfig c:\missionattributes.csv TestInfo = Export Parameters c:\iadsposttestdata\pfconfig c:\parameters.csv True Note: There is no Import option for the TestInfo Type = Parameters command TestInfo = Export ParameterDefaults c:\iadsposttestdata\pfconfig c:\parameterdefaults.csv TestInfo = Import ParameterDefaults c:\iadsposttestdata\import\pfconfig c:\parameterdefaults.csv TestInfo = Export Selections c:\iadsposttestdata\pfconfig c:\selections.csv TestInfo = Import Selections c:\iadsposttestdata\import\pfconfig c:\selections.csv TestInfo = Export TestInfo c:\iadsposttestdata\pfconfig c:\testinfo.csv Note: There is no Import option for the TestInfo Type = TestInfo command TestInfo = Export TestPoints c:\iadsposttestdata\pfconfig c:\testpoints.csv TestInfo = Import TestPoints c:\iadsposttestdata\import\pfconfig c:\testpoints.csv TestInfo = Export Thresholds c:\iadsposttestdata\pfconfig c:\thresholds.csv TestInfo = Import Thresholds c:\iadsposttestdata\import\pfconfig c:\thresholds.csv TestInfo = Export TimeSegmentLog c:\iadsposttestdata\pfconfig c:\timesegmentlog.csv TestInfo = Import TimeSegmentLog c:\iadsposttestdata\import\pfconfig c:\timesegmentlog.csv TestInfo command line example: TestInfo commands executed on the application command line have a / to designate the command /TestInfo Export EventMarkers c:\iadsposttestdata\pfconfig c:\eventmarkers.csv 5

8 IADS Help 1.3. Search Command The Search command is used to output event times from a single IADS test set or multiple IADS test sets to a CSV file. Any conditional statement that is valid in IADS can also be used as an equation in the Search command. Also, start and stop times can be specified to search a particular subset of data. Search command arguments: Arg1 - The IADS configuration file name and path Arg2 - Equation - The events returned when the equation is True. Multiple equations or those with spaces must be enclosed in quotations. See the Search examples below. Arg3 - Transition Only: True or False. True - One event for each instance the equation is True. False - All events where the equation is True. TrueFalse - The start and end times only of the condition. Arg4 - Output File - the CSV output (results) file name and path; or STDOUT. Arg5 - [Optional] TestInfo File - TestInfo generated CSV file with start and stop times defined. - Or - Arg5 - [Optional] IRIG Start Time. Arg6 - [Optional] IRIG Stop Time. Note: When executing a multi-test search, enter the folder name for the IADS post test data, not the IADS config file name. For example, Search = c:\iadsposttestdata C001_03<0 True c:\test\search4.csv Search run file examples: Copy/paste to a Run (Text) file to get started; change name, path, etc as applicable To use a single command in the IADS Batch Server Dialog, enter that part of the command after the = Search = c:\iadsposttestdata C001_03<0 True c:\test\search.csv Search = c:\iadsposttestdata\pfconfig "C001_03>2305 && IN001_10>0.25 && C001_04!=0" True c:\test\search.csv Search = c:\iadsposttestdata\pfconfig "(C001_03 > 2305) && (IN001_10 > 0.25) && (C001_04!= 0)" True c:\test\search.csv Search = c:\iadsposttestdata\pfconfig C001_02>0 TRUEFALSE c:\test\search.csv Search command line example: Search commands executed on the application command line have a / to designate the command /Search c:\iadsposttestdata\pfconfig "(C001_03 > 2305) && (IN001_10 > 0.25) && (C001_04!= 0)" True STDOUT 6

9 IADS Batch Server Search output file example: 1.4. DataExport Command The Export command can be used to output parameter data within the user specified time segments. Export Type CSV Time Segment(s) IRIG Start Time IRIG Stop Time Description Outputs parameters to a CSV file. One time segment. IRIGStartTime and IRIGStopTime arguments in the command line. CSV TestInfo File Output parameters to individual CSV files; one for each time segment. Processes more than one time segment using IRIG start and stop times from a CSV output file that was created from a TestInfo command. IADS IRIG Start Time IRIG Stop Time Output parameters to individual IADS data files (.iadsdata) within the specified folder. One time segment. IRIGStartTime and IRIGStopTime arguments in the command line. IADS TestInfo File Output parameters to IADS data files (.iadsdata). This option will create a compacted form of IADS data where multiple time segments are appended into a single parameter file. Processes more than one time segment using IRIG start and stop times from a CSV output file that was created from a TestInfo command. Matlab IRIG Start Time IRIG Stop Time Outputs parameters to a Matlab (.mat) file. One time segment. IRIGStartTime and IRIGStopTime arguments in the command line. Matlab TestInfo File Output parameters to individual MAT files; one for each time segment. Processes more than one time segment using IRIG start and stop times from a CSV file that was created from a TestInfo command. DataExport command arguments: Arg1 - IADS Config File - The IADS config file name and path Arg2 - Export Type CSV (.csv) or IADS (.iadsdata) file Arg3 - Parameters Only one of the following options can be specified in the command: Option 1: The Data Group you want to export; and export options [optional]. Option 2: A comma separated list of parameters; and export options [optional]. The format is <Parm1,Parm2,...> <CSV export options> (note the two are pipe-separated). 7

10 IADS Help Option 3: A 'TestInfo' DataGroup generated CSV file (DataGroup.csv) Arg4 - Time - Only one option can be specified in the command: Option 1: IRIG Start Time and IRIG Stop Time of the data you want to export Option 2: The TestInfo CSV file name and path. Processes more than one time segment using IRIG start and stop times from a CSV output file generated from one of the TestInfo commands. Option 3: A Search command generated CSV file, name and path. Arg5 - Output File - The output (results) file name and path; or STDOUT. If you selected IADS as the Export Type in arg2, enter a folder name (not file name) for this argument; IADS data files will be created for each parameter in the data group in the specified folder. DataExport run file examples: Copy/paste to a Run (Text) file to get started; change name, path, etc as applicable To use a single command in the IADS Batch Server Dialog, enter that part of the command after the = DataExport = c:\posttestdata\pfconfig CSV DataGroup 001:00:01: :00:01: c:\dataexport DataExport = c:\posttestdata\pfconfig CSV DataGroup c:\testpoints.csv c:\dataexporttestpoints.csv DataExport = c:\posttestdata\pfconfig CSV Parm1,Parm2,Parm3 \TriggerParam=* 001:01:00: :01:01:00.00 c:\dataexport DataExport = c:\posttestdata\pfconfig IADS DataGroup 001:00:01: :00:01: c:\dataexport DataExport = c:\posttestdata\pfconfig IADS DataGroup c:\testpoints.csv c:\dataexport DataExport = c:\posttestdata\pfconfig Matlab DataGroup 001:00:01: :00:01: c:\dataexport.mat DataExport = c:\posttestdata\pfconfig Matlab DataGroup c:\testpoints.csv c:\dataexporttestpoints.mat Command line examples: DataExport commands executed on the application command line have a / to designate the command /DataExport c:\posttestdata\pfconfig CSV "AB1001X,AB1002X,AB1003X \DataPrecision=4\SampleRate=10\NoDataText=None" 001:00:00: :00:00: c:\dataexport.csv 8

11 IADS Batch Server Example output directory: CSV file output: 9

12 IADS Help 1.5. Config Command The Config command can import or export IADS Analysis Windows or Desktops from and IADS configuration file. Config Import command arguments: Arg1 - Import Arg2 - The IADS config file name and path that you want to import the Analysis Window or Desktop into Arg3 - Type - AW (Analysis Window) or DT (Desktop) Arg4 - The Analysis Window.iadsAw or Desktop.iadsDt file name and path Arg5 - [Only used if Arg3 = AW] The Desktop name that you want to import the Analysis Window into Config Import run file examples: Copy/paste to a Run (Text) file to get started; change name, path, etc as applicable To use a single command in the IADS Batch Server Dialog, enter that part of the command after the = Config = Import c:\posttestdata\pfconfig AW c:\status.iadsaw Desktop1 Config = Import c:\posttestdata\pfconfig DT c:\desktop1.iadsdt Config Export command arguments: Arg1 - Export Arg2 - The IADS config file name and path Arg3 - Type - AW (Analysis Window) or DT (Desktop) Arg4 - The name of the Analysis Window or Desktop. To specify more than one Analysis Window or Desktop separate the names with a pipe (no spaces) Arg5 - Output Directory - The CSV output (results) directory name and path Config Export run file examples: Copy/paste to a Run (Text) file to get started; change name, path, etc as applicable To use a single command in the IADS Batch Server Dialog, enter that part of the command after the = Config = Export c:\posttestdata\pfconfig AW Status c:\test Config = Export c:\posttestdata\pfconfig DT Flutter c:\test Command line examples: Config commands executed on the application command line have a / to designate the command /Config Import c:\posttestdata\pfconfig DT c:\desktop1.iadsdt /Config Export c:\posttestdata\pfconfig AW Status c:\test 10

13 IADS Batch Server 1.6. Archive Command This command only supports IADS data files that have the extension '.iadsdata'. Note: Arguments that contain spaces must be enclosed in quotations "a b c d". Archive Type Combine Split Convert Merge Description Combines multiple data directories into one large data set. The process will combine Param1, Param2, Param3 in InputFolder1, with Param1, Param2, Param3 in InputFolder2, and so on. Any data files that do not match, for example ParamX, will get copied to the output directory as is. Please refer to the rules below. Splits a time slice of data from an existing data archive and copies it to the specified destination folder. Converts an IADS data file to or from an IADS ASCII text file. This may be useful for use in other programs or for visual inspection of data values. Merges any TPP or IAP parameters from multiple data directories into a single periodic data set. The process will combine Param1, Param2 and their PDT information from InputFolder1, Param3, Param4 and their PDT information from InputFolder2, and so on; into a designated output folder. It is recommended to merge data with similar start and end times. Combine Archive Combine command arguments: This command combines multiple data directories into one large data set. The process will combine Param1, Param2, Param3 in InputFolder1, with Param1, Param2, Param3 in InputFolder2, and so on. Any data files that do not match, for example ParamX, will get copied to the output directory as is. Please refer to the rules below. Arg1 - Combine Arg2 - Output folder - The output directory name and path for all the combined data sets Arg3 - InputFolder1 with config - The directory name and path for the 'master' data set, for example, c:\posttestdata\folder1\pfconfig. All files from this folder (config file, auxiliary files, etc.) will get copied to the Output folder Arg4 - InputFolder2 - The directory name and path of Folder2 (should contain the same data files/parameters as Folder1) Arg5 - InputFolderN - The directory name and path of InputFolderN (should contain the same data files/parameters as Folder1, Folder2, etc.) Rules: 1. The first input folder is considered the "master" dataset and all of the files from that folder (config, auxiliary files, etc.) will get copied over to the output directory. The data files in the resulting dataset will be aperiodic or multi-periodic files that reflect the data from each input folder. 2. To get a valid multi-periodic data file for each parameter, the data in each input folder must match ; contain the same list of data files (parameters) in each input folder. 3. The time slices of data in each input folder must increase from input folder to input folder. This means that the end time of the data in InputFolder1 must be less than the 11

14 IADS Help start time of the data in InputFolder2, the end time of InputFolder2 must be less than the start time of the data in InputFolder3, etc. Archive Combine run file example: Copy/paste to a Run (Text) file to get started; change name, path, etc as applicable To use a single command in the IADS Batch Server Dialog, enter that part of the command after the = Archive = Combine c:\posttestdata\combinedata c:\posttestdata\folder1\pfconfig c:\posttestdata\folder2 c:\posttestdata\folder3 Archive Combine command line example: Archive commands executed on the application command line have a / to designate the command /Archive Combine c:\posttestdata\combinedata c:\posttestdata\folder1\pfconfig c:\posttestdata\folder2 c:\posttestdata\folder3 Split Archive Split command arguments: This command splits a time slice of data from an existing data archive and copies it to the specified destination folder. The directory structure of the source archive is preserved; only the length of time is changed. Arg1 - Split Arg2 - Data directory with config. The directory name and path for the data set, for example, c:\posttestdata\pfconfig Arg3 - IRIG start time Arg4 - IRIG stop time Arg5 - Output folder - The output directory name and path for the new data set Archive Split run file example: Copy/paste to a Run (Text) file to get started; change name, path, etc as applicable To use a single command in the IADS Batch Server Dialog, enter that part of the command after the = Archive = Split c:\posttestdata\pfconfig 001:00:01: :00:01: c:\newdataset Archive Split command line example: Archive commands executed on the application command line have a / to designate the command /Archive Split c:\posttestdata\pfconfig 001:00:01: :00:01: c:\newdataset 12

15 IADS Batch Server Convert Archive Convert command arguments: This command converts an IADS data file to or from an IADS ASCII text file. This may be useful for use in other programs or for visual inspection of data values. Arg1 - Convert Arg2 - The folder name and path containing the IADS data files to convert Arg3 - The list of parameter files to convert. Only one option can be specified in the command: Option 1: A comma separated list of parameter names Option 2: A 'DataGroup' file created by the IadsBatchServer Option 3: An asterisk * to denote all files in the specified folder Arg4 - The conversion method. Only one option can be specified in the command: Option 1: ToAscii - Convert an IADS data file to the equivalent IADS ascii file Option 2: FromAscii - Convert an IADS ascii file to the equivalent IADS data file Arg5 - Output folder - The output directory name and path for the converted files Arg6 - True or False - Enter True to verify the ASCII file by converting it back to an IADS binary data file and doing a byte compare with the source IADS data file; otherwise False (default) Archive Convert run file example: Copy/paste to a Run (Text) file to get started; change name, path, etc as applicable -To use a single command in the IADS Batch Server Dialog, enter that part of the command after the = Convert some IADS data files to ASCII, then back to IADS data files (verification active (True)): Archive = Convert c:\sourcedata Parm1,Parm2,Parm3 ToAscii c:\asciidata True Archive = Convert c:\asciidata Parm1,Parm2,Parm3 FromAscii c:\asciidata True Convert a folder of data files to ASCII, then back to IADS data files (no verification (False)): Archive = Convert c:\sourcedata * ToAscii c:\asciidata True Archive = Convert c:\asciidata * FromAscii c:\asciidata True Convert parameters specified in a TestInfo = DataGroup generated csv file to ASCII, then back to IADS data files: Archive = Convert c:\sourcedata c:\datagroup.csv ToAscii c:\asciidata False Archive = Convert c:\asciidata * FromAscii c:\asciidata False Archive Convert command line example: Archive commands executed on the application command line have a / to designate the command /Archive = Convert c:\sourcedata * ToAscii c:\asciidata True /Archive = Convert c:\asciidata * FromAscii c:\asciidata True 13

16 IADS Help Merge Archive Merge command arguments: Merges any TPP or IAP parameters (not available for derived parameters) from multiple data directories into a single periodic data set. The process will combine Param1, Param2 and their PDT information from InputFolder1, Param3, Param4 and their PDT information from InputFolder2, and so on; into a designated output folder. It is recommended to merge data with similar start and end times. Arg1 - Merge Arg2 - Output folder - The output directory name and path. This directory should not contain any config files or data (empty directory). The config files you specify in the following arguments will be merged into a single config file, in this directory. Arg3 - Master config - The file name and path of the 'master' config. The config file and all data in this 'master' directory will be copied to the specified output directory in Arg2. No parameter options are allowed for this argument. Arg4 - InputConfig1 - The file name and path of the first input config. 14 Note: Options can be combined. All options follow the command with a pipe separator (see example below). Option 1: \Parameters - A comma separated list of parameter names, for example, \Parameters=Param1,Param2,Param3 (if no parameters are defined, all parameters (except derived) will be copied to the output folder config) Option 2: \Datagroup - A DataGroup name defined in the Parameter Defaults Table, for example, \DataGroup=ABCD (if a datagroup is not defined, all parameters (except derived) will be copied to the output folder config) Option 3: \Prefix - Prepends a string to the beginning of each parameter that you specify, for example, \Prefix=1_ Option 4: \Suffix - Appends a string to the end of each parameter that you specify, for example, \Suffix=_B Arg5 - InputConfigN - The file name and path of the Nth input config. Parameter options: As defined in Arg4. Archive Merge run file example: Copy/paste to a Run (Text) file to get started; change name, path, etc as applicable To use a single command in the IADS Batch Server Dialog, enter that part of the command after the = Merge = Merge "c:\posttestdata\mergeoutput" "c:\posttestdata\masterset\pfconfig" "c:\posttestdata\config1\pfconfig \Parameters=Param1,Param2,Param3\Suffix=_1" "c:\posttestdata\config2\pfconfig \DataGroup=ABCD\Suffix=_2" Archive Merge command line example: Merge commands executed on the application command line have a / to designate the command /Archive Merge "c:\posttestdata\mergeoutput" "c:\posttestdata\masterset\pfconfig" "c:\posttestdata\config1\pfconfig \Parameters=Param1,Param2,Param3\Suffix=_1" "c:\posttestdata\config2\pfconfig \DataGroup=ABCD\Suffix=_2"

17 IADS Batch Server 1.7. Statistic Command (Work in Progress) 1.8. DataImport Command DataImport command arguments: Arg1 File type: CSV is the only supported format at this time. Arg2 - InputFile - The file name and path of the input file and optional import options (the input file and the export options are separated by a pipe, see the run file examples shown below). Valid options include: \Delimiter - Determines what delimiter (single character) will be used to parse the file. Any single character may be used as a delimiter. You may also specify a tab delimiter by using the keyword TAB, or a space delimiter by using the keyword SPACE. The default delimiter if this property is not specified is a comma (,). \NumHeaderRows - The number of rows in the file header that will be skipped to get to the data. Default is 0 if this property is not specified. \TimeColumn - The 1-based column index where time is present in the file. Default is 1 if this property is not specified. \StartTime - User-specified IRIG start time of the output files. If this property is not specified, the start time will be read from the input file based on the specified TimeColumn. \SampleRate - User-specified sample rate of the output files. If this property is not specified, the sample rate will be calculated based on the times in the specified TimeColumn of the input file. \Custom Custom data import formats supported by the IADS Batch Server. Currently the following formats are supported: DGPS (Differential Global Positioning System). For example, c:\datafileimport \Custom=DGPS Arg3 - Output folder - The output directory name and path. DataImport run file examples: Copy/paste to a Run (Text) file to get started; change name, path, etc as applicable To use a single command in the IADS Batch Server Dialog, enter that part of the command after the = DataImport = CSV c:\myinputfile.csv c:\iadsoutputfolder DataImport = CSV c:\data File Import \TimeColumn=2\NumHeaderRows=10 c:\outputfolder DataImport = CSV c:\data File Import \Custom=DGPS c:\outputfolder Note: Arguments that contain any spaces must be enclosed in quotations to avoid Batch Server processing errors. DataImport command line example: DataImport commands executed on the application command line have a / to designate the command /DataImport CSV c:\myinputfile.csv c:\iadsoutputfolder 15

18 IADS Help /DataImport CSV c:\myinputfile \TimeColumn=2\NumHeaderRows=10 c:\outputfolder /DataImport CSV c:\myinputfile \Custom=DGPS c:\outputfolder 1.9. Data Group Setup and Export Options Defining a data group in advance allows you to export data for multiple parameters easily. To setup a data group in IADS: 1. On the Dashboard, click Configuration. 2. Click the Data folder > DataGroups table. 3. [Optional] Enter a Group name (SubGroup and User are not currently implemented). This Group name must be the same as your Desktop Group name and only those in that group will be able to see the data group. Leaving the Group field empty allows all users to see the data group. 4. Enter a unique identifier in the Name column, for example, DataGroup1. 5. Enter the parameters that you want to export as a group in the Parameters column. The Parameter Selection Tool is useful for this purpose. 6. [Optional] Enter data group export options in the Property Bag (see the table below). 7. Save the table. Note: DataGroup export options apply to all the parameters defined in that data group (export). To add or change an Export Default Option: 1. Click the Data folder > DataGroups table. 2. In the Name column enter ExportDefaults. 3. In the PropertyBag column of this row, enter one or more options (see table below). For example, \\TimeFormat=IrigString\\DataPrecision=2. 4. Save the table. [Example] To add a decimation factor export option to a DataGroup: 1. Click the Data folder > DataGroups table. 2. On the row containing the data group, in the PropertyBag column, enter \\DecimationFactor=2 (substitute 2 with your own factor). The decimation factor value determines how many point will be skipped from the highest sample rate in the Data Group. For example, 1 = every data point, 2 = every second data point, etc... If the largest sample rate of all parameters with the Data Group was 1000 samples per second and the decimation factor was 2, the data export would produce a value every 1/500 of a second (Note: An anti-aliasing Low Pass filter is recommended prior to decimation). 3. Save the table. 16

19 IADS Batch Server Export Options DataGroup export options apply to all the parameters defined in that data group (export). Option Name and Option Value Option Default Option Example Purpose Decimation Factor - Allows decimation of exported data by a given factor. Integer >1 1 \\DecimationFactor=3 DefaultExportDirectory - A valid directory name Current \\DefaultExportDirectory= Specifies initial directory with backslash Directory c:/temp/directory of export methods that output data files. characters converted to forward slashes DisableFilters - Disables True or False False \\DisableFilters=True filtering. HeaderFormat - Specifies the format type of the header. HeaderRows - Specifies multiple header rows. Filter - Specifies a filter that is applied to all the parameters in the data group on export. Note: To correctly enter the \\Filter... in the property bag cell, apply the desired filter settings to a Stripchart with data, hint on the title to view the filter. NameModification - Modifies name. NamingMethod - Uses various naming methods. SampleRate - Specifies a target or parameter sample rate (overrides decimation factor). Note: prior to downsampling, an anti-aliasing low pass filter is recommended. TimeFormat - Specifies format of time. None, ParamNames, QuotedParamNames Any ParameterDefaults table column heading name(s) BW (Butterworth), Pass Type, FC1, FC2 (not for low pass), Order; EL (Elliptic), Pass Type, Stop-Pass, Pass- Stop, Ripple, Order None, AllCharsToUpper, AllCharsToLower ParameterName, ShortName, LongName Floating Point Value >0.0, ParameterName ParamNames None None None Parameter Name Highest sample rate of data group None, IrigString, IrigString SecondsSinceMidnight, (For Matlab, SecondsSince \\HeaderFormat=None \\HeaderRows=Parameter, Units, DataSourceType \\Filter=BW,BP, ,2 \\Filter=BW,LP,30.0,2 \\Filter=EL,BP, , ,0.01,2 \\NameModification= AllCharsToUpper \\Namingmethod= ShortName \\SampleRate= \\SampleRate=AB1001X \\TimeFormat= SecondsSinceNewYear 17

20 IADS Help TimePrecision - Specifies number of digits past decimal point for time output. 18 SecondsSinceNewYear, Midnight) NanosSinceNewYear (automatically calculates the level of precision from 3-9 based on the highest sample rate of the export.) 3 None \\TimePrecision=5 \\TimePrecision=-1 TriggerParam - Sets the Trigger parameter name None \\TriggerParam= export sample rate for the * (Batch Server only - * ParameterName data group based on the trigger parameter Aperiodic data export that triggers on all \\TriggerParam=* specified. If not specified parameters; every time the periodic parameter with the highest sample rate will be used; If no periodic parameters the point is exported for every parameter, at the rate it occurs in the data file - no sampling). SPS is 50. Excel Only: ExcelMaxRows - Specifies maximum number of rows To export to Excel \\ExcelMaxRows=10000 ExcelMaxRowsMethod - LimitToMax, LimitToMax \\ExcelMaxRowsMethod= Specifies an action when AppendNewWorksheet, AppendNewWorksheet maximum rows exported AppendNewWorkbook to Excel is exceeded. ExcelStatementToRun - Any valid Excel macro None \\ExcelStatementToRun= Executes this Excel MacroToRunAfterExport macro after Data Group has been exported. CSV Only: DataPrecision - Specifies \\DataPrecision=3 number of digits past decimal point for floating point values NanText - If active check Nan None \\NanText=Nan for _finite and then output specific text. SeparatorChar - To allow alternative separator characters such as ; Any ascii character, \\Separatorchar=; NoDataText - To replace Any text/string Blank \\NoDataText=String a cell with 'no data' to the specified text/string. (EmptyString) Matlab Only:

21 IADS Batch Server MatlabExportMethod - Specifies that the export to Matlab will create a "Mat" file or be sent directly to the Matlab application. Name - Sets the exported Matlab matrix name when MatlabExportType= Matrix. ExtendedInfo Adds an export string with information such as time, sample rate, and parameter names. MatlabExportType - Produces either a Matrix of all Data Group parameters or separate vectors. MatlabFile, DirectlyToMatlab Any valid Matlab variable name DirectlyToMatlab None \\MatlabExportMethod= MatlabFile \\Name= MatlabMatrixName None, Minimal Minimal \\ExtendedInfo=None Vector, Matrix Matrix \\MatlabExportType= Vector MatlabStatementToRun Any valid Matlab None - Executes this Matlab command command after Data Group has been exported. MatlabExportShape - Columnwise, Rowwise Columnwise Outputs the vectors and matrices in a column wise format. MatlabMaxRows - Integer number of max Specifies Max Number of rows > 0 Rows To Export to Matlab. MatlabMaxRowsMethod LimitToMax - Specifies an action AppendNewFile when max rows export is exceeded. 0 (limited only by memory) LimitToMax \\MatlabStatementToRun= Surf(MatlabMatrixName) \\MatlabExportShape= RowWise \\MatlabMaxRows= \\MatlabMaxRowsMethod= AppendNewFile 19