projects / tools.git / blame
search:
summary | shortlog | log | commit | commitdiff | tree
plain | HEAD | blame
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
maxious 13
14 geo
15 - http://converter.mygeodata.eu/vector kml exporter for shp
16 - http://bost.ocks.org/mike/map/
17
18 R
19 - http://blog.yhathq.com/posts/10-R-packages-I-wish-I-knew-about-earlier.html
20 - excel -> R/rattle/ deducer? http://www.r-bloggers.com/updates-to-the-deducer-family-of-packages/
21
22
Maxious 23
maxious 24 - tools.disclo.gs - how to use data
25 - developer tools inc. linked data
26 - gephi -> neo4j
27 - neo4j lets you build on, do massive queries of who is friends with who
28 - 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/
29 - http://mbostock.github.com/d3/ex/pack.html http://mbostock.github.com/d3/ex/tree.html
30 - postgis/quantum gis
31 - (google earth is alright but many limitations) NASA World Wind?
32 - ABS statistical areas
33 - http://irs.gis-lab.info/ wms or http://www.gdal.org/frmt_wms_openstreetmap_tms.xml
34 - can do nearest/isin/union queries - personal geocoder
35 - cloudmade geocoder, google maps my maps
36 - base layers like agri or nearmap
37 - scraperwiki with new pytemplate libraries
38 - makes an API for your data to get in sqlite/json/csv
39 - three.js with cables vis? Overviewer from AP?
40 - govhack library
41 - http://hpneo.github.com/gmaps/examples.html
42 - https://graphics.stanford.edu/wikis/cs448b-12-fall/ data viz theory
43 - https://mixpanel.com/education/understanding-the-first-five-minutes
44 - http://drawingbynumbers.org/toolsandresources
45 - http://wmbriggs.com/blog/?p=6465
46 - http://ofps.oreilly.com/titles/9781449339739/k_00000002.html list of d3 alternatives
47 - http://craigkerstiens.com/2012/10/01/understanding-postgres-performance/
48 - https://github.com/clips/pattern for easy NLP/network analysis/data mining
49 - https://github.com/theodi/open-data-tech-review/wiki othr cleanup/linked data toola
50 - http://selection.datavisualization.ch/ data viz tools catalog
51 - manipulating data - grep/find replace/sed/regex
52 - d3 tools and tutorial http://enjalot.com/ http://news.ycombinator.com/item?id=4608440
53 - Why d3 is the way it is and how to make charts http://bost.ocks.org/mike/chart/
54 - how to make an xkcd chart http://bl.ocks.org/3914862
Maxious 55
maxious 56 - data viz
57 - http://k2company.com/blog/2012/09/06/toolbox-for-learning-machine-learning-and-data-science/
58 - http://williamparry.blogspot.com.au/2011/04/putting-data-into-google-fusion-tables.html google fusion tutorial
59 - andrewharvey4.wordpress.com postgis/asgs tutorial
60 - http://www.slideshare.net/maxdemarzi/etl-into-neo4j
Maxious 61
maxious 62 - http://www.twotorials.com/ for R
63 - 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
64 - http://is-r.tumblr.com/post/38240018815/making-prettier-network-graphs-with-sna-and-igraph
65 - http://www.r-bloggers.com/video-simpler-tricks-and-tools-help-debugging-git-latex-and-workflow-with-r-by-prof-rob-hyndman/
66 - 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/
67 - http://chartsnthings.tumblr.com/post/36978271916/r-tutorial-simple-charts http://flowingdata.com/2012/12/17/getting-started-with-charts-in-r/
Maxious 68
69 - http://dydra.com/
maxious 70 - http://selection.datavisualization.ch/ data viz tools list
71 - http://nodexl.codeplex.com/ network graphs for excel
Maxious 72 - http://sunfoundation.tumblr.com/
maxious 73 - analysing - linked data tools
74 - http://govcampau.wikispaces.com/useful+tools
75 - http://linkeddata.org/home
76
Alex Sadleir 77
78 # Hosted Developer Tools {#hosted-developer-tools}
79
80 ### Sourceforge
81
82 Subversion, Git, Mercurial, Bazaar, CVS, issue tracker, wiki, release file downloads. Unlimited free use for open source projects.
83
84 You can create your own Sourceforge project at [http://sourceforge.net/](http://sourceforge.net/)
85
86 ### Google Code Project Hosting
87
88 Git, Mercurial, and Subversion code. Issue tracker, wiki, release file downloads. Unlimited free use for open source projects.
89
90 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/)
91
92
93
Maxious 94 # The basics of being a data scientist
95
Alex Sadleir 96 * 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.
97 * Find the people and tools you need to prove/show/find. This rest of this page will help with the latter.
98 * 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 99 Please note, there are a combination of Analysis and Visualisation tools in each of the major categories below.
100
Alex Sadleir 101 # API Development {#api-development}
Maxious 102
103
104 So an API isn’t just an XML file ![;)](http://www.govhack.org/wp-includes/images/smilies/icon_wink.gif)
105
106 A good web based data API:
107
108 * Is logically organised
109 * Can filter returned data
110 * Can return results in different open formats (CSV/JSON etc.)
111 * Is efficient and responsive by using caching and databases appropriately
112 * Handles errors gracefully
113 * Monitors and controls access (to show benefit realised of API and prevent abuse)
114 * Provides appropriate documentation with examples
115
116 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.
117
118 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)
119
Maxious 120 API
121 - howto.gov api tutorial
122 - http://shancarter.com/data_converter/
123 - http://training.sunlightfoundation.com/module/data-visualizations-google-docs/
124 - api documentation
125 - WSDL or http://swagger.wordnik.com/ or https://github.com/mashery/iodocs
126 - 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
127 - https://github.com/elc/rapi_doc https://github.com/Pajk/apipie-rails
128 -
129
Maxious 130
131
Alex Sadleir 132 # Infographics and Data Visualisation {#data-visualisation}
133
134 Infographics try to contextualise charts and graphs to tell a story. Data vis builds on this to find new ways to design insight.
135
136 Most of the categories to follow have visualisation tools specific to their purpose.
137
138 You can find some data visualisation &#8220;essential&#8221\. tools below:
139
140 [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/)
141
142 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)
143
Maxious 144 # Mobile
145 html5 jquery mobile like directory.gov.au
146 - android datviz
147 - 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/
148
Maxious 149
Alex Sadleir 150
151 # Geographical Data Tools {#geographical-data-tools}
152
153 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!
154
155 ## Analysis
156
157 ### PostGIS
158
159 [![](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.
160
161 ### Quantum GIS
162
163 [![](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/)
164
165 ## Visualisation
166
maxious 167 ### Layar and other augmented reality tools
168
169 ### Google Fusion Tables/ChartsBin/[OpenHeatMap](http://www.openheatmap.com/)
170
171 [![](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
172
173 ### [Cartographer.js](http://cartographer.visualmotive.com/)
174
175 [![](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.
176
177
178
179 ### OpenLayers/Google Maps/[Leaflet](http://leaflet.cloudmade.com/)
180
181 [![](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.
182
183 ### NASA World Wind/Google Earth
184
185 [![](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_4dda24a4-3