# plotAmpProfile

Plots the line currents profile and line rating vs. distance

## Contents

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

## Syntax

    plotAmpProfile(DSSCircObj,BusName);
    plotAmpProfile(DSSCircObj,BusName, _'PropertyName'_ ,PropertyValue);

## Description

Function to plot line currents in in each between the selected bus and the substation. The line current and line rating is plotted vs. distance from the substation. 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)
- `BusName` - Property for the name of the bus (string) that the current (amp) profile should be plotted to. Only the direct line between the bus and the substation will be plotted
- `Properties` - optional properties as one or more name-value pairs in any order
- -- `'AveragePhase'` - Property for if the average power should be plotted alone or in addition to the phase plots `'on' | {'off'} | 'addition'`
- -- `'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.

## 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 an Amp profile plot to a bus

    [DSSCircObj, DSSText, gridpvPath] = DSSStartup;
    DSSText.command = ['Compile "' gridpvPath 'ExampleCircuit\master_Ckt24.dss"'];
    DSSText.command = 'solve';
    figure; plotAmpProfile(DSSCircObj, 'G2101JK1400_N300995_sec_1','AveragePhase','addition')
    ylim([0 1000])
    %