Installation

This installation description is for the general user. If you are using the Belle II software, see below:

  1. Setup your local environment. For example, run:

    source venv/bin/activate
    
  2. Install b2luigi from pipy into your environment.

    1. If you have a local installation, you can use the normal setup command
    pip3 install b2luigi
    
    1. If this fails because you do not have write access to where your virtual environment lives, you can also install b2luigi locally:
    pip3 install --user b2luigi
    

    This will automatically also install luigi into your current environment. Please make sure to always setup your environment correctly before using b2luigi.

Now you can go on with the Quick Start.

b2luigi and Belle II

Starting from release 04-00-00, b2luigi is already included in the externals. Follow this guid, if you want to update to the newest version nevertheless.

  1. Setup your local environment. You can use a local environment (installed on your machine) or a release on cvmfs. For example, run:

    source /cvmfs/belle.cern.ch/tools/b2setup prerelease-02-00-00c
    

    Or you setup your local installation

    cd release-directory
    source tools-directory/b2setup
    
  2. Install b2luigi from pipy into your environment.

    1. If you have a local installation, you can use the normal setup command
    pip3 install b2luigi -U
    
    1. If you are using an installation from cvmfs, you need to add the user flag.
    pip3 install --user b2luigi -U
    

The examples in this documentation are all shown with calling python, but basf2 users need to use python3 instead.

Please also have a look into the Basf2 specific examples.