Extension Basic chart views using Flot Charts


Extension Basics

Title
Basic chart views using Flot Charts
Name
ckanext-basiccharts
Type
Public extension
Description
Add Line, Bar, Pie charts and basic grid views for DataStore resources
CKAN versions

~2.8

Show details
Download-Url (zip)
https://github.com/DataShades/ckanext-basiccharts.git#egg=ckanext-basiccharts
Download-Url commit date
2014-01-01
Url to repo
https://github.com/DataShades/ckanext-basiccharts
Category
Visualization & Analytics


Background Infos

Description (long)
Show details

This extension adds basic chart visualizations to CKAN using Flot Charts library with compatibility for all major browsers including IE6+. Features include: Line chart view for time series and trend visualization, Bar chart view for comparing discrete values, Pie chart view for showing proportional distributions, Basic grid view for tabular data display, filter support to include specific data subsets (multiple filters on same column work as OR, different columns as AND), customizable axes configuration (X and Y for line/bar charts, Y only for pie charts), data grouping capability to separate series by column values with optional legend display, automatic DataStore type detection (text, numeric, timestamp), works with any DataStore data types as long as correctly interpreted, integration with ckanext-viewhelpers for advanced filtering (Key:Value pairs separated by pipes). Charts automatically handle grouped data for pie charts (sums values), and support date-based timelines, numeric comparisons, and text-based categorization. Compatible with CKAN resource views system.

Version
0.1
Version release date
2014-01-01
Contact name
Vitor Baptista
Contakt email
vitor.baptista@okfn.org
Contact Url
(not set)


Installation Guide

Configuration hints

Install the extension:

python setup.py install

Enable chart plugins in your CKAN config file (enable any or all):

ckan.plugins = linechart barchart piechart basicgrid

Restart your webserver after installation.

Chart configuration concepts:

  1. Filters (define what to include):

    • Single filter: State: California
    • Multiple filters same column (OR logic): Date: 01-01-2000, Date: 01-01-2010
    • Multiple filters different columns (AND logic): State: California AND (Date: 01-01-2000 OR Date: 01-01-2010)
    • See ckanext-viewhelpers for more filtering options

  2. Axes (define what column to plot):

    • Line/Bar charts: Y axis and X axis
    • Pie charts: Y axis only
    • Works with all DataStore column types (numeric, text, timestamp)
    • Check DataStore Upload log in Manage resource -> DataStore tab to verify types

  3. Groups (organize data by column):

    • Optional for line/bar charts, required for pie charts
    • Example: Group by State to separate California and New York populations
    • Enable ‘Show groups’ legend’ for line/bar charts to display group legend
    • Pie charts automatically show embedded legends
    • Pie charts sum all values for each group

Known limitations: - Side-by-side bars not yet supported (bars may overlap when grouped) - No stacked bar chart functionality - Filters support inclusion only (no exclusion/negation)

Chart views appear as options in the view type list for DataStore resources.

Requires DataStore to be properly configured and resource data uploaded to DataStore.

Plugins to configure (ckan.ini)
linechart barchart piechart basicgrid
CKAN Settings (ckan.ini)
(not set)
DB migration to be executed
(not set)
<< back to Extensions