Use for unlocking software downloads and updates of the registered software.
If you bought University package, follow link and get the user code of Clarity Offline.
This section is available for authorizeddistributors or developers only.
This page lists frequently asked questions about Clarity Chromatography Software. If you didn't find the answer here, maybe it's covered in one of our videos or as a datasheet.
Bar code scanners support is implemented within a few autosampler control modules (Spark Integrity, HTA HT4000, …) – here the read bar code will be available as %f variable to be used in SampleID, Sample or Filename fields.
Hand-held scanners (emulating keyboard) could be used to fill in the values in the sequence table – terminating character should be set to Enter and the setting in the User Options dialog - General tab - Sequence Table - On Enter section should be set to Move Down option to move the focus to the next row after the Bar code value is read. For versions prior to 9.0 the option to set the terminating character to Down Arrow in the scanner will be advantageous otherwise it is necessary to move to the next row using the mouse/keyboard.
A Connect key is needed to activate communication between Clarity and Nexera control module. The Connect key (text file) will be generated by Shimadzu support upon providing the following numbers:
1. the Controller (CBM-40, SCL-40, CBM-40 Lite) Serial Number
2. the purchased RC.net Agilent ICF Nexera LC driver License Number (provided by us as a document based on the purchase of p/n A24-001 LC Shimadzu Control license).
In such case, it is recommended to check Colibrick Setup in the System Configuration window. Synchronize Start with Digital Input should only be enabled when one of Colibrick's digital inputs is configured as Exr. Start Dig. Input:. Furthermore, Synchronize Start with Digital Input and Exr. Start Dig. Input: must be set to the same Digital Input.
This change was made because the wrong setting led to random issues with analysis starts in previous versions.
Synchronize Start with Digital Input enables a faster and more accurate synchronization of channels with the start signal. The start of the analysis is defined by a marker in data points rather than by detecting the change in Digital Input. The difference is in the order of hundreds of milliseconds, which means that it is important only for very short analysis. When measuring multi-detector chromatograms it will minimize the time shift between detector signals and thus improve the detection of peaks.
It is not possible to install Clarity to Windows 10 LTSC releases, where .NET Framework version 4.7.2 or newer cannot be installed (this should apply to Windows 10 Enterprise LTSC 2015). This is because Clarity installation requires .NET Framework version 4.7.2, which was introduced as part of Windows updates in 2016 (Windows build 1607).
Importantly, DataApex cannot guarantee complete Clarity functionality in LTSC Windows releases, as they are not among supported OS (only OS with the latest updates is fully supported) and are not properly tested with Clarity.
All Software and Hardware requirements are listed here. You can test, whether it is possible to install Clarity to the system, by downloading and installing Clarity Demo.
Mark in a chromatogram can be created utilizing any HW with digital input (e.g. Colibrick A/D converter) or the Virtual Digital Input Output Loop module and Event Table tab from the Method Setup dialog. With proper settings, triggering the digital input is recorded as an event (vertical line labeled with name and RT) in the Acquisition and Chromatogram windows. The digital input can be triggered by pressing the start button when it is provided by HW, or by pressing the corresponding Digital Output in the Device monitor when provided by the Virtual Digital Input Output Loop module.
The following settings are necessary:
Clarity stores the IP address of the device detected during autodetection in the configuration and if it changes, it is unable to communicate with the device. Some devices use IP adress assigned by DHCP server in default settings.
If the system is connected directly to the computer or via a switch, it is necessary to set static IP addresses in the devices and in the LAN card in the computer (preferred solution). Refer to the device manual or contact device manufacturer/supplier for how to change the device setting to a static IP address.
If the system is connected directly to the computer via router, it is possible to use DHCP IP address assignment, but you must ensure that the assigned IP addresses do not change. The same applies for connections via an internal network, where the cooperation of the network administrator is required to set the IP address.
Clarity is a 32-bit process, which means it can use the max of 2GB RAM, but if you use more than one demanding instrument, it can still be beneficial to have 8 GB RAM, so the PC has enough RAM left for OS and other apps.
Sometimes you may get the error "Out Of Memory", caused, e.g., when opening a chromatogram in the Chromatogram window. This may be caused by using a particular method, which has been saved over and over again due to some modifications. Since version 8.3, every saving of such method results in creating another method's version (number of versions is displayed at the top of Method setup behind the method name as "- #number"). These versions increase Method file size; when such a method is used, memory can be depleted, forcing the software to misbehave.
As a remedy:
The control of Shimadzu Nexis GC-2030 GC and Nexera LC-40 HPLC is available in Clarity - Shimadzu Edition (p/n C50-28).
It requires a Shimadzu license for each connected instrument p/n A23-001 for GC-2030 and A24-001 for Nexera HPLC Series.
Clarity - Shimadzu Edition is available only in Europe.
Configuration for Clarity Shimadzu Edition with one Nexis GC:
p/n C50-28 Clarity Shimadzu Edition for 1 Instrument
p/n A23 GC control
p/n A23-001 GC Shimadzu license for one GC
p/n A26 AS control (in case there is a Clarity controlled autosampler)
Configuration for Clarity with two Nexera HPLCs:
p/n C50-28 Clarity Shimadzu Edition for 1 Instrument
p/n C55 Add on Instrument
p/n A24 LC control
p/n A24-001 LC Shimadzu license for one HPLC, 2x
p/n A26 AS control (in case there is a Clarity controlled autosampler)
p/n A29 PDA extension (in case Nexera includes a PDA detector)
Configuration for Clarity with one Nexis GC and one Nexera HPLC:
p/n C50-28 Clarity Shimadzu Edition for 1 Instrument
p/n C55 Add on Instrument
p/n A23 GC control
p/n A23-001 GC Shimadzu license for one GC
p/n A24 LC control
p/n A24-001 LC Shimadzu license for one HPLC
p/n A26 AS control (in case there is a Clarity controlled autosampler)
p/n A29 PDA extension (in case Nexera includes a PDA detector)
When ordering an upgrade from Clarity to Clarity Shimadzu Edition (p/n C620-28) do not forget to add a Shimadzu control license p/n A23-001 or A24-001.
It is possible to print an audit trail of the method used for acquisition solely using the Method Setup dialog. In case it is required to print audit trail of method (*.met) file it is necessary to perform this print directly from the Method Setup dialog.
In case there will be requested print from a different location (for example from the Chromatogram window) with checked option 'Method Audit Trail' from tab 'Audit & Signatures' from the Report Setup dialog nothing will be printed. This means it is not possible to print together with chromatogram an audit trail of the method (*.met file) used for its acquisition, thus procedure described above has to be applied.
Yes, it is possible. The procedure is described in the Clarity Whitepaper How to capture network communication using Wireshark (Network Protocol Analyzer) (D142), please see the Whitepaper section to view the datasheet.
For the Gow-Mac GC chromatograph, use the asymmetrical connection as shown in the picture below.
Connect Brown wire (pink tubular end sleeve) to terminal (+) and white wire (grey tubular end sleeve) together with yellow wire (shielding) to terminal (-).
Do not connect anything to the terminal marked D in the picture, it may cause damage to the A/D converter. Set also the Signal Range at the Method Setup Acquisition tab to the lowest possible value.
Yes, this is possible from Clarity version 4.0. In both the Sequence window and the Single Analysis dialog it is possible to define the name of the file including the subdirectory - use the \ sign in the name of the file.
It is possible to use the standard Clarity variables in the name of the subdirectory - the file name could look for example like this:
In the given example, %s\%Q is used for creating the file name, which means a subdirectory with the sequence name (%s) will be created in the working directory, inside of which the files with a name of Sample format will be created.
If the folder is not present at the moment when the acquisition is run, it will be created automatically (you might be prompted to confirm the folder creation). If the subfolder is already present, the file will be created in it.
In this respect, please take care not to break Windows file and folder naming rules, so check that space will not be the last character in the folder name, etc.
Yes, you can add the User Column which displays RRT according to a Compound Name. To do this, follow these instructions:
This problem is caused by the wrong configuration file saved in Clarity\cfg. The most common reason is that the computer was shut down while Clarity was running. Normally, Clarity saves the clarity.cfg file when exiting, but when the computer is shut down while doing this, the clarity.cfg file may be corrupted and cannot be used in Clarity next time it is opened.
The corruption of the clarity.cfg file may happen in numerous ways. Here are the two most common situations:
All data, such as methods, sequences, data files, calibrations, etc. are saved on demand and are not corrupted when a similar situation arises. The clarity.cfg file holds the information of the Directories and the System Configuration settings, that are lost, so they must be set manually once more.
To repair the damage, follow this process:
The station should now be in the configuration as before the failure.
To prevent this from happening in the future if the reason was the sleep mode follow the procedure:
In Windows 7, 8.1 go to Control Panel - Hardware and Sound - Power Options - Edit Plan Settings to change the settings.
Corruption should be prevented in the future. Of course, if it was caused by another reason, such as instabilities in the power network, only a good stabilized backup power source and backing up your configuration may help.
Yes, Calibration Bracketing is supported directly in Clarity.
The bracketing in calibration is a technique when samples in a long sequence run are evaluated to standards immediately preceding and immediately following the respective samples. It is used to compensate for the instability of detector response during the run for example, typical for electrochemical detectors.
1. In the Method Setup - Calculation, set the name for cloned calibration files used during the Calibration Bracketing. The field enables the use of any text, however it is recommended to use variables appropriate to the calibration method (Line, Date and Time, ...) (1).
2. In the Sequence - Sequence Options, check the Calibration Bracketing option. This sets the sequence and calibration to the Calibration Bracketing mode (2). As every unknown sample series is demarcated by calibration standards and as such uses a single calibration file, calibration will be cloned from the previous calibration clone whenever an unknown sample or blank follows the calibration standard. In a newly cloned calibration file, all responses other than responses of the last series of calibration standards (only those standards that follow the unknown samples) are cleared.
The Retention indexes columns are hidden in the default layout of Clarity tables (Reten. Index in Clarity corresponds to Kovats Retention Index).
To display them in both the Calibration window and the Chromatogram window:
If you need to use the Unretained Peak, follow these steps:
The serial number and user code can be found in the About dialog.
1. Open the main Clarity (Lite) window.
2. Use the Help - About menu command to invoke the About dialog.
3. Serial number can be found in the first tab.
4. Both user code and serial number can be found on the System files tab with other fundamental information about both the station and the computer.
You can also find it printed on a plastic card supplied to your USB installation media or it can be found in the packing list.
During acquisition, data are stored in the temporary directory (...\TMP\ $ch1run.raw file ). The data are stored from memory to disk in approximately 1 min intervals. In case the Clarity crashes/freezes during a run, the up to that moment acquired data could be recovered using the Data Recovery ... command from the Single Analysis window. Note the chromatogram will be created according to the method and parameters specified in the Single analysis (file name and processing parameters), which may be different from the ones used in the Sequence.
During the freeze, it will depend if the thread collecting and storing the data to disk will be still active, with a crash, the data to the last minute before the crash could usually be recovered. In case the computer freezes often, it will be advisable to investigate the cause and try to find a remedy – please do not hesitate to send us the respective diagnostic files. A Memory dump may be helpful for such situation.
Antivirus programs usually do not interfere with Clarity functionality. But two areas may pose problems for the correct functioning of Clarity (Lite):
Automatic Windows updates are in the default settings able to force the unattended computer to restart regardless of running programs - only a warning message will appear. Please note, that the first two options (Automatic updates or Download updates) may result in the forced computer restart.
Choose one of the options for automatic updates:
On administered systems ask your local administrator to choose one of the options described above.
In Windows 10 and 11 it is not possible to forbid the updates, just to pause updates for short period of time and install them after manually to avoid forced restarts. Go to Settings - Windows Update - Advanced Options - Pause Updates
In Windows 7, 8.1 go to Control Panel - System and Security - Windows Update- Change settings.
We recommend installing and operating Clarity on a PC with updated OS, only the forced restarts pose a potential problem to Clarity.
In case your PC and chromatograph are connected directly via LAN and autodetect is not possible, use the following configuration.
Possible causes are:
a) Detector is not allocated to the Instrument:
b) You have purchased a license for data collection for a smaller number of instruments:
Serial Number (S/N) is a 7- or 8-digit number that represents the serial number of the station. S/N is always required when you ask for technical support at firstname.lastname@example.org. S/N is saved in the HW key and is permanent (i.e. does not change with the Clarity configuration change). Last 5 or 6 digits extended most often by 40.000 correspond to the number written on the HW key itself. The prefix usually differentiates OEM versions, e.g. Clarity Offline has 98-xxxxx(x) number format.
User Code (U/C) is a 16- or 17-digit (one- or two-letter prefix) code formed from letters and numbers that unlocks the specific Clarity configuration. It defines the version of SW and other specifications (e.g. bought extensions). User Code is always unique for the corresponding HW key and might be variable and changes whenever the customer purchases an additional instrument, control, extension or upgrade. When the configuration is changed you need to set the new U/C (given usually via email) in the Clarity main window - Help - User Code... dialog.
▌An unknown error occurred while accessing C:\Users\<user name>\AppData\Local\Temp\Clarity\$ch1run.raw
It can be displayed during the start of the acquisition, probably when the User does not have writing rights into C:\...\Clarity.
▌Attempted an unsupported operation.
It may occur when accessing a broken dialog or window. Please contact our support and describe in which window it happened.
Probably there is an error in communication with DataApex converter. See a manual of INT7 or INT9 - chapter Troubleshooting, table List of Error Messages.
▌Blocked HW key
Your HW key has for some reason been blocked. Contact our support for help.
▌Cannot add device group
When trying to drag the whole group of devices (AS, GC, ...) over to the Instrument.
▌Cannot add some subdevices. - DEMO - 1 was configured on Instrument XX
If the number of DEMO detectors in configuration exceeds a certain number. Up to 10 is definitely still fine.
▌Cannot connect with communication library CswHP1100.dll. Install Agilent IO Library Suite version 15.
Libraries for GPIB are not installed (e.g. when switching the station from Clarity Demo mode with 1100 over GPIB in configuration). We do not include the libraries, see the Agilent website. Also note that GPIB communication is no longer supported since Windows 7.
▌Cannot create Detector
This error message can occur while using a DataApex A/D converter. Probably an unregistered library. Please contact our support.
▌Cannot create RAW file
Cannot create raw file C:\Users\<user name>\AppData\Local\Temp\Clarity\$ch1temp.raw is an error message which occurs due to very specific circumstances.
After starting the analysis, the file $ch1run.raw is created. When the analysis finishes, it is then renamed to $ch1last.raw from which the chromatogram *.prm is created. The file $ch1temp.raw gets created in case the renaming is not possible - usually due to a modal error message which awaits confirmation.
▌Cannot create temporary files
At Clarity startup if the user cannot write to C:\Clarity (installed without administrator rights).
▌Can't create ... (device name)
Usually a problem with the control module library (*.dll file). See FAQ - Question "I get an error message (Error on setup, Can't create ...) when I want to add an hardware to Clarity Configuration".
▌Cannot determine the number of bytes in input queue for Serial communication. System Error Information : 31. A device attached to the system is not functioning
If Multicom is unplugged from the USB of the PC (ECOM LCO connected over Multicom).
▌Cannot determine the number of bytes in input queue for Serial communication. System Error Information : 1167. The device is not connected
If Multicom is unplugged from the USB of the PC (ECOM LCO 102 connected over Multicom).
▌Cannot establish communication with XXXX SN xxx! XXXX SN xxx might not be connected, installed properly or it might be malfunctioning
In an attempt to open Instrument which has an uncommunicative device in configuration (e.g. unplugged U-PAD2 or Colibrick).
▌Cannot find driver file
From version 2.8 and later - this message pops up if an DataApex internal A/D (INT7, INT9) card is configured but physically unplugged. Also if the device is disabled in the Device Manager. See a manual of INT7 or INT9 - chapter Troubleshooting, table List of Error Messages.
▌Cannot find first board
This message may occur when a user wants to configure more A/D cards than is present in the PC.
▌Cannot find RAW file
This message has occurred while ending the analysis (Agilent 7890). Cause unknown yet.
▌Cannot find second board
If the user tries to add a second board which is, however, not present in the PC. See a manual of INT7 or INT9 - chapter Troubleshooting, table List of Error Messages.
▌Cannot load device driver
This message could have occurred on older versions of Clarity (for example on 18.104.22.168), probably due to a missing DataApex INT7 card. See a manual of INT7 or INT9 - chapter Problems with INT7.
▌Cannot load script xxx server execution failed (Ruby control modules)
Problem is caused by recent Windows 10 update (Build 1809), which is blocking the used RUBY script intepreter library version used due to a vulnerability issues. For remedy, please update to Clarity version 8.1 or higher, the affected library was updated in it.
▌Cannot open File Open Dialog. An unknown error occured during this operation
This message seems to be related to exhausted Windows resources. Make sure you are using the latest version of Clarity and a fully functional Windows installation.
▌Cannot open file XXX The file is already open on Instrument YYY.
If you attempt to open a method that is already opened on another instrument.
▌Cannot open USB communication for XY
For example U-PAD2/Colibrick. Possible causes are if the A/D converter is connected over a USB hub or if there is a problem with DLL registration.
▌Cannot send data in serial communication
If you have, for example, a GC connected over a NetPAD and in configuration you first remove the NetPAD and then try to perform something with the GC.
▌Changing project requires to restart instrument. (You will be prompted to save modified files.) Is this OK ?
If you have unsaved changes in the Chromatogram window and you also want to change a project on the instrument.
▌Clarity is already running!
Appears during the startup of clarity.exe if another instance is already running.
▌Clarity.psw file has been changed. Please see help file for possible reasons.
When upgrading Clarity from versions older than 8.0, this dialog may occur at first run and be logged in Station Audit Trail. It is a standard behavior caused by security improvements in newer versions of Clarity.
When manipulation with the *.psw file has been detected, it appears during the start of Clarity . This manipulation may mean a *.psw file from another station was copied to the Clarity configuration folder (C:\CLARITY\Cfg by default) or when Clarity closed unexpectedly (Clarity crash, PC power failure, ...) when the *.psw file was modified but not yet saved.
When the *.psw file found does not contain a record about station running in the Regulated Environment, station will normally continue working and no message will be displayed on further Clarity station starts. If the *.psw file contains the record about station running in the Regulated Environment, station will not start at all. An empty *.psw file from the \Cfg\BACK\LAST_INSTALLATION\ subfolder can be used, all user accounts must be recreated and all GLP options must be re-selected.
▌Clarity.psw file has been corrupted. Clarity will now terminate. Replace the corrupted Clarity.psw file in Clarity folder (C:\Clarity\Cfg) with default file from the backup folder C:\Clarity\Cfg\Back\Last installation. All user accounts will be lost.
Appears during the start of Clarity when *.psw file is corrupted (illegible). Clarity will not start at all. An empty *.psw file from the \Cfg\BACK\LAST_INSTALLATION\ subfolder can be used, all user accounts must be recreated and all GLP options (if used) must be re-selected.
▌Configuration file C:\Clarity\Cfg\Clarity.cfg is not valid. The file was either damaged or created with a later version of the software. The backup copy will be used.
Appears when starting Clarity with a non-compatible *. cfg file.
▌Configuration file C:\Clarity\Cfg\Clarity.cfg is not valid. The file was either damaged or created with a later version of the software. Contact support for help.
Appears when starting Clarity with a non-compatible *. cfg file. Backup cannot be restored in this case.
▌Detector 1 (= NAME OF SIGNAL) is not acquiring any data
In case of high load on a low performance PC. This error may also occur due to physically damaged card during acquisition.
▌Encountered an improper argument
In version 22.214.171.1245, this message appeared when the PDA tab in Report Setup was moved from the initial position.
▌Error Occurred During Setup.
This message can happen during the configuration of a control module.
▌Error 1008 V-2500 (Upchurch) (SN N/A): Not Connected
If the valve from a COM port is disconnected, it is switched from Waiting to Communication Error.
▌FAILED to send method to device (Thermostats)
When thermostat is unplugged from RS232 and then "Send Method" is pressed manually.
▌FAILED to send method to sub-device
If the device stops communicating with several parts (e.g. 7890).
▌Fraction table contains overlapping time intervals. Please amend the table so that the time intervals don't overlap.
This error occurs if the user creates a wrong table for a fraction collector with overlapping times. It is a warning for the user that the fraction table needs to be corrected in order to avoid presence of the overlapping time segments in the table.
▌HW Key test Failed
Your HW key is not working correctly. Contact our support for help.
▌Incompatible device driver
The kernel driver and the driver in the Clarity do not match.
▌Invalid rows detected in the Method Setup - Event Table. The invalid rows will be marked out and skipped from events processing
This message appears during the opening of a method whose Event Table uses something that is not in the configuration.
▌Method file XXX does not exist. For more information about errors on the other rows, point mouse cursor over "Sts." Column for each row.
This happens when opening or checking a sequence which contains a name of a non-existent method.
▌Method file XXX was prepared with different instrument configuration and cannot be sent into HW. Open Edit Method Dialog and press OK to adapt it to the new configuration (non-matching parameters will be replaced by defaults).
If the instrument or method being opened does not correspond to the hardware which is currently present in the configuration.
▌Microsoft Visual C++ 2005 Redistributable Package (x86) installation failed. Exit code: 1618. Installation of Windows update or another program is already in progress. Let it finish first, restart the PC if necessary, and then start Clarity installation again.
This can happen when Windows update or another program is already being installed, in rare cases this is caused by Windows installer process not being terminated properly. Waiting for intallation to finish and restarting PC should resolve the issue.
▌Missing keylock drivers
The drivers for the HW key are missing or corrupted. They need to be reinstalled. See FAQ on our website - HW key (re)installation.
▌Net-PAD (SN Error) Cannot send sockets.
Net-PAD is not communicating. This may be due to a faulty cable or that when using a direct connection the PC does not have a static IP address set up.
This message appears if the data do not arrive within 7.5 seconds.
▌No data received for 10 s.
This message may occur during an acquisition if Clarity has not received any data for a prolonged period of time. Make sure the PC is not under high load during the acquisition.
▌No detector has been found and not even DEMO detector has been found
The control modules may be incorrectly registered. Please check the IQ Report of Clarity.
▌Please enter valid Data Size. Minimum is 2.
The content of the imported file is too short (only one data point on the graph).
▌Project directory <Project name> already exists but has no project file! Do you want to create the project file?
Project directory with this name already exists but it misses its project *.prj file. Select one of options. It is recommended to select Yes option.
▌Project file <Project name> already exists but has no project directory! Do you want to create the project directory?
There already exists project *.prj file with given name but it misses its project folder. Select one of options. It is recommended to select Yes option.
▌Project <Project name> already exists! Choose a different name.
Project with this name already exists. Select another and unique name for newly created project.
▌Seek failed on C:\..... .csv
The content of the imported file is too short (less than 5000 Bytes). Please update to the latest version of Clarity.
▌Shutdown from Event Table
This message appears after executing the Shutdown command from the Event Table.
▌Stop time must be larger than Start time for individual fractions.
This message concerns fraction collectors. The Fraction table contains incorrect settings of Start Time and Stop Time for one or more rows. Each row of the Fraction table has to be set such that the Stop Time is always higher than the Start Time on the same row.
▌The directory specified for instrument x does not exist: C:\...... It is necessary to set correct directory with projects for instrument x in Directories dialog.
This message appears during the opening of an Instrument window while deleting/renaming or damaging the respective directory in the meantime.
▌The report style "Chromatogram.sty" does not exist or is damaged. Default report style "Noname" will be used instead.
This message appears during the opening of a Chromatogram window while deleting/renaming or damaging the respective .sty file in the meantime.
▌Too many peaks in chromatogram. Try to increase peak width or threshold
Peak Width was set to a low value (e.g. to 0.001 minutes in a 80 minute noise chromatogram).
▌Too much data for FFT. Max. number of samples in interval is 2E6
FFT applied to a too large interval.
▌Unable to lock instrument in unprotected mode!
When no user is created and you attempt to set Lock on an opened instrument.
▌UPAD (SN...): Cannot send data in USB communication.
For example when you unplug a USB cable during acquisition and confirm the displayed error, the Instrument then switches to a Communication Error.
▌UPAD device malfunction
This appears during the test of a UPAD when it does not provide any data. In other words, during the start of Clarity an acquisition signal 10V/100Hz is sent to the first UPAD channel and if there is nothing received from the UPAD in 1 second, this error message appears. See the manual of UPAD - chapter Troubleshooting.
▌User accounts file load error
The file Clarity.psw failed to load. Happens, for example, if you downgrade from 3.0 to 2.8 and leave the old files in place.
▌You are attempting to paste incompatible or out of range values
This message may occur while copying a sequence table prepared in Excel. Make sure the form of the table and its values are correct.
▌You do not have sufficient privileges to read file XXX.prj.
This message occurs if the user tries to open the project file created by user who has option No Access selected in Other Users Can setting.
▌You entered 3 times wrong password, you must restart program
If the user submits a wrong password three times in a row prior to closing Clarity.
▌wrong checksum (size), probably different version of the file
Check the IQ Report to see if the Clarity installation is correct.
▌Warning: unknown control module
Happens e.g. in Clarity Lite for drivers of control modules if the PC finds a full version of Clarity installed.
▌Failed: bad size
The file has a different size (compared to iq.chk) - occurs e.g. in Clarity Full for .dll from Lite, if that one was the last registered.
▌Failed: bad checksum
The file has a different checksum (compared to iq.chk) - occurs for .dll which has the right size, but the checksum does not match. For example if you edit the size of iq.chk manually.
Clarity installation requires a specific version of Microsoft .NET Framework, which may not be installed or enabled on the computer by default. You will be notified by the Clarity installer which version of .NET is missing on your PC.
Some external control modules and their components may also require different version, which is not controlled by the Clarity installer.
There are three ways to obtain required versions of .NET framework:
On Windows 7, download the respective versions using the link below:
Click here to download .NET 3.5 SP1
Click here to download .NET 4.8 (this includes all previous 4.X versions)
On Windows 8.1, 10 and 11 follow these steps:
Note:Installing .NET framework may require additional windows updates. Always follow the instructions supplied with each version of .NET you are installing. It contains information about additional updates and security fixes.
Installation of .NET 3.5 is not always smooth in Windows 10, consult with your IT to find the best way to install it.
For computers that do not have (enough) serial ports, we offer the MultiCOM device (6x RS232 to USB converter). Be sure you have an available USB port in your computer to accommodate the MultiCOM.
Clarity is available in English, Chinese, Spanish, German, French and Russian localizations.
The USB or LPT HW key is not functional.
The Rockey USB/LPT and Sentinel USB/LPT HW keys are not functional due to the installation of the wrong driver. This situation occurs in case this HW key was connected to the PC before the installation of the correct driver (Clarity). It can be solved by uninstalling the wrong driver and installing the correct one. You can find such info in the chapter describing the certain HW key.
Before you do anything, ensure the corresponding port (USB, LPT) is enabled in the BIOS settings (integrated peripherals). The drivers can be installed even if it is not enabled, however, the key will not function then.
a) For a USB HW key, check the following:
b) For an HW key connected to a parallel port check the following:
Depending on the type of HW key you get with the Clarity, continue with the proper chapter of (re)installation. See images below:
Rockey USB ND does not need separate installation of drivers. Drivers will be automatically installed once plugged into the USB port.
At first sight, Rockey USB ND is distinguished from other keys by the fact that the casing is grey and transparent (the internal chip is visible).
Supported from Clarity version 2.6.1.
If it will not help, please check, if the used USB port is functional or try to install the station on another computer.
If this will not help, contact our technical support at email@example.com.
If it will not help, please check, if the used USB port is functional.
Verify that the key is properly inserted in the LPT (printer) port.
The peak detection algorithm used in FC-GP can be explained using the figure below. The red color is the signal, the blue color is the derivative of the signal (basically a slope at that moment). The axis on the left is shown in the units of the derivative, there are two green vertical lines at 2 and -2 for illustration (let us assume the slope has a start value of 2 and an end value of 2).
The first peak is collected when the derivative raises over limit 2 (first upwards black line). The peak is being collected through the peak apex (even before that the derivative falls below 2) and still being collected when the derivative falls below -2. It then starts to rise and the peak end is triggered when the derivative raises from some -4 above -2 (which is the negative of the end limit). In case the derivative on the peak end never falls below -2, the fraction will never end (until the end of the interval of the collection).
The Clarity software license is fixed on the HW key. The software itself could be installed freely on different computers, but without the HW key, it will not start.
For moving Clarity to a new PC follow these steps:
1) Install the software on a new computer (the latest version could be downloaded from our website www.dataapex.com, section Downloads, you need to be registered and logged in). During the installation make sure all necessary drivers and control modules are installed - some may not be included in the Typical installation.
2) Connect the hardware (MultiCOM, A/D Converter, etc.) and the HW key.
3) Enter the user code matching the HW key.
4) To restore your settings copy the system files (clarity.cfg, clarity.dsk, clarity.psw) from the old computer to the Clarity\cfg folder on the new PC.
If you have Clarity Full version:
5) To restore the data, use Archive/Restore command to copy the needed projects (recommended procedure) or copy the respective folders (including the Projects and Common).
If you have Clarity Lite:
5) To restore the data, copy the respective folders (including the Projects and Common).
The loss of the HW key = the loss of the license. The software and a new HW key must be repurchased (see Item 6 in General Sales conditions).
Damaged keys may be replaced for a nominal charge. The damaged key must be returned.
For one or more devices requiring the serial (COM) RS232 port, use the reliable MultiCOM adapter from DataApex (p/n MC01). Proper operation of the MultiCOM adapter has been approved by many of our satisfied customers.
If you purchase the USB to serial (COM) RS232 cable adapter from another manufacturer consider the following recommendations:
Most probably yes, the list contains only directly controlled autosamplers. In other words, those where it is possible to set the position and injection method using a computer. Nevertheless, Clarity allows basic synchronization (allow injection and start data acquisition) with arbitrary autosamplers equipped with appropriate control output and input.
For more information about AS connection, refer to chapter 6 (Connecting Autosamplers) in the Getting Started.
It is possible to configure and control up to 4 independent instruments (GC or HPLC) in one Clarity station. Only one Clarity station can run on one PC.
However, please consider such configuration may not be practical in cases when all 4 instruments should be running simultaneously with short analyses (less than 20 minutes) due to the following issues:
Please note there may be also specific limitations given by the controlled instrument (for example only one Agilent 1100 system using HP-IB communication or only one Shimadzu LC-10/20 system may be controlled by the Clarity station) due to the communication protocol constraints.
Normally, drivers for MultiCOM are installed without any problems when the Typical installation of Clarity is performed from Clarity version 8.1, before that MultiCOM drivers were installed only during Full installation or when manually checked during the installation. Nevertheless on Windows 8.1 drivers for MultiCOM may not be installed properly. In such case, the following error appears: "Windows found driver for your device but encountered an error while attempting to install it. The system cannot find the path specified."
There are two ways to rectify this situation:
In case your Master GC has an older firmware that supports an older version of Clarity than you have installed it is possible to use older drivers in newer Clarity (up to 8.1). Proceed as follows:
It is not possible with Clarity version 8.2 and newer because of our internal policy.
Yes, since Clarity 8.0 you can work with up to 10 internal standards.
The "No Data received for 10 sec" or "No data from Acquisition..." messages mean what they say, no data were received from a detector or convertor (Colibrick, U-PAD2, etc.) for a certain time. It may be caused by several cases:
1) In most cases, there is some problem on the computer - processor overload, interference on the USB bus, time-consuming net search, or backup operations blocking the communication for some time. The error invoked will stop an acquisition or interrupt the sequence.
Suspected programs are incorrectly set antivirus (continuous checking of file types used by Clarity during data acquisition - raw, prm, audit, tmp should be avoided), programs monitoring files on exchangeable media (i.e. programs for organizing and presenting pictures, music, or video, including some CD/DVD burning programs). One such persisting problem was reportedly solved by removing the Roxio Burning software.
This will occur more frequently on slow computers, the triggering action may be processor overload or some programs blocking the communication for an extended period.
2) In some cases, Windows may suspend the power of the USB HUB in the computer and this unexceptionally causes a loss of connection to connected HW (e.g., Colibrick). Try to check the Device Manager dialog - Universal Serial Bus controllers. Display the Generic USB HUB Properties dialog - Power Management tab. Set Disabled for option Allow the computer to turn off this device to safe power. In case the problem is temporary, sending the method again may solve the problem. If not, disconnect and reconnect the USB HUB.
The above-mentioned problem with communication was not observed when the USB hub is connected to the USB C connector on the PC.
Clarity is fully supported on Windows 7, 8.1, 10 and 11. For more details see the Clarity compatibility table.
You can upgrade to the latest Clarity version at Downloads. See our Upgrade Policy for more details.
If you have anti-virus software that scans your web communication and downloads for viruses, it may hang the download in your web browser at the end of the download process. The length of the delay depends on the size of the file and it may appear in Firefox, Chrome, Internet Explorer, etc.
You can also turn off the web scanner (web protection) in your anti-virus SW for as short time as the length of download time of the Clarity Installation.
RkUSB HW keys may not work properly on computers with "AMD USB Audio Driver Filter" installed. It is recommended to check the driver details of RkUSB in Device Manager. In case a "usbfilter.sys" is listed, uninstall the "AMD USB Audio Driver Filter" driver from Windows using the "Add or Remove Programs" function in Windows. For more details see the support pages of your PC's manufacturer.
State of Clarity Instrument can be read by other software using a built-in DDE server. For more information, please see the datasheet D070 DDE synchronization of Clarity with other programs.
Yes, it is. Simply take your HW key and plug it into another PC. You can install Clarity (Lite, Offline) on as many PC as you like using the same user code. Clarity will work properly on the one PC with the HW key connected.
If you add a User Column both to the Summary and Result Table containing the same formula, often you cannot get the same results. In Summary Table you cannot use the First, Last, etc. functions from Special Values. For example "[Reten. Time]first/[Reten. Time]" will not work here. But you can use figures working with the compound itself, for example "[End Time]-[Start Time]".
At first, check if Colibrick/U-PAD2 isn't connected to a USB hub. Problems are mostly related to the USB power supply, so the hub should definitely have an external power source.
Note that Colibrick/U-PAD2 is sensitive to communication delays. Responsible for those delays in USB communication may be the computer hardware or software. Processor overload, low RAM memory or running processes blocking the processor or communication lines should be checked. In case the communication is interrupted for more than 10 seconds, an error will be invoked. Error messages "No data from Acquisition", "No data received for ..." and similar may appear randomly. As a consequence, the running acquisition is stopped and the running sequence is interrupted. In case the problem is temporary, sending the method again may solve the problem. If not, disconnect and reconnect the USB hub.
Try the Task Manager and inspect the processor load and processes consuming a large amount of CPU time or memory. Suspected programs are incorrectly set anti-virus (continuously checking file types used by Clarity during data acquisition). The *.raw, *.prm, *.audit, *.tmp file types should be disabled for scans. Any other programs monitoring files on exchangeable media (i.e. programs for organizing and presenting pictures, music or video, including some CD/DVD burning programs) may also interrupt the acquisition.
Also, when the acquisition is running, it may be interrupted by any actions started during this, like printing to a slow USB or network printer, large file transfer over network or USB, connecting or disconnecting USB devices, computer entering sleep mode or screen-saver activation.
The above-mentioned problem with communication with Colibrick/U-PAD2 was not observed when the USB hub is connected to the USB C connector on the PC.
It is possible to schedule a task that will run Clarity with defined parameters automatically starting a sequence. Proceed as follows:
The batch should contain the following line (example):
The sequence can contain just one line with the start-up method, or some standards/samples can be defined in the following rows. In the start-up method, define to switch the lamp on and flush the system as required to equilibrate.
Set the clarity.bat to be started at a defined time and date. In Windows 7 and later you may find "Task Scheduler" after pressing the Windows Key on your keyboard. Use the advanced properties of the task to fine-tune the scheduling.
Set the task to be started when you are logged on only and when leaving the PC, do not log yourself off. Remember, there must not run Windows Update which may log you out and restart the PC.
Yes, you can. There are two possible intentions of using the sequence table for starting the acquisition:
How to set digital input and output to start the sequence without an autosampler?
Events must be set in the Event Table accessible from the Method Setup dialog.
For more detailed info refer also to Clarity Getting Started manual, chap. 6.
For LAN communication, one of the 1100/1200 modules must be equipped with a LAN communication card inserted in the MIO slot on the backside of the module (do not mistake it for the CAN connectors used for the internal system communication, using the same RJ45 connectors).
The original board supported by Agilent is a G1369A LAN Interface described in Agilent G1369A LAN Interface User Manual (Agilent P/N G1369-90000).
In case you want to use J4100A JetDirect card (alternative to HP JetDirect Print Servers 600N/400N/500X/300X) we don't support it and don't guarantee the functionality.
In case you need to connect the PC directly with the 1100/1200 system using a LAN card, see chapter 3.3.4 Single PC & network connection in the Agilent 1100 manual.
When the communication with the Agilent 1100/1200 system by the GP-IB card could not be established, even if all the parameters are set correctly and the Agilent IO Libraries report the module as connected on the used ID address, then it is necessary to check the Agilent IO Libraries.
The Agilent IO Libraries must be closed (Use the Exit command) before the communication with Clarity can be established.
During the installation of the Agilent IO Libraries, they are added to the programs to be started automatically at the system start. It is necessary to disable this function because they could not run simultaneously with Clarity.
When using the GP-IB USB converter, it may be necessary to disconnect the converter from the PC to clear the communication buffers. As the USB can be powered even during a computer shutdown, the shutdown and restart may not help.
Yes, it is possible. If you already optimized global parameters and peaks are still not resolved, it is possible to try using the other integration algorithm which may provide better results. If this still does not help use the Add Positive function, choose the part of the unresolved peak which you want to split off and add the interval markers to the borders of the new peak. Both peaks will be separated by a vertical line now. Including the current peak's maximum in the interval would produce no result.
In Clarity 9.0 we changed our upgrade policy. For more details please see www.dataapex.com/upgrade.
In case the computer is connected to the Internet, just select the menu Help - Check for Updates in the Clarity main window. The new version will be offered. You may need to fill in the registration form and proceed with selecting the default options suggested.
Alternatively (when connection to internet is not available), you could download the version on another PC from our web pages, section downloads - full versions. You need to register (including the S/N of the station) and login, then download the update, transport it (by USB flash disc) to the PC with Clarity and run the file.
Most chromatography systems use a proprietary data format (the main reason is belief that it ensures data integrity for GLP-related requirements). To open and process such chromatograms in Clarity, they must be first exported from the original software into a suitable format. Most commonly used formats are AIA (.cdf files) or ASCII (.csv, *.txt, *.asc and other files). Clarity can import such files (only the chromatogram data, not integration method or result tables) and process them using the current instrument method.
Yes, Clarity can be connected to any LIMS using the import/export of text files. Results can be exported in various formats to the LIMS and the sample info can be imported from a TXT file into Clarity Sequence which you intend to process.
Please, see our manual describing the Clarity cooperation with LIMS: Cooperation with LIMS systems.
For preparative purposes, multiposition valves are frequently used as a simple fraction collector.
Knauer provides dedicated control modules for multiposition valve-based fraction collectors, however, they are available solely in the ClarityChrom Prep OEM version.
To use valves for this purpose in Clarity, it is usually necessary to combine a two-position (three-way) valve to perform the Collect/Waste function and a multiposition valve to perform the Next vial function. Clarity Valve control modules also support the needed Next position command. Using the General Purpose Fraction Collector module (requires A24 LC control module) and one of the controlled selection valves (Upchurch, Vici-Valco or Rheodyne MX II series), the fraction collector can be easily created.
To install the CTC PAL autosampler or Shimadzu LC-10/20 system it is necessary to disable the UAC (User Account Control) during installation, otherwise, it will be unsuccessful. Similar problems were reported for the installation of the Agilent 1100 system, again the UAC disabling helped.
Most probably you need an appropriate User Code (u/c) only. HW key keeps basic serial number XX-YYYYY (event. XX-YYYYYY) only and all information about valid version, number of instruments, extensions and control modules are part of the User Code.
Only when upgrading from Clarity Offline to Clarity or Clarity Lite it is necessary to replace the HW key with a new one.
The configuration files are the following:
We recommend backing up these files, in case of an accident you won't be forced to set everything up again.
You can see at least three sources of problem in analog way:
The Sample Rate needs to be set to provide enough points to adequately describe the peaks of interest. Recommended is at least 30 points per the narrowest peak width. The default value for DataApex's A/D converters is 10 Hz. This is suitable for most HPLC and packed column GC applications, the capillary GC and CE applications may need higher sample rates.
Accordingly to Sampling Rate, the Global Peak Width parameter has to be also amended.
When running Clarity on a very slow PC or laptop, we can recommend some tips which can improve the speed of Clarity in certain situations:
1) Set the appropriate threshold.
2) Set the appropriate frequency of data acquisition.
3) Turn off the unused tables in Clarity (Performance, SST).
4) Turn off the Overlay function during the Sequence.
5) Turn off the PostRun Printing.
6) In your antivirus SW, turn off the option "Check Files at Change", especially for files used by Clarity (*.raw and *.audit).
The minimum Clarity's hardware requirements can be found on the Compatibility page. Often it is very helpful to increase the memory in the PC (RAM) rather than improve processor (CPU) speed.
This happens usually when upgrading Clarity from an earlier version. The IQ program checks all registered files and in case they are no more used in the new version, they will cause the check to fail. However, the station will usually function correctly.
To get Passed for IQ results, it is necessary to:
The Uninstall Clarity command will remove the program files only, leaving the configuration and data intact.
Yes, it can, however, the philosophy of use is slightly different. The peak areas belonging to a selected group of peaks are summed and the group can be named and calibrated as a single compound. Please refer to the corresponding parts of the Reference and User Guides. Especially in the calculation of the Result table Total line and Amount % column, there are potential problems, if the calculation procedure is not understood properly.
The corresponding instrument displays only the simulated curve or has a so-called DEMO detector driver allocated instead of the data acquisition driver. Meaning that the signal is not real but simulated from a data file. The reason for the watermark "Simulated" could be one of the following:
A new project can be created (opened, changed,...) only in the current instrument directory. However, an arbitrary directory can be set for each instrument in the main Clarity window using the System - Directories command.
Yes, for this upgrade the part number (p/n) C540 is available.