|
|
| (105 intermediate revisions by 17 users not shown) |
| Line 1: |
Line 1: |
| {{Product | | {{Technical support}} |
| |description='''DatLab''' is the O2k-Software for Data Acquisition & Analysis, specifically developed for [[high-resolution respirometry]] with the [[Oxygraph-2k]]. | | __TOC__ |
| The [http://www.oroboros.at/?DatLab newest DatLab version] is included in the [[O2k-Core]], and updates of DatLab are free of charge during the warranty period of the O2k. | | {{MitoPedia without banner |
| |product id=20700
| | |abbr= |
| |product type=O2k, O2k-Core
| | |description=[[Image:Logo OROBOROS-DatLab.jpg|200px|right|DatLab]]'''DatLab''' is the O2k-Software for Data Acquisition & Analysis, specifically developed for [[high-resolution respirometry]] with the O2k. |
| |info=Previous Product ID 28001-44, [http://www.oroboros.at/?DatLab DatLab @OROBOROS]
| | The newest DatLab version is '''DatLab 8''', included in the O2k-Packages. NextGen-O2k and O2k-Series J* and higher come with DatLab 8 installed on the integrated PC (Linux). DatLab 8 is required for the NextGen-O2k. DatLab 8.1 is compatible with O2k-Series (E and higher). |
| }}
| |
|
| |
| After many years of gradual change of DatLab 4 the multiple challenges from the increased use of MultiSensor applications prompted us to develop a new generation of software for the O2k: '''DatLab 5'''
| |
|
| |
| Because the internal structure of DatLab 4 was becoming to inflexible for new features, DatLab 5 was completely rewritten. This required also a change in the file format for DatLab files, see "Compatibility" below. By now DatLab 5.2 offers many new features like renaming plots, changing units and linear regression for the calibration of the Amp channel and for calculating the instrumental oxygen background parameters. Please consult the [http://www.oroboros.at/index.php?o2k-datlab-guide DatLab Guide] for a comprehensive description for versions up till DatLab 5.1. New features not yet included in the manuals are described below.
| |
|
| |
| == Installing DatLab 5 ==
| |
| # Get Datlab5:
| |
| ## from www.oroboros.at: When you are eligible to a free upgrade to Datlab5 our administration ([email protected]) will supply you with a login code. Use this code to log in at [http://www.oroboros.at/index.php?id=login] and download "'''DL5Inst.exe'''" to your computer. | |
| ## from the "OROBOROS O2k-Course on HRR" (on a USB flash drive): using the file finder, click "Manual" and then use the link labeled "DL5-Install.exe" to start the installation process. (Alternatively, you can use the link in the column at the far right to navigate to the folder containing DL5Inst.exe. The full path name is "OROBOROS O2k-Course on HRR\O2k-Building Blocks\3.O2k-Manual\O2k-DatLab-Install".
| |
| # Start (double click) '''DL5Inst.exe'''.
| |
| # You may be asked to permit the installation by the Windows operating system.
| |
| # C:\DatLab will be suggested as installation directory. Usually this will be also be the directory used by DatLab4 and you can accept the suggestion.
| |
| # Select "type of installation" = "typical" this will keep your instrument specific setting (chamber labels, calibration parameters) but may overwrite some layouts.
| |
| # During the first start of DatLab 5 the information in any Datlab4.ini file in the same directory will be copied to Datlab5.ini, then Datlab4.ini will be deleted together with DatLab4.exe. The new executable file will be Datlab5.exe. A new desktop shortcut will be created, named "Oroboros DatLab". It may be necessary to manually delete any old shortcuts (icons) to Datlab4, if present.
| |
| If for some reason you want to use DatLab4 and DatLab5 on the same computer they have to be installed in two different directories.
| |
| Known Issues: Windows 7: When selecting an alternative directory for installing DatLab (or creating a new directory by selecting a non existing directory) Windows 7 may respond with an error message. Ignore the error message and proceed.
| |
|
| |
|
| === Upgrading from DatLab 4 to DatLab 5 ===
| | The DatLab software is designed for 64-bit versions of Windows operating systems and does not run on MAC devices. |
| DatLab 5 can be installed over DatLab 4 (recommended option). In this case all DatLab files will be kept, but some layouts may be overwritten.
| |
|
| |
|
| | The minimum computer requirements are Intel-Core-2 or equivalent CPU, 2GB RAM and Windows XP (64-bit version). However, we recommend Intel i5 or equivalent CPU, 4GB RAM, Windows 10 (64-bit version) and SSD. For the proper display of DatLab on your computer, please make sure the “Language settings” are set to English. |
|
| |
|
| == New Features in DatLab 5.2 not yet included in the Manuals ==
| | *Optionally available without integrated PC. |
|
| |
| * Menu [O2k-Multisensor]/[Calibration] The Amp channel can now be calibrated using a multiple point linear regression:
| |
| # Select the Amp plot to be calibrated as active plot.
| |
| # Mark sections of the experiment for which the concentrations are known.
| |
| # Open the calibration window using either [O2k-MultiSensor]/[Calibration] or F5.
| |
| # In the left panel the current calibration is shown. The right panel is used to do a new calibration.
| |
| # Choose the desired unit for the calibrated signal from the drop down menu beside "Unit".
| |
| # Select the marks you want to use for the calibration by ticking the appropriate check boxes in the right panel under the heading „Select marks“. The averaged raw signal values, times, and slopes will be displayed for the selected marks.
| |
| # Leave the check boxes beside the slope column unchecked unless calibrating an Amplex Red experiment, see [[Amplex_red#Calibration_with_H2O2]].
| |
| # Enter the known concentrations in the column labeled "Conc".
| |
| # DatLab will perform a linear regression after each field has been edited. The results, sensitivity and R2, are displayed below the calibration table. You can compare these parameters with those of the currently valid calibration in the left panel.
| |
| # Check the quality of the calibration with „Show Graph Plot“. The graph may be exported to the clipboard.
| |
| # Apply the new calibration values with „Calibrate“ or continue using the old calibration values with „Cancel“.
| |
| ''Manually entering parameters from a linear regression:''
| |
| # Choose the desired unit for the calibrated signal from the drop down menu beside "Unit".
| |
| # Enter the desired values for sensitivity (slope of a regression signal against concentration) and intercept. | |
| # Apply the Calibration values with „Calibrate“ or continue using the old calibration values with „Cancel“
| |
|
| |
|
| * Menu [O2k-Multisensor]/[Calibration]: Functions effecting the calibrated signal have been separated from those effecting the slope calculated from the signal by placing the in different tabs: “Calibration” and “Slope”.
| | |info=[[Image:MitoPedia.jpg|left|60px|link=http://www.bioblast.at/index.php/MitoPedia:_DatLab |MitoPedia: DatLab]] [[MitoPedia: DatLab]] |
| | }} |
| | <br> |
| | [[File:Expand.png|right|45px |Click to expand or collaps]] |
| | <div class="toccolours mw-collapsible mw-collapsed" style="background:#F7F8FF"> |
| | <span style="font-size:105%; color:#424242">[[File:Questions.jpg|left|18px |Asking]]'''Does [[DatLab]] software run on MAC devices?'''</span> |
| | <div class="mw-collapsible-content"> No. The [[DatLab]] software is designed for Windows operating systems. |
| | </div> |
| | </div> |
| | <br> |
| | {{Labeling |
| | |area=Instruments;methods |
| | |instruments=Oxygraph-2k, O2k-Fluorometer |
| | |additional=DatLab |
| | }} |
|
| |
|
| * Menu [Experiment]/[Edit]: It now possible to calculate the parameters describing [[Instrumental background oxygen flux]] directly in DatLab:
| |
| # Perform an instrumental background test and set marks on the O2 slope plot as usually.
| |
| # Open [Experiment]/[Edit].
| |
| # Click on the “Calculate” button beside the displayed current background correction parameters for the desired chamber.
| |
| # Select the marks that should be included in the calculation of background parameters by ticking their check boxes (in a standard background experiment usually all marks will be used).
| |
| # Background parameters will be calculated and displayed immediately.
| |
| # Control the quality of the regression with “Show graph”.
| |
| # As a further quality control you may select to view a graph with the background correction already applied to the slopes. The corrected slopes should be close to zero.
| |
| # The graph can be exported using the “Copy to Clipboard” function.
| |
| # Close the graph window to return to the linear regression window.
| |
| # Apply the background correction by clicking “Save” in the linear regression window and again save in the [Experiment]/[Edit] window.
| |
| # The parameters a and b are exported whenever the button "Calibrate and copy to clipboard" is used in the calibration window. Therefore the calibration list template (available at [http://www.oroboros.at/index.php?o2k-o2calibration]) can be used for quality control and keeping a time track of background parameters.
| |
|
| |
|
| == Compatibility with DatLab 4 ==
| | {{MitoPedia O2k and high-resolution respirometry |
|
| | |mitopedia O2k and high-resolution respirometry=O2k hardware, DatLab, O2k-Open Support, O2k-Respirometry, O2k-FluoRespirometry |
| DatLab 5 is downwards compatible with DatLab 4: DatLab 5 can read all files generated by DatLab 4. However, DatLab 5 will save these files always in the DatLab 5 format. Afterwards, these files will no longer be readable by DatLab 4. Therefore, we recommend doing a complete transition from DatLab 4 to DatLab 5, upgrading all computers. However, there is no need to mass convert the old DatLab 4 files. They can stay in the DatLab 4 format and will be converted by DatLab 5 when necessary. If you have to import DatLab 4.1 files into DatLab 5, please upgrade to DatLab 5.1.0.130 or higher.
| | }} |
| | |
| == DatLab Technical Service Pages ==
| |
| | |
| {{#ask: mainlabel=Title|[[Category:All]] | [[Technical service::DatLab]]| ?Technical service}} | |
| | |
| {{#set:Technical service=DatLab}}
| |
| | |
| == Version History ==
| |
| | |
| === DatLab 5.2 ===
| |
| see above
| |
| | |
| === DatLab 5.1.1.9 ===
| |
| * Main menu: [Oxygraph] and [MultiSensor] were integrated into [O2k-MultiSensor]. [O2k-MultiSensor]/ [Calibration] (F5) will always open the Calibration Window for the active plot (O2, pX or Amp).
| |
| * pX: [O2k-MultiSensor]/ [Calibration] : Renaming the Amp channel, selecting units for the calibrated signal, setting a factor for the slope calculation, and calculating the slope from raw signal works now for the pX channel analogous to the Amp channel (see above).
| |
| * [O2k-MultiSensor]/ [Calibration]: When changing the selected unit for the calibrated signal, DatLab asks whether the calibration should be adjusted accordingly.
| |
| * Double clicking "Light on / Light off" in the O2k-Status line will switch on / off the chamber light.
| |
| | |
| === DatLab 5.1.0.130 ===
| |
| * Menu [MultiSensor]/ [MS Calibration] (Ctrl +F5): For the Amp channel, the user can now set the name of the plot (as it appears e.g. in axis labeling), the unit displayed in the calibrated plot, the multiplication factor used in slope calculation, and whether the slope should be calculated from the calibrated signal or the raw signal. To use these new features: [[Image:DL5_1_0_130_Amp_calibration_user_settings.PNG|400px|right]]
| |
| ** Type the desired plot name in the field "Name for Amp-channel". Avoid long names.
| |
| ** Choose the desired unit for the calibrated signal from the drop down menu beside "Unit". Default: "µM". Changing the unit '''will not''' (in DatLab 5.1.0.130) change the calibrated values. Therefore, to avoid confusion, the unit should be chosen before performing a calibration or upgrade to DatLab 5.1.1.7, see below.
| |
| ** Choose the desired factor for slope calculation from the drop down menu beside "Slope factor". Default: 1000. The correct unit for the slope will be set by DatLab depending on the chosen unit for the calibrated signal and the factor for slope calculation. Changing the factor '''will''' recalculate the values for the slope plot correctly.
| |
| ** To calculate the slope based on the [[raw signal]], activate the checkbox "Calculate from raw signal". If viewing the raw (uncalibrated signal) it is recommended to use this option.
| |
| ** Click "Calibrate and Copy to Clipboard" to apply all changes.
| |
| * Menu [Oxygraph]/ [Stirrer test] (F9) opens a window to enter the desired duration of a [[Stirrer test]] (Default: 30 s). After clicking "OK", stirring will be deactivated in both chambers and reactivated after the chosen time.
| |
| * Indicator for light in chambers: If the chamber light (not to be confused with light sources for fluorescence) is on, this is indicated in the status line by the text "Light on", highlighted in yellow. If the light is off the text reads "Light off", with no highlighting. This should be helpful when the chamber light is not obviously visible due to [[Fluorescence-Sensor]]s inserted into the O2k front windows.
| |
| * Menu [Oxygraph]/[O2 Calibration] (F5): If the the values for R1 and R0 differ by less than 1 V a warning is displayed. This typically happens when either the same mark is chosen for R1 and R0 or when the two marks for R1 and R0 are set erroneously to the same "state" of the chamber, that is both regions are either for the "open chamber" or for the "closed chamber, no oxygen" state. Check the selected marks when seeing this warning. It is possible to ignore the warning and continue with "Calibrate and Copy to Clipboard".
| |
| * Menu [Oxygraph]/ [O2k Control] (F7) / [Configuration]: A field "pX Reference Electrode" was added. A serial number or other designation can be entered.
| |
| * Menu [Experiment]/ [View protocol] (Ctrl+F3): The information is now more clearly structured to discern between parameters used during a calibration (may originate from another file, different condition) and the parameters used when the file was recorded. Both, calibration information and the information about actually used parameters were expanded for the pX and Amp channels.
| |
| | |
| === DatLab 5.1.0.20 ===
| |
| * [[file:USB RS232.PNG|thumb| right]]DatLab 5 supports connecting the oxygraph to a computer via the computers USB port and a standard USB cable (requires O2k-Core or O2k Series E and above). Additionally, DatLab 5 still supports connection to a computer via the RS232 port. Therefore, it is possible and highly recommended to upgrade all oxygraphs in a lab to DatLab 5. When connecting to the O2k for the first time, the type of connection (USB or RS232) is set by radio buttons. When connecting via the USB port any detected oxygraphs will be identified by their serial number and can be selected in the drop down menu to the right of "USB Port". When connecting via the RS232 port the proper serial port "Com..." can be selected in the drop down menu to the right of "Serial Port".
| |
| * DatLab 5 allows to open DatLab files by double clicking them in the Windows file manager or similar programs. First time use: Double click any DatLab file in the Windows file manager, select "open this file type always with this program", select "browse", then navigate to the file Datlab5.exe. Usually this file will be in C:\Datlab\DatLab5.exe. Depending on your Windows settings the extension '.exe' may not be displayed: In this case you can differentiate between DatLab5.exe and DatLab5.ini by right clicking and selecting "properties". The exact procedure will depend on the version and language of your Windows operating system. After doing this once, Windows will always use DatLab 5 to open DatLab files.
| |
| * Menu [Graph]/[Scaling] (F6): It is possible to set the maximum value for the Y axis of a plot. When changing one or two parameters (minimum, maximum, or range) the remaining parameters will be adjusted automatically after pressing "OK" or clicking in a different field. Fill out only the fields Minimum and Range to simulate the behavior of DatLab 4.
| |
| * Menu [Graph]/[Scaling] (F6):It is possible to selectively copy scaling settings to other windows by using the "Apply to Graph 1", Apply to Graph 2", etc buttons. These buttons replace the "Apply to all" button. This will be helpful in MultiSensor applications when e.g. two windows should show oxygen plots (with identical scaling) and two windows should show fluorescence plots (with identical scaling).
| |
| * The number of points used for slope calculations can now be changed for the pX and the Amp channels. Select [MultiSensor]/[MS Calibration]: Slope N: Select the number of data points (N = 40 to N = 5 in intervals of 5) used to calculate the slope. A high value of N yields a highly smoothed curve, whereas a low value of N improves time resolution.
| |
| * The slopes for the pX and Amp channel are now calculated with the correct sign for the first order time derivative. That is, if the calibrated signal decreases the slope will have a negative sign, if it increases the sign of the corresponding slope will be positive. The slope for the O2 channels is still calculated to give a positive sign for a decreasing signal, signifying a "positive " respiration.
| |
| * Proton production rates can be calculated on line. In the menu select [Plots]/[Proton Flux], see [[O2k-pH ISE-Module]].
| |
| *The amperometric channel that, due to its main use for "NO electrodes", was labeled "NO" in DatLab 4 was renamed to "Amp" to reflect its versatile nature. It is used e.g. to record the data from the [[O2k-Fluorescence LED2-Module]].
| |
| * Faster processing of DatLab Data (this required a larger minimum file size).
| |
| | |
| | |
| __SHOWFACTBOX__
| |
| | |
| {{Technical service}}
| |
