File: Clock.rst

package info (click to toggle)
ecflow 5.15.2-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 51,868 kB
  • sloc: cpp: 269,341; python: 22,756; sh: 3,609; perl: 770; xml: 333; f90: 204; ansic: 141; makefile: 70
file content (86 lines) | stat: -rw-r--r-- 1,964 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
ecflow.Clock
////////////


.. py:class:: Clock
   :module: ecflow

   Bases: :py:class:`~Boost.Python.instance`

Specifies the :term:`clock` type used by the :term:`suite`.

Only suites can have a :term:`clock`.
A gain can be specified to offset from the given date.

Constructor::

   Clock(day,month,year,hybrid)
      int day              : Specifies the day of the month  1-31
      int month            : Specifies the month 1-12
      int year             : Specifies the year > 1400
      bool hybrid<optional>: Default = False, true means hybrid, false means real
                             by default the clock is not real

      Time will be set to midnight, use set_gain() to alter

   Clock(hybrid)
      bool hybrid: true means hybrid, false means real
                   by default the clock is real
      Time will be set real time of the computer


Exceptions:

- raises IndexError when an invalid Clock is specified

Usage:

.. code-block:: python

   suite = Suite('s1')
   clock = Clock(1,1,2012,False)
   clock.set_gain(1,10,True)
   suite.add_clock(clock)


.. py:method:: Clock.day( (Clock)arg1) -> int :
   :module: ecflow

Returns the day as an integer, range 1-31


.. py:method:: Clock.gain( (Clock)arg1) -> int :
   :module: ecflow

Returns the gain as an long. This represents seconds


.. py:method:: Clock.month( (Clock)arg1) -> int :
   :module: ecflow

Returns the month as an integer, range 1-12


.. py:method:: Clock.positive_gain( (Clock)arg1) -> bool :
   :module: ecflow

Returns a boolean, where true means that the gain is positive


.. py:method:: Clock.set_gain( (Clock)arg1, (int)arg2, (int)arg3, (bool)arg4) -> None :
   :module: ecflow

Set the gain in hours and minutes


.. py:method:: Clock.set_gain_in_seconds( (Clock)arg1, (int)arg2, (bool)arg3) -> None :
   :module: ecflow

Set the gain in seconds


.. py:method:: Clock.year( (Clock)arg1) -> int :
   :module: ecflow

Returns the year as an integer, > 1400