= Installing CEFLIB with Python 3

'Thanks to Thomasz KLOS from CAA team, who provided this short installation
manual.'

== Create data directory
   
Create a dedicated directory (data-dir)
----
data_dir=(data-dir)
mkdir $data_dir
cd $data_dir
----
   
== Download and unzip CEFLIB v1.8.1 
   
----
wget http://ceflib.irap.omp.eu/documents/CEFLIB-1.8.1.tar.gz
tar -zxf CEFLIB-1.8.1.tar.gz
cd CEFLIB/
---- 
   
== Modify build script

Update the CEFLIB/build script, with your favorite text editor:

* Modify INSTALL_DIR to (data-dir)/CEFLIB

* Modify NUMPY_DIR to the numpy install directory.

[NOTE]
--
numpy install directory can be checked by:

---- 
python3
import numpy; 
numpy.__path__
----
--
   
   
== Build LIB and C

----
cd LIB
../build -B clean raz all (on Mac probably without -B)
cd ../C
../build -B clean raz all (on Mac probably without -B)
----
   
== Build PYTHON API

----
cd PYTHON
----

Modify makefile with a text editor (change python to python3),
and build the software

----
../build -B clean raz all (on Mac probably without -B)
----

   
== Testing

The library is now installed. 

To use it, update the library path somewhere at the beginning of your script

----
import sys
sys.path.append("(data-path)/CEFLIB/PYTHON")
import ceflib
----
   
Or update the Unix environment variable PYTHONPATH, before launching Python :

----
$ export PYTHONPATH=(data-path)/CEFLIB/PYTHON
$ python3
>>> import ceflib
>>> ceflib.read ("filename.cef")
----