There are several options to start working with ostap, you can build ostap on the Linux or lxplus/7, run the docker container and futhermore now the ostap is available on conda and SWAN services.
ostap requires the python2 version >2.7 or python3. You need to provide ROOTSYS environment for building the package library. The library should be build with the same compiler version and C++ standard as was the one used to build ROOT.
After setting the enviroments clone and build ostap package:
git clone https://github.com/OstapHEP/ostap.git
cd ostap
mkdir build
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=<INSTALL_DIRECTORY>
make -j8
make install
source <INSTALL_DIRECTORY>/thisostap.sh
On lxplus/7 you can do it with several LCG versions (95,96,97), using the scripts/setup.sh. Check the location of the preffered LCG version. For instance for LCG 102rc1_LHCB_7 and x86_64-centos7-gcc11-opt:
- lb-set-platform x86_64-centos7-gcc11-opt
- source /cvmfs/sft.cern.ch/lcg/views/LCG_102rc1_LHCB_7/${CMTCONFIG}/setup.sh
- ./scripts/setup.sh
- source build/INSTALL/thisostap.sh
To update the package to latest version use the command:
git pull origin <latest tag>
or to get the head version:
git pull origin master
After update please repite the compilation steps
For the latest tag check the page https://github.com/OstapHEP/ostap/releases
We also provide Dockerfile to build the ostap image. You can run Ostap interactively using the command line or via Docker Desktop which is available on MacOS and Windows. To create the docker image from the Ostap directory run:
sudo docker build --network host -t <dockerID>/ostaphep:latest .
Or you can download image from the ostap from gitlab registry
docker pull ostaphep/ostaphep/centos7-build
Run the image iteractively:
sudo docker run -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix -v ${WORKDIR_PATH}/work_dir:/work_dir -it <dockerID>/ostaphep:latest
For the further info on docker, please check the documentation: https://docs.docker.com/.
ostap is now available on the conda-forge channel https://github.com/conda-forge/ostaphep-feedstock. To get ostap with conda:
Install mininconda:
wget http://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh
sh Miniconda3-latest-Linux-x86_64.sh
Set conda environments:
source path-to-miniconda/etc/profile.d/conda.sh
Add conda-forge to your channels:
conda config --add channels conda-forge
Check available versions:
conda search ostaphep --channel conda-forge
Create an environment with a specific version of python:
conda create --name ostap-env ostaphep python=3.7
To activate or deactivate ostap's environment:
conda activate ostap-env
conda deactivate
To get the latest version of the ostap package:
conda install -n ostap-env ostaphep=version
The list of available version you can find here. To know more about conda-forge, please visit conda page.
Additionally you can install the master version of the ostap package using dependancy packages which are also availible on conda:
Set conda environments:
source path-to-miniconda/etc/profile.d/conda.sh
Add conda-forge to your channels:
conda config --add channels conda-forge
Create an environment with required dependancies:
conda create -n ostap-req-env root_base root-binaries root-dependencies gsl future configparser numpy scipy pathos dill multiprocess ppft terminaltables binutils-meta c-compiler compilers cxx-compiler fortran-compiler python ipython cmake
If you computer has installed Berkeley-DB (libdb) and you are using python3, it is desirable also to add bsddb3 in the list
Activate the environment with requirement packages:
conda activate ostap-req-env
Clone and build ostap package:
git clone git://github.com/OstapHEP/ostap.git
cd ostap
mkdir build
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=<INSTALL_DIRECTORY>
make -j8
make install
source <INSTALL_DIRECTORY>/thisostap.sh
Note that the latest command should be used every time when the ostap-req-env is activated again.
The ostap installation uses the SWAN CERN service (described here.)