diffractometer: add pa() report

[prjemian]

fixes #434 to make a report of the diffractometer sample(s), orientation, and reflection(s)

[prjemian]

@gfabbris, @ambarb: please look at this PR (and issue in #434)

[prjemian]

simpler example:

In [13]: sim4c = APS_diffractometer.SoftE4CV('', name='sim4c')                                                                                                   
In [17]: r1 = sim4c.calc.sample.add_reflection(1, 1, 0, 
    ...:     position=sim4c.calc.Position(omega=45, chi=45, phi=90.0, tth=90)) 
    ...: r2 = sim4c.calc.sample.add_reflection(0, 1, 0, 
    ...:     position=sim4c.calc.Position(omega=30, chi=90, phi=90.0, tth=60)) 
    ...: sim4c.calc.sample.compute_UB(r1, r2) 
    ...:                                                                                                                                                         
Out[17]: 1

In [18]: sim4c.pa()                                                                                                                                              
===================== ==========================================================================
term                  value                                                                     
===================== ==========================================================================
diffractometer        sim4c                                                                     
geometry              E4CV                                                                      
class                 SoftE4CV                                                                  
energy (keV)          0.80509                                                                   
wavelength (angstrom) 1.54000                                                                   
calc engine           hkl                                                                       
mode                  bissector                                                                 
positions             ===== =======                                                             
                      name  value                                                               
                      ===== =======                                                             
                      omega 0.00000                                                             
                      chi   0.00000                                                             
                      phi   0.00000                                                             
                      tth   0.00000                                                             
                      ===== =======                                                             
sample: main          ================= ========================================================
                      term              value                                                   
                      ================= ========================================================
                      unit cell edges   a=1.54, b=1.54, c=1.54                                  
                      unit cell angles  alpha=90.0, beta=90.0, gamma=90.0                       
                      ref 1 (hkl)       h=1.0, k=1.0, l=0.0                                     
                      ref 1 positioners omega=45.00000, chi=45.00000, phi=90.00000, tth=90.00000
                      ref 2 (hkl)       h=0.0, k=1.0, l=0.0                                     
                      ref 2 positioners omega=30.00000, chi=90.00000, phi=90.00000, tth=60.00000
                      [U]               [[ 1.00000000e+00 -1.11022302e-16  1.08845649e-16]      
                                         [ 1.11022302e-16  1.00000000e+00 -1.08845649e-16]      
                                         [-1.08845649e-16  1.08845649e-16  1.00000000e+00]]     
                      [UB]              [[ 4.07999046e+00 -7.02797298e-16  1.94261847e-16]      
                                         [ 4.52969935e-16  4.07999046e+00 -6.93916573e-16]      
                                         [-4.44089210e-16  4.44089210e-16  4.07999046e+00]]     
                      ================= ========================================================
===================== ==========================================================================

Out[18]: <pyRestTable.rest_table.Table at 0x7f4eb464fc40>

[prjemian]

TODO: report any constraints

[prjemian]

Here is an overview of what got changed by this pull request:

Complexity increasing per file
==============================
- apstools/diffractometer.py  5
         

See the complete overview on Codacy