Zielnetzplanung (ZNP)

Calculate simultaneity factor (G-Factor) for a ZNP project

Traverses all CONTRIBUTES_LOAD edges with layer ≤ targetLayer inbound to the specified substation node, sums asset capacities, and applies the simultaneity factor (Gleichzeitigkeitsfaktor) from VDE-AR-N 4100.

Immutable Stacking: The graph is never mutated — layer filtering happens at query time (Short-Circuiting). This means you can call calculateGFactor with targetLayer=0 even after addLayer1 has been called, and the result will only reflect Layer 0 assets.

get/api/znp/projects/:projectId/g-factor

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/znp/projects/:projectId/g-factor
  • Auth: none declared

Path parameters

projectIdstring required
Example:a1b2c3d4-0000-0000-0000-000000000001

Query parameters

target_layerinteger

Include all layers ≤ target_layer in the capacity sum.

substationIdstring

Target substation node key. Defaults to SUB_1.

tokenstring

Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.

Response

G-Factor calculation result

projectIdstring
substationIdstring
targetLayerinteger
assetCountinteger
totalCapacityKWnumber
simultaneityFactornumber
adjustedCapacityKWnumber

Changes

No recorded changes to this operation across all 2 revisions of this API.