===============
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
=======

pyfact.py
=========

rawdata access
-------
.. autoclass:: pyfact.RawData
    :members:


fnames of a data run
--------------------
.. autoclass:: pyfact.fnames
	:members: