| 1 | = !BluePrint: Chart = |
| 2 | [[TOC]] |
| 3 | |
| 4 | == Introduction == |
| 5 | Charts can be used to quickly and easily visualise data. As Sahana Eden can contain larges amount of informations, Charts can be a valuable tool for presenting this information to Users to support their analysis and decision making. |
| 6 | |
| 7 | == Description == |
| 8 | Types of Charts: |
| 9 | * Line Charts - for quantitate data over time |
| 10 | * Bar Charts - for quantitate data associated with a label |
| 11 | * Pie Charts - for quantitate data associated with a label |
| 12 | |
| 13 | Ideally the Sahana Eden framework would be able to be configured to produce a chart method for any resource. |
| 14 | |
| 15 | == Use-Cases == |
| 16 | === Project Module === |
| 17 | * A Regional Project Manager can use a bar chart to compare the number of projects in different countries and which hazards those projects are addressing to identify needs for new programs (eg. 2 Variable Bar Chart showing the count of projects by Country and Hazard) |
| 18 | * A Project Manager can use a chart to see what types (themes) for projects are being implemented in a specific country for a specific hazard to see if there are best practices to follow or potential for innovation. (eg. 2 Variable Bar Chart showing the count of projects by Hazard Theme filtered by a country ) |
| 19 | * A Project Assistant can use a chart to compare the number of beneficiaries in different communities to ensure that all communities are benefiting equally (eg. 2 Variable Bar Chart showing the sum of Beneficiaries by L4 and Beneficiary Type) |
| 20 | * A Project Manager can use a chart to compare the amount of funding different donors are giving to find out who the major donors are. (eg. 1 Variable Bar Chart showing the sum of Funds Contributed by Organisation filtered for a specific project). They may then want to view this data in tabular form. |
| 21 | * A Project Assistant can use a chart to view the cumulative number of beneficiaries over time for a specific project/location (eg. Line Chart showing the cumulative sum of Beneficiaries over time filtered for a specific project. Multiple Lines could be shown for different Beneficiary Types) |
| 22 | |
| 23 | === Inventory Module === |
| 24 | * A warehouse manager can monitor the stock levels of a specific item in different warehouses to decide if any need to be transferred (eg. 1 Variable Bar Chart showing the quantity of an Item in different warehouses filtered for a specific item) |
| 25 | === Human Resources === |
| 26 | * A Staff Manager can use a chart to compare the number of staff in different offices to get an overview of the size of each operation (eg. 1 Variable Bar Chart showing the count of Staff by different offices) |
| 27 | * A Volunteer Coordinator can can use a chart to find out which communities have gaps in their number of volunteers (eg. 1 Variable Bar Chart showing the count of Volunteers by different communities). They may then want to then view these numbers on a map. |
| 28 | |
| 29 | == Requirements == |
| 30 | Many of these requirements are documented based on the assumption that charts will be implemented with a similar method to the current report method. Some of these requirements could also improve the current implementation of Reports. |
| 31 | * Be able to filter the data which is used to generate the chart using S3Search widgets. |
| 32 | * 2 dimensional Bar Chart |
| 33 | * Pick Row / Column based on result of filter |
| 34 | * Automatically associate the aggregate function based on the type of field used for the value. |
| 35 | * String fields will always be aggregated by Count |
| 36 | * It may be desirable to always aggregate an integer/double by sum to avoid confusing users |
| 37 | |
| 38 | == Design == |
| 39 | TBD |
| 40 | |
| 41 | == Implementation == |
| 42 | === S3Report === |
| 43 | Currently charts can be generated as part fo the [wiki:S3Report]. However as these are not initially displayed, users may over look these. Hopefully the data generated for this Report view can be utilized for the generation of the charts. |
| 44 | |
| 45 | == References == |
| 46 | * BluePrint/Reporting |
| 47 | * [wiki:S3Report] |
| 48 | |
| 49 | ---- |
| 50 | BluePrints |