Design of the library
PyFAI can be seen as a set of application written in Python or as the underlying library. I would describe it as a stack of 5 layers, upper ones relying on lower ones:
Graphical user interfaced application:
pyFAI-calib2,diff_map, …
Command-line scripts:
pyFAI-average,pyFAI-benchmark, …
Top level objects:
AzimuthalIntegrator,Distortion, …
Helper classes:
Detector,Calibrant, …
Rebinning engines:
CSRIntegrator,OCL_CSR_Integrator, …
Common basement: Python, Numpy, Cython, PyOpenCL and silx
At level 5. are easy-to use applications, requiring no specific computing knowledge. Levels 3. and 2. are heavily described in tutorials and should be accesible to any Pythonistas. We try to keep the API on those levels consistent between versions. Level 1. is often written in Cython, or OpenCL and requires low-level expertise.
Of course mastering level 1. provides faster analysis, but it is not of general use.