swh:1:snp:041f9230e81d57a91ed327bbfe128d3eb74a8ec2
Tip revision: 09483f7abb8f7ec83b68ff1f0ea0d6578275f7ae authored by Zhongyue GUAN on 19 February 2024, 14:21:02 UTC
model data update
model data update
Tip revision: 09483f7
README.md
# Tracing Versus Freehand for Evaluating Computer-Generated Drawings (SIGGRAPH 2021)
Zeyu Wang, Sherry Qiu, Nicole Feng, Holly Rushmeier, Leonard McMillan, Julie Dorsey
[[Paper]](https://graphics.cs.yale.edu/sites/default/files/tracing-vs-freehand_0.pdf)
[[Project]](https://zachzeyuwang.github.io/tracing-vs-freehand)
[[Browser]](http://tracer.cs.yale.edu/tracing-vs-freehand/)
![teaser](teaser.jpg)
## Drawing Dataset
The dataset consists of 1,498 tracings and freehand drawings by 110 participants for 100 image prompts. Our drawings are registered to the prompts and include vector-based timestamped strokes collected via stylus input.
Please run `bash prepare_data.sh` to download the dataset, which will be placed in the `data` folder (about 600MB after unzipping). All code in this repository takes input from the `data` folder.
`data/tracings.json`, `data/drawings.json`, and `data/drawings_registered.json` use the following format.
```
{
// each prompt
"IMAGE_FILENAME.png": {
// each drawing
"PARTICIPANT_ID": [
// each stroke
{
"path": string (Unix timestamp, x, y coordinates at each vertex separated by comma)
"pressure": string (pressure value at each vertex separated by comma)
"color": string (hex code, e.g., "#000000")
"width": integer (stroke width on a 800x800 canvas)
"opacity": float (alpha value from 0 to 1)
}
...
]
...
}
...
}
```
## Code
Before running any code, please run `conda env create -f environment.yml`, `conda activate tracer`, and `sudo apt install librsvg2-bin`. All code has been tested on Ubuntu 20.04.
- `utils/` contains the code for rendering drawings and their subsets and composites from the raw JSON data.
- `registration/` contains the code for registering freehand drawings to tracing density.
- `figs/` contains the code for combining intermediate visual results to make the teaser in our paper.
I will update this repo from time to time. If you need anything in particular, please feel free to reach out to me directly.
## Citation
The dataset and code are released for academic research use only under CC BY-NC-SA 4.0.
If you use the dataset or code for your research, please cite this paper:
```
@article{Wang:2021:Tracing,
author = {Wang, Zeyu and Qiu, Sherry and Feng, Nicole and Rushmeier, Holly and McMillan, Leonard and Dorsey, Julie},
title = {Tracing Versus Freehand for Evaluating Computer-Generated Drawings},
year = {2021},
issue_date = {August 2021},
publisher = {Association for Computing Machinery},
address = {New York, NY, USA},
volume = {40},
number = {4},
issn = {0730-0301},
url = {https://doi.org/10.1145/3450626.3459819},
doi = {10.1145/3450626.3459819},
journal = {ACM Trans. Graph.},
month = aug,
numpages = {12},
keywords = {sketch dataset, drawing process, stroke analysis}
}
```