spec

Software for Diffraction

5.5.1. - File Hierarchy



After installation and site configuration on a computer running, for example, both a four-circle and a z-axis diffractometer, the spec file hierarchies would appear something like the following,
                      |-chelp
                      |-contents
                      |-dpmake
                      |-fourc
/usr/local/bin--------|-scans
                      |-showscans
                      |-show_state
                      |-specfile
                      |-splot
                      |-tidy_spec
                      |-wiz_passwd
                      |-zaxis
                      |-README
                      |-data_pipe-----|-data_pipe.mak
                      |               |-data_pipe.o
                      |               |-pipe_test.c
                      |               |-user_pipe.h
                      |
                      |-edconf        |-config        |-hdw_lock
                      |-four.mac      |-settings      |-user_ttyH
                      |-fourc---------|-conf.mac      |-user_ttyL
                      |               |-userfiles-----|-user_ttyP
                      |                               |-user_ttyS
                      |-hgr-----------|-x11filt       |- ...
                      |
                      |-include-------|-spec_server.h
                      |               |-spec_shm.h
/usr/local/lib/spec.d-|-passwd
                      |-show.awk
                      |-site.mac      |-help         |-angles
                      |-site_f.mac    |-help.tmac    |-ackno
                      |-spec.conf     |-help_man-----|-changes
                      |-spec_help-----|              |- ...
                      |               |
                      |               |              |-angles
                      |               |-help_pre-----|-ackno
                      |               |              |-changes
                      |               |              |- ...
                      |               |-news
                      |               |-nroff_help.tmac
                      |               |-old_help.tmac
                      |               |-rst2man
                      |
                      |-splot---------|-many splot files
                      |
                      |-standard.mac  |-config        |-hdw_lock
                      |-zaxi.mac      |-settings      |-user_ttyH
                      |-zaxis---------|-conf.mac      |-user_ttyL
                                      |-userfiles-----|-user_ttyP
                                                      |-user_ttyS
                                                      |- ...

where /usr/local/bin is the installation directory, configured as INSDIR in the Makefile, and /usr/local/lib/spec.d is SPECD, the auxiliary file directory. Of the programs installed in /usr/local/bin, contents and showscans are described in the User Manual, while the camac utility program is described below. The chelp utility is a stand-alone help file viewer that allows browsing of the spec help files without having to run spec.

The subdirectory fourc contains the files specific to the four-circle diffractometer. The name fourc matches the name by which the program is invoked. The first four letters of the name determine the geometry configuration. If a single computer is to control two spectrometers, they could be called fourcL and fourcR, and the Install program would create separate subdirectories called by those names for each.

Within the diffractometer directory is the associated configuration file, config, which specifies the hardware and the motor parameters to be used. Also associated with each diffractometer is the settings file that tracks changes in the motor position and limit settings. The edconf program can be used to to modify the contents of these two files.

The subdirectory userfiles contains each user's state files on a per terminal basis. These files allow the user to exit spec and restart at a later time, retaining macro definitions, variable assignments, etc. The spec administrator may, from time to time, delete old state files for users not expected back again, especially if disk space is a problem. The tidy_spec program reports on the disk usage of all the userfiles directorys and provides options for removing files by age, user, tty or spectrometer geometry. Type tidy_spec - from the shell for usage options.