190550 63 15 9101027 911 811 7 7 8 7 8 9 8 611 7 9 10 8 9 8 6 6 6 6 610 51212 6 711 9 8 8 7 7 7 8 6 7 6 6 6 8 6 614 715 810 7 8 718 7 811 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 This is a list of one-line descriptions of all commands, ordered by topics. The reference numbers of the topics correspond to the sections of the manual devoted to them. 4.5 Commands to Control the Display ACCENT mark derivative with asterisks TOGGLE k -1<0 deactiv. D2CHDIR read 2nd component of dir. of inv. D2 D><0;1 deactiv. D3CHDIR read 3rd component of dir. of inv. D3 D><0;1 deactiv. IDIRCTN read the direction of investigation D D><0 deactiv. LDRCTN load a new direction of investigation kd 3 deactiv NORMAL turn normalization of D on/off TOGGLE --- --- deactiv. RDIRCTN read channel number for direction list nc --- --- ROTATE change direction of investigation DD D><0 deactiv. 4.8 Commands to Control Accuracy, the Window, and Round-Off Effects CWINDOW change window width by factor SIGN m m=0 immediate DIVIDE divide h by integer m SIGN m d><0 immediate DOUBLE double h --- --- immediate HALVE halve h --- --- immediate IHVALUE read value of h h h>0 deactiv. MULTPLY multiply h by factor m SIGN m m><0 immediate ZOOM enlarge central portion of displ. SIGN m m><0 immediate 4.9 Commands to Control Execution EXIT return to calling program --- --- deactiv. FORCE recompute everything --- --- activ GO compute whatever is needed --- --- activ QUIT terminate MICROSCOPE session --- --- --- RESTART reestablish earlier parameter settings --- --- --- SETDF reset defaults --- --- deactiv. STORE store current parameter settings --- --- --- UNDO undo previous parameter changes --- --- --- WAIT make program wait for GO or FORCE com. --- --- deactiv. 4.10 Commands to Obtain On-Line Help HELP obtain detailed help on command cmd cmd ;2 --- HSUMRY obtain a summary of all commands --- --- --- LIST print all currently available commands --- --- --- NEWS print the news --- --- --- 4.11 Commands to Keep a Record LOG give channel number for logging nc --- --- OUTPUT write screen immage on recording device --- --- --- TNOTE take a note on recording device text --- --- 4.12 Commands to Analyze Cross Derivatives C1CROSS read 1st component of cross direction C1 C><0 deactiv. C2CROSS read 2nd component of cross direction C2 C><0;1 deactiv. C3CROSS read 3rd component of cross direction C3 C><0;1 deactiv. CDIRCTN read direction of cross direction C C><0 deactiv. CHVALUE read ch for cross differentiation ch 5 deactiv. CORDER read order of cross derivative k -1< means "not equal"). No entry means that no check is made for errors. If there is insufficient room for listing them, then reference numbers of errors are separated by a semi-colon. The following is a key to the reference numbers: 1. Components to be changed must not have an index that is greater than the current dimension. 2. The command must be a valid MICROSCOPE command. If it is not recognized you will be prompted for another command to be helped on. Typing any valid command will get you some information on it and will then return you to command mode. 3. The list must contain only points in a legal format. If illegal characters are encountered, an error termination of the command will occur. Also, the index number must not exceed the number of points in the list. If it does, the program will reach the end of the file containing the list, and the precise action after that depends upon the computing system. -- Screen -- activ the command activates the screen deactiv. the command deactivates the screen - i.e. the GO or FORCE command must be given before the computation proceeds. For some commands, there is a check if the newly input datum is identical with the old one, in which case the screen remains active. immediate If the screen is active then the effects of the command are incorporated before the next command is requested pending If the screen is inactive, this command will keep the graphical display on the screen, even if computations are pending. --- The graphical and numerical display, and the screen status are not changed. Notice, however, that the actual screen display may be destroyed by error messages or help information. The next display changing command (or RSCREEN) will then refresh the screen. ACCENT mark derivative with asterisks TOGGLE k -1<0 deactiv. This command replaces the first component of the cross direction with the number read from the input device, leaving the other components unchanged. This is useful for correcting errors. If cross differentiation is currently inactive, it is activated by C1CROSS, and its order is set to 1 by default. For more information see section 4.12 of the manual. C2CROSS read 2nd component of cross direction C2 C><0;1 deactiv. This command replaces the second component of the cross direction with the number read from the input device, leaving the other components unchanged. This is useful for correcting errors. If cross differentiation is currently inactive, it is activated by C2CROSS, and its order is set to 1 by default. If the current dimension is 1 an error will result. For more information see section 4.12 of the manual. C3CROSS read 3rd component of cross direction C3 C><0;1 deactiv. This command replaces the third component of the cross direction with the number read from the input device, leaving the other components unchanged. This is useful for correcting errors. If cross differentiation is currently inactive, it is activated by C3CROSS, and its order is set to 1 by default. If the current dimension is 1 or 2 an error will result. For more information see section 4.12 of the manual. CCHANNL change channel number ic,nc 4 --- This command is used to change those channel numbers that are input parameters of the routine MCRSCP. The first parameter describes the channel to be changed, the second is the new channel number. The channel types are: 1. Input Device 2. Output Device 3. Graphics Device 4. Recording Device 5. Restart Device The logging device and the three point loading devices can be changed by using the commands LOG, RCROSS, RPOINT, or RDIRCTN. The current channel numbers can be viewed in the last line of the numerical display, in the sequence: 1. Input Device, 2. Output Device, 3. Graphics Device, 4. Help Device, 5. Recording Device, 6. Restart Device, 7. Logging Device, 8. Point Loading Device, 9. Direction Loading Device, 10. Cross Direction Loading Device. The Help Device number cannot be changed, and you should take care not to overwrite the help file. For more information see section 4.13 of the manual. CDIRCTN read direction of cross direction C C><0 deactiv. This command reads the new cross direction from the input device. If cross differentiation is currently inactive, then it is activated, its order is set to 1 by default, and the value of the cross differentiation parameter is set equal to the current value of the discretization parameter h. A zero cross direction will result in an error. For more information see section 4.12 of the manual. CHVALUE read ch for cross differentiation ch 5 deactiv. This command reads the new value of the cross differentiation parameter ch from the input device. If cross differentiation is activated by setting the cross direction it is unneccessary to give this command as ch is set automatically to the value of the current discretization parameter h. Future changes of h have no impact on ch to maintain efficiency. The CHVALUE command is the only one allowing to change the value of ch while cross differentiation is active. For more information see section 4.12 of the manual. CORDER read order of cross derivative k -1<0 deactiv. This command reads the new first component of the direction of investigation, leaving the others fixed. This is useful for error corrections. For more information see section 4.7 of the manual. D2CHDIR read 2nd component of dir. of inv. D2 D><0;1 deactiv. This command reads the new second component of the direction of investigation, leaving the others fixed. This is useful for error corrections. If the current dimension is 1 then an error will result. For more information see section 4.7 of the manual. D3CHDIR read 3rd component of dir. of inv. D3 D><0;1 deactiv. This command reads the new third component of the direction of investigation, leaving the others fixed. This is useful for error corrections. If the current dimension is 1 or 2then an error will result. For more information see section 4.7 of the manual. DCENTER draw center of graph. display TOGGLE --- --- immediate This command turns the center mark (a plus sign in the center of the graphical display or a horizontal line in the PLOT79 display) on or off. It is off by default. For more information see section 4.5 of the manual. DGRAPH draw graph k -1<0 immediate This command divides the current value of the discretization parameter h by the specified positive integer factor, leaving the window width fixed. If the factor is negative, then h is multiplied rather than divided. The division is most efficient if the factor is a power of 2. For more information see section 4.8 of the manual. DMNSN read dimension v of domain v 0<0 deactiv. This command reads the new direction of investigation from the input device. The direction must be non-zero. For more information see section 4.7 of the manual. IHVALUE read value of h h h>0 deactiv. This command reads the new value of the discretization parameter h from the input device. There are several other ways to modify h. For more information see section 4.8 of the manual. IINTVL read endpoints of line of investig. A,B A><0 immediate This command multiplies the current value of the discretization parameter h by the specified positive integer factor, leaving the window width fixed. If the factor is negative, then h is divided rather than multiplied. The multiplication is most efficient if the factor is a power of 2. For more information see section 4.8 of the manual. NEWS print the news --- --- --- This commands prints any available news on the output device. The first line of the news is printed when MCRSCP is first entered. This facility may be used by your system manager to inform you of recent changes in MICROSCOPE or similar purposes. For more information see section 4.10 of the manual. NORMAL turn normalization of D on/off TOGGLE --- --- deactiv. MICROSCOPE computes either standard directional derivatives (the default) or unnormalized Gateaux derivatives which are sometimes useful in multivariate analysis. The NORMAL command switches between thes two options. For more information see section 4.7 of the manual. OUTPUT write screen immage on recording device --- --- --- This command can be used to write a copy of the current screen image on the recording device. This is useful for record keeping and can be augmented by notes or comments using the TNOTE command. For more information see section 4.11 of the manual. P1CHPNT read first component of P P1 --- deactiv. This command reads the new first component of the point of examination, leaving the others fixed. This is useful for error corrections. For more information see section 4.6 of the manual. P2CHPNT read second component of P P2 1 deactiv. This command reads the new second component of the point of examination, leaving the others fixed. This is useful for error corrections. If the current dimension is 1 then an error will result. For more information see section 4.6 of the manual. P3CHPNT read third component of P P3 1 deactiv. This command reads the new third component of the point of examination, leaving the others fixed. This is useful for error corrections. If the current dimension is 1 or 2 then an error will result. For more information see section 4.6 of the manual. PAUSE pause until RETURN from channel nc nc --- --- This command suspends computation until a dummy character is entered on the specified channel. This useful for demonstration purposes. For more information see section 4.13 of the manual. PLOT enter plotting mode --- --- --- If available, this commands enters the PLOT submode in which a PLOT79 version of the current alphanumerical display can be designed and executed. Various plot options can be set interactively. For more information see section 4.14 of the manual. QUIT terminate MICROSCOPE session --- --- --- This command terminates the MICROSCOPE session via a FORTAN STOP statement. For more information see section 4.9 of the manual. RCROSS read channel number for cross list nc --- --- This command reads the new channel number for the cross direction loading device. For more information see section 4.12 of the manual. RDIRCTN read channel number for direction list nc --- --- This command reads the new channel number for the direction loading device. For more information see section 4.7 of the manual. RESTART reestablish earlier parameter settings --- --- --- This command reads a set of parameter settings from the Restart device as they have been deposited there by the STORE command. This way computation may resume as it was left off at earlier point in the investigation. For more information see section 4.9 of the manual. ROTATE change direction of investigation DD D><0 deactiv. This command adds the given vector to the current direction of investigation. For more information see section 4.7 of the manual. RPOINT read channel number for point list nc --- --- This command reads the new channel number for the point loading device. For more information see section 4.6 of the manual. RSCREEN refresh screen --- --- pending This command has two applications: On an active screen, it refreshes the screen image, e.g. after it has been destroyed by a system message or by some MICROSCOPE HELP information. On an inactive screen, it prints the current state of the graphical and the numerical dispaly without doing any computations. In that case, the graphical and the numerical display may be inconsistent. This condition is indicated by the flag "GO pndng" in the numerical display. For more information see section 4.5 of the manual. RWIND rewind device nc nc --- --- This command rewinds the device with the given number. It can be used to read a sequence of commands for a second time or to overwrite information that was generated earlier and is no longer needed. For more information see section 4.13 of the manual. SETDF reset defaults --- --- deactiv. This command resets some of the original MICROSCOPE defaults. More precisely, its effects are as follows: -1- The screen is deactivated. -2- All previous function evaluations are discarded. -3- The window width 2h/s is set to 12. -4- Only the display function itself is flagged to be plotted. -5- Any current cross differentiation is turned off. -6- The discretization parameter h is set to 1.0d-4 -7- If the test package is loaded, its parameters are reset (N = 1, D = 10, ETA = 1, no exponential is added) For more information see section 4.9 of the manual. SHIFT shift point of examination is --- immediate This command shifts the current display by the given number of columns. A positive shift corresponds to a shift to the right. There is nor restriction on the number of columns, in particular it may exceed the number of columns in the display. For more information see section 4.6 of the manual. STORE store current parameter settings --- --- --- This command stores all current parameter settings on the Restart Device. Any subsequent STORE command will overwrite that information. So if several configurations of a session must be saved, then the Restart device must be assigned to a different file for each configuration. This can be accomplished either by the commands CCHANNL or USER. For more information see section 4.9 of the manual. TCENTER type value of k-th derivative at center k -1<0 immediate This command multiplies the current window width with the specified factor if is positive, and divides by its absolute value if it is negative. This is accomplished by adjusting the display interval and leaving the discretization parameter h fixed. This is useful if h cannot be decreased because of round-off effects. However, whenever possible the more efficent command CWINDOW should be used instead of ZOOM. For more information see section 4.8 of the manual. ACCENT input which derivative is to be accented C1CROSS input new first component C2CROSS input new second component C3CROSS input new third component CCHANNL input type and new channel number CDIRCTN input direction of cross derivative CHVALUE input new stencil width CORDER input new order, 0 to turn off cross derivative CWINDOW input factor (positive for increase, negative for decrease) D1CHDIR input new first component D2CHDIR input new second component D3CHDIR input new third component DCENTER no arguments DGRAPH input which derivative (0 thru 6) DIVIDE input integer factor DMNSN input the dimension of the domain (1 thru 3) DOUBLE no arguments DSCALE no arguments DXAXIS no arguments EGRAPH input which derivative (0 thru 6) is to be erased EXIT no arguments FLIP no arguments FORCE no arguments GO no arguments HALVE no arguments HELP give name of command you want help on HSUMRY no arguments IDIRCTN input direction of investigation IHVALUE input discretization parameter IINTVL 2 vectors, 1 per line IPOINT input vector LCROSS give index number of new cross direction LDRCTN give index number of new direction LIST no arguments LOG give new channel number, zero to turn off log LPOINT give index number of new point MULTPLY input integer factor NORMAL no arguments NEWS no arguments OUTPUT no arguments P1CHPNT give new first component P2CHPNT give new second component P3CHPNT give new third component PAUSE give channel number PLOT no arguments QUIT no arguments RCROSS give new channel number RDIRCTN give new channel number RESTART no arguments ROTATE input vector to be added to current direction of investigation RPNT give new channel number RSCREEN no arguments RWIND give device number SETDF no arguments SHIFT input integer shift (+ve for right shift, -ve for left shift) STORE no arguments TCENTER give order of derivative TNOTE no arguments TYPE give order of derivative and location of point UNDO no arguments USER no arguments WAIT no arguments ZOOM input factor (positive for increase, negative for decrease) 93 MICROSCOPE News v. 1: A Primer on MICROSCOPE Welcome to MICROSCOPE. If at any stage you are getting tired of this summary you can abort it by typing a period (followed, like everything else in MICROSCOPE by a carriage return, see below). It is assumed that you know what you want to use MICROSCOPE for and that you only need to know how to go about it. To make full use of MICROSCOPE you really should obtain a copy of the manual which is distributed with the MICROSCOPE package and should be available from your system manager. If for some reason you can't get a hold of one, contact Peter Alfeld, Department of Mathematics, University of Utah, Salt Lake City, Utah 84112, Tel. 801-581-6842. I'd also be glad to hear of your comments or suggestions. The following is an excerpt from section 3.2 of the manual. It describes the structure of the interaction with MICROSCOPE: 3.2 The Command Mode The MICROSCOPE prompt is of the form: n >> where n is the number of the command to be given. It starts at 1 and is incremented by 1 after each command. A MICROSCOPE command is a string of at least two letters and digits. However, only the first two characters are significant and recognized by the parser. They must be entered in the first two columns immediately following the prompt. On an active screen, this will be in the same line as the prompt, on an inactive screen, or in the scrolling version, on the next line. Blank spaces are significant. (MICROSCOPE simply reads the command using a 2A1 format.) The remaining columns can be filled with arbitrary characters. They are not read or processed by MICROSCOPE. This is sometimes useful for including comments in a program. A command line is terminated by pressing the RETURN button. If the command is not recognized, MICROSCOPE prompts for another one. After a command you will be prompted for the appropriate data (if any are needed). The prompt is specific to the commands. The dimension of the vectors is identical to the number of variables of the trial function. (The default is 2, see section 4.18 for a listing of all defaults). Numbers are processed by an internal parser and are essentially format free. The following distinctions and restrictions apply, however: - Blanks are ignored. For example "1 2" is considered the single integer 12. - Numbers on the same line must be separated by commas. - Numbers can also be separated by writing them on separate lines (omiting the comma). - If two vectors are requested, then the second vector must start on a new line . - When a single number (Integer or Real) is requested, then an empty string (obtained by just pushing the RETURN button) is considered to mean zero. This is particularly useful when a zero entry implies that a submode (see the descriptions of the PLOT and the USER commands in sections 4.14 and 4.15 respectively) is to be exited. - When two integers are requested, then either one or both can be represented by an empty string. (The only command for which this feature is useful is TYPE.) - Floating Point numbers (like 1.0E-12 or 1D-4) are processed correctly. - Floating Point numbers may also be represented as integers. After receiving the data, MICROSCOPE processes the command and the data. If the screen is active, then the command is carried out and the alphanumerical display is updated, otherwise the next command is prompted for. If a command is not recognized by MICROSCOPE, then a message will be printed to that effect and a new command will be prompted for. If data are requested, and a number is not recognized, then you will have a chance to correct your input. However, if data are syntactically correct, but otherwise meaningless (e.g. you request the graph of the 117th derivative), then the command will be aborted and a new command will be prompted for. There are currently 63 commands which divide into 11 major groups. You can obtain a listing of them by giving the command LIST, a brief description of all of them by HSUMRY, and detailed help on an individual command by HELP. Good luck, you are on your own now ...