|
|
|
|
|
|
|
|
|
cage3
|
cage3
or cage3, onoff
Toggle the cage display. If ONOFF is non-nil and non-zero,
turn on the cage. If ONOFF is zero, turn off the cage.
The cage draws a rectangular box "behind" the 3D object and
attempts to put ticks and labels around the edge of the box.
unknown type function, documented at include/pl3d.i line 1011
| |
| SEE ALSO: |
limit3, |
|
|
call
|
call, subroutine(arg1, arg2, arg3, arg4, arg5
arg6, arg7, arg8);
allows a SUBROUTINE to be called with a very long argument list
as an alternative to:
subroutine, arg1, arg2, arg3, arg4, arg5,
arg6, arg7, arg8;
Note that the statement
subroutine(arg1, arg2, arg3, arg4, arg5,
arg6, arg7, arg8);
will print the return value of subroutine, even if it is nil.
If invoked as a function, call simply returns its argument.
unknown type function, documented at startup/std.i line 2666
| |
|
catch
|
catch(category)
Catch errors of the specified category. Category may be -1 to
catch all errors, or a bitwise or of the following bits:
0x01 math errors (SIGFPE, math library)
0x02 I/O errors
0x04 keyboard interrupts (e.g.- control C interrupt)
0x08 other compiled errors (YError)
0x10 interpreted errors (error)
Use catch by placing it in a function before the section of code
in which you are trying to catch errors. When catch is called,
it always returns 0, but it records the virtual machine program
counter where it was called, and longjumps there if an error is
detected. The most recent matching call to catch will catch the
error. Returning from the function in which catch was called
pops that call off the list of catches the interpreter checks.
To use catch, place the call near the top of a function:
if (catch(category)) {
...
| |
| SEE ALSO: |
error |
|
|
cd
|
cd, directory_name
or cd(directory_name)
change current working directory to DIRECTORY_NAME, returning
the expanded path name (i.e.- with leading environment variables,
., .., or ~ replaced by the actual pathname). If called as a
function, returns nil to indicate failure, otherwise failure
causes a Yorick error.
unknown type function, documented at startup/std.i line 1552
| |
| SEE ALSO: |
get_cwd, |
|
|
ceil
|
ceil(x)
returns the smallest integer not less than x (no-op on integers).
unknown type function, documented at startup/std.i line 619
| |
| SEE ALSO: |
floor |
|
|
clear3
|
clear3
Clear the current 3D display list.
unknown type function, documented at include/pl3d.i line 728
| |
|
close
|
close, f
closes the I/O stream F (returned earlier by the open function).
If F is a simple variable reference (as opposed to an expression),
the close function will set F to nil. If F is the only reference
to the I/O stream, then "close, f" is equivalent to "f= []".
Otherwise, "close, f" will close the file (so that subsequent
I/O operations will fail) and print a warning message about the
outstanding ("stale") references.
unknown type function, documented at startup/std.i line 1229
| |
| SEE ALSO: |
open, save, |
|
|
collect
|
result= collect(f, name_string)
scans through all records of the history file F accumulating the
variable NAME_STRING into a single array with one additional
index varying from 1 to the number of records.
NAME_STRING can be either a simple variable name, or a name
followed by up to four simple indices which are either nil, an
integer, or an index range with constant limits. (Note that
0 or negative indices count from the end of a dimension.)
Examples:
collect(f, "xle") -- collects the variable f.xle
collect(f, "tr(2,2:)") -- collects f.tr(2,2:)
collect(f, "akap(2,-1:0,)") -- collects f.akap(2,-1:0,)
(i.e.- akap in the last two values of its
second index)
unknown type function, documented at startup/std.i line 1711
| |
| SEE ALSO: |
get_times |
|
|
color_bar
|
color_bar
or color_bar, levs, colors
Draw a color bar below the current coordinate system. If LEVS is
not specified uses plfc_levs (set by previous call to plfc). If
COLORS is specified, it should have one more value than LEVS,
otherwise equally spaced colors are chosen, or plfc_colors if
plfc_levs was used. With the vert=1 keyword the color bar appears
to the left of the current coordinate system (vert=0 is default).
By default, color_bar will attempt to label some of the color
interfaces. With the labs= keyword, you can force the labelling
algorithm as follows: labs=0 supresses all labels, labs=n forces
a label at every nth interface, labs=[i,n] forces a label at every
nth interface starting from interface i (0<=i<=numberof(LEVS)).
You can use the adjust= keyword to move the bar closer to (adjust<0)
or further from (adjust>0) the viewport, and the height= keyword to
set the height of any labels (default 14 points).
unknown type function, documented at startup/graph.i line 1610
| |
| SEE ALSO: |
plfc |
|
|
conj
|
conj(z)
returns the complex conjugate of its argument.
unknown type function, documented at startup/std.i line 646
| |
|
contour
|
nc= contour(yc,xc, level, z, y,x)
or nc= contour(yc,xc, level, z, y,x,ireg)
returns the points on the contour curve that would have been
plotted by plc. Z, Y, X, and IREG are as for plc, and the
triangle= and region= keywords are accepted and have the same
meaning as for plc. Unlike plc, the triangle array is an output
as well as an input to contour; if supplied it may be modified
to reflect any triangulations which were performed by contour.
LEVEL is a scalar z value to return the points at that contour
level. All such points lie on edges of the mesh. If a contour
curve closes, the final point is the same as the initial point
(i.e.- that point is included twice in the returned list).
LEVEL is a pair of z values [z0,z1] to return the points of
a set of polygons which outline the regions between the two
contour levels. These will include points on the mesh boundary
which lie between the levels, in addition to the edge points
for both levels. The polygons are closed, simply connected,
and will not contain more than about 4000 points (larger polygons
are split into pieces with a few points repeated where the pieces
join).
YC and XC are the output points on the curve(s), or nil if there
are no points. On input, they must be simple variable references,
not expressions. The return value NC is a list of the lengths of
the polygons/polylines returned in (XC,YC), or nil if there are
none. numberof(XC)==numberof(YC)==sum(NC). For the level pair
case, YC, XC, and NC are ready to be used as inputs to plfp.
KEYWORDS: triangle, region
unknown type function, documented at startup/graph.i line 421
| |
| SEE ALSO: |
plc, |
|
|
copyb
|
copyb, src, dst
or copyb, openb(src_name), createb(dst_name)
Copy binary file SRC to binary file DST.
Check for "obsolete/" subdirectory of Yorick home directory for
extensions of the openb function to old file formats.
Use the size= keyword to specify a non-default (4 Mbyte) size for
the members of the output file family.
If you habitually include basfix.i, you may want to use the
basfix_openb function to open the src file.
unknown type function, documented at include/copyb.i line 26
| |
| SEE ALSO: |
openb, |
|
|
cos
|
unknown type function, documented at startup/std.i line 524 | |
| SEE |
sin |
|
|
cosh
|
unknown type function, documented at startup/std.i line 562 | |
| SEE |
sinh |
|
|
cray_primitives
|
cray_primitives, file
sets FILE primitive data types to be native to Cray 1, XMP, and YMP.
unknown type function, documented at startup/std.i line 1978
| |
|
create
|
f= create(filename)
is a synonym for f= open(filename, "w")
Creates a new text file FILENAME, destroying any existing file of
that name. Use the write function to write into the file F.
unknown type function, documented at startup/std.i line 1216
| |
| SEE ALSO: |
write, |
|
|
createb
|
file= createb(filename)
or file= createb(filename, primitives)
creates FILENAME as a PDB file in "w+b" mode, destroying any
existing file by that name. If the PRIMITIVES argument is
supplied, it must be the name of a procedure that sets the
primitive data types for the file. The default is to create
a file with the native primitive types of the machine on which
Yorick is running. The following PRIMITIVES functions are
predefined:
sun_primitives -- appropriate for Sun, HP, IBM, and
most other workstations
sun3_primitives -- appropriate for old Sun-2 or Sun-3
dec_primitives -- appropriate for DEC (MIPS) workstations
alpha_primitives -- appropriate for DEC alpha workstations
cray_primitives -- appropriate for Cray 1, XMP, and YMP
mac_primitives -- appropriate for MacIntosh
macl_primitives -- appropriate for MacIntosh, 12-byte double
pc_primitives -- appropriate for IBM PC
vax_primitives -- appropriate for VAXen only (H doubles)
vaxg_primitives -- appropriate for VAXen only (G doubles)
xdr_primitives -- appropriate for XDR files
unknown type function, documented at startup/std.i line 1933
| |
| SEE ALSO: |
openb, set_filesize, close102_default, |
|
|
current_window
|
n= current_window()
returns the number of the current graphics window, or -1 if none.
unknown type function, documented at startup/graph.i line 104
| |
|
|
|
|
|
|
|
|