OSTEC-AC Module¶

Type: OSTEC_AC Category: Optimization Maturity: DEVELOPMENT 🟡

OSTEC variant that factors the type of allocation coefficients (fixed or proportional) into the optimization objective, rather than applying them post-hoc.

Configuration Schema¶

Field	Type	Default	Required	Description
`allocation_mode`	string	—	Yes	`FIXED` · `PROPORTIONAL` · `DYNAMIC`
`consider_allocation_in_optimization`	boolean	`true`	No	Embed allocation logic in the objective
`solver`	string	`"CPLEX"`	No	`CPLEX` · `GUROBI` · `CBC`
`l_extra`	number	`10`	No	Extra penalty weight
`optimization_timeout`	integer	`300`	No	Max solver time in seconds

{
  "allocation_mode": "PROPORTIONAL",
  "consider_allocation_in_optimization": true,
  "solver": "CPLEX",
  "optimization_timeout": 300
}

Activation¶

curl -X POST \
  https://<host>/core/api/communities/{community_id}/energy_management/configs \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "module_type": "OSTEC_AC",
    "horizon": 24,
    "delta_t": 1.0,
    "config_data": {
      "allocation_mode": "PROPORTIONAL",
      "solver": "CPLEX"
    }
  }'

Triggering a Calculation¶

curl -X POST \
  "https://<host>/core/api/communities/{community_id}/energy_management/configs/{config_id}/calculate?target_date=2026-04-18" \
  -H "Authorization: Bearer <token>"