Teaching tool on the importance of data visualization.
Project description
Morph an input dataset of 2D points into select shapes, while preserving the summary statistics to a given number of decimal points through simulated annealing.
Installation
Data Morph can be installed with pip:
$ pip install data-morph-ai
Usage
Once installed, Data Morph can be used on the command line or as an importable Python package. Below are some examples; be sure to check out the documentation for more information.
Command Line Usage
Run data-morph on the command line:
$ data-morph --start-shape panda --target-shape star
This produces the animation in the newly-created morphed_data directory within your current working directory (shown above).
See all available CLI options by passing in --help:
$ data-morph --help
Python Usage
The DataMorpher class performs the morphing from a Dataset to a Shape. Any pandas.DataFrame with numeric columns x and y can be a Dataset. Use the DataLoader to create the Dataset from a file or use a built-in dataset:
from data_morph.data.loader import DataLoader
dataset = DataLoader.load_dataset('panda')
For morphing purposes, all target shapes are placed/sized based on aspects of the Dataset class. All shapes are accessible via the ShapeFactory class:
from data_morph.shapes.factory import ShapeFactory
shape_factory = ShapeFactory(dataset)
target_shape = shape_factory.generate_shape('star')
With the Dataset and Shape created, here is a minimal example of morphing:
from data_morph.morpher import DataMorpher
morpher = DataMorpher(
decimals=2,
in_notebook=False, # whether you are running in a Jupyter Notebook
output_dir='data_morph/output',
)
result = morpher.morph(start_shape=dataset, target_shape=target_shape)
Note that the result variable in the above code block is a pandas.DataFrame of the data after completing the specified iterations of the simulated annealing process. The DataMorpher.morph() method is also saving plots to visualize the output periodically and make an animation; these end up in data_morph/output, which we set as DataMorpher.output_dir.
In this example, we morphed the built-in panda Dataset into the star Shape. Be sure to try out the other built-in options:
The DataLoader.AVAILABLE_DATASETS attribute contains a list of available datasets, which are also visualized in the DataLoader documentation.
The ShapeFactory.AVAILABLE_SHAPES attribute contains a list of available shapes, which are also visualized in the ShapeFactory documentation.
Acknowledgements
This code has been altered by Stefanie Molin (@stefmolin) to work for other input datasets by parameterizing the target shapes with information from the input shape. The original code works for a specific dataset called the “dinosaurus” and was created for the paper Same Stats, Different Graphs: Generating Datasets with Varied Appearance and Identical Statistics through Simulated Annealing by Justin Matejka and George Fitzmaurice (ACM CHI 2017).
The paper, video, and associated code and datasets can be found on the Autodesk Research website here. The version of this code placed on GitHub at jmatejka/same-stats-different-graphs, served as the starting point for the data_morph code base, which is on GitHub at stefmolin/data-morph.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for data_morph_ai-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a1c4f05b44370ceee316ed72411b18cfca6c5ad0f9b0562aea87a292a2f6505e |
|
MD5 | 6596cea0bc5fe33a2b0336322c9c6dae |
|
BLAKE2b-256 | 84288f844cc2043cad865314f5d3c15b74efc367685ccba65207d101f59f0f6b |