Author: Brandon S Runnels (brunnels@uccs.edu), The University of Colorado Colorado Springs
Date: 03/02/2016
Version: 001

_______________________________________________________________________________________

*                       Section 1: Summary of input variables                         *
_______________________________________________________________________________________

In this Test Driver (TD), the user specifies the following variables through stdin using a Jinja template file named 'pipeline.stdin.tpl' contained in the directory of a Test which uses this TD (the sequence in which they are specified must be the same as below, with 'modelname' being the first):

- 'modelname'
Type: string
Description: Contains the extended-id of a valid KIM Model.  This can be specified by '@< MODELNAME >@' in pipeline.stdin.tpl.  When the pipeline mates a Model with the Test, it will automatically replace '@< MODELNAME >@' with the Model's extended-ID.

- 'a1'
Type: 3D integer-valued vector
Description: The miller indices corresponding to the vector that is initially in the GB (along the x direction)

- 'a2'
Type: 3D integer-valued vector
Description: The miller indices corresponding to the vector that is initially normal to the GB (along the y direction)

- 'a2'
Type: 3D integer-valued vector
Description: The miller indices corresponding to the tilt direction (along the z direction)
Note: a1, a2, a3 must be mutually orthogonal and must obey the right hand rule. Normality is not enforced.

- 'species'
Type: string
Description: The name of the material

- 'theta_min'
Type: double
Description: The initial tilt angle (in degrees)

- 'theta_max'
Type: double
Description: The final tilt angle (in degrees)

- 'max_denominator'
Type: int
Description: The maximum width (in number of latice spacings) of a repeating unit cell. The choice of this variable determines the number of GB orientations that will be considered.

- 'mass'
Type: double
Description: The molar mass (in g/mol) of the element specified by 'element', e.g. 39.948 for Argon.

- 'short_name'
Type: string
Description: The name of the crystal structure: should be fcc or bcc

- 'a'
Type: double
Description: The lattice constant

- 'cutoff_distance'
Type: double
Description: The threshold for initially deleting atomns. Units are in terms of lattice spacings, for instance, a value of 0.5 would delete atoms that are closer than 0.5*a.

- 'x_repeat'
Type: integer
Description: Number of repeating cells in the x direction

- 'z_repeat'
Type: integer
Description: Number of repeating cells in the z direction

- 'min_cell_height'
Type: float
Description: Minimum height of the unit cell (direction normal to interface). The number of repeating cells in the y direction is determined based on this value.

- 'offset_top'
Type: 3D float vector 
Description: Initial offset of the top crystal

- 'offset_bottom'
Type: 3D float vector
Description: Initial offset of the bottom crystal

- 'cohesive_energy'
Type: float
Description: The cohesive energy of the lattice 

- 'mass'
Type: double
Description: The molar mass (in g/mol) of the element specified by 'element', e.g. 39.948 for Argon.