gvector
 List of: Scheme Extensions Subjects: Mathematics Contents: Kernel
Action: Creates a new gvector given coordinates x, y, and z.

Filename: kern/kern_scm/gvec_scm.cxx

Syntax: (gvector x y z [space=model])

Arg Types: x real

y real

z real

space string

Returns: gvector

x defines the x-coordinate relative to the active coordinate system.

y defines the y-coordinate relative to the active coordinate system.

z defines the z-coordinate relative to the active coordinate system.

The optional space argument defaults to "WCS". If no active WCS exists,space defaults to "model". The other optional space arguments return agvector in the new coordinate system. The values for thespace argument are:

- "wcs" is the default if an active WCS exists. Otherwise, the default is "model".

- "model" means that the x, y, and z values are with respect to the model. If the model has an origin other than the active WCS, this returns the position relative to the active coordinate system in rectangular Cartesian coordinates.

- "polar" or "cylindrical" mean that the x, y, and z values are interpreted as the radial distance from the z-axis, the polar angle in degrees measured from the xz plane (using right-hand rule), and the z coordinate, respectively. This returns the x, y, and z terms with respect to the active coordinate system.

- "spherical" means that the provided x, y, and z values are the radial distance from the origin, the angle of declination from the z-axis in degrees, and the polar angle measured from the xz plane in degrees, respectively. This returns the x, y, and z terms with respect to the active coordinate system.

Example: ; gvector

; Create gvectors of various types.

(gvector 3 3 3)

;; #[gvector 3 3 3]

(gvector 5 5 5 "wcs")

;; #[gvector 5 5 5]

(gvector 5 5 5 "model")

;; #[gvector 5 5 5]

(gvector 5 5 5 "polar")

;; #[gvector 4.98097349045873 0.435778713738291 5]

(gvector 5 5 5 "cylindrical")

;; #[gvector 4.98097349045873 0.435778713738291 5]

(gvector 5 5 5 "spherical")

;; #[gvector 0.434120444167326 0.0379806174694798

;; 4.98097349045873]
PDF/KERN/13SCF.PDF
HTM/DATA/KERN/KERN/13SCF/0072.HTM