Xcalibur Library User
Xcalibur Library User
Library Browser
User Guide
Creating and Searching Spectral Libraries
Software Version 4.0
XCALI-97780 Revision A August 2015
© 2015 Thermo Fisher Scientific Inc. All rights reserved.
Xcalibur is a registered trademark of Thermo Fisher Scientific Inc. in the United States.
Microsoft, Windows, and Excel are registered trademarks of Microsoft Corporation in the United States and
other countries. Adobe, Acrobat, and Reader are registered trademarks of Adobe Systems Incorporated in the
United States and other countries.
The following is a registered trademark in the United States and possibly other countries: NIST is a registered
trademark of the National Institute of Standards and Technology.
All other trademarks are the property of Thermo Fisher Scientific Inc. and its subsidiaries.
Thermo Fisher Scientific Inc. provides this document to its customers with a product purchase to use in the
product operation. This document is copyright protected and any reproduction of the whole or any part of this
document is strictly prohibited, except with the written authorization of Thermo Fisher Scientific Inc.
The contents of this document are subject to change without notice. All technical information in this
document is for reference purposes only. System configurations and specifications in this document supersede
all previous information received by the purchaser.
This document is not part of any sales contract between Thermo Fisher Scientific Inc. and a purchaser. This
document shall in no way govern or modify any Terms and Conditions of Sale, which Terms and Conditions of
Sale shall govern all conflicting information between the two documents.
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .v
Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Special Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vi
Contacting Us . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75
Preface
The Thermo Xcalibur™ mass spectrometry data system includes all the software needed to
create, search, and edit libraries. This guide describes the following:
• How to create and edit custom libraries for MS, MS/MS, or MSn spectra
• How to manage multiple libraries
• How to search multiple libraries
Contents
• Related Documentation
• Special Notices
• Contacting Us
Related Documentation
You can access the user guides (as PDF files) for the Xcalibur data system in two ways:
• From the computer taskbar by choosing Start > All Programs > Thermo Xcalibur >
Manuals > Xcalibur.
• From the home page – Roadmap view of the Xcalibur data system by choosing Help >
Manuals from the menu bar.
In addition to this guide, Thermo Fisher Scientific provides these guides for the Xcalibur data
system:
• Xcalibur Quick Start
• Xcalibur Getting Started Guide
• Xcalibur Data Acquisition and Processing User Guide
• Xcalibur Quan Browser User Guide
• Xcalibur Qual Browser User Guide
• XReport User Guide
Help is available from within the Xcalibur data system and the National Institute of Science
and Technology (NIST) Mass Spectral Search application.
Special Notices
Make sure you follow the precautionary statements presented in this guide. The special
notices appear in boxes.
Contacting Us
There are several ways to contact Thermo Fisher Scientific for the information you need. You
can use your smartphone to scan a QR code, which opens your email application or browser.
us.customer-support.analyze us.techsupport.analyze
@thermofisher.com @thermofisher.com
1. Go to www.thermoscientific.com.
2. Click Contact Us, select the Using/Servicing a Product option, and then
type the product name.
3. Use the phone number, email address, or online form.
Go to www.thermoscientific.com/support.
Go to www.thermoscientific.com/lc-ms.
Note To provide feedback for this document:
• Send an email message to Technical Publications (techpubs-lcms@thermofisher.com).
• Complete a survey at www.surveymonkey.com/s/PQM6P62.
Contents
• Library Browser Process Overview
• About Library Browser
Note Throughout this guide, the term Library Browser is used synonymously with the
term NIST MS Search (National Institute of Standards and Technology Mass Spectral
Search Program and Library System) to refer to the NIST™ MS Search desktop.
When using the Library Browser, you can export a spectrum from the Qual Browser window
to create a custom user library of MS/MS or MSn spectra, one entry at a time. To include a
spectrum in a library, open a raw data file1 in Qual Browser. Enhance a spectrum by averaging
several scans and by subtracting background scans. Then, export the spectrum to Library
Browser. See Exporting Spectrum Files to Library Browser for more information about this
process.
After exporting the spectrum to Library Browser, you can edit the spectrum information. For
example, you can change the name of the entry or specify the molecular weight or the CAS
(Chemical Abstract Service) registry number. You can even attach a chemical structure to the
library entry or select which mass-to-charge ratios to include. See Managing Libraries for
more information.
IMPORTANT For MS/MS and MSn spectra, however, do not delete any of the masses that
the data system detects because the presence of a particular mass-to-charge ratio, rather
than its intensity, is essential to identifying a compound.
Finally, the Xcalibur data system provides three ways to search libraries and print custom
reports:
• Automatically, by batch reprocessing data files in Sequence Setup with an appropriate
processing method (See Setting Up and Running Automated Library Searches for more
information.)
• Manually, by using a single spectrum in Qual Browser (See Submitting a Spectrum to a
Library Search in Qual Browser for more information.)
• Manually, by exporting a spectrum to Library Browser (See for more information.)
To print custom reports during sequence processing or batch reprocessing, you must select an
appropriate report template in the processing method. In addition, you can set up the
processing method to automatically export spectra to a user library in Library Browser during
sequence processing or batch reprocessing.
To print a custom report following a manual library search in the Qual Browser or Library
Browser window, choose File > Print from the Qual Browser menu bar or File > Print
Report from the Library Browser menu bar.
1 A raw data file is an unprocessed data file acquired from a Thermo Scientific instrument controlled by the
Xcalibur data system or equivalent application.
Create a processing Add the processing method Set up batch processing to run a library
method with library to an existing sequence or search and print reports. Then, submit the
search parameters. a new sequence. sequence to the processing queue.
Note Thermo Fisher Scientific provides the NIST Mass Spectral Search Program (version
2.0f ) with the Xcalibur data system.
You can create user libraries using spectra from the following sources:
• Exported from Qual Browser
• Exported automatically during sequence processing or batch reprocessing
• From other sources including text files
For information about the features of the NIST Mass Spectral Search application, see the
Help system provided with the application.
The following procedures show how to export a spectrum file to the Library Browser window
using one of the steroid.raw data files in the following folder:
drive:\Xcalibur\examples\data
Follow these procedures to export spectrum files from Qual Browser to Library Browser or to
add spectrum files to an existing library during sequence processing or batch reprocessing.
Contents
• Opening a Raw Data File in Qual Browser
• Viewing a Spectrum in Qual Browser
• Subtracting Background Spectra
• Manually Exporting Spectrum Files from Qual Browser
• Exporting Spectrum Files Automatically During Sequence Processing
e. Click Open.
The TIC chromatogram and the first mass spectrum for this data file appear in the
grid (Figure 3).
Figure 3. Default layout for a raw data file
1. Beginning with the default layout of two cells in the grid, with the upper cell displaying a
chromatogram view and the lower cell displaying a spectrum view, add two more cells to
the grid:
• In the toolbar, click the Insert Cells Left icon, .
–or–
• On the menu bar, choose Grid > Insert Cells > Left.
All of the cells are inactive.
2. In the lower left cell, change the view to the scan filter view by right-clicking the cell and
choosing Scan Filters from the shortcut menu (Figure 4).
Note When none of the cells in the grid are pinned, clicking a cell makes it the active
cell. An active but unpinned cell has a gray border.
Shortcut
menu
3. In the lower left cell, change the range of the scan filters view to the entire time range of
the chromatogram as follows:
a. Right-click the scan filter view and choose Ranges from the shortcut menu.
The Scan Filter Range dialog box opens.
b. If the value in the Time box is 0.00, type a dash and the end time point for the
chromatogram in the box (Figure 5). Otherwise, set the time range to the full time
range of the chromatogram (first time point–last time point).
Figure 5. Scan Filter Range dialog box with a time range specified in the Time box
c. Click OK.
The scan filters view lists all the scan filters in the raw data file (Figure 6).
Figure 6. Scan filters
4. In the upper left cell, change the TIC chromatogram to a mass range chromatogram for a
selected scan filter as follows:
a. Click the pin icon, , in the upper right corner of the cell (pin the cell) to make it
the active and pinned cell .
The last entry in the scan filter list is for a mass range chromatogram of all ions
between m/z 150 to 375.
b. Select the last entry in the scan filter list.
The last entry becomes surrounded with a box and the cursor becomes a page cursor.
c. Drag the page cursor to the upper left cell.
When you release the page cursor, the upper left cell displays the mass range
chromatogram for the selected scan filter (Figure 7).
Figure 7. Mass range chromatogram for the selected scan filter (full MS2 m/z)
5. In the upper right cell, change the display to an averaged spectrum as follows:
a. Pin the cell.
b. Right-click the pinned cell and choose View > Spectrum from the shortcut menu.
c. In the upper left cell (full range MS2 chromatogram), drag the cursor across the
baseline width of the chromatographic peak.
An averaged spectrum appears in the upper right cell.
6. Pin the lower right cell and choose View > Chromatogram from the shortcut menu.
An unfiltered TIC chromatogram appears in the cell. Confirm that the grid looks similar
to the one in Figure 8.
Figure 8 shows the following views (clockwise from lower left): scan filter view, (filtered)
chromatogram view, (filtered) spectrum view (averaged, and chromatogram view
(unfiltered).
Figure 8. Qual Browser window
Chromatogram view (filtered) Spectrum view (averaged)
Leave this layout open and go to the next procedure, Subtracting Background Spectra.
These procedures describe the two ways you can perform background subtraction:
• Using the Subtract Background Tool
• Subtracting Background Spectra Graphically
For more information, refer to the Xcalibur Qual Browser User Guide.
3. In the chromatogram view, select a baseline region that is close to the chromatographic
peak of interest.
4. Drag the cursor away from the peak of interest and across a few scans that are
representative of the first scan range to subtract. Then, release the mouse button to define
the first range.
The cursor label changes to –2.
5. Select a baseline region on the other side of the peak of interest.
6. Drag the cursor away from the peak of interest and across a few scans that are
representative of the second scan range to subtract. Then, release the mouse button. to
define the second range.
When you release the mouse button, the data system subtracts an average of the selected
scans and redraws the spectrum view. The spectrum view header shows the number of
subtracted scans (Figure 11).
Choose Actions > Subtract Spectra > Clear from the menu bar.
Note For best results, read the documentation that the National Institute of Science and
Technology (NIST) provides with the NIST Mass Spectral Search application before you
export a spectrum file to the application.
This topic describes how to export a spectrum file from the Qual Browser window.
When an exported spectrum file does not match any of the spectrum files in the selected
library, the data system appends the new spectrum file to the library.
1. Choose GoTo > Processing Setup from the home page menu bar.
The Processing Setup window opens.
2. Choose View > Qual.
The Qual view of the Processing Setup window opens with the Identification page
displayed.
3. Click the Library Search Options tab to display the Library Search Options page.
4. Check the libraries that are in use as follows:
a. Click Search List.
The Search List dialog box opens.
b. Check the list of available libraries.
c. Add or remove libraries from the Available Libraries area, and then click OK to save
the changes and close the dialog box.
5. In the Append to User Library area, select the Enable check box.
Figure 12 shows the Append to User Library area on the Library Search Options page in
the Processing Setup – Qual view.
Figure 12. Append to user library area
6. In the User Library list, select an existing library or type the name of a spectral library
where you want to append the exported spectra.
If you type a new library name, the library is created only if a spectrum fails the matching
criteria. To ensure that spectrum files are appended to the specified library, enter the
highest possible values in the Thresholds boxes. The data system only appends spectrum
files that fail the matching criteria.
7. Type threshold values for Match Factor, Reverse Match Factor, and Probability%. To
confirm that all spectra are appended to the library, type 999, 999, and 100 respectively.
During processing and after any requested enhancement of a relevant chromatogram peak
apex scan, the Xcalibur data system submits the spectrum to a library search:
• If the top hit from a library search exceeds (or is equal to) any one of the
threshold values, the data system returns the hit list and the spectrum is not
appended to the specified library.
• If the top hit fails to reach any of the threshold values, the data system discards
the hit list (no search results are reported) and appends the searched spectrum to
the specified library. Unless otherwise specified, the library is stored in the
NIST\MSSearch folder.
8. Save the processing method.
1. From the Processing Setup window, open the Sequence Setup view by choosing GoTo >
Xcalibur Home Page from the menu bar. If the Sequence Setup view is not displayed,
open it by choosing View > Sequence Setup View.
2. Do one of the following:
• If you have not already acquired a set of raw data files, create a new sequence as
described in the Xcalibur Data Acquisition and Processing User Guide.
• If the acquisition sequence that contains the raw data files you want to process is not
open, choose File > Open. Then, in the Open dialog box, browse to the appropriate
folder, select the sequence file (SLD) of interest, and click Open.
3. If you have not already added the processing method to the sequence, do the following:
a. Double-click the Processing Method column.
The Select Processing Method dialog box opens (Figure 13).
b. Browse to the appropriate folder, select the processing method (PMD file) of interest,
and click Open.
4. Do one of the following:
• To export the spectra during data acquisition, in the Processing Actions area of the
Run Sequence dialog box, select the Qual check box.
• To export the spectra during batch reprocessing, in the Batch Reprocess dialog box,
select the Qual check box. Then, select the Peak Detection and Integration check
box and the Library Search check box.
If the library that is specified in the processing method does not exist, the Xcalibur data
system creates it.
When a spectrum is added to a user library, it contains the following basic information:
• Complete mass/intensity list
• Name formatted as <filename>#<scannumber> RT: <rt> AV: <av> NL: <nl>, for
example: steroids02#1 RT: 0.01 AV: 1 NL: 2.14E3
• Comment showing the scan filter, such as T: + c Full ms2 363.30 [150.00 – 375.00]
• Molecular weight (Mol Weight) and CAS number set to zero
You might want to modify the basic information or provide the following:
• Chemical formula
• List of synonyms
• Molecular weight
• CAS number
• Chemical structure (in MOL, SDF, or MDL file format)
When you attach a structure to the file, you can automatically add the chemical formula
and molecular weight to the file by clicking From Structure as described in Managing the
NIST Libraries.
Managing Libraries
In the Library Browser window, you can create, manage, and search user libraries. Use these
functions to create reference libraries from your own spectra.
Follow these procedures to add your spectrum files to a user library, to manage your library
list, and to convert your libraries to another format.
The data system stores the spectral libraries in the following folder:
drive:\Program Files\NISTMS\MSSEARCH\
Contents
• Adding Spectrum Files to a User Library
• Managing the NIST Libraries
• Converting Libraries to Another Format
The following procedure describes how to add a spectrum that you manually exported from
the Qual Browser window to a user library.
1. Export a spectrum from Qual Browser. See Manually Exporting Spectrum Files from
Qual Browser.
The Library Browser window opens.
2. Choose Window > Librarian.
The Librarian window opens.
3. In the Spec. List, select the spectrum that you want to add to a library (Figure 14).
The Spec List contains one row for each spectrum. The Src column lists the source of the
spectrum as one of the following: a text file (A), the Spectrum Editor (E), or a library.
User libraries are coded with the first two letters of the library name. The Name column
lists the spectrum name.
Figure 14. NIST MS Search 2.0 – Librarian window
5. Choose the library that you want to add the spectrum file to or type the name of a new
library in the box.
6. Click OK to add the new spectrum file to an existing library or to a new library.
A message box that lists the name of the library and the number of spectra in the library
appears (Figure 16).
Figure 16. Information about the library
For more information about the Manage Libraries page of the Library Manager application,
see Library Manager Application.
Adding a Library
When you add a library to the NIST libraries list, either copy the library file to the local
computer or link to the library at a remote location without copying files.
To add a library
1. Open the Manage Libraries page of the Library Manager application as described in
Managing the NIST Libraries.
2. Click Add.
The Add Library dialog box opens (Figure 18).
Figure 18. Add Library dialog box
3. In the Add Library dialog box, type the path for the new library file in the Source box or
click Browse to bring up the Browse for Folder dialog box and find the file of interest.
4. Select one of the two options:
• Copy the library to the local computer.
• Link to the library from either a remote location or computer.
Tip Because libraries can be large, you can often save time by selecting the Link
option rather than the Copy option.
5. Click OK.
The data system adds the selected library to the NIST Libraries list in the Library
Manager application.
6. If you have no more tasks to complete with the Library Manager, click Exit.
Deleting a Library
To delete a selected library in the NIST Libraries list
1. Open the Manage Libraries page of the Library Manager application as described in
Managing the NIST Libraries.
2. Select a library to delete from the NIST Libraries list.
3. Click Delete.
The system prompts you to confirm the deletion.
4. To delete the selected library, click Yes.
5. If you have no more tasks to complete with the Library Manager, click Exit.
Copying a Library
You can copy a selected library to another directory on the computer or network by using the
Archive feature.
To copy a library
1. Open the Manage Libraries page of the Library Manager application as described in
Managing the NIST Libraries.
2. Select a library to copy from the NIST Libraries list.
3. Click Archive.
The Archive Library dialog box opens (see Figure 19).
Figure 19. Archive Library dialog box
4. Type the path for the copied library file in the Destination box or click Browse to bring
up the Browse for Folder dialog box and find the desired location.
5. To copy the selected library to the remote location, click OK.
6. If you have no more tasks to complete with the Library Manager, click Exit.
For more information about the Convert Libraries page, see Convert Libraries Page.
Figure 20. Convert libraries page
1. Open the Library Manager application as described in Managing the NIST Libraries.
2. Click the Convert Libraries tab to open the Convert Libraries page.
3. In the Source Library Details area, do the following:
• In the Type list, select the type of source library, based on the file name extension.
• In the Library box, type the path to the source library or click Browse to open the
Browse for Folder dialog box and find a file.
• In the Process Entries box, to convert only certain entries from the source library,
type the number range of the entries to convert. For example, to convert only entries
#100 to #200, type 100–200.
4. In the Target Library Details area, do the following:
• In the Type list, select the type of target library based on the file name extension.
• In the Library box, type the path to the target library or click Browse to open the
Browse for Folder dialog box and find a folder.
Note When you select NIST as the target library type, the default target library is
the library folder for the Xcalibur data system: C:\NIST02\MSSEARCH\.
When you select ICIS/GCQ/ITS 40 or MassLab as the target library type, the Title
box becomes available.
• In the Title box, type the title for the converted library.
5. In the Options area, do the following:
• Select either the Create/Replace option or the Append option.
Create/Replace is selected by default.
When you select NIST as the source library type, the Include Replicate Entries from
the NIST Library in the Target Library check box becomes available.
• Click the Include Replicate Entries from the NIST Library in the Target Library
check box to copy replicate entries.
When you select the Include Replicate Entries check box, the Replicate Library box
becomes available. The data system stores the default replicate library, REPLIB, in
the following folder:
drive:\NIST02\MSSEARCH\
• To use a different replicate library, type the path to the desired library in the Replicate
Library box or click Browse to open the Browse for Folder dialog box and find a
folder.
6. To begin the conversion process, click Convert.
The Conversion Status box displays sequential chronological (top to bottom) messages
such as:
Started the conversion on SEP 3, 1999 at 10:01, please wait
Finished the conversion on SEP 3, 1999 at 10:02
Converted 570 entries
7. If you have no more tasks to complete with the Library Manager, click Exit to close the
Library Manager application.
Searching Libraries
After you create a custom library, you can use it for library searches. You can search spectral
libraries in three ways:
• Manually from within the Qual Browser window
• Manually from within the Library Browser window
• Automatically during sequence processing or batch reprocessing
Follow the procedures in this chapter to run library searches in the Qual Browser window or
during batch processing.
Contents
• Submitting a Spectrum to a Library Search in Qual Browser
• Setting Up and Running Automated Library Searches
The interactive cells of the Library Search Results window show the following library
search results, displayed clockwise from the upper left quadrant:
• Hits list (a list of matching spectrum files)
• Molecular structure, including formula, molecular weight, name, and library index
number
• Difference spectrum (Raw Data minus Library Entry)
– Peaks above the x axis are relatively more intense in the spectrum than in the
library entry.
– Peaks below the x axis are relatively more intense in the library entry than in the
sample spectrum.
• Comparison of the sample spectrum and the library entry
Note When you print a report from the Qual Browser window, the data system uses
the default printer for the data system computer.
For more information about this window, see Library Search Results Window.
To run automated library searches and print reports, follow these procedures:
1. Setting Up Library Searches in a Processing Method
2. Setting Up the Qualitative Processing Sequence
3. Batch Reprocessing the Sequence and Printing Library Search Reports
Note Using the Library Search Constraints page requires specific knowledge about the
compounds you are looking for. When you are running a qualitative analysis on a sample
set, you might not know what compounds are in the samples, so it is not always possible
to use the parameters on the Library Search Constraints page to refine automated
processing.
Follow these procedures to set up the library search parameters for a processing method:
1. Setting Up the Identification Parameters for a Qualitative Processing Method
2. Setting Up the Library Search Options in a Processing Method
3. Specifying the Libraries for an Automated Search
4. Setting Up the Search Constraints for an Automated Library Search
5. Setting Up Reports for Automated Library Searches
1. Open the Qual view of the Processing Setup window (see To open the Qual view of the
Processing Setup window).
2. Open a representative raw data file as follows:
a. From the menu bar, choose File > Open Raw File.
The Open Raw File dialog box opens.
b. Browse to and select an appropriate raw data file. Then, click Open.
The chromatogram and spectrum views become populated with data from the raw
data file (Figure 25).
Figure 25. Qual view of the Processing Setup window with an example raw data file
ICIS This algorithm has been designed for MS data and has superior peak
detection efficiency at low MS signal levels. This is the Xcalibur
default peak detection algorithm.
Genesis This algorithm is the original Xcalibur peak detection algorithm and
has been provided for backward compatibility with Xcalibur 1.0 data
system studies.
Avalon This algorithm supports detectors other than MS and detects negative
chromatographic peaks and shoulders more accurately than Genesis or
ICIS.
Note For the following procedure, the ICIS Advanced Parameters dialog box
opens. If you choose another peak detection algorithm, a different Advanced
Parameters dialog box opens. Fill in the values that are appropriate for the
method.
f. Confirm that the INCOS Noise option is selected in the Noise Method area.
Figure 26. ICIS Advanced Parameters dialog box
g. To close the dialog box and return to the Processing Setup window, click OK.
h. To apply changes to the Identification page, click OK.
Go to the next procedure, Setting Up the Library Search Options in a Processing Method, to
set up the library search options.
For more information about creating a processing method, refer to the Xcalibur Data
Processing and Acquisition User Guide.
Note The Xcalibur data system uses the NIST Mass Spectral Search Program algorithms
to perform its library searches. The algorithms and related software are distributed by the
Standard Reference Data Program of the National Institute of Standards and Technology
and are the copyright of the US Secretary of Commerce.
b. Select the user library and specify the spectrum thresholds as follows:
• From the User Library list, select the target user library.
• Type a threshold value in the Match Factor box.
• Type a threshold value in the Reverse Match Factor box.
• Type a threshold value in the Probability (%) box.
7. To save the settings on the Library Search Options page, click OK.
Leave the Library Search Options page open and go to the next procedure, Specifying the
Libraries for an Automated Search.
1. On the Library Search Options page of the Processing Setup – Qual view, click Search
List (Figure 27 on page 40).
The Search List dialog box opens (Figure 28).
Figure 28. Search List dialog box
2. To select a library to search, select the library name in the Available Libraries list and click
Add to move it to the Selected Libraries list.
3. Click OK to select that library and return to the Processing Setup – Qual view.
To set up search constraints for the automated library search, go to the next procedure, Setting
Up the Search Constraints for an Automated Library Search. Otherwise, go to Setting Up
Reports for Automated Library Searches to add a library search report to the method.
Setting up the options on the Library Search Constraints page requires specific knowledge
about the target compounds in the chromatogram. Acquiring this knowledge is not always
possible with a qualitative analysis.
The Library Search Constraints page contains five groups of options to constrain the library
search (Figure 29). To display the Library Search Constraints page, from the Qual view of the
Processing Setup window, click the Library Search Constraints tab.
Set parameters and save your settings by clicking OK. To save your settings for future
searches, click Save as Default.
Note This constraint is not available if you have already selected the Search with
MW= check box on the Library Search Options page of the Processing Setup – Qual
view.
To limit the library search to entries in the NIST library that are also featured in other
databases
1. Select the Enable check box in the Other Databases area (Figure 31). NIST library entries
contain references to other commercial databases if they contain information about the
compound.
Figure 31. Other databases area
2. Select one or more databases from the available list. To use a database constraint, select its
check box. If you do not want to use a database constraint, make sure its check box is
clear.
The data system only reports search results if they feature in one or more, but not
necessarily all, of the selected databases.
1. Select the Enable check box in the Name Fragment area (Figure 32).
The Name box accepts a text string (up to 39 characters) to represent a fragment of a
compound name, for example, “cyclo”. The library search filters the search results and
only returns those containing the specified text in their names. The entry is not case
sensitive; for example “CYCLO” returns compounds containing the fragments “cyclo”,
“Cyclo”, “CYCLO”, and any other case permutations.
Figure 32. Name fragment area
To constrain the library search to compounds with specific element profiles, follow one of
these methods:
• To use the Individual Elements constraints
• To use the Elements in Compound constraints
You do not need to provide a complete elemental profile. The library search returns
compounds if they satisfy all the specified criteria regardless of any other elements
present. Use this option to specify which elements you do not want to be in a library hit
(spectrum match). For example, C = 0 confirms that no search results contain carbon.
When a contradiction occurs, for example, C < 2, and C > 4, the data system displays an
error message. Correct the contradiction to proceed.
2. In the Individual Element area, do the following for each element that you want to
constrain:
• In the Element column, type the required element abbreviation. You must use the
IUPAC approved abbreviation for each element. For example, type capital F for
fluorine or Cl for chlorine.
• In the Condition column of the same row, select from the three available conditions:
< (less than), > (greater than), or = (equal to).
• In the Value column of the same row, type the required number of atoms for the
element constraint condition.
4. Select the Some option to have the returned search results contain at least one of the
specified elements and no elements other than those listed. For example “C, H, O” would
return CO2, CH4, and HCHO but not CH2Cl2 (Cl not allowed).
If you leave the box blank, the data system does not apply the Elements in compound
constraint function. If you type an invalid element, the data system reports an error when
you click anywhere else on the page.
If there are no contradictions, you can use the two types of elemental constraints together. For
example, if the Individual Element area contains “C=0” or “C<1" and the Elements In
Compound box contains “C” when the All option has been selected, the data system displays
an error message. Correct the contradiction to proceed.
The Mass spectral peak constraint feature builds a profile of ions and their abundances to be
matched against library entries during the search.
For information about the parameters in the Mass Spectral Peak Constraints area, refer to the
Xcalibur Data Acquisition and Processing User Guide.
1. Select the Enable check box in the Mass Spectral Peak Constraints area (Figure 34).
The search algorithm only returns search results matching the specified constraints.
Figure 34. Example of a relative mass spectral peak constraint
3. For each mass spectral peak that you want to constrain, do the following in the Mass
Spectral Peak Constraints table:
• In the Type list, do the following:
– Select from the four available types for the Absolute option: Normal, Loss, Rank
or Maxmass.
– Select from the two available types for the Relative option: Normal or Loss.
• In the m/z column of the same row, do the following:
– For a Normal, Rank, or Maxmass type constraint, type the m/z value of the mass
spectral peak to be constrained. The valid range is 0–2000,
– For a Loss type constraint, type the value of a neutral loss. The valid range is
0–64.
• In the From column of the same row, do the following:
– For a Normal, Loss, or Maxmass type constraint, type the minimum abundance
of the constrained mass spectral peak.
– For a Rank type constraint, type the lowest position of the ion in an intensity
ordered list of spectral peaks.
For the Rank type constraint, the From value cannot be greater than the To
value. If the From value equals the To value, the designated ion must have that
rank in the retrieved spectrum.
• In the To column of the same row, do the following:
– For a Normal, Loss, or Maxmass type constraint, type the maximum abundance
of the constrained mass spectral peak.
– For a Rank type constraint, type the highest position of the ion in an intensity
ordered list of spectral peaks.
Note If you switch between Absolute and Relative modes, the Xcalibur data
system prompts you with a warning message before clearing all rows in the grid.
2. If the Apply Changes? dialog box opens, read the message and click Yes.
3. Click the Enable cell in the Sample Reports area. When a check box appears, select the
check box to make row 1 active (Figure 36).
Figure 36. Reports view with Row 1 active
b. Type file summary information in the Description box and click OK.
The Save As dialog box opens.
c. Type a name for the processing method in the File Name box (Figure 39).
Figure 39. Save As dialog box
d. To save the method and return to the Reports view, click Save.
8. To close the Processing Setup window and return to the Xcalibur home page, choose File
> Exit.
For information about creating a processing method for automated library searches, see
Setting Up Library Searches in a Processing Method.
To batch reprocess the sequence and print reports, go to the next procedure, Batch
Reprocessing the Sequence and Printing Library Search Reports.
Tip During batch reprocessing, the data system sends the user-specified reports to the
default printer for the data system computer. You can select the paper size and page
orientation in the Page Setup dialog box. To open this dialog box, choose File > Page
Setup from the menu bar.
5. Confirm that the Process Rows box lists all row numbers (for example 1–2). If the
numbers are missing, double-click the box and type the row numbers.
6. To perform a library search, select the Qual check box. Then, select the Peak Detection
& Integration check box, the (optional) Spectrum Enhancement check box, and the
Library Search check box.
7. To print the library search sample report, select the Reports check box. Then, select the
Print Sample Reports check box.
8. To initiate batch processing of the selected samples, click OK. If the data system prompts
you to save your changes, click Yes in the confirmation box.
9. To display the Processing Status window (Figure 42), click the Queue Manager task in
your computer task bar.
Figure 42. Processing Status window
Contents
• Report from a Library Search During Batch Reprocessing
• Report from a Library Search Using Qual Browser
Library Browser
This chapter describes the Library Manager application that you can access from the Tools
menu on the Xcalibur home page and the Library Search Results window that opens when
you submit a library search from the spectrum view of the Qual Browser application.
Contents
• Library Manager Application
• Library Search Results Window
For more information about the NIST MS Search application, refer to the Help provided
with the application.
ICIS/GCQ/ITS 40
MassLab
ANDI-MS
NIST
Note The Xcalibur data system does not directly support INCOS, LAB-BASE, or
JCAMP library conversions. However, MassLab data system users have a conversion
program to convert from a LAB-BASE user library to a MassLab user library. In addition,
a conversion tool exists in ICIS (a UNIX system) that can convert a LAB-BASE user
library to a MassLab user library.
If you select source library file type AutoMass, you can only select
the NIST target library file type.
If you select the library type NIST, the Xcalibur data system
displays the path to the NIST library folder in the Library box.
You specified this location when you installed NIST.
If you select the library type NIST, the Xcalibur data system
displays the path to the NIST replicate library folder in the
Library box. You specify this location when you install NIST
software.
Because libraries can be large, you might save time by using the
Link option rather than the Copy option.
Click OK when you have selected the library you want to add and
selected Action options.
Click Yes. The Xcalibur data system removes the library from the
list.
Archive Copies a selected library to another directory on your computer or
network. Select the library that you want to copy to another
directory. Click Archive. The Archive Library dialog box opens.
Use Browse to select a destination for the selected file. Click OK.
The data system makes a copy of the selected NIST library and
stores it in the selected directory.
The Library Search Results window displays matching library spectra (hits) in a four-pane
arrangement. Clockwise from the top left, the four panes are Hit List, Molecular Structure,
Difference Spectrum, and Comparison.
Hit List
The Hit List lists the best matches found during the library search. Three factors describe the
accuracy of the match to your spectrum:
SI A direct matching factor for the unknown and the library spectrum.
RSI A reverse search matching factor ignoring any peaks in the unknown that are
not in the library spectrum.
Prob A probability factor based on the differences between adjacent hits in an SI
ordered list.
With the SI and RSI matching factors, a perfect match results in a value of 1000. As a general
guide 900 or greater is an excellent match; 800–900, a good match; and 700–800, a fair
match. A matching factor less than 600 is a poor match. Unknown spectra with many peaks
tend to yield lower match factors than otherwise similar spectra with fewer peaks.
The probability factor is a complex parameter based on the SI matching factor and the
difference between adjacent matches. If a hit has an SI match factor > 900 and the next best
hit has a match factor of 300, the probability of the compound being correctly identified is
high. Conversely, if several hits are returned with very similar SI matching factors, the
probability of a correct assignment is low.
Molecular Structure
Shows the formula, structure, molecular weight, name and library index number of the
currently selected hit in the Hit List.
Difference Spectrum
Compares the submitted spectrum with the currently selected library spectrum in the Hit
List. Peaks above the x axis are relatively more intense in the sample than the library entry.
Negative peaks are relatively more intense in the library entry than in the sample spectrum.
Comparison
Displays the submitted spectrum above the currently selected library spectrum in the Hit List
pane (list of matching spectrum files).
Note Avoid making positive assignments based solely on the statistical result of a library
search. The Xcalibur data system might identify a compound with an unusual structure
(or, more importantly, an unusual mass spectrum) in a definitive way. More usually, your
unknown might be a member of a class of compounds with very similar mass spectra. The
ability of Qual Browser or any search system to distinguish between them is limited. In
many cases, the best that the search algorithm can do is identify a class of compounds that
have similar mass spectra — and usually similar structure. In most cases, you should seek
confirmation by other analysis techniques.
Index
C L
contacting us vii LAB-BASE user library 67
converting libraries to another format 27 libraries
copying a library from the NIST Libraries list 26 adding, to NIST Libraries list 25
CRC Handbook of Data of Organic Compounds converting to another format 27
database 45 copying, from NIST libraries list 26
creating a library entry with your spectral data 24–27 creating entries in 24–27
deleting from the NIST Libraries list 26
custom
reports, example 52 searching
during batch reprocessing 37
user library 17, 23
in Qual Browser 32
Library Browser window
D about 4
deleting a library from the NIST Libraries list 26 Library Manager application 24
dialog boxes Library Search Constraints page
Search List 17 element constraints 46
Search Properties 32 elements in compound 47
mass spectral peak constraints 48
molecular weight 44
E name fragment 46
element constraints 46 Library Search Results window 73
elements in compound 47
library searches R
adding to processing method 40
Registry of Toxic Effects Chemical Substances database 45
creating a sequence for 55
reports
adding a report template to the processing method 52
M adding to processing method 50
Mass spectral peak constraints 48 printing
MassLab user library 67 in Qual Browser 36
Match factor threshold 18 in Sequence Setup 57
molecular weight, constraining a library search 44 reverse search, match factor threshold 18
N S
Name Fragment constraint 46 scan filter view 9
National Institute of Standards and Technology 1, 4 Search List dialog box 42
Neutral Loss option 41 spectrum files
adding to library 5
NIH-NCI Inventory File database 45
manually exporting 16
NIST Browser 4
Subtract Background window 12
NIST MS Search 4
subtracting background spectra 14
NIST/EPA Gas Phase IR database 45
P T
text file label, spectrum 22
Penalize Rare Compounds option 41
Thermo Library Manager application
printing reports
Convert Libraries Page 68
from Qual Browser 36
Manage Libraries Page 71
from Sequence Setup 58
thresholds, append to user library option 18
probability threshold 18
Toxic Substances Control Act Inventory database 45
processing methods
adding a library search 40
exporting a spectrum 19 U
Processing Setup window US Pharmacopoeia database 45
opening 37 user guides, Xcalibur v
Qual view user libraries
Identification page 38 adding 25
Library Search Constraints page 43 creating 21
Library Search Options page 40 including in a search
opening 37 in a processing method 42
Search List dialog box 42 in Qual Browser 32
Q V
Qual Browser window viewing a spectrum in Qual Browser 8
cursor actions in views 8
exporting a spectrum to Library Browser 16
grid layout 8
Library Search Spectrum icon 34
library searches in 32
Print dialog box 36
Search Properties dialog box 32
subtract background tool 12
using views interactively 8