{"id":13693306,"url":"https://github.com/huda-lab/synner","last_synced_at":"2025-05-02T21:32:00.154Z","repository":{"id":41058350,"uuid":"204450857","full_name":"huda-lab/synner","owner":"huda-lab","description":"Generating Realistic Synthetic Data","archived":false,"fork":false,"pushed_at":"2024-02-15T13:18:37.000Z","size":12860,"stargazers_count":31,"open_issues_count":13,"forks_count":7,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-11-12T19:41:23.944Z","etag":null,"topics":["angularjs","chi","d3","data-generator","gui","hci","research","research-paper","research-project","sketches","user-experience","user-interface","visualization"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/huda-lab.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2019-08-26T10:18:55.000Z","updated_at":"2024-10-17T05:49:44.000Z","dependencies_parsed_at":"2024-04-08T02:33:33.517Z","dependency_job_id":null,"html_url":"https://github.com/huda-lab/synner","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huda-lab%2Fsynner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huda-lab%2Fsynner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huda-lab%2Fsynner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/huda-lab%2Fsynner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/huda-lab","download_url":"https://codeload.github.com/huda-lab/synner/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252108916,"owners_count":21696158,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angularjs","chi","d3","data-generator","gui","hci","research","research-paper","research-project","sketches","user-experience","user-interface","visualization"],"created_at":"2024-08-02T17:01:08.225Z","updated_at":"2025-05-02T21:31:55.509Z","avatar_url":"https://github.com/huda-lab.png","language":"JavaScript","funding_links":[],"categories":["Process-driven methods","JavaScript"],"sub_categories":["Tabular"],"readme":"# Synner\n\nSynner is a tool that helps users generate real-looking synthetic data by visually and declaratively specifying the \nproperties of the dataset such as each field’s statistical distribution, its domain, and its relationship to other fields. \nIt provides instant feedback on every user interaction by updating multiple visualizations of the generated dataset and \neven suggests data generation specifications from a few user examples and interactions. Synner visually communicates \nthe inherent randomness of statistical data generation.\n\n![screenshot](https://github.com/huda-lab/synner/blob/resources/synner-ui-sigmod.png)\n\n## Publications\n\n**[Is this Real? Generating Synthetic Data that Looks Real](https://dl.acm.org/doi/10.1145/3332165.3347866)**\n\u003cbr/\u003e\n\u003cspan style=\"font-size:80%\"\u003eMiro Mannino, Azza Abouzied - UIST'19\u003c/span\u003e\n\n**[Synner: Generating Realistic Synthetic Data](https://dl.acm.org/doi/abs/10.1145/3318464.3384696)**\n\u003cbr/\u003e\n\u003cspan style=\"font-size:80%\"\u003eMiro Mannino, Azza Abouzied - SIGMOD'20\u003c/span\u003e\n\n## Videos\n\n[Demo video](https://www.youtube.com/watch?v=5LuHyJsKY3I)\n\n[Short Demo video](https://www.youtube.com/watch?v=dS6dS5JdNr8)\n\n[SIGMOD'20 - Demo session](https://youtu.be/2LaLpc2r1U4)\n\n## Repository Content\n\nThis repository contains:\n\nSynner's source code and the datasets we used for our publications.\n\n## How to run Synner\n\nSynner can be run as a server, which also provides the user interface, or as a command line interface application.\n\n### Running the server\n\nSynner server can be run by launching the main static method in `edu.nyu.dtl.synner.SynnerServerApplication`.\nThis method will run Synner's server as a Spring Boot application in port 5042.\n\n#### Running using Docker\n\nTo build the image execute:\n\n```bash\n./build-docker-image.sh\n```\n\nTo run the image:\n\n```bash\n./run-docker-image.sh\n```\n\n### Command line interface\n\nSynner can be launched from the command line interface with Java by using the main static method in \nclass `edu.nyu.dtl.synner.core.Main`\n\nThis method accepts a path of a JSON file as a console argument, where the generation specification script is saved.\n\nFor example:\n\n```bash\n  java -classpath \"...\" edu.nyu.dtl.synner.core.Main my-specifications.json\n```\n\nThis generation specification script can be saved from the User Interface with \"Script -\u003e Save\"\n\n### Building from source\n\nTo build the back end:\n\n```bash\ncd /path/to/synner\nmvn clean package\n```\n\nTo build the front-end:\n\n```bash\ncd /path/to/synner/synner-server/src/main/resources/static\nbower install\nnpx sass main.scss main.css\n```\n\nThis can either be launched directly from the `src/main/` with:\n\n```bash\ncd /path/to/synner/synner-server/src/main/resources/static\nnpm run live-server\n```\n\nOr it can be run using the Synner server running with Spring Boot.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuda-lab%2Fsynner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhuda-lab%2Fsynner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhuda-lab%2Fsynner/lists"}