HOME GUIDE OPERATIONS DOCS FAQ TECHNIQUES FORMATS INSTALL NEW TIPS WEB LINKS WADSWORTH

FR - Read (sets) a local symbolic parameter (string variable)

(10/02/07)

PURPOSE

Associates a file name template or any other alphanumeric string with a string variable (symbolic parameter). This operation should only be called from inside a procedure. The string variable is specified inside the procedure. The associated value is read from the input stream which may be either an interactive SPIDER run or a higher level procedure.

SEE ALSO

FR L [Read (sets) a local symbolic parameter (string variable)]
FR G [Read (sets) a global symbolic parameter (string variable)]
FR F [Read (sets) global symbolic parameter (string variable) from a file]
RR [Read Register variables]

USAGE

.OPERATION: FR
[Operation given in a SPIDER procedure.]

.PROMPT & VARIABLE NAME: ?prompt? [name]
[Enter prompt string to be printed when procedure is called from an interactive session and name for this variable.]

[Upon procedure execution, prompt string is printed on terminal or in results file:]

.prompt: PIC{***[num]}
[Enter value to be associated with this variable. Any alphanumeric string such as a filename is allowed. If the value contains another variable or a register, then these components are evaluated in the procedure where they are specified (before being passed into the caller).]

1. Example.
If the following lines are contained inside a SPIDER procedure:

FR
?NERVE AXON FILE TEMPLATE? [temp]

DO I=4,6 FS [temp] ENDDO

CP [temp]004 [temp]_jnk EN

When procedure is invoked from an interactive SPIDER session the following prompt appears:
?NERVE AXON FILE TEMPLATE? [temp] nerve

When do-loop executes, operation sequence is :

FS nerve004 FS nerve005 FS nerve006

Following do-loop execution, operation sequence is :
CP nerve004 nerve_jnk

2. Variable names can consist of any string. Prior to 2002 they were restricted to numbers in this operation.

SUBROUTINES

DRIV1, SYMPAR, RDPRMC

CALLER

DRIV1

© Copyright Notice /       Enquiries: spider@wadsworth.org

BACK TO SPIDER BACK TO WADSWORTH