emcSetGoniometerPosition

NAME

emcSetGoniometerPosition - Move the goniometer to a new position

SYNOPSIS

#include "emc.h"
int emcSetGoniometerPosition(EM *em, int units, int correction, int relative,
                             double x, double y, double z, double a, double b);

DESCRIPTION

emcSetGoniometerPosition() sets the current position of goniometer

*em

points to an EM control and communications structure that was returned by the emcOpen() call.

units

the units the values are expressed in:

UNCALIBRATED_UNITS	Positions are measured in units
ANGSTROM_UNITS	Positions are measured in angstroms
NANOMETER_UNITS	Positions are measured in nanomaters
MICRON_UNITS	Positions are measured in microns
PIXEL_UNITS	Positions are measured in pixels

autocorrect

The type of correction for imaging side effects that should be made:

NONE	No correction of goniometer movement is made
HYSTERESIS	Hysteresis corrections made. Each change along an axis is corrected or hysteresis. Requested position is always approached from lower to higher axis position.
ORIENTATION	Axis orientation corrections made. The mechanical stage is not necessarily oriented precisely along the optical axis. This flag corrects for this so that the movement is made along the optical rather than mechanical axis. (X and Y only)
AUTO	Both HYSTERESIS and ORIENTATION corrections are made.

relative

Flags what the movement is relative to the current position or an absolute distance from the goniometer origin position and whether movement is measure along the optical or mechanical axis of the goniometer.

EMC_RELATIVE_MECHANICAL EMC_RELATIVE	Goniometer position change measured relative to current position and along the mechanical axis of the goniometer.
EMC_ABSOLUTE_MECHANICAL EMC_ABSOLUTE	Goniometer position change measured relative to giniometer origin position and along the mechanical axis of the goniometer.
EMC_RELATIVE_OPTICAL	Goniometer position change measured relative to current position and along the optical axis.
EMC_ABSOLUTE_OPTICAL	Goniometer position change measured relative to to goniometer origin position and along the optical axis

x

the amount of X-axis change

y

the amount of X-axis change

z

the amount of X-axis change

a

the amount of A-axis tilt change (in radians)

b

the amount of B-axis tilt change (in radians)

DIAGNOSTICS

Page 49 of 54