This package is the version of the OpenScientist osc_vis used
 by the LHCb/Panoramix event display. Below are instructions to
 build on a local Linux or macOS machine, but also to build on
 lxplus by using the gcc, Qt and Python packages used by LHCb, which are
 now under:
    /cvmfs/lhcb.cern.ch/lib/lcg/releases/[gcc,Python,qt]

 ///////////////////////////////////////////////////////////////
 //// build osc_vis : //////////////////////////////////////////
 ///////////////////////////////////////////////////////////////
   <source setup the desired compiler>

   cd osc/osc_vis/mgr
   
 To build code over C lib, STL and OpenGL only :    
   ./build

 To build [gtk,Qt,OpenMotif,Python] related code, you may have to customize :  
   ../../../inexlib/exlib/mgr/use_[gtk,Qt,Xt,Python]
 and then :
   ./build -[gtk,Qt,Xt,Python]

 For Qt and Python, on lxplus for a build for LHCb, see the special note below.

 To build the release :
   ./build_release

 It produces the zip distribution binary file :
   ./bin_[gnu,clang]/distrib/osc_vis-<version>-<platform>-<compiler>.zip

 To have a trace of what happens (what is compiled, linked), you can type :
   ./build -v

 and to be fully verbose :
   ./build -x

 To remove the per package bin_<config> directories with binaries :
   ./build -clean_all

 ///////////////////////////////////////////////////////////////
 //// install //////////////////////////////////////////////////
 ///////////////////////////////////////////////////////////////
  To install a binary kit, for example under you home directory,
 in an existing writable "local" directory :
   cd ~/local
   <get a zip binary kit>
   unzip -q osc_vis-<version>-<platform>-<compiler>.zip
   cd osc_vis/<version>
   ./install

  The ./install script enforces the installation path in the
 [aida-]setup.[csh,sh] scripts. You have to execute it once.

 ///////////////////////////////////////////////////////////////
 //// use //////////////////////////////////////////////////////
 ///////////////////////////////////////////////////////////////
  After installation, to use the kit you have to "source setup" it
 by sourcing, according your shell, or the setup.sh or the setup.csh
 script. If you have a sh flavoured shell :
   sh> . <installation_path>/osc_vis/<version>/setup.sh
   sh> osc-plot
  (sh> osc-plot -gtk)
  (sh> osc-plot -Xt)

  If you have a csh flavoured shell :
   csh> source <installation_path>/osc_vis/<version>/setup.csh
   csh> osc-plot

  If using Qt, you may have to source setup it :
   sh> . ./Qt-setup.sh  # to find the Qt shared libs of the
                        # Qt installation used at build time.
 (csh> source Qt-setup.csh)
   sh> osc-plot -Qt

 ///////////////////////////////////////////////////////////////
 ///////////////////////////////////////////////////////////////
  To test the graphics with osc-plot :
  - Choose the Viewer3D tab to have the Inventor decorations.
  - Help => Examples => Examples/AIDA/DLD => Histogram2D/lego plot
  - Play with the thumb wheels.

 ///////////////////////////////////////////////////////////////
 ///////////////////////////////////////////////////////////////
 If using Python, you may have to source setup it :
   sh> . ./py-setup.sh   # to find the python program of the
                         # Python installation used at build time.
 (csh> source py-setup.csh)
   sh> . ./Python-setup.sh   # to set PYTHONPATH to find osc_vis plugins.
 (csh> source Python-setup.csh)
   sh> cd Resources/AIDA/examples/Python
   sh> python aida_0.py
   sh> OSC_GUI_TOOLKIT=Qt;export OSC_GUI_TOOLKIT
 (csh> setenv OSC_GUI_TOOLKIT Qt)
   sh> python aida_1.py

 WARNING : the python program must be the one coming from the Python installation
           used to build the plugins ([Coin,HEPVis,OnX,OnXLab]_SWIG_Python.so).
           You must be aware that multiple python programs may exist on your machine.

 ///////////////////////////////////////////////////////////////
 //// Qt, Python on lxplus /////////////////////////////////////
 ///////////////////////////////////////////////////////////////
  The exlib/mgr/use_Qt, use_Python are tuned to find Qt
 and Python on the "lcg area" under :
   /cvmfs/lhcb.cern.ch/lib/lcg/releases/[Python,qt]

  If "being on lxplus" is detected (by using `uname -n`), then
 the version of Python, Qt used is choosen from a BUILD_CONFIG
 variable that you have to define before launching the build
 for Python, Qt. For example :
   sh> export BUILD_CONFIG=x86_64-centos7-gcc62-opt

  Obviously you must take care to be on the correct kind of machine,
 then here a 64 bits machine under centos7, and be sure to use the   
 right compiler. Here typing :
   sh> g++ --version

 should return you a 6.2.x version. Various version of g++ can
 be found under :
   /cvmfs/sft.cern.ch/lcg/contrib/gcc

  For example to setup a 6.2 one under a csh shell, type :
   csh source /cvmfs/lhcb.cern.ch/lib/lcg/releases/gcc/6.2.0/x86_64-centos7/setup.csh

  Under the configs directory some scripts can be found to
 setup both the compiler and BUILD_CONFIG for the configs
 already known by exlib/mgr/use_[Qt,Python].

  Note that on lxplus, someone can build the Qt driver (./build -Qt),
 but also the gtk2 (./build -gtk) and the OpenMotif (./build -Xt) ones since
 gtk2 and OpenMotif are installed on the system. (And put all together,
 if displaying on a remote machine, OpenMotif is still the most effective!)