DataView - Data Converter User Manual

Transcription

1 Manual Pg. 1/8 Manual Rev. Data Notes /07/2005 First issue

2 Manual Pg. 2/8 Index 1 Introduction Limits Description CFG file configuration Data converted import on DataView Explorer...8

3 Manual Pg. 3/8 1 Introduction The tool is designed to convert the data acquired with generic systems (csv, ascii) in the way to be imported by DataView. It works either on a single or nested directories; in this last case it is possible to adopt a recursive policy and keep the source directories structure. In order to convert a generic file format, it is needed to prepare a custom configuration file (*.CFG), that must be selected by the user before to start the converting process. The user interface allow to select: the source directory, the configuration file and the destination directory. Anytime the tool is launched, it opens automatically opens the last CFG file. At each iteration, the tool converts all the files contained into the source directory using a single file format, depending on the CFG file chosen by the user. Each source file is converted into a destination DTX file, that will maintain the same name as the original one. 1.1 Limits in order to be compliant with DataView, the maximum number of channels in the source files is 1024 if the original sampling frequency of channels is not foreseen by DataView, the converting tool modifies it to the closest higher value managed by DataView XLS data format converting is not foreseen, it is needed to convert them into ASC format The tool doesn t allow to change the original name of channels. 2 Description The tool DVAsciiToBIN allows to convert CSV and ASCII format files into DTX format files relying on the content of the configuration file (*.CFG). The user interface allows to select the converting process scope: single file or entire directory. In case of entire directory: it is possible to activate the scan of subdirectories by activating the relevant flag the tool shows the status of the converting process by indicating the statistics concerning the converted or ignored files. By Browse buttons it is possible to select File/Directory to be converted and the configuration file (*.CFG). At startup, the tool automatically consider the last selected CFG file. Each CFG file is configured using custom keys in order to define the features of the data file format to be converted.

4 Manual Pg. 4/8 PS: to obtain auxiliary information like measurement unit of the channels, it is possible to activate Export information to Parameters function. In this case, the converter generate a *.set file that must be renamed in Channel.set and copied into the Setup directory where Dataview Explorer has been installed. Once selected the configuration and data files, user must activates Export command and defines the destination file name: It is possible to use program by command line with this syntax: DVAsciiTOBin -s FilePath -c FilePath -o FilePath [/p] [/d] [/tree] [/makedtx]

5 Manual Pg. 5/8 Parameters: -s Source text file -c Config file (.CFG) -o Output file (.DTX) [/p] if preset, program makes the "Parameters" file [/d] if present, program convert whole directory [/tree] if present, program converts all the data file stored in the subdirectory [/makedtx] if present, program makes DTX file automatically 2.1 CFG file configuration Converter versatility is guaranteed by using a configuration file for the data format (.CFG), where are stored all the necessary information for data management; so it is necessary to create a.cfg file for each data format. The foreseen keys in according to the characteristics of the data format are the following: Channels properties System foresees the possibility to defined the channel name and the channel measurement unit in two ways: a) automatic import of the data file by using the following keys (default): CHPROPERTY=name_row,unit_row where: name_row represent the row number where are stored channels name (default if key is absence: nn=0). unit_row represent the row number where are stored the strings which defined the channles measurement unit (default if key is absence: nn=0). b) manual definition by using the following syntax: CHNAME01=name_string,unit_string CHNAME02=name_string,unit_string.. CHNAMEnn=name_string,unit_string In case of name_string is not programmed, system uses name Ch01, Ch02,, Chnn. In case of unit_string is not programmed, system uses. Notes: - if CHPROPERTY is present, system uses automatic modality; - in automatic modality, measurement unit import is management only in case of unit_row is present; otherwise, the channels measurement unit are programmed to default value ; - in case of the above-mentioned keys are absence, system uses automatic modality with default values; - in manual modality, the property of the channels do not have CHNAMEnn key are programmed to default values; Row and Column number of data start DATASTART=nn_row,nn_col where: nn_row represent the row number (default if key is absence: nn=0) nn_col represent the column number (default if key is absence: nn=0) Note: converter return error only if this key is programmed with a non-numerical value; on the contrary, if the value of this key is not integer, converter makes an approximation by excess.

6 Manual Pg. 6/8 Channels frequency and/or Base Time channel In case of user wants to specify the data frequency (base frequency) it is needed to use this key: CHFREQ=ff where: ff represent a number to specify frequency in [Hz] (default if key is absence: ff=1000) On the contrary, if user wants to use a channel specified into the data file as a base time channel (base time), above-mentioned key must be omitted and replaced with the following key: TIMECH=name, value where: name represent channel name value represent a number to specify measurement unit of the channel name in [ms] (default if key is absence: value = 1000) In case of the CFG file contains TIMECH key, it is possible to define its separator with another key called TIMECHSEPARATOR. Characters allowed as separator are:. (default), -, :,. System foresees a fixed parameters management in both modality: base frequency and base time.. PS: Channel particular formats management is not foresee. Notes: - it is necessary to foresee one of the above-mentioned keys in the CFG file. - the second parameter of the TIMECH key describes the ms number of the time channel measurement unit so if the CFG file reports TIMECH=TIME,1000 it means that TIME field is worded in 1000ms and so in seconds. - in case of the TIMECH key is present, channels acquisition frequency is calculated by the variation of a sample and the next one of the time channel. Separator character of the data DELIMITER=string where: string {TAB ; :, } (default if key is absence: string=tab) Note: To use space character or a group of characters which contain the space one as separator, it is necessary to contain these ones between apostrophes ( ex. indicate DELIMITER=''). In case of other separators are present, the apostrophes are not foresee. ( ex.: DELIMITER=; ) In case of data file contains a multiple separator (ex: more space), it is necessary add the following key to the CFG file: DISCARDMULTISEP = x where: x can assume value 0 (function Disabled) o 1 (function Enabled). Data column number User can define the significant column number of the data file using the following key: NUMCH=value if key is absence program foresee an automatic identification of the data file column number.

7 Manual Pg. 7/8 TRIGGER function It is possible to select a channel for which the program proceed to divide source data file into more DTX with the following key: TRIGGERCH=name,value where: name represent channel name value represent a number to specify the threshold Converter makes data separation when, once the threshold is exceeded, the field value come back fixed to 0. The functionality is enabled when both parameters are present. In case of some parameters are incomplete, program indicates syntax error. If key is absence, converter does not divide data file. NOTES: In case of system detects some syntax problem or wrong key values, converter visualizes an error window with the following message: Syntax error detected in <nomefile>.cfg at row nn. In correspondence with the definition of all the key, spaces interpolation is not allowed between key and = character and between this one and the value. Ex DELIMITER=; In a conversion from ASCII data to DTX, system uses the following default data: o Decimal number: 3 o Representation: decimal o Data type: long o Channel number : starting from index 0 in same order of the file ASCII Because of trigger functioning, converter does not allow to establish a threshold equal to zero, because it coinciding with the second threshold fixed to 0. In this case program foresees a warning message.

8 Manual Pg. 8/8 2.2 Data converted import on DataView Explorer In order to visualize DTX file on Dataview, user has two possibility: - directly copy the DTX file into Data directory of the Dataview installation path; - use Import DTX function available into the File menu. Notes: - for all the Dataview functionality see the relative Help on line;