This repository contains the data and code underlying the paper "How Segregated is Urban Consumption?" in the Journal of Political Economy by Don Davis, Jonathan Dingel, Joan Monras, and Eduardo Morales.
Kevin Dano provided outstanding research assistance and contributed very substantially to this code.
Our project is organized as a series of tasks.
The main project directory contains 46 folders that represent 46 tasks.
Each task folder contains three folders:
A task's output is used as an input by one or more downstream tasks.
This large graph depicts the input-output relationships between tasks.
We use Unix's
make utility to automate this workflow.
After downloading this replication package (and installing the relevant software), you can reproduce the figures and tables appearing in the published paper and the online appendix simply by typing
make at the command line.
The project's tasks are implemented via Julia code, Stata code, and Unix shell scripts. In particular, we used Julia 0.6.2, Stata 15, and GNU bash version 4.2.46(2). To run the code, you must have installed Julia 0.6.2, Stata, and Bash. The taskflow structure employs symbolic links.
Note to Mac OS X users:
The code presumes that Julia and Stata scripts can be run from Terminal via the commands
Please follow the instructions for Running Julia from the Terminal and Running Stata from the Terminal.
Download and configure
- Download (or clone) this repository by clicking the green
Clone or downloadbutton above. Uncompress the ZIP file into a working directory on your cluster or local machine. Uncompress the two ZIP files within the
- From the Unix/Linux/MacOSX command line, navigate to the working directory and configure the project based on whether you will be running the code using the Slurm workload manager in a computing cluster environment or locally:
- If you are using Slurm, type
bash slurm_configuration.shand enter the name of the computing partition to which the batch jobs should be submitted.
- If you want to run code locally, type
bash local_configuration.shto impose the local configuration. The script will ask you to specify the number of CPUs available.
Warning: We strongly recommend using a computing cluster if possible. This is a large project (in terms of both disk space and computation time) that heavily exploits parallel computation.
After setting up your configuration, typing
make in the working directory will execute all the project code.
Warning: A few of the tasks are computationally intensive and take days to run.
The slow tasks are:
predictvisits_bootstrap alone needs more than 1TB of disk space.
- To replicate everything, at the command line type
make full_version. It may take several days to produce everything. You need at least 4TB of disk space.
- To replicate the results in the main text that can be computed in less than a day on typical hardware (you need at least 10GB of RAM and 70GB of disk space), type
- It is best to replicate the project using the
makeapproach described above. Nonetheless, it is also possible to produce the results task-by-task in the order depicted in the flow chart. If all upstream tasks have been completed, you can complete a task by navigating to the task's
codedirectory and typing
- Given Julia's ongoing development (i.e., evolving syntax), it important to use Julia version 0.6.2 to run this code.
- An internet connection is required so that scripts can install Julia packages and Stata programs.
slurm_configuration.shscript asks the user to name a single computing partition on which the batch jobs are run. To vary this at the folder level, type
make edit_sbatchwithin the task folder and select that task's partition.