DatasauRust is both an executable binary that can be run, and a library that can be used in Rust programs.

Installing the command-line executable

Assuming you have Rust/Cargo installed, run this command in a terminal:

cargo install datasaurust

It will make the datasaurust command available in your PATH if you've allowed the PATH to be modified when installing Rust. cargo uninstall datasaurust uninstalls.

Adding `datasaurust` library as a dependency

Run this command in a terminal, in your project's directory:

cargo add datasaurust

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

datasaurust = "0.1.0"

The datasaurust library will be automatically available globally. Read the datasaurust library documentation.

Back to the crate overview.

Readme

DatasauRust

Blazingly fast implementation of the Datasaurus paper (500x faster than the original): "Same Stats, Different Graphs: Generating Datasets with Varied Appearance and Identical Statistics through Simulated Annealing" by Justin Matejka and George Fitzmaurice.

Usage

To run with plot -p (using gnuplot):

cargo run --release -- -d data/seed_datasets/Datasaurus_data.csv -p

With pre-defined shape:

cargo run --release -- -p -n 3000000 --decimals 2 --shape cat --allowed-distance 0.1

Starting from Gaussian noise:

cargo run --release -- -p -n 3000000 --decimals 2 --shape cat --allowed-distance 0.1 --gaussian

Create videos

Create video and gif (use --save-plot):

pip install moviepy ffmpeg-python

python scripts/create_video.py logs/cat/ logs/cat.mp4

From one shape to another:

cargo run --release -- -p -n 2000000 --decimals 1 --shape dog --allowed-distance 0.1 --log-interval 10000 -d logs/gaussian_cat/output.csv --save-plots

Note: The original datasets and python code comes from http://www.autodeskresearch.com/papers/samestats

Installing the command-line executable

Adding datasaurust library as a dependency

Adding `datasaurust` library as a dependency