Recipe Records

Recipes Wrapper

A ::recipes-wrapper record.

• BeerXML Type: Record Set

Wrapped Record

• Recipes

Recipes

A vector of valid ::recipe records.

Collection Type

• Recipe Wrapper

Recipe Wrapper

A ::recipe record wrapped in a :recipes map.

• BeerXML Type: Record

Wrapped Record

• Recipe

Recipe

A record representing a beer recipe.

Required Keys

• Batch Size
• Boil Size
• Boil Time
• Brewer
• Fermentables
• Hops
• Mash
• Miscellaneous Ingredients
• Name
• Style
• Type
• Version
• Waters
• Yeasts

Optional Keys

• Abv
• Actual Efficiency
• Age
• Aging Temperature
• Assistant Brewer
• Calories
• Carbonation
• Carbonation Temp
• Carbonation Used
• Date
• Display Aging Temperature
• Display Batch Size
• Display Boil Size
• Display Carbonation Temperature
• Display Final Gravity
• Display Original Gravity
• Display Primary Temperature
• Display Secondary Temperature
• Display Tertiary Temperature
• Efficiency
• Equipment
• Estimated ABV
• Estimated Color
• Estimated Final Gravity
• Estimated Original Gravity
• Fermentation Stages
• Final Gravity
• Forced Carbonation
• International Bitterness Units
• Ibu Method
• Keg Priming Factor
• Notes
• Original Gravity
• Primary Age
• Primary Temperature
• Priming Sugar Equivalent
• Priming Sugar Name
• Secondary Age
• Secondary Temperature
• Taste Notes
• Taste Rating
• Tertiary Age
• Tertiary Temperature

Abv

A non-negative IEEE-754 floating point number representing the actual ABV for the recipe.

• BeerXML Type: Floating Point
• BeerXML Unit: ABV
• Clojure Key Name: :abv
• Clojure Type: Double
• Example: 40.2

Actual Efficiency

A non-negative IEEE-754 floating point number representing the actual conversion efficiency between the measured final and original gravities.

• BeerXML Type: Floating Point
• Clojure Key Name: :actual-efficiency
• Clojure Type: Double
• Example: 40.3

Age

A non-negative IEEE-754 floating point number representing the number of days to bottle age the beer.

• BeerXML Type: Floating Point
• BeerXML Unit: Day
• Clojure Key Name: :age
• Clojure Type: Double
• Example: 12.0

Aging Temperature

A non-negative IEEE-754 floating point number representing the temperature in degrees Celsius for bottle aging.

• BeerXML Type: Floating Point
• BeerXML Unit: Degrees Celsius
• Clojure Key Name: :age-temp
• Clojure Type: Double
• Example: 12.0

Assistant Brewer

A non-empty string denoting the name of the assistant brewer.

• BeerXML Type: Text
• Clojure Key Name: :asst-brewer
• Clojure Type: String
• Example: "Dariusz R. Jakubowski"

Batch Size

A non-negative IEEE-754 floating point number representing the target final volume of recipe.

• BeerXML Type: Floating Point
• BeerXML Unit: Liter
• Clojure Key Name: :batch-size
• Clojure Type: Double
• Example: 5.8

Boil Size

A non-negative IEEE-754 floating point number representing the starting volume of the wort.

• BeerXML Type: Floating Point
• BeerXML Unit: Liter
• Clojure Key Name: :boil-size
• Clojure Type: Double
• Example: 7.5

Boil Time

A non-negative IEEE-754 floating point number representing the time in minutes to boil the wort.

• BeerXML Type: Floating Point
• BeerXML Unit: Minute
• Clojure Key Name: :boil-time
• Clojure Type: Double
• Example: 45.0

Brewer

A non-empty string denoting the name of the brewer.

• BeerXML Type: Text
• Clojure Key Name: :brewer
• Clojure Type: String
• Example: "Nick A. Nichols"

Calories

A non-empty string describing the number of dietary calories per serving of this recipe.

• BeerXML Type: Text
• Clojure Key Name: :calories
• Clojure Type: String
• Example: "180 Cal / pint"

Carbonation

An IEEE-754 floating point number representing the carbonation for this recipe in volumes of CO2.

• BeerXML Type: Floating Point
• BeerXML Unit: Volumes of CO2
• Clojure Key Name: :carbonation
• Clojure Type: Double
• Example: 1.5

Carbonation Temp

An IEEE-754 floating point number representing the temperature in degrees Celsius for either bottling or forced carbonation.

• BeerXML Type: Floating Point
• BeerXML Unit: Degrees Celsius
• Clojure Key Name: :carbonation-temp
• Clojure Type: Double
• Example: 12.0

Carbonation Used

A non-empty string denoting a display value for the carbonation measures used formatted for display in arbitrary units.

• BeerXML Type: Text
• Clojure Key Name: :carbonation-used
• Clojure Type: String
• Example: "Kegged at 1.36 atmospheres"

Date

A non-empty string denoting the display date the recipe was created on. Intentionally implemented as a string type to match BeerXML spec.

• BeerXML Type: Text
• Clojure Key Name: :date
• Clojure Type: String
• Example: "2020/05/06"

Display Aging Temperature

A non-empty string denoting a display value for the temperature of the aging step formatted for display in arbitrary units.

• BeerXML Type: Text
• Clojure Key Name: :display-age-temp
• Clojure Type: String
• Example: "68F"

Display Batch Size

A non-empty string denoting a display value for the pre-fermentation volume formatted for display in arbitrary units.

• BeerXML Type: Text
• Clojure Key Name: :display-batch-size
• Clojure Type: String
• Example: "4.5 gallons"

Display Boil Size

A non-empty string denoting a display value for the pre-boil volume formatted for display in arbitrary units.

• BeerXML Type: Text
• Clojure Key Name: :display-boil-size
• Clojure Type: String
• Example: "5.0 gallons"

Display Carbonation Temperature

A non-empty string denoting a display value for the temperature of the bottling step formatted for display in arbitrary units.

• BeerXML Type: Text
• Clojure Key Name: :display-carb-temp
• Clojure Type: String
• Example: "68F"

Display Final Gravity

A non-empty string denoting a display value for the post-fermentation gravity formatted for display in arbitrary units.

• BeerXML Type: Text
• Clojure Key Name: :display-fg
• Clojure Type: String
• Example: "1.050sg"

Display Original Gravity

A non-empty string denoting a display value for the pre-fermentation gravity formatted for display in arbitrary units.

• BeerXML Type: Text
• Clojure Key Name: :display-og
• Clojure Type: String
• Example: "1.050sg"

Display Primary Temperature

A non-empty string denoting a display value for the temperature of the primary fermentation step formatted for display in arbitrary units.

• BeerXML Type: Text
• Clojure Key Name: :display-primary-temp
• Clojure Type: String
• Example: "68F"

Display Secondary Temperature

A non-empty string denoting a display value for the temperature of the secondary fermentation step formatted for display in arbitrary units.

• BeerXML Type: Text
• Clojure Key Name: :display-secondary-temp
• Clojure Type: String
• Example: "68F"

Display Tertiary Temperature

A non-empty string denoting a display value for the temperature of the tertiary fermentation step formatted for display in arbitrary units.

• BeerXML Type: Text
• Clojure Key Name: :display-tertiary-temp
• Clojure Type: String
• Example: "68F"

Efficiency

A non-negative IEEE-754 floating point number representing the percent brewhouse efficiency to be used for estimating the starting gravity of the beer.

• BeerXML Type: Percentage
• Clojure Key Name: :efficiency
• Clojure Type: Double
• Example: 85.6

Estimated ABV

A non-negative IEEE-754 floating point number representing the estimated ABV for the recipe.

• BeerXML Type: Floating Point
• BeerXML Unit: ABV
• Clojure Key Name: :est-abv
• Clojure Type: Double
• Example: 40.1

Estimated Color

A non-empty string describing the calculated color formatted for display in arbitrary units.

• BeerXML Type: Text
• Clojure Key Name: :est-color
• Clojure Type: String
• Example: "30SRM"

Estimated Final Gravity

A non-empty string describing the calculated estimated final gravity formatted for display in arbitrary units.

• BeerXML Type: Text
• Clojure Key Name: :est-fg
• Clojure Type: String
• Example: "1.050sg"

Estimated Original Gravity

A non-empty string describing the calculated estimated original gravity formatted for display in arbitrary units.

• BeerXML Type: Text
• Clojure Key Name: :est-og
• Clojure Type: String
• Example: "1.050sg"

Fermentation Stages

An integer representing the number of fermentation stages in the recipe.

• BeerXML Type: Integer
• Clojure Key Name: :fermentation-stages
• Clojure Type: Long
• Example: 2

Final Gravity

A non-negative IEEE-754 floating point number representing the post-fermentation specific gravity of the recipe.

• BeerXML Type: Floating Point
• BeerXML Unit: Specific Gravity
• Clojure Key Name: :fg
• Clojure Type: Double
• Example: 1.048

Forced Carbonation

A boolean representing if this batch was force carbonated with CO2 pressure. When absent, assume false.

• BeerXML Type: Boolean
• Clojure Key Name: :forced-carbonation
• Clojure Type: Spec
• Example: false

International Bitterness Units

A positive IEEE-754 floating point number representing the bitterness in IBUs for the recipe.

• BeerXML Type: Floating Point
• BeerXML Unit: IBU
• Clojure Key Name: :ibu
• Clojure Type: Double
• Example: 40

Ibu Method

A case-sensitive string representing the method of calculation used derive the IBUs. Must be one of: "Tinseth", "Rager", "Garetz"

• Garetz: The Garetz method of IBU calculation.

• Rager: The Rager method of IBU calculation.

• Tinseth: The Tinseth method of IBU calculation.

• BeerXML Type: List

• Clojure Key Name: :ibu-method

• Clojure Type: String

• Example: "Garetz"

Keg Priming Factor

An IEEE-754 floating point number representing the conversion factor of sugar needed to prime carbonation in large containers.

• BeerXML Type: Floating Point
• Clojure Key Name: :keg-priming-factor
• Clojure Type: Double
• Example: 1.5

Name

A non-empty string representing the name of the ingredient.

• BeerXML Type: Text
• Clojure Key Name: :name
• Clojure Type: String
• Example: "Citra"

Notes

A non-empty string representing any notes about the subject.

• BeerXML Type: Text
• Clojure Key Name: :notes
• Clojure Type: String
• Example: "A wonderful, zesty aroma."

Original Gravity

A non-negative IEEE-754 floating point number representing the pre-fermentation specific gravity of the recipe.

• BeerXML Type: Floating Point
• BeerXML Unit: Specific Gravity
• Clojure Key Name: :og
• Clojure Type: Double
• Example: 1.06

Primary Age

A positive IEEE-754 floating point number representing the number of days spent in primary fermentation.

• BeerXML Type: Floating Point
• BeerXML Unit: Day
• Clojure Key Name: :primary-age
• Clojure Type: Double
• Example: 12.0

Primary Temperature

A non-negative IEEE-754 floating point number representing the temperature in degrees Celsius for primary fermentation.

• BeerXML Type: Floating Point
• BeerXML Unit: Degrees Celsius
• Clojure Key Name: :primary-temp
• Clojure Type: Double
• Example: 12.0

Priming Sugar Equivalent

An IEEE-754 floating point number representing the conversion factor to an equivalent amount of corn sugar.

• BeerXML Type: Floating Point
• Clojure Key Name: :priming-sugar-equiv
• Clojure Type: Double
• Example: 1.5

Priming Sugar Name

A non-empty string denoting the name of the priming agent used to carbonate the beer.

• BeerXML Type: Text
• Clojure Key Name: :priming-sugar-name
• Clojure Type: String
• Example: "Corn Sugar"

Secondary Age

A non-negative IEEE-754 floating point number representing the number of days spent in secondary fermentation.

• BeerXML Type: Floating Point
• BeerXML Unit: Day
• Clojure Key Name: :secondary-age
• Clojure Type: Double
• Example: 12.0

Secondary Temperature

A non-negative IEEE-754 floating point number representing the temperature in degrees Celsius for secondary fermentation.

• BeerXML Type: Floating Point
• BeerXML Unit: Degrees Celsius
• Clojure Key Name: :secondary-temp
• Clojure Type: Double
• Example: 12.0

Taste Notes

A non-empty string denoting any tasting notes.

• BeerXML Type: Text
• Clojure Key Name: :taste-notes
• Clojure Type: String
• Example: "A nice, full body and intense mouthfeel"

Taste Rating

An IEEE-754 floating point number representing the tasting score of the beer.

• BeerXML Type: Floating Point
• Clojure Key Name: :taste-rating
• Clojure Type: Double
• Example: 100.0

Tertiary Age

A non-negative IEEE-754 floating point number representing the number of days spent in tertiary fermentation.

• BeerXML Type: Floating Point
• BeerXML Unit: Day
• Clojure Key Name: :tertiary-age
• Clojure Type: Double
• Example: 12.0

Tertiary Temperature

A non-negative IEEE-754 floating point number representing the temperature in degrees Celsius for tertiary fermentation.

• BeerXML Type: Floating Point
• BeerXML Unit: Degrees Celsius
• Clojure Key Name: :tertiary-temp
• Clojure Type: Double
• Example: 12.0

Type

A case-sensitive string representing the type of recipe. Must be one of: "Partial mash", "All grain", "Extract"

• All Grain: A recipe that uses only malted grains.

• Partial Mash: A recipe that uses a combination of malted grains and malt extract.

• Extract: A recipe that uses only malt extract.

• BeerXML Type: List

• Clojure Key Name: :type

• Clojure Type: String

• Example: "All Grain"

Version

An integer representing the version of the BeerXML standard implemented in a given record. Currently, only 1 exists.

• BeerXML Type: Integer
• Clojure Key Name: :version
• Clojure Type: Long
• Example: 1