editz
[tools.git] / index.md
Alex Sadleir 1 Welcome to the GovHack toolkit. This page provides all the information you need to prepare hackfest entries.
Maxious 2 These tools can be used to make entries like: mobile apps, web apps, data visualisations/infographics
Alex Sadleir 3
4
5 - govhack toolkit!!!!
Maxious 6 - key datasets, directory.gov.au gazetter/AEC electorates/suburbs/postcodes/LGAs
Maxious 7
Alex Sadleir 8 - definitions, open licence reuse permissive hacker hack data journalism data bis UCX etc.
9 - what do govhack entries look like?
Maxious 10 - roles; coder, designer UX/graphics
Alex Sadleir 11
Maxious 12 server admin / technical tools
Maxious 13 many projects will require some kind of internet presence, webpage etc.
Maxious 14 video tools, youtube slideshow, FOSS video editing tools
Maxious 15 - http://ubuntu-tutorials.com/2008/11/11/relaying-postfix-smtp-via-smtpgmailcom/
Maxious 16 - amon
Maxious 17
Maxious 18 geo
Maxious 19 - http://converter.mygeodata.eu/vector kml exporter for shp
20 - http://bost.ocks.org/mike/map/
21
Maxious 22 R
23 - http://blog.yhathq.com/posts/10-R-packages-I-wish-I-knew-about-earlier.html
Alex Sadleir 24 - excel -> R/rattle/ deducer? http://www.r-bloggers.com/updates-to-the-deducer-family-of-packages/
Maxious 25
Maxious 26 d3
27 - http://datadrivenjournalism.net/resources/data_driven_documents_defined
maxious 28 - http://www.benmcmahen.com/blog/posts/50eb57d55a94d35262000001 d3 svg
Maxious 29
Maxious 30 API
31 - howto.gov api tutorial
Maxious 32 - http://shancarter.com/data_converter/
Alex Sadleir 33 - http://training.sunlightfoundation.com/module/data-visualizations-google-docs/
Maxious 34 - api documentation
35 - WSDL or http://swagger.wordnik.com/ or https://github.com/mashery/iodocs
maxious 36 - 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
Maxious 37 - https://github.com/elc/rapi_doc https://github.com/Pajk/apipie-rails
38 -
39 - tools.disclo.gs - how to use data
40 - https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet#wiki-images reference style images?
41 - developer tools inc. linked data
42 - gephi -> neo4j
43 - neo4j lets you build on, do massive queries of who is friends with who
44 - don't use network viz if what you actually have is a tree/hierarchy with no interconnections http://www.randelshofer.ch/treeviz/ http://thejit.org/demos/ http://mbostock.github.com/protovis/ex/treemap.html http://blog.pixelingene.com/2011/07/building-a-tree-diagram-in-d3-js/
45 - http://mbostock.github.com/d3/ex/pack.html http://mbostock.github.com/d3/ex/tree.html
Alex Sadleir 46 - postgis/quantum gis
47 - (google earth is alright but many limitations) NASA World Wind?
48 - ABS statistical areas
Maxious 49 - http://irs.gis-lab.info/ wms or http://www.gdal.org/frmt_wms_openstreetmap_tms.xml
50 - can do nearest/isin/union queries - personal geocoder
51 - cloudmade geocoder, google maps my maps
52 - base layers like agri or nearmap
Alex Sadleir 53 - scraperwiki with new pytemplate libraries
Maxious 54 - makes an API for your data to get in sqlite/json/csv
Alex Sadleir 55 - three.js with cables vis? Overviewer from AP?
Maxious 56 - govhack library
57 - http://hpneo.github.com/gmaps/examples.html
58 - android datviz
Alex Sadleir 59 - 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/
Maxious 60 - https://graphics.stanford.edu/wikis/cs448b-12-fall/ data viz theory
61 - https://mixpanel.com/education/understanding-the-first-five-minutes
62 - http://drawingbynumbers.org/toolsandresources
Alex Sadleir 63 - http://wmbriggs.com/blog/?p=6465
64 - http://ofps.oreilly.com/titles/9781449339739/k_00000002.html list of d3 alternatives
Maxious 65 - http://craigkerstiens.com/2012/10/01/understanding-postgres-performance/
maxious 66 - https://github.com/clips/pattern for easy NLP/network analysis/data mining
Alex Sadleir 67 - https://github.com/theodi/open-data-tech-review/wiki othr cleanup/linked data toola
Maxious 68 - http://www.opentripplanner.org/apidoc/rest.plan.html
Alex Sadleir 69 - http://selection.datavisualization.ch/ data viz tools catalog
Maxious 70 - http://www.slideshare.net/OReillyStrata/visualizing-networks-beyond-the-hairball
71 - http://blog.sciencenet.cn/blog-554179-622011.html SNA tools catalog
72 - https://github.com/jacomyal/osdc2012-sigmajs-demo sigmajs filtering/searching
73 - manipulating data - grep/find replace/sed/regex
74 - d3 tools and tutorial http://enjalot.com/ http://news.ycombinator.com/item?id=4608440
75 - Why d3 is the way it is and how to make charts http://bost.ocks.org/mike/chart/
76 - how to make an xkcd chart http://bl.ocks.org/3914862
77 - http://blog.josephwilk.net/ruby/latent-semantic-analysis-in-ruby.html similar terms usually found together
78 - data viz
Alex Sadleir 79 - http://k2company.com/blog/2012/09/06/toolbox-for-learning-machine-learning-and-data-science/
Maxious 80 - http://williamparry.blogspot.com.au/2011/04/putting-data-into-google-fusion-tables.html google fusion tutorial
81 - andrewharvey4.wordpress.com postgis/asgs tutorial
82 - http://www.slideshare.net/maxdemarzi/etl-into-neo4j
83 - http://www.twotorials.com/ for R
84 - 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
Maxious 85 - http://is-r.tumblr.com/post/38240018815/making-prettier-network-graphs-with-sna-and-igraph
86 - http://www.r-bloggers.com/video-simpler-tricks-and-tools-help-debugging-git-latex-and-workflow-with-r-by-prof-rob-hyndman/
Alex Sadleir 87 - 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/
Maxious 88 - http://chartsnthings.tumblr.com/post/36978271916/r-tutorial-simple-charts http://flowingdata.com/2012/12/17/getting-started-with-charts-in-r/
89 - http://dydra.com/
Alex Sadleir 90 - http://selection.datavisualization.ch/ data viz tools list
91 - http://nodexl.codeplex.com/ network graphs for excel
92 - http://sunfoundation.tumblr.com/
93 - css framework like bootstrap or zurb foundation
94 - analysing - linked data tools
95 - http://govcampau.wikispaces.com/useful+tools
96 - http://linkeddata.org/home
97 - analysing - unstructured/nlp incl overviewer, opennlp/nltk, lucene/solr
98 - http://www.r-bloggers.com/simple-text-mining-with-r/
99
100
101 # Hosted Developer Tools {#hosted-developer-tools}
102
103 ### Sourceforge
104
Alex Sadleir 105 Subversion, Git, Mercurial, Bazaar, CVS, issue tracker, wiki, release file downloads. Unlimited free use for open source projects.
106
107 You can create your own Sourceforge project at [http://sourceforge.net/](http://sourceforge.net/)
Maxious 108
109 ### Google Code Project Hosting
maxious 110
111 Git, Mercurial, and Subversion code. Issue tracker, wiki, release file downloads. Unlimited free use for open source projects.
112
113 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/)
114
115
116
117 # The basics of being a data scientist
118
119 * 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.
120 * Find the people and tools you need to prove/show/find. This rest of this page will help with the latter.
121 * 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.
122 Please note, there are a combination of Analysis and Visualisation tools in each of the major categories below.
123
Maxious 124 # API Development {#api-development}
125
Maxious 126
Alex Sadleir 127 So an API isn’t just an XML file ![;)](http://www.govhack.org/wp-includes/images/smilies/icon_wink.gif)
Maxious 128
129 A good web based data API:
maxious 130
Maxious 131 * Is logically organised
132 * Can filter returned data
Alex Sadleir 133 * Can return results in different open formats (CSV/JSON etc.)
Maxious 134 * Is efficient and responsive by using caching and databases appropriately
Alex Sadleir 135 * Handles errors gracefully
Alex Sadleir 136 * Monitors and controls access (to show benefit realised of API and prevent abuse)
Maxious 137 * Provides appropriate documentation with examples
138
Alex Sadleir 139 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.
Alex Sadleir 140
141 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)
142
143
144
maxious 145
146
147 # Infographics and Data Visualisation {#data-visualisation}
148
149 Infographics try to contextualise charts and graphs to tell a story. Data vis builds on this to find new ways to design insight.
150