Google

section w of routines in global.i

yorick banner

Home

Manual

Packages

Global Index

Keywords

Quick Reference

all functions - w

 
 
 
where


             where(x)  
 
     returns the vector of longs which is the index list of non-zero  
     values in the array x.  Thus, where([[0,1,3],[2,0,4]]) would  
     return [2,3,4,6].  If noneof(x), where(x) is a special range  
     function which will return a nil value if used to index an array;  
     hence, if noneof(x), then x(where(x)) is nil.  
     If x is a non-zero scalar, then where(x) returns a scalar value.  
     The rather recondite behavior for scalars and noneof(x) provides  
     maximum performance when the merge function to be used with the  
     where function.  

builtin function, documented at i0/std.i   line 758  
SEE ALSO: where2,   merge,   merge2,   allof,   anyof,   noneof,  
nallof,   sort  
 
 
 
where2


             where2(x)  
 
     like where(x), but the returned list is decomposed into indices  
     according to the dimensions of x.  The returned list is always  
     2 dimensional, with the second dimension the same as the dimension  
     of where(x).  The first dimension has length corresponding to the  
     number of dimensions of x.  Thus, where2([[0,1,3],[2,0,4]]) would  
     return [[2,1],[3,1],[1,2],[3,2]].  
     If noneof(x), where2 returns [] (i.e.- nil).  

interpreted function, defined at i0/std.i   line 772  
SEE ALSO: where,   merge,   merge2,   allof,   anyof,   noneof,  
nallof,   sort  
 
 
 
widget_setup


 widget_setup  
 
  

interpreted function, defined at i/demo3.i   line 58  
 
 
 
window


             window, n, display="host:server.screen", dpi=100/75, wait=0/1,  
                        private=0/1, hcp="hcp_filename", dump=0/1,  
                        legends=1/0, style="style_sheet_filename",  
                        width=wpixels,height=hpixels,rgb=1  
 
     select window N as the current graphics output window.  N may  
     range from 0 to 7, inclusive.  Each graphics window corresponds to  
     an X window, and optionally has its own associated hardcopy file.  
     If N is omitted, it defaults to the current coordinate system.  
     The X window will appear on your default display at 75 dpi, unless  
     you specify the display and/or dpi keywords.  A dpi=100 X window  
     is larger than a dpi=75 X window; both represent the same thing  
     on paper.  Use display="" to create a graphics window which has  
     no associated X window (you should do this if you want to make  
     plots in a non-interactive batch mode).  
     By default, if the X window needs to be created, the graphics area  
     will be 450x450 pixels if dpi=75, or 600x600 pixels if dpi=100,  
     representing a 6x6 inch square on hardcopy paper.  You can override  
     this default initial size using the width and height keywords.  
     These settings remain in force indefinitely; use width=0,height=0  
     to return to the default dpi-dependent behavior.  For a dpi=75,  
     landscape=0 window, width=638,height=825 displays the entire sheet  
     of hardcopy paper.  Supplying these keywords will not change the  
     size of an existing window; only newly created windows.  
     By default, an X window will attempt to use shared colors, which  
     permits several Yorick graphics windows (including windows from  
     multiple instances of Yorick) to use a common palette.  You can  
     force an X window to post its own colormap (set its colormap  
     attribute) with the private=1 keyword.  You will most likely have  
     to fiddle with your window manager to understand how it handles  
     colormap focus if you do this.  Use private=0 to return to shared  
     colors.  
     By default, Yorick will not wait for the X window to become visible;  
     code which creates a new window, then plots a series of frames to  
     that window should use wait=1 to assure that all frames are actually  
     plotted.  
     By default, a graphics window does NOT have a hardcopy file  
     of its own -- any request for hardcopy are directed to the  
     default hardcopy file, so hardcopy output from any window goes  
     to a single file.  By specifying the hcp keyword, however, a  
     hardcopy file unique to this window will be created.  If the  
     "hcp_filename" ends in ".ps", the hardcopy file will be a PostScript  
     file; otherwise, hardcopy files are in binary CGM format.  Use  
     hcp="" to revert to the default hardcopy file (closing the window  
     specific file, if any).  The legends keyword, if present, controls  
     whether the curve legends are (legends=1, the default) or are not  
     (legends=0) dumped to the hardcopy file.  The dump keyword, if  
     present, controls whether all colors are converted to a gray scale,  
     (dump=0), or the current palette is dumped at the beginning of each  
     page of hardcopy output (dump=1, the default).  (The legends keyword  
     applies to all pictures dumped to hardcopy from this graphics  
     window.  The dump keyword applies only to the specific hardcopy  
     file defined using the hcp keyword -- use the dump keyword in the  
     hcp_file command to get the same effect in the default hardcopy  
     file.)  
     Use rgb=1 to set the rgb color model when you are creating a  
     window on an 8-bit display on which you intend to use three  
     component rgb colors (see color).  This installs the 5x9x5  
     colorcube and avoids having to issue the palette command  
     after the first true color object has been drawn.  
     If both display="" and hcp="", the graphics window will be  
     entirely eliminated.  
     The style keyword, if present, specifies the name of a Gist style  
     sheet file; the default is "work.gs".  The style sheet determines  
     the number and location of coordinate systems, tick and label styles,  
     and the like.  Other choices include "axes.gs", "boxed.gs",  
     "work2.gs", and "boxed2.gs".  
     If invoked as a function, window(...) returns the current  
     window number.  

builtin function, documented at i0/graph.i   line 13  
SEE ALSO: plsys,   hcp_file,   fma,   hcp,   redraw,   palette,  
animate,   plg,   winkill,   gridxy  
 
 
 
window3


             window3  
          or window3, n  
 
     initialize style="nobox.gs" window for 3D graphics  

interpreted function, defined at i/pl3d.i   line 723  
 
 
 
winkill


             winkill  
          or winkill, n  
 
     deletes the current graphics window, or graphics window N (0-7).  

interpreted function, defined at i0/graph.i   line 96  
SEE ALSO: window  
 
 
 
write


             n= write(f, format=fstring, linesize=l, obj1, obj2, ...)  
             n= write(format=fstring, linesize=l, obj1, obj2, ...)  
 	 or strings= swrite(format=fstring, linesize=l, obj1, obj2, ...)  
 
     writes text to I/O stream F (1st form), or to the terminal (2nd  
     form), or to the STRINGS string array (3rd form), representing  
     arrays OBJ1, OBJ2, ..., according to the optional FSTRING.  The  
     optional linesize L defaults to 80 characters, and helps restrict  
     line lengths when FSTRING is not given, or does not contain  
     newline directives.  The write function always appends to the  
     end of a text file; the position for a sequence of reads is  
     not affected by intervening writes.  
     There must be one conversion specifier (see below) in FSTRING for  
     each OBJ to be written; the type of the conversion specifier must  
     generally match the type of the OBJ.  That is, an integer OBJ  
     requires an integer specifier (d, i, o, u, x, or c) in FSTRING,  
     a real OBJ requires a real specifier (e, f, or g), a string OBJ  
     requires the string specifier (s), and a pointer OBJ requires a  
     the pointer specifier (p).  An OBJ may not be complex, a structure  
     instance, or any non-array Yorick object.  If FSTRING is not  
     supplied, or if it has fewer conversion specifiers than the  
     number of OBJ arguments, then Yorick supplies default specifiers  
     (" %8ld" for integers, " %14.6lg" for reals, " %s" for strings, and  
     " %8p" for pointers).  If FSTRING contains more specifiers than  
     there are OBJ arguments, the part of FSTRING beginning with the  
     first specifier with no OBJ is ignored.  
     The OBJ may be scalar or arrays, but the dimensions of the OBJ  
     must be conformable.  If the OBJ are arrays, Yorick behaves as  
     if he write were called in a loop dimsof(OBJ1, OBJ2, ...) times,  
     writing one array element of each of the OBJ according to FSTRING  
     on each pass through the loop.  The swrite function returns a  
     string array with dimensions dimsof(OBJ1, OBJ2, ...).  The write  
     function inserts a newline between passes through the array if  
     the line produced by the previous pass did not end with a  
     newline, and if the total number of characters output since the  
     previous inserted newline, plus the number of characters about  
     to be written on the current pass, would exceed L characters  
     (L defaults to 80).  The write function returns the total  
     number of characters output.  
     The FSTRING is composed of a series of "directives" which are  
     (1) characters other than % -- copied directly to output  
     (2) conversion specifiers beginning with % and ending with a  
         character specifying the type of conversion -- specify  
	 how to convert an OBJ into characters for output  
     The conversion specifier is of the form %FW.PSC, where:  
     F is zero or more optional flags:  
       - left justify in field width  
       + signed conversion will begin with either + or -  
         (space) signed conversion  will begin with either space or -  
       # alternate form (see description of each type below)  
       0 pad field width with leading 0s instead of leading spaces  
     W is either a decimal integer specifying the minimum field width  
       (padded as specified by flags), or not present to use the  
       minimum number of characters required.  
     .P is either a decimal integer specifying the precision of the  
       result, or not present to get the default.  For integers, this  
       is the number of digits to be printed (possibly forcing leading  
       zeroes), and defaults to 1.  For reals, this is the number of  
       digits after the decimal point, and defaults to 6.  For strings,  
       this is the maximum number of characters to print, and defaults  
       to infinity.  
     S is either one of the characters 'h', 'l', or 'L', or not  
       present.  Yorick allows this for compatibility with the C  
       library functions, but ignores it.  
     C is a character specifying the type of conversion:  
       d, i  - decimal integer  
       o     - octal integer (# forces leading 0)  
       u     - unsigned decimal integer (same as d for Yorick)  
       x, X            - hex integer (# forces leading 0x)  
       f     - floating point real in fixed point notation  
               (# forces decimal)  
       e, E  - floating point real in scientific notation  
       g, G  - floating point real in fixed or scientific notation  
               depending on the value converted (# forces decimal)  
       s   - string of ASCII characters  
       c   - integer printed as corresponding ASCII character  
       p   - pointer  
       %   - the ordinary % character; complete conversion  
             specification must be "%%"  
     The write function is modeled on the ANSI standard C library  
     fprintf and sprintf functions, but differs in several respects:  
       (1) Yorick's write cannot handle the %n conversion specifier  
           in FSTRING.  
       (2) Yorick's write may insert additional newlines if the OBJ  
           are arrays, to avoid extremely long output lines.  

builtin function, documented at i0/std.i   line 1373  
SEE ALSO: print,   exit,   error,   read,   rdline,   open,  
close,   save,   restore  
 
 
 
write_flat


 write_flat  
 
  

interpreted function, defined at i/testb.i   line 402  
 
 
 
write_hist


 write_hist  
 
  

interpreted function, defined at i/testb.i   line 317  
 
 
 
write_ptrs


 write_ptrs  
 
  

interpreted function, defined at i/testb.i   line 557  
 
 
 
write_style


             write_style, file, landscape, systems, legends, clegends  
 
     write a Gist style sheet (.gs file), using the data structures  
     as described in the get_style function.  The FILE can be a  
     filename or a text file stream.  

interpreted function, defined at i/style.i   line 97  
SEE ALSO: get_style,   set_style,   read_style