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

Timestamp:

06/08/12 15:31:39 (12 years ago)

Author:

neise

Message:

... working on the docu

File:

• fact/tools/pyscripts/doc/getting_started.rst (modified) (1 diff)

fact/tools/pyscripts/doc/getting_started.rst

@@ -112 +112 @@
 This should work at ISDC only, but if it does not work, please ask somebody for help.
 
-6. Tiny examples
-===============
 
-one may interactively play with the two most important classes *RawData* and
-*SlowData* from module pyfact... 
-
-*datafilepath* and *calibfilepath* should be adjusted in case you are not working
-on the ISDC cluster. 
-
-explore class RawData::
-
-  from pyfact import RawData
-  # or from pyfact import *
-  
-  datafilepath = '/fact/raw/2012/03/04/20120304_018.fits.gz'
-  calibfilepath = '/fact/raw/2012/03/04/20120304_012.drs.fits.gz'
-  run = RawData(datafilepath, calibfilepath)
-  event = run.next()
-  
-  type(event)
-  
-  print 70*'*'
-  for key in event:
-    print 'key  :', key
-    print 'value:', event[key]
-    print 70*'*'
-
-for historical reasons, an event contains *data* and *acal_data*, where *acal_data*
-would be the DRS amplitude calibrated data, and *data* would be uncalibrated.
-But since the calibration was moved into a C++ class, for better performance,
-these keys now contains the same data.
-
-loop over RawData::
-
-  from pyfact import RawData
-  # or from pyfact import *
-  
-  datafilepath = '/fact/raw/2012/03/04/20120304_018.fits.gz'
-  calibfilepath = '/fact/raw/2012/03/04/20120304_012.drs.fits.gz'
-  run = RawData(datafilepath, calibfilepath)
-
-  for event in run:
-    print 'event_id:', event['event_id'] 
-    # the data can be found in event['data']
-
-have a look at some SlowData::
-
-  :~$ cd /fact/aux/2012/05/30
-  :/fact/aux/2012/05/30$ python
-  
-  from pyfact import SlowData
-  file = SlowData('20120530.FTM_CONTROL_TRIGGER_RATES.fits')
-  file.show()
-  
-
-have a look at the *columns*, that are available::
-
-  'columns': {'BoardRate': (40L, 4L, 'E', 'Hz'),
-             'ElapsedTime': (1L, 4L, 'E', 'sec'),
-             'FTMtimeStamp': (1L, 8L, 'K', 'us'),
-             'OnTime': (1L, 4L, 'E', 'sec'),
-             'OnTimeCounter': (1L, 8L, 'K', 'us'),
-             'PatchRate': (160L, 4L, 'E', 'Hz'),
-             'QoS': (1L, 4L, 'J', ''),
-             'Time': (1L, 8L, 'D', 'MJD'),
-             'TriggerCounter': (1L, 4L, 'J', 'int'),
-             'TriggerRate': (1L, 4L, 'E', 'Hz')},
-
-choose the *columns* you would like to retrieve from the file::
-
-  file.register('TriggerRate')
-  file.register('Time')
-  # or in case you are unsure
-  file.register('all')
-
-check, what happened. file has got some new members::
-
-  file.show()
-
-but they are all zero. Now one should call *next()* in order to get 
-the file contents row by row::
-
-  file.next()
-  file.show()
-
-or loop over the file::
-
-  for row in file:
-    print row.Time, row. OnTime
-
-*row* is just be a copy of *file*, but inside the for loop, I think it is 
-convenient to access members of *row* rather than members of *file*.
-I is just easier to understand for the reader, I think.
-
-7. Old way of creating the so files
+6. Old way of creating the so files
 ===================================