The inlcolor package is an R package that provides access to a variety of color schemes. It is designed to support packages and scripts written by researchers at the United States Geological Survey (USGS) Idaho National Laboratory Project Office (INLPO). The package has a simple and consistent API, and supports qualitative, diverging, and sequential color schemes. It also supports combining color palettes using a hinge location, simulates color blindness, and has few dependencies. The goal of inlcolor is to be a single comprehensive collection of color schemes for maps and graphs in INLPO publications.
To install the current release of the package from CRAN you can use the following command in R:
To install the package along with its dependencies, which are required to run examples in the package help documentation and simulate partial-color blindness, run:
To install the development version of the package, you need to clone the repository and build from source, or run the following commands:
if (!requireNamespace("remotes")) install.packages("remotes")
remotes::install_gitlab(
repo = "inl/inlcolor@develop",
auth_token = Sys.getenv("GITLAB_PAT"),
host = "code.usgs.gov",
dependencies = TRUE
)
The package provides two main functions for interacting with color palettes:
get_colors
This function is used to create a vector of n
colors from the specified color scheme. The function supports qualitative, diverging, and sequential color schemes. The maximum number of colors in a generated palette is dependent on the specified color scheme. The function also supports alpha transparency, color stops, interpolation bias, and color blindness simulation.set_hinge
This function is used to set a hinge location within a color palette. A hinge is a dramatic change in the colors at a location appropriate for your data (such as, at sea level). Examples are given in the package help pages. To access these documents, run:Jason C. Fisher (ORCID iD 0000-0001-9032-8912)
Jason C. Fisher (jfisher@usgs.gov)
To cite inlcolor in publications, please use:
Fisher, J.C., 2023, inlcolor—Color palettes for the U.S. Geological Survey Idaho National Laboratory Project Office: U.S. Geological Survey software release, R package, Reston, Va., https://doi.org/10.5066/P93BDACR.
We welcome your contributions and suggestions for how to make these materials more useful to the community. Please feel free to comment on the issue tracker or open a merge request to contribute.
All contributions to- and interactions surrounding- this project will abide by the USGS Code of Scientific Conduct.
This software is preliminary or provisional and is subject to revision. It is being provided to meet the need for timely best science. The software has not received final approval by the U.S. Geological Survey (USGS). No warranty, expressed or implied, is made by the USGS or the U.S. Government as to the functionality of the software and related material nor shall the fact of release constitute any such warranty. The software is provided on the condition that neither the USGS nor the U.S. Government shall be held liable for any damages resulting from the authorized or unauthorized use of the software.
Any use of trade, product, or firm names is for descriptive purposes only and does not imply endorsement by the U.S. Government.
Unless otherwise noted, this project is in the public domain in the United States because it contains materials that originally came from the United States Geological Survey, an agency of the United States Department of Interior. For more information, see the official USGS copyright policy at copyrights-and-credits.
Additionally, we waive copyright and related rights in the work worldwide through the CC0 1.0 Universal public domain dedication.
This is a human-readable summary of the Legal Code (read the full text).
The person who associated a work with this deed has dedicated the work to the public domain by waiving all of his or her rights to the work worldwide under copyright law, including all related and neighboring rights, to the extent allowed by law.
You can copy, modify, distribute and perform the work, even for commercial purposes, all without asking permission.
In no way are the patent or trademark rights of any person affected by CC0, nor are the rights that other persons may have in the work or in how the work is used, such as publicity or privacy rights.
Unless expressly stated otherwise, the person who associated a work with this deed makes no warranties about the work, and disclaims liability for all uses of the work, to the fullest extent permitted by applicable law. When using or citing the work, you should not imply endorsement by the author or the affirmer.
The Idaho National Laboratory Project Office of the USGS supports the development and maintenance of inlcolor. Resources are available primarily for maintenance and responding to user questions. Priorities on the development of new features are determined by the development team.
Additional metadata about this publication, not found in other parts of the page is in this table.
Publication type | Formal R language package |
---|---|
DOI | 10.5066/P93BDACR |
Year published | 2023 |
Version | 1.0.2 |
IPDS | IP-150749 |