********************************************************* ********************************************************* Hierarchical Data from Igor HieDI 1.1.2 Jimenez Lab, University of Colorado at Boulder Released 14-November-2005 ********************************************************* ********************************************************* This program converts .itx and .bin data files acquired on the Aerodyne Time-of-Flight Mass Spectrometer to Hierarchical Data Format (HDF). The current release is intended for use with MS and PToF data acquired with ToF-AMS Acquisition software versions 1.4 and earlier. Data filenames must include acquisition dates. BFSP data cannot be converted. The format of the generated HDF files is identical to that of the HDF files that will be written in real-time from ToF-AMS Acquisition software versions 1.5 and later. A single HDF file contains many runs. Data within the file is sorted into datasets, such as "InfoVal," "ParVal," and "MSopen." The layers of these datasets are the individual runs. All HDF data can be viewed and processed using the HDF5XOP available with IgorPro 5.04 ******************** INSTALLATION ******************** The .net framework must be installed before running HDFwriter. Note that if you are running the ToF-AMS data analysis software, the framework is already installed. If not, the framework is available at: http://msdn.microsoft.com/netframework/default.aspx HieDI_vXXX.exe should be saved to the same directory as ToF_AMS_vXXX.exe files, which is typically: C:\Program Files\ToFAMS\ToFAMSAcq HieDI requires a set of dlls, which should be saved to the same directory as HieDI_112.exe. These can be downloaded from: http://cires.colorado.edu/jimenez-group/ToFAMSResources/ToFSoftware/Downloads/Supplemental/Required_HDF_dlls.zip ******************** USE ******************** The set of .itx and .bin files to be converted is chosen by selecting the info.itx files corresponding to the first and last runs of interest. Run numbers within the desired set of files do not need to be contiguous and the set of files can cover multiple dates. But, info.itx must exist for all runs to be converted. PToF.bin cannot be accurately converted without an associated PToF.itx file The status of the conversion process is tracked with labels indicating the current HDF File, the current Run Number being converted, and the total sizes of the Main and PToF HDF files. A given HDF file will be written to until either the PToF file size exceeds the maximum file size (defined in the "options" tab), the acquisition date changes, or the dimensions of a dataset within the file changes between runs (e.g., the MS Sticks array grows or shrinks). The destination directory for converted HDF data is defined in the "options" tab. The sub-directories \Main and \PToF will automatically be created within the destination directory. Created HDF file names include the acquisition date, the first run number written to the file (as 6 digits), and the type of data in the file (p = ptof, m = main). As an example, writing to the destination directory C:\ToFAMS\ToFAMSData\HDFConvertData and starting the conversion with file 103105_100_Info.itx will generate C:\ToFAMS\ToFAMSData\HDFConvertData\Main\103105_000100_m.hdf C:\ToFAMS\ToFAMSData\HDFConvertData\PToF\103105_000100_p.hdf _m.hdf files include the datasets: InfoVal,ParVal, RunInfo, MSSDiff, MSDiff, MSopen, and ptof_stick _p.hdf files include the datasets: InfoVal,ParVal, RunInfo, and PToF Datasets MSSDiff, MSDiff, MSopen, ptof_stick, and PToF are given extensions to indicate the ToF type. - No extension corresponds to c-ToF - "_v" corresponds to v-ToF - "_w" corresponds to w-ToF An HDF file may contain both _v and _w datasets The dataset RunInfo contains rows describing the acquisition runs written to the extendible data sets. - Column 1 contains the Run Number - Column 2 contains the Year - Column 3 contains the Julian Day - Column 4 contains the seconds after midnight - Column 5 contains the ToF type (0=c, 1=v, 2=w; For older data, where ToF type was not included in ParVal, HieDI will output NaN) - Column 6 contains a value representing the count of the defined ToF type in the current HDF File (used for Squirrel Indexing)