Goniostat Commands

goniostatchange

Syntax: goniostatchange arg value....
Change one or more of the goniostat parameters.

arg	type	description
beamstopangle	angle	angle of the beamstop holder. 0.0 is up, rotating counterclockwise
id	string	identifier
kappachiaxis	vector	kappa or chi axis (gonio 2) in laboratory coordinates
kappasupport	angle	support angle of a kappa goniostat
offset	3 angles	zero offsets for omega, kappa/chi, phi
omegaaxis	vector	omega axis (gonio 1) in laboratory coordinates
phiaxis	vector	phi axis (gonio 3) in laboratory coordinates
rotationdirection	f f f	the rotation direction (+1.0=counterclockwise) for each of the goniostat axes
rotax000	vector	laboratory vector describing the phi axis when all goniostat angles are zero
swingaxis	vector	swing rotation axis in laboratory coordinates
swingdirection	f	the direction of the swing angle (+1.0=counterclockwise)
type	string	goniostattype. One of kappa/kappahor/kappa180/euler/horax/dtb/x8/raxis

Multiple arguments may be given on one ore more input lines.
The goniostatchange command is terminated with goniostatend or nop.
If the goniostattype is changed, all corresponding items will be initialized.

Examples

goniostatchange type kappa nop
Set the goniostat type to kappa (similar to goniostattype kappa).
goniostatchange type kappa kappasupport 50.0147 nop
Set the goniostat type to kappa and change the value of the kappasupport angle.
goniostatchange type horax swingaxis 0 0 1 nop
Set the goniostat type to horax, and change the vector describing the swing axis.

goniostatprint

Prints the goniostat parameters. The output consists of two parts. The first part gives the non-default values. The second part gives all the values.

Example

goniostatchange type kappa swingdirection 1 nop
goniostatprint

non-default: type kappa swingdirection 1.0
full: type kappa kappasupport 50.0 beamstopangle 0.0 swingdirection 1.0 rotationdirection -1.0 -1.0 -1.0
swingaxis 0.0 0.0 1.0 kappachiaxis 0.76604 0.0 0.64279 rotax000 0.0 0.0 1.0 offset 0.0 0.0 0.0

goniostattype

Syntax: goniostattype type.
Sets the goniostat type. If type differs from the current goniostattype, all items will be initialized.

goniostat types

type	description
kappa	goniostat with axes omega, kappa and phi. You should also set kappasupport
kappahor	goniostat with axes omega, kappa and phi. You should also set kappasupport horizontal orientation
kappa180	goniostat with axes omega, kappa and phi. You should also set kappasupport offset for omega = 180
euler	goniostat with euler axes omega, chi and phi
horax	euler goniostat, rotated 90 degrees around 1,0,0. horizontal swingaxis and rotax000
dtb	euler goniostat. horizontal swingaxis and rotax000
x8	Bruker (quasi) euler goniostat
raxis	?

default values

arg	kappa	kappahor	kappa180	euler	horax	dtb	x8	raxis
beamstopangle	0.0	180.0	0.0	90.0	90.0	90.0	0.0	0.0
kappachiaxis	sin(Κ) 0 cos(Κ)	sin(Κ) 0 cos(Κ)	sin(Κ) 0 cos(Κ)	1 0 0	1 0 0	-1 0 0	1 0 0	1 0 0
kappasupport	50	50	50
offset	0 0 0	0 0 0	180 0 0	0 0 0	0 0 0	0 0 0	180 0 90	0 0 0
omegaaxis	0 0 1	0 0 1	0 0 1	0 0 1	0 1 0	0 0 1	0 0 1	0 0 1
phiaxis	0 0 1	0 0 1	0 0 1	0 0 1	0 0 1	0 0 1	0 0 1	0 0 1
rotationdirection	-1 -1 -1	1 1 1	-1 -1 -1	1 1 1	1 1 1	-1 -1 -1	1 -1 -1	1 1 1
rotax000	0 0 1	0 1 0	0 0 1	0 0 1	0 1 0	0 -1 0	0 0 1	0 0 1
swingaxis	0 0 1	0 0 1	0 0 1	0 0 1	0 1 0	0 1 0	0 0 1	0 0 1
swingdirection	-1	-1	-1	1	1	1	1	1

You may change these values with goniostatchange.
The goniostattype can also be set using goniostatchange type type nop.
goniostatprint prints the parameters for the current goniostat.