Skip to content

Map Production State

Map raw rows into the scenario's production state table: the outcome of production. It records how many units of each recipe were produced at each site, and the conversion cost realized.

This is the observed side of production. Pair it with Map Production Policy for the rule.

When to use this

  • You have a baseline of what was produced and want Cost to Serve to roll production cost into finished goods
  • You're importing observed manufacturing volumes rather than optimizing them

Network Optimization writes this table itself from its production decision. Map it only when you have an observed baseline to load.

What you need

  • A Map Bill of Materials node defining each recipe
  • An upstream Import Data node with one row per (location, recipe) that was produced
  • A produced-quantity column, and optionally the realized conversion cost

Field mapping

Auto-detection is all or nothing. With no explicit mapping on the node, every field is matched against the headers listed below, case-insensitively, and a space in your header reads as an underscore, so Site Name matches site_name. Set even one field explicitly and detection switches off for the whole node: only the fields named in the mapping are filled, and the rest arrive empty.

Set mappings in the node's panel. Connect an upstream table and select the mapping node to see automatic matches. Choosing a column saves all displayed matches as an explicit mapping. Use Use automatic detection to return to header detection. Required fields without a match are marked in the panel.

Field Type Required Example What it is Auto-detected headers
Location text Yes Berlin Assembly Plant Where production occurred. Must match a Location name. location, loc, name, id, location_id, loc_id
Bom Name text Yes City Bike BoM Recipe that was produced. Must match a bom_name on the BoM table. bom_name
Produced Quantity number No 300.0 Units of the output product actually produced in the recorded baseline. Its unit goes in Quantity Unit. produced_quantity
Quantity Unit text No bike Unit that produced quantity is expressed in (the output product's unit). quantity_unit, qty_unit, unit, uom
Realized Cost number No 12000.0 Total production conversion cost actually incurred in the baseline (not per-unit; excludes component cost). realized_cost, supply_cost, handling_cost, total_supply_cost, production_cost, total_handling_cost
Realized Emissions number No 900.0 Total emissions actually produced by manufacturing in the baseline. Its unit goes in Emissions Unit. realized_emissions, emissions, co2, carbon, ghg, carbon_emissions
Emissions Unit text No kg CO2 Unit for realized emissions (e.g. kg CO2). emissions_unit, co2_unit

How it works

Each row records production at a site. Cost to Serve reads the produced quantity to size component consumption, then rolls the components' cost plus the realized conversion cost up into the finished good's cost to serve.

Workflow wiring

flowchart LR
    n1["Import Data (bom.csv)"] --> n2["Map Bill of Materials"]
    n4["Import Data (production.csv)"] --> n5["Map Production State"]
    n2 --> n3["Create Scenario"]
    n5 --> n3

Common mistakes

  • Putting the per-unit rate here. Realized Cost is the total incurred. The per-unit conversion rate belongs on Map Production Policy.
  • No matching recipe. The Bom Name must match a recipe on the bill of materials table.