Stata package for creating user-defined scheme files using research-based color palettes
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
StataFileSystem @ c7c86f6 Checking in work in progress on the colorContrast branch. Aug 3, 2018
_site Checking in work in progress on the colorContrast branch. Aug 3, 2018
brewschemeExtras Updated submodule dependencies and added the example scheme package i… Jun 2, 2017
brewthemehelp @ 6cd5262 Updated brewthemehelp submodule Mar 21, 2016
examples Updated StataFileSystem to manage issue with relative path Apr 5, 2016
recycle @ 6fffc9a Checking in work in progress on the colorContrast branch. Aug 3, 2018
.gitignore Updated StataFileSystem to manage issue with relative path Apr 5, 2016
.gitmodules Changed submodule reference for recycle Dec 18, 2015
README.md Updated project README and packagefile. Also included the most up-to-… Mar 17, 2016
brewcbsim.ado Fixed potential bug in brewcbsim that would cause an error if too man… May 10, 2017
brewcbsim.sthlp Bumped all version numbers to 1.0.0. Updated brewtheme helpfiles that… Mar 21, 2016
brewcolordb.ado Updated brewcolordb to first check for the presence of the personal s… Nov 9, 2016
brewcolordb.sthlp Bumped all version numbers to 1.0.0. Updated brewtheme helpfiles that… Mar 21, 2016
brewcolors.ado Added fix for brewcolors that points to xkcd's https site. Aug 3, 2018
brewcolors.sthlp Bumped all version numbers to 1.0.0. Updated brewtheme helpfiles that… Mar 21, 2016
brewcontrastratio.ado Updated the display format for brewcontrastratio to display the two c… Apr 13, 2017
brewdb.ado Updated brewdb.ado to only create the personal/b subdirectory if the … Nov 9, 2016
brewextra.ado Added fix for brewcolors that points to xkcd's https site. Aug 3, 2018
brewextra.sthlp Bumped all version numbers to 1.0.0. Updated brewtheme helpfiles that… Mar 21, 2016
brewlibcheck.ado Updated brewlibcheck to rebuild Mata library for users as of 15apr201… Apr 15, 2016
brewmeta.ado Patched bug reported in Issue #42; Also fixed bug reported in Issue #43 Apr 4, 2016
brewmeta.sthlp Bumped all version numbers to 1.0.0. Updated brewtheme helpfiles that… Mar 21, 2016
brewmorepalettes.ado Checking in work in progress on the colorContrast branch. Aug 3, 2018
brewproof.ado Patched bug reported in Issue #42; Also fixed bug reported in Issue #43 Apr 4, 2016
brewproof.sthlp Bumped all version numbers to 1.0.0. Updated brewtheme helpfiles that… Mar 21, 2016
brewscheme-main.pdf Updated article being submitted to StataJournal Mar 18, 2016
brewscheme.ado Modified all calls to dirfile utility due to API changes. Should fix … Nov 9, 2016
brewscheme.pkg Updated the package file distribution date field. Nov 9, 2016
brewscheme.sthlp Patched bug reported in Issue #42; Also fixed bug reported in Issue #43 Apr 4, 2016
brewscheme.stpj New feature added for future release of brewscheme that provides meth… Apr 6, 2016
brewscheme.stpr Patched bug reported in Issue #42; Also fixed bug reported in Issue #43 Apr 4, 2016
brewsearch.ado Fixed bug that caused brewscheme to sometimes copy the colors from a … Apr 3, 2016
brewsearch.sthlp Bumped all version numbers to 1.0.0. Updated brewtheme helpfiles that… Mar 21, 2016
brewterpolate.ado Patched bug reported in Issue #42; Also fixed bug reported in Issue #43 Apr 4, 2016
brewterpolate.jar Updated helpfiles for formatting/consistency. Refactored the use of '… Mar 16, 2016
brewterpolate.sthlp Bumped all version numbers to 1.0.0. Updated brewtheme helpfiles that… Mar 21, 2016
brewtheme.ado Modified all calls to dirfile utility due to API changes. Should fix … Nov 9, 2016
brewtheme.sthlp Bumped all version numbers to 1.0.0. Updated brewtheme helpfiles that… Mar 21, 2016
brewthemedata.do Patched bug reported in Issue #42; Also fixed bug reported in Issue #43 Apr 4, 2016
brewtransform.ado Fixed bug that caused brewscheme to sometimes copy the colors from a … Apr 3, 2016
brewtransform.sthlp Bumped all version numbers to 1.0.0. Updated brewtheme helpfiles that… Mar 21, 2016
brewviewer.ado Patched bug reported in Issue #42; Also fixed bug reported in Issue #43 Apr 4, 2016
brewviewer.sthlp Bumped all version numbers to 1.0.0. Updated brewtheme helpfiles that… Mar 21, 2016
dirfile.ado Patched bug related to checking for/building file paths for the program Oct 14, 2015
filesys.ado Fixed minor bug in issue #25 with brewviewer.ado. Also adjusted how t… Dec 17, 2015
filesys.sthlp Fixed minor bug in issue #25 with brewviewer.ado. Also adjusted how t… Dec 17, 2015
hextorgb.ado Added program to convert Hexadecimal RGB values to Decimal RGB values… Nov 6, 2015
hextorgb.sthlp Added program to convert Hexadecimal RGB values to Decimal RGB values… Nov 6, 2015
libbrewscheme.ado Fixed issue #41 (related to installation of brewscheme in networked e… Apr 5, 2016
libbrewscheme.mata Applies fix to issue #55. Now pure white and pure black RGB values ar… Jun 3, 2017
libbrewscheme.sthlp Updated brewlibcheck to rebuild Mata library for users as of 15apr201… Apr 15, 2016

README.md

NEWS

A help file was added for the brewcolors command and all brewtheme specific and brewscheme documentation has been updated. There have been some minor refactorings implemented to change instances of the option refresh to the more typical Stata syntax replace.

brewscheme

A data visualization toolkit for Stata. This package contains Stata programs; Mata functions, classes, and methods; and Java plugins to make customizing graphs in Stata easier. The major functionality is provided by the brewtheme and brewscheme programs which generate a .theme file (for aesthetic settings that are not specific to a graph/plot type) and .scheme files (which inherit the .theme files and set aesthetic properties specific to plot/graph types). In addition to the user specified/requested aesthetics, these programs also leverage the libbrewscheme Mata library to generate parallel versions of these files with values that simulate the appearance to individuals with achromatopsia (complete color blindness), protanopia (red color sight impairment), deuteranopia (green color sight impairment), and tritanopia (blue color sight impairment).

There are additional programs for color interpolation (brewterpolate), translation between hexadecimal and RGB color spaces (hextorgb), estimating simulated RGB values for the forms of color sight impairments listed above (libbrewscheme), a color palette previewer (brewviewer), and a color vision simulator (brewcbsim).

Together, this provides users with a powerful toolkit to customize their data visualizations generated in Stata and makes it easier and faster to incorporate Stata code into production environments that require standardization.

Examples

To view examples, please see the project website.

References

Bostock, M., Ogievetsky, V., & Heer, J. (2011). D3: data driven documents. IEEE Transactions on Visualization & Computer Graphics. 17(12) pp 2301 - 2309. Retrieved from http://vis.stanford.edu/papers/d3

Brewer, C. A. (2002). Color Brewer 2. [Computer Software]. State College, PA: Cynthia Brewer, Mark Harrower, and The Pennsylvania State University

Krzywinski, M. (2015). Color palettes for color blindness. Retrieved on: 22nov2015. Retrieved from: http://mkweb.bcgsc.ca/colorblind/

Lin, S., Fortuna, J., Kulkarni, C., Stone, M., {c 38} Heer, J. (2013). Selecting Semantically-Resonant Colors for Data Visualization. Computer Graphics Forum 32(3) pp. 401-410. Retrieved from http://vis.stanford.edu/files/2013-SemanticColor-EuroVis.pdf

Lindbloom, B. (2001). RGB working space information. Retrieved from: http://www.brucelindbloom.com/WorkingSpaceInfo.html. Retrieved on 24nov2015.

Meyer, G. W., & Greenberg, D. P. (1988). Color-Defective Vision and Computer Graphics Displays. Computer Graphics and Applications, IEEE 8(5), pp. 28-40. Retrieved from: http://www-users.cs.umn.edu/~meyer/papers/meyer-greenberg-cga-1988.pdf. Retrieved on: 26nov2015

Smith, V. C., & Pokorny, J. (2005). Spectral sensitivity of the foveal cone photopigments between 400 and 500nm. Journal of the Optical Society of America A, 22(10), pp. 2060-2071. Retrieved from: http://macboy.uchicago.edu/~eye1/PDF%20files/Smith%20Pokorny%2075.pdf. Retrieved on: 26nov2015

Wickham, H. (2009). ggplot2: Elegant Graphics for Data Analysis. New York City, NY: Springer Science+Business Media LLC.

Wickline, M. (2014). Color.Vision.Simulate, Version 0.1. Retrieved from: http://galacticmilk.com/labs/Color-Vision/Javascript/Color.Vision.Simulate.js. Retrieved on: 24nov2015.

License Information

Please view section 4 of the ColorBrewer copyright notice for additional information pertaining to the licensing and redistribution of ColorBrew intellectual property.

Additional Info

For additional information/examples about the brewscheme package see Buchanan, W. R. (2015). Brewing color schemes in Stata: Making it easier for end users to customize Stata graphs. Presented 31jul2015 at the 2015 Stata North American Users' Group Meeting. Columbus, OH.