CMC Macro Info

CMC-CAT Macro Information

This page lists Spec macros in use at CMC as of June 2000.

CMC geometry and naming conventions
site.mac: see also notes on the energy macros
energyCMC.mac: see also notes on the energy macros
fpath.mac, table.mac, mirror.mac: see notes, below.
slit.mac: see notes
analyzerSi111.mac (Please don't put brackets in unix file names!)
opco.mac - macros that report ring status and monochromator LN control
tempctrl_epics.mac
filter-box.mac
sem_util.mac (documentation to appear on the updated motor page)

Standing macro to-do list:

move/scan undulator gap
interface with MCA

CMC geometry and naming conventions

We are using the APS conventions for directions:

z along the beam (positive downstream)
y vertical (positive up)
x horizontal (positive outboard, away from the ring)

NOTE: Consensus has been reached on the appropriate usage of "left" and "right". The CMC tribe holds the belief that we should be looking downstream, as though astride the very photons, so that left = positive x = outboard. Those who preferred to turn one's gaze towards the source (outboard = positive x = right) are no longer with us.

Nothing prevents us putting the slit assemblies onto the flight path in the wrong orientation, however. The leftness, rightness, topness or bottomness of a slit jaw is best determined empirically and adjusted to match the macros. CMC decrees "top" to mean towards the ceiling (positive y), "bottom" towards the floor (negative y). Note that you must correctly render the serial numbers of XIA controllers. If it ends in -084, you cannot enter -0084 into the epics screen.

As far as possible we use the letters f, s and b to begin mnemonics for FOE, SOE and B hutch components. Slits in the FOE and SOE have names. Slits in the experimental hutch just get numbers so that they can be added and moved around without making the names meaningless. These conventions also apply to pseudomotors such as slit edges defined by positions of wedge motors. (Back to top.)

Spec macros for tables, flight paths, and mirrors

These macros define commands and special scans for relative translation and tilting motions of tables and other components with sets of vertical and horizontal actuators. Provision is made within the macros to customize units for angular motions. By use of a scale factor, a tilt motion can be in degrees, in linear deflection of an actuator, or in something like the motion of a reflected spot at a further distance (which may be useful for mirror tilting). (Back to top.)

Slit macros

The conventions for slits are similar to those used at X22. Units are in mm with positive being away from the gap for the four slit jaws top(t), bottom(b), left(l) and right(r). For closed slits all jaws have position=0. The position of the gap (midpoint between two opposed jaws) is positive if towards the top or left. The main useful slit commands have the form:

cvslitX center gap
chslitX center gap

X specifies which set of slits; v=vertical gap (moves top and bottom jaws); h=horizontal gap (moves left and right jaws); center specifies the position of the center of the gap (mm from the zero position); gap is the width of the gap (mm). The command slits displays slit positions. The center position is positive if towards the top or left.

No Spec macros or pseudomotor records exist for the white beam slits in the FOE, although these slit positions are displayed by the macro. (Back to top.)