edits
[tools.git] / index.md
blob:a/index.md -> blob:b/index.md
Below is a whole bunch of information to help you prepare hackfest entries. These tools can be used to make entries like: mobile apps, web apps, data visualisations/inforgraphics - tools.disclo.gs - how to use data
  - developer tools inc. linked data
govhack library - gephi -> neo4j
  - neo4j lets you build on, do massive queries of who is friends with who
- http://hpneo.github.com/gmaps/examples.html -
- android datviz - postgis/quantum gis
- http://code.google.com/p/afreechart/ http://code.google.com/p/snowdon/ http://code.google.com/p/chartdroid/ http://androidplot.com/ http://code.google.com/p/achartengine/ - (google earth is alright but many limitations) NASA World Wind?
- https://graphics.stanford.edu/wikis/cs448b-12-fall/ data viz theory - ABS statistical areas
- https://mixpanel.com/education/understanding-the-first-five-minutes  
- http://drawingbynumbers.org/toolsandresources - scraperwiki with new pytemplate libraries
- http://wmbriggs.com/blog/?p=6465 - makes an API for your data to get in sqlite/json/csv
- http://ofps.oreilly.com/titles/9781449339739/k_00000002.html list of d3 alternatives  
- http://craigkerstiens.com/2012/10/01/understanding-postgres-performance/ - govhack library
- https://github.com/clips/pattern for easy NLP/network analysis/data mining - https://graphics.stanford.edu/wikis/cs448b-12-fall/ data viz theory
- https://github.com/theodi/open-data-tech-review/wiki othr cleanup/linked data toola - http://drawingbynumbers.org/toolsandresources
- http://www.opentripplanner.org/apidoc/rest.plan.html - http://wmbriggs.com/blog/?p=6465
- http://selection.datavisualization.ch/ data viz tools catalog - http://ofps.oreilly.com/titles/9781449339739/k_00000002.html list of d3 alternatives
- http://www.slideshare.net/OReillyStrata/visualizing-networks-beyond-the-hairball - http://craigkerstiens.com/2012/10/01/understanding-postgres-performance/
- http://blog.sciencenet.cn/blog-554179-622011.html SNA tools catalog - https://github.com/clips/pattern for easy NLP/network analysis/data mining
- https://github.com/jacomyal/osdc2012-sigmajs-demo sigmajs filtering/searching - https://github.com/theodi/open-data-tech-review/wiki othr cleanup/linked data toola
- manipulating data - grep/find replace/sed/regex - http://selection.datavisualization.ch/ data viz tools catalog
- d3 tools and tutorial http://enjalot.com/ http://news.ycombinator.com/item?id=4608440 - manipulating data - grep/find replace/sed/regex
- Why d3 is the way it is and how to make charts http://bost.ocks.org/mike/chart/  
- how to make an xkcd chart http://bl.ocks.org/3914862 - data viz
- http://blog.josephwilk.net/ruby/latent-semantic-analysis-in-ruby.html similar terms usually found together - http://k2company.com/blog/2012/09/06/toolbox-for-learning-machine-learning-and-data-science/
- data viz - http://williamparry.blogspot.com.au/2011/04/putting-data-into-google-fusion-tables.html google fusion tutorial
- http://k2company.com/blog/2012/09/06/toolbox-for-learning-machine-learning-and-data-science/  
- http://williamparry.blogspot.com.au/2011/04/putting-data-into-google-fusion-tables.html google fusion tutorial - http://www.slideshare.net/maxdemarzi/etl-into-neo4j
- andrewharvey4.wordpress.com postgis/asgs tutorial  
- http://www.slideshare.net/maxdemarzi/etl-into-neo4j  
- http://www.twotorials.com/ for R - http://dydra.com/
- http://www.r-bloggers.com/gradient-word-clouds/ http://www.rstudio.com/shiny/ http://blog.ouseful.info/2012/11/28/quick-shiny-demo-exploring-nhs-winter-sit-rep-data/ https://github.com/timelyportfolio/shiny-d3-plot https://github.com/trestletech/shiny-sandbox/tree/master/grn - http://selection.datavisualization.ch/ data viz tools list
- http://is-r.tumblr.com/post/38240018815/making-prettier-network-graphs-with-sna-and-igraph - http://nodexl.codeplex.com/ network graphs for excel
- http://www.r-bloggers.com/video-simpler-tricks-and-tools-help-debugging-git-latex-and-workflow-with-r-by-prof-rob-hyndman/ - http://sunfoundation.tumblr.com/
- http://yihui.name/knitr/ makes reports including google widgets/charts/maps via http://www.r-bloggers.com/googlevis-0-3-2-is-released-better-integration-with-knitr/ - analysing - linked data tools
- http://chartsnthings.tumblr.com/post/36978271916/r-tutorial-simple-charts http://flowingdata.com/2012/12/17/getting-started-with-charts-in-r/ - http://govcampau.wikispaces.com/useful+tools
- http://dydra.com/ - http://linkeddata.org/home
- http://selection.datavisualization.ch/ data viz tools list  
- http://nodexl.codeplex.com/ network graphs for excel  
- http://sunfoundation.tumblr.com/ Welcome to the GovHack toolkit. This page provides all the information you need to prepare hackfest entries.
- css framework like bootstrap or zurb foundation These tools can be used to make entries like: mobile apps, web apps, data visualisations/infographics
- analysing - linked data tools  
- http://govcampau.wikispaces.com/useful+tools  
- http://linkeddata.org/home # General Data Hacking and Programming References {#general-data-hacking-and-programming-references}
- analysing - unstructured/nlp incl overviewer, opennlp/nltk, lucene/solr ## The basics of being a data scientist
- http://www.r-bloggers.com/simple-text-mining-with-r/  
  * Have a hypothesis � even if you’re making a tool/api that helps people with their questions too, remember what the objective of that is.
# Hosted Developer Tools {#hosted-developer-tools} * Find the people and tools you need to prove/show/find. This rest of this page will help with the latter.
  * Analyse and present results � were they what you expected? Do they help explain to others what you have found out? Can present as a interactive data visualisation or a web/mobile application or just a infographic/motion graphics video that tells a story.
  Please note, there are a combination of Analysis and Visualisation tools in each of the major categories below.
   
   
  [![](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_m6a65720f-300x199.gif "Data Journalism Diagram")](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_m6a65720f.gif)</dt>
  Illustration from Data Journalism Handbook, CC BY-SA 3.0</dd>
   
   
  The best high level reference is the �Understanding Data� and �Delivering Data� chapters of the Data Journalism Handbook which is available online for free at
   
  [datajournalismhandbook.org](http://datajournalismhandbook.org/)
   
  You can learn the technical skills from scratch in Visualize This: The FlowingData Guide to Design, Visualization, and Statistics by Nathan Yau or for more advanced
   
  practical advice check out Data Analysis with Open Source Tools by Philipp K. Janert
   
  For further reading in this space
   
  [http://flowingdata.com/2012/04/27/data-and-visualization-blogs-worth-following/](http://flowingdata.com/2012/04/27/data-and-visualization-blogs-worth-following/)
   
   
   
  **Statistics**
   
  [http://greenteapress.com/thinkstats/html/index.html](http://greenteapress.com/thinkstats/html/index.html)
   
  **Programming**
   
  Programming is valuable skill for manipulating and displaying data.
   
  Basic tutorials for a variety of languages are available for free online or you can learn
   
  interactively with websites like [http://www.codecademy.com/](http://www.codecademy.com/#!/exercises/0\. for JavaScript or [http://www.learnpython.org/ ](http://www.learnpython.org/)or [http://tryruby.org](http://tryruby.org/)
   
  [https://developer.mozilla.org/en/JavaScript](https://developer.mozilla.org/en/JavaScript) &#8211\. especially for web applications and visualisations, you&#8217;ll need a basic understanding of JS. Common libraries like prototype or jQuery can help
   
  **Accessibility/User Experience**
   
  WCAG guidelines not only make a web app accessible but make it a better experience for all users! Even if not making an app, good to consider these things to do and not do: [http://www.w3.org/TR/WCAG/](http://www.w3.org/TR/WCAG/)
   
  ## Who can be a hack day participant
  - roles; coder, designer UX/graphics
   
  ## Definitions
  - definitions, open licence reuse permissive hacker hack data journalism data bis UCX etc.
   
   
  ## key datasets
  - key datasets, directory.gov.au gazetter/AEC electorates/suburbs/postcodes/LGAs
   
  ## examples
   
  ## The Open Budget
   
  ## WeatherTree weather API
   
  ## PlanningAlerts
   
  [![Planning Alerts Screenshot](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_2f0199ff1-300x221.png "Planning Alerts Screenshot")](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_2f0199ff1.png)Description: Planning Alerts takes data from local government development applications and sends alerts to users based on what applications are lodged in their area.
   
  Programming Language: Ruby
   
  Source Control: [Git](https://github.com/openaustralia/planningalerts-app)
   
  Issue Tracking: [Atlassian JIRA](http://tickets.openaustraliafoundation.org.au/browse/PA/)
   
  ## LobbyLens
   
  [![](http://www.govhack.org/wp-content/uploads/129-Screenshot-LobbyClue_-_Chromium-300x180.png "LobbyLens screenshot")](http://www.govhack.org/wp-content/uploads/129-Screenshot-LobbyClue_-_Chromium.png)
   
  Description: Displays connections between government contracts, business details, politician responsibilities, lobbyists, clients of lobbyists, political donors and the location of these entities.
   
  Programing Language: PHP
   
  Source Control: SVN (Subversion)
   
  Issue Tracking: A whiteboard
   
  ## Bus.lambdacomplex.org
   
  [![](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_3789acae-300x253.jpg "Bus.lambda screenshot")](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_3789acae.jpg)
   
  Description: Online Canberra Bus Timetables and Trip Planner.
   
  Programing Language: PHP/Ruby
   
  Source Control: Git
   
  Issue Tracking: Github
   
   
  ## Developer Tools For Your Computer {#developer-tools-for-your-computer}
   
  server admin / technical tools
  many projects will require some kind of internet presence, webpage etc.
  - css framework like bootstrap or zurb foundation
  video tools, youtube video editor/slideshow, FOSS video editing tools
  - http://ubuntu-tutorials.com/2008/11/11/relaying-postfix-smtp-via-smtpgmailcom/
  - amon
   
  ### Source Control &#8211\. Git / Subversion
   
  [![](http://www.govhack.org/wp-content/uploads/Screenshot-at-2012-04-29-172132-300x235.png "Git Screenshot")](http://progit.org/book/)
   
  [http://progit.org/book/](http://progit.org/book/)
   
  [http://svnbook.red-bean.com/](http://svnbook.red-bean.com/)
   
  [http://tortoisesvn.net/](http://tortoisesvn.net/)
   
  [http://code.google.com/p/tortoisegit/](http://code.google.com/p/tortoisegit/)
   
  ### Task Tracking -
   
  Issue/task trackers allow you to outline the tasks required for your project and assign them to people to do.
   
  [Trello](https://trello.com/) and [Workflowy](https://workflowy.com/) are free, lightweight project management tools suitable for a rapid project!
   
  ## Hosted Developer Tools {#hosted-developer-tools}
   
  Can get many tools (source control, issue tracking) combined into one service cloud hosted so no setup required.
   
  ### Github
  Git obviously but svn/hg interfaces are possible. Provide their own GUI for Windows/OSX or use the variety of Git capable tools
   
### Sourceforge ### Sourceforge
   
Subversion, Git, Mercurial, Bazaar, CVS, issue tracker, wiki, release file downloads. Unlimited free use for open source projects. Subversion, Git, Mercurial, Bazaar, CVS, issue tracker, wiki, release file downloads. Unlimited free use for open source projects.
   
You can create your own Sourceforge project at [http://sourceforge.net/](http://sourceforge.net/) You can create your own Sourceforge project at [http://sourceforge.net/](http://sourceforge.net/)
   
### Google Code Project Hosting ### Google Code Project Hosting
   
Git, Mercurial, and Subversion code. Issue tracker, wiki, release file downloads. Unlimited free use for open source projects. Git, Mercurial, and Subversion code. Issue tracker, wiki, release file downloads. Unlimited free use for open source projects.
   
You can host your Google Code project and get access to developer tools, APIs and documentation at [http://code.google.com/](http://code.google.com/) You can host your Google Code project and get access to developer tools, APIs and documentation at [http://code.google.com/](http://code.google.com/)
   
   
   
# The basics of being a data scientist  
   
 
* Find the people and tools you need to prove/show/find. This rest of this page will help with the latter.  
 
Please note, there are a combination of Analysis and Visualisation tools in each of the major categories below.  
   
# API Development {#api-development} # API Development {#api-development}
   
   
So an API isn&#8217;t just an XML file ![;)](http://www.govhack.org/wp-includes/images/smilies/icon_wink.gif) So an API isn&#8217;t just an XML file ![;)](http://www.govhack.org/wp-includes/images/smilies/icon_wink.gif)
   
A good web based data API: A good web based data API:
   
* Is logically organised * Is logically organised
* Can filter returned data * Can filter returned data
* Can return results in different open formats (CSV/JSON etc.) * Can return results in different open formats (CSV/JSON etc.)
* Is efficient and responsive by using caching and databases appropriately * Is efficient and responsive by using caching and databases appropriately
* Handles errors gracefully * Handles errors gracefully
* Monitors and controls access (to show benefit realised of API and prevent abuse) * Monitors and controls access (to show benefit realised of API and prevent abuse)
* Provides appropriate documentation with examples * Provides appropriate documentation with examples
   
Some people like sensis [http://](http://developers.sensis.com.au/)[developers.sensis.com.<wbr>au</wbr>](http://developers.sensis.com.au/)[/](http://developers.sensis.com.au/) use a provider like[http://](http://mashery.com/)[mashery.com](http://mashery.com/)[/](http://mashery.com/) or [https](https://apigee.com/)[://](https://apigee.com/)[apigee.com](https://apigee.com/) or [http://](http://apiaxle.com/)[apiaxle.com](http://apiaxle.com/)[/](http://apiaxle.com/) or [http://www.3scale.net/](http://www.3scale.net/) which handles making a good API for them. Some people like sensis [http://](http://developers.sensis.com.au/)[developers.sensis.com.<wbr>au</wbr>](http://developers.sensis.com.au/)[/](http://developers.sensis.com.au/) use a provider like[http://](http://mashery.com/)[mashery.com](http://mashery.com/)[/](http://mashery.com/) or [https](https://apigee.com/)[://](https://apigee.com/)[apigee.com](https://apigee.com/) or [http://](http://apiaxle.com/)[apiaxle.com](http://apiaxle.com/)[/](http://apiaxle.com/) or [http://www.3scale.net/](http://www.3scale.net/) which handles making a good API for them.
   
Atlassian have a great page on what makes a good API [https](https://developer.atlassian.com/display/REST/Atlassian+REST+API+Design+Guidelines+version+1)[://](https://developer.atlassian.com/display/REST/Atlassian+REST+API+Design+Guidelines+version+1)[developer.atlassian.<wbr>com</wbr>](https://developer.atlassian.com/display/REST/Atlassian+REST+API+Design+Guidelines+version+1)[/display/REST/](https://developer.atlassian.com/display/REST/Atlassian+REST+API+Design+Guidelines+version+1)[Atlassian](https://developer.atlassian.com/display/REST/Atlassian+REST+API+Design+Guidelines+version+1)[+<wbr>REST+API+Design+Guidelines+<wbr>version+1</wbr></wbr>](https://developer.atlassian.com/display/REST/Atlassian+REST+API+Design+Guidelines+version+1) Atlassian have a great page on what makes a good API [https](https://developer.atlassian.com/display/REST/Atlassian+REST+API+Design+Guidelines+version+1)[://](https://developer.atlassian.com/display/REST/Atlassian+REST+API+Design+Guidelines+version+1)[developer.atlassian.<wbr>com</wbr>](https://developer.atlassian.com/display/REST/Atlassian+REST+API+Design+Guidelines+version+1)[/display/REST/](https://developer.atlassian.com/display/REST/Atlassian+REST+API+Design+Guidelines+version+1)[Atlassian](https://developer.atlassian.com/display/REST/Atlassian+REST+API+Design+Guidelines+version+1)[+<wbr>REST+API+Design+Guidelines+<wbr>version+1</wbr></wbr>](https://developer.atlassian.com/display/REST/Atlassian+REST+API+Design+Guidelines+version+1)
   
  API
  - howto.gov api tutorial
  - http://shancarter.com/data_converter/
  - http://training.sunlightfoundation.com/module/data-visualizations-google-docs/
# Data Visualisation {#data-visualisation} - api documentation
  - WSDL or http://swagger.wordnik.com/ or https://github.com/mashery/iodocs
  - http://symfony.com/ https://github.com/FriendsOfSymfony/FOSRestBundle http://williamdurand.fr/2012/08/02/rest-apis-with-symfony2-the-right-way/ https://github.com/nelmio/NelmioApiDocBundle better apis https://github.com/liip/LiipHelloBundle
  - https://github.com/elc/rapi_doc https://github.com/Pajk/apipie-rails
  -
  http://amberonrails.com/building-stripes-api/
   
   
  # Infographics and Data Visualisation {#data-visualisation}
   
  Infographics try to contextualise charts and graphs to tell a story. Data vis builds on this to find new ways to design insight.
   
Most of the categories to follow have visualisation tools specific to their purpose. Most of the categories to follow have visualisation tools specific to their purpose.
   
You can find some data visualisation &#8220;essential&#8221\. tools below: You can find some data visualisation &#8220;essential&#8221\. tools below:
   
[http://www.visualisingdata.com/index.php/2011/07/part-6-the-essential-collection-of-visualisation-resources/](http://www.visualisingdata.com/index.php/2011/07/part-6-the-essential-collection-of-visualisation-resources/) [http://www.visualisingdata.com/index.php/2011/07/part-6-the-essential-collection-of-visualisation-resources/](http://www.visualisingdata.com/index.php/2011/07/part-6-the-essential-collection-of-visualisation-resources/)
   
Also check out [http://thejit.org](http://thejit.org/) &amp; [http://www.senchalabs.org/<wbr>philogl/</wbr>](http://www.senchalabs.org/philogl/) (contributed by Matt Adcock) Also check out [http://thejit.org](http://thejit.org/) &amp; [http://www.senchalabs.org/<wbr>philogl/</wbr>](http://www.senchalabs.org/philogl/) (contributed by Matt Adcock)
   
  Have to use visual art concepts, good color schemes http://www.r-bloggers.com/the-paul-tol-21-color-salute/
   
# Augmented Reality Tools {#augmented-reality-tools} # Mobile
  html5 jquery mobile like directory.gov.au
### buildAR - android datviz
  - http://code.google.com/p/afreechart/ http://code.google.com/p/snowdon/ http://code.google.com/p/chartdroid/ http://androidplot.com/ http://code.google.com/p/achartengine/
buildAR was the world&#8217;s first AR Content Management System with the first early version launched back in 200\. as a bit of a test to see if people were interested in being able to create their own augmented experiences. MOB Labs officially launched the new improved buildAR at the Augmented Reality event in Silicon Valley in May 2011.  
   
[http://buildAR.com](http://buildar.com/) (normally a 1\. day free trial but GovHack attendees on the day will get a fully activated account for a month. If you are a GovHack attendee want full access now to play, just sign up for a trial and then forward your GovHack Eventbrite registration email to govhack [at] buildar.com and they&#8217;ll set you up for the free month fully activated account within a couple of days.  
   
### Other AR tools and references  
   
theAWEsomeWEB &#8211\. Future of the Augmented Web [http://theAWEsomeWEB.com](http://theawesomeweb.com/)  
   
Layar &#8211\. AR Browser - [http://layar.com](http://layar.com/)  
   
Junaio &#8211\. AR Browser - [http://junaio.com](http://junaio.com/)  
   
Aurasma &#8211\. AR Browser - [http://aurasma.com/](http://aurasma.com/)  
   
Vuforia &#8211\. NFT based AR SDK - [http://qualcomm.com/solutions/<wbr>augmented-reality</wbr>](http://qualcomm.com/solutions/augmented-reality)  
   
String &#8211\. Marker based AR SDK - [http://poweredbystring.com/](http://poweredbystring.com/)  
   
[pointcloud.io](http://pointcloud.io/) - SLAM based AR SDK - [http://pointcloud.io/](http://pointcloud.io/)  
   
ARToolkit &#8211\. Marker based AR SDK - [http://en.wikipedia.org/wiki/<wbr>ARToolKit</wbr>](http://en.wikipedia.org/wiki/ARToolKit)  
   
FLARToolkit &#8211\. Marker based AR SDK - [http://saqoo.sh/a/en/<wbr>flartoolkit/start-up-guide</wbr>](http://saqoo.sh/a/en/flartoolkit/start-up-guide)  
   
Kooaba &#8211\. Visual search platform - [http://kooaba.com](http://kooaba.com/)  
   
Catchoom &#8211\. Visual search platform - [http://catchoom.com/](http://catchoom.com/)  
   
Google Googles &#8211\. Visual search app - [http://www.google.com/mobile/<wbr>goggles/#text</wbr>](http://www.google.com/mobile/goggles/#text)  
   
Vuzix 920AR &#8211\. Wearable display - [http://www.vuzix.com/consumer/<wbr>products_wrap920ar.html</wbr>](http://www.vuzix.com/consumer/products_wrap920ar.html)  
   
Project Glass &#8211\. Googles wearable display project - [http://www.youtube.com/watch?<wbr>v=9c6W4CCU9M4</wbr>](http://www.youtube.com/watch?v=9c6W4CCU9M4)  
   
Mixed Reality &#8211\. Nokia&#8217;s vision for wearable displays [http://www.youtube.com/watch?<wbr>v=CGwvZWyLiBU</wbr>](http://www.youtube.com/watch?v=CGwvZWyLiBU)  
   
City Lens &#8211\. Nokia&#8217;s latest AR app - [http://www.youtube.com/watch?<wbr>v=63lNPkl-EPE&amp;feature=youtu.be</wbr>](http://www.youtube.com/watch?v=63lNPkl-EPE&amp;feature=youtu.be)  
   
AR &#8211\. Wikipedia page - [http://en.wikipedia.org/wiki/<wbr>Augmented_reality</wbr>](http://en.wikipedia.org/wiki/Augmented_reality)  
   
Steve Mann &#8211\. Wearable Computing Pioneer - [http://en.wikipedia.org/wiki/<wbr>Steve_Mann</wbr>](http://en.wikipedia.org/wiki/Steve_Mann)  
   
Thad Starner &#8211\. Wearable Computing Pioneer [http://en.wikipedia.org/wiki/<wbr>Thad_Starner</wbr>](http://en.wikipedia.org/wiki/Thad_Starner)  
   
Mark Weiser &#8211\. Father of Pervasive Computing [http://en.wikipedia.org/wiki/<wbr>Mark_Weiser</wbr>](http://en.wikipedia.org/wiki/Mark_Weiser)  
   
   
# Geographical Data Tools {#geographical-data-tools} # Geographical Data Tools {#geographical-data-tools}
   
Check out the[ GeoRabble Boundary Mapper&#8217;s Cookbook](http://georabble.org/2012/05/31/the-boundary-mappers-cookbook/) to see how you can tie all these things together! Check out the[ GeoRabble Boundary Mapper&#8217;s Cookbook](http://georabble.org/2012/05/31/the-boundary-mappers-cookbook/) to see how you can tie all these things together!
   
  ## Key datasets
  - base layers like agri http://agri.openstreetmap.org/, http://irs.gis-lab.info/ wms or http://www.gdal.org/frmt_wms_openstreetmap_tms.xml
  ASGS including suburbs/postcodes
  - andrewharvey4.wordpress.com postgis/asgs tutorial
  ## Wrangling
   
  ### Converting
  There are many spatial data formats and often the one your tool requires is not the one the dataset is provided in
  Online
  - http://converter.mygeodata.eu/vector kml exporter for shp