Installation

Initial Installation

brewscheme is available for installation/download from the Statistical Software Components Archives (SSC) and the most recent versions of the program are available here from GitHub. The version available from SSC will always be the most recent stable release and with the exception of any patches to fix bugs/minor issues, it generally won't change much. To install this version use:

ssc install brewscheme, replace

The replace option will force it to overwrite an existing installation.

To install the lastest development release of brewscheme you can use:

net inst brewscheme, from("https://wbuchanan.github.io/brewscheme/") rep

The version available from the project page may include newer features/functionality. However, the newer features/functionality are always subject to change.

What's next

Now that you've installed brewscheme there is one additional/manual step that you are required to complete before the programs will work.

Bare bones

The barebones installation requires you to first run the command below:

brewcolordb, replace 

This program then searches your Stata for all named color styles, parses the RGB values, computes the color sight impaired transforms, and stores them in a file along the ADOPATH. This is a necessary step due to the use of named colorstyles and RGB values in scheme and theme files.

Something extra

If you wanted the basic functionality with the additional benefit of lots of named color styles:

brewcolors xkcd, make install replace

The command above also performs the same basic task that brewcolordb performs (as a side effect), but more importantly it installs the named colors from the XKCD survey and then processes those named color styles identically to how the existing named color styles are processed. Once you've completed this last step you should be able to create .theme and .scheme files without issues.