Next: length()
Up: MacAnova Help File
Previous: labels
Contents
Usage:
Unix/Linux and DOS: macanova [-q] [File Options] [Screen Options]
at Unix/Linux or DOS prompt
Macintosh: Double click on MacAnova icon or MacAnova file icon
Windows: Double click on MacAnova for Windows icon
|
Keywords:
general, files
Nonwindowed versions
For non-windowed versions (Unix/Linux or DOS), type 'macanova' at the
Unix/Linux or DOS prompt. If the MacAnova directory is not in the
search path, you will need to specify the complete path. See below for
command line options.
For non-windowed versions, you may also use "redirected" input and
output to run an entire analysis noninteractively and save the output.
macanova [options] < cmdFile > outputFile
will read commands from cmdFile and save the results in outputFile.
Microsoft Windows Version
If MacAnova is installed correctly under Windows 95/98/NT/XP there is
a MacAnova entry on the Start menu, with subentries for all installed
versions and possibly for browser based help files. All versions can
also be launched from the DOS prompt.
In addition, the installer should also register the extentions
.mvbat, .mvsave, and .mvout for MacAnova batch files, save (workspace)
files, and output files. Double clicking any file with one of those
extensions should start MacAnova, execute the batch file, restore
the save file, and/or open the output file.
Finally, you may drag and drop save, batch, and output files onto the
MacAnova for Windows icon.
See also topic 'dos_windows', 'carapace'.
Linux GTK
Assuming the Carapace GTK version has been named macanovacpc and is
in a directory in your search path, type
macanovacpc [-q] [File Options] [Path Options] [Screen Options]
at the Unix/Linux prompt, where items in [...] are options. See below
for details on command line options.
See also topics 'unix', 'carapace'.
Macintosh Mac OS X
Double click the MacAnova icon. In addition, the Finder should also
recognize files with extensions .mvbat, .mvsave, and .mvout (files
with creator mat2 and types TeXT, S000, and TeXT) as MacAnova batch
files, save (workspace) files, and output files. Double clicking
any file of those types should start MacAnova, execute the batch
file, restore the save file, and/or open the output file. You can,
in fact, shift click on more than one such file and then choose Open
from the Finder File menu to do more than one operation.
It is possible, though rather awkward, to launch MacAnova from
a Terminal window. Change into the directory where MacAnova is
located; it will show up as MacAnova.app. Then change into the
MacAnova.app directory, and the Contents directory within that,
and the MacOS directory within that. There you should find
macanovacpc, which is the actual executable. Typing ./macanovacpc
will start MacAnova. In this fashion you may also use command
line options.
See also topic 'macintosh'.
Command line options
The windowed versions of MacAnova have a greater array of command
line options than the nonwindowed versions. However, most casual
users will never need these options, particularly for windowed
versions.
The following tables give an option, whether it is usable in
windowed (W) or nonwindowed (N) versions, and its use. There will
be a 1 in the W or N column if an option can be used exactly once,
and an asterisk if the option can be used multiple times (up to 50).
File related options
Option W N Use
-restore filename 1 1 execute restore("filename") at startup
-batch filename * 1 execute batch("filename") at startup
-f startfile * 1 execute batch("startfile") silently
-help helpfile 1 1 use helpfile as the default help file
-macro filename * 1 add filename to variable MACROFILES
-open filename * open filename in a command window
-data filename * 1 add filename to DATAFILES
-addhelp filename * add filename to HELPFILES
-config filename 1 use filename as the Carapace preference file
Path related options
Option W N Use
-home pathname 1 1 set variable HOME to pathname
-appdir pathname 1 set MacAnova root directory to pathname
-path pathname * add pathname to DATAPATHS
-dpath pathname 1 add pathname to DATAPATHS
-mpath pathname 1 add pathname to DATAPATHS
Other options
Option W N Use
-q 1 1 suppress banner at startup
-prompt string 1 1 set the MacAnova prompt to string
-bprompt string 1 1 set the batch prompt to string (for -batch)
-e expression 1 1 execute expression at startup
-eq expression 1 execute expression and then quit
-l lines 1 1 set page height to l lines
-w columns 1 1 set page width to w columns
-hist count 1 1 set history length to count items
Option details
-restore saveFile
The equivalent of 'restore("saveFile")' is executed at startup and
MacAnova.ini.txt is not read and executed. See 'customize', restore().
-batch batchFile
The equivalent of 'batch("batchFile")' is executed after
initialization.
-f initFile
File initFile is executed silently as a batch file at startup instead
of file MacAnova.ini.txt (see 'customize').
-help helpFile
Help information will be taken from file helpFile rather than the
default help file MacAnova.hlp.txt.
-macro macroFile
"macroFile" will be added to the beginning of Pre-defined CHARACTER
variable MACROFILES. This will mean that pre-defined macro
getmacros() will search the file before the standard macro files. You
can accomplish the same thing after starting MacAnova by
addmacrofile("macroFile"). See topics getmacros() and addmacrofile().
-open windowFile
Load the contents of windowFile into a command-output window, as if
Open were selected on the File menu. No startup message printed.
-data dataFile
"dataFile" will be added to the beginning of pre-defined CHARACTER
variable DATAFILES. DATAFILES is used by pre-defined macro
getdata() to make it easy to read data from a standard file. See
topic getdata().
-addhelp helpFile
"helpFile" will be added to the beginning of pre-defined CHARACTER
variable HELPFILES. Files in HELPFILES are searched when using the
command help(). See topic help().
-config configFile
Use configFile instead of the default file MacAnova.config. Some
aspects of MacAnova (fonts, window sizes, etc) can be controlled
through the configuration file.
-home homePath
Predefined CHARACTER variables HOME will have "homePath" as value
instead of a default value. HOME is used to expand file names of the
form "~/filename". For instance, when HOME is "dataDir", "~/filename"
is expanded to "dataDir/fileName". See topic 'files'.
-appdir appPath
By default, the last element of DATAPATHS is the directory where
MacAnova is located. You may override that value by using -appdir.
This is really only useful on Unix/Linux, because the location of
MacAnova cannot be determined at execution time and a default value
must be used instead. Here you can override the default.
-path pathName (or -dpath dataPath or -mpath macroPath)
Add pathName to the front of the CHARACTER vector DATAPATHS, which
contains a set of directories that are searched when you attempt to
read a file (for example, by using vecread(), read(), matread() or
macroread()). If the file cannot be found in the default directory,
MacAnova searches in the directories in DATAPATHS. See topic
DATAPATHS.
If -q is present, the startup message will not be printed and the
welcome screen is not shown.
-e Expr
Execute the MacAnova command in Expr as if it were the contents of
a batch file. Expr will be executed before anything else is done.
-eq Expr
Execute the MacAnova command in Expr as if it were the contents of
a batch file and then immediately quit. Expr will be executed
before anything else is done. This option does not make sense
for windowed versions.
-prompt Prompt
Sets the non-batch command line prompt. Usually Prompt should end
with a space, for example, -prompt "Next? ". This becomes the default
prompt that will be set by setoptions(default:T). See topics
setoptions(), 'options'.
-bprompt Prompt
Sets a prompt to be used with echoed commands in batch files
specified on the command line (-batch batchFile). Usually Prompt
should end with a space, for example, -bprompt "HW 1> "..
-l Nlines
This pre-defines option 'height' to be Nlines, where Nlines is either
0 or an integer at least 5. On windowed versions, this only controls
the height of "dumb" plots. See subtopic 'options:"height"'.
-w Ncols
This pre-defines option 'width' to be Ncols, where Ncols is an integer
at least 20. On windowed versions, this only controls the width of
"dumb" plots. See subtopic 'options:"width"'.
-hist Nhist
This pre-defines option 'history' to be Nhist, an integer >= 0. This
limits the number of previous command lines that can be saved and
recalled to Nhist. The default value is 100. See subtopic
'options:"history".
See also topics 'quitting', 'customize'.
Gary Oehlert
2005-08-12