Changeset 14097 for fact/tools/pyscripts/doc

Timestamp:

06/07/12 10:18:54 (12 years ago)

Author:

neise

Message:

explained new makelibs.C script

File:

• fact/tools/pyscripts/doc/getting_started.rst (modified) (3 diffs)

fact/tools/pyscripts/doc/getting_started.rst

@@ -53 +53 @@
 
     # this is needed for Python to find the pyfact classes and PyROOT
-    export PYTHONPATH=$PYFACT
+    export PYTHONPATH=$MY_PYFACT
     export PYTHONPATH=$ROOTSYS/lib:$PYTHONPATH
 
@@ -62 +62 @@
 3. Check out the repository
 ===========================
-svn co https://fact.isdc.unige.ch/svn/fact/tools/pyscripts/
-
-4. Create pyfits_h.so library
+svn co https://fact.isdc.unige.ch/svn/fact/tools/pyscripts py
+
+
+4a. Create the needed *.so libs @ ISDC
+======================================
+
+FACT data are stored in (gzipped) fits files, but the data files are too large to be read by the existing tools: 
+
+`pyfits <http://www.stsci.edu/institute/software_hardware/pyfits>` which uses `cfitsio <http://heasarc.gsfc.nasa.gov/fitsio/>`_.
+
+To mitigate this problem a C++ class defined in fits.h [#f1]_ is used. A simple possibility to create an interface of this C++ class is to use ROOT and later to import it using the
+`pyroot <http://root.cern.ch/drupal/category/package-context/pyroot>`_ module.
+
+example::
+  neise@isdc-viewer00:~/py/pyfact$ root -l -q makelibs.C 
+  root [0] 
+  Processing makelibs.C...
+  Info in <TUnixSystem::ACLiC>: creating shared library /home_nfs/isdc/neise/test_py/pyfact/./izstream_h.so
+  Info in <TUnixSystem::ACLiC>: creating shared library /home_nfs/isdc/neise/test_py/pyfact/./factfits_h.so
+  [... quite some warnings ...]
+  
+  neise@isdc-viewer00:~/py/pyfact$ ls *.so
+  calfactfits_h.so  factfits_h.so  izstream_h.so
+
+4b. Create pyfits_h.so library 
 =============================
+
+-----------This is a depricated section---------------
 
 FACT data are stored in (gzipped) fits files, but the data files are too large to be read by the existing tools: 
@@ -135 +159 @@
     pyfits.h  pyfits_h.d  pyfits_h.so
 
-
-
-Now you can check if the reading rawdata is working:
-
-$ ./pyfact.py
-
-this should print some data from a few events
+Now you can check if the reading rawdata is working::
+
+  neise@isdc-viewer00:~/py/pyfact$ pyfact.py 
+  showing test of iterator of RawData class
+  in order to test the SlowData classe please use: ./pyfact.py fits-file-name
+  ev  1 data[0,0] =  -7.68806196438 start_cell[0] =  426 trigger type =  416
+  ev  2 data[0,0] =  0.792280672486 start_cell[0] =  437 trigger type =  416
+  ev  3 data[0,0] =  54.9490855517 start_cell[0] =  449 trigger type =  416
+  ev  4 data[0,0] =  3.9482592671 start_cell[0] =  461 trigger type =  416
+  ev  5 data[0,0] =  -66.4329317281 start_cell[0] =  474 trigger type =  416
+  ev  6 data[0,0] =  8.2917625181 start_cell[0] =  485 trigger type =  416
+  ev  7 data[0,0] =  -41.6565116079 start_cell[0] =  498 trigger type =  416
+  ev  8 data[0,0] =  33.4668984163 start_cell[0] =  509 trigger type =  416
+  ev  9 data[0,0] =  -28.520090549 start_cell[0] =  522 trigger type =  416
+  ev  10 data[0,0] =  -20.4925692795 start_cell[0] =  533 trigger type =  416
+
 
 5. Run examples