Differences

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

--- jvs:fscan:manual:chapter2:run [2011/08/02 18:33]
voyvodic
+++ jvs:fscan:manual:chapter2:run [2023/02/23 18:43] (current)
@@ Line 1: / Line 1: @@
 **fScan Reference Manual, Chapter 2 (CmdLineOptions): run**
-===== Run -- =====
+===== Run -- Execute a series of fScan interactive commands =====
-**usage: -run flag string**
+**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.
+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.
-FLAG:
+MODE:
-  * 1 - set [[jvs:fscan:manual:chapter4:peekstr|peekstr]] to STR (default)
+  * 1 - interpret STRING as a sequence of interactive commands (default). This sets [[jvs:fscan:manual:chapter4:peekstr|peekstr]] to STRING.
-  * 2 - run file STR
+  * 2 - run contents of file STRING as a sequence of interactive commands
-  * 3 - set [[jvs:fscan:manual:chapter4:quitstr|quitstr]] to STR
+  * 3 - STRING 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 - run file STR
+  * 4 - set contents of file STRING to run when fScan terminates (sets [[jvs:fscan:manual:chapter4:quitstr|quitstr]])
-  * 5 - run STR as synchronous fScan shell command
+  * 5 - run STRING and following arguments as an [[jvs:fscan:manual:chapter3:winkeys:exec|EXEC]] command (like interactive cmd: 'STRING',flag E)
+  * 6 - run contents of file STRING as a sequence of fScan command-line commands
+  * 7 - run STRING 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:chapter3:winkeys:exec|EXEC]],
+[[jvs:fscan:manual:chapter2:options|OPTIONS]],
+[[jvs:fscan:manual:chapter3:winkeys:go|GO]]
 [[jvs:fscan|fScan Home]],

Brain Imaging & Analysis Center

User Tools

Site Tools

Differences

Page Tools