edits
[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
Maxious 5 - govhack toolkit!!!!
Maxious 6 - key datasets, directory.gov.au gazetter/AEC electorates/suburbs/postcodes/LGAs
Alex Sadleir 7
8 - definitions, open licence reuse permissive hacker hack data journalism data bis UCX etc.
Maxious 9 - what do govhack entries look like?
Alex Sadleir 10 - roles; coder, designer UX/graphics
Maxious 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
19 - http://converter.mygeodata.eu/vector kml exporter for shp
20 - http://bost.ocks.org/mike/map/
Maxious 21
22 R
Alex Sadleir 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/
Maxious 25
26 d3
maxious 27 - http://datadrivenjournalism.net/resources/data_driven_documents_defined
Maxious 28 - http://www.benmcmahen.com/blog/posts/50eb57d55a94d35262000001 d3 svg
Maxious 29
30 API
Maxious 31 - howto.gov api tutorial
Alex Sadleir 32 - http://shancarter.com/data_converter/
Maxious 33 - http://training.sunlightfoundation.com/module/data-visualizations-google-docs/
34 - api documentation
maxious 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
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
maxious 52 - base layers like agri or nearmap
Maxious 53 - scraperwiki with new pytemplate libraries
maxious 54 - makes an API for your data to get in sqlite/json/csv
Maxious 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
Alex Sadleir 62 - http://drawingbynumbers.org/toolsandresources
63 - http://wmbriggs.com/blog/?p=6465
Maxious 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/
66 - https://github.com/clips/pattern for easy NLP/network analysis/data mining
Maxious 67 - https://github.com/theodi/open-data-tech-review/wiki othr cleanup/linked data toola
Alex Sadleir 68 - http://www.opentripplanner.org/apidoc/rest.plan.html
Maxious 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
Maxious 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
100
101 # Hosted Developer Tools {#hosted-developer-tools}
102
Alex Sadleir 103 ### Sourceforge
104
105 Subversion, Git, Mercurial, Bazaar, CVS, issue tracker, wiki, release file downloads. Unlimited free use for open source projects.
Maxious 106
107 You can create your own Sourceforge project at [http://sourceforge.net/](http://sourceforge.net/)
maxious 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.
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.
Maxious 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}
125
126
Maxious 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:
Alex Sadleir 130
Maxious 131 * Is logically organised
Alex Sadleir 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
135 * Handles errors gracefully
Alex Sadleir 136 * Monitors and controls access (to show benefit realised of API and prevent abuse)
Alex Sadleir 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)
maxious 142
143
144
145
146
147 # Infographics and Data Visualisation {#data-visualisation}
Maxious 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.
Maxious 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
Alex Sadleir 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
Maxious 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)