/**************************************************************************

*/
/* MATCH! - Phase Identification From Powder Diffraction Data
*/
/* Version 3.9.0.158 for Windows (64-bit)
*/
/***
***/
/* (C) Copyright 2003-2019 Crystal Impact, H.Putz & K.Brandenburg GbR,
*/
/* Bonn, Germany.
*/
/* All rights reserved.
*/
/* Author: Dr. Holger Putz
*/
/***
***/
/* Latest update of this Readme File: December 12, 2019
*/
/**************************************************************************
*/

Contents of this Readme File:

1. Installing Match! on Windows PCs

2. License Installation and Running the Software
3. Installation of FullProf software
4. Adjustment of User Level
5. Reference Pattern Database
6. Documentation
7. Online Update
8. Uninstalling Match!
9. Online Support
10. Time-limited license
11. Contacting Crystal Impact

If you intend to run Rietveld refinement calculations with Match! using

FullProf later on,
you should install FullProf first (see below), so that Match! can detect
the presence of
FullProf automatically when it is first run. However, it is also non
problem to install
FullProf later on and add the path to it in the Match! options.

1. Installing Match! on Windows PCs

-----------------------------------

Before you install and run Match!, you should check the following minimum
system requirements:

- Personal Computer with Microsoft Windows 7, Windows 8 or Windows 10

operating system (64-bit)
- 2 GB of RAM
- Hard disk with minimum 500 MB of free disk space
- Graphics resolution of 1024 x 768 pixels (1280 x 800 pixels or more
recommended)
- FullProf release January 2018 (or later) required for Rietveld refinement
In order to install Match!, please download and run the corresponding
installer from

https://www.crystalimpact.de/match/download.htm

If you already have Match! 3 installed on your machine and have created a
new reference
database (e.g. the PDF) "for all users", please note that uninstalling
Match! 3 will
automatically delete the "Reference Database Library" entry for it (not the
reference
database or the corresponding index files itself). Hence, there are three
options:
- Do NOT uninstall a previous version of Match! 3 before installing a new
version.
- If the Reference Database Library entry has been deleted by the
uninstaller,
you can add the corresponding reference again (without having to run the
database indexing again)
using the "Add" button/function at the bottom of the "Reference Database
Library" dialog.
Normally, reference databases are created in the "Application Data"
directory (or the
corresponding "Crystal Impact/Match! 3" subdirectory).
- Finally, you can prevent the uninstaller from deleting the references to
your
own reference databases by creating them not "for all users" but only for
you.
In order to do so, please make sure the deactivate to corresponding
checkbox
at the bottom left of the "Create Reference Database" dialog when
creating/
indexing a new reference database.

Please note the terms of the "End User License Agreement", which will
appear in the second
dialog box of the installer!

2. License Installation and Running the Software

------------------------------------------------

After you have installed the main software from the download package, the
program will run
in the evaluation mode, which basically means that it will stop functioning
60 days after the
installation. You still need to install your personal license in order to
transform the software
into the fully personalized, unrestricted version.

In order to do so, simply copy the license file "yourlicense.lic" that you
have received by
e-mail into the directory where you have installed the program. The
directory where the software
is installed by default is "C:\Program Files\Match! 3". Note that you may
need administrator
privileges to perform this task!

Afterwards, please verify again that the license file is really present in
the corresponding
directory, then run Match!. This can be done e.g. by double-clicking the
file "Match!.exe"
in the directory where you have installed the program (e.g. "C:\Program
Files\Match! 3").
Alternatively, you can run the software by clicking the Windows "Start"
button, then on
"Match3/Match!.exe".

Your license data should be displayed at the bottom of the splash screen
(at program startup),
to the right of the status bar at the bottom as well as in the "About
Match!" dialog which
can be opened from the "Help" menu.

3. Installation of FullProf software

------------------------------------

Match! can use the well-known software "FullProf" (J. Rodriguez-Carvajal,

Physica B. 192,
55 (1993); http://www.ill.eu/sites/fullprof; FullProf release October 2014
(or later)
required for Rietveld refinement) to run Rietveld refinement calculations.
If you would like
to use this feature, you have to install FullProf (at least if it is not
already present on
your machine):

You can download and install FullProf directly from the FullProf web page
(where you will
also find detailed installation instructions):

http://www.ill.eu/sites/fullprof/php/downloads.html

As an alternative, you can also download and install FullProf from the
Crystal Impact web page

https://www.crystalimpact.de/match/download.htm#download_fp

Simply follow the download and installation instructions given there for
the Windows platform.

4. Adjustment of User Level

---------------------------

When you run Match! for the very first time, you will be asked which
default user level
("Beginner" or "Expert") you prefer:

In the "Beginner" mode Match! performs a nearly complete automatic

processing of the initial
steps: All you have to do is to select the diffraction data file you would
like to analyze
(you will be prompted automatically for it once the software has been
started). Afterwards,
Match! will automatically process the raw data, determine the peaks, and
run the search-match
calculation. All that remains to do is to select the "matching" phases
(e.g. by double-clicking
or dragging the corresponding entries from the candidate list on the left-
hand side to the
Match list to the right), and finally display the report containing e.g.
the list of matching
phases as well as their arbitrary amounts (e.g. by selecting
"View/Report").

In the "Expert" mode you have to perform nearly all actions manually. This
mode is especially
recommended for experienced users who would like to analyze more
complicated samples.
You can customize the user level ("batch" behaviour) on the "Batch" tab of
the "Tools/Options"
dialog also later on. In addition to selecting user levels like "Beginner"
or "Expert" you
can also select individual batch steps according to your requirements.

5. Reference Pattern Database

-----------------------------

Match! identifies phases in a sample by comparing its powder diffraction

pattern to
reference patterns of known phases. Hence, it needs a so-called "reference
database"
in which these reference patterns are provided. There are several options
for obtaining
a reference database:

Match! is by default installed along with the COD-Inorganics reference

database. The
name of this reference database already indicates that it contains powder
diffraction
patterns calculated from inorganic crystal structure data (compounds
without C-H-bonds)
taken from the COD ("Crystallography Open Database"). This reference
database is
especially appropriate if you are typically analyzing mineral samples; it
is used
throughout the tutorial.
All entries of the COD-Inorganics reference database contain atomic
coordinates, based on
which the corresponding powder diffraction patterns have been calculated.
Besides this,
for all entries, I/Ic-values have been calculated, so that a semi-
quantitative analysis
can be carried out.

If the COD-Inorganics reference database is not suitable for your

requirements, you can
download and install the full COD reference database from

https://www.crystalimpact.de/match/download.htm#refdb

As an alternative to the COD reference databases, you can of course also

use any
ICDD PDF database product (PDF relational database products only on Windows
PCs), or
the "old" ICSD/Retrieve database (released 1993-2002), if you have a valid
license for it.
Finally, it is also possible to apply your own diffraction or crystal
structure data
in phase identification, by importing them into a so-called "user
database".

6. Documentation
----------------

Once you have installed the software on any of the three platforms, both a
comprehensive
online help (which can be accessed through the "Help" menu) as well as a
manual
are available as documentation. You can access the manual either from
within Match! using the menu ("Help-Manual") or directly by
double-clicking on the file "Manual.pdf" in Match!'s program directory.

In addition, tutorial videos in the most common operations are demonstrated

are available at

https://www.crystalimpact.de/match/videos.htm

Finally, there are two basic keyboard shortcuts you should always keep in
mind:

<F1> (Cmd+? on the Mac) will open the online help at the index page, so
that you
can easily search for information about a given keyword/issue.

<Ctrl+J> will display a table of all mouse operations and keyboard

shortcuts that
can be used.

Using these two shortcuts, you should be able to clarify most issues and
questions.

7. Online Update
----------------

By default, Match! automatically checks the Crystal Impact web server for a
more recent version
each time it is executed. If a new version is found, you will be informed
and guided to the
corresponding web page from which you can download the new version.

You can also manually check for a more recent version, simply by selecting
the "Check for
updates..." command from the "Help" menu. The procedure will be the same as
the one described
above for the automatic update.

8. Uninstalling Match!
----------------------

If you would like to uninstall Match!, please click on the Windows "Start"
button, then click
on "Programs", and finally select the command "Uninstall Match!" from the
"Match! 3" subfolder.
If you are using Microsoft Vista, Windows 7 or 8 as operating system,
please note that you
need to run the uninstaller using administrator rights explicitly. In order
to do so, please
right-click on the command "Uninstall Match!" in the "Match! 3" subfolder,
then select "Run
as administrator" from the context menu.

Alternatively, you can also open the "Control Panel" from the "Settings"
folder in the Windows
"Start" menu. Afterwards, double-click on "Software" (on some operating
systems called
"Add/Remove Programs) in order to bring up the normal Windows software
installation dialog.
In the list, please mark "Match! 3", then click "Change/Remove". As soon as
the uninstall
program has been opened, please click "Ok" in order to remove Match!.

9. Online Support
-----------------

In case of trouble with Match!, you can quickly access the most recent
support
documents on the Crystal Impact Web site
("https://www.crystalimpact.de/match/")
by selecting "News", "Update", "Known Bugs" or "Support" from Match!'s
"Help" menu.
Of course, you can also send an e-mail to support@crystalimpact.com

You might also want to visit the Match! web page from time to time:

https://www.crystalimpact.de/match/index.html

10. Time-limited license

------------------------

As long as no valid license file is installed, Match! will run as a full-

featured
but time-limited "evaluation version": You can use Match! for 60 days after
you
have installed it for the first time, without having to purchase a license.

The expiration date of your evaluation period is displayed on the right-

hand side of
the status bar at the bottom. Besides this, You can view this date in the
"About"
dialog which can be opened by selecting "About Match!" from the Match!
"Help" menu.

After the expiration date, Match! will refuse operation until a valid
license is
installed. If you would like to continue using Match!, please contact
Crystal Impact
(address see below) in order to obtain the full version !

11. Contacting Crystal Impact

-----------------------------
To contact a Crystal Impact sales representative, either

* send an e-mail to sales@crystalimpact.com

* fax to +49-228-9813644
* call +49-228-9813643
* or write to: Crystal Impact GbR, Kreuzherrenstr. 102, D-53227 Bonn,
Germany.