Chromabrew
Convert SRM, EBC, or a list of Lovibond values to another color scale, or to a hex color.
Color values are provided by Barley Dog Brewery here
Usage
Install the library:
npm install --save chromabrew
Require the module:
let chromabrew = ;
Pass options which describe a batch to the Batch
constructor, or directly to the required module. See the list of accepted options below. Call hex
on the returned object to get a color:
srm: 4 ;// => '#ECE61A' ;// => '#ECE61A' ;// => '#F8F753'
Convert between color scales:
let batch = ; batch;// => 4 batch;// => 7.88 batch;// => 4.210535199414287 batch;// => 3.407407407407407
Specify which calculation method was used to determine the provided srm
or ebc
, or which method to use when converting between scales:
let batch = ; batch;// => 14 // defaults to 'morey'batch;// => 14.670088349307665 batch;// => 13.099999999999998 // defaults to 'morey'batch;// => 28.9000740481361 batch;// => '#B26033' // defaults to 'morey'batch;// => '#A85C37'
Options
Primary Options
Any one of the following options must be passed to the module:
option | description | type |
---|---|---|
srm |
the SRM of a batch | Number |
ebc |
the EBC of a batch | Number |
l or lovibond |
the degrees Lovibond of a batch | Number |
batch |
options describing a batch in detail (see below) | Object |
This option may be used in combination with a known color value (srm
, ebc
, or l
) to specify which calculation method was used:
option | description | type |
---|---|---|
calculator |
the SRM calculation method used: 'morey' (default), 'daniels' , 'mosher' , or 'barry' † |
String |
† apparently they let anyone create a beer color scale
Batch Options
The following options define the batch
primary option:
option | description | type |
---|---|---|
mcu |
the MCU of the batch, if it is already known | Number |
v or volume |
the total liquid volume of the wort (required) | Number |
ingredients |
an Array of ingredient options (see below; required) |
Array[Object] |
litres or liters |
whether volume is expressed in litres |
Boolean |
kilograms or kilos |
whether weight of each item in ingredients is expressed in kilograms |
Boolean |
metric |
shortcut to apply both litres and kilograms options |
Boolean |
Ingredient Options
The following options define each ingredient in the ingredients
batch option:
option | description | type |
---|---|---|
l or lovibond |
the value in degrees Lovibond of the ingredient (required) | Number |
w or weight |
the weight of the ingredient used (required) | Number |
Functional Domain
The domain of valid inputs is 0 through 40 SRM. Input values are rounded to the nearest 0.1 SRM within this domain:
=== ;// => true === ;// => true === ;// => true
The 'daniels'
and 'mosher'
SRM calculation scales have a minimum result of 8.4
and 4.7
, respectively. Where a provided srm
would result in a negative mcu
, the mcu
is set to 0:
let daniels = ; daniels;// => 0 daniels;// => 0 daniels;// => 8.4 let mosher = ; mosher;// => 0 mosher;// => 0 mosher;// => 4.7