taurus taurus

Table Of Contents

Previous topic

Introduction

Next topic

User’s Interface

This Page

Getting started

Installing

Linux (Debian-based)

Since v3.0, Taurus is part of the official repositories of Debian (and Ubuntu and other Debian-based distros). You can install it and all its dependencies by doing (as root):

aptitude install python-taurus

(see more detailed instructions in this step-by-step howto)

Linux (generic)

  1. Download the latest version of taurus from http://pypi.python.org/pypi/taurus

  2. Extract the downloaded tar.gz into a temporary directory

  3. type:

    python setup.py build
    python setup.py install
  4. test the installation:

    python -c "import taurus; print taurus.Release.version"

Windows

  1. Download the latest windows binary from http://pypi.python.org/pypi/taurus

  2. Run the installation excecutable

  3. test the installation:

    C:\Python26\python -c "import taurus; print taurus.Release.version"

Windows installation shortcut

This chapter provides a quick shortcut to all windows packages which are necessary to run taurus on your windows machine

  1. from Python(x,y)
    1. Download and install a python 2.6/2.7 compatible version of python(x,y) from here
  2. from scratch:
    1. Download and install PyQwt < 6.0 from PyQwt downdoad page
      1. Download and install compatible python with from link in the same PyQwt page
      2. Download and install compatible numpy from link in the same PyQwt page.
      3. Download and install compatible PyQt from link in the same PyQwt page.
  3. Finally:
    1. Download and install latest PLY from PLY downdoad page (necessary for jdraw synoptics only)
    2. Download and install latest PyTango from PyTango downdoad page
    3. Download and install latest taurus from Taurus downdoad page

Working from Git

Sometimes it is convenient to work directly from the git source without installing. Taurus code is hosted in a subdirectory of the main Sardana git repository

You can clone sardana from our main git repository:

git clone git://git.code.sf.net/p/sardana/sardana.git sardana

and you will find the taurus code in the sardana/taurus directory.

Then, if you decide to work directly from Git code (without installing):

  1. add <sardana_root_dir>/taurus/lib to PYTHONPATH

  2. add <sardana_root_dir>/taurus/scripts to PATH

  3. build the resources:

    cd <sardana_root_dir>/taurus
    python setup.py build_resources

Dependencies

digraph dependencies {
    size="8,3";
    Taurus      [shape=box,label="taurus 2.0"];
    PyTango     [shape=box,label="PyTango 7.1.0"];
    Python      [shape=box,label="Python >=2.6"];
    numpy       [shape=box,label="numpy >=1.1.0"];
    PyQt        [shape=box,label="PyQt >=4.4.3"];
    PyQwt       [shape=box,label="PyQwt >=5.2.0"];
    Qub         [shape=box,label="Qub >=1.1.0"];
    qtcontrols  [shape=box,label="qtcontrols >=1.1.0"];
    PyMca       [shape=box,label="PyMca >=4.4.1"];
    ply         [shape=box,label="PLY"];

    Taurus -> Python;
    Taurus -> PyTango;
    Taurus -> PyQt         [label="taurus.qt only"];
    Taurus -> PyQwt        [label="taurus.qt only"];
    Taurus -> Qub          [style=dotted, label="taurus.qt.qtgui.image only"];
    Taurus -> qtcontrols   [style=dotted, label="taurus.qt.qtgui.gauge only"];
    Taurus -> PyMca        [style=dotted, label="taurus.qt.qtgui.extra_nexus only"];
    Taurus -> ply          [style=dotted, label="taurus.qt.qtgui.graphic.jdraw only"];
    Taurus -> numpy;
}

Taurus has dependencies on some python libraries. After you installed taurus you can check the state of the dependencies by doing:

>>> import taurus
>>> taurus.check_dependencies()
Checking required dependencies of taurus.core...
    Checking for Python >=2.6.0... [OK] (Found 2.6.2)
    Checking for PyTango >=7.1.0... [OK] (Found 7.1.0)
Checking required dependencies of taurus.qt...
    Checking for PyQt >=4.4.3... [OK] (Found 4.5.0)
    Checking for PyQwt >=5.2.0... [OK] (Found 5.2.1)
Checking OPTIONAL dependencies of taurus.qt...
    Checking for Qub >=1.0.0... [OK] (Found 1.0.0)
    Checking for qtcontrols >=1.0.0... [OK] (Found 1.0.0)
  • You may already have PyTango installed. You will need PyTango 7 or later. You can check by doing:

    python -c 'import PyTango; print PyTango.Release.version'

    If that fails or it reports and older version follow the PyTango installation steps to properly install PyTango.

  • You may already have PyQt installed. You will need PyQt 4.4 or later. You can check by doing:

    python -c 'import PyQt4.Qt; print PyQt4.Qt.QT_VERSION_STR'

Optional packages

  • The plotting widgets are only available if you have PyQwt. You may already have PyQwt installed. You will need PyQwt 5.2.0 or later. You can check it by doing:

    python -c 'import PyQt4.Qwt5; print PyQt4.Qwt5.QWT_VERSION_STR'
  • The image widgets are provided by the guiqwt library. The widgets based on this library replace the previously used Qub-based image widget which is now considered deprecated in Taurus

  • The Gauge widgets are only available if you have the python extension of qtcontrols. qtcontrols is part of QTango.

  • The JDraw synoptics widgets are only available if you have the ply package installed.

  • The NeXus browser widget is only available if you have PyMca installed