Differences

This shows you the differences between two versions of the page.

--- jvs:fscan:manual:chapter2:run [2016/07/19 19:20]
voyvodic
+++ jvs:fscan:manual:chapter2:run [2023/02/23 18:43]
@@ Line 1: / Line 1: @@
-**fScan Reference Manual, Chapter 2 (CmdLineOptions): run**
-===== Run -- Execute a series of fScan interactive commands =====
-**usage:**\\
- %%-run mode [flag] string%%\\
- %%-run%%\\
- %%:%%
-===== =====
-With no arguments, this command just forces everything before it in the command line to be processed before processing other options. A colon (surrounded by blank space) is a shorthand equivalent to the **-run** command with no arguments. It simply forces execution of all command options preceding it.
-With arguments, this loads interactive command strings.
-MODE:
-  * 1 - interpret STR as a sequence of interactive commands (default). This sets [[jvs:fscan:manual:chapter4:peekstr|peekstr]] to STR.
-  * 2 - run contents of file STR as a sequence of interactive commands
-  * 3 - STR is the name of a menu; ITEM is the number of an item within that menu (1=first). If STRING="funckey", ITEM is Funckey number. The menu item is run as though it had been selected interactively. Multiple pairs of [MENUNAME ITEM] can be combined in the same '-run 3' command.
-  * 4 - set contents of file STR to run when fScan terminates (sets [[jvs:fscan:manual:chapter4:quitstr|quitstr]])
-  * 5 - run STR as an EXEC command (same as interactive cmd: 'STR',flag E)
-  * 6 - run contents of file STR as a sequence of fScan command-line commands
-  * 7 - run STR as a sequence of fScan command-line commands
-Examples:
-<code>
-  fscan infile -e + 100   -e x 4 -D           # add and multiply together (one result window)
-  fscan infile -e + 100 : -e x 4 -D           # add and multiply separately (show both results)
-  fscan infile -run "3C4d" -D                 # load data, switch to 3-plane view and reduce intensity
-  fscan infile -run 2 myview -D               # load data and run interactive commands in file "myview"
-  fscan infile -run 3 display 3 -D            # load data and run icon 3 from taskbar 'Display'
-  fscan -run 5 run_fslmc infile 9 -v 0        # run the shell script as: "csh run_fslmc INFILE 9"
-</code>
-**Note:**\\
-RUN is a command-line command designed for running sequences of interactive fScan commands.\\
-[[jvs:fscan:manual:chapter2:options|OPTIONS]] is a command-line command designed for running sequences of command-line commands.\\
-The '[[jvs:fscan:manual:chapter3:winkeys:go|G]]' interactive command is designed to run sequences of command-line commands interactively.\\
-Combining and embedding RUN, OPTIONS, and 'G' commands provides a lot of programming flexibility, but can be a bit confusing.\\
-When in doubt, insert ':' (or '-run') into command-line sequences to group sub-sequences into separate processing stages.
-**See Also:**\\
-[[jvs:fscan:manual:chapter3:winkeys:exec|EXEC]],
-[[jvs:fscan:manual:chapter2:options|OPTIONS]],
-[[jvs:fscan:manual:chapter3:winkeys:go|GO]]
-[[jvs:fscan|fScan Home]],
-[[jvs:fscan:manual|fScan Manual]],
-[[jvs:fscan:manual:chapter2|CmdLineOptions]],
-[[jvs:fscan:manual:help|Manual Help]]

Brain Imaging & Analysis Center

User Tools

Site Tools

Differences

Page Tools