.. _eventfile:

=======================
Event file
=======================


What is event file?
=====================

Event file provides the records of specific types of activities (operations commands).
The source of event files are different between ASPERA-3 and -4.
ASPERA-3 event file is produced by a script developed by Leif Kalla.
The :mod:`irfpy.mexop.eventfile` module provide the functionality.
On the other hand, ASPERA-4 event file is produced by ``irfpy`` module.
The :mod:`irfpy.vexop.eventfile` module provide the reading functionality.


The ASPERA-4 event file
========================

ASPERA-4 event file is regularly produced by cron job at ``thor.irf.se``.
The file (URI) can be downloaded from:

http://aspera-4.irf.se/archive/commanding/pmrqs/EV_ASPERA.VEX

.. code-block:: sh

        wget http://aspera-4.irf.se/archive/commanding/pmrqs/EV_ASPERA.VEX


How to read the file?
------------------------

Use :mod:`irfpy.vexop.eventfile` module.

.. code-block:: py

        >>> from irfpy.vexop import eventfile
        >>> event = eventfile.EventFile('EV_ASPERA.VEX')
        >>> print(event.list[0]) 
        <Event: A4_ON        0023 2006-05-14T00:43:57 AASF001A (0 prms)>

From this example, the ASPERA-4 was powered on at 00:43:57 on May 14, 2006.

How can the file be produced?
-------------------------------

The script :mod:`vexop_eventfile` produces the event file.
See the script for details.