SHORT REFERENCE GUIDE

 

*************************************************

Powder Diffraction Structure Analysis Program

DDM

Version 1.95

*************************************************

 

 

 

Includes Rietveld and Derivative Difference Minimization (DDM) methods

[L.A. Solovyov, J. Appl. Cryst. 37 (2004) 743-749]

 

 

 

 

 

Update/Download:

http://www.icct.ru/eng/content/persons/Sol_LA/ddm.html

http://sites.google.com/site/ddmsuite

http://l-solovyov.narod.ru/ddm.html

 

 

 

 

Leonid A. Solovyov

Institute of Chemistry and Chemical Technology

Academgorodok 50-24, 660036 Krasnoyarsk

Russia

E-mail: leosol@icct.ru

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

22 May 2012

 

 

General information

 

  The program is designed for crystal structure analysis from powder diffraction data by making use of either Rietveld [H. Rietveld J.Appl.Cryst. (1969) 65], or Derivative Difference Minimization [L.A. Solovyov J.Appl.Cryst. (2004) 743] (DDM) method. In the DDM method the refinement is aimed not at minimizing the absolute difference between the experimental and calculated profiles but at minimizing the oscillations (or curvature) of the difference curve. The squared values of the difference curve derivatives are used in DDM as a measure of the difference curvature. The main advantage of this method is that it does not require the background line modeling or approximations. Eliminating the systematic errors caused by inadequate background definitions, DDM allows structure refinemet with increased stability and precision.

 

=============================================================================

COMMAND LINE: ddm.exe [Parameters file]

EXAMPLE: ddm.exe params.ddm

=============================================================================

 

I. Parameters

 

  Parameters are stored internally in arrays XL(I,J), GLB(I), and PAR(I,J). XL contains the data for the atoms. The first index runs over the atoms; the second over the parameters for the atom. GLB contains those parameters which apply to all phases such as zero-point and background. PAR contains crystalline-phase dependent parameters such as lattice constants, scale factor, profile shape parameters n and m, preferred orientation parameters, etc.  The first index runs over the phases. There are corresponding arrays LP, LGLB, and LPAR which map the parameters to the normal matrix elements. This mapping is determined by the user.

  Codewords are entered for each parameter. A zero codeword means that the parameter is not being refined.  Assume one wishes to vary the x,y,z coordinates of an atom and that y = x/2. If we let the codewords be given as:

                            x:  31.00

                            y:  30.50

                            z:  41.00

 

then x and y will be assigned to the third normal matrix parameter and z to the fourth. Also, 1.00 times the calculated shift in the third parameter will be applied to x and 0.50 times to y.  The full calculated shift in the fourth parameter will be applied to z. In general, the codeword is formed as:

 

                         sign(A)*(10P + |A|)

 

where P is the parameter position in the matrix and A is the factor by which the computed shift will be multiplied before use. P is optional; a parameter will be refined if A is nonzero. The shifts are also multiplied by a relaxation factor before being applied to the parameters.  The user may supply four different relaxation factors which apply to four different classes of parameters.

 If P is zero, then the parameter position in the matrix is assigned by the program AUTOMATICALLY. Only those parameters which need to be restrained to have the same position in the matrix (as x and y in the above example) should be numbered by P in the codewords. Holes in the sequence of numbered codewords are removed automatically by the program. Making a line with codewords blank (in the Parameters file) is equivalent to assigning them zero values.

 

 Starting from version 1.4 the manual numbering of symmetry related parameters is optional as the program imposes symmetry restrictions automatically.

 


MATHEMATICAL INFORMATION

 

1. Refinement method

 

  The program uses the Newton-Raphson algorithm to minimize the quantity

,  

in the case of Rietveld refinement [Rietveld H. J. Appl. Cryst. (1969) 65], or

       ,   

in the case of Derivative Difference Minimization [Solovyov L.A. J. Appl. Cryst. (2004) 743],

where Yi and Yci are the observed and calculated profile intensities at the ith step, si is the variance in the observed profile intensity Yi and skj are the Savitzky-Golay (SG) coefficients for the derivative of order k with the  convolution interval [-m, m]. The weights w depend on the exponent factor p that is chosen by the flag IWGHT in Line 7 of the Parameters file. In the Rietveld scheme p = 2(IWGHT+1); for DDM p = IWGHT.

  The choice of the convolution interval [-m, m] for each data-point is controlled by the variables WDDM and CDDM specified in Line 7 of the Parameters file. The interval selection consists in finding the widest interval for which the deviations of the profile intensities from the fitted SG polynomial PSG satisfies certain criterion defined by the value of WDDM. This procedure generates narrower convolution intervals for profile regions with sharp features. CDDM limits the maximal interval width allowed (in degrees 2q).

If WDDM > 0, the selection criterion is based on the counting statistics:

 < WDDM

If WDDM < 0, the selection is done according to the Durbin-Watson correlational statistics:

                        > 4 + 2WDDM + 2/(m-1) - 1/(2m+1)

The optimal ranges are: 1 < WDDM < 3 and -1.7 < WDDM < -1.3.

  The variable structural and profile parameters vr are refined by solving the normal equations

          for Rietveld refinement, or

  for DDM.

  The standard uncertainties of the variable parameters are estimated from the diagonal elements of a residual-related variance-covariance matrix Vx. In the Rietveld refinement Vx is calculated as

,       ,         ,

where A is the inverted normal matrix, Dn is the residual (Yn - n­­), and x is the variable parameter. In the DDM mode the matrix Vx is derived as follows:

,

,       ,       ,

,           ,            

,       ,      ,

where  and are the SG coefficients, and the summation in the expression for Lni is done for all the profile points whose convolution interval [-m, m] includes the nth point.

  The refinement reliability factors are calculated as:

Rp = 100 S|Yi - Yci| / S(Yi - Ybi),                       the profile R-factor;

Rwp = 100 [Swi(Yi - Yci)2 / Swi(Yi - Ybi)­2]1/2,      the weighted profile R-factor;

Rexp = 100 [(N - P + C) / Swi(Yi - Ybi)­2]1/2,        the expected weighted R-factor;

RB = 100 S|I - Ic| / SIo­­,                        the Bragg R-factor;

where Ybi­ is the background intensity at the ith step, I and Ic are the "observed" (estimated from the observed profile) and the calculated integral reflection intensities;

RDDM = ,     DDM R-factor;

DDM-Rw = ,    simplified weighted DDM R-factor.

 

2. Calculated profile

 

  The profile intensities Yci are calculated by summing the contributions from neighboring Bragg reflections, k, for all phases, p, plus the background, Ybi:

Yci = Sp sp {Sk [ |Fk|2 f(2qi - 2qk) Lk Pk Sa ]}p + Ybi,

where sp is the scale factor for phase p, Fk is the structure factor, f is a reflection profile function which approximates the effects of both instrumental and, possibly, specimen features, Lk contains the Lorentz, polarization and multiplicity factors, Pk is a preferred orientation function, and Sa includes the surface roughness, finite sample thickness and absorption corrections. The ratio of the intensities for the two wavelengths (if used) is absorbed in the calculation of |Fk|2, so that only a single scale factor is required for each phase.

 The currently available profile functions are:

NPROF           FUNCTION                                                   NAME

(0)          exp[-Co(2qi - 2qk)2 /Hk2] ÖCo /HkÖp                            Gaussian (`G')

(1)          [1+C1(2qi - 2qk)2 /Hk2]-1 ÖC1 /pHk                               Lorentzian (`L')

(2)          [1+C2(2qi - 2qk)2 /Hk2]-2 2ÖC2 /pHk                             Lorentzian Mod 1

(3)          [1+C3(2qi - 2qk)2 /Hk2]-1.5 ÖC3 /2Hk                             Lorentzian Mod 2

(5)          nL + (1 - n)G,                                                                       pseudo-Voigt ('pV')

  n = NA + NB*2q       

(6)          (C4/Hk) [1 + 4(21/m - 1) (2qi - 2qk)2 /Hk2]-m,                  Pearson VII (`PVII')

  m = NA + NB/2q + NC/(2q)2

for NPROF < 7: Hk = [(U + Aniso2)tan2q +V tanq +W + (Z + Aniso1Fder)/cos2q ]1/2

 (7)        nL + (1 - n)G,                                               Thompson-Cox-Hastings (TCH) pseudo-Voigt

 n = 1.36603q - 0.47719q2 + 0.1116q3                                     [Thompson P., Cox D.E., Hastings J.B.

 q = HL / Hk,                                                                J. Appl. Cryst. (1987) 79]

 Hk = (HG5 + 2.69269HG4HL + 2.42843HG3HL2 + 4.47163HG2HL3 + 0.07842HGHL4 + HL5)0.2,

 for IAN3 > 0:  HL = (X + Aniso21/2)tanq +(Y + Aniso11/2Fder)/cosq,    

HG = [U tan2q +V tanq +W +Z/cos2q]1/2,

 for IAN3 < 0:  HL = X tanq +(Y + Aniso11/2Fder)/cosq,           

HG = [(U + Aniso2)tan2q +V tanq +W +Z/cos2q]1/2,

where Hk is the full-width-at-half-maximum (FWHM) of the kth Bragg reflection, NA, NB, NC, U, V, W, Z, X, and Y are refinable parameters, and

Co = 4ln2,  C1 = 4,  C2 = 4(Ö2 - 1),  C3 = 4(22/3 - 1),  and C4 = 2G(m)(21/m - 1)1/2 / G(m - 0.5)Öp.

 

The anisotropic peak broadening terms are calculated as follows:

the size term,    Aniso1 =d2(SIZ1h2 + SIZ2k2 + SIZ3l2 + SIZ42hk + SIZ52hl + SIZ62kl)/100

the strain term depends on IAN3 flag,

if IAN3=1,     Aniso2 = d2(STR1h2 + STR2k2 + STR3l2 + STR42hk + STR52hl + STR62kl)/100

if IAN3=2,     Aniso2 = d4[STR1h4 + STR2k4 + STR3l4 + 3(STR4h2k2 + STR5h2l2 + STR6k2l2) +

                          + 2(STR7kh3 + STR8hl3 + STR9lk3 + STR10hk3 + STR11lh3 + STR12kl3) +

                                     + 4(STR13klh2 + STR14hlk2 + STR15khl2)]/10000

 

The term Fder responsible for the selective anisotropic broadening due to structural defects is calculated as described in ref [Solovyov L.A. J. Appl. Cryst. (2000) 338]. Its calculation involves the structure factor derivative with respect to a refinable parameter responsible for the defects (pseudo-position occupancy, for instance). The codeword number of the defect-responsible parameter is specified in the variable NDPAR (Line 13.2). If NDPAR=0, no broadening related to defects is considered.

 

  The background intensity Ybi at the ith step may be obtained by any of several methods. The user's choice is indicated by the value of NBCKGD entered in the fourth position in Line 3 of the Parameters file. The choices are: (1) an operator-supplied file with background intensities Ibi (NBCKGD = 1), or (2) linear interpolation between operator-selected points in the pattern (NBCKGD = n, where n is the number of points), or (3) the background function (NBCKGD = 0):

where BKPOS is user-specified in Line 5 of the Parameters file. Note that the operator-supplied background intensities Ibi are optional; they are added to the background function when NBCKGD = 1.

  The diffraction peak asymmetry is allowed for by giving the left side of a peak an additional broadening:

FWHM_left  = FWHM_right + 2P1exp(-2q*0.084) + P2tanq,

where P1 and P2 are refinable parameters. Additionally, the peak asymmetry may be introduced by the approach of Finger, Cox & Jephcoat (1994) J. Appl. Cryst. 892. The respective refinable parameter FCJ (Line 13.8) is related to an effective slit_height/diffractometer_radius ratio that is considered to be equal to the sample_height/diffractometer_radius ratio.

  The absorption and microabsorption correction for a flat sample is

Sak = m/mk + (1 - m/mk) exp(-0.0002PARSkmk/3) + ABSORP1exp[-0.0002PARSk(m - mk)/3-ABSORP2/sinq]

where ABSORP1 and ABSORP2 are adjustable parameters, m and mk are the linear absorption coefficients of the sample and the kth phase, and PARSk is the particle size [um]. ABSORP1 = -1 holds for the finite sample thickness effect and ABSORP1 > 0 holds for the surface roughness effect (equivalent to the Suortti model [Suortti P. J.Appl. Cryst. (1972) 325]). For a cylindrical sample:

Sa = exp[-(1.7133 - 0.0368sin2q)ABSORP3 + (0.0927 + 0.375sin2q)ABSORP32]

The preferred orientation function is:

Pk = G2 + (1-G2)P[1 + d2(EPR1h2 + EPR2k2 + EPR3l2 + EPR42hk + EPR52hl + EPR62kl)/100]-3/2,

with  P = G2 + (1-G2) (G12cos2a + sin2a/G1)-3/2  (March-Dollase model chosen by IPREF=1)

or     P = G2 + (1-G2)exp(-G1a2)      (Rietveld-Toraya model chosen by IPREF=0)

where G1, G2, and EPR1...EPR6 are refinable parameters, a is the acute angle between the scattering vector and the preferred orientation direction in reciprocal space, and d is the reflection d-spacing. When the EPR coefficients are refined without restraints, the scale-factor SF is fixed.

 

3. Size-strain calculations

 

  When the TCH profile function is used (NPROF = 7), the crystallite size and micro-strain calculations are performed based on the refined FWHM parameters. The estimated size and strain values are written to the Output file. The volume-weighted and area-weighted domain sizes DV and DA, and the maximum (upper limit) of strain e are calculated as:

DV = 1/bS,       DA = 1/ 2bSL,                           e = bD/4,

bS = [2bSL + (bSL2 + 9bSG2)1/2]/3,                      bD = [2bDL + (bDL2 + 9bDG2)1/2]/3,

bSL = (Y - Ys)p2/360l,                           bDL = (X - Xs)p2/360,

bSG = [(Z - Zs)/pln2]1/2p2/ 360l,            bDG = [(U - Us)/pln2]1/2p2/ 360,

where bS and bD are the approximations of the integral breadth of the size- and strain-broadened profiles derived from their Gaussian and Lorentzian components, Y, Z, X and U are the refinable parameters of the FWHM components HL and HG of the TCH function, Ys, Zs, Xs and Us are the respective FWHM parameters for an instrumental broadening standard (entered in Line 12 of the Parameters file), and l is the wavelength. An estimation of the average crystallite diameter <D> and its distribution dispersion s<D> is done using equations

<D> = DA+ (DADV)1/2 / 4         and       s<D> = <D> (DV/DA - 1/2)/2

found empirically from fitting TCH function to simulated profiles for the model of spherical crystallites with different size distribution dispersions. The anisotropic diameter <D>aniso and strain eaniso are calculated similarly, but the Lorentzian breadth components are given by:

bSLaniso = (Y - Ys + Aniso11/2)p2/360l,    bDLaniso = (X - Xs + Aniso21/2)p2/360.

 

4. Quantitative phase analysis calculations

 

  In a mixture of N crystalline phases the net weight fraction Wi of phase i is given by:

Wi = SiMiViNi2 / S(SjMjVjNj2)                                     (4.1)

where S is the scale factor, M and V are the unit cell mass and volume, N is the space group multiplicity.

  If the internal standard with the weighted fraction Ws is used, the phase fractions are corrected:

Wi* = WiWs / W,          WR = 1 - S Wi*                         (4.2)

where W0 is the standard fraction calculated from (4.1), and WR is the residual “amorphous” fraction.

  The external standard based calculations are performed as follows:

Wi* = mSiMiViNi2 / CT­, WR = 1 - S Wi*                         (4.3)

where m is the sample mass absorption coefficient, C is the diffractometer constant (DIFC) determined from the external standard measurement, and T is the counting time of the current scan (TPS).

 


II. Description of input files


A. The Parameters file

  This file contains the control variables and the structural parameters.  If 
output of a new input file is selected, the current input file will be updated 
at the end of the last cycle (see flag NXT in Line 4). A star (*) before a line 
number indicates that the line's existence depends on the value of a control 
variable. The parameters are entered in free format and should be separated by 
at least one space.
 In the mathematical expressions Q denotes the diffraction angle Theta.

Line   Par.N     Description
1.               Title - any 70 characters to be used to label the printout.    
2.               Data file name
3.       1       JOBTYP - 0 - X-ray case    
                          1 - Neutron case(nuclear scattering only)    
         2        NPROF - profile selection    
                          0 - Gaussian            4 - [Not used]    
                          1 - Lorentzian (Cauchy) 5 - pseudo-Voigt(pV)       
                          2 - Mod 1 Lorentzian    6 - Pearson VII    
                          3 - Mod 2 Lorentzian    7 - Thompson-Cox-Hastings pV 
         3        NPHASE - number of phases in the sample
         4        NBCKGD - background correction control    
                          0 - polynomial background
                         -1 - background to be estimated by weighted difference
                              smoothing (see BKCURV, Line 5.10). The resultant
                              curve is output to ddm_bckgr file
         5        NEXCRG - number of excluded regions read from Line 10.
         6        NSCAT  - number of extra scattering sets read from Line 11.
         7        INSTRM - data type     
                           0 - laboratory Q-2Q X-ray data, or single detector
                               neutron data (the Data file contains only profile
                               intensities, see section B.)    
                           1 - the Data file contains profile intensities and 
                               squared variances
                           2 - PANalytical XRDML data (multiple scans are summed)
                           3 - XY (2Theta Intensity) format
                           4 - XYE (2Theta Intensity Sigma) format
         8        IPREF - preferred orientation function type
                            0 - Rietveld-Toraya function    
                            1 - March-Dollase function    
         9        ISZSTR - size-strain instrumental standard used (for NPROF=7)
                           If ISZSTR=1, instrumental broadening parameters
                           US ZS XS YS are read from Line 12.

4.               Output control flags (0 for off, >0 for on)
         1        IWP  =1: prf-file for WinPLOTR
                       =2: weighted prf-file for WinPLOTR
         2        IPL  =1: text-files with calculated and observed intensities
                       =2: text-files with weighted profile intensities
         3        IPC  =1: list of reflections
                       =2: list of |F|obs, |F|calc & R-F
         4        MAT  =1: correlation matrix output
         5        NXT  =1: parameters file is updated after the last cycle
         6        LST1     number of last refinement cycles to output
         7        LST2     not used
         8        LST3     not used
         9        LST4     not used

Line   Par.N     Description

5.       1        Lamda(1) - Wavelength1
         2        Lamda(2) - Wavelength2
         3        RATIO - Alpha2/Alpha1 intensity ratio
         4        BKPOS - origin of background polynomial (in °2Q)
         5        WDT -  range of calculated peak profile in units of FWHM
                        (beyond this the calc. profile is set to zero)
         6        CTHM - monochromator coefficient in polarization correction
                          [1 + CTHM*(cos2Q)2]/[sin2Q sinQ]
         7        TMR -  convolution interval for R-Bragg calculation and
                         profile decomposition in units of FWHM
         8        RLIM - peaks below this angle (2Q) are corrected for asymmetry
                         by the Finger-Cox-Jephcoat approach
         9        SAMPLE - angle (2Q) below which the intensities are corrected
                           for the effect of the primary beam falling beyond the
                           sample edges (Bragg-Brentano geometry only)
                           An empirical correction is applied:
                             Icor=I/(1+(.0128+.0106*(SAMPLE-2Q))*(SAMPLE-2Q))
        10        BKCURV - number of  values in the weighted difference
                           smoothing estimation of the background curve
6.       1       MCYCLE - number of refinement cycles (starting from 0)
         2       EPS  -  refinement convergence precision: run terminates when
                         all parameter shifts are < EPS*e.s.u.
                 RELAX - relaxation factors for parameter shifts
         3          (1) - coordinates & isotropic displacement factors
         4          (2) - anisotropic displacement parameters
         5          (3) - profile, asymmetry, overall atomic displacement
                          and preferred orientation parameters
         6          (4) - peak shift and lattice parameters,
                          overall scale factor, site occupancies

 7.       1       NDEC - number of cycles for profile decomposition run
                        (either DDM or Le Bail methods depending on CDDM)
                        If NDEC > 0, the structure model is ignored and the
                        squared structure factors F2 are read from ddm_ffobs
                        file which is overwritten with the refined F2s after
                        the final run cycle. If ddm_ffobs is absent, a set of
                        equal F2 is applied at the first decomposition cycle.
                        If both MCYCLE and NDEC > 0, the refinement of profile
                        parameters is followed by NDEC decomposition cycles
         2       MAXS - refined parameters control flag
                        MAXS = 0 denotes refinement of all parameters with
                                 nonzero codewords
                        MAXS = -1 removes all refinement codewords
         3       WDDM - DDM convolution interval selection threshold
                     If WDDM>0, the counting statistics is used (optimal WDDM=3)
                     If WDDM<0, the Durbin-Watson statistics is used
                     If WDDM=0, all convolution intervals are equal to CDDM
         4       CDDM - maximal DDM convolution interval in degrees 2Q 
                      If CDDM=0, Rietveld refinement is performed instead of DDM
         5       IWGHT - weighting scheme flag: for DDM IWGHT = 0, 1, 2;
                         for Rietveld IWGHT = 0, 1

Line   Par.N     Description
 8.         Global parameters
 8.1     1       ZER     - zero-point for 2Q (in degrees)
         2       DISP    - sample displacement 2Q correction parameter
         3       SHASM  - asymmetry-related peak shift correction parameter
         4       ABSORP1,
         5       ABSORP2 - absorption correction coeffs. for flat sample:
                              Icor=I*[1 + ABSORP1*exp(-ABSORP2/sinQ)]
                  ABSORP1 = -1 holds for the finite sample thickness effect
           		     ABSORP1 > 0 holds for the surface roughness effect
         6       ABSORP3 - absorption correction coeff. for cylindrical sample:
                              Icor = I*exp[-(1.7133 - 0.0368*sin2Q)* ABSORP3 +
                                      + (0.0927 + 0.375*sin2Q)*ABSORP32]
 8.2             Codewords for ZER, DISP, SHASM, ABSORP
 8.3             BACK  - polynomial background coefficients (six values)
 8.4             FBACK - codewords for background coefficients

*9.             Not used

*10.            If NEXCRG > 0, there are NEXCRG lines
                ALOW - low angle bound of excluded region
                AHIGH - high angle bound of excluded region
                NOTE: A reflection will be excluded if any part of 
                          its calculated tail falls in this range.

*11.            If NSCAT > 0, there are NSCAT sets of lines for extra
                scatterers not included in the incorporated table of scattering
                factor coefficients
*11.1           NAM - symbol identifying this set
                DFP - f', DFPP - f'',
                XMAS - Molecular mass, AMAC - mass absorption coefficient
*11.2           Either one line of the form
                A1 B1 A2 B2 A3 B3 A4 B4 C,
                the coefficients for the analytic approximation to f,
                or a set of lines of the form Posi - Scat, where
                              Posi = sinQ/lambda and Scat = f
                The set is terminated by a line with -100 in the first position.
                If the first form is desired, A2 can not = 0

*12.            If ISZSTR = 1, there are instrumental broadening parameters
                US, ZS, XS, YS for size-strain calculations (only for NPROF=7).

********************************************************************************
At this point optional code-lines may be added beginning from $ symbol followed 
by the line-code and parameters:
          $QPA  SWT DIFC TPS OMAC - quantitative phase analysis constants
                SWT  - internal standard weight percent 
                DIFC - diffractometer constant derived from external standard
                TPS  - counting time of current data scan
                OMAC - overall sample mass absorption coefficient (if known)
                If SWT>0, the 1st phase is assumed as the internal standard
                If DIFC=0, TPS>0, the DIFC constant will be calculated
                If OMAC=0, the MAC will be derived from the atomic composition
          $BFILE Filename - background curve file name
                The program will read the background point positions and
                intensities in free format from the specified file. 
********************************************************************************

13.        Phase parameters:  NPHASE sets of lines (see Line 3)
13.1             PHSNM - name of phase (maximum 70 characters)
13.2     1       NATOM - number of atoms
         2       IFUR  - Fourier output flag
                         If IFUR=1, F-factors are written to ddm_cif.cif
                         If IFUR=2, F-squared are written to ddm_cif.cif
         3       NDPAR - codeword number of the parameter responsible for
                         structural defects (pseudoposition occupancy parameter,
                         for instance) in the selective anisotropic broadening
                         model [Solovyov (2000) J.Appl.Cryst. 338]
         4       PREF(3) - preferred orientation direction h k l
         5       PARS  - Particle size [um] for the microabsorption correction

13.3             SYMB - space group symbol, e.g. P-1, P63/m, P21/n, P 1 1 2/b,
                        I41/acd, Pmmn, Pmmn S, R-3c, R-3c R, HALL -P 3* 2N, ...
                 ending R means RHOMBOHEDRAL setting, S means ORIGIN CHOICE 1
                 By default (if S is omitted) the ORIGIN CHOICE 2 with the
                 inversion centre at (0,0,0) is selected

Line             Description
******************************* NATOM line sets ********************************
13.4      4 lines for each of the N atoms
13.41            LABEL - identification characters for atom (4 characters)
                 NTYP  - link to scattering data for atom: either name from 11.1
                         or chemical symbol and valence to access the
                         incorporated list of f-coefficients taken from the
                         International Tables.
                 x,y,z - fractional atomic coordinates
                 B     - isotropic temperature parameter
                 N     - occupation number (number of atoms in the unit cell)
        NOTE: if N = -1, the occupation number will be calculated by the program
                 IANIS - isotropic (0) or anisotropic (1) temp. factor flag
                 ADIST - maximal interatomic distance for GEOMETRY output
                      If ADIST<0, ANGLES will not be output to CIF for this atom
13.42            CX,CY,CZ - codewords for the fractional atomic coordinates
                 CB       - codeword for the isotropic temperature parameter
                 CN       - codeword for the occupation number
       Lines 13.43 and 13.44 are entered only if IANIS = 1
*13.43            Beta11, Beta22, Beta33, Beta12, Beta13, Beta23 
                          anisotropic temperature parameters
*13.44            CB11, CB22, CB33, CB12, CB13, CB23 
                           codewords for anisotropic temperature parameters
********************************************************************************
13.5
13.51             SF   - scale factor
                         If SF = 0, it will be estimated by the program
                  BQ   - overall isotropic temperature factor
13.52             CSF, CBQ  - codewords for SF and BQ 
13.6
13.61             U,V,W,Z,X,Y - FWHM ("H") parameters
                              For NPROF = 0...6
                               H2 = U*tan2Q + V*tanQ + W + Z/cos2Q
                              X & Y are used only when NPROF = 7, where
                               HGauss = [U*tan2Q + V*tanQ + W + Z/cos2Q]1/2
                               HLorentz = X*tanQ + Y/cosQ
13.62             CU,CV,CW,CZ,UX,UY - codewords for FWHM parameters
13.7
13.71             A, B, C, Alpha, Beta, Gamma - lattice parameters
                  LAUE - reflection generation flag
                   When LAUE = 1, the set of reflections is generated as for
                   Laue class -1 disregarding the actual lattice symmetry. This
                   option is required when the preferred orientation or
                   anisotropic broadening directions are inconsistent with the
                   crystal symmetry.
13.72             CA,CB,CC,CAlpha,CBeta,CGamma - lattice parameters codewords                       
13.8
13.81            G1, G2 - preferred orientation parameters,
                          PO = G2 + (1 - G2)* PrefCorrr(G1)
                        With IPREF=0, setting G1 to any number > 99.0 for a
                        phase causes the program to generate for that phase only
                        those reflections for which d* is parallel to the
                        preferred orientation vector PREF specified in Line 13.2
                 P1, P2, FCJ - peak asymmetry parameters
                 P1 and P2 are the split-FWHM asymmetry parameters:
                   FWHM_left  = FWHM_right + 2P1*EXP(-2 *0.084) + P2tan 
                 FCJ is an effective slit_height/diffractometer_radius ratio in
                 the Finger, Cox & Jephcoat asymmetry model. The convergence of
                 FCJ refinement may be slow and/or unstable for strongly
                 overlapped and noisy data. Use an appropriate starting value
                 (0.01-0.02), RLIM (Line 5) and relaxation factors (Line 6)
13.82            CG1, CG2, CP1, CP2, CFCJ - codewords for G1, G2, P1, P2, FCJ

Line             Description

13.9                 Profile Shape parameters
13.91            NA, NB, NC
                       For the usual pseudo-Voigt (NPROF=5) the Shape parameter
                                        n = NA + NB*2Q
                       For the Pearson VII (NPROF=6) the Shape parameter
                                    m = NA + NB/2Q + NC/(2Q)2
                       For all other profiles listed (1 - 3, 7), NA, NB, NC, and
                       their codewords must all be set to zero.
13.92            codewords for  NA, NB, NC

13.10            FWHMmin, FWHMmax - lower and higher FWHM limits for the FWHM
                                    estimation procedure (undocumented)
			IAN3 - anisotropic strain model flag
                       = 1 or -1 indicates 2nd rank anisotropy tensor:
                          Aniso2 = (STR1*h2 + STR2*k2 + STR3*l2 + STR4*2hk +
                                   + STR5*2hl + STR6*2kl)*0.001*d2
                       = 2 or -2 indicates 4th rank anisotropy tensor:
                          Aniso2 = [STR1*h4 + STR2*k4 + STR3*l4 + 
                          + 3(STR4*h2k2 + STR5*h2l2 + STR6*k2l2) +
                          + 2(STR7*kh3 + STR8*hl3 + STR9*lk3 +
                          + STR10*hk3 + STR11*lh3 + STR12*kl3) +
                       + 4(STR13*klh2 + STR14*hlk2 + STR15*khl2)]*0.00001*d4
                       For NPROF < 7, H(a)2 = H2 + Aniso2*tan2Q
                       For NPROF = 7 only:
                        if IAN3 > 0, HLorentz(a) = HLorentz + Aniso21/2*tanQ
                        if IAN3 < 0, HGauss(a) = HGauss + Aniso2*tanQ2
13.11
13.111           EPR(6) - six preferred orientation coefficients for the
                          Ellipsoidal IPREF = 2) function:
                          Icorr = Iobs[1 + (EPR1*h2 + EPR2*k2 + EPR3*l2 +
                              + EPR4*2hk + EPR5*2hl + EPR6*2kl)*0.001d2]-1.5
                          NOTE: When EPR coefficients are refined without
                             restrains, the scale-factor SF should be fixed.
13.112           CEPR(6) - codewords for EPR

13.113           SIZ(6) - six anisotropic size broadening coefficients 
                          The anisotropic broadening term is calculated as:
                          Aniso1 = (SIZ1*h2 + SIZ2*k2 + SIZ3*l2 + SIZ4*2hk +
                                   + SIZ5*2hl + SIZ6*2kl)*0.001*d2
                       For NPROF < 7, H(a)2 = H2 + Aniso1/cos2Q
                       For NPROF = 7, HLorentz(a) = HLorentz + Aniso11/2/cosQ
13.114           CSIZ(6) - codewords for SIZ

13.115           STR(1-6) - anisotropic strain broadening coefficients 
13.116           CSTR(1-6) - codewords for STR
       Lines 13.117 - 13.120 are entered if IAN3 = 2
*13.117          STR(7-12) - anisotropic strain broadening coefficients 
*13.118          CSTR(7-12) - codewords for STR
*13.119          STR(13-15) - anisotropic strain broadening coefficients 
*13.120          CSTR(13-15) - codewords for STR



B. The Data file

 This file contains the data from the diffractometer. The first line contains
the variables START, STEP, STOP and DATAID in free format:
  START  - beginning angle in degrees 2Q
  STEP   - step size in degrees 2Q
  STOP   - last angle in degrees 2Q
  DATAID - alphanumeric string identifier

The rest of the file consists of the data themselves in free format. Depending 
on the INSTRM parameter (Line 3) for each data-point either the profile 
intensity alone or both the intensity and its squared variance should be given.
                       
NOTE: The START angle assigned here must correspond to that of the first datum. 
The STOP angle can be any angle less than that of the last datum in the file. 
Any desired angular range can be selected for the refinement by (i) declaring an 
excluded region (NEXCRG in Line 3 and bounds in Line 10) from the START angle to 
the desired beginning and (ii) assigning the desired ending angle to STOP.

C. Optional files 'ddm_ffobs', and 'ddm_fwobs'

  These files, if used, should be placed to the same folder from which the 
program was run.
  The file 'ddm_ffobs' contains estimated observed squared structure factors 
after the last refinement (or decomposition) run. It is rewritten automatically 
by the program. It can be created and/or edited manually if the structure 
factors need to be entered at the initial step of the profile decomposition 
procedure (see NDEC description in Line 7).
  The file 'ddm_fwobs' is optional. It may contain fixed FWHM values for 
selected reflections. Five parameters should be specified for each selected 
reflection: h, k, l, FWHM, Nphase
where hkl are the indexes and Nphase is the number of phase to which the 
reflection belongs. The file format is free.
EXAMPLE:
  1   0   0   0.149  1
  1   3  -1   0.209  1
  1   0   1   0.242  2
......................
If 'ddm_fwobs' file exists in the folder from which the program was run the FWHM 
values for the selected reflections are read from it and fixed (not refined). 
This option may be useful in difficult cases of anisotropic peak broadening when 
it can not be satisfactorily modeled.

III. Description of output files

File 'ddm_out.txt' contains detailed output listing

File 'ddm_prf.prf' contains the observed and calculated patterns, which can be 
viewed by the popular program WinPLOTR. WinPLOTR is freely downloadable from:
  http://www-llb.cea.fr/fullweb/winplotr/winplotr.htm

File 'ddm_prf.txt' is a text file with the observed, calculated, difference, and 
background profile intensities and the DDM convolution interval widths (in 
degrees 2Q).

File 'ddm_ref.txt' contains positions and integral intensities of reflections.

File 'ddm_cif.cif' is the Crystallographic Information File, which can be read 
by many programs for crystal structure visualization and analysis.