{"id":18399700,"url":"https://github.com/mrc-ide/arbomap","last_synced_at":"2025-04-12T16:23:35.127Z","repository":{"id":228555754,"uuid":"773715879","full_name":"mrc-ide/arbomap","owner":"mrc-ide","description":"Web application displaying dengue indicators","archived":false,"fork":false,"pushed_at":"2024-05-19T08:18:26.000Z","size":85913,"stargazers_count":0,"open_issues_count":7,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-05-19T14:13:01.324Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://mrc-ide.github.io/arbomap/","language":"TypeScript","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/mrc-ide.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"publiccode":null,"codemeta":null}},"created_at":"2024-03-18T09:16:12.000Z","updated_at":"2024-05-20T16:01:36.794Z","dependencies_parsed_at":"2024-05-20T16:14:20.282Z","dependency_job_id":null,"html_url":"https://github.com/mrc-ide/arbomap","commit_stats":null,"previous_names":["mrc-ide/dengue-map","mrc-ide/arbomap"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrc-ide%2Farbomap","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrc-ide%2Farbomap/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrc-ide%2Farbomap/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mrc-ide%2Farbomap/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mrc-ide","download_url":"https://codeload.github.com/mrc-ide/arbomap/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248594359,"owners_count":21130354,"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":[],"created_at":"2024-11-06T02:28:13.970Z","updated_at":"2025-04-12T16:23:35.077Z","avatar_url":"https://github.com/mrc-ide.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ArboMap\n\nWeb application for displaying Dengue (and eventually other arbovirus) indicators on choropleth maps, on desktop and mobile. \n\nThe application is built using [Vue](https://vuejs.org/), [Vuetify](https://vuetifyjs.com/) and [Pinia](https://pinia.vuejs.org/), and is deployed to Github Pages here: [https://mrc-ide.github.io/arbomap/](https://mrc-ide.github.io/arbomap/)\n\n\n## Development\n\nInstall dependencies: `npm ci`\n\nBuild: `npm run build`\n\nRun in development mode, with hot reloading: `npm run dev`\n\nLint: `npm run lint` or `npm run lint-fix`\n\nRun unit tests: `npm run test:unit`\n\nRun e2e tests: `npm run test:e2e`\n\n## Data and Scripts\n\nWe work with two sets of data:\n- indicator values: these are provided by the researchers in the form of xlsx files, and can be found in the `data/raw` \ndirectory, with `Adm1_` and `Adm2_` prefixes. These provide indicator values (force of infection, seroprevalence at age 9,\nand age-stratified hospitalisations) for admin1 and admin2 regions, using GADM's region IDs. \n- geographical data defining the shape and locations of regions: we use GADM's geojson data, which has been simplified\nusing MapShaper. This data can be found in `public/dengue/may24/resources/geojson`.\n\nWhen the app runs, all data is loaded from `public/dengue/may24/resources`. Some of this data has been further processed from the \ndatasets described above. The data files are:\n- `countryNames.json`: a handy mapping of country IDs to names, used for Excel download and country selection. Generated by the\nscript `generate_country_names_from_adm0_geojson.cjs` using data in `geojson/admin0`.\n- `geojson/all_adm1_0_5_pc_by_iso.json`: a single json file containing simplified admin1 level geojson for all countries - this\nis in the form of a dictionary where the country IDs are the keys, and is generated by the script `transform_adm1_geojson_to_dict.cjs`\nusing the file `data/raw/all_adm1_0_5pc.json`, which contains all features in the form of a single FeatureCollection. We load this\nwhen the app first loads, to display the global view with admin1 data from all countries.\n- `geojson/admin0`: country-level geojson, one file per country. We use these to draw an outline around the selected country,\n- `geojson/admin1`: admin1-level geojson, one file per country. We keep this only for the small set of countries which have no admin2 regions (`countriesWithoutAdmin2`\nin config.json). This geojson is more detailed than the simplified regions defined in the `all_adm1..` file. When one of these\ncountries is selected we load and display from these files.\n- `geojson/admin2`: admin2-level geojson, one file per country. When a country is selected, we load and display from these files. \n- `indicators/admin1`: a single file containing all admin1 level indicator values. We load this when the app first loads, to display\nthe global view. Generated from the xlsx file in `data/raw` by the script `process-data.R`\n- `indicators/admin2`: admin2-level indicator values, one file per country, loaded when the country is selected. Generated \nfrom the xlsx file in `data/raw` by the script `process-data.R`\n\nWe also pre-generate the global Excel files available to download through the app. These can be found in the `excel`\nsub-folder of the resources folder. \n\nAll public data is committed to github, and is not currently automatically updated using the scripts. So you need to \nremember to run scripts manually when required:\n\n- if indicator values have changed: run `process-data.R`\n- if admin1 geojson has changed: run `transform_adm_geojson_to_dict.cjs`\n- if there are any changes to the list of countries, or country names: run `generate_country_names_from_adm0_geojson.cjs`\n\nRemember to copy resulting data from the `data/processed` folder to the relevant part of `public/dengue/may24/resources`.\n\n- After copying new indicator values to the resources folder, run `npm run generate:global-excel` to regenerate the \nglobal Excel files. ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrc-ide%2Farbomap","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmrc-ide%2Farbomap","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmrc-ide%2Farbomap/lists"}