OM - 11594020 - NIRWise Plus Software - en
OM - 11594020 - NIRWise Plus Software - en
Operation Manual
11594020 | B en
Imprint
Product Identification:
Operation Manual (Original) NIRWise PLUS Software
11594020
Version B
BÜCHI Labortechnik AG
Meierseggstrasse 40
Postfach
CH-9230 Flawil 1
E-Mail: quality@buchi.com
BUCHI reserves the right to make changes to the manual as deemed necessary in the light of experience,
especially with respect to structure, illustrations and technical details.
This manual is copyrighted. Information from it may neither be reproduced, distributed, or used for
competitive purposes, nor made available to third parties. The manufacture of any component with the
aid of this manual without prior written agreement is also prohibited.
Büchi Labortechnik AG Table of contents
Table of contents
1 About this document........................................................................................................... 5
1.1 Mark-ups and symbols .......................................................................................................... 5
1.2 Trademarks ........................................................................................................................... 5
2 Product description............................................................................................................. 6
2.1 Description of function ........................................................................................................... 6
2.2 Files and folders of a project ................................................................................................. 6
2.3 User interface ........................................................................................................................ 7
2.4 Technical data ....................................................................................................................... 7
2.4.1 Computer system requirements ............................................................................... 7
3 Installation............................................................................................................................ 8
3.1 Installing the software............................................................................................................ 8
3.2 Software settings ................................................................................................................... 9
3.2.1 General settings ....................................................................................................... 9
3.3 License management .......................................................................................................... 11
3.3.1 Applying for a license ............................................................................................. 11
3.3.2 Importing a license ................................................................................................. 12
5 Basic operations................................................................................................................ 15
5.1 Optimizing a calibration ....................................................................................................... 15
5.2 Open an existing project...................................................................................................... 15
5.3 Creating a new project (BUCHI application support only) ................................................... 15
5.4 Saving a project................................................................................................................... 16
5.5 Carrying out a calculation .................................................................................................... 16
5.6 Exporting a calibration ......................................................................................................... 16
5.7 Exporting a graph ................................................................................................................ 16
5.8 Exporting a .tsv/excel file..................................................................................................... 16
6 Menu bar............................................................................................................................. 18
10 Report panel....................................................................................................................... 29
11 Troubleshooting ................................................................................................................ 30
12 Appendix ............................................................................................................................ 31
12.1 Explanation of terms............................................................................................................ 31
12.2 List of abbreviations............................................................................................................. 31
12.3 File explanations and folder locations ................................................................................. 32
https://www.buchi.com/contact
R This character draws attention to a requirement that must be met before the
instructions below are carried out.
u This character indicates an instruction that must be carried out by the user.
ð This character indicates the result of a correctly carried out instruction.
Mark-up Explanation
Window Software Windows are marked-up like this.
1.2 Trademarks
Product names and registered or unregistered trademarks that are used in this
document are used only for identification and remain the property of the owner in
each case.
2 Product description
2.1 Description of function
The software is used for the maintenance and optimization of calibrations for
ProxiMate™ instruments.
The software allows exploration, visualization and treatment of the calibration data.
The software maintains all data in project files.
NOTE
Name the .prj, .cal, and .rtf files according to the following schematic:
u applicationname.property.filetype
NOTE
The location of the destination folder is fixed. See Chapter 12.3 "File explanations
and folder locations", page 32
7
3
5 4
Fig. 1: User interface of the software
No. Description Function
1 Menu bar Shows the program menu.
See Chapter 6 "Menu bar", page 18
2 Tool bar Shows the available tools.
See Chapter 7 "Tool bar", page 19
3 Project panel Editing project data and calibration settings.
See Chapter 8 "Project panel", page 20
4 Graph panel Shows the graphic results of a calibration.
See Chapter 9 "Table panel and graph panel", page 28
5 Status bar Shows the status of the software.
6 Table panel Shows numeric results which depend on the selection in
the project panel.
See Chapter 9 "Table panel and graph panel", page 28
7 Report panel Shows the report generated after computing a calibration
model.
See Chapter 10 "Report panel", page 29
3 Installation
3.1 Installing the software
Precondition:
R The windows™ passwords are known.
u Double click the file Setup.exe.
ð The software installation client start.
u Single click [Install NIRWise Plus™].
ð The software starts the installation process.
3 Installation
3.1 Installing the software
Precondition:
R The windows™ passwords are known.
u Double click the file Setup.exe.
ð The software installation client start.
u Single click [Install NIRWise Plus™].
ð The software starts the installation process.
Edit tab
Save tab
Expert tab
NOTE
BUCHI application support only.
➔ [Help]
➔ [Help]
Precondition:
R The license file .lic is available on the instrument.
u Navigate to the action [Import License] via the navigation path.
ð The display shows a dialog for choosing the folders on the instrument.
u Navigate to the saving folder of the license you wish to import.
u Select the file.
u Tap the button [OK].
ð The software imports the license.
u Start the software again.
NOTE
Only if the corresponding checkbox is activated, the entry will be processed.
4.2.3 Zoom
u Press the right mouse key and move the
courser diagonal from left down to right up.
➔ [Compute]
Precondition:
R All settings have been selected. See Chapter 8 "Project panel", page 20
u Single click the [Compute] menu.
ð The status bar shows the progress of the calculation.
u Wait until the software shows the result.
5 Basic operations
5.1 Optimizing a calibration
Precondition:
R A calibration from the ProxiMate™ with reference values is available.
R If necessary, additional data files are available in the data folder.
u Open a project. See Chapter 5.2 "Open an existing project", page 15
u If necessary, add a data file to the project. See Chapter 8.1 "Project file settings",
page 20
u Change the project selector settings according to your requirements. See
Chapter 8.2 "Project selector settings", page 20
u Change the project pretreat settings according to your requirements. See
Chapter 8.3 "Project pretreat settings", page 21
u Change the project model settings according to your requirements. See
Chapter 8.4 "Project model setting", page 22
u Carry out a calculation. Chapter 5.5 "Carrying out a calculation", page 16
u Check the results. See Chapter 9 "Table panel and graph panel", page 28
u Adjust the settings according to your needs.
u Export the calibration. See Chapter 5.6 "Exporting a calibration", page 16
u Save the project.
➔ [File]
➔ [File]
➔ [File]
➔ [Compute]
Precondition:
R All settings have been selected. See Chapter 8 "Project panel", page 20
u Single click the [Compute] menu.
ð The status bar shows the progress of the calculation.
u Wait until the software shows the result.
➔ [Project]
➔ [File]
Precondition:
R A calculation was carried out. See Chapter 5.5 "Carrying out a calculation",
page 16
u Click the table in the table panel.
u Navigate to the [File] menu according to the navigation path.
ð The Save Matric... dialog opens.
u Save the .tsv file in the requested folder.
6 Menu bar
The following menus are available:
Menu Submenu / Action Explanation
[File] [New] Create a new project.
(BUCHI application support only)
[Open] Open a project.
[Open in History] Open a project from history folder.
[Merge] Merges .tsv files.
(BUCHI application support only)
[Save] Save a project.
[Save as] Save a project as.
[Save project with data] Save a project incl. all available data.
[Exit] Exit a project.
[Import NAX] BUCHI application support only.
[Export NAX] BUCHI application support only.
[Edit] [Undo] Available according to the operation.
[Cut] Available according to the operation.
[Copy] Available according to the operation.
[Paste] Available according to the operation.
[Clear] Available according to the operation.
[Select All] Available according to the operation.
[Insert] Insert row or column.
Available according to the operation.
[Remove] Delete row or column.
Available according to the operation.
[Name] Rename a column.
Available according to the operation.
[View] [Tools bar] Enable / disable the tools bar.
[Status bar] Enable / disable the status bar.
[Options] See Chapter 3.2.1 "General settings",
page 9
[Project] [Export model] See Chapter 5.6 "Exporting a calibration",
page 16
[Compute] Carrying out a calculation.
[Help] [License Request] See Chapter 3.3.1 "Applying for a li-
cense", page 11
[Installed Licenses] Shows a dialog with details about the li-
censes on this instrument.
[Import License] See Chapter 3.3 "License management",
page 11
7 Tool bar
Icon Explanation
Create a new project.
(BUCHI application support only)
Open a project.
Save a project.
No function
Cut
Available according to the operation.
Copy
Available according to the operation.
Paste
Available according to the operation.
Undo
Available according to the operation.
8 Project panel
The project panel shows the project in a tree structure.
NOTE
Only if the corresponding checkbox is activated, the entry will be processed.
The Selector allows to add further criteria to define which samples are included in
the calculation of the calibration.
NOTE
The option true and false is defined by the ProxiMate™ firmware.
NOTE
The order of the pretreatments affects the result of the calculation of the
calibration.
Parameter Explanation
XLS (Type) PLS with optimized first derivative.
RR (Type) Ridge Regression (MLR).
PLS;XLS;RR (Type) Compute model using all listed methods and automatically se-
lect the best option.
Each sample will be used for the calculation and the validation of the calibration.
Therefore, the samples are divided into groups.
Parameter Explanation
5 (CrossValidate) Divides all calibration samples into five groups.
One of the five groups will be used to validate the
calibration (20%), while the other 4 groups are
used to calculate the calibration.
The classification of the groups changes with each
calculation.
In a cycle of five calculations, each group is once
the validation group.
10 (CrossValidate) Divides the samples into 10 groups.
10% of the samples will be used for the validation
at one time.
The classification of the groups changes with each
calculation.
Parameter Explanation
99999 (CrossValidate) Leave out one, permutations equal to number of
samples.
Only one sample will be used for the validation at
one time.
All the other samples are used for the calibration.
NOTE
If the checkbox is not selected, the software selects the number of factors.
8.4.6 Delete
Defines a sample which will not be used for the calculation (after the first calculation
when it is clear which sample does not fit the model).
u Enter the sample ID manually in the field.
or
u Copy paste the samples from the calibration plot.
Navigation path
The results are shown in the graph panel and/or in the table panel. See Chapter 9
"Table panel and graph panel", page 28
Navigation path
Skew No function - -
SkewBias No function - -
1 2
Fig. 3: Results
1 Table panel 2 Graph panel
NOTE
A selected table entry in the table panel is highlighted in the graphic in the graph
panel. See Chapter 8.5 "Project pretreat results", page 24 and Chapter 8.6 "Project
model results", page 25
10 Report panel
The report panel shows report data about the calibration.
11 Troubleshooting
Problem Possible cause Action
Computation error The project contains no u Check if there is a data file
data. attached to the project
(project window, file).
u Check if the directory of the
data file is still correct by
clicking on it.
u If message says [file not
found], double click on data
file and load it again from the
correct directory.
No data selected. u Check if data file contains
reference values by clicking on
the file in the project window.
u If so, check if ‘Check’ is set to
‘True’ for samples exhibiting
reference values.
Too few data. u Less than three reference
values in one of the data files.
Wrong results The wavelength range is out- u Press abort and check if the
side the range of available wavelength range in the
data. chosen spline (project window,
pretreat) fits the
measurements.
12 Appendix
12.1 Explanation of terms
Term Explanation
Chemometrics The interpretation of spectral data to determine chemical
composition with the use of mathematical and statistical
methods.
Regression Solving an equation for its unknowns.
Regression methods The mathematical or procedural way by which the equa-
tion is determined.
Multiple Linear Regres- Is a method of solving equations where you have many
sion variables that in a linear combination represent the target.
Various methods are used depending on numerical and
stability properties of your data, SVD (Singular value de-
composition) or RR (Ridge Regression).
Principal Component Re- This method is a combination of data-reduction and Multi-
gression ple Linear Regression, where the data is approximated by
a fewer number of variables that are later used to solve
the equation.
Partial Least Squares This method is similar to the Principal Component Regres-
sion though the eigenvectors are calculated to maximize
the covariance to the target / target residuum.
Mahalanobis Orthonormal distance of a sample relative to its multivari-
ate structure.
Standard -deviation, -er- Standard deviations are used to determine the quality of a
rors model. Given a normal distribution the value represents
the spread of 68% of the population examined.
Standardized residuals Divide the individual residual with its population standard
deviation. <1 = 68%=GOOD, <2=95%=OK, <3=99%=QUES-
TIONABLE, >3=WRONG!
Pre-treatment Pre-treatments are mathematical reformatting functions
of the original measured signal.
These pre-treatments are needed to e.g. cancel particle
size effects, remove baselines etc.
Abbreviation Explanation
XVVAR Validation-set observation variation
SEC RMS of calibration residuals
CMAX Maximum calibration residual
SECV RMS of cross-validation residuals
CVMAX Maximum cross-validation residual
SEP RMS of validation residuals
VMAX Maximum validation residual
QVAL Standardized ratio of residual when in and outside of calibra-
tion-set. (negative if outside yields lesser residual than in)
N Number of instances
X Observations
Y Target
XLS An extension of Partial Least Squares; to only use derivative in-
formation in the data. Replaces Partial Least Squares with de-
rivative pretreatment.
Press Predicted Residual Error Sum Square
The difference between the predicted values and the original
reference values.
RMS Root mean square
BUCHI Affiliates:
Europe
Switzerland/Austria Benelux France Germany
BÜCHI Labortechnik AG BÜCHI Labortechnik GmbH BUCHI Sarl BÜCHI Labortechnik GmbH
CH – 9230 Flawil Branch Office Benelux FR – 91140 Villebon-sur-Yvette DE – 45127 Essen
T +41 71 394 63 63 NL – 3342 GT Hendrik-Ido-Ambacht T +33 1 56 70 62 50 T +800 414 0 414 0 (Toll Free)
F +41 71 394 64 64 T +31 78 684 94 29 F +33 1 46 86 00 31 T +49 201 747 49 0
buchi@buchi.com F +31 78 684 94 30 france@buchi.com F +49 201 747 49 20
www.buchi.com benelux@buchi.com www.buchi.com/fr-fr deutschland@buchi.com
www.buchi.com/bx-en www.buchi.com/de-de
BUCHI Italia s.r.l. BUCHI Russia/CIS BUCHI Ibérica S.L.U. BUCHI UK Ltd.
IT – 20010 Cornaredo (MI) RU – 127006 Moscow ES – 08960 Barcelona GB – Suffolk CB8 7SQ
T +39 02 824 50 11 T +7 495 36 36 495 T +34 936 06 8010 T +44 161 633 1000
F +39 02 575 12 855 russia@buchi.com iberica@buchi.com F +44 161 633 1007
italia@buchi.com www.buchi.com/ru-ru www.buchi.com/es-es uk@buchi.com
www.buchi.com/it-it www.buchi.com/gb-en
NIR-Online America
Germany Brazil USA/Canada
Asia
China India Indonesia Japan
BUCHI China BUCHI India Private Ltd. PT. BUCHI Indonesia Nihon BUCHI K.K.
CN – 200233 Shanghai IN – Mumbai 400 055 ID – Tangerang 15332 JP – Tokyo 110-0008
T +86 21 6280 3366 T +91 22 667 75400 T +62 21 2222 9478 T +81 3 3821 4777
F +86 21 5230 8821 F +91 22 667 18986 F +62 21 5568 7906 F +81 3 3821 4555
china@buchi.com india@buchi.com indonesia@buchi.com nihon@buchi.com
www.buchi.com/cn-zh www.buchi.com/in-en www.buchi.com/id-in www.buchi.com/jp-ja
BUCHI Korea Inc. BUCHI Malaysia Sdn. Bhd. BUCHI Singapore Pte. Ltd. BUCHI (Thailand) Ltd.
KR – Seoul 153-782 MY – 47301 Petaling Jaya, SG – Singapore 609919 TH – Bangkok 10600
T +82 2 6718 7500 Selangor T +65 6565 1175 T +66 2 862 08 51
F +82 2 6718 7599 T +60 3 7832 0310 F +65 6566 7047 F +66 2 862 08 54
korea@buchi.com F +60 3 7832 0309 singapore@buchi.com thailand@buchi.com
www.buchi.com/kr-ko malaysia@buchi.com www.buchi.com/sg-en www.buchi.com/th-th
www.buchi.com/my-en