Network data format
The network data dictionary
Since PowerModelsMCDC extends the PowerModelsACDC data format, most of the parameters have the same meaning as in PowerModelsACDC. In particular, the status parameter of branchdc and convdc components determines whether to include the element in the model. If the component is active (i.e., status = 1), additional parameters control the availability of the single conductors/poles of the multi-conductor element. This guarantees portability with PowerModelsACDC.
The parameters that are introduced in PowerModelsMCDC are described below.
Converter (convdc)
| Field | Values | Data U.M. | Description |
|---|---|---|---|
conv_confi | {1,2} | Configuration:$\\$1: monopolar (symmetric or asymmetric)$\\$2: bipolar | |
connect_at | {0,1,2} | Bus terminals where the converter is connected (only used if the converter is monopolar):$\\$0: positive and negative$\\$1: positive and neutral$\\$2: negative and neutral | |
ground_type | {0,1} | Neutral terminal grounding type:$\\$0: ungrounded neutral terminal$\\$1: grounded neutral terminal | |
ground_z | [0,+∞) | p.u. | Grounding impedance (only used if ground_type == 1) |
status_p | {0,1} | Status of the positive pole of the converter:$\\$0: inactive$\\$1: active | |
status_n | {0,1} | Status of the negative pole of the converter:$\\$0: inactive$\\$1: active |
Both parameters status_p and status_n are used for a bipolar converter (i.e., conv_confi = 2). Instead, a single status parameter is selected if the converter is monopolar (i.e., conv_confi = 1), depending on its specific configuration:
- In symmetric configuration (i.e.,
connect_at = 0), thestatus_pparameter is used by default. - In asymmetric configuration (i.e.,
connect_atset at1or2), the status parameter is chosen according to the positive/negative DC bus terminal to which the converter is connected. For example, parameterstatus_pis used if the monopolar converter is connected to the positive DC bus terminal.
DC branch (branchdc)
| Field | Values | Data U.M. | Description |
|---|---|---|---|
line_confi | {1,2} | Configuration:$\\$1: monopolar (symmetric or asymmetric)$\\$2: bipolar | |
connect_at | {0,1,2} | Bus terminals where the branch is connected (only used if the DC branch is monopolar):$\\$0: positive and negative$\\$1: positive and neutral$\\$2: negative and neutral | |
return_type | Not used in package code, but present in input files.$\\$Originally meant for modeling ground return (1) instead of metallic return (2). | ||
return_z | (0,+∞) | p.u. | Metallic return impedance |
status_p | {0,1} | Status of the positive conductor:$\\$0: inactive$\\$1: active | |
status_n | {0,1} | Status of the negative conductor:$\\$0: inactive$\\$1: active | |
status_r | {0,1} | Status of the metallic return:$\\$0: inactive$\\$1: active |
The DC bus terminals, which the DC branch is connected to, determine which status parameters are selected.
Working with Matpower files
Input data can be provided in the form of a file structured similarly to the format defined by Matpower. An example .m file is available to illustrate the syntax. You can provide such a file to PowerModelsMCDC by using the parse_file function.