Changeset 13376 for fact/tools/pyscripts/doc/getting_started.rst

Timestamp:

04/18/12 09:26:03 (13 years ago)

Author:

neise

Message:

added some examples, and changed the part about the env vars

File:

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

fact/tools/pyscripts/doc/getting_started.rst

@@ -30 +30 @@
 set the following env variables depending on the SHELL you are using, for instance in .bashrc or .tcshrc
 
+
 * **ROOTSYS**: /swdev_nfs/root_v5.28.00
 * **PATH**: add $ROOTSYS/bin
-* **PATH**: add /swdev_nfs/FACT++
-* **LD_LIBRARY_PATH**: $ROOTSYS/lib:/swdev_nfs/FACT++/.libs
+* **LD_LIBRARY_PATH**: add $ROOTSYS/lib
 * **PYTHONPATH**: $ROOTSYS/lib
 * **PYTHONPATH**: add all directories where python should search for modules. At least:
     * pyscripts/pyfact
-    * pyscript/tools
-    * pyscripts/ecamples
+* **LD_LIBRARY_PATH**: add the path to pyfits_h.so
+    * pyscripts/pyfact in many cases
 
 the absolute path depends on where you have checked (or will check) out the pyscripts repository
+
+example .bashrc::
+
+    # this is just a convenient shortcut
+    export MY_PYFACT=/home_nfs/isdc/neise/py/pyscripts/pyfact
+
+    # this is needed for ROOT only
+    export ROOTSYS=/swdev_nfs/root_v5.28.00
+    export PATH=$ROOTSYS/bin:$PATH
+    export LD_LIBRARY_PATH=$ROOTSYS/lib:$LD_LIBRARY_PATH
+
+    # this is needed for Python to find the pyfact classes and PyROOT
+    export PYTHONPATH=$PYFACT
+    export PYTHONPATH=$ROOTSYS/lib:$PYTHONPATH
+
+    #this is one of many possible ways, for ROOT to find pyfits_h.so
+    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$MY_PYFACT
+
 
 3. Check out the repository
@@ -48 +66 @@
 4. Create pyfits_h.so library
 =============================
+
 FACT data are stored in (gzipped) fits files, but the data files are too large to be read by the existing tools: 
 
@@ -55 +74 @@
 `pyroot <http://root.cern.ch/drupal/category/package-context/pyroot>`_ module.
 
-got to the directory: pyscripts/pyfact
+example by dom::
 
-simple::
-
-  [lusterma@isdc-cn02 pyfact]$ root
+  neise@isdc-viewer00:~/py/pyscripts/pyfact$ root
   ROOT 5.28/00 (trunk@37585, Dec 14 2010, 15:20:27 on linuxx8664gcc)
   CINT/ROOT C/C++ Interpreter version 5.18.00, July 2, 2010
   Type ? for help. Commands must be C++ statements.
   Enclose multiple statements between { }.
+  root [0] .L pyfits.h++
+  Info in <TUnixSystem::ACLiC>: creating shared library /home_nfs/isdc/neise/py/pyscripts/pyfact/./pyfits_h.so
+  In file included from /home_nfs/isdc/neise/py/pyscripts/pyfact/pyfits_h_ACLiC_dict.h:34,
+                   from /home_nfs/isdc/neise/py/pyscripts/pyfact/pyfits_h_ACLiC_dict.cxx:17:
+  /home_nfs/isdc/neise/py/pyscripts/pyfact/./pyfits.h: In member function »size_t std::fits::Table::GetN(const std::string&) const«:
+  /home_nfs/isdc/neise/py/pyscripts/pyfact/./pyfits.h:442: Warnung: Deklaration von »it« überdeckt einen vorhergehenden lokalen Bezeichner
+  /home_nfs/isdc/neise/py/pyscripts/pyfact/./pyfits.h:437: Warnung: Verdeckte Deklaration ist hier
+  root [1] .q
 
-  root [0] .L fits.h++
-  Info in <TUnixSystem::ACLiC>: creating shared library /home_nfs/isdc/lusterma/pyscripts/pyfact/./fits_h.so
-  root [1]
+check if it worked::
 
-This might not work for whatenver reason then it should be done like this::
+  neise@isdc-viewer00:~/py/pyscripts/pyfact$ ls pyfits*
+  pyfits.h  pyfits_h.d  pyfits_h.so
 
-  $rootcint -f my_dict.C -c fits.h izstream.h
+
+This might not work for whatenver reason then you can try this::
+
+  $rootcint -f my_dict.C -c pyfits.h izstream.h
   $g++ -fPIC -c -I$ROOTSYS/include my_dict.C -o my_dict.o
-  $g++ -o fits_h.so -shared my_dict.o
+  $g++ -o pyfits_h.so -shared my_dict.o
 
 Now you can check if the reading rawdata is working: