LDMGE - CREATE .GE FILES FROM AN LDM FILE
=========================================


INTRODUCTION
 
The program LDMGE is used to create .ge files for a program such as INTLAUE
from a .ldm (Laue Data Module) parameters file. The .gen, .ge1 and .ge2
files are created. The program is only suitable for an LDM file with not
more than six plates in the pack. It is provided to allow the continued use
of existing Laue programs with a program such as LAUEGEN which now makes
use of the Laue Data Module. The program was written by J.W. Campbell,
Daresbury Laboratory.
 
List of sections:
 
   Data Control Cards
   Input and Output Files
   Running the Program
   Notes
   Printer Output
   Error Messages
   Program Function
   References
 
DATA CONTROL CARDS
 
The program is run interactively with a question and answer sequence as
follows:
 
 
LDM input file name (default ext=.ldm):
 
   The reply is the name of the input LDM (.ldm) file.
 
Root name for .gen/.ge1/.ge2 files:
 
   The reply is the root part of the required file name for the output
   .gen, .ge1 and .ge2 files. The corresponding file type extensions are
   added to this root to give the actual file names. If a file extension is
   given in the reply then this extension will be removed and ignored. If
   any of the three files are already present then a error message will be
   output indicating that the file exists and the prompt will be repeated.
   If a blank reply is given, then the write .ge files option will be
   abandoned.
 
Pack number for which .ge files are required [1]:
 
   The user selects the pack number for which the .gen/.ge1/.ge2 files are
   to be written. This must be within the range defined in the LDM file.
 
Do you want to write spatials to the file (y/n) [n]:
 
   The user replies with 'yes' if spots, determined as being spatially
   overlapped, are to be written to the .ge1/.ge2 files or 'no' (the
   default) if they are not to be written.
 
Enter Min I to by-pass measurements on subsequent plates [100]:
 
   The reply is an intensity value used by the integration program INTLAUE
   with a default value of 100.
 
 
The .ge1/.ge2 files reflection data are then written. A summary of
reflection counts is then output.
 
 
INPUT AND OUTPUT FILES
 
The input file is:
 
a) A .ldm Laue Data Module (LDM) parameters file.
 
The output files are:
 
a) A .gen parameters file.
 
b) A .ge1 (binary) predicted spot list file for use with integration
   program.
 
c) A .ge2 (binary) file with harmonic data which cannot be contained in the
   .ge1 file.
 
 
 
RUNNING THE PROGRAM
 
Use the command 'laue ldmge'
 
 
NOTES
 
None.
 
 
PRINTER OUTPUT
 
None.
 
 
ERROR MESSAGES
 
a) Unable to open the input .ldm file.
 
   **File not found**
 
   **Error in opening file**
 
b) Errors reading LDM data (+ other LDM error messages)
 
   **Error** LDM_READLINE error, ierr= n
 
   **Error** LDM_PARSE error
 
c) Errors opening output files
 
   **.gen file already exists**
 
   **.ge1 file already exists**
 
   **.ge2 file already exists**
 
   **Error in opening the .gen file**
 
   **Error in opening the .ge1 file**
 
   **Error in opening the .ge2 file**
 
 
 
PROGRAM FUNCTION
 
The program LDMGE is used to give compatibility with the other programs of
the Laue software suite which are not yet based on the Laue Data Module
(LDM) developments. It creates a set of .ge files (.gen/.ge1/.ge2) from an
LDM parameters data file. The processing is limited to a singlepack with a
maximum of six plates in that pack.
 
 
REFERENCES
 
None.