edits
[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
Maxious 12 server admin / technical tools
maxious 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
Maxious 23 - http://blog.yhathq.com/posts/10-R-packages-I-wish-I-knew-about-earlier.html
maxious 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
Maxious 55 - three.js with cables vis? Overviewer from AP?
maxious 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
Maxious 61 - https://mixpanel.com/education/understanding-the-first-five-minutes
maxious 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
Maxious 68 - http://www.opentripplanner.org/apidoc/rest.plan.html
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
Maxious 72 - https://github.com/jacomyal/osdc2012-sigmajs-demo sigmajs filtering/searching
maxious 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
Alex Sadleir 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
Maxious 94 - analysing - linked data tools
95 - http://govcampau.wikispaces.com/useful+tools
Alex Sadleir 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/
Maxious 99
100
Alex Sadleir 101 # Hosted Developer Tools {#hosted-developer-tools}
Maxious 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
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.
Maxious 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
124 # API Development {#api-development}
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:
Maxious 130
131 * Is logically organised
Alex Sadleir 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
Maxious 144
145
146
147 # Infographics and Data Visualisation {#data-visualisation}
148
Maxious 149 Infographics try to contextualise charts and graphs to tell a story. Data vis builds on this to find new ways to design insight.
Alex Sadleir 150
151 Most of the categories to follow have visualisation tools specific to their purpose.
152
153 You can find some data visualisation &#8220;essential&#8221\. tools below:
154
155 [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/)
156
157 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)
158
159
160
161
162 # Geographical Data Tools {#geographical-data-tools}
163
164 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!
165
166 ## Analysis
maxious 167
168 ### PostGIS
169
170 [![](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.
171
172 ### Quantum GIS
173
174 [![](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/)
175
176 ## Visualisation
177
178 ### Layar and other augmented reality tools
179
180 ### Google Fusion Tables/ChartsBin/[OpenHeatMap](http://www.openheatmap.com/)
181
182 [![](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
183
184