CHAPTER FIVE - EDITORS
Editors are an important part of SNAP. Editors enable the user to easily enter, change, load, store, and view data. Editing functions have been programmed into the special function keys F1-F10 and ALT F1 - ALT F10 and certain keys on the number pad.
SF Keys
The definitions for the special function keys F1 through F10 are listed with each menu in Chapter Three. Some of these keys are not defined in each editor. Others do not share the same definition. See Chapter Three for the definitions for a particular editor.
ALT SF Keys
The editors in SNAP use a common set of ALT SF key definitions and are discussed below. These keys are only in effect while you ARE NOT entering a value into a cell. For instance, if you are in the middle of entering 55.23 into a cell, you cannot decide to sort the file without completing your input and pressing ENTER, then you may press the SORT special function key. The key definitions are as follows:
FIND
To search a column for a value, press the FIND key (ALT F1 and enter the value to search for in the pop-up window. SNAP will start searching at the next line below the current cursor location and probe for the next line at which the value appears. To search for a blank cell, just press ENTER without entering anything. The code value for a blank cell is usually -987, unless you are located on an alphanumeric column, in which case it is the null string. To clear an entry in the search box use the TAB key.
REPLACE (not yet available)
To replace all occurrences of a value in the current column (on or below the cursor location), press the REPLACE key (ALT F2) and enter the value to search for and the replacement value and press ENTER. To search for or replace with a blank cell, just press ENTER without entering anything. To clear an entry in the search box use the TAB key.
JUMP (not yet available)
To jump to a specific line number in the editor, press the JUMP key (ALT F3) and enter the line number. The editor will try to center the screen around the line that you specify.
SORT
To sort a column, move the cursor to the column you want to sort and press SORT (ALT F4). The cursor can be anywhere in the column. After pressing SORT, specify the manner in which you want the data sorted; you have two options: ascending order or descending order. Both strings and numbers can be sorted.
COPY
To make a copy one or more existing lines in an editor, move the cursor to the location where you want to insert the copied lines and press COPY (ALT F5) to access the pop-up window. Enter the beginning and ending line to be copied. The lines will be copied and inserted beginning at the cursor location. A maximum of 100 lines can be copied at a time.
ADD (not yet available)
To add a constant to a range of data in a column, put the cursor in the column to be modified and press the ADD key (ALT F6) to access the the pop-up window. Enter the beginning and ending line of the range and the value to be added to each element within the range and press ENTER.
MULTIPLY (not yet available)
To multiply a constant to a range of data in a column, put the cursor in the column to be modified and press the MULT key (ALT F7) to access the the pop-up window. Enter the beginning and ending line of the range and the value to be multiplied to each element within the range and press ENTER.
LAST
To move to the last entry with data, press the LAST key (ALT F8). Since the LAST option must scan the entire file for the ending position, this option may take a few seconds. Be patient and only press the key once. An entry is marked as used if the major components of the entry are present (i.e. 'from node', 'to node', or 'unit name' are all major components).
FILL
To fill a range with a number or string, press the FILL key (ALT F9). This accesses a pop-up screen. Enter the beginning and ending line for the range and the number or string which is to be put into each cell within the range.
HELP
To access information describing the operation and definitions of the editor you are in press ALT F10.
Other Editing Commands
UP ARROW - Moves the cursor up one line.
DOWN ARROW - Moves the cursor down one line.
LEFT ARROW - Moves the cursor one column left.
RIGHT ARROW - Moves the cursor one column right.
SHIFT + UP ARROW - Jumps to the top of the editor, (lines 1 through 20).
SHIFT + DOWN ARROW - Jumps to the bottom of the editor. This allows you to find the maximum number of data lines that the editor can handle.
INS LN - Inserts a blank data line at the current cursor position.
DEL LN - Deletes the current line highlighted by the cursor. A blank line will by added to the bottom of the editor.
ENTER - Allows you to edit the data highlighted by the cursor.
SPACEBAR - Toggles to the status (visibility) of the current line. If an asterisk is present, the line will be considered during the analysis, if not, it won't be.
TAB - Changes the current cell, highlighted by the cursor, to 'blank cell' status.
Making Data Lines Invisible (Asterisks)
Asterisks are an editing feature which can be used to make lines of data invisible without having to destroy the data. If you remove the asterisks, the data line is invisible. They are used in many of the editors. Removing asterisks can be used to hardwire a solution. It is preferable to remove the asterisks rather than enter large values to make sales or links unattractive. An asterisk is removed by pressing the space bar at the desired location. A blue line will appear indicating the data on that line is invisible. To make the data visible, press the space bar again.
Use the asterisk option to make certain harvesting system choices invisible. Never try to hardwire a harvesting system choice in the SALE Editor by assigning a status of "0" to some harvesting systems and a non-zero status to other harvesting system choices for the same unit. All harvesting system choices in the Sale Editor for a specific unit must have the same status.
Leaving an Editor
SNAP is designed to save your data as you leave any editor. The SAVE procedure can be invoked in one of three ways.
(1) You can use the F4 special function key. If you use this option you will be given the opportunity to either save or not save your changes and to choose to update the current file or save under a new file name. After saving you are still in the editor.
(2) You can use the Esc key. If you use this option you will be given the
opportunity to either save or not save your changes and to choose to update the current file or save under a new file name. After saving or not saving you will return to the Main Menu.
(3) You can use the F10 special function key. This is a short cut key for experienced users. It automatically saves your data to the current file name and returns you to the Main Menu. If you do not want to save your changes, DO NOT USE THIS KEY.
DOS SHELL
SNAP III can shell to DOS by pressing Alt S at the Main Menu or within any Snap editor.