OGS Composition Model Specification
Open Gastronomy Standard — Composition v0.6
1. Overview
This specification defines how dishes and beverages are structurally modeled in OGS. It establishes controlled vocabularies for component roles, cooking methods, and transformation indicators that together describe how individual ingredients combine into a finished dish.
2. Component Roles
Each component in a dish is assigned a role from the following controlled vocabulary:
| Role | Label | Definition |
|---|---|---|
main_protein |
main protein | The principal protein element: meat, poultry, fish, seafood, egg, legumes or tofu. |
main_vegetable |
main vegetable | The principal vegetable element, when a vegetable is the center of the dish or its main accompaniment. |
starch |
starch | The starchy base: rice, pasta, noodles, bread, potato, grains or dumpling wrappers. |
sauce |
sauce | A liquid or semi-liquid element served with or over the dish: sauce, jus, dressing, broth or purée. |
fat_component |
fat component | An element added mainly for fat and richness: butter, oil, cream or rendered fat. |
acid_component |
acid component | An element added mainly for acidity: vinegar, citrus, pickles, fermented vegetables or yogurt. |
aromatic_garnish |
aromatic garnish | Herbs, flowers, zest, microgreens or other finishing elements added for aroma. |
seasoning |
seasoning | Salt, pepper, spices, spice blends and condiments that season the dish rather than form part of it. |
textural_element |
textural element | An element added mainly for contrasting texture: crumbs, crisps, nuts, seeds or tuiles. |
sweet_element |
sweet element | The principal sweet element of a dessert or sweet dish: fruit, custard, cream, ice cream, chocolate, cake or pastry. |
A single ingredient MAY fulfill multiple roles. For example, a lemon vinaigrette could be both sauce and acid_component.
3. Cooking Methods Vocabulary
The cooking methods are listed in vocab/cooking_methods.json:
| Method | Label | Definition |
|---|---|---|
raw |
raw | Served without being heated. |
seared |
seared | Cooked briefly over very high heat to brown the surface, leaving the inside less cooked. |
grilled |
grilled | Cooked by direct radiant heat from below (charcoal, gas or wood) or above (a broiler or salamander). |
barbecued |
barbecued | Cooked slowly with indirect heat and wood smoke, as in American barbecue. Cooking over direct heat is grilled. |
roasted |
roasted | Cooked by dry heat in an oven or on a spit, usually uncovered, so the surface browns. |
baked |
baked | Cooked by dry heat in an oven; used mostly for bread, pastry, cakes and casseroles. |
gratinated |
gratinated | Topped with cheese, breadcrumbs or sauce and browned under high heat. |
braised |
braised | Browned, then cooked slowly, covered, in a small amount of liquid. |
stewed |
stewed | Cut into pieces, cooked slowly covered in liquid, and served in it. |
poached |
poached | Cooked gently in liquid well below the boil, at about 70–85 °C. |
simmered |
simmered | Cooked gently in liquid just below the boil, with small bubbles. |
boiled |
boiled | Cooked in liquid at a full, rolling boil. |
blanched |
blanched | Plunged briefly into boiling water, usually then cooled at once in iced water to stop the cooking. |
steamed |
steamed | Cooked in steam above, not in, boiling liquid. |
pressure_cooked |
pressure-cooked | Cooked in a sealed pot under pressure, at about 115–120 °C. |
slow_cooked |
slow-cooked | Cooked at low temperature, below a simmer, for many hours. |
sous_vide |
sous vide | Vacuum-sealed and cooked in a water bath held at a precise temperature, often for a long time. |
fried |
deep-fried | Cooked submerged in hot fat, usually at 160–190 °C. Cooking in a shallow layer of fat is pan-fried or stir-fried. |
pan_fried |
pan-fried | Cooked in a shallow layer of fat in a pan, turned once or twice. |
sauteed |
sautéed | Cooked quickly in a little fat over high heat while being tossed or turned. |
stir_fried |
stir-fried | Cooked quickly over very high heat in a little fat, stirred and tossed constantly, as in a wok. |
confit |
confit | Cooked slowly submerged in fat at low temperature, and often stored in it. |
smoked |
smoked | Flavored, and sometimes cooked, by smoke: hot-smoked food is cooked, cold-smoked food is not. |
charred |
charred | Surface deliberately blackened by intense heat, for bitter, smoky notes. |
toasted |
toasted | Browned by dry heat without fat, as nuts, seeds, spices or bread. |
caramelized |
caramelized | Browned until sugars caramelize, giving sweet, nutty and slightly bitter notes, as caramel or the top of a crème brûlée. |
glazed |
glazed | Coated with a shiny layer of reduced stock, sugar, honey or sauce, often in the last minutes of cooking. |
flambeed |
flambéed | Doused with spirit that is set alight. This adds caramelized notes, but much of the alcohol remains. |
reduced |
reduced | Liquid simmered down to concentrate its flavor and thicken it. |
emulsified |
emulsified | Fat and water blended into an emulsion, stable as in mayonnaise or temporary as in hollandaise and beurre blanc. |
marinated |
marinated | Soaked in a seasoned, often acidic liquid before cooking or serving, including raw fish firmed by acid, as in ceviche. |
cured |
cured | Preserved with salt, often with sugar, nitrite or nitrate, which draws out moisture, as ham, bacon or gravlax. |
pickled |
pickled | Preserved in vinegar, or in brine in which it lacto-ferments. |
fermented |
fermented | Transformed by yeasts, bacteria or molds, as kimchi, miso or sourdough. |
dehydrated |
dried | Moisture removed by air, low heat, sun or freeze-drying. |
dry_aged |
dry-aged | Meat matured uncovered for weeks in controlled cold and humidity, which concentrates its flavor and tenderizes it. |
4. Maillard Index
The Maillard index quantifies the degree of browning reaction (Maillard reaction and caramelization) applied to a component:
| Value | Anchor Description |
|---|---|
| 0 | No browning — raw, blanched, steamed, poached |
| 1 | Light — pale gold, minimal crust (light sauté) |
| 2 | Golden — even golden-brown crust (well-sautéed, toasted) |
| 3 | Deep brown — substantial crust, rich browning (well-seared, roasted) |
| 4 | Dark — dark brown with charred edges (high-heat grilling, deep roast) |
| 5 | Fully charred — deliberately blackened surface |
The Maillard index is measured on a 0–5 integer scale. Values MUST be integers between 0 and 5 inclusive.
5. Reduction Level
For sauces and liquid components, the reduction level indicates concentration:
| Value | Anchor Description |
|---|---|
| 0 | No reduction — stock, broth, or liquid as-is |
| 1 | Light reduction — slightly concentrated, still fluid |
| 2 | Moderate reduction — noticeably thickened, coat-a-spoon |
| 3 | Heavy reduction — significantly concentrated, syrupy |
| 4 | Near-glace — very thick, intensely concentrated |
| 5 | Glace-level — fully reduced to a syrupy glaze |
The reduction level is measured on a 0–5 integer scale. Values MUST be integers between 0 and 5 inclusive.
6. Composition Structure
A dish's composition is expressed as an array of components, each describing one element of the dish:
"components": [
{
"role": "main_protein",
"ingredient_ref": "ogs:core:ingredient:wagyu-beef",
"cooking_method": "seared",
"maillard_index": 3,
"sensory_contribution": {
"basic_tastes": {
"umami": 8.0,
"salty": 3.0
},
"aromatics": [
{
"family": "savory",
"group": "meat",
"item": "beef_fat",
"qualifier": "cooked",
"intensity": 7.0
}
],
"texture": ["tender", "juicy"]
}
},
{
"role": "sauce",
"ingredient_ref": "ogs:core:ingredient:black-truffle",
"cooking_method": "sauteed",
"maillard_index": 1,
"reduction_level": 3,
"sensory_contribution": {
"basic_tastes": {
"umami": 7.0
},
"aromatics": [
{
"family": "earth",
"group": "fungal",
"item": "truffle",
"intensity": 9.0
}
]
}
}
]
6.1 Component Fields
| Field | Type | Required | Description |
|---|---|---|---|
role |
string | YES | Component role from controlled vocabulary (Section 2) |
ingredient_ref |
string | one of | OGS ID reference to the ingredient entity |
preparation_ref |
string | one of | OGS ID of another dish used as a sub-preparation, such as a sauce or stock (new in v0.5) |
cooking_method |
string | NO | Cooking method from controlled vocabulary (Section 3) |
maillard_index |
integer | NO | Browning level, 0–5 (Section 4) |
reduction_level |
integer | NO | Concentration level for liquids, 0–5 (Section 5) |
proportion |
string | NO | Relative proportion: dominant, significant, accent, trace |
share |
number | NO | Approximate share of the dish by weight, 0–1 (new in v0.5) |
sensory_contribution |
object | NO | Partial sensory profile describing this component's contribution to the dish |
A component references exactly one of ingredient_ref or preparation_ref.
6.3 Sub-Preparations (new in v0.5)
Sauces, stocks, doughs and garnishes are often dishes in their own right, made of several ingredients and cooked in their own way. Such a part is published as its own dish document and referenced with preparation_ref:
"components": [
{ "role": "main_protein", "ingredient_ref": "ogs:core:ingredient:beef-fillet", "cooking_method": "pan_fried" },
{ "role": "sauce", "preparation_ref": "ogs:core:dish:sauce-au-poivre" }
]
A sub-preparation is a dish document; its course is usually omitted. Sub-preparation references MUST NOT form a cycle, and a dish's dietary.contains SHOULD include the allergens of its sub-preparations, as it does those of its ingredients.
6.2 Proportion Values
| Value | Description |
|---|---|
dominant |
The primary element by volume/weight (>40% of dish) |
significant |
A major element (15–40%) |
accent |
A supporting element (5–15%) |
trace |
A finishing or seasoning element (<5%) |
7. Dish-Level Fields
Beyond composition, a dish entity carries these additional fields:
| Field | Type | Required | Description |
|---|---|---|---|
cuisine |
string | NO | Cuisine reference, e.g. ogs:core:cuisine:italy (see vocab/cuisines.json). Free text such as "italian" is accepted for v0.1 compatibility but does not meet L2. |
service_temperature |
string | NO | One of: frozen, cold, cool, room, warm, hot, very_hot |
serve_temperature_c |
object | NO | Serving range in °C, {"min": 55, "max": 65} (new in v0.5) |
course |
string | NO | A course from vocab/courses.json (§7.1) |
overall_sensory_profile |
object | YES | Complete sensory profile of the finished dish (see OGS Sensory) |
dietary |
object | NO | Allergens and diets (optional module, see OGS Allergens and Diet) |
7.1 Courses
| Course | Label | Definition |
|---|---|---|
amuse |
amuse-bouche | A single complimentary bite served before the first course. |
appetizer |
appetizer | A first course or starter, lighter than the main course. |
soup |
soup | A course in which soup is the dish, served hot or cold. |
salad |
salad | A course in which a salad is the dish, served as a first course or after the main course. |
fish |
fish course | A fish or seafood course between the first course and the main, as in a classical menu. |
main |
main course | The principal and usually most substantial course. |
side |
side dish | A dish served alongside a main rather than as a course of its own. |
cheese |
cheese course | Cheese served as a course of its own, before or after dessert. |
pre_dessert |
pre-dessert | A small, light course before dessert that refreshes the palate, such as a sorbet. |
dessert |
dessert | The sweet course at the end of a meal. |
petit_four |
petit four | Small sweets and pastries served with coffee or tea after dessert. |
snack |
snack | A small dish eaten between meals or with drinks. |
breakfast |
breakfast | A dish served at breakfast. |
7.2 Ingredient Categories
An ingredient's category comes from vocab/ingredient_categories.json. Diets name the categories they exclude, so a validator can check a vegetarian claim against an ingredient in category meat (OGS Allergens and Diet §4). meat, poultry, fish, seafood, egg, condiment and alcohol are new in v0.6; earlier documents used protein for meat, fish and egg, and that remains valid.
| Category | Label | Definition |
|---|---|---|
meat |
meat | Meat of mammals, including game: beef, pork, lamb, goat, venison. |
poultry |
poultry | Chicken, duck, turkey, goose and game birds. |
fish |
fish | Fish, fresh, cured or preserved. |
seafood |
seafood | Crustaceans, mollusks and other seafood that is not fish, such as sea urchin. |
egg |
egg | Eggs, usually hen's eggs. |
protein |
other protein | Other protein foods, such as tofu, tempeh and seitan. |
dairy |
dairy | Milk and milk products other than butter: cream, cheese, yogurt. |
fat |
fat | Fats and oils: butter, olive oil, lard, rendered fat. |
vegetable |
vegetable | Vegetables, including leaves, roots, alliums and squashes. |
fruit |
fruit | Fruit, fresh or dried. |
fungus |
fungus | Mushrooms, truffles and other fungi. |
legume |
legume | Beans, lentils, chickpeas, peas, soybeans and peanuts. |
grain |
grain | Cereals and their products: rice, wheat, corn, oats, flour, pasta, bread. |
nut |
nut | Tree nuts: almond, hazelnut, walnut, pistachio, cashew. |
seed |
seed | Edible seeds: sesame, sunflower, pumpkin, chia, flax. |
herb |
herb | Leafy herbs, fresh or dried. |
spice |
spice | Dried seeds, barks, roots, fruits and stigmas used for flavor: pepper, cumin, cinnamon, saffron. |
salt |
salt | Salt in its forms: sea salt, rock salt, flavored salts. |
sweetener |
sweetener | Sugar, honey, syrups and other sweeteners. |
acid |
acid | Ingredients used mainly for acidity: vinegar, citrus juice, verjuice. |
condiment |
condiment | Prepared seasonings used as ingredients: soy sauce, fish sauce, miso, mustard, ketchup. |
alcohol |
alcohol | Wine, spirits, beer and other alcoholic drinks used as ingredients. |
other |
other | Anything else, such as stocks and prepared bases. |
8. Beverage Composition Fields
| Field | Type | Required | Description |
|---|---|---|---|
type |
string | YES | A type from vocab/beverage_types.json (§8.2) |
kind |
string | NO | product (a specific bottle or SKU) or style (a category such as "young Barolo"); new in v0.5 |
subtype |
string | NO | Free-text subtype (e.g. "sparkling", "ipa", "stout") |
grape_varieties |
array | NO | Variety names, or {"variety": "Chardonnay", "share": 0.4} objects (shares new in v0.5) |
vintage |
integer or "NV" |
NO | Harvest year, or "NV" for a non-vintage blend ("NV" new in v0.5) |
region |
LString | NO | Production region |
appellation |
LString | NO | Official appellation or denomination |
producer |
LString | NO | Producer or winery name |
abv |
number | NO | Alcohol by volume, percent. Non-alcoholic versions use a low abv and the alcohol_free diet |
residual_sugar |
number | NO | Residual sugar in g/L |
serve_temperature_c |
object | NO | Serving range in °C |
style |
object | NO | Controlled style attributes (§8.1, new in v0.5) |
dietary |
object | NO | Allergens and diets, e.g. sulphites (see OGS Allergens and Diet) |
Products and styles. Most recommendations name a style ("a young Barolo", "a dry Riesling") rather than a bottle. A style document describes the typical profile of that category and SHOULD NOT name a producer or a numeric vintage. A product document describes one bottle or SKU.
Cocktails are described as beverages, by their sensory profile, abv and style.base. Mixing specifications (recipes, measures) stay out of scope (OGS Core §1.2).
8.1 Style Attributes
| Field | Values | Applies to |
|---|---|---|
color |
red, white, rose, orange (skin-contact white), amber, tawny |
wine |
sweetness |
dry, off_dry, medium_sweet, sweet, luscious |
wine, cider, mead, sake, beer, spirit (liqueurs), cocktail |
dosage |
brut_nature, extra_brut, brut, extra_dry, dry, demi_sec, doux |
sparkling wine and cider (types wine, cider) |
methods |
production methods from vocab/beverage_methods.json (§8.3) |
any |
tea_type |
white, green, yellow, oolong, black, dark (herbal is accepted for compatibility; from v0.6 herbal drinks are type infusion) |
tea, kombucha (its base tea) |
roast_level |
light, medium, medium_dark, dark |
coffee |
ibu |
number | beer |
base |
free-text base spirits or components | cocktail |
"style": {
"color": "white",
"sweetness": "dry",
"dosage": "brut",
"methods": ["traditional_method", "lees_aged"]
}
From v0.5, methods MUST come from the vocabulary to meet L2; validators SHOULD warn about an attribute used on a type it does not describe (type other is exempt).
8.2 Beverage Types
| Type | Label | Definition |
|---|---|---|
wine |
wine | Fermented grape juice, including sparkling, fortified and sweet wine. |
beer |
beer | A fermented drink brewed from malted cereals, usually flavored with hops. |
cider |
cider | Fermented apple juice; perry, made from pears, is included. |
mead |
mead | Fermented honey and water, sometimes with fruit or spices. |
sake |
sake | A brewed drink of polished rice, koji and water, made by multiple parallel fermentation. |
spirit |
spirit | A distilled drink, including liqueurs and flavored spirits. |
cocktail |
cocktail | A mixed drink of two or more ingredients, alcoholic or not. |
coffee |
coffee | A drink brewed from roasted coffee beans. |
tea |
tea | A drink brewed from the leaves of the tea plant, Camellia sinensis. |
infusion |
infusion | A drink steeped from plants other than the tea plant: herbs, flowers, fruit or rooibos. |
cocoa |
hot chocolate | A drink made from cocoa or chocolate, usually with milk. |
juice |
juice | Fruit or vegetable juice. |
milk |
milk | Milk and milk drinks, including fermented ones such as lassi, kefir and ayran, and plant-based milks. |
soft_drink |
soft drink | A non-alcoholic, usually sweetened and carbonated flavored drink. |
kombucha |
kombucha | Sweetened tea fermented by a culture of yeast and bacteria. |
water |
water | Still or sparkling water. |
other |
other | A beverage that fits no other type. |
8.3 Production Methods
applies_to in the vocabulary names the types a method usually describes; it is advisory.
| Method | Label | Definition | Usually for |
|---|---|---|---|
oak_aged |
oak-aged | Matured in oak barrels, or with oak staves or chips, gaining vanilla, spice, toast and tannin. | wine, spirit, beer, cider |
barrel_fermented |
barrel-fermented | Fermented in barrel rather than tank, for texture and well-integrated oak. | wine, beer, cider |
lees_aged |
lees-aged | Aged on the spent yeast (lees), often stirred, for a creamy texture and bread or brioche notes. | wine, cider |
malolactic |
malolactic conversion | Sharp malic acid converted by bacteria into softer lactic acid, often adding buttery notes. | wine, cider |
skin_contact |
skin contact | White grapes fermented on their skins, gaining color, tannin and grip (orange or amber wine). | wine |
carbonic_maceration |
carbonic maceration | Whole bunches fermented intact under carbon dioxide, for bright, juicy fruit and low tannin, as in much Beaujolais. | wine |
amphora_aged |
amphora-aged | Fermented or aged in clay vessels such as amphora, qvevri or tinaja. | wine |
botrytised |
botrytized | Made from grapes shriveled by noble rot (Botrytis cinerea), for concentrated sweetness and honey, apricot and saffron notes. | wine |
dried_grape |
dried-grape | Made from grapes dried after picking to concentrate sugar and flavor (appassimento, passito), as Amarone or vin santo. | wine |
late_harvest |
late harvest | Made from grapes left on the vine to ripen further, usually for sweet wine. | wine |
ice_wine |
ice wine | Made from grapes frozen on the vine and pressed while frozen. Ice cider is usually made by freezing the apple juice instead (cryoconcentration). | wine, cider |
fortified |
fortified | Strengthened with grape spirit during or after fermentation, as port, sherry or madeira. | wine |
oxidative |
oxidative | Deliberately exposed to oxygen during aging, for nutty, bruised-apple and caramel notes. | wine |
flor_aged |
flor-aged | Aged under a film of flor yeast (biological aging), as fino and manzanilla sherry or vin jaune. | wine |
solera |
solera | Aged by fractional blending through a tiered set of barrels, as sherry and some brandies and rums. | wine, spirit |
traditional_method |
traditional method | Made sparkling by a second fermentation in the bottle it is sold in, as Champagne, Cava or Crémant. | wine, cider |
tank_method |
tank method | Made sparkling by a second fermentation in a pressurized tank (Charmat), as most Prosecco. | wine, cider |
ancestral_method |
ancestral method | Bottled before the first fermentation finishes, which ends in the bottle (pét-nat). | wine, cider |
natural |
natural | Made with minimal intervention: native yeasts and little or no added sulfites, fining or filtration. There is no single legal definition. | wine, cider, beer |
spontaneous_fermentation |
spontaneous fermentation | Fermented by wild yeasts and bacteria from the environment, without added cultures, as lambic. | wine, beer, cider |
unfiltered |
unfiltered | Bottled without filtration, so it may be hazy or carry sediment. Muroka sake skips charcoal filtration; cloudy nigori sake is coarsely pressed, not unfiltered. | wine, beer, cider, sake |
dealcoholised |
dealcoholized | Alcohol removed after fermentation, by vacuum distillation, reverse osmosis or spinning cone. | any |
top_fermented |
top-fermented | Fermented warm with ale yeast, which gives fruity esters, as ales, wheat beers and stouts. | beer |
bottom_fermented |
bottom-fermented | Fermented cool with lager yeast and conditioned cold, for a clean profile, as lagers and pilsners. | beer |
dry_hopped |
dry-hopped | Hops added after the boil, during or after fermentation, for aroma without bitterness. | beer, cider |
sour_fermented |
sour-fermented | Soured by lactic acid bacteria or mixed fermentation, as Berliner Weisse, gose or kettle sours. | beer |
bottle_conditioned |
bottle-conditioned | Carbonated by a further fermentation in the bottle, leaving a yeast sediment. | beer, cider |
barrel_aged |
barrel-aged | Matured in barrels that previously held another drink, such as bourbon, sherry or wine, taking on its character. | any |
nitro |
nitro | Served with nitrogen instead of, or as well as, carbon dioxide, for a dense, creamy head. | beer, coffee |
smoked |
smoked | Smoke added during production: smoked malt (rauchbier), peated whisky, smoked tea (lapsang souchong). | any |
junmai |
junmai | Pure rice sake, with no distilled alcohol added. | sake |
unpasteurized |
unpasteurized | Not heat-treated, so it keeps fresher, more volatile aromas; sake made this way is namazake. | sake, beer |
pot_still |
pot still | Distilled in batches in a pot still, for a lower-proof, fuller-bodied and more flavorful spirit. | spirit |
column_still |
column still | Distilled continuously in a column still, for a higher-proof, lighter-bodied spirit. | spirit |
cask_strength |
cask strength | Bottled at or near barrel strength, without dilution. | spirit |
washed |
washed process | Fruit removed before the coffee beans are dried, for clean, bright acidity. | coffee |
dry_processed |
natural process | Coffee beans dried inside the whole cherry, for heavy body and ripe-fruit notes. | coffee |
honey_processed |
honey process | Coffee beans dried with some of the cherry's sticky pulp left on; between washed and natural. | coffee |
espresso |
espresso | Brewed by forcing hot water through finely ground coffee at about 9 bar. | coffee |
filter |
filter | Brewed by pouring hot water over ground coffee that drains through a filter, as pour-over or drip. | coffee |
immersion |
immersion | Grounds or leaves steeped in the water and then separated, as a French press or teapot. | coffee, tea |
cold_brew |
cold brew | Steeped in cold water for many hours; the result tastes smoother and less acidic. | coffee, tea |
decaffeinated |
decaffeinated | Most of the caffeine removed. | coffee, tea |
steamed |
steamed | Leaves steamed to stop oxidation, the Japanese method for green tea such as sencha, giving grassy, marine notes. | tea |
pan_fired |
pan-fired | Leaves heated in a pan or drum to stop oxidation, the usual Chinese method for green tea, giving toasty, nutty notes. | tea |
shaded |
shaded | Tea bushes shaded for weeks before harvest, which raises umami and sweetness, as gyokuro and matcha. | tea |
roasted |
roasted | Leaves roasted after processing, for toasty, nutty notes, as hojicha or roasted oolong. | tea |
9. References
- OGS Core — Core Specification (ID format, versioning)
- OGS Sensory — Sensory Model (scales, aromatics, textures)
- OGS Matching — Matching Model (how composition informs pairing)