https://github.com/sideeffects/stats_houdini

Houdini-specific statistics data collection and reporting system, as an add-on to stats-core
https://github.com/sideeffects/stats_houdini

Last synced: 3 days ago
JSON representation

Houdini-specific statistics data collection and reporting system, as an add-on to stats-core

• Host: GitHub
• URL: https://github.com/sideeffects/stats_houdini
• Owner: sideeffects
• License: mit
• Created: 2014-09-12T15:47:33.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2016-03-22T19:31:44.000Z (almost 9 years ago)
• Last Synced: 2024-03-26T09:12:41.752Z (9 months ago)
• Language: Python
• Size: 721 KB
• Stars: 2
• Watchers: 7
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
stats_houdini

=============

The stats_houdini package contains the implementation for a Houdini-specific statistics data collection and reporting system. This package is part of the [Houdini Anonymous Usage  Statistics](http://www.sidefx.com/index.php?option=com_content&task=view&id=2686) project. With this package installed as an add-on of stats_core you will be able to visualize the data in your preferred way, creating your own menus and reports.

**How to extend or modify menus?**

The stats_houdini package comes with a default horizontal menu and a set of already made reports. But you can easily extend or modify the menus and add reports if you want. 

The default menu is divided by report categories based on the information we collect from Houdini. You can extend/modify the default menu layout by changing the configuration of the Ordered Dictionary 'menu_and_report_options' in local_settings.py

The generic structure of the menu_and_report_options Dictionary is:

```python

menu_and_report_options = OrderedDict([

    ("menu_internal_name", {

        "menu_url_prefix": "menu_url",

        "menu_name": "Menu Display Name",

        "menu_image": "menu_image_file_name", # Image to be shown in Home page. 

                                              # This image must be saved first 

                                              # in stats_core/stats_main/static

                                              # /images  

        "menu_description": '''Brief description of the menu and reports in it.''',

        

        # Menu options and reports (below some examples)

        "menu_options": [

            ("option_internal_name", "Option Display Name", [

                "ReportName1",

                "ReportName2",

                ..............

                "ReportNameN",

            ]),

           # ... more menu options with te same format

        ],

        # Which user group can access the reports in the current menu

        "groups": ['staff', 'r&d'],

    }),  

    

  # ... more menus with the same format above ...

])

```

**How to create new reports?**

The package gives you a set of more than 15 already made reports. Each report is implemented as a python class which inherit from one of the two main report generic classes, _ChartReport_ or _HeatMapReport_, which inherit from _Report_. All the generic report classes and functions are implemented in stats_core/stats_main/genericreportclasses.py.

You can check stats_houdini/houdini_stats/reports/houdini.py to see how the existing reports were implemented.