Skip to main content

Collector

phase_permutations object

Specify the phase mapping between this asset (child) and its parent collector (parent). Leave unset when the wiring is unknown; phase-aware control (use_topology) requires every asset's mapping to be declared, so a single unset mapping makes the controller fall back to the worst case. The root collector is exempt: it is the grid connection, whose phases are the reference frame every other mapping is expressed against, so the controller always treats it as the identity and it may only be left unset or declared as the identity.

anyOf
parentstring[]required

Possible values: [L1, L2, L3]

childstring[]required

Possible values: [L1, L2, L3]

nameName (string)required
children object

The children of this collector. This is used to create a tree structure.

anyOf
  • Array [
    • 0
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
  • ]
    • line_currentLine Current (integer)required

    The line current in Ampere.

    safe_line_current object

    An optional, safer line current in Ampere used by the optimizer instead of line_current when set.

    anyOf
    integer
    min_phase_current object

    An optional lower bound in Ampere per phase. Set it to 0 on the main collector to forbid injection into the grid.

    anyOf
    number
    phase_voltagePhase Voltage (integer)required

    The phase voltage is in Volt.

    commodityCommodity (string)
    Default value: electricity
    1P_3PCollectorType (string)

    Specifies whether the collector is single-phase (1P) or three-phase (3P).

    Possible values: [1P, 3P]

    Default value: 3P
    Collector
    {
      "phase_permutations": {
        "parent": [
          "L1"
        ],
        "child": [
          "L1"
        ]
      },
      "name": "main_collector",
      "children": [
        null
      ],
      "line_current": 400,
      "safe_line_current": 300,
      "min_phase_current": 0,
      "phase_voltage": 230,
      "commodity": "electricity",
      "1P_3P": "3P"
    }