Content of the raw downloadable ExtSym zip file

ExtSym Home

Summary: From this page ExtSym can be downloaded in the form it was originally presented in Ref. [1], i.e. without any additional support scripts. This page also details the two parameter files which ExtSym reads when executed.

This web page is structured as follows:

Content of the raw ExtSym zip file

The ExtSym program, its two required parameter files and an example powder dataset can be downloaded from here (Windows 32bit binary), here (Linux 32bit binary) and here (Intel Mac OSX). Note the Window's executable contains a minor bug fix, see 8th April 2015 comment at the bottom this page. The content of this downloadable zip file is more specifically:

Please do not hesitate to contact me if you would prefer another binary version of the executable.

Running ExtSym

To execute ExtSym type: ExtSym.exe (or ExtSym on Linux/Mac) from the command prompt. ExtSym will read in the default parameter files parameter_input.asc and advanced.asc, followed by the powder data file as specified in the parameter_input.asc file. ExtSym outputs one file, table.asc, for a description of this file click here.

parameter_input.asc

Required parameter input file to ExtSym. Used to specify the filename of the powder data file and the Laue class of your crystalline powder. The powder data file is required to have either the extension .hkl or .hkl_weight as explained in detail on this web page.

advanced.asc

Required parameter input file to ExtSym. Used to specify more specialised parameters to ExtSym, hence the reason for its name.

Parameters in advanced.asc can be used to influence the accuracy by which ExtSym calculates its probability integrals and advanced.asc also includes a convenience parameter for scaling the covariance matrix (error bars) contained in a .hkl (or .hkl_weight) file.

The first parameter of advanced.asc is a rescale data error parameter, which is discussed here and equals A*GOF on that page. The effect of this parameter is to multiply the covariance matrix by the square of this number. For a .hkl file this is achieved by multiplying the 5th column by this number and for a .hkl_weight file by dividing the 5th column by this number.

The second, third and fourth parameters of advanced.asc all concern the accuracy by which ExtSym calculate its probability integrals. The second parameter is the 'correlation cutoff' parameter. It affects the decision as to whether two neighboring intensities are treated as uncorrelated (see Ref. [1], Sec 4.1 for more on this). With a high value for this parameter more intensities will be treated as uncorrelated and as a result the execution time will decrease. This is because there will be fewer integrals in the program, which need to be evaluated numerically by the Monte Carlo method, see [1] Sec 4. The higher the correlation cutoff value the more the correlation between neighboring intensities is ignored. For the data examples in Ref. [1] a value of 40% was used.

As soon as two or more intensities are treated as correlated, the program executes the Monte Carlo method, see [1] sec. 4. The aim when using the Monte Carlo method is to evaluate integrals below the accuracy specified by the 'tolerance' parameter. If this is not achieved for an integral this integral is discarded. Like the correlation cutoff parameter the tolerance parameter is a percentage value. This tolerance can be thought of as the uncertainty that is allowed in the numerical calculation of the integral. Hence, all integrals that are not discarded are calculated to an accuracy better than the tolerance. By increasing this value the integrals will be calculated faster but with higher inaccuracy. The 3rd parameter in advanced.asc is named 'max Monte Carlo iterations'. It controls the maximum number of Monte Carlo iterations spend on getting the accuracy below the tolerance level. Reducing this number will typically reduce the execution time of ExtSym as a consequence of more integrals being discarded and therefore not contributing to the calculation of the final output: the extinction symbol probability table returned in table.asc.

carbamazepine.hkl

Is an example powder data set in the .hkl format. This dataset is one of the datasets downloadable from this table. It is the carbamazepine dihydrate (C15H12N2O 2H2O) entry in that table. The space group of this crystaline powder is Cmca, which belong to the extinction symbol C - c (ab).

History or this document

References

  1. A. J. Markvardsen, W. I. F. David, J. Johnston and K. Shankland, Acta Cryst. A57, 47 (2001).