README.md
In OuhscBbmc/usnavy-billets: Matching Billets and Officers

usnavy-billets

This project explores possibilities of optimally assigning naval officers to billets. The demonstration report is viewable in this report (or alternatively, this location hosted directly within the repository.

The following survey adequately addresses the current project needs, which involves only a few dozen commands and officers in one specialty. The survey framework would need to be generalized and scaled out, depending on the additional volume and types of specializations. https://bbmc.ouhsc.edu/redcap/surveys/?s=7XNAFK337W

Notes:

The project is under the initial direction of Richard C. Childers, CDR NPC, PERS-4415, with advisement from Alvin Roth.
This demonstration was developed primarily by Will Beasley, Assistant Professor of Research, University of Oklahoma College of Medicine, Department of Pediatrics. The code developed for the billet marketplace project is open source and available online.
The project members are appreciative of the open source matchingMarkets R package, (independently developed by Thilo Klein since 2013) that implements the Gale-Shapley (1962) Deferred Acceptance Algorithm. For further discussion, see Roth (2007) Deferred Acceptance Algorithms: History, Theory, Practice, and Open Questions and the 2012 Nobel Prize material.
Further information & Context: Billets and Career Path.

This package can be installed from GitHub after installing the remotes package. Depending on your machine, you may have to first install some of the dependencies (which are listed under the 'Imports', 'Suggests', and 'Remotes' headings). The rJava package is trickiest, because it relies on Java underneath; see that package's documentation for troubleshooting its installation.

install.packages("remotes") # Run this line if the 'remotes' package isn't installed already.
install.packages("rJava")
remotes::install_github(repo="thiloklein/matchingMarkets")
remotes::install_github(repo="OuhscBbmc/usnavy-billets", dependencies=TRUE)

Other installation resources include: The "What is a Package?" section in R Packages by Hadley Wickham, R Packages on DataCamp, Troubleshooting installing packages within RStudio, and The remotes package (which assumes some of the functionality of devtools.