Re: historystats file format documentation

Zdeněk Kedaj <[email protected]> writes:

> 2010/4/15 Joe Wells <[email protected]>
>
>     Zdeněk Kedaj <[email protected]> writes:
>
>     > The date format is a bit confusing, why it starts with "1" and why is not full
>     > year representation present? I guess 104 in the exaple corresponds to year 2004
>     > - or is there any other magic interpretation of 104? :)
>
>     I think the contents of this line is just a raw dump of the data that
>     is returned by the “localtime” or “gmtime” library function calls on POSIX
>     systems.  The documentation of those functions says this:
>
>      tm_year
>        The number of years since 1900.
>
>     > I also guess the two
>     > dates on the line mean "start of recording" and "end of recording" within one
>     > day, unless the work period overlaps to the next day.
>
>     I think you are (mostly) correct.  The first date seems to be the time
>     of the earliest activity noticed on a given day, and the second one
>     seems to be the time of the last activity on that same day.
>
>     > It would be more valuable
>     > to segment the work records in hours in the next version of workrave
>     > stats.
>
>     It is true that you need to do some processing to get a breakdown by
>     hours.  Fortunately, the information you want is already there.
>
> The basic information is there, but you loose the knowledge of how is the work
> distributed during the day. If you work 5 hours in the morning and then just
> click shut down in the evening you get misleading work period. From this
> historystat format you cannot make any conclusions about workloads during the
> day (which could be interesting), that is what I tried to point out.

Sorry for being confusing.  The information you want is in the
“idlelog..log” file.  If you look for earlier postings on this mailing
list, you can find programs that process this data.

I hope this helps.

-- 
Joe

>     > Well but thanks for feedback anyway, I will have the java stuff done untill the
>     > end of april :)
>     >
>     > 2010/4/8 Joe Wells <[email protected]>
>     >
>     >     Zdeněk Kedaj <[email protected]> writes:
>     >
>     >     > Hello everyone, 
>     >     > is there any documentation on the historystats file? I want to know the meaning
>     >     > of the rows and numbers in this file as I am going to write Java app for
>     >     > extract the data to some format that can be easily read/imported to some
>     >     > statistics software. Although I can guess the format I would like some more
>     >     > feedback from people who really know the meaning of those numbers.
>     >
>     >     Here is a relevant comment from contrib/plot/workrave-dump in the
>     >     Workrave 1.8.5 distribution:
>     >
>     >     # WorkRaveStats 4
>     >     # D 16 5 104 14 51 17 5 104 3 59
>     >     # B 0 7 9 8 40 0 0 9 386
>     >     # B 1 7 4 1 0 1 3 4 362
>     >     # B 2 7 0 0 0 0 0 0 0
>     >     # m 6 6049 234742 113560 266 417 16617
>     >     # D 17 5 104 16 49 18 5 104 3 59
>     >     # B 0 7 1 0 3 0 0 1 526
>     >     # B 1 7 3 0 0 0 2 2 1768
>     >     # B 2 7 0 0 0 0 0 0 872
>     >     # m 6 15272 39275 11937 36 30 1899
>     >     #
>     >     # D(ate):       [ tm_mday tm_mon tm_year tm_hour tm_min ] {2}
>     >     #
>     >     # B(reak):      <t> <nn> <x0> <x1> <x2> <x3> <x4> <x5> <x6>
>     >     #
>     >     #       <t> = break type
>     >     #               0 = microbreak
>     >     #               1 = rest break
>     >     #               2 = daily limit
>     >     #
>     >     #       <nn> STATS_BREAKVALUE_SIZEOF - number of following numbers
>     >     #
>     >     #       <x0> STATS_BREAKVALUE_PROMPTED - break prompts<x6> + repeated prompts
>     >     #       <x1> STATS_BREAKVALUE_TAKEN - prompted breaks taken
>     >     #       <x2> STATS_BREAKVALUE_NATURAL_TAKEN - natural breaks taken
>     >     #       <x3> STATS_BREAKVALUE_SKIPPED - breaks skipped
>     >     #       <x4> STATS_BREAKVALUE_POSTPONED - breaks postponed
>     >     #       <x5> STATS_BREAKVALUE_UNIQUE_BREAKS - break prompts
>     >     #       <x6> STATS_BREAKVALUE_TOTAL_OVERDUE - overdue time (seconds)
>     >     #
>     >     # m(isc):       <nn> <x0> <x1> <x2> <x3> <x4> <x5>
>     >     #
>     >     #       <nn> STATS_VALUE_SIZEOF
>     >     #       <x0> STATS_VALUE_TOTAL_ACTIVE_TIME (seconds)
>     >     #       <x1> STATS_VALUE_TOTAL_MOUSE_MOVEMENT
>     >     #       <x2> STATS_VALUE_TOTAL_CLICK_MOVEMENT
>     >     #       <x3> STATS_VALUE_TOTAL_MOVEMENT_TIME (seconds)
>     >     #       <x4> STATS_VALUE_TOTAL_CLICKS
>     >     #       <x5> STATS_VALUE_TOTAL_KEYSTROKES
>     >
>     >     I hope this helps.
>     >
>     >     --
>     >     With my best regards,
>     >
>     >     Joe Wells


------------------------------------------------------------------------------
_______________________________________________
Workrave-user mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/workrave-user