labs-migration-viz icon indicating copy to clipboard operation
labs-migration-viz copied to clipboard

A single-page interactive visualization of historic U.S. Census migration data for New York City

NYC Historic Migration Data Visualization

A single-page interactive visualization of historic U.S. Census migration data for New York City built with the guidance of NYC Planning's Population Division

The project's goals are as follows:

  1. To create a compelling web experience for exploring NYC migration trends data, in support of a broader initiative by the population division highlighting migration patterns.
  2. To create a re-usable template for future single-page dataviz projects, and a fully-functional project that can be used for learning basic web development and data visualization with d3.js.

Screenshot

How we work

NYC Planning Labs takes on a single project at a time, working closely with our customers from concept to delivery in a matter of weeks. We conduct regular maintenance between larger projects.

How you can help

In the spirit of free software, everyone is encouraged to help improve this project. Here are some ways you can contribute.

  • Comment on or clarify issues
  • Report bugs
  • Suggest new features
  • Write or edit documentation
  • Write code (no patch is too small)
    • Fix typos
    • Add comments
    • Clean up code
    • Add new features

Read more about contributing.

Requirements

You will need the following things properly installed on your computer.

Local Development

  • Clone this repo git clone https://github.com/NYCPlanning/labs-migration-viz.git
  • Navigate to the project directory cd labs-migration-viz
  • Start a local webserver
    • Python 2: cd labs-migration-viz && python -m SimpleHTTPServer 8000
    • Python 3: cd labs-migration-viz && python -m http.server 8000
  • Open the site in your browser at http://localhost:8000

Architecture

This project uses Bootstrap for layout, and a custom D3.js chart.

Deployment

This project can be deployed on any static web server.

  • Create a new Git remote called dokku: git remote add dokku dokku@{servername}:{appname}
  • Deploy via Dokku using git push dokku master. Because .static exists in the root of the repo, Dokku will deploy the app using the NGINX buildpack.

Contact Us

You can find us on Twitter at @nycplanninglabs, or comment on issues and we'll follow up as soon as we can. If you'd like to send an email, use [email protected]