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

Timestamp:

04/05/12 14:10:40 (12 years ago)

Author:

lusterma

Message:

worked on doc

File:

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

fact/tools/pyscripts/doc/getting_started.rst

@@ +1 @@
+===============
+Getting Started
+===============
+
+1) Get an account at the FACT data center at ISDC
+2) Setup your environment variables
+3) Checkout the pyfact software repository
+4) Try a few examples
+
+1. Important links
+=================================
+
+**FACT data center at ISDC** <http://www.isdc.unige.ch/fact/datacenter>**
+    here you find instructions how to get an account, how to set it up and how to use it
+
+**SVN repository** <https://fact.isdc.unige.ch/svn/fact/>
+    hosts all FACT software (including pyfact)
+
+**FACT run database** <https://www.fact-project.org/run_db/db/fact_runinfo.php>
+    here you find information about all available runs
+
+**eLogbook** <https://www.fact-project.org/logbook/>
+  telescope logbook used since Dec. 1, 2012; for logbook information before this date have a look here: <http://fact.ethz.ch/FACTelog/index.jsp>
+
+**FACT La Palma pages** <https://www.fact-project.org/>
+  plenty of information concerning the telescope in La Palma
+
+2. Environment variables
+=====================
+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
+* **PYTHONPATH**: $ROOTSYS/lib
+* **PYTHONPATH**: add all directories where python should search for modules. At least:
+    * pyscripts/pyfact
+    * pyscript/tools
+    * pyscripts/ecamples
+    * py
+
+the absolute path depends on where you have checked (or will check) out the pyscripts repository
+
+3. Check out the repository
+========================
+svn co https://fact.isdc.unige.ch/svn/fact/tools/pyscripts/
+
+4. Create pyfits library
+========================
+FACT data are stored in (gzipped) fits files, but the data files are too large to be read by the default tool: 
+
+`pyfits <http://www.stsci.edu/institute/software_hardware/pyfits>`.
+
+To mitigate this problem a C++ class defined in `fits.h` is used. A simple possibility to create an interface of this C++ class and python is to use the 
+
+`pyroot http://root.cern.ch/drupal/category/package-context/pyroot>` module.
+
+simple::
+
+  [pceth118] /home/luster/py > root
+  ROOT 5.28/00h (branches/v5-28-00-patches@42209, Feb 13 2012, 23:52:00 on linux)
+  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 fits.h++
+  Info in <TUnixSystem::ACLiC>: creating shared library /home/luster/py/./fits_h.so
+  root [1]
+
+
+
+5. Run examples
+============
+
+
 =======
 Classes
@@ -8 +83 @@
 rawdata access
 -------
-.. autoclass:: pyfact.rawdata
+.. autoclass:: pyfact.RawData
     :members: