Installation (METRo)

From Documentation

This page contains the instructions to install the METRo software.

Contents 1 Platform 2 Prerequisite 2.1 Python 2.1.1 python :: numarray 2.1.2 python :: numpy 2.2 XML library 2.2.1 python :: libxml2 2.2.2 python :: PyXML 2.3 g77 2.4 SWIG 3 METRo installation

[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] 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.

• python website

[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.

• python numarray

[edit] python :: numpy

Numpy is the library replacing the numarray version. METRo has been tested with 1.0.1

• python numpy

[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.

• PyXML

[edit] g77

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, g77 is required.

• g77

[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.

• SWIG

[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.