2013 updates
[tools.git] / index.md
maxious 1 Welcome to the GovHack toolkit. This page provides all the information you need to prepare hackfest entries.
2 These tools can be used to make entries like: mobile apps, web apps, data visualisations/infographics
3
4
5 - govhack toolkit!!!!
6 - key datasets, directory.gov.au gazetter/AEC electorates/suburbs/postcodes/LGAs
7
8 - definitions, open licence reuse permissive hacker hack data journalism data bis UCX etc.
9 - what do govhack entries look like?
10 - roles; coder, designer UX/graphics
11
12 server admin / technical tools
13 many projects will require some kind of internet presence, webpage etc.
14 video tools, youtube slideshow, FOSS video editing tools
15 - http://ubuntu-tutorials.com/2008/11/11/relaying-postfix-smtp-via-smtpgmailcom/
16 - amon
17
18 geo
19 - http://converter.mygeodata.eu/vector kml exporter for shp
20 - http://bost.ocks.org/mike/map/
21
22 R
23 - http://blog.yhathq.com/posts/10-R-packages-I-wish-I-knew-about-earlier.html
24 - excel -> R/rattle/ deducer? http://www.r-bloggers.com/updates-to-the-deducer-family-of-packages/
25
26 d3
27 - http://datadrivenjournalism.net/resources/data_driven_documents_defined
28 - http://www.benmcmahen.com/blog/posts/50eb57d55a94d35262000001 d3 svg
29
30 API
31 - howto.gov api tutorial
32 - http://shancarter.com/data_converter/
33 - http://training.sunlightfoundation.com/module/data-visualizations-google-docs/
34 - api documentation
35 - WSDL or http://swagger.wordnik.com/ or https://github.com/mashery/iodocs
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
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
46 - postgis/quantum gis
47 - (google earth is alright but many limitations) NASA World Wind?
48 - ABS statistical areas
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
53 - scraperwiki with new pytemplate libraries
54 - makes an API for your data to get in sqlite/json/csv
55 - three.js with cables vis? Overviewer from AP?
56 - govhack library
57 - http://hpneo.github.com/gmaps/examples.html
58 - android datviz
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/
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
63 - http://wmbriggs.com/blog/?p=6465
64 - http://ofps.oreilly.com/titles/9781449339739/k_00000002.html list of d3 alternatives
65 - http://craigkerstiens.com/2012/10/01/understanding-postgres-performance/
66 - https://github.com/clips/pattern for easy NLP/network analysis/data mining
67 - https://github.com/theodi/open-data-tech-review/wiki othr cleanup/linked data toola
68 - http://www.opentripplanner.org/apidoc/rest.plan.html
69 - http://selection.datavisualization.ch/ data viz tools catalog
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
79 - http://k2company.com/blog/2012/09/06/toolbox-for-learning-machine-learning-and-data-science/
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
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/
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/
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/
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
Alex Sadleir 100
101 # Hosted Developer Tools {#hosted-developer-tools}
102
103 ### Sourceforge
104
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/)
108
109 ### Google Code Project Hosting
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
Maxious 117 # The basics of being a data scientist
118
119
120 * Find the people and tools you need to prove/show/find. This rest of this page will help with the latter.
121
122 Please note, there are a combination of Analysis and Visualisation tools in each of the major categories below.
123
Alex Sadleir 124 # API Development {#api-development}
Maxious 125
126
127 So an API isn’t just an XML file ![;)](http://www.govhack.org/wp-includes/images/smilies/icon_wink.gif)
128
129 A good web based data API:
130
131 * Is logically organised
132 * Can filter returned data
133 * Can return results in different open formats (CSV/JSON etc.)
134 * Is efficient and responsive by using caching and databases appropriately
135 * Handles errors gracefully
136 * Monitors and controls access (to show benefit realised of API and prevent abuse)
137 * Provides appropriate documentation with examples
138
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.
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
145
146
Alex Sadleir 147 # Data Visualisation {#data-visualisation}
148
149 Most of the categories to follow have visualisation tools specific to their purpose.
150
151 You can find some data visualisation &#8220;essential&#8221\. tools below:
152
153 [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/)
154
155 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)
156
157
Maxious 158
Alex Sadleir 159
160 # Geographical Data Tools {#geographical-data-tools}
161
162 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!
163
164 ## Analysis
165
166 ### PostGIS
167
168 [![](http://www.govhack.org/wp-content/uploads/postgisexample-300x130.jpg "postgisexample")](http://www.govhack.org/wp-content/uploads/postgisexample.jpg)PostGIS is an extension for the PostgreSQL database server that allows you to store and manipulate geospatial data on a large scale. For example finding which points are in an area or what points are closest . It is also very useful for storing geospatial data because it can convert between all major formats including ESRI Shape files and Google Earth/Maps KML.
169
170 ### Quantum GIS
171
172 [![](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_m50afbe88-300x160.jpg "QGIS Screenshot")](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_m50afbe88.jpg)QGIS is a graphical desktop application that allows viewing and editing of geospatial data. Some good base maps are available by adding the WMS layer/server [http://irs.gis-lab.info/](http://irs.gis-lab.info/)
173
174 ## Visualisation
175
maxious 176 ### Layar and other augmented reality tools
177
178 ### Google Fusion Tables/ChartsBin/[OpenHeatMap](http://www.openheatmap.com/)
179
180 [![](http://www.govhack.org/wp-content/uploads/fusiontablesscreenshot-300x168.jpg "fusiontablesscreenshot")](http://www.govhack.org/wp-content/uploads/fusiontablesscreenshot.jpg)Input a numerical values and areas to a spreadsheet and maps are produced
181
182 ### [Cartographer.js](http://cartographer.visualmotive.com/)
183
184 [![](http://www.govhack.org/wp-content/uploads/cartographerjs-300x187.png "cartographerjs screenshot")](http://www.govhack.org/wp-content/uploads/cartographerjs.png)Input data as JSON and maps are produced.
185
186
187
188 ### OpenLayers/Google Maps/[Leaflet](http://leaflet.cloudmade.com/)
189
190 [![](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_512fcbe1-300x173.jpg "OpenLayers Screenshot")](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_512fcbe1.jpg)Display points and different layers. Leaflet is the easiest to use if you just want to show points with popups when clicked on.
191
192 ### NASA World Wind/Google Earth
193
194 [![](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_4dda24a4-300x261.jpg "WorldWind screenshot")](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_4dda24a4.jpg)Google Earth provides 3\. viewing of KML/GML files which represent points and shapes, both through a desktop application and a web plugin. These can be extended with interactive features that allow you to view by timeline or have animated tours between different points. You can also develop and customise your own viewer with the open source [NASA World Wind toolkit.](http://goworldwind.org/demos/)
195
196 ###
197
Alex Sadleir