# plotKVARProfile

Plots the feeder profile for the kVAR power flow on the lines

## Contents

- Syntax
- Description
- Inputs
- Outputs
- Notes
- Example

## Syntax

    plotKVARProfile(DSSCircObj);
    plotKVARProfile(DSSCircObj, _'PropertyName'_ ,PropertyValue);

## Description

Function to plot the feeder profile for the kVAR power flow on the lines. This is the kVAR power vs. distance from the substation graph. Clicking on objects in the figure will display the name of the object, and right clicking will give a menu for viewing properties of the object.

## Inputs

- `DSSCircObj` - link to OpenDSS active circuit and command text (from DSSStartup)
- `Properties` - optional properties as one or more name-value pairs in any order
- -- `'Only3Phase'` - Property for if only 3-phase power lines should be plotted `'on' | {'off'}`
- -- `'AveragePhase'` - Property for if the average power should be plotted alone or in addition to the phase plots `'on' | {'off'} | 'addition'`
- -- `'BusName'` - Property for the name of the bus (string) that the kVAR profile should be plotted to. Only the direct line between the bus and the substation will be plotted, unless all buses are selected. `{'all'} | busName`
- -- `'Downstream'` - If a BusName is given, all buses in the electrical path to the substation (upstream) will be plotted, and if this property is on, all buses in the electrical path downstream of BusName will be plotted too `'on' | {'off'}`
- -- `'PVMarker'` - Property for if the PV PCC should be marked (if it exists) `{'on'} | 'off'`
- -- `'Lines'` - Structure of the circuit lines from getLineInfo. If no input is given, the structure is filled from the most current power flow solution in DSSCircObj COM.
- -- `'PV'` - Structure of the PV from getPVInfo. If no input is given, the structure is filled from the most current power flow solution in DSSCircObj COM.

## Outputs

- none - a figure is displayed with the plot

## Notes

For the right-click visualizations, the AllowForms field of DSSCircObj must be set to 1, which is the default value. Currently, OpenDSS 7.6.3 (the current version as of this writing) does not allow for setting the AllowForms field back to 1 after setting it to 0.

## Example

Example of a feeder kVAR profile plot

    [DSSCircObj, DSSText, gridpvPath] = DSSStartup;
    DSSText.command = ['Compile "' gridpvPath 'ExampleCircuit\master_Ckt24.dss"'];
    DSSText.command = 'solve';
    figure; plotKVARProfile(DSSCircObj,'AveragePhase','addition','BusName','N300558');
    figure; plotKVARProfile(DSSCircObj,'AveragePhase','on');
    DSSText.command = ['Compile "' gridpvPath 'ExampleCircuit\Ckt24_PV_Central_7_5.dss"'];
    DSSText.command = 'Set mode=duty number=1  hour=12  h=1 sec=0';
    DSSText.command = 'Set controlmode=static';
    DSSText.command = 'solve';
    figure; plotKVARProfile(DSSCircObj,'BusName','N300558')
    %