Installation Notes for the LLNLPython Distribution

The LLNL Distribution is delivered in two forms, LLNLDistribution.tgz for Unix, and LLNLDistribution.zip for Windows. The Windows distribution includes compiled libraries for the Numerical package only.

This distribution includes several packages (not in the Python sense, just in the sense of 'collection of modules').

• Numerical
• CXX
• Graphics
• PyHistory
• PyPDB
• RNG

Numerical should be installed first. PyHistory has no compiled portion. CXX is experimental and may present significant compilation difficulties as explained in the README file.

Note that source files other than the header files are not installed anywhere. Be sure to keep those parts of the distribution for which  you wish to have the source.

Gotcha #1: There have been bugs reported when loading on a platform where there is a native version of the BLAS or LAPACK. Somehow there is a confusion between different versions of the routines. Please be sure to alter the file Setup to remove the files indicated from the build of module lapack_lite and to set the location of your libraries appropriately if working on such a platform.

Gotcha #2: if you are building a C extension that requires you to use the numerical extension (arrayobject.h) then you MUST add the statement:
        import_array();
to the initialization routine for your module in order to initialize it properly.

Unix

Compilation

Perform the following two steps in each subdirectory of the LLNLDistribution directory which has a Src subdirectory you wish to build, beginning with Numerical.

• In the package's root directory, execute python makethis.py. Be sure to execute this script with the python you want to use to make and install the package.

Installation

• In the package's root directory, execute python installthis.py. Be sure to execute this script with the same python you used to make the package. The package files will be installed in unique subdirectories of your python installation directory. You will be given the chance to confirm these locations.

Windows 95, 98, NT

The distribution LLNLDistribution.zip contains the full source plus compiled libraries for Numerical. To install from this file simply unzip it and proceed to "installation" below. For the other packages, or recompiling on your own, first do the "Compilation" step.

Compilation (assumes Visual C++ 5 or later)

          This step is only needed if working from the sources. Always do Numerical first.

c:\wherever> python makethis.py (or double-click makethis.py)
c:\wherever> msdev workspace.dsw
[Go to "Build", pull down "Batch Build", do "Build All", exit DevStudio]

Installation

• install_windows.bat  (or double-click installthis.py) will install your package. To use a python other than the installed one use the procedure in the next paragraph. The package files will be installed in unique subdirectoriese of your python installation directory. You will be given the chance to confirm these locations..
• If you don't want the standard package name you can change it by running python by hand:
  python installthis.py package_name