.github/image | ||
analysis | ||
data | ||
detection | ||
plot | ||
streetview | ||
util | ||
.gitignore | ||
LICENSE | ||
main.py | ||
README.md | ||
requirements.txt |
Surveilling Surveillance: Estimating the Prevalence of Surveillance Cameras with Street View Data
Project page | Paper
Locations of verified cameras in 10 large U.S. cities for the period 2016–2020. Densely clustered areas of points indicate regions with high camera density in each city. Camera density varies widely between neighborhoods. Note: Scale varies between cities.
This is the code base of the Surveillance Camera paper:
@article{sheng2021surveilling,
title={Surveilling Surveillance: Estimating the Prevalence of Surveillance Cameras with Street View Data},
author={Sheng, Hao and Yao, Keniel and Goel, Sharad},
journal={arXiv e-prints},
pages={arXiv--2105},
year={2021}
}
Camera Detection
Requirements
- Linux or macOS with Python ≥ 3.6
- PyTorch ≥ 1.6 and torchvision that matches the PyTorch installation. Install them together at pytorch.org to make sure of this
- Detection2. The installation instruction of Detection2 can be found here
Install Python dependencies by running:
pip install -r requirements.txt
Download street-view images
python main.py download_streetview_image --key GOOGLE_API_KEY --sec GOOGLE_API_SECRET
Model training
cd detection && python main.py train --exp_name EXPERIMENT_NAME --[hyparameter] [value]
Model inference
cd detection && python main.py test --deploy --deploy_meta_path [DEPLOY_META_PATH]
, where DEPLOY_META_PATH
is a path to a csv file of the following format:
save_path | panoid | heading | downloaded |
---|---|---|---|
/dY/5I/l8/4NW89-ChFSP71GiA/344.png | dY5Il84NW89-ChFSP71GiA | -105.55188877562128 | True |
... |
Here, panoid
and heading
refer to the ID and heading of each street-view image.
Analysis
To reproduce the figures and tables in our paper, run the analysis/results.Rmd
script.
You'll need to download our camera and road network data available here into a data
directory in the root of this repository.
Artifacts
Annotations
Our collected camera annotations can be downloaded as follows:
#images | # cameras | link | md5 |
---|---|---|---|
3,155 | 1,696 | download | b2340143c6af2d1e6bfefd5001fd94c1 |
- 2021-5-20: This dataset is larger than the one reported in the paper as we include verified examples from our pilot.
- 2021-5-18: The metadata can also be found in this repo as
./data/meta.csv
.
Pre-trained Models
Our pre-trained camera detection model can be downloaded as follows:
architecture | Size | link | md5 |
---|---|---|---|
FasterRCNN | 472 Mb | download | dba44ad36340d3291102e72b340568a0 |
- 2021-5-20: We updated the model architecture (FasterRCNN).
Detection and Road Network Data
Size | link | md5 |
---|---|---|
97 Mb | download | 6ceab577c53ba8dbe60b0ff1c8d5069a |