README.md

HRDF

December 2015. Creating data visualizations of labor issues in Saudi Arabia.

Notes on geodata

Original shapefiles for Saudi's provinces were found at DIVA-GIS. They were then converted to GeoJSON using the command-line tool, ogr2ogr:

ogr2ogr -f GeoJSON saudi.json raw/SAU_adm1.shp

To compress this file, TopoJSON was used, where NAME_1 was assumed to be the province names:

topojson -o saudi_comp.json --id-property NAME_1 saudi.json

Resources

• ColorHexa - Help with picking colors
• ColorBrewer - Help with picking map colors
• DIVA-GIS
• Mike Bostock - Let's Make a Map
• Mike Bostock - Pie chart
• Mike Bostock - Pie multiples
• Mike Bostock - Pie chart update II
• Mike Bostock - Thinking with joins
• Stack Overflow - "update angles of multiple pie on map in d3.js"
• mapsam.com - D3 Background Hash Patterns
• Pandas documentation - Merging, appending, concatenating, joining

TODOs

1. git.
2. Get map up.
3. GPS coords for province capitals.
4. Workforce population.
5. Total population (Saudi, non-Saudi) data.
6. Input .csv for dynamic bar chart.
7. Linking the map to d3.filter/d3.update of the dynamic bar chart.

• Default: Keep region highlighted and bar chart label.
• Hover: Change bar chart and labels?
• Click: Keep region highlighted and bar chart label.

8. Better way to toggle between graphs?
9. Update spellings, according to last Slack updates.
10. Kill overlapping circles; pie charts (vary r) instead.
11. Fix pie charts:

• How do I move each pie chart over each capital? transform, translate() - but is it upside-down?
• Arc lengths?
• Reorganize data?

12. Turn off province highlighting when not in #byRegion.
13. Pie chart: colors?
14. Pie chart: Tooltips over each slice?
15. Industry viz: start that function.
16. Explanatory captions.
17. Bar chart: axes, legend.
18. For each chart: highlight the pies/bars where Saudi > expat and expat > Saudi. (Small circle button? Caption/subtitle?)
19. Fix xAxis.
20. Bold/highlight the "by..." user selection.
21. Why does update only work the first time, but not subsequent times?
22. By region: Fix mouseout classes.
23. Stack charts.
24. Industry viz: Dropdown menu for all industries.
25. Industry viz: Update via dropdown.
26. Industry viz: First chart. Default to Construction?
27. By region: Fix mouseout title.
28. By region: click fixes the region.
29. By region: Mouseover captions.
30. Merge lat/lon data into industries.csv. Check that the pandas merge worked!
31. By industry: Mouseover captions.
32. Tooltips: Fix percentage calcs.
33. Legend with Saudi/expat colors.