OOF2: The Manual

Chapter 1. Getting Started
	Part I. Using OOF2

Chapter 1. Getting Started

Table of Contents

1.1. Acquiring and Installing OOF2
1.2. Running OOF2
1.3. Learning OOF2

1.1. Acquiring and Installing OOF2

OOF2 is available from the NIST CTCMS website at

http://www.ctcms.nist.gov/oof/oof2

After downloading the program, follow the installation instructions in the README file.

1.1.1. Requirements

OOF2 will run on any Unix system with an X11 server. At the current time, it will not run on Windows. It has been compiled and run at NIST on Debian Linux, Ubuntu Linux, and Macintosh systems. It can also be installed on Macintoshes via MacPorts.

Building and running OOF2 requires a C++ compiler and a number of other freely available software programs and libraries, listed in Table 1.1. These must be installed before you install OOF2. To compile OOF2 from sources, you will also require the header files (“includes”) associated with these programs and libraries. These are usually available as part of a “development” version of the library software.

Detailed instructions for installing the OOF2 dependencies on a number of operating systems are available at

http://www.ctcms.nist.gov/oof/oof2/prerequisites.html.

Most of the prequisites are met by installing OOFCanvas and its prerequisites.

Table 1.1. OOF2 Requirements

Python	3.8 through 3.11	http://www.python.org
OOFCanvas	1.1.0 or later	https://www.ctcms.nist.gov/oof/oofcanvas
Magick++	6.x	https://www.imagemagick.org/Magick++
Gtk3	3.22 or later, but not as late as 4.0	https://docs.gtk.org/gtk3
pygobject	3.28 or later	https://pypi.org/project/PyGObject
cairomm	1.12 or later	https://www.cairographics.org/cairomm
Pango	1.40 or later	https://pango.gnome.org
PangoCairo	1.40 or later	https://docs.gtk.org/PangoCairo
BLAS ^[a]		https://www.netlib.org/blas
LAPACK^[a]		https://www.netlib.org/lapack
swig	4.0 or later	http://www.swig.org
cmake	3.18 or later	https://cmake.org
^[a] BLAS and LAPACK are provided by the vecLib system library on macOS and don't need to be installed.

Macintosh users can configure OOF2 to use either Apple's native Quartz graphics (recommended) or X11. If using X11 they will need to install an X11 server such as XQuartz.


3. About This Manual		1.2. Running OOF2