{"id":16635964,"url":"https://github.com/bhoov/june-vis","last_synced_at":"2025-10-14T22:41:57.451Z","repository":{"id":62573303,"uuid":"337836653","full_name":"bhoov/JUNE-vis","owner":"bhoov","description":"Visualization for the JUNE epidemic and intervention simulation tool","archived":false,"fork":false,"pushed_at":"2021-05-25T13:45:59.000Z","size":12747,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-21T01:47:47.462Z","etag":null,"topics":["covid","covid-19","epidemic-model","epidemics","simulation","visualization"],"latest_commit_sha":null,"homepage":"https://bhoov.github.io/JUNE-vis","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bhoov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-02-10T19:52:00.000Z","updated_at":"2022-11-17T16:03:40.000Z","dependencies_parsed_at":"2022-11-03T18:27:07.354Z","dependency_job_id":null,"html_url":"https://github.com/bhoov/JUNE-vis","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":"bhoov/nbdev_template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bhoov%2FJUNE-vis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bhoov%2FJUNE-vis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bhoov%2FJUNE-vis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bhoov%2FJUNE-vis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bhoov","download_url":"https://codeload.github.com/bhoov/JUNE-vis/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243136058,"owners_count":20241985,"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":["covid","covid-19","epidemic-model","epidemics","simulation","visualization"],"created_at":"2024-10-12T06:05:22.397Z","updated_at":"2025-10-14T22:41:52.431Z","avatar_url":"https://github.com/bhoov.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"# JUNE-vis\n\u003e A dashboard to visualize the JUNE simulation results for epidemic modeling and intervention\n\n\n## Install\n\n`pip install junevis`\n\n## Serve the Example Project\n\nThis code ships with an example project (`mask_wearing`) for the interface. From the command line, run:\n\n`junevis_serve` \n\n## Add new simulation results to JUNE-vis\n\nThe `JUNE` simulation logs events as they occur into hdf5 files called `records`. These are transformed into csv files called `summaries` that are automatically placed into a folder the frontend interface can serve. To create a new visualization from a simulation,\n\n`junevis_create path/to/folder/containing/records`\n\nFor more details on the expected contents of this folder, see [this documentation](`https://bhoov.github.io/JUNE-vis/Create%20Project.html`).\n\n### Changing the homepage\n\nYou will need to clone the source code if you want to change the landing page to describe the set of simulation results deployed. The file to change is in `junevis/client/src/views/Intro.vue` (this is a `.vue` file that contains all the needed HTML, CSS, and javascript).\n\nAfter cloning and making your desired changes, from this project's root:\n\n```\npip install -e .\ncd junevis/client\nnpm install\nnpm run build\njunevis_serve\n```\n\n### Deploying\n\nYou can easily host this for others to see by running `junevis_serve` and exposing (default port) `8000`. \n\n# Walkthrough\n\n## The Explore Page\n\n### The parameter selection grid\n\nChoose which runs to compare across a single dimension:\n\n\u003cimg src=\"nbs/img/Explore_Top.png\" alt=\"Parameter Selecting on the Exploration Page\" width=\"600px\" style=\"max-width: 600pxpx\"\u003e \n\nThe parameter grid (left) is designed so you can view a single simulation by clicking on a valid combination of hyperparameter values. Alternatively, you can highlight all the values of the hyperparameters by clicking on the name of the hyperparameter to compare simulations accross all values of that dimension.\n\n### A card and SIR cruve for every simulation\n\nEvery run is associated with a set of hyperparameters. Its effect can be summarized with an SIR curve, shown as the thumbnail:\n\n\u003cimg src=\"nbs/img/Explore_Cards.png\" alt=\"SIR Cards on the Explore Page\" width=\"600px\" style=\"max-width: 600pxpx\"\u003e \n\n## The Detailed Comparison Page\n\nSometimes we want to compare simulations across more subtle effects, such as the difference in where the infections occurred, shown below:\n\n\u003cimg src=\"nbs/img/Compare_Locs.png\" alt=\"Comparing the Location Details of 2 runs\" width=\"600px\" style=\"max-width: 600pxpx\"\u003e \n\nYou can add any additional plot here to compare between two simulations. Included are SIR curve, ages of the infected, the locations of infection, and a detailed geography overview:\n\n\u003cimg src=\"nbs/img/Compare_Geo.png\" alt=\"Comparing the Geography Details of 2 runs\" width=\"600px\" style=\"max-width: 600pxpx\"\u003e \n\nThe slider will color the background of each region according to the selected dimension at that point in time.\n\n## The Geography Overview\n\nTo see the geographical effects of all simulations at once, we include a special page to sort and observe the peak value at each location for the course of a simulation:\n\n\u003cimg src=\"nbs/img/Geo_Overview.png\" alt=\"Overview of Geography\" width=\"600px\" style=\"max-width: 600pxpx\"\u003e\n\n\n## Known Bugs\n\n- Rendering the geojson associated with the map of England does not work\n- Creating a new project using the PyPI package will overwrite existing projects. We need to move processed projects into a configuration folder in the home directory and symbolically link them to the client\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbhoov%2Fjune-vis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbhoov%2Fjune-vis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbhoov%2Fjune-vis/lists"}