(This document is best viewed in a monospaced font) M A C A N O V A 5.04 Release 1 August 18, 2005 An Interactive Program for Statistical Analysis and Matrix Algebra Copyright 2005, Gary W. Oehlert and Christopher Bingham This file is the installation guide for the MacAnova on Linux and is part of the distribution of MacAnova 5.04 for Linux. This document contains the following sections: Introduction Distribution conditions and information about documentation Which Platform Do You Want? Describes available platforms and their requirements What Files Do You Need? Lists the files you should download Downloading from the Web Describes procedure for downloading files Using the rpm installer Describes procedures for installing MacAnova after downloading files and the installer program from the Internet. What to Do After Installation Running MacAnova File listing What is in the installation files Introduction MacAnova is distributed under the terms of the GNU Public License, Version 2. See file Copying.txt distributed with MacAnova. The latest versions of MacAnova may be obtained over the Internet from its home page http://www.stat.umn.edu/macanova/ You can get documentation and source code there as well. See file Readme.linux.txt for information on documentation, starting MacAnova and features specific to Linux. Copying.txt and Readme.linux.txt are installed automatically with MacAnova in the SharedSupport directory. A standard MacAnova installation includes two program files (one for X11-GTK and one for xterm), various auxiliary help and macro files, all documentation in PDF format, and all help in html (browseable) format. Which Platform Do I Want? Most people will want to use MacAnova for Linux interactively (the windowed forms of MacAnova use the Carapace toolkit and are sometimes referred to as Carapace, cpc, or cp versions of MacAnova). People who want to work noninteractively or do production work may wish to use the command line/xterm version. The installer includes both versions. What Files Do You Need? MacAnova for Linux comes as a single rpm file. The rpm will have a name similar to macanova-5.04-2.i586.rpm, where the numbers reflect versioning (in the example, version 5.04 release 2). Downloading from the Web Start at the download page www.stat.umn.edu/macanova/downloadlinux.html. Right click on the link to download the rpm. You can save the rpm to any other convenient location on your hard disk. That's really all there is to it. Installing MacAnova At this stage you should have the rpm on your hard disk. The default installation puts files in /usr/lib/macanova and /usr/bin. To install there, you must be able to run with root privileges. The basic install command is sudo rpm -i macanova-5.04-2.i586.rpm This works if you are an authorized user listed in file /etc/sudoers. If not, you su to root and use command rpm -i macanova-5.04-2.i586.rpm If you do not have root privileges, or if you wish to put the MacAnova installation in a nonstandard location, you may do so via the --prefix option to rpm. For example, rpm -i --prefix /home/gary/downloads macanova.all-5.04-2.i586.rpm will put files in /home/gary/downloads/bin, /home/gary/downloads/lib and so on. In other words, the prefix will replace /usr in the path of the files that are loaded. The scripts should be set up to work properly if you relocate the package. If you want to remove MacAnova, use [sudo] rpm -e macanova-5.04-2 where the [sudo] may or may not be required. IMPORTANT NOTE: The Linux GTK executable was compiled using shared libraries. That means that it does not stand on its own, and will need to search for and find those libraries on your system before it can run. If you are missing one of the required libraries, you will need to install it. You can find the list of required libraries via the command ldd macanovacpc The list is discouragingly long, but does not contain anything esoteric: c/c++ (libgcc, libstdc++, libc, libm) system (libdl, libpthread, ld-liunx) Gnome (libgtk-x11, libatk, libgdk_pixbuf, libpangoxft, libpangox, libpango, libgobject, libgmodule, libgthread, libglib) X11 (libX11, libXrandr, libXi, libXext, libXft, libXrender) image (libpng, libjpeg, libtiff) xml (libexpat) compression (libz) fonts (libfontconfig, libfreetype) What to Do After Installation You don't need the rpm for running MacAnova. You can delete it or save it. In KDE or Gnome, you may start MacAnova by clicking its icon in the file explorer, or by adding MacAnova to your system menu lists. At a command line window (e.g., xterm), you can start GTK MacAnova with the command macanovacpc. You may need to preface it with the path if you have not installed MacAnova in the standard place. For example, ~/downloads/bin/macanovacpc if you put MacAnova into your downloads directory. Similarly, you may start the command line version of MacAnova with the command macanova. Again, you may need to preface the command with the full path. From an xterm, there are number of command line options you can use. For example, macanovacpc -q -data mydata.txt suppresses printing the startup "banner" (-q) and sets mydata.txt as the default data file used by macro getdata. In MacAnova, type help(launching) for details on such options. File Manifests Here are the files installed for MacAnova. We use PREFIX to be a shortcut for the prefix where MacAnova was installed; by default, PREFIX is /usr. Files in PREFIX/bin macanovacpc A one line shell script pointing to PREFIX/lib/macanovacpc including some command line options to establish search paths macanova A one line shell script pointing to PREFIX/lib/macanova including some command line options to establish search paths Files in PREFIX/lib/macanova macanovacpc Macanova for GTK program file macanova MacAnova (nonwindowed) program file Files in PREFIX/lib/macanova/SharedSupport MacAnova.hlp.txt MacAnova Help File Tser.hlp.txt Help for Macros in Tser.mac Design.hlp.txt Help for Macros in Design.mac Userfun.hlp.txt Help related to user functions Arima.mac.txt File of macros for time series analysis in the time domain and nonlinear regression Tser.mac.txt File of macros for time series analysis in the frequency domain and some plotting macros Graphics.mac.txt File of macros related to making graphs Gui.mac.txt File of macros related to the graphical interface Gui.dat.txt File of dialog definitions to the graphical interface MacAnova.mac.txt File of most pre-defined macros plus other miscellaneous macros Math.mac.txt File of mathematics related macros, including optimization, factoring and matrix decomposition Mulvar.mac.txt File of macros for multivariate analysis, including factor analysis and discriminant analysis Regress.mac.txt File of macros related to regression, including stepwise regression MacAnova.dat.txt Sample data file MacAnova.ini.txt Sample startup file Copying.txt File summarizing the form of copyright and giving conditions underwhich MacAnova may be copied Banner.gif A splash banner for MacAnova *.htm Four html files used in the About MacAnova dialog Install.linux.txt A copy of this file Readme.linux.txt Read Me file Files in PREFIX/lib/macanova/SharedSupport/afm *.afm 14 Adobe font metric files Files in PREFIX/lib/macanova/SharedSupport/docs/pdf Intro.pdf "An Introduction to MacAnova" man*.pdf Chapters of "The MacAnova User's Guide" reference.pdf "The MacAnova Reference Manual" Files in PREFIX/lib/macanova/SharedSupport/docs/html *.htm More than 700 html files with hyperlinked help. Start with index.htm or Contents.htm Files in PREFIX/lib/macanova/SharedSupport/userfun userfun.h C header file for writing user functions dynload.h C header file for writing user functions goo.c Sample user function C source foo.c Sample user function C source fooeval.c Sample user function C source foosym.c Sample user function C source Happy Computing! Gary W. Oehlert gary@stat.stat.umn.edu Christopher Bingham kb@stat.stat.umn.edu University of Minnesota School of Statistics 313 Ford Hall 224 Church Street, S.E. Minneapolis, MN 55455-0493 August 18, 2005