Data File Format for CCC_atom ver 1.0

The CCC_atom application takes in the positions and the models to be used for the atoms.  Each data file specifies the locations of all the atoms at a specific moment in time and refers to the names of the models to be used.  NOTE:  All models must be placed within a "atommodels" directory off of the ccc_atom directory.   This was done since each client has their own copies of the models and the simulation must know where to go and get them each time (even if somebody else loads the model).  The following example shows the beginning of such a file.  All files need only be in text format.

filename: test.31

         4
   0.9000000000000000
 Al    -59.76837620303741      -69.54976222542665     -1.0176230615702367E-15
 Ni    -61.69366158436890      -70.30929695743578       1.437599999999999
 Al    -60.00911675005008      -63.10989069746438     -9.8906913559299175E-16
 Ni    -61.93738858514705      -63.87160428499993       1.437599999999999

Filenames:  The name of this file was test.31.  The 31 extension refers to an index number.  This index number may be anything you please and will be used to show the models in the correct time sequencing when in the "time change" mode.  Thus, if you wanted to play 5 files in a row after "test.31", you would call them "test.32" through to "test.36" or alternatively you could call them "test.1" through to "test.6".

Data Format:  The first line in the file refers to the number of atoms in the structure, in this case there are 4.  The second line refers to a number that is used by MSI's WebLab-ViewerPro, but ccc_atom does not use the number.  Be sure to include a similar number though in all data files for the moment since ccc_atom will still take into account the spacing for this number in the data file.   The lines after this show the name of the model to be loaded along with its x, y and z position respectively.  Thus the first line says to put the Al model at x = -59.76837620303741, y = -69.54976222542665 and z = -1.0176230615702367E-15.  The Al model itself must be kept in the ccc_atom directory and may be of format "iv","wrl" or "vrml".  If no model is found for the given name with any of these three extensions then the program creates its own standard spherical models using different colors for each type of atom.

Loading the Files:  Each interface (the cave voice interface versus the desktop menu interface) provides a different way to load the models.  Please see the functionality pages for more information on how to use each method. In general the base name of the file to be loaded must be specified (e.g. if you have files called test.31 through test.45 then specify the name "test" as the file name), along with the minimum index (which is 31 in our example), the maximum index (which is 36 if we added the 5 extra files), and the refinement.  This last option will determine the number of polygons to use in the default model spheres if no specified models are found.  The standard is 32, higher will give better looking models but will take more time to render for each frame, lower will give faster performance but less precise models.  The atom files must be stored in the ccc_atom directory if multiple participants are expected (if you connect tom someone with a model already loaded it will check in your ccc_atom directory for the same model).

For more information on other functionality in CCC_atom please refer to the functionality pages.
 

Virginia Tech
VT-CAVE
Created 05/12/00, Revised 05/12/00

http://www.sv.vt.edu/future/cave/software/cccatom/fileformat.html