Micromass Quattro Micro Interfacing Guide
Micromass Quattro Micro Interfacing Guide
Interfacing Guide
Version 3.5
4 September, 2000
Page i
Interfacing Guide
Interfacing Guide
The software described in this book is furnished under a license agreement and may
be used only in accordance with the terms of that agreement.
Copyright Notice
Micromass Ltd believes that the information in this publication is accurate. However
the information is subject to change without notice and should not be construed as a
contractual undertaking by Micromass Ltd. Despite the care which has been given to
the preparation of this publication, Micromass Ltd accepts no responsibility for any
loss or any other matter which may arise from any error or inaccuracy which may
inadvertently have been included.
No part of this publication may be copied without the express written permission of
Micromass Ltd.
Trademarks
Page ii
Interfacing Guide
Table of Contents
Importing 5
Copying Data 5
Import Worksheet 6
To Import a Worksheet 6
Creating Import Files 7
Access 97 7
Excel 8
Notepad 8
Import Data 8
To Import Data 8
Creating Import Files 9
Access 97 9
Excel 9
Notepad 9
Exporting 10
Export to LIMS File 10
Copying to and from the Windows NT Clipboard 13
Export SEQUEST file 15
OpenLynx Batch Files 16
Paragraphs 16
Batch Block 17
Plate Block 17
Sample Block 18
Fields 18
Comments 18
File Format 19
OpenLynx Browser 23
Sections 23
Fields 23
Comments 23
Tabulated Sections 24
Free Format Text Sections 24
File Section Descriptions 25
MetaboLynx Browser 34
Sections 34
Fields 34
Comments 34
Tabulated Sections 35
Free Format Text Sections 35
File Section Descriptions 36
ProteinLynx Browser 46
Sections 46
Fields 46
Tabulated Sections 46
File Section Descriptions 47
Bio-Rad File Descriptions 53
File Formats 56
Sample List 56
An Example Generic Sample List File 59
AutoLynx 60
Status.ini 62
File Format 63
Page 1
Interfacing Guide
Index 69
Page 2
Interfacing Guide
Conventions
The Interfacing Guide follows these typographic conventions
This Represents
italic Place holders for information you must provide. For example
if you are asked to type filename, you would type the actual
name for a file instead of the word shown in italic type.
Keyboard Formats
KEY1+KEY2 A plus sign (+) between key names means to press and hold
down the first key while you press the second key. For
example, "press ALT+ESC" means to press and hold down the
ALT key and press the ESC key. Then release both keys.
KEY1,KEY2 A comma sign (,) between key names means to press and
release the keys one after the other. For example, "press
ALT,F" means to press and release the ALT key and then press
the F key.
Page 3
Interfacing Guide
This manual is designed to explain how data can be imported into and exported from
MassLynx for use in other applications. When you have read this manual you
should be able to -
This manual assumes that you have no previous knowledge of MassLynx. However
this manual does assume that you are familiar with using the Microsoft Windows
NT Graphical Environment and have the basic skills required to work with
Windows NT software.
If you have never used Microsoft Windows NT before we would suggest that you
spend a short time reading “Chapter 2 Learning the Basics” in the Microsoft
Windows NT Workstation Start Here guide supplied with your Windows NT
software.
This manual also assumes knowledge of Access, Excel, Notepad and LIMS systems.
Page 4
Interfacing Guide
Importing
There are several ways of importing data into a Sample List:
• Copying and pasting data from text editors, Access and Excel.
• Import Worksheet.
• Import Data.
Copying Data
Data created in other Windows applications can be copied to the clipboard and
pasted into the Sample List editor.
1. Press the button or select New from the File menu. If the previous
Sample List has not been saved you will be prompted to save it. A Sample
List with one default row will be displayed.
2. Add rows and columns to the Sample List so that it matches the number of
rows and columns as the other Windows application. Note if this is not done
data may be lost.
3. Select the relevant area in the other Windows application and copy it.
4. In the Sample List editor, position the cursor on the cell at the top left corner
of the paste area and select Paste.
Notes:
If copying from a text editor e.g. Notepad fields must be tab delimited.
When copying from an Access database the last record is not pasted and will have to
be entered manually.
Page 5
Interfacing Guide
Import Worksheet
Sample Lists can be created in a number of other packages and imported into
MassLynx. MassLynx V3.0 and V3.1 allowed OpenLynx batch files and
MassLynx V2.3 Sample List files to be imported. While these options are still
supported, there are now several other file types that have been added.
• ACCESS 97
To Import a Worksheet
2. Locate the required file, or type in a file name, and press Open. Generic
Batch files created in OpenLynx are the default file types. Click on the
arrow, at the end of the Files of type box, to import a different file type.
Page 6
Interfacing Guide
The following is a list of instructions on how to create files suitable for importing
into MassLynx.
For all types of file fields must have the same name as in the Sample List (see
Sample List on page 56) although they can be defined in any order. For Access 97
the data type must also match. The names correspond to the name in brackets on the
Customize Field Display dialog.
Access 97
It is recommended that the design view is used when creating a new table, this
allows you to define the data type of the field.
You must have the first column called Index as the primary key. Column headings
must match those shown on page 56. Other columns can be present but they will not
be imported into the Sample List.
1. Select Number from the drop down list box in the Data Type column.
2. On the general page, at the bottom left of the screen, click on Field Size and
select Double from the drop down list box.
The table can be saved as an access database by selecting Save from the File menu
and can be imported into MassLynx in this format. Tables can also be saved as tab
or comma delimited files for importing into MassLynx.
3. Make sure the Delimited option is selected and press the Next button.
4. Check the Include Field Names on First Row option, select the type of
delimiter to use and press the Next button.
5. Enter the name to save the file as and press the Finish button.
If files are saved as comma or tab delimited then they must be imported into
MassLynx as comma or tab delimited files.
Page 7
Interfacing Guide
Excel
You must have the first column called Index, other column headings must match
those shown on page 56.
Select the area containing the data to be imported, including the column headings,
and name the area ANALYSIS. To do this select Define from the Name option on
the Insert menu, type ANALYSIS and press OK.
For a text field containing only numeric data an apostrophe ( ‘ ) must be inserted in
front of the number.
If the file is to be saved as tab or comma delimited then Excel will only allow one
sheet to be saved. If the current workbook contains more than one worksheet then
each worksheet must be saved as a separate text file.
Notepad
You must have the first column called Index, other column headings must match
those shown on page 56.
Type in the field name/value and then a comma (or press tab for tab delimited files)
and enter the next value. End each line with a carriage return.
Import Data
Sample List data can be created in a number of other packages and imported into
MassLynx. The file types supported are:
• ACCESS 97
To Import Data
1. In MassLynx ensure that the correct number of rows and columns is displayed.
If this is not done then data will be lost.
3. Locate the required file, or type in a file name, and press Open. Excel 5.0 files
are the default file types. Click on the arrow, at the end of the Files of type
box, to import a different file type.
Page 8
Interfacing Guide
The following is a list of instructions on how to create files suitable for importing
into MassLynx.
• Fields must be in the same order as they are to appear in the MassLynx Sample
List
Access 97
It is recommended that the design view is used when creating a new table, this
allows you to define the data type of the field.
If files are saved as comma or tab delimited then they must be imported into
MassLynx as comma or tab delimited files.
Excel
Select the area containing the data to be imported, including the column headings,
and name the area ANALYSIS. To do this select Define from the Name option on
the Insert menu, type ANALYSIS and press OK.
For a text field containing only numeric data an apostrophe ( ‘ ) must be inserted in
front of the number.
If the file is to be saved as tab or comma delimited then Excel will only allow one
sheet to be saved. If the current workbook contains more than one worksheet then
each worksheet must be saved as a separate text file.
Notepad
Type in the field name/value and then a comma (or press tab for tab delimited files)
and enter the next value. End each line with a carriage return.
Page 9
Interfacing Guide
Exporting
There are several ways of exporting data from MassLynx:
• Export to LIMS.
The file generated will consist of three areas; the Header Section , the
Samples Section and the Calibration section.
The header section contains the following four sections. Each shows the full path
name of the file generated by or used to create the report and the date and time that
the file was last modified. All fields are text.
The compound section will include an entry for each sample in the current sample
list. The header will contain the File Name, Sample ID and any text entered in the
SPARE_1 to SPARE_5 fields in the sample list.
E.g. ASSAY01,ID,,,,,
Page 10
Interfacing Guide
Samples Section
For each sample there will be one entry for each compound named in the compound
box in the quantify method. Each entry will have the following fields, separated by
a comma. The data type column shows what type of field the data was exported
from.
The compound number shown in the compound box in the quantification method. int
The scan at which the matching peak was found in the current sample datafile. Int
The relative retention time at which the matching peak was found. Float
The blank subtracted concentration of the compound for this sample. Float
The chromatogram trace used to locate peaks for this compound. Char
The error between the expected concentration and the calculated concentration. Float
The ordinal number of the compound in the quantification method that is used as the Int
reference peak for this compound.
The area of the reference peak used for this compound for this sample. Float
The modification date of the peak used to quantify this compound for this sample. Text
This refers manual modification of the peak.
The retention time the peak was expected at for this compound. Float
Page 11
Interfacing Guide
The relative retention time the peak was expected at for this compound. Float
The calibration section will have a subsection for each calibration curve calculated
for the current quantification calibration. Each subsection will contain information
as displayed on the calibration graphs window. Where a line entry is inappropriate
it will not be entered in the report file.
• Response Type:
E.g.
Coefficient of Determination: 1
Calibration curve: 0.568051 * x + 0.0010347
Response type: Internal Std ( Ref 1 ), Area * ( IS Conc. / IS Area )
Curve type: Linear, Origin: Exclude, Weighting: 1/x, Axis trans: None
Coefficient of Determination: 1
Calibration curve: 0.336996 * x + -0.00516146
Response type: Internal Std ( Ref 1 ), Area * ( IS Conc. / IS Area )
Curve type: Linear, Origin: Exclude, Weighting: 1/x, Axis trans: None
All fields are text. It is possible to parse the correlation coefficients out, but their
format will depend on how the quantify methods are set up, so this will have to be
done on a per application basis.
Page 12
Interfacing Guide
2. Press the Toolbar button or choose Copy Chromatogram List from the
Chromatogram Edit menu. The section of the chromatogram on display will
be transferred to the Clipboard as (time, intensity) pairs or (scan, intensity)
pairs depending on the horizontal axis setting.
3. To read the information into another application, choose Paste from the other
application’s Edit menu.
Copying the Chromatogram list to the clipboard gives the following format.
2. Press the Toolbar button or choose Copy Detected Peaks from the
Chromatogram Edit menu. The chromatogram peaks on display will be
transferred to the Clipboard. The information transferred for each peak is the
peak top, height, area, start, end, start height and end height.
3. To read the information into another application, choose Paste from the other
application’s Edit menu.
Copying the Chromatogram list to the clipboard gives the following format.
Page 13
Interfacing Guide
2. Press the Toolbar button or choose Copy Spectrum List from the
Spectrum Edit menu. The section of the spectrum on display will be
transferred to the Clipboard as (mass, intensity) pairs.
3. To read the information into another application, choose Paste from the other
application’s Edit menu.
Copying the Spectrum list to the clipboard gives the following format.
Mass Intensity
Mass Intensity
Mass Intensity
Mass Intensity
Page 14
Interfacing Guide
1. Display the relevant centered MS/MS data file select Export SEQUEST file
from the File menu.
2. The Precursor ion mass is picked up from the data file, if it was entered in
the Function Editor, otherwise type in a value.
4. Enter any known sequence information in the Partial sequence info box.
5. File Path and Destination is the location and filename that the file will be
saved to. The file name is the original file name with the scan and function
numbers appended to it. To change the destination press the Browse button
and select a new destination from the dialog displayed, or type a new one in.
The file produced is an ASCII text file with the following format.
Page 15
Interfacing Guide
Paragraphs
The file will hold section blocks of data called paragraphs. A file will have a
“Batch” paragraph and at least one “Plate” paragraph, followed by a paragraph for
each sample to be analysed. Where there is more than one plate in an analysis, there
will be a paragraph for each plate followed by sample paragraphs for each sample.
A paragraph will always start with the name of the section surrounded by square
parentheses on a line by itself. i.e. [SectionName].
e.g. [SectionName1]
....Data Item 1...
....Data Item 2…
[SectionName2]
….Data Item 1…
….Data Item 2…
[Batch]
….Data Item 1…
….Data Item 2…
[Plate:1]
....Data Item 1...
....Data Item 2…
[Sample:1.1]
....Data Item 1...
....Data Item 2…
[Sample:1.n]
....Data Item 1...
....Data Item 2…
[Plate:2]
....Data Item 1...
....Data Item 2…
[Sample:2.1]
....Data Item 1...
....Data Item 2…
[Sample:2.n]
....Data Item 1...
....Data Item 2…
[Plate:m]
....Data Item 1...
....Data Item 2…
Page 16
Interfacing Guide
[Sample:m.1]
....Data Item 1...
....Data Item 2…
[Sample:m.n]
....Data Item 1...
....Data Item 2…
Batch Block
The first paragraph in the file will contain information that is pertinent to the whole
batch.
MSMethod
MSTune
LCMethod
EconomyScheduling
PriorityScheduling
AnalysisTime
ProcessParameters
Process
UserName
BatchID
UserAddress
SampleReportEnable
NumberOfPlates
Plate Block
A file will contain a plate block for each plate which will contain information that is
pertinent to the whole plate rather than a specific well. Within this plate block will
be information concerning the plate description, plate ID and wells used. Where
samples are not being presented in a plate this block can be used to describe the
batch of samples loaded into an autosampler carousel.
JobCode
UserName
Rows
Columns
Track
NumberOfWells
Page 17
Interfacing Guide
Sample Block
For each sample to be analysed there will be a sample block that contains well
position, and other information, specific to a certain sample.
Well
SampleDescription
Conditions
SampleID
MSDataName
SampleType
MSInjectionVolume
NumberOfMasses
Mass1
NumberOfFractions
NumberOfWaveLengths
NumberOfConcs
NumberOfFormulae
NumberOfFactors
NumberOfUserFields
Fields
Sections will have a group of fields, each field will be on one line. The field name
will be the first item on the line, followed by “=” and then the data item for that
field. The type of data will depend on the field type.
i.e. [SectionName]
FieldName1=Data1
FieldName2=Data2
...
e.g. [Plate:3]
JobCode=JB123456
NumberOfWells=96
Comments
Page 18
Interfacing Guide
File Format
[Batch]
When creating files manually the fields marked an (M) must be defined, all other
fields are optional.
MSTune Text The name of the MS Tune file to be used. If not specified the
current instrument tuning parameters will be used.
InletPreRunMethod Text The name of the acquisition Inlet prerun method to be used. If
not specified no prerun is performed.
InletPostRunMethod Text The name of the acquisition Inlet postrun method to be used. If
not specified no postrun is performed.
InletSwitchMethod Text The name of the acquisition Inlet column switch method to be
used. If not specified no switch method is performed.
PriorityScheduling Integer None zero if batch is to be run as a Priority task. Otherwise will
be scheduled normally.
AnalysisTime Float Time of analysis for each sample in the batch. Equals zero if no
time is specified.
ReportScheme Text Name of the OpenLynx Browser report scheme to use when
formatting output results.
HPLCMethod Text Path of HPLC method parameter override file if one exists.
Page 19
Interfacing Guide
[Plate:N]
PlateID Text Plate Identifier. A text description of the plate can be defined in
files created externally. This is not generated in files created
from the OpenLynx Login program.
PlatePosition Text The description of the plate position, as co-ordinates for plate
position in the autosampler bed.
1. X,Y.
Or
Page 20
Interfacing Guide
[Sample:N:M]
Well (M) Text The description of the well position, as co-ordinates for well
position in plate, or an absolute position. There are two formats
for a Well. This field can be used to identify a vial position in a
non XY autosampler.
Mass1 Float 1st mass to be used for targeting. This could be the mono-
isotopic mass or the mass with the greatest intensity, derived
from the formula’s isotope cluster. If the analysis being
performed by the MS requires an expected molecular weight
then this field is Mandatory unless a formula is supplied.
NumberOfFraction Integer The number of fractions defined. Only one fraction mass is
Triggers currently supported by MassLynx.
Page 21
Interfacing Guide
Factor1 Float 1St User Factor if required. MassLynx currently only supports 1
User Factor.
MSDataName Text The name of the MS data file to be processed and/or created.
Page 22
Interfacing Guide
OpenLynx Browser
Sections
The file will hold section blocks of data. The start of a section block will always
start with the name of the section surrounded by square parentheses on a line by
itself. i.e. [SectionName].
The main body of the data will be enclosed by a pair of braces, the opening and
closing braces will be the only characters on their respective lines.
i.e. [SectionName]
{
....Data...
}
Section blocks can have section blocks embedded in them, in some cases multiple
instances of sections with the same name can be allowed, depending on the type of
data.
e.g. [SectionName1]
{
....Data...
[SectionName2]
{
....Data...
}
}
Fields
Sections will have a group of fields, each field will be on one line. The field name
will be the first item on the line, followed by a list of TAB separated data items for
that field. The type of data will depend on the field type.
i.e. [SectionName]
{
FieldName1 Data1
FieldName2 Data2_1Data2_2
...
}
Comments
Page 23
Interfacing Guide
Tabulated Sections
Some sections can be considered to be a table, or list, of fields of the same type.
Tabulated sections do not have any field names to describe the data but will
normally have a comment line describing the names of the fields.
e.g. [TableSection]
{
;Field1 Field2
Data1_1Data1_2
Data2_1Data2_2
...
}
The information in these sections contains free format text which may stretch over
several lines. A line will be terminated with a <carriage return><linefeed> pair.
Page 24
Interfacing Guide
SAMPLE
Well Text The description of the well position, as a pair of co-ordinates for
plate position in rack and well position in plate, or an absolute
position. There are three formats for Well.
1. plateX,plateY:wellX,wellY
FUNCTION Section MS function data and test results. There will be one
FUNCTION section per MassLynx MS and DAD data
functions.
Page 25
Interfacing Guide
PLATE FIELD
For samples acquired using a Gilson or Waters 2700 autosampler the following
information will be written to the file, otherwise this field will be blank.
Origin Location ( TL - top left, TR - top right, BL - bottom left, BR - bottom right )
1:Number Of Rows
2:Number Of Columns
3:Row Spacing
4:Column Spacing
5:Row Offset
6:Column Offset
7:Which Rows Offset ( O or E )
8:Which Columns Offset ( O or E )
9:Plate Width
10:Plate Height
11:Vial/Well Depth
12:Vial/Well Diameter
13:Vial One X
14:Vial One Y
Page 26
Interfacing Guide
e.g.
01,TL,XY,LN,1:8,2:12,3:120.0,4:120.0,5:0.0,6:0.0,7:O,8:O,9:1250.0,10:870.0,11:4
00.0,12:90.0,13:80.0,14:130.0
Which means:
Version = 01.
Origin Location = top left.
Priority = x coordinate before y coordinate.
Reference scheme = Letter Number.
1:Number Of Rows = 8.
2:Number Of Columns = 12.
3:Row Spacing = 12mm.
4:Column Spacing = 12mm.
5:Row Offset = 0.0mm.
6:Column Offset = 0.0mm.
7:Which Rows Offset ( O or E ) = Odd numbers, but because Row Offset = 0, this
has no effect .
8:Which Columns Offset ( O or E ) = Odd numbers, but because Column Offset = 0,
this has no effect.
9:Plate Width = 125mm.
10:Plate Height = 87mm.
11:Vial/Well Depth = 40mm.
12:Vial/Well Diameter = 9mm.
13:Vial One X = 8.0mm.
14:Vial One Y = 13.0mm.
Page 27
Interfacing Guide
COMPOUND
Mono Mass Float The mass used for targeting. This could be the mono-isotopic
mass or the mass with the greatest intensity, derived from the
formula’s isotope cluster.
FRACTION
Ion Mode Text The ionisation mode used to collect the fraction.
Start Time Float The time at which the fraction collection started.
End Time Float The time at which the fraction collection ended.
Start Site Text The name of the site at which the fraction collection started.
No. Of Tubes Integer The number of tubes the fraction was collected in.
INLET PARAMETERS
FUNCTION
Type Text The type of MS scan function e.g. MS for full scan.
SPECTRUM Section MS data and results of testing. There can be more than
one SPECTRUM section in a function.
Page 28
Interfacing Guide
SPECTRUM
Process Integer The number of the MassLynx saved mass spectrum. Only present
if the processed spectrum was saved with data file.
State Text The result of testing the quality of the mass spectral data.
TIC Float Total Ion Current, the sum of all the peak intensities in the
spectrum.
BPI Float The intensity of the base peak in the mass spectrum.
BPM Float The mass of the base peak in the mass spectrum.
Saved Text TRUE if the processed spectrum was saved with the data file.
Otherwise FALSE.
MASSES Section Section describing the results of testing, and finding significant
masses. This includes all adducts.
RESULTS Section Section describing the results of the targeting of the expected
compound. Masses from the same compound are combined into
one item.
MS Section Section that holds all the mass/intensity pairs, for this mass
spectrum.
SEARCH Section Section holding the results of a library search on this spectrum.
This section will not be created if no search exists.
Page 29
Interfacing Guide
MASSES
% BPI Float The intensity of the mass peak as a percentage of the base peak
intensity.
RESULTS
Found Boolean 1 if any of the possible adduct ions have been found for this
compound, otherwise 0
% BPI Float The sum of the percentage intensities for the compound.
Confirmed Boolean False if any of the confirmation tests made failed. If not specified
regarded as being True.
MS
Page 30
Interfacing Guide
ELEMENTAL
Contains results of elemental calculations if defined, otherwise this section does not
appear.
Mass Float Actual observed mass for which elemental composition was
searched.
PPM Float Difference between observed mass and calculated mass in parts per
million
SEARCH
Contains Spectrum library search results if library search was defined, otherwise this
section does not appear.
HIT Section Contains information about a library hit. There can be several or no
hits for each search
HIT
For Integer Forward search match value. Value between 0 and 1000.
Rev Integer Reverse search match value. Value between 0 and 1000.
Page 31
Interfacing Guide
CHROMATOGRAM
MaxIntensity Float The absolute intensity of the point with maximum intensity in the
chromatographic data.
PEAK Section Section(s) that hold information about peak(s) detected in the
chromatogram.
TRACE
Page 32
Interfacing Guide
PEAK
Peak Float + Float Peak start and end retention times in decimal minutes. Two floats
separated by a TAB character.
Intensity Float + Float Peak baseline start and end intensity. Two floats separated by a
TAB character.
Area %BP Float Detected peak area as percentage of the largest peak in the
chromatogram.
Area %Total Float Detected peak area as percentage of the sum of all the peak areas in
the chromatogram.
RT Index Float Retention time index for peak. Field only output if RT Index has
been calculated.
RT LogP Float Retention time LogP for peak. Field only output if RT LogP has
been calculated.
Calc Conc Float Calculated concentration for peak. Field only output if calculated.
Calc Amount Float Calculated amount for peak. Field only output if calculated.
ANALOG
MaxIntensity Float The absolute intensity of the point with maximum intensity in the
analog channel data.
TRACE Section A section that holds the chromatographic data. See description
above.
PEAK Section Section(s) that hold information about peak(s) detected in the
chromatogram. See description above.
Page 33
Interfacing Guide
MetaboLynx Browser
Sections
The file will hold section blocks of data. The start of a section block will always
start with the name of the section surrounded by square parentheses on a line by
itself. i.e. [SectionName].
The main body of the data will be enclosed by a pair of braces, the opening and
closing braces will be the only characters on their respective lines.
i.e. [SectionName]
{
....Data...
}
Section blocks can have section blocks embedded in them, in some cases multiple
instances of sections with the same name can be allowed, depending on the type of
data.
e.g. [SectionName1]
{
....Data...
[SectionName2]
{
....Data...
}
}
Fields
Sections will have a group of fields, each field will be on one line. The field name
will be the first item on the line, followed by a list of TAB separated data items for
that field. The type of data will depend on the field type.
i.e. [SectionName]
{
FieldName1 Data1
FieldName2 Data2_1Data2_2
...
}
Comments
Page 34
Interfacing Guide
Tabulated Sections
Some sections can be considered to be a table, or list, of fields of the same type.
Tabulated sections do not have any field names to describe the data but will
normally have a comment line describing the names of the fields.
e.g. [TableSection]
{
;Field1 Field2
Data1_1Data1_2
Data2_1Data2_2
...
}
The information in these sections contains free format text which may stretch over
several lines. A line will be terminated with a <carriage return><linefeed> pair.
Page 35
Interfacing Guide
SAMPLE
ProcessParameters Text MassLynx Sample List input field. Name of the MEP file used to
process the data.
InjectionVolume Float MassLynx Sample List input field. Volume of sample injected, in
micro-litres.
InletFileName Text MassLynx Sample List input field. Name of the Inlet Parameters
file used to acquire the data.
MSMethodFileName Text MassLynx Sample List input field. Name of the Method File used
to acquire the data.
MSTuneFileName Text MassLynx Sample List input field. Name of the Instrument Tune
File used for the data acquisition.
Well Text The description of the well position, as a pair of co-ordinates for
plate position in rack and well position in plate, or an absolute
position. There are three formats for Well.
1. plateX,plateY:wellX,wellY
Page 36
Interfacing Guide
COMPOUND Section Description of parent drug(s); the masses taken from the
MassLynx Sample List.
FUNCTION Section MS function data and test results. There will be one FUNCTION
section per MassLynx MS and DAD data functions.
PLATE FIELD
For samples acquired using a Gilson or Waters 2700 autosampler the following
information will be written to the file, otherwise this field will be blank.
Origin Location ( TL - top left, TR - top right, BL - bottom left, BR - bottom right )
1:Number Of Rows
2:Number Of Columns
3:Row Spacing
4:Column Spacing
5:Row Offset
6:Column Offset
7:Which Rows Offset ( O or E )
8:Which Columns Offset ( O or E )
9:Plate Width
10:Plate Height
Page 37
Interfacing Guide
11:Vial/Well Depth
12:Vial/Well Diameter
13:Vial One X
14:Vial One Y
e.g.
01,TL,XY,LN,1:8,2:12,3:120.0,4:120.0,5:0.0,6:0.0,7:O,8:O,9:1250.0,10:870.0,11:4
00.0,12:90.0,13:80.0,14:130.0
Which means:
Version = 01.
Origin Location = top left.
Priority = x coordinate before y coordinate.
Reference scheme = Letter Number.
1:Number Of Rows = 8.
2:Number Of Columns = 12.
3:Row Spacing = 12mm.
4:Column Spacing = 12mm.
5:Row Offset = 0.0mm.
6:Column Offset = 0.0mm.
7:Which Rows Offset ( O or E ) = Odd numbers, but because Row Offset = 0, this
has no effect .
8:Which Columns Offset ( O or E ) = Odd numbers, but because Column Offset = 0,
this has no effect.
9:Plate Width = 125mm.
10:Plate Height = 87mm.
11:Vial/Well Depth = 40mm.
12:Vial/Well Diameter = 9mm.
13:Vial One X = 8.0mm.
14:Vial One Y = 13.0mm.
Page 38
Interfacing Guide
COMPOUND
Mono Mass Float The parent drug used for targeting. This could be the
monoisotopic mass or the mass with the greatest intensity,
derived from the formula’s isotope cluster.
FUNCTION
Type Text The type of MS scan function e.g. MS for full scan.
ScanCycleTime Float The scan cycle time in seconds i.e. the scan duration + the
inter-scan delay time.
SPECTRUM Section MS data and results of testing. There can be more than
one SPECTRUM section in a function.
Page 39
Interfacing Guide
SPECTRUM
Process Integer The number of the MassLynx saved mass spectrum. Only present
if the processed spectrum was saved with data file.
State Text The result of testing the quality of the mass spectral data.
Peak Cluster ID Integer If this peak is considered to be the same as another peak (according
to Setup parameter Min Peak Separation) then this is the number of
the cluster containing this and all other similar peaks. A value of –1
indicates that this peak is considered separate from all others.
Control Peak ID Integer If the sample is an analyte and this spectrum matches one in the
control, then the Peak ID of the control spectrum is written to this
field. Only present if this spectrum has a matching control
spectrum.
TIC Float Total Ion Current, the sum of all the peak intensities in the
spectrum.
BPI Float The intensity of the base peak in the mass spectrum.
BPM Float The mass of the base peak in the mass spectrum.
Saved Text TRUE if the processed spectrum was saved with the data file.
Otherwise FALSE.
MASSES Section Section describing the results of testing, and finding significant
masses. This includes all adducts.
RESULTS Section Section describing the results of the targeting of the expected
compound. Masses from the same compound are combined into
one item.
MS Section Section that holds all the mass/intensity pairs, for this mass
spectrum.
Page 40
Interfacing Guide
MASSES
% BPI Float The intensity of the mass peak as a percentage of the base peak
intensity.
RESULTS
Found Boolean 1 if any of the possible adduct ions have been found for this
compound, otherwise 0.
% BPI Float The sum of the percentage intensities for the compound.
Confirmed Boolean False if any of the confirmation tests made failed. If not specified
regarded as being True.
MS
Page 41
Interfacing Guide
ELEMENTAL
Contains results of elemental calculations if defined, otherwise this section does not
appear.
Mass Float Actual observed mass for which elemental composition was
searched.
PPM Float Difference between observed mass and calculated mass in parts per
million
CHROMATOGRAM
MaxIntensity Float The absolute intensity of the point with maximum intensity in the
chromatographic data.
TraceNumberIn Integer The number of the chromatogram trace relative to the start of the
Function function.
PEAK Section Section(s) that hold information about peak(s) detected in the
chromatogram.
Page 42
Interfacing Guide
TRACE
PEAK
Peak Cluster ID Integer If this peak is considered to be the same as another peak (according
to Setup parameter Min Peak Separation) then this is the number of
the cluster containing this and all other similar peaks. A value of –1
indicates that this peak is considered separate from all others.
Peak Float + Float Peak start and end retention times in decimal minutes. Two floats
separated by a TAB character.
Intensity Float + Float Peak baseline start and end intensity. Two floats separated by a
TAB character.
Area %BP Float The peak area as a percentage of the largest peak in the sample in
which a metabolite was detected. If no metabolite found = 0.
Area %Total Float The peak area as a percentage of the total area of all peaks in the
sample in which a metabolite was detected. If no metabolite found
= 0.
Page 43
Interfacing Guide
ANALOG
MaxIntensity Float The absolute intensity of the point with maximum intensity in the
analog channel data.
TRACE Section A section that holds the chromatographic data. See above.
PEAK Section Section(s) that hold information about peak(s) detected in the
chromatogram. See above.
EXPECTED METABOLITES
Compound Float The number of the compound that this metabolite is associated with,
starting from zero.
Precursor Float Mass to be searched for, the sum of the compound and metabolite.
Formula Text The formula of the metabolite if known. Absolute formula if the
parent mass was specified as a formula (e.g. C18H24O2) or relative
formula if parent mass was specified as a mass (e.g. +CO2). If the
metabolite is not recognised the formula is 0.
ChroTrace Integer list This field is a comma-separated list of chromatogram traces searched
when looking for this mass; the trace numbers start from 1.
Peak Text list If the mass was found, this field is a comma-separated list of
chromatogram peak numbers in which the mass was found. Each
peak is identified by a string of text containing four forward slash
separated numbers in the following format:
peak-number/function-number/trace-number/mass-found
Page 44
Interfacing Guide
UNEXPECTED METABOLITES
Compound Float The number of the compound that this metabolite is associated
with, starting from zero.
Precursor Float Mass to be searched for, the sum of the compound and metabolite.
Formula Text The formula of the metabolite if known. Absolute formula if the
parent mass was specified as a formula (e.g. C18H24O2) or relative
formula if parent mass was specified as a mass (e.g. +CO2). If the
metabolite is not recognised the formula is 0.
Peak Text list If the mass was found, this field is a comma-separated list of
chromatogram peak numbers in which the mass was found. Each
peak is identified by a string of text containing four forward slash
separated numbers in the following format:
peak-number/function-number/trace-number/mass-found
Page 45
Interfacing Guide
ProteinLynx Browser
Sections
The file will hold section blocks of data. The start of a section block will always
start with the name of the section surrounded by square parentheses on a line by
itself. i.e. [SectionName].
The main body of the data will be enclosed by a pair of braces, the opening and
closing braces will be the only characters on their respective lines.
e.g. [SectionName]
{
....Data...
}
Section blocks can have section blocks embedded in them, in some cases multiple
instances of sections with the same name can be allowed, depending on the type of
data.
e.g. [SectionName1]
{
....Data...
[SectionName2]
{
....Data...
}
}
Fields
Sections will have a group of fields, each field will be on one line. The field name
will be the first item on the line, followed by a list of TAB separated data items for
that field. The type of data will depend on the field type.
i.e. [SectionName]
{
FieldName1 Data1
FieldName2 Data2_1Data2_2
...
}
Tabulated Sections
Some sections can be considered to be a table, or list, of fields of the same type.
Tabulated sections do not require any field names to describe the data.
e.g. [TableSection]
{
;Field1 Field2
Data1_1Data1_2
Data2_1Data2_2
...
}
Page 46
Interfacing Guide
SAMPLE
Note: The fields may not appear in the same order as the table below and some
empty fields will not appear at all.
Well Text The description of the well position, as a pair of co-ordinates for
plate position in rack and well position in plate, or an absolute
position. There are three formats for Well.
1. wellX,wellY
2. wellAwell1 (or well1wellA )
3. Absolute rack position.
Page 47
Interfacing Guide
FUNCTION Section MS function data and results. There will be one FUNCTION
section per MassLynx MS data functions.
FUNCTION
Type Text The type of MS scan function e.g. MS for full scan.
PROCESS_PARAMETERS Section MS process parameter data and results. There will only be
one PROCESS_PARAMETERS section in a FUNCTION.
SPECTRUM Section MS raw spectrum data. There will only be one SPECTRUM
in a function. Note: Only present for Maldi data.
PEAKLIST Section MSMS raw spectrum data. There will only be one
PEAKLIST in a function. Note: Only present for MSMS
data.
Page 48
Interfacing Guide
PROCESS_PARAMETERS
Page 49
Interfacing Guide
SEARCH_PARAMETERS
Page 50
Interfacing Guide
MODIFIERS
Name of modifier Boolean 1 if always use this modifier box checked, 0 if use when
needed to match peptide box checked.
Page 51
Interfacing Guide
SEARCH_RESULTS
File_Name Text Search result file name with its full path
PRP_File_Name Text The hit section does not appear in this file but in the file
named above. One HIT section defines one database
Hit. There can be more than one HIT sections.
SPECTRUM
MONOISOMASSES
CORRECTION_FACTOR
Page 52
Interfacing Guide
PEAK_LIST
e.g.
Mascot file
C:\TEMP\hilo07.004.2.1.pkl
Sequest file
C:\MASSLYNX\hilo07.0100001.dta
If the Bio-Rad box was checked then a SampleID.txt file is produced with the
following format.
Page 53
Interfacing Guide
VIEW_ONE
Some entries do not contain data on all the line types, and some line types occur
many times in a single entry.
GN Gene name.
OS The organism species line specifies the organism which was the source of the
sequence. In most cases this is the Latin name followed by the English name (in
parentheses). For viruses only the common English name is given. If the sequence is
identical for more than one species the OS lines will list the names of all those species.
OG The Organelle lines indicate if the gene coding for a protein originates from the
mitochondria, the chloroplast, a cyanelle or a plasmid.
OC The organism classification lines contain the taxonomic classification of the source
organism.
RN Reference number
RP Reference position
RC Reference comment
RX Reference cross-reference
RA Reference authors
DR The database cross-reference lines are used as pointers to related information in other
data collections. E.g. Protein Data Bank (PDB).
Page 54
Interfacing Guide
VIEW_TWO
Some entries do not contain data on all the line types, and some line types occur
many times in a single entry.
Accession number The accession number, a unique number used to identify entries.
Species The organism species line specifies the organism which was the source of the
sequence.
Matching peptides A list of matching fragment masses with their molecular weight (MW), mass
error (Delta), the position of the peptide in the sequence (start and end) and
the sequence. If a * appears to the left of one of these entries then it is a
single partial fragment (i.e. one missed cleavage site), if ** appears it is a
double partial fragment (i.e. two missed cleavage sites).
Unmatched masses A list of unmatched masses showing the Searched mass, the Query mass and
the Charge State.
VIEW_THREE
This view displays the sequence specific to the entry as a text string.
Page 55
Interfacing Guide
File Formats
Sample List
The Sample Lists are held in Microsoft Access which mean their contents are
readily available to numerous other windows programs. Sample Lists created by the
MassLynx system have the .SPL extension.
FILE_NAME Char (255) Raw data file name for this sample. Can be name or full path.
MS_FILE Char (255) MS method parameter file to use when acquiring this sample. Can
be name or full path.
MS_TUNE_FILE Char (255) MS tuning parameter file to use when acquiring this sample. Can
be name or full path. If empty the current tune settings will be
used.
INLET_FILE Char (255) Inlet method parameter file to use when acquiring this sample. Can
be name or full path. Only required if a programmable inlet
acquisition system is being used to acquire sample.
INLET_PRERUN Char (255) Inlet pre-run method parameter file to use prior to acquiring this
sample. Can be name or full path. If empty no pre-run is
performed. Only required if a programmable inlet acquisition
system is being used to acquire sample.
INLET_POSTRUN Char (255) Inlet postrun method parameter file to use subsequent to acquiring
this sample. Can be name or full path. If empty no post-run is
performed. Only required if a programmable inlet acquisition
system is being used to acquire sample.
INLET_SWITCH Char (255) Inlet pre-run method parameter file to use prior to acquiring this
sample if inlet system has had to make a column switch, this will be
used in preference to INLET_PRERUN. Can be name or full path.
If empty no column switch pre-run is performed. Only required if a
programmable inlet acquisition system is being used to acquire
sample.
AUTO_FILE Char (255) Autosampler method parameter file to use when acquiring this
sample. Can be name or full path. Only required if a
programmable autosampler system is being used to acquire sample.
Page 56
Interfacing Guide
PROCESS Char (255) External process to run to perform processing of sample. Can be
name or full path. Only required if external processes are being
run, if empty no process will be run for this sample.
PROCESS_PARAMS Char (255) Name of external process parameter file to use when processing
samples. Available to external process via MLCURSMP.TXT file.
PROCESS_OPTIONS Char (255) Options to specify on command line of external process when it is
executed
FILE_TEXT Char (255) Sample text description to be used for sample. Will be recorded in
data file header.
JOB Char(255) Job description for sample. Will be recorded in data file header.
TASK Char(255) Task description for sample. Will be recorded in data file header.
USER Char(255) User name for sample. Will be recorded in data file header.
SUBMITTER Char(255) Submitter for sample. Will be recorded in data file header.
CONDITIONS Char(255) Condition information for sample. Will be recorded in data file
header.
TYPE Char (255) Sample type to use during Quantify. Currently can be one of
ANALYTE, BLANK, QC or STANDARD
CONC_A … CONC_T Char (255) 20 fields used to specify the concentration levels of compounds
within this sample. Used during the quantify process.
WAVELENGTH_A… Double 10 fields used to specify wavelengths to analyse for this sample.
WAVELENGTH_J Used during OpenLynx processing.
MASS_A … MASS_T Char (255) 20 fields used to specify masses to analyse for this sample. Used
during the OpenLynx process. Masses can be real numbers or
chemical formulae
HPLC_FILE Char(255) The additional LC information for this sample (used by OpenLynx)
SPARE_1 … Char (255) General purpose fields available to the User to store extra
SPARE_5 information about the sample.
ACQU_PROCESS Char (255) External process to run when acquiring data. Can be name or full
path. Only required if external processes are being run, if empty no
process will be run for this sample.
Page 57
Interfacing Guide
ACQU_PROCESS_ Char (255) Name of external process parameter file to use when acquiring
PARAMS samples. Available to external process via MLCURSMP.TXT file.
ACQU_PROCESS_ Char (255) Options to specify on command line of external process when it is
OPTIONS executed
SAMPLE_GROUP Char (255) Used too inform QuanLynx that the optimisation file for an
Analysis sample should combine the optimisations for a number of
compounds sample groups are used. Each sample group item is a
unique one or two letter code in upper case. Thus ‘A:B:C’, ‘AA
BB CC’, ‘A….ZZ….QP’ are all valid three item groups.
If the sample group field is empty then all the compounds will be
optimised; one method file will be created and used for all the
analysis samples.
FRACTION_FILE Char (255) Raw data file name for this sample. Can be name or full path.
QUAN_REF Char (255) This field specifies which sample (if any) is to be used to adjust the
retention time window of the quantification method created for the
analysis. The first sample in the current group that has this field set
to anything other than blank will be used.
AUTO_ADDITION Char (255) The Waters 2790 autosampler can take samples from up to 15 vials
and inject them sequentially. This field contains a list of the sample
locations separated by a semi-colon (;) e.g. A:1;A:2;A:3. The
volume specified in the INJ_VOL field is drawn from each vial.
METH_DB Char (255) The full path to the quantify method file used for this sample group
in QuanLynx.
CURVE_DB Char (255) The full path to the calibration curve file used for this sample group
in QuanLynx.
DUMP_FILE Char (255) The full path to the text export file used for this sample group in
QuanLynx.
PROCESS_ACTION Char (255) The Action that the process manager is to perform should the
external application return an error
Page 58
Interfacing Guide
[Batch]
MSMethod=DEFAULT.MDB
MSTune=DEFAULT.DBF
LCMethod=DEFAULT
ProcessParameters=C:\MASSLYNX\LC1.olp
Process=C:\MASSLYNX\OPENLYNX.EXE
UserName=john doe
BatchID=13
NumberOfPlates=1
[Plate:1]
JobCode=13
UserName=john doe
Rows=0
Columns=0
Track=R
NumberOfWells=1
[Sample:1:1]
Well=25
SampleDescription=testsample
SampleID=tst11
MSDataName=test1
SampleType=0
MSInjectionVolume=15.0000
NumberOfMasses=1
Mass1=504.00
NumberOfWaveLengths=1
Wavelength1=254.0
NumberOfConcs=2
Conc1=50.000
Conc2=100.000
NumberOfFormulae=1
Formula1=CH3CH2Cl
Page 59
Interfacing Guide
AutoLynx
AutoLynx is an application that enables batches to be submitted to the MassLynx
queue for automatic acquisition, processing and report generation.
• Take information from other software packages (e.g. LIMS systems) and
automatically create batch files.
• Add these batch files to the AutoLynx queue. (AutoLynx will then add them to
the MassLynx queue and perform the processing defined on the AutoLynx
settings dialog).
Page 60
Interfacing Guide
To produce the required Browser file the Process column in the Sample List must be
defined as:
Page 61
Interfacing Guide
Status.ini
The Status.ini file contains details of the current status of the Mass Spectrometer,
LC system and the MassLynx Queue.
To create a Status.ini file select Options from the MassLynx Tools menu to display
the options dialog.
On the Status page check the Update Status box to write details to a status file.
By default the details in this file are updated every 60 seconds, to change this enter a
new time in the Refresh rate box.
If any of these fields are changed MassLynx must be closed down and restarted for
the changes to take effect.
Page 62
Interfacing Guide
These files can be viewed in Notepad or by third party software across a network.
This allows users to detect software or hardware errors, to decide which instrument
should be used to acquire samples or when data has been acquired and is ready for
further processing.
File Format
The format of the Status.ini file is as follows:
[MS Status]
Operate=2
Status=Scanning
[LC Status]
Status=0
Ready=0
%A=100.0
%B=0.0
%C=0.0
%D=0.0
Flow Rate=0.000
[Queue Status]
Queue Paused=0
Process Running=1
1=test Samples 1 to 5: Sample 1 Acquiring Running
2=test1 Samples 1 to 5: Waiting
3=test2 Samples 1 to 2: Waiting
Total samples=12
[Time Stamp]
Time=06-002-1999,10:37:59
Page 63
Interfacing Guide
MS Status
Operate Shows the state of the mass spectrometers high voltage electronics. It has
two values:
Status Shows the status of the mass spectrometer. It can have one of the following
values:
Solvent Delay The mass spectrometer has started acquiring data and is
in solvent delay.
Waiting for Injection The mass spectrometer is waiting for the autosampler to
inject the sample.
This information is useful during automation of a list of samples. For example the
inlet system will continually poll this parameter while the mass spectrometer is
acquiring in order to determine when it has reached a suitable status (Waiting for
injection) for the next sample to be injected and a new data file to be acquired.
LC Status
Status Shows whether there is an error with the inlet system. If an error occurs
then the appropriate action can be taken by the software to stop the automation. It
has two values:
Ready Shows whether the inlet system is ready to inject a new sample. It has two
values:
%A, %B, %C and %D These parameters detail what percentage of the four
possible reservoirs will be used for the mobile phase.
Flow Rate This gives the flow rate of the HPLC (ml/min).
Page 64
Interfacing Guide
Queue Status
Queue Paused This shows whether the process queue is paused. It has two states:
Process Running This shows whether the sample list is running a process. It has
two states:
“Batch No.” “MassLynx Batch ID” “Samples range” “Sample status” “Batch status”
MassLynx Batch ID is the identifier of the batch (e.g. sample list name).
Sample status has the form “Sample n Acquiring” to indicate which sample is
running.
Total Samples
This parameter gives the total number of samples in all the batches in the queue
Time Stamp
This shows the time the data system last updated a data file. If this value does not
increase as often as its refresh rate assume the data system is no longer responding.
Page 65
Interfacing Guide
Page 66
Interfacing Guide
Notes
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
Page 67
Interfacing Guide
Notes
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
................................................................................................................................................................
Page 68
Interfacing Guide
Index
A
AutoLynx, 60
C
Copying a Chromatogram as a Text List, 13
Copying a Spectrum as a Text List, 14
Copying Data, 5
Copying Integrated Chromatogram Peaks as a Text List, 13
E
Export to LIMS, 10
Exporting Data, 10
F
File Formats, 56
Sample List, 56
I
Import Data, 8
Import Worksheet, 6
M
MetaboLynx Browser Files, 34
O
OpenLynx Batch Files, 16
OpenLynx Browser Files, 23
P
ProteinLynx Browser Files, 46
S
SEQUEST Files
Exporting, 15
Status.ini, 62
Page 69
Interfacing Guide
Page 70