|
|
| (91 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| − | | + | The DAQ has moved to [https://sites.google.com/site/tofamsdaq/ a new site] |
| − | [[File:AriCU.JPG|none|caption]]
| |
| − | | |
| − | | |
| − | == News ==
| |
| − | '''31-Oct-2009''' [http://cires.colorado.edu/jimenez-group/UsrMtgs/UsersMtg10/091031_DAQ_UsersMeeting_Kimmel.pdf Slides from DAQ Update] at 2009 Users Meeting
| |
| − | | |
| − | '''28-Oct-2009''' Migration to Wiki complete. All details should be current. Please repair or report any broken links.
| |
| − | | |
| − | '''29-Sept-2009'''
| |
| − | V3.0.19 beta posted. Primarily bug fixes, based on use of v3.0.16 at FLAME-3 in Montana.
| |
| − | | |
| − | '''05-Aug-2009'''
| |
| − | V3.0.16 beta posted. See notes on [[#RealTime Warning Pop-up]]
| |
| − | | |
| − | == Latest Versions ==
| |
| − | {| style="color:black; background-color:#ffffcc;" cellpadding="10" cellspacing="0" border="1"
| |
| − | !Version
| |
| − | !Date
| |
| − | !Type
| |
| − | !Release Notes
| |
| − | | |
| − | |-
| |
| − | |[http://cires.colorado.edu/jimenez-group/ToFAMSResources/ToFSoftware/Downloads/ToFAcq/ToFAMS_v303.exe '''V3.0.3''']
| |
| − | |06-March-2009
| |
| − | |Public
| |
| − | |[http://docs.google.com/View?docID=0AakKIkjDi9nmZGhwOThwNjdfNTZmNXpyMjlnZw&revision=_latest&hgd=1#Latest_Release Public Notes]
| |
| − | [http://cires.colorado.edu/jimenez-group/ToFAMSResources/ToFSoftware/Downloads/Supplemental/mxFirstInstall.pdf Notes on First mx Install]
| |
| − | | |
| − | |-
| |
| − | |[http://cires.colorado.edu/jimenez-group/ToFAMSResources/ToFSoftware/Downloads/ToFAcq/ToFAMS_v3019.exe '''V3.0.19''']
| |
| − | |29-Sept-2009
| |
| − | |Beta
| |
| − | |[http://docs.google.com/Doc?docid=0AakKIkjDi9nmZGhwOThwNjdfNTZmNXpyMjlnZw&hl=en#Latest_Beta Beta Notes]
| |
| − | |}
| |
| − | | |
| − | | |
| − | === Known Bugs in Recent Releases ===
| |
| − | | |
| − | {| style="color:black; background-color:#ffffcc;" cellpadding="10" cellspacing="0" border="1"
| |
| − | !Severity
| |
| − | !Window
| |
| − | !Description
| |
| − | !Work around
| |
| − | !Fixed In Version
| |
| − | | |
| − | |-
| |
| − | |Minor
| |
| − | |Menu Window
| |
| − | |If swap button was used, calibration group and sampling type values did not update.
| |
| − | |Change manually after swap.
| |
| − | |3.0.21+ (Not Yet Available)
| |
| − | | |
| − | | |
| − | |-
| |
| − | |Minor
| |
| − | |Acquisition Window
| |
| − | |First PTOF display inactive. Acquisition is not affected. Suspect bug appeared in roughly v3.0.15
| |
| − | |
| |
| − | |3.0.21+ (Not Yet Available)
| |
| − | | |
| − | |-
| |
| − | |Minor
| |
| − | |Bitwise
| |
| − | |Changes to MCP voltage using +/- 10V buttons are not saved to menu.
| |
| − | |Input new voltages in calibration window.
| |
| − | |Pending
| |
| − | | |
| − | | |
| − | |-
| |
| − | |Major
| |
| − | |BFSP Acquisition
| |
| − | |AS BFSP filtering never found particles.
| |
| − | |Input appropriate masses for user m/z filtering
| |
| − | |3.0.17+
| |
| − | | |
| − | |-
| |
| − | |Minor
| |
| − | |Menu Window
| |
| − | |GZip compression would turn on/off independent of check box in menu window.
| |
| − | |
| |
| − | |3.0.15+
| |
| − | | |
| − | |-
| |
| − | |Minor
| |
| − | |Acquisition Window
| |
| − | |Software crashed if acquisition was stopped in, for instance, V-mode, acquire window was exited, menu was changed to W-mode using arrows on front panel, and acquisition was restarted.
| |
| − | |
| |
| − | |3.0.14+
| |
| − | | |
| − | |-
| |
| − | |Minor
| |
| − | |Acquisition
| |
| − | |Crash at save with error to the effect of "Path C:/ToFAMS/ToFAMSData/LogFiles/TimeTrace/MS/xxx_MS.itx does not exist"
| |
| − | |(i) Disable Save or RT on Avg and Saving Tab or (ii) Manually create directory ToFAMSData/LogFiles/MS
| |
| − | |3.0.10+
| |
| − | | |
| − | | |
| − | |-
| |
| − | |Minor
| |
| − | |Non-autosave (F3) PTOF HDF
| |
| − | |PTOF save with F3 has error in RunInfo dataset that prevents normal use in Squirrel.
| |
| − | |Email Joel/Donna for Squirrel fix
| |
| − | |3.0.8+
| |
| − | | |
| − | |-
| |
| − | |Minor
| |
| − | |Itx File
| |
| − | |InfoVals in itx files later than version 3.0.0 had syntax error that prevented files from being opened in Igor.
| |
| − | |
| |
| − | |3.0.6+
| |
| − | | |
| − | | |
| − | | |
| − | |}
| |
| − | | |
| − | == Documentation ==
| |
| − | [http://cires.colorado.edu/jimenez-group/ToFAMSResources/ToFSoftware/Downloads/Supplemental/ToF-AMS_DAQ_UM_v30.pdf ToF-AMS DAQ Manual (.pdf)]
| |
| − | | |
| − | [http://docs.google.com/View?docID=0AakKIkjDi9nmZGhwOThwNjdfNTZmNXpyMjlnZw&revision=_latest&hgd=1 Release Note (Current and Archive)]
| |
| − | | |
| − | == Other Downloads ==
| |
| − | | |
| − | | |
| − | === Supplemental ===
| |
| − | | |
| − | {| style="color:black; background-color:#ffffcc;" cellpadding="10" cellspacing="0" border="1"
| |
| − | !Name
| |
| − | !Date
| |
| − | !Notes
| |
| − | !Link
| |
| − | | |
| − | |-
| |
| − | |ToF-AMS DAQ dlls
| |
| − | |
| |
| − | |Necessary for v2.2.22+
| |
| − | |[http://cires.colorado.edu/jimenez-group/ToFAMSResources/ToFSoftware/Downloads/Supplemental/ToFAMSDAQDlls.zip Download (.zip)]
| |
| − | |-
| |
| − | |CRITR 1.1
| |
| − | |
| |
| − | |Program for movement of chopper, TOF Triggering, and monitor/save of slow board voltages
| |
| − | |[http://cires.colorado.edu/jimenez-group/ToFAMSResources/ToFSoftware/Downloads/Supplemental/CRiTR_v1_1.exe Download]
| |
| − | |-
| |
| − | |DAQ QuickView Display
| |
| − | |
| |
| − | |By D. Sueper. Save to C:\ToFAMS\ToFAMSData\LogFiles\TimeTrace
| |
| − | |[http://cires.colorado.edu/jimenez-group/ToFAMSResources/ToFSoftware/Downloads/Supplemental/DAQ_QuickView.ipf Download]
| |
| − | |-
| |
| − | | |
| − | |Exact Mass File (v1.1)
| |
| − | |19-March-2007
| |
| − | |Displays list of m/z values in calibration window. Save to C:\ToFAMS\ToFAMSCode.
| |
| − | |[http://cires.colorado.edu/jimenez-group/ToFAMSResources/ToFSoftware/Downloads/Supplemental/ExactMass.csv Download]
| |
| − | |-
| |
| − | | |
| − | |Compress HDF files
| |
| − | |25-May-2009
| |
| − | |By D.Sueper. A stand-alone ipf file that compresses existing DAQ .hdf files.
| |
| − | |[http://cires.colorado.edu/jimenez-group/ToFAMSResources/ToFSoftware/Downloads/Supplemental/CompactHDFProcedure_1_0.ipf Download]
| |
| − | |-
| |
| − | | |
| − | | |
| − | | |
| − | |}
| |
| − | | |
| − | === External ===
| |
| − | | |
| − | {| style="color:black; background-color:#ffffcc;" cellpadding="10" cellspacing="0" border="1"
| |
| − | !Name
| |
| − | !Notes
| |
| − | !Link
| |
| − | |-
| |
| − | | |
| − | |Tofwerk TPS Control Software
| |
| − | |
| |
| − | |[http://www.tofwerk.com/software/ Link]
| |
| − | |-
| |
| − | | |
| − | |NI-DAQmx
| |
| − | |DAQ Requires v8.6.1
| |
| − | |[http://www.ni.com/dataacquisition/nidaqmx.htm link]
| |
| − | |-
| |
| − | | |
| − | |Acqiris Digitizer Software and Drivers
| |
| − | |Follow Link or Search "Acqiris Software" at [http://www.agilent.com/ Agilent.com]
| |
| − | |[http://www.home.agilent.com/agilent/techSupport.jspx?cc=US&lc=eng&nid=-35501.733417.00&pid=1197886&pageMode=DS Link]
| |
| − | |-
| |
| − | | |
| − | |Microsoft .NET Framework Version 1.1
| |
| − | |Follow Link or Search "Framework 1.1" at [http://www.microsoft.com/ Microsoft.com]
| |
| − | |[http://www.microsoft.com/downloads/details.aspx?FamilyID=262d25e3-f589-4842-8157-034d1e7cf3a3&displaylang=en Link]
| |
| − | |-
| |
| − | | |
| − | |}
| |
| − | | |
| − | | |
| − | == FAQs ==
| |
| − | | |
| − | === Menu Files / Settings ===
| |
| − | ==== What is Co-Adding ====
| |
| − | "Co-adds" is a user-adjustable value on the timing tab of the menu window, with relevance for PToF and Single particle modes.
| |
| − | | |
| − | As shown in the figure below, the PToF data set is a matrix with rows corresponding to TOF extractions. We call this data matrix (yellow region) the chopper block.
| |
| − | | |
| − | [[File:Ptof_coAdd.png|none|caption]]
| |
| − | | |
| − | | |
| − | The start of a chopper cycle is triggered at the moment when the chopper slit passes the axis of the particle beam. The first row row of the acquired block is the first TOFMS recorded after the chopper trigger, the second row is the second TOFMS recorded, and so on.
| |
| − | | |
| − | For Single Particle modes the block contains data for a single chopper cycle. For PToF Mode, the chopper block is the average of many chopper cycles. (The number of cycles averaged in a single file depends on dwell time and save time settings.) In all acquisition modes, full waveforms are stored in the memory of the AP240 before transfer to the PC. For PToF mode, the ADC averages multiple cycles before transfer to the PC.
| |
| − | | |
| − | Like all storage devices, the ADC has finite memory and can only store a limited amount of data. For the ToF-AMS the limit is 4M samples per acquisition. The total number of data values in the acquired block is the product of the number of samples/TOF (length of TOF waveform) and the TOF/chop (number of rows in block).
| |
| − | | |
| − | As you can see in the figure, the number of samples/TOF determines the mass range and the TOF/chop determines the particle size range. If you desire an extended mass range and/or size range the total number of samples may grow very large. The DAQ will warn you if your settings exceed 4M samples. Short of that, you should also consider that a large number of samples yields large PTOF file size.
| |
| − | | |
| − | Co-Adding allows us to extend mass and size range to a point where the product of numSamples and TOF/Chop is greater than 4M, while keeping the memory used on the AP240 (and the number of samples in the data file) below 4M samples.
| |
| − | | |
| − | To understand co-adds, we differentiate between the acquisition block from the save block, as shown in the second part of the figure above. Both blocks will have number of columns equal numSamples, but the co-add blocks has a reduced number of rows. Specifically, the number of rows = (TOF/chop)/2. It accomplishes this by averaging successive TOF/extraction within the block.
| |
| − | | |
| − | The advantage of co-adding is the ability to acquire PToF data across large mass and/or size range with reduced ADC memory usage. This is mandatory in some circumstance. And, in all situations it will improve efficiency (less data to transfer and write to disk) and reduce file size.
| |
| − | Keep in mind, though, that the because co-adding averages successive rows of the acquired block, the resolution of the PToF measurement is reduced.
| |
| − | | |
| − | ==== Why is the calculated max particle size 0 nm in timing display ====
| |
| − | | |
| − | Max size = 0 is returned due to a nonsensical calculation. In particular, calculated particle size becomes negative if
| |
| − | | |
| − | [(VelGas - VelGasInLens) / (VelParticle - VelGasInLens)] - VelGasInLens < 1
| |
| − | | |
| − | This does not indicate a problem with your configuration, rather it indicates that the size range cannot be properly calculated.
| |
| − | | |
| − | === Acquisition Window ===
| |
| − | | |
| − | ==== RealTime Warning Pop-up ====
| |
| − | | |
| − | Users frequently have RealTime data save enabled without realizing it.
| |
| − | | |
| − | This includes the RT.txt and TimeTrace.txt file types. Save of these files does not degrade performance. But, if save of either file type is enabled for a long time without attention, the text files can consume a significant amount of disk space, for no good reason.
| |
| − | | |
| − | Beginning with v3.0.16, the DAQ will alert you if (1) Both files types are enabled (2)A large number of unprocessed RT files exist and/or (3) The active TimeTrace file is growing too large.
| |
| − | | |
| − | At the load of the acquisition window, the DAQ check current settings and file sizes. If condition (1),(2), or (3) is met, the pop-up window shown below will appear. From this window, you can clear existing RT files, turn file saves on/off, and start a new TimeTrace.txt file.
| |
| − | | |
| − | === Data Files ===
| |
| − | | |
| − | === BitWise ===
| |
| − | ==== What is the proper Baseline bit value ====
| |
| − | The AP240 Settings Tab and BitWise include a rarely touched value called "Baseline Bits." Before explaining how to set it, we need to review the basics of the ADC. In particular, the terms Full Scale, Offset, and Baseline.
| |
| − | | |
| − | Paraphrasing the manual (Section: Menu Window->AP240 Setting Tab) :
| |
| − | | |
| − | Full Scale
| |
| − | The AP240 digitizes signals with 255 bits of resolution. The full scale voltage range is user-adjustable and is set based on the amplitude of the largest signal of interest ...
| |
| − | | |
| − | Offset
| |
| − | By default, the board centers its full scale voltage range on 0V, in order to record positive and negative voltages of equal amplitude. The offset setting allows the user to adjust the relative position of the voltage window to better capture specific signals ...
| |
| − | | |
| − | Baseline / Baseline ()
| |
| − | The baseline is the voltage from which signals originate. Ideally this would be 0V in the ToF-AMS, but it typically has a value of a few mV. This value is measured in the BitWise Window ... With thresholding enabled, signals are recorded relative to the defined baseline voltage.
| |
| − | | |
| − | Putting it all together: When configuring the AP240, the user defines the region of voltage space where the signals will be recorded.
| |
| − | Full scale determines the size of the window
| |
| − | Offset determines the position of the window
| |
| − | Baseline (mV) determines the voltage relative to which thresholded signals are recorded
| |
| − | The AP240 can only return integer values. That is, a signal cannot have intensity = 1.302 bits. Critically, a signal with voltage = baseline voltage should return 0 bits. For this to be the case, we must set our offset such that the measured baseline voltage corresponds to an integer bit value.
| |
| − | | |
| − | Rather than put the user through the trouble of calculating this offset, the DAQ takes the desired bit value (Baseline bit) and baseline voltage as inputs and uses them to calculate the appropriate offset. This step is carried out in the menu window when you press "Set" next to the baseline value or in the BitWise window when you press "Set Baseline."
| |
| − | | |
| − | So, what should the Baseline Bit value be? Historically, we set this value to 13 bits, which is 5% of 255. We measure all signals greater than the baseline, so this meant we were using 95% of the ADCs dynamic range. More recently, we have developed a rule of thumb:
| |
| − | | |
| − | "The baseline bit value need not be greater than the threshold bits + 2."
| |
| − | | |
| − | Where does this come from? When acquiring thresholded data, anything less than the base voltage is digitized as a 0. So, if the baseline bit = 13, anything with voltages corresponding to 13 or less will be recorded as a 0. (Actually, anything with voltage equivalent to 13 + threshold or less will be 0 ..) Immediately you can see that there is no sense setting the baseline bit high.
| |
| − | | |
| − | So, if we are not interested in voltages below baseline, why not set the baseline bit to 0? There is one time we look at signals below baseline: Baseline voltage is calculated as the average value of the electronic noise waveform. This signal has positive and negative going components. If we only measure the positive, we will bias the calculation high.
| |
| − | | |
| − | Back to the rule of thumb ... we generally set threshold at a value that is just greater than most of the positive electronic noise. And, the magnitude of the positive and negative noise is approximately equivalent. So, under normal circumstances, if we set the baseline bit at (Threshold +2) we will capture the positive and negative electronic nose, and properly calculate our baseline voltage.
| |
| − | | |
| − | Versions 3.0.17+ of the DAQ will warn you if your baseline bit is set too high or too low.
| |
| − | | |
| − | === Calibration / Tuning Window ===
| |
| − | | |
| − | === Troubleshoot ===
| |
