Template Attributes

In this section you can read about the different attributes: what effects they have and how to use them. On the different sheets of the Excel you can find a lot of types of attributes, some of them are cost related or opening/closing decisions. Some of the attributes can be used only if you have the specific module (User Roles and Modules).

Optimization Parameters and Constraints

Time Limit

Sheets on which it appears: Settings
Possible inputs: any number greater than 0 (in hours)
How it affects the model: The time limit of the optimization run measured in hours. If not specified, the model uses 1 hour

Optimality Gap

Sheets on which it appears: Settings
Possible inputs: number between 0 and 100 (in percentage), the smaller the optimality gap, the better the solution
How it affects the model: The optimization engine stops when a solution is found which is within this percentage of the best possible solution. The default is 0.01(%) when using Single Source and 0.001(%) otherwise.

Maximum # of Source Locations

Sheets on which it appears: Location Product, Customer Product Data
Possible inputs: Positive integers
How it affects the model: On Location Product sheet for locations where there is a Warehouse or a Production facility: The maximum number of source location per product and period that can serve a warehouse/production facility. For example if the maximum number of source locations is 10 for a warehouse location, then the inbound volume can only come from 10 different locations, which can be supplier, warehouse or production facility. On Customer Product data sheet for customer locations: The maximum number of source locations per product and period that can serve the Customer. For example if the maximum number of source locations is 10 for a customer location, then the inbound volume can only come from 10 different locations, which can be supplier, warehouse or production facility.

Maximum # of Destination Locations

Sheets on which it appears: Location Product
Possible inputs: Positive integers
How it affects the model: The maximum number of destination location per product and period that the supplier/warehouse/production facility can serve. For example if the maximum number of destination locations is 10 for a warehouse location, then only 10 different location (Warehouse/Production/Customer) can receive product from that location.

Available

Sheets on which it appears: Supplier, Supplier Product, Production, Warehouse, Warehouse Product, Inventory, Inventory Product, Transport Cost, Stepwise Transport Cost
Possible inputs: Binary: 1 or 0 (empty)
How it affects the model: To indicate that the Supplier, Warehouse, Production…etc., can be used by the model. Only Available without Force Open does not necessarily mean that the minimum and maximum capacity will be considered, in other words the constraint will be conditional. If both Available and Force Open attributes are defined then the constraints must be met. For example, if the Warehouse has minimum capacity (10000) and it is only Available and not Force Open, the inbound/outbound of the warehouse can be less than the minimum capacity (e.g.:5000) and the model will be feasible. But if the Warehouse is available and force open the inbound/outbound of the warehouse can not be less than the minimum capacity or the model is infeasible. Objects with {Curly Bracket} does not need Available attribute if single elements of the group have Available attribute.

BOM and Production Routing

Bill of Material is only available in the Network Design Advanced Module. You can read more about how to use BOM and Production Routing in Bill of Material Groups.

Product Created

Sheets on which it appears: Bill of Material
Possible inputs: any number greater than 0
How it affects the model: Product Created attribute defines how many final products can be made from the given amount of raw materials.

Product Needed

Sheets on which it appears: Bill of Material
Possible inputs: any number greater than 0
How it affects the model: Product Needed attribute defines how many raw materials are needed for the given amount of final product

Capacity Consumed

Sheets on which it appears: Production Routing
Possible inputs:any number greater than 0 (0 means unlimited)
How it affects the model: the amount of capacity consumed in one iteration of the given Bill of Material at the given Production, Location, and Period.

BOM Fixed Cost

Sheets on which it appears: Production Routing
Possible inputs: any number greater than 0 (0 means no cost)
How it affects the model: the cost of the Bill of Material being in use at the Production for the given Period and Location. BOM Fixed Cost is independent of the inbound or outbound volume. BOM Fixed Cost remains the same no matter how much the volume is.

BOM Variable Cost

Sheets on which it appears: Production Routing
Possible inputs: any number greater than 0 (0 means no cost)
How it affects the model: The cost of using one iteration of the given bill of material at the given production, location, and period. Compared to the Variable Cost in the Production sheet it differs in that the Variable Cost is the cost of one unit of volume (capacity consumed). So the proper interpretation is that, for example, producing a given BOM takes Capacity Consumed amount of hours (specified in the sheet Production Routing) and this creates a set of products (a given amount from each specified in the sheet Bill of Material). The Variable Cost in the sheet Production is the hourly wage the workers operating the machine have to be paid to carry out the task, while the BOM Variable Cost is the cost of using the machine for the given task once. BOM Variable Cost is inherently independent of the hours the task takes.

Count Constraint Attributes

Count Constraints are only available in the Network Design Advanced and in the Sustainability and Risk Modules.

Minimum # of Open Locations

Sheets on which it appears: Location Product
Possible inputs: Positive integers
How it affects the model: This attribute enforces a constraint for the minimum number of locations (from the given location group) where at least one product (or product from the given product group) is present. Curly bracket notation must be used to denote location groups, products can be denoted in curly bracket groups or individually (for instance {Location Group}, Product or {Product Group}). Note that imposing a minimum number of open locations does not force associated resources to open, i.e. a location may be opened without any active resources.

Maximum # of Open Locations

Sheets on which it appears: Location Product
Possible inputs: Positive integers
How it affects the model: This attribute enforces a constraint for the maximum number of locations (from the given location group) where at least one product (or product from the given product group) is present. Curly bracket notation must be used to denote location groups, products can be denoted in curly bracket groups or individually (for instance {Location Group}, Product or {Product Group}).

Minimum # of Open Suppliers

Sheets on which it appears: Supplier
Possible inputs: Positive integers
How it affects the model: This attribute enforces a constraint for the minimum number of locations (within a location group) where at least one supplier (from the given supplier group) is present. Curly bracket notation must be used to denote location and supplier groups (e.g. {Location Group}, {Supplier Group}).

Maximum # of Open Suppliers

Sheets on which it appears: Supplier
Possible inputs: Positive integers
How it affects the model: This attribute enforces a constraint for the maximum number of locations (within a location group) where at least one supplier (from the given supplier group) is present. Curly bracket notation must be used to denote location and supplier groups (e.g. {Location Group}, {Supplier Group}).

Minimum # of Open Productions

Sheets on which it appears: Production
Possible inputs: Positive integers
How it affects the model: This attribute enforces a constraint for the minimum number of locations (within a location group) where at least one production (from the given production group) is present. Curly bracket notation must be used to denote location and production groups (e.g. {Location Group}, {Production Group}).

Maximum # of Open Productions

Sheets on which it appears: Production
Possible inputs: Positive integers
How it affects the model: This attribute enforces a constraint for the maximum number of locations (within a location group) where at least one production (from the given production group) is present. Curly bracket notation must be used to denote location and production groups (e.g. {Location Group}, {Production Group}).

Minimum # of Open Warehouses

Sheets on which it appears: Warehouse
Possible inputs: Positive integers
How it affects the model: This attribute enforces a constraint for the minimum number of locations (within a location group) where at least one warehouse (from the given warehouse group) is present. Curly bracket notation must be used to denote location and warehouse groups (e.g. {Location Group}, {Warehouse Group}).

Maximum # of Open Warehouses

Sheets on which it appears: Warehouse
Possible inputs: Positive integers
How it affects the model: This attribute enforces a constraint for the maximum number of locations (within a location group) where at least one warehouse (from the given warehouse group) is present. Curly bracket notation must be used to denote location and warehouse groups (e.g. {Location Group}, {Warehouse Group}).

Ratio Constraint Attributes

Ratio Constraints are only available in the Network Design Advanced and in the Sustainability and Risk Modules.

Minimum Ratio

Sheets on which it appears: Supplier Ratio, Production Routing Ratio, Warehouse Ratio, Transport Ratio
Possible inputs: Positive real number
How it affects the model: This attribute can be used to enforce a constraint on the minimum ratio between the volume at an entity (or group of entities) and a comparison group of entities. Curly bracket notation must be used when denoting groups. The minimum ratio constraint is conditional on whether the entity, the location, and the period are single, otherwise the constraint is imposed in absolute sense. All constraints can be modeled as absolute if the respective entities are set to Force Open. The table below shows some examples of ratio constraints which can be modeled using this attribute:

Product

Warehouse

Location

Period

Product 2

Warehouse 2

Location 2

Period 2

Minimum Ratio

{All Products}

Location_2

Location_2

2024

{All Products}

{LDC}

{LDC}

2024

0.25

Thin-Film

Location_3

Location_3

2024

{All Products}

Location_3

Location_3

2024

0.35

Thin-Film

Location_4

Location_4

2024

Thin-Film

{LDC}

{LDC}

2024

0.65

{All Products}

{US LDC}

{US LDC}

2024

{All Products}

{Global LDC}

{Global LDC}

2024

0.75

{All Products}

{US LDC}

{US LDC}

{2024-2030}

{All Products}

{Global LDC}

{Global LDC}

{2024-2030}

0.45

Row-by-row explanation of the table above:
  1. Location_2 must account for a minimum of 25% of the total throughput for All Products across all LDCs. (Conditional constraint)

  2. The Thin-Film product must account for a minimum of 35% of All Products throughput at Location_3. (Conditional constraint)

  3. Thin-Film throughput at Location_4 must account for a minimum of 65% of the total Thin-Film throughput across all LDCs. (Conditional constraint)

  4. US LDCs must account for a minimum of 75% of All Products throughput across all Global LDCs. (Absolute constraint)

  5. US LDCs must account for a minimum of 45% of All Products throughput across all Global LDCs over the period group 2024-2030. (Absolute constraint)

Maximum Ratio

Sheets on which it appears: Supplier Ratio, Production Routing Ratio, Warehouse Ratio, Transport Ratio
Possible inputs: Positive real number
How it affects the model: This attribute can be used to enforce a constraint on the maximum ratio between the volume at an entity (or group of entities) and a comparison group of entities. Curly bracket notation must be used when denoting groups. This attribute can be applied in the same was as the Minimum Ratio, please refer to the explanatory table above for more details.

Transport Navigator Attributes

Transport Navigator attributes are only available in the Transport Navigator Module.

TN Time Limit

Sheets on which it appears: TN Settings
Possible inputs: Positive integer value (in seconds)
How it affects the model: Sets the maximum time allowed for the Transport Navigator solver to run. The solver will return the best solution found once this time is reached.

Reference Date and Time

Sheets on which it appears: TN Settings
Possible inputs: Date and time formatted as YYYY-MM-DD HH:MM:SS
How it affects the model: Establishes the start point for all time-based calculations, with period start and end times defined relative to this reference point.

Include Week Number in Time Stamps

Sheets on which it appears: TN Settings
Possible inputs: 1 (include week number) or 0 (do not include week number)
How it affects the model: Determines whether week numbers are shown in the time stamps for arrival times, departure times, and time windows in the application.

Reset Duty Time at Depot

Sheets on which it appears: TN Settings
Possible inputs: 1 (reset duty time at depot) or 0 (do not reset duty time)
How it affects the model: Controls whether a vehicle’s duty time is reset when it returns to a depot, impacting compliance with duty time constraints and route planning.

Volume UOM

Sheets on which it appears: TN String Settings
Possible inputs: String representing a volume unit of measurement (e.g., m3, L)
How it affects the model: Defines the unit of measurement for all volume-related inputs and calculations in Transport Navigator.

Weight UOM

Sheets on which it appears: TN String Settings
Possible inputs: String representing a weight unit of measurement (e.g., kg, lb)
How it affects the model: Defines the unit of measurement for all weight-related inputs and calculations in Transport Navigator.

Period Start

Sheets on which it appears: TN Periods
Possible inputs: Positive real value (in hours)
How it affects the model: Specifies the start time of the period as an offset in hours from the Reference Date and Time (see: Reference Date and Time on TN Settings sheet).

Period End

Sheets on which it appears: TN Periods
Possible inputs: Positive real value (in hours)
How it affects the model: Specifies the end time of the period as an offset in hours from the Reference Date and Time (see: Reference Date and Time on TN Settings sheet).

Mode of Transport

Sheets on which it appears: TN Locations
Possible inputs: String matching a defined mode of transport from the Mode of Transport sheet
How it affects the model: Determines the transport mode used for routing from the warehouse. The associated speed is used in drive time calculations if no actual drive times are provided.

Maximum Duty Time

Sheets on which it appears: TN Locations
Possible inputs: Positive real value (in minutes)
How it affects the model: Sets the maximum allowable duty time before a layover is required. Duty time includes driving, unloading/loading, and waiting times.

Maximum Drive Time

Sheets on which it appears: TN Locations
Possible inputs: Positive integer value (in minutes)
How it affects the model: Defines the maximum driving time before a mandatory layover is required.

Minimum Layover Duration

Sheets on which it appears: TN Locations
Possible inputs: Positive integer value (in minutes)
How it affects the model: Sets the minimum duration of a layover.

Maximum Layover Duration

Sheets on which it appears: TN Locations
Possible inputs: Positive integer value (in minutes)
How it affects the model: Defines the maximum allowable duration of a layover.

Cost Per Stop

Sheets on which it appears: TN Locations
Possible inputs: Positive real value
How it affects the model: Adds a cost for each stop made along the route.

Cost Per Dispatch

Sheets on which it appears: TN Locations
Possible inputs: Positive real value
How it affects the model: Applies a cost for each vehicle dispatched from a warehouse.

Cost Per Layover

Sheets on which it appears: TN Locations
Possible inputs: Positive real value
How it affects the model: Applies a cost penalty for each layover during a route.

Cost Per Hour Late

Sheets on which it appears: TN Locations
Possible inputs: Positive real value
How it affects the model: Applies a cost penalty for each hour a vehicle arrives outside the customer’s specified time window.

Maximum Distance between Stops

Sheets on which it appears: TN Locations
Possible inputs: Positive real value
How it affects the model: Restricts the maximum distance allowed between two consecutive customer stops on a route.

Reloading Time Warehouse

Sheets on which it appears: TN Locations
Possible inputs: Positive real value (in minutes)
How it affects the model: Defines the reloading time needed at a warehouse before a vehicle can depart for the next route.

Maximum Number of Stops per Route

Sheets on which it appears: TN Locations
Possible inputs: Positive integer value
How it affects the model: Limits the number of customer stops allowed per route before a vehicle must return to the warehouse.

Reduced Capacity Per Stop

Sheets on which it appears: TN Vehicles
Possible inputs: Positive real value (in volume UOM)
How it affects the model: Reduces the available volume capacity of the vehicle after each stop to account for inefficiencies such as packaging or palletizing for multiple deliveries.

Vehicle Capacity Weight

Sheets on which it appears: TN Vehicles
Possible inputs: Positive real value (in Weight UOM, see: TN Settings)
How it affects the model: Sets the maximum weight that the vehicle can carry.

Vehicle Capacity Volume

Sheets on which it appears: TN Vehicles
Possible inputs: Positive real value (in Volume UOM, see: TN Settings)
How it affects the model: Sets the maximum volume that the vehicle can carry.

Has Sleep Cabin

Sheets on which it appears: TN Vehicles
Possible inputs: 1 (yes) or 0 (no)
How it affects the model: Indicates whether a vehicle has a sleep cabin, allowing it to take layovers anywhere instead of requiring a specific rest location.

Cost Per Distance

Sheets on which it appears: TN Vehicles
Possible inputs: Positive real value
How it affects the model: Adds a cost per kilometer or mile traveled.

Cost Per Day

Sheets on which it appears: TN Vehicles
Possible inputs: Positive real value
How it affects the model: Applies a fixed daily cost for using the vehicle.

Cost Per Hour

Sheets on which it appears: TN Vehicles
Possible inputs: Positive real value
How it affects the model: Adds a cost for each hour of duty time for a vehicle.

Grouping Code

Sheets on which it appears: TN Vehicles
Possible inputs: String value
How it affects the model: Matches vehicles with customers that have the same grouping code (see: Grouping Code on TN Customer Product sheet), allowing selective assignment of vehicles to specific customer groups.

Demand

Sheets on which it appears: TN Customer Product
Possible inputs: Positive real value
How it affects the model: Specifies customer demand per product. If used, UOM conversion for volume and weight must be set. Alternatively, use Demand Volume and Demand Weight directly.

Demand Volume

Sheets on which it appears: TN Customer Product
Possible inputs: Positive real value (in Volume UOM, see: TN Settings)
How it affects the model: Defines the demand per product by volume.

Demand Weight

Sheets on which it appears: TN Customer Product
Possible inputs: Positive real value (in Weight UOM, see: TN Settings)
How it affects the model: Defines the demand per product by weight.

Service Time

Sheets on which it appears: TN Customer Product
Possible inputs: Positive real value (in minutes)
How it affects the model: Sets the required service time at each customer stop.

Time Window Start

Sheets on which it appears: TN Customer Product
Possible inputs: Positive real value (in hours from the associated TN Period start)
How it affects the model: Sets the earliest allowed arrival time at the customer location.

Time Window End

Sheets on which it appears: TN Customer Product
Possible inputs: Positive real value (in hours from the associated TN Period start)
How it affects the model: Sets the latest allowed arrival time at the customer location.

Is First Stop

Sheets on which it appears: TN Customer Product
Possible inputs: 1 (yes) or blank (no)
How it affects the model: Forces the customer to be the first stop on the assigned route.

Is Last Stop

Sheets on which it appears: TN Customer Product
Possible inputs: 1 (yes) or blank (no)
How it affects the model: Forces the customer to be the last stop on the assigned route.

Grouping Code

Sheets on which it appears: TN Customer Product
Possible inputs: String value
How it affects the model: Assigns customers to specific vehicle types with matching grouping codes (see: Grouping Code on TN Vehicles sheet).

Serviced by Warehouse Location

Sheets on which it appears: TN Customer Product
Possible inputs: String value (warehouse name)
How it affects the model: Determines the warehouse location responsible for servicing the customer’s demand.

Customer Name

Sheets on which it appears: TN Fixed Routes
Possible inputs: String value (must match a customer name)
How it affects the model: Defines the customer that must be visited as part of a fixed route.

Location Name

Sheets on which it appears: TN Fixed Routes
Possible inputs: String value (must match a warehouse name)
How it affects the model: Specifies the physical location where the vehicle must stop on the fixed route.

TN Period Name

Sheets on which it appears: TN Fixed Routes
Possible inputs: String value (must match a TN Period name)
How it affects the model: Assigns the fixed route stop to a specific Transport Navigator period (see: TN Period sheet).