OpenLC is programmed in Python. The main development platform is Linux, but OpenLC and the software it depends upon also should run on other Unices and Windows platforms. Provided your machine is properly configured with the necessary base software, there's no reason why it shouldn't run on your platform. If it doesn't, please send me a mail.
In the next sections, very detailed prerequisite installation instructions are described. Please, read and follow carefully the guidelines stated there before to continue.
Here you will find brief instructions for installing the required software in UNIX platforms. First are listed the requisites for OpenLC server, and then for the client.
To compile and install everything, you will need the GNU C compiler, GNU Make, autoconf, automake and other common utilities. You will find that there are also binaries packages ready for Linux or Solaris, but installing them in that form is not as fun as compiling the sources :-).
Although the development platform for OpenLC is Linux, we have been able to compile (and execute) successfully the prerequisites and OpenLC in Solaris 7 (UltraSparc). Other Unices should also compile and execute well, but your mileage may vary. Please, drop me an e-mail if you get into difficulties.
Please, unless you know what you are doing, install the packages preferably in sequential order. If you have installation problems with a specific software, refer to the original package documentation. Note also that, in general, version numbers are stated because they run well with OpenLC. You may use other versions and probably you can have success for running OpenLC, but in some cases don't. If you are experiencing problems, please, double-check the prerequisite versions, and try to stay in sync with them.
cd py-xmlrpc-0.8.8.2 python setup.py build (become root) python setup.py install
cd Numeric-21.0 python setup.py build (become root) python setup.py install
./configure make make test (become root) make install
cd ScientificPython-2.3.6 python setup.py build (become root) python setup.py install
cd Gnosis_Utils-1.0.2 python setup_gnosis.py build (become root) python setup_gnosis.py install
HDF5 can store two primary objects: datasets and groups. A dataset is essentially a multidimensional array of data elements, and a group is a structure for organizing objects in an HDF5 file. Using these two basic objects, one can create and store almost any kind of scientific data structure, such as images, arrays of vectors, and structured and unstructured grids. You can also mix and match them in HDF5 files according to your needs.
If you want to have the run data (raw and reduced) in HDF5 format in addition to NetCDF, you have to install a couple of packages more.
cd hdf5-1.4.3 ./configure make (become root) make install # Make this library accessible. In linux this is normally # acomplished by issuing an ldconfig command, but this is # OS dependent. # Check documentation about shared libraries for # more information, such as the ld(1) and ld.so(8) # manual pages. ldconfig # If Linux
cd hlhdf-0.40 ./configure make (become root) # The setup.py is in the debian directory, but is completely general # for any UNIX or Windows OS. python debian/setup.py install
For running the client OLCCommander you will need Python 2.1 or higher, as well as the Python XMLRPC 0.8.8.2 or higher. Follow the installation instructions as in the server case.
Although the development platform for OpenLC is Linux, OpenLC, both server and client, also run in Windows without modification because it's a pure Python application. However, there aren't Windows binary versions for all the prerequisites, so I will discuss only how to install prerequisites only for the client program. If you want to install the server, you must have a C compiler (preferably Visual C++ 6.0), GNU Make, autoconf and other common utilities. You may have a look at the excellent package MinGW (Minimalist GNU for Windows) for free and GNU compatible tools. Read the section 2.1.1 for detailed compilation and installation instructions.
Have in mind that, unless you know what you are doing, you should install the packages preferably in sequential order. If you have installation problems with a specific software, refer to the original package documentation.
cd Gnosis_Utils-1.0.2 python setup_gnosis.py build (become super-user, if needed) python setup_gnosis.py install
OpenLC is pure Python code, with no C extensions, so no C compiler is needed. To install it, get the package from http://openlc.sf.net, unpack the sources, and proceed as follows:
cd OpenLC-0.6 # Edit OpenLC-config.xml and choose the rundata directory. # Edit setup.py and select the directories for configuration # files and executables. python setup.py build (become super-user) python setup.py install
Once you have done that, you are ready to run OpenLC server (OLCServer command) and client (OLCCommander command). Of course, you can choose to run both on the same or different machines. See the next chapter to see some examples of use.