Open Gastronomy Standardv0.6

Standard / Ogs Comp

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)