{"id":24642612,"url":"https://github.com/johnsonandjohnson/njmm","last_synced_at":"2025-07-14T00:35:59.060Z","repository":{"id":46292668,"uuid":"302422854","full_name":"johnsonandjohnson/njmm","owner":"johnsonandjohnson","description":"New Jersey Maternal Mortality (NJMM) is an interactive web application that visualizes maternal mortality in the state of New Jersey in order to raise awareness of maternal mortality and make it easier to see how it relates to other potential factors (e.g. access to healthcare).","archived":false,"fork":false,"pushed_at":"2023-04-04T14:25:20.000Z","size":6953,"stargazers_count":9,"open_issues_count":3,"forks_count":2,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-04-01T01:02:35.946Z","etag":null,"topics":["maternal-health","maternal-mortality","new-jersey","r-programming","shiny"],"latest_commit_sha":null,"homepage":"https://johnsonandjohnson.shinyapps.io/njmm/","language":"R","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/johnsonandjohnson.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}},"created_at":"2020-10-08T18:04:20.000Z","updated_at":"2024-01-21T03:32:16.000Z","dependencies_parsed_at":"2023-02-16T23:30:53.101Z","dependency_job_id":null,"html_url":"https://github.com/johnsonandjohnson/njmm","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnsonandjohnson%2Fnjmm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnsonandjohnson%2Fnjmm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnsonandjohnson%2Fnjmm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnsonandjohnson%2Fnjmm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/johnsonandjohnson","download_url":"https://codeload.github.com/johnsonandjohnson/njmm/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253789597,"owners_count":21964702,"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":["maternal-health","maternal-mortality","new-jersey","r-programming","shiny"],"created_at":"2025-01-25T13:12:12.451Z","updated_at":"2025-05-12T17:43:39.138Z","avatar_url":"https://github.com/johnsonandjohnson.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"# __NJ Maternal Mortality Dashboard__\n\n[![NJMMDeploy](https://github.com/johnsonandjohnson/njmm/workflows/NJMMDeploy/badge.svg?branch=main)](https://johnsonandjohnson.shinyapps.io/njmm/)\n\nThis project is a collaboration with the Johnson \u0026 Johnson Women's Health Group\nto build an interactive web application that visualizes maternal mortality\nin the state of New Jersey in order to raise awareness of maternal mortality\nand make it easier to see how it relates to other potential factors\n(e.g. access to healthcare).\n\nLearn more about this effort here - https://medium.com/johnson-johnson-open-source/maternal-mortality-in-new-jersey-680a52fb5bc5.\n\nYou can find the application here - https://johnsonandjohnson.shinyapps.io/njmm/.\n\n\n##  Repository Structure\n- `Root Folder`\n  - This contains the necessary project setup files (e.g. gitignore) as well as our shiny application files\n- `data`\n  - This contains almost all necessary data files (raw, external, and processed)\n  - `raw`\n    - This contains all raw data from our data sources\n  - `processed`\n    - This contains all data files generated from the raw data\n  - `reference`\n    - This contains all reference datasets\n- `renv`\n  - This contains the package management/virtual environment files\n- `explore`\n  - This contains scripts meant to explore usage of different packages or datasets\n- `etl`\n  - This contains all scripts and functions used to convert the raw data into processed data\n  - `layers`\n    - This contains scripts and functions used solely convert raw layer data into processed data\n  - `maternal_mortality`\n    - This contains scripts and functions used soley to convert raw maternal mortality measurement data\n    into processed data\n- `app_utils`\n  - This contains functions being used in shiny application broken out into separate files by functionality\n- `test`\n  - This contains unit tests and test data used to test our functions within utils\n- `logs`\n  - This contains all application logs (that are autogenerated)\n\n\n## Pre-Requisites\n### R\nIn order to help with R development, you'll need to install `renv` which manages the dependencies for this project.\n\nIf you're on a Mac, please follow the steps here to configure your computer for package compilation beforehand - https://thecoatlessprofessor.com/programming/cpp/r-compiler-tools-for-rcpp-on-macos/.\n\nThe following script will check if you have renv and then install any packages you may not have.\n\n```r\npacman::p_install(renv, force = F, try.bioconductor = F)\nrenv::restore()\n```\n\nFor package dependencies, you may additionally need to follow these steps:\n\n- Install udunits with homebrew `homebrew install udunits`\n- Install the `units` library outside p_load with `install.packages(\"units\")`\n- Install the `systemfonts` library outside of p_load with `install.packages(\"systemfonts\")`\n- (re)install XQuartz from https://www.xquartz.org/ \n- Restart your computer/R\n\n## Testing\nWe use `testthat` for testing our utility functions. In order to run our test, just run the following command\nin the shell.\n\n```bash\nRscript test/testthat.R\n```\n\n## Styling\nWe use the `styler` package to ensure our code adheres to the [tidyverse code style guide](https://style.tidyverse.org/). A quick guide for installation and usage can be found [here](https://styler.r-lib.org/).\n\nFor the purposes of this project, we utilize the `style_file` and `style_dir` functions which automatically style individual files and entire directories, respectively. \n\n```r\npacman::p_load(styler)\nstyle_file(path_to_file)\nstyle_dir(path_to_directory)\n```\n\n## Our Workflow\n- Our Methods and Tools\n  - Static Code Analysis - [lintr](https://github.com/jimhester/lintr)\n  - Git Strategy - Git Flow via Pull Requests\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnsonandjohnson%2Fnjmm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohnsonandjohnson%2Fnjmm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnsonandjohnson%2Fnjmm/lists"}