The Logical Icons

These will be presented in increasing order of complexity.

This is identical to clicking the "enter 1,0" button or using -E. The real part is replaced by a binary representation of the screen and the imaginary part is set to zero.

 

When executed this will cause the chosen display mode to be displayed. Choose a mode! If it flashes by too fast use the "pause" icon afterward to slow things down. While running a script the result of most operations are not automatically flashed for you to see. It is usually just an annoyance. However, if you wish to see what has been placed on the screen buffer without replacing it with the contents of the big array, use the "show screen buffer." button.

This icon usually brings the document window to the front when displaying results. If you do not want that to happen, deselect the "Force Document window to front." button.

The "Set display maximum" is equivalent to the "set display maximum" button on the drawer. However in this window you have the option of filling the max value from a symbol variable, that is set elsewhere.

You have the option of placing a thumbnail of a display which will only change when the display icon associated with it is active. You can place the resulting little (or not so little) window wherever you wish by dragging it or entering coordinates in the boxes and then "placing" the window. The current coordinates appear above the "X" "Y" labels.

If you loose track of which window is which just click on the window while watching the script. The icon will be highlighted. You can also click on the display icon and, if there is a separate window associated with it, the window will be brought to the front.

 

This icon duplicates all of the functions of the "put into real" box of buttons in the main document window, including the icon at the top of this list.

The right hand side of the window duplicates some of the logical operations on the combine menu.

For example "big array x binary file ..." on the "combine" menu is replaced in a script by first loading a binary file onto the screen and then using the "one/zero mode" option in this window.

I rarely use this in a script, since the state of the screen is difficult to predict when single stepping through a script.

 

This icon when clicked will display the same window that the "Filter" button and file menu item display. You must load a data table as described in the Light Valve Compensation page of this manual. The filter will be applied to the current screen every time it is executed by the script. So you should make sure that the screen displays what you want to filter before execution gets to this icon. The Icon may be placed immediately after "Display icon".
An alternative and probably more useful way to use this icon to keep it out of the flow of execution of the script and just connect it to a "Display Content of The Big Array" icon. (above) Connecting this to the display icon with a red data connection causes the display icon to modify the display to reflect the affect of the filter. The separate window, if used, will also show the filtering. This window can be placed on a separate monitor or display device and the filtering used to compensate for the characteristics of a device.

 

This produces the same dialog as the Graph (3D) item on the Goodies menu produces. Once the dialog has been filled out the instructions in it will be carried out with each pass of the script. This dialog may (if you wish) stay visible on the screen.

 

This icon will require you to tell it what to clip to the pasteboard, or alternatively where to past what is already on the pasteboard.

The contents of the selected sells in the selected row are converted into text of the form exponent form, "1.0E-4" for example, and placed on the pasteboard as one column (or two if both the real and imaginary parts are chosen). This can be pasted into a spreadsheet program such as "Excel" or "AppleWorks". You can choose alternative destinations for the clip other than the pasteboard. You may choose to put the data on a (red) data connection line be be used by another of these copy-paste icons to paste or to the "LOOK UP fn" icon which will use the 2 column data for interpolation. The data can change frequently. You can also save the data to a file. The file could be used, for example, by the batch option of "Rescale" or "DIRECT" propagation.

The paste side of the window will paste a column of text data into the real part of the selected cells of a row. If more than one column of data is on the pasteboard the second column will be put into the imaginary part. You can paste data from a file or from a data connection as well.

The array will not be cleared before the paste. You probably need to clear it first.

 

This icon (which is more of an action icon) forces you to fill out the dialog at the left. Your choice determines if this is a copy or paste operation.

If it is a copy you need to decide if the copy is to the paste board or to a red data connection line which goes to another of these same icons where it will be pasted.

Also if it is a copy you must decide whether to clip just the screen or to clip the big array. A screen clip to the clipboard will be formatted for external pasting.

If you paste you must make appropriate selections for the paste operation which are consistent with what was clipped.

You may connect the data from one clip to several pastes or to many data lines.

See the "Intro. to Scripting" tutorial.

 

This icon's appearance changes depending upon the choices made above. So
Indicates that "copy from screen" has been chosen.
Indicates that "copy from big Array" has been chosen. You can fan out to many data lines from this.
An image will be put on the screen not the big array.
The big array will be replaced with data from a data connection or the clip board. (Paste Big Array)
Data will be added to the big array.
Data will be multiply (complex) the big array.

To move the center of the big array to a predetermined point use this icon. You just put it in the flow and perhaps connect it with a red data connection to another icon. If there is no red data connection to this icon, you will be shown a window and asked to specify the position to which the center will be moved. you can specify the numbers directly or by substitution for symbols.
The move is done with wrap-around at the edges.
Alternatively, if you have made a data connection to this icon from the following four icons you will not be shown a window. In the case of the Copy icon, or Truncate& icon a bitmap (not big array) will be fetched and then searched for the first non-zero pixel and the center moved to this point. This search starts at the upper left corner and continues row by row down the screen. A new map is fetched on each execution, so you can change it on each pass. If the data source is not a bitmap you will be told to fix the source icon so that it clips from the screen buffer to a data connection.
Peak FinderI have done something which may annoy you here. The Peak Finder just passes the location of the highest peak found to this icon but that point is moved TO the center rather than the center being moved to that point, as in all other cases. (This is usually what you want to do.)
Another alternative (but not very useful): A Dot icon can be placed anywhere in the script and be connected by a data line. The location of the dot will be fetched and used. The Dot icon does not (in this case) need to be in the flow of the script. If you wish the location of the dot to change during execution by using symbol values for the location the Dot icon must be in the flow of execution for this value to be calculated and entered into the dot icon. You should have the dot icon put the dot into the bitmap where it doesn't cause trouble. (much trouble)

 



This icon can be used to truncate the contents of the big array in much the same way as using the histogram window. You can truncate from either above or bellow. If truncating from above, the values in the big array above that value will be set equal to the set value. If you use a negative value to truncate the magnitude the results get strange.

Besides being able to truncate you can make a big array map to use as a mask. The mask may be either a 1-0 mask or a 1-1 mask (stored in the real part with zero in the imaginary part). You may also make a binary mask. These maps can be accessed by any Copy icon through a red data connection. To paste to the screen you must make a binary map. A binary mask can also be used by the slider icon(see just above)to move the big array about. The big array map may be pasted, multiplied or added. by the clip/paste icon.

Unless truncated the big array is unchanged by this icon. You can use several of these in a row to make maps from different levels.