/***************************************************************************/ /* MATCH! - Phase Identification From Powder Diffraction Data - Version 2 */ /* Version 2.4.7 for Mac OS X */ /*** ***/ /* (C) Copyright 2003-2016 Crystal Impact, H.Putz & K.Brandenburg GbR, */ /* Bonn, Germany. */ /* All rights reserved. */ /* Author: Dr. Holger Putz */ /*** ***/ /* Latest update of this Readme File: January 14, 2016 */ /***************************************************************************/ Contents of this Readme File: 1. Installing Match! on Mac OS X 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 1. Installing Match! on Mac OS X -------------------------------- Before you install and run Match!, you should check the following minimum system requirements: - Mac with Intel processor and Mac OS X 10.6 "Snow Leopard" operating system (or later) - 1 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 September 2014 (or later) required for Rietveld refinement In order to install Match!, please download and run the corresponding installer from http://www.crystalimpact.com/match/download.htm In order to install Match!, first please download the corresponding compressed installer file ("Match-2-osx-installer.zip") from http://www.crystalimpact.com/match/download.htm Once the download has finished, please uncompress the zip-file into some temporary directory, and run the installer e.g. by double-clicking on the corresponding file (you will be asked to enter your administrator password). When the installer is running, please follow the instructions on the screen, and note the terms of the "End User License Agreement", which will appear in the second dialog box! 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 "/opt/Match2. 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 on the corresponding desktop symbol "Match!", or alternatively using the Finder (Folder "Applications/Match2"). 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 September 2014 (or later) required) 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 http://www.crystalimpact.com/match/download.htm#download_fp Simply follow the download and installation instructions given there for the Mac OS X 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 http://www.crystalimpact.com/match/download.htm#refdb or from a Crystal Impact DVDs distributed at various meetings, e.g. the ECM- or IUCr-conferences. 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, a tutorial handbook is available as documentation. You can access it either from within Match! using the menu ("Help-Tutorial Handbook") or directly by double-clicking on the file "Tutorial.pdf" in Match!'s program directory. In addition to the software overview and a "quickstart" tutorial, this document contains several important chapters: First of all, the software maintenance (e.g. installation) is described in the corresponding chapter on p. 19. Once you have setup the software on your machine, please follow the tutorial session on p. 22 where the basic usage of the program is demonstrated. If you have already used the previous version 1 of the software, you should also have a look at the chapter "What's New for Match! 1 Users" on p. 8. Here, you can get a quick overview over the major changes between version 1 and 2 of the software. This chapter is also recommended for other users who would like to learn about the advanced features of the software! If you are an experienced user and would like to get a quick overview on how to operate the software, please have a look at the chapter "Table of Mouse Button and Key Combinations" in the Appendix. There are two basic keyboard shortcuts you should always keep in mind: - Cmd+? will open the online help at the index page, so that you can easily search for information about a given keyword/issue. - Cmd+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 double-click on "uninstall" in the "Applications/Match2" folder using the Finder. 9. Online Support ----------------- In case of trouble with Match!, you can quickly access the most recent support documents on the Crystal Impact Web site ("http://www.crystalimpact.com/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: http://www.crystalimpact.com/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.