add wordpress mode
[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/
Alex Sadleir 21
Maxious 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
maxious 26 d3
Maxious 27 - http://datadrivenjournalism.net/resources/data_driven_documents_defined
Maxious 28 - http://www.benmcmahen.com/blog/posts/50eb57d55a94d35262000001 d3 svg
29
Maxious 30 API
Alex Sadleir 31 - howto.gov api tutorial
Maxious 32 - http://shancarter.com/data_converter/
33 - http://training.sunlightfoundation.com/module/data-visualizations-google-docs/
maxious 34 - api documentation
Maxious 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
Alex Sadleir 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
Maxious 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
Alex Sadleir 51 - cloudmade geocoder, google maps my maps
Maxious 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
55 - three.js with cables vis? Overviewer from AP?
56 - govhack library
Alex Sadleir 57 - http://hpneo.github.com/gmaps/examples.html
Maxious 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
Alex Sadleir 61 - https://mixpanel.com/education/understanding-the-first-five-minutes
Alex Sadleir 62 - http://drawingbynumbers.org/toolsandresources
Maxious 63 - http://wmbriggs.com/blog/?p=6465
maxious 64 - http://ofps.oreilly.com/titles/9781449339739/k_00000002.html list of d3 alternatives
Alex Sadleir 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
Maxious 69 - http://selection.datavisualization.ch/ data viz tools catalog
70 - http://www.slideshare.net/OReillyStrata/visualizing-networks-beyond-the-hairball
Maxious 71 - http://blog.sciencenet.cn/blog-554179-622011.html SNA tools catalog
72 - https://github.com/jacomyal/osdc2012-sigmajs-demo sigmajs filtering/searching
Alex Sadleir 73 - manipulating data - grep/find replace/sed/regex
Maxious 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
Alex Sadleir 81 - andrewharvey4.wordpress.com postgis/asgs tutorial
Maxious 82 - http://www.slideshare.net/maxdemarzi/etl-into-neo4j
83 - http://www.twotorials.com/ for R
Alex Sadleir 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/
Alex Sadleir 99
100
Alex Sadleir 101 # Hosted Developer Tools {#hosted-developer-tools}
Maxious 102
103 ### Sourceforge
Alex Sadleir 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
Maxious 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.
Alex Sadleir 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.
Alex Sadleir 123
maxious 124 # API Development {#api-development}
Maxious 125
Alex Sadleir 126
Maxious 127 So an API isn’t just an XML file ![;)](http://www.govhack.org/wp-includes/images/smilies/icon_wink.gif)
128
Alex Sadleir 129 A good web based data API:
Alex Sadleir 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
maxious 135 * Handles errors gracefully
136 * Monitors and controls access (to show benefit realised of API and prevent abuse)
Maxious 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
Alex Sadleir 143
Maxious 144