edits
[tools.git] / index.md
maxious 1 - tools.disclo.gs - how to use data
2 - developer tools inc. linked data
3 - gephi -> neo4j
4 - neo4j lets you build on, do massive queries of who is friends with who
Maxious 5 -
maxious 6 - postgis/quantum gis
7 - (google earth is alright but many limitations) NASA World Wind?
8 - ABS statistical areas
Maxious 9
maxious 10 - scraperwiki with new pytemplate libraries
11 - makes an API for your data to get in sqlite/json/csv
Maxious 12
maxious 13 - govhack library
14 - https://graphics.stanford.edu/wikis/cs448b-12-fall/ data viz theory
15 - http://drawingbynumbers.org/toolsandresources
16 - http://wmbriggs.com/blog/?p=6465
17 - http://ofps.oreilly.com/titles/9781449339739/k_00000002.html list of d3 alternatives
18 - http://craigkerstiens.com/2012/10/01/understanding-postgres-performance/
19 - https://github.com/clips/pattern for easy NLP/network analysis/data mining
20 - https://github.com/theodi/open-data-tech-review/wiki othr cleanup/linked data toola
21 - http://selection.datavisualization.ch/ data viz tools catalog
22 - manipulating data - grep/find replace/sed/regex
Maxious 23
maxious 24 - data viz
25 - http://k2company.com/blog/2012/09/06/toolbox-for-learning-machine-learning-and-data-science/
26 - http://williamparry.blogspot.com.au/2011/04/putting-data-into-google-fusion-tables.html google fusion tutorial
Maxious 27
maxious 28 - http://www.slideshare.net/maxdemarzi/etl-into-neo4j
Maxious 29
30
31 - http://dydra.com/
maxious 32 - http://selection.datavisualization.ch/ data viz tools list
33 - http://nodexl.codeplex.com/ network graphs for excel
Maxious 34 - http://sunfoundation.tumblr.com/
maxious 35 - analysing - linked data tools
36 - http://govcampau.wikispaces.com/useful+tools
37 - http://linkeddata.org/home
38
Alex Sadleir 39
Maxious 40 Welcome to the GovHack toolkit. This page provides all the information you need to prepare hackfest entries.
41 These tools can be used to make entries like: mobile apps, web apps, data visualisations/infographics
42
43
44 # General Data Hacking and Programming References {#general-data-hacking-and-programming-references}
45 ## The basics of being a data scientist
46
47 * 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.
48 * Find the people and tools you need to prove/show/find. This rest of this page will help with the latter.
49 * 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.
50 Please note, there are a combination of Analysis and Visualisation tools in each of the major categories below.
51
52
53 [![](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_m6a65720f-300x199.gif "Data Journalism Diagram")](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_m6a65720f.gif)</dt>
54 Illustration from Data Journalism Handbook, CC BY-SA 3.0</dd>
55
56
57 The best high level reference is the �Understanding Data� and �Delivering Data� chapters of the Data Journalism Handbook which is available online for free at
58
59 [datajournalismhandbook.org](http://datajournalismhandbook.org/)
60
61 You can learn the technical skills from scratch in Visualize This: The FlowingData Guide to Design, Visualization, and Statistics by Nathan Yau or for more advanced
62
63 practical advice check out Data Analysis with Open Source Tools by Philipp K. Janert
64
65 For further reading in this space
66
67 [http://flowingdata.com/2012/04/27/data-and-visualization-blogs-worth-following/](http://flowingdata.com/2012/04/27/data-and-visualization-blogs-worth-following/)
68
69
70
71 **Statistics**
72
73 [http://greenteapress.com/thinkstats/html/index.html](http://greenteapress.com/thinkstats/html/index.html)
74
75 **Programming**
76
77 Programming is valuable skill for manipulating and displaying data.
78
79 Basic tutorials for a variety of languages are available for free online or you can learn
80
81 interactively with websites like [http://www.codecademy.com/](http://www.codecademy.com/#!/exercises/0\. for JavaScript or [http://www.learnpython.org/ ](http://www.learnpython.org/)or [http://tryruby.org](http://tryruby.org/)
82
83 [https://developer.mozilla.org/en/JavaScript](https://developer.mozilla.org/en/JavaScript) &#8211\. especially for web applications and visualisations, you&#8217;ll need a basic understanding of JS. Common libraries like prototype or jQuery can help
84
85 **Accessibility/User Experience**
86
87 WCAG guidelines not only make a web app accessible but make it a better experience for all users! Even if not making an app, good to consider these things to do and not do: [http://www.w3.org/TR/WCAG/](http://www.w3.org/TR/WCAG/)
88
89 ## Who can be a hack day participant
90 - roles; coder, designer UX/graphics
91
92 ## Definitions
93 - definitions, open licence reuse permissive hacker hack data journalism data bis UCX etc.
94
95
96 ## key datasets
97 - key datasets, directory.gov.au gazetter/AEC electorates/suburbs/postcodes/LGAs
98
99 ## examples
100
101 ## The Open Budget
102
103 ## WeatherTree weather API
104
105 ## PlanningAlerts
106
107 [![Planning Alerts Screenshot](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_2f0199ff1-300x221.png "Planning Alerts Screenshot")](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_2f0199ff1.png)Description: Planning Alerts takes data from local government development applications and sends alerts to users based on what applications are lodged in their area.
108
109 Programming Language: Ruby
110
111 Source Control: [Git](https://github.com/openaustralia/planningalerts-app)
112
113 Issue Tracking: [Atlassian JIRA](http://tickets.openaustraliafoundation.org.au/browse/PA/)
114
115 ## LobbyLens
116
117 [![](http://www.govhack.org/wp-content/uploads/129-Screenshot-LobbyClue_-_Chromium-300x180.png "LobbyLens screenshot")](http://www.govhack.org/wp-content/uploads/129-Screenshot-LobbyClue_-_Chromium.png)
118
119 Description: Displays connections between government contracts, business details, politician responsibilities, lobbyists, clients of lobbyists, political donors and the location of these entities.
120
121 Programing Language: PHP
122
123 Source Control: SVN (Subversion)
124
125 Issue Tracking: A whiteboard
126
127 ## Bus.lambdacomplex.org
128
129 [![](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_3789acae-300x253.jpg "Bus.lambda screenshot")](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_3789acae.jpg)
130
131 Description: Online Canberra Bus Timetables and Trip Planner.
132
133 Programing Language: PHP/Ruby
134
135 Source Control: Git
136
137 Issue Tracking: Github
138
139
140 ## Developer Tools For Your Computer {#developer-tools-for-your-computer}
141
142 server admin / technical tools
143 many projects will require some kind of internet presence, webpage etc.
144 - css framework like bootstrap or zurb foundation
145 video tools, youtube video editor/slideshow, FOSS video editing tools
146 - http://ubuntu-tutorials.com/2008/11/11/relaying-postfix-smtp-via-smtpgmailcom/
147 - amon
148
149 ### Source Control &#8211\. Git / Subversion
150
151 [![](http://www.govhack.org/wp-content/uploads/Screenshot-at-2012-04-29-172132-300x235.png "Git Screenshot")](http://progit.org/book/)
152
153 [http://progit.org/book/](http://progit.org/book/)
154
155 [http://svnbook.red-bean.com/](http://svnbook.red-bean.com/)
156
157 [http://tortoisesvn.net/](http://tortoisesvn.net/)
158
159 [http://code.google.com/p/tortoisegit/](http://code.google.com/p/tortoisegit/)
160
161 ### Task Tracking -
162
163 Issue/task trackers allow you to outline the tasks required for your project and assign them to people to do.
164
165 [Trello](https://trello.com/) and [Workflowy](https://workflowy.com/) are free, lightweight project management tools suitable for a rapid project!
166
Maxious 167 ## Hosted Developer Tools {#hosted-developer-tools}
168
169 Can get many tools (source control, issue tracking) combined into one service cloud hosted so no setup required.
170
171 ### Github
172 Git obviously but svn/hg interfaces are possible. Provide their own GUI for Windows/OSX or use the variety of Git capable tools
173
174 ### Sourceforge
175
176 Subversion, Git, Mercurial, Bazaar, CVS, issue tracker, wiki, release file downloads. Unlimited free use for open source projects.
177
178 You can create your own Sourceforge project at [http://sourceforge.net/](http://sourceforge.net/)
179
180 ### Google Code Project Hosting
181
182 Git, Mercurial, and Subversion code. Issue tracker, wiki, release file downloads. Unlimited free use for open source projects.
183
184 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/)
185
186
187
Alex Sadleir 188 # API Development {#api-development}
Maxious 189
190
191 So an API isn&#8217;t just an XML file ![;)](http://www.govhack.org/wp-includes/images/smilies/icon_wink.gif)
192
193 A good web based data API:
194
195 * Is logically organised
196 * Can filter returned data
197 * Can return results in different open formats (CSV/JSON etc.)
198 * Is efficient and responsive by using caching and databases appropriately
199 * Handles errors gracefully
200 * Monitors and controls access (to show benefit realised of API and prevent abuse)
201 * Provides appropriate documentation with examples
202
203