Metadata-Version: 1.0
Name: eea.daviz
Version: 6.0
Summary: EEA DaViz is a plone product which uses Exhibit and Google Charts API to easily create data visualizations based on data from csv/tsv, JSON, SPARQL endpoints and more.
Home-page: https://eea.github.com/docs/eea.daviz
Author: Alin Voinea (Eau de Web)
Author-email: alin@eaudeweb.ro
License: GPL
Download-URL: http://pypi.python.org/pypi/eea.daviz
Description: =========
        EEA Daviz
        =========
        
        |DaViz logo|
        
        Introduction
        ============
        
        `EEA Daviz`_ is a web tool developed by the European Environment Agency which
        helps creating interactive data visualizations easily through the web
        browser, no extra tools are necessary. It is free and open source.
        
        You can generate attractive and interactive charts and combine them in a
        dashboard with facets/filters which updates the charts simultaneously.
        Data can be uploaded as CSV/TSV or you can specify SPARQL to query
        online Linked open data servers (aka sparql endpoints).
        
          **Daviz is the first Semantic web data visualisation tool for Plone CMS,
          entirely web-based!**
        
        At the moment `Simile Exhibit`_ and `Google Charts`_ visualizations are
        supported. The architecture allows to extend Daviz with more
        visualisation libraries (visualisations plugins).
        
        .. contents::
        
        Main features
        =============
        
        |Daviz features diagram|
        
        1. No desktop tools needed to make visualizations. all web based.
        2. Data input: easy copy and paste of data table from any webpage or
           excel sheet
        3. Data input: drag-and-drop your data from CSV/TSV files, and we do the rest
        4. Data input advanced: retrieve data from any SPARQL endpoint on the fly
        5. Intuitive visualization editor to create interactive charts.
        6. Large amount of visualizations available: Area, Bar,
           Bubble, Candlestick, Column, Combo Chart, Gauge, Geo Intensity Maps,
           Line, Pie, Radar, Scatter, Stepped Area, Table, Tree Map, Motion Charts,
           Faceted search table, Faceted tiles, Faceted timeline,
           Faceted map and more...
        7. Dashboard. Group charts into one dashboard.
        8. Share any chart. Embeddable visualization in any webpage.
        9. Customizable chart options and colors
        10. Data table manipulation via drag and drop, preparing table for chart
        11. Pivot table (Transpose), transform row values into columns
        12. Modular framework for extending it with more visualizations
        13. And much more...
        
        
        It is simple to use, needs no desktop application, everything is done
        through the web by uploading an "excel file", CSV, TSV. You can also query
        the "web of data" via public available sparql endpoints.
        
        You can easily make visualizations like:
        
        1. `Simile Exhibit <http://www.simile-widgets.org/exhibit>`_
        2. `Google Charts <http://code.google.com/apis/chart>`_
        
        See also initial project `wiki page <https://svn.eionet.europa.eu/projects/Zope/wiki/DaViz>`_
        for the reasoning behind this project.
        
        
        Live demos
        ==========
        
        * `Eurostat data employment rates 2000-2010 (demo using Linked Data) <http://www.eea.europa.eu/data-and-maps/daviz/data-visualization-employement-trends-eu-1>`_
        * `GHG vs GDP in Europe 1990 - 2009 (demo using Linked Data) <http://www.eea.europa.eu/data-and-maps/daviz/ghg-vs-gdp-in-europe>`_
        * `GHG national emissions reporting to UNFCC (Simile Exhibit demo with TSV) <http://www.eea.europa.eu/data-and-maps/data/national-emissions-reported-to-the-unfccc-and-to-the-eu-greenhouse-gas-monitoring-mechanism-3/national-total-excluding-lulucf/ghg_v10_extract.csv>`_
        * `Google charts demos <http://code.google.com/apis/chart>`_
        * `MIT Simile Exhibit demos <http://www.simile-widgets.org/exhibit>`_
        
        
        Architecture overview
        =====================
        
        At the moment `Simile Exhibit`_ and `Google Charts`_ visualizations are
        supported. The architecture allows to extend Daviz with more
        visualisation libraries (visualisations plugins).
        
        .. image:: http://eea.github.com/_images/eea.daviz.layers.svg
        
        
        Installation
        ============
        
        zc.buildout
        ~~~~~~~~~~~
        If you are using `zc.buildout`_ and the `plone.recipe.zope2instance`_
        recipe to manage your project, you can do this:
        
        * Update your buildout.cfg file:
        
          * Add ``eea.daviz`` to the list of eggs to install
          * Tell the plone.recipe.zope2instance recipe to install a ZCML slug
        
          ::
        
            [instance]
            ...
            eggs =
              ...
              eea.daviz
        
            zcml =
              ...
              eea.daviz
        
        * Re-run buildout, e.g. with::
        
          $ ./bin/buildout
        
        You can skip the ZCML slug if you are going to explicitly include the package
        from another package's configure.zcml file.
        
        
        Google Maps API Key
        ~~~~~~~~~~~~~~~~~~~
        
        Plone
        +++++
        Within ZMI -> Plone Site -> portal_properties add a plone property sheet called
        geographical_properties and inside it add a new string property
        called google_key.
        
        Zope
        ++++
        Within ZMI -> Top Folder -> manage_propertiesForm add a string property called
        google_key
        
        In this property you have to paste the Google maps API KEY, follow instruction
        https://developers.google.com/maps/documentation/javascript/v2/introduction#Obtaining_Key
        
        The Google account you use to generate the key has to be owner of the site,
        this is done by verification via Google webmaster tools.
        
        
        Dependencies
        ============
        
        `EEA Daviz`_ has the following dependencies:
          - `Plone 4.x`_
          - `eea.app.visualization`_
          - `eea.sparql`_
          - `eea.forms`_
          - `eea.googlecharts`_
          - `eea.exhibit`_
        
        The following package are optional. Still they can improve the user experience with this tool:
          - `eea.relations`_
          - `eea.cache`_ (Check `eea.cache`_ documentation for more about
            memcache configuration)
          - `eea.depiction`_
        
          ::
        
            [instance]
            ...
            eggs =
              ...
              eea.daviz [full]
        
            zcml =
              ...
              eea.daviz-overrides
              eea.daviz-full
        
        
        .. image:: http://eea.github.com/_images/eea.daviz.dependencies.svg
        
        
        Source code
        ===========
        
        Latest source code (Plone 4 compatible):
          - `Plone Collective on Github <https://github.com/collective/eea.daviz>`_
          - `EEA on Github <https://github.com/eea/eea.daviz>`_
        
        Plone 2 and 3 compatible (Simile Exhibit visualisations only):
          https://svn.eionet.europa.eu/repositories/Zope/trunk/eea.daviz/branches/plone25
        
        
        Copyright and license
        =====================
        
        The Initial Owner of the Original Code is European Environment Agency (EEA).
        All Rights Reserved.
        
        The EEA Daviz (the Original Code) is free software;
        you can redistribute it and/or modify it under the terms of the GNU
        General Public License as published by the Free Software Foundation;
        either version 2 of the License, or (at your option) any later
        version.
        
        More details under eea.daviz/docs/License.txt
        
        
        More documentation
        ==================
        
        -  `Daviz technical documentation on
           github <http://eea.github.com/docs/eea.daviz>`_
        -  `Daviz plone product summary <http://plone.org/products/eea.daviz>`_
        -  `Data input
           examples <http://www.eea.europa.eu/data-and-maps/daviz/learn-more/examples>`_
        -  `How to prepare your
           data <http://www.eea.europa.eu/data-and-maps/daviz/learn-more/prepare-data>`_
        
        
        Links
        =====
        
        1. Simile Wiki - Exhibit 2.0: http://simile.mit.edu/wiki/Exhibit
        2. Simile widgets: http://www.simile-widgets.org/exhibit
        3. EEA Daviz how-to: https://svn.eionet.europa.eu/projects/Zope/wiki/HowToDaviz
        4. EEA Daviz backlog wiki: https://svn.eionet.europa.eu/projects/Zope/wiki/DaViz
        5. Google charts: http://code.google.com/apis/chart/
        
        
        Funding and project management
        ==============================
        
        EEA_ - European Environment Agency (EU)
        
        .. _EEA: http://www.eea.europa.eu/
        .. _`EEA Daviz`: http://eea.github.com/docs/eea.daviz
        .. _`EEA Google Charts`: http://eea.github.com/docs/eea.googlecharts
        .. _`EEA Exhibit`: http://eea.github.com/docs/eea.exhibit
        .. _`eea.daviz`: http://eea.github.com/docs/eea.daviz
        .. _`eea.depiction`: http://eea.github.com/docs/eea.depiction
        .. _`eea.googlecharts`: http://eea.github.com/docs/eea.googlecharts
        .. _`eea.exhibit`: http://eea.github.com/docs/eea.exhibit
        .. _`eea.app.visualization`: http://eea.github.com/docs/eea.app.visualization
        .. _`eea.sparql`: http://eea.github.com/docs/eea.sparql
        .. _`eea.cache`: http://eea.github.com/docs/eea.cache
        .. _`eea.forms`: http://eea.github.com/docs/eea.forms
        .. _`eea.relations`: http://eea.github.com/docs/eea.relations
        .. _`plone.recipe.zope2instance`: http://pypi.python.org/pypi/plone.recipe.zope2instance
        .. _`EEA App Visualization`: http://eea.github.com/docs/eea.app.visualization
        .. _`Simile Exhibit`: http://www.simile-widgets.org/exhibit
        .. _`Google Charts`: http://code.google.com/apis/chart
        .. _`plone.recipe.zope2instance`: http://pypi.python.org/pypi/plone.recipe.zope2instance
        .. _`zc.buildout`: http://pypi.python.org/pypi/zc.buildout
        .. |Daviz features diagram| image:: http://daviz.eionet.europa.eu/learn-more/davizdiagram.png/@@images/2d254f67-9af2-476c-be4c-8f1a5e602627.png
        .. |DaViz logo| image:: http://daviz.eionet.europa.eu/logo.png
        .. _`Plone 4.x`: http://plone.org
        
        Changelog
        =========
        
        6.0 - (2012-10-08)
        ------------------
        * Upgrade step: ZMI > portal_setup > profile "EEA Daviz" > import Action Providers settings
        * Feature: Added Visualization data source provenance adapter for
          DavizVisualization objects
          [voineali refs #5490]
        * Feature: On "Create Visualization" create the visualization and redirect to
          "Edit visualization" tab
          [szabozo0 refs #5449]
        * Feature: Use portal_daviz utility for default folder settings
          [szabozo0 refs #5449]
        * Change: Added daviz.json adapter for IDavizVisualization content-type
          [voineali refs #5449]
        * Change: Added IVisualizationData adapter for DavizVisualization content-type
          [voineali refs #5511]
        
        4.9 - (2012-08-10)
        ------------------
        * Upgrade step: Within "Plone > Site setup > Add-ons" click on
          upgrade button available for eea.daviz
          [szabozo0 refs #5347]
        * Bugfix: Fixed columns order
          [szabozo0 refs #5137]
        * Feature: Added new action on data visualization "Create another visualization";
          Added action on Sparql "Create visualization with this dataset";
          Added action on all object which provides IVisualizationEnabled "Create another visualization"
          [szabozo0 refs #5347]
        * Feature: use title of data source as default title for visualisation
          [szabozo0 refs #5138]
        
        4.8 - (2012-07-13)
        ------------------
        * Change: updated readme with info about google map API KEY configuration.
          [demarant refs #5338]
        
        4.7 - (2012-07-04)
        ------------------
        * Bug fix: Fixed possible_relations.xml when used togheter with eea.relations
          on a non-EEA Plone site
          [voineali refs #5330]
        
        4.6 - (2012-06-12)
        ------------------
        * Bug fix: fixed markup of HISTORY.txt file
          [ciobabog refs #5231]
        * Feature: Warn user about changing data risks
          [voineali fixes #4973]
        * Feature: Added @@data.info adapter for DavizVisualization content-type in order
          to easily get data source and data owner metadata
          [voineali refs #5072]
        
        4.5 - (2012-04-26)
        ------------------
        * Feature: Possibility to add data provenance/source information when one
          copy&paste data tables or upload them via QuickUpload Widget
          [voineali refs #5072]
        
        4.4 - (2012-03-30)
        ------------------
        * Feature: added documentation and links on how to examples and
          how prepare data for visualizations.
          [demarant #4995]
        * Change: added default workflow mapping for daviz visualization.
          [demarant #5002]
          Upgrade step: if you have already been using daviz visualization
          you would need to migrate the instances to the new workflow states.
          Plone > Site setup > Types > choose Daviz Visualization and
          the new worklow to folder_workflow. Define the states mapping as
          you prefer.
        * Upgrade step: Within "Plone > Site setup > Add-ons" click on
          upgrade button available for eea.daviz
        * Feature: Updated Daviz Visualization fields help to provide examples and
          tutorials
          [voineali #4995]
        * Change: do not show duplicates of sparql and json data when adding existing
          data. show only last version. Upgrade step (not needed for EEA production):
          ZMI > portal_setup > profile "EEA Daviz" > import Possible relations settings
          [demarant #5003]
        * Feature: Refactoring to be able to use eea.googlecharts or eea.exhibit as
          standalone packages or as part of eea.daviz visualization bundle.
          [voineali #4996]
        
        4.3 - (2012-03-05)
        ------------------
        * Bug fix: restricted data sources relations to exhibit json or sparql queries.
          Upgrade step:
          ZMI > portal_setup > profile "EEA Daviz" > import Possible relations settings
          [demarant #4919]
        * Change: The new UI expects eea.googlecharts and eea.sparql, therefore they are
          now an integral part of this product and declared as dependencies.
          [demarant]
        * Change: Renamed DavizPresentation to DavizVisualization.
          [demarant]
        * Change: removed label widget for data input, no need for it,
          we have already many headings.
          [demarant]
        * Change: Re-group DavizPresentation AT Schema
          [voineali #4980]
        * Change: Reordered the data input fields. Most common scenarion on top.
          rephrasing.
          [demarant #4980]
        * Upgrade step: Within "Plone > Site setup > Add-ons" click on
          upgrade button available for eea.daviz
          [voineali]
        * Fixed: Support case insensitive column types in CSV files
          [voineali #4975]
        * Feature: Also support CSV or any other SV file by auto-detecting dialect
          [voineali #4977]
        * Feature: Added SpreadSheet field to DavizPresentation Schema in order
          to easily copy & paste TAB separated text as data source
          [voineali #4967]
        * Feature: Added QuickUpload field to DavizPresentation Schema in order
          to easily upload new TAB separated files as data sources
          [voineali #4965]
        * Change: changed texts for visualizations, changed Data Sources to be mandatory
          [szabozo0 #4948]
        * Bug fix: properly link images in css files
          [tiberich #4956]
        * Change: corrected daviz presentation description
          [demarant]
        
        4.2 - (2012-02-06)
        ------------------
        * no changes
        
        4.1 - (2012-02-06)
        ------------------
        * Upgrade step: Within "Plone > Site setup > Add-ons" click on
          upgrade button available for eea.daviz
          [voineali #4866]
        * Feature: Moved facets in global settings tab in order to have more space
          for views configuration
          [voineali #4914]
        * Feature: Added a CSS class on section tabs
          [voineali #4880]
        * Feature: Redirects to daviz-edit if there is no DaViz view/chart configured
          [voineali #4882]
        * Feature: Added a way to register additional charts as tabs in view mode.
          [voineali #4873]
        * Feature: Added DavizPresentation content-type in order to easy aggregate
          internal and external exhibit sources
          [voineali #4866]
        
        4.0 - (2011-11-07)
        ------------------
        * Feature: Added upgrade steps
          [voineali #4392]
        * Feature: Plone 4.x compatible
          [ichimdav, voineali #4234]
        * Feature: Added exhibit 'properties' dict in generated JSON
          [voineali 4528]
        
        1.5 - (2011-09-21)
        ------------------
        * Feature: Added exhibit 'properties' dict in generated JSON
          [voineali 4528]
        
        1.4 - (2011-09-07)
        ------------------
        * Feature: Enabled daviz for eea.dataservice EEAFigureFile
          [voineali #4492]
        
        1.3 - (2011-07-29)
        ------------------
        * Feature: Added babel translator API and a custom translator:
          rdf-xml to exhibit-json
          [voineali #4416]
        * Feature: Possibility to add external exhibit data sources like
          "Google Spreadsheet", "RDF/XML" and "External JSON".
          [voineali #4416]
        * Feature: Added editable 'Lens' property to Tiles view in order
          to easily create custom Exhibit Lens Templates
          [voineali #4414]
        * Feature: Added a way to reorder Exhibit Views
          [voineali #4177]
        * Feature: Added a way to reorder or hide Exhibit Facets
          [voineali #4417]
        * Feature: Possibility to add/remove facets
          [voineali #4416]
        * Feature: Made Exibit edit page more user friendly (WYSIWYG)
          [voineali #4417]
        * Feature: JSON Converter handles column types if specified in CSV columns
          header (ex: Title:lable, Year:date, etc)
          [voineali #4414]
        * Feature: Added 'Details' column for 'Tabular View'. This can be
          enabled/disabled in 'Tabular View' settings.
          [voineali #4419]
        
        1.2 - (2011-04-07)
        ------------------
        * Feature: Added edit form for generated JSON
          [voineali #4199]
        * Feature: If column name contains ":list" exported data in JSON will pe an array
          [ghicaale #4199]
        * Bug fix: Made exibit available for ATBlob files
          [voineali #4135]
        * Cleanup: of pyflakes warnings
          [ichimdav #4141]
        * Cleanup: of sensible pylint violations
          [ichimdav #4140]
        * Feature: Added live search field as default on top
          [demarant, #3023]
        * Change: Moved facets to the right
          [demarant]
        * Bug fix: Fixed Google Map Key alert
          [voineali #4196]
        * Change: Disabled Thumbnails View as it's bugous on IE
          [voineali #4196]
        
        1.1 - (2011-03-16)
        ------------------
        *  Bug fix: Removed jQuery and jQuery UI from daviz-edit.css, daviz-edit.js
           as they generate errors if already installed. You'll have to manually
           install jQuery and jQuery UI in portal_css and portal_javascripts
           [voineali #4196]
        
        1.0 - (2011-03-16)
        ------------------
        * Initial release
          [voineali #2773]
        
        
Keywords: eea daviz data visualization exhibit googlechartssparql rdf zope plone
Platform: UNKNOWN
Classifier: Framework :: Zope2
Classifier: Framework :: Zope3
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.0
Classifier: Framework :: Plone :: 4.1
Classifier: Framework :: Plone :: 4.2
Classifier: Programming Language :: Zope
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: License :: OSI Approved :: Mozilla Public License 1.0 (MPL)
