Instructions for PeakSearch CUI program
[English / Japanese]

This page explains the PeakSearch program Version 0.99 (download page in SourceForge.jp) that is also implemented in powder auto-indexing software Conograph GUI.
The algorithm of the program is described here.

The program executes peak-search for any kinds of 1-dimensional distributions (Figure 1) represented as a histogram data.

Figure 1

Figure 1 : Example of 1-dimensional distribution

Subsequently, an IGOR text file is outputted, which contains the powder diffraction pattern and the following values of peaks with the peak-height more than a given threshold (Example):
  1. peak-positions
  2. peak-heights (estimated background is substracted from the y-value of the peaktop)
  3. full-widths-at-half-maximum (FWHM)
If you open the file with IGOR Pro, you can see a plot as in Figure 2 immediately. Or you can see the same plot by using the Conograph software.

Figure 2

Figure 2 : Output IGOR text file

FAQ

How to use the PeakSearch program

  1. The PeakSearch program requires the three following input files. (Examples can be found in the "sample" folder.)
  2. Copy one of the folders from the sample folder. Modify the contents of the two xml-files and the name of the *.inp.xml file if necessary.
    If you change the name of the *.inp.xml file, then it will be necessary to modify the contents of the cntl.inp.xml file accordingly.
  3. Open a command prompt or terminal window in your operating system.
    Change the current folder to the same folder that contains the modified cntl.inp.xml file.
  4. Enter the absolute path to the PeakSearch.exe file on the command line and execute PeakSearch.

When results are not satisfactory, which parameters should be modified?

<Threshold>, <NumberOfPointsForSGMethod> are necessary to be modified in order to obtain more successful results.
It is also necessary to set <Alpha2Correction> for powder patterns including α2 reflections of characteristic X-rays.

  1. <Threshold> on peak-heights influences on peak-search results, because a peak at peak-position x is detected, if and only if it has a peak-height more than (Threshold) × Err[y], where Err[y] is the value of error in the y-value of the distribution at x. Our recommended value of <Threshold> is 3.0.
    Adjust <Threshold> (to a value within 1--10 if the input observational errors are proper), if the result is not satisfactory.

    Figure 3

    Figure 3 : Example of a case of synchrotron data.
    (By modifiying <Threshold>, it is possible to detect small diffraction peaks as well as peaks with high intensities.)

  2. <NumberOfPointsForSGMethod> is also an important parameter so as not to pick up background noise as peaks.
    If this number is smaller, the smoothing curve is fit to local irregularity more finely.
    In Figure 4.1, noises are picked up as peaks, because the smoothing curve almost coincides with the background noise.
    Figure 4.1 Figure 4.2
    Figure 4.1 : "NumberOfPointsForSGMethod" = 5 Figure 4.2 : "NumberOfPointsForSGMethod" = 25
  3. <Alpha2Correction> should be set to 1 if the powder pattern contains α2 peaks, or set to 0 otherwise.
    If it is not Cu Kα2, <Kalpha1WaveLength> and <Kalpha2WaveLength> are necessary to be modified accordingly.
    Kα1 Kα2
    Ag 0.5594075 0.563798
    Co 1.788965 1.792850
    Cr 2.289700 2.293606
    Cu 1.540562 1.544398
    Fe 1.936042 1.939980
    Mo 0.709300 0.713590

How do I report bugs?

You should send us a bug report with all of the input and output files attached (including LOG_PEAKSEARCH.txt) to the following e-mail address:

How do I cite the program?

If you use the program for your research, we strongly encourage you to include a citation of the following article in the bibliography.

About the copyright

The source codes are distributed as open source under the MIT license on the repository list of the Conograph project.

Acknowledgments

I would like to express my gratitude to those who offered powder diffraction patterns for the Conograph project.

[Back to top] [Go to my research page (list of software)]