Installation (METRo)
From Documentation
This page contains the instructions to install the METRo software.
Contents |
[edit] Platform
METRo has been designed to run under GNU/Linux operating system on a x86 processor.
In case of trouble during the installation, please read the METRo troubleshooting to know if this problem is documented there.
[edit] Ubuntu/Kubuntu
On Ubuntu and Kubuntu box, you'll need the following package:
- python
- python-dev
- python-numpy
- python-xml
- python-libxml2
- swig
- gfortran
To install everything, write the following in a console:
sudo apt-get install python python-dev python-numpy python-xml python-libxml2 swig gfortran
[edit] Prerequisite
To run METRo, you will need the following software packages.
[edit] Python
METRo has been developed under python 2.3 and tested with python 2.4.
[edit] python :: numarray
Numarray is deprecated for version later than METRo 3.1.0. The numpy library is now used by METRo.
Numarray is a python library providing convenient functions and methods to work with, well, array of numbers. METRo has been developed with numarray version 0.9. Last supported version is 1.5.1 or later.
[edit] python :: numpy
Numpy is the library replacing the numarray version. METRo has been tested with 1.0.1
[edit] XML library
Since the METRo input and output format is XML, a python library is needed to parse the XML files.
Two choices are available to use with METRo: libxml2 and PyXML. METRo is ten times faster if the libxml2 library is used instead of PyXML.
[edit] python :: libxml2
The libxml2 library is usually installed with every standard GNU/Linux distribution. The python libxml2 binding corresponding to the existing version must be installed.
To know the release of libxml2 you have installed, do this following command:
ls /usr/lib | grep libxml2.so
The written numbers represent the release you have installed. To avoid all conflicts, download the source code with the corresponding release number and install.
- libxml2 (usually installed on standard GNU/Linux distribution) and the corresponding python bindings
[edit] python :: PyXML
PyXML is an python implementation of the XML DOM. The use of PyXML is very slow and is not recommanded, it is however supported by the METRo architecture.
[edit] gfortran
The physical model of METRo is written in fortran 77. The binary is included in the distribution but if one wants to change the code, gfortran is required.
[edit] SWIG
SWIG stands for Simplified Wrapper and Interface Generator. In METRo, SWIG is used to call C code from python.
METRo has been developed with SWIG version 1.3.20 and has been tested with versions 1.3.24 and 1.3.26.
[edit] METRo installation
The code of METRo is available on the gna website. Once you have the source code, follow these steps to install METRo:
1- Decompress the METRo source. Ex:
tar xjvf metro-x.x.x.tar.bz2
2- If there is more than one version of python on your system, set the environment variable PYTHON_INCLUDE to indicate the directory where you find the include of the latest (or the one you want to use) version python.
Ex:
export PYTHON_INCLUDE=/usr/local/include/python2.3
3- Execute the script setup.sh with the destination directory as an argument.
Ex:
./setup.sh /usr/local
4- Run METRo with the files provided to check the installation. In the directory path_to_metro/bin
execute the command:
python ./metro --selftest
if the file path_to_metro/data/roadcast/roadcast_selftest.xml
was created successfully and the only diffence with the file path_to_metro/data/roadcast/roadcast_selftest_reference.xml is the tag <production-date> , your installation is working.
Ex:
diff path_to_metro/data/roadcast/roadcast_selftest* 5c5 < <production-date>2006-08-22T13:57:44Z</production-date> --- > <production-date>2006-08-23T19:46:44Z</production-date>
 | This page is part of the documentation of the METRo software. Back to the table of content. |
