add docs to Profile Plotter

[bemcdonnell]

This can be completed after #174 and #155 (planning)

[wraseman]

I can create an example to include in the docs, I just need to figure out how to deal with an error in build_profile_plot() first. When I try to use the from swmmio import build_profile_plot, find_network_trace code referenced in the pyswmm/pyswmm#531 ticket, I get an error. The issue is that there is no Type attribute associated with links.loc[link_id] and there are several locations where the logic in build_profile_plot() and private methods associated with it use links.loc[link_id].Type to determine whether the link is a conduit, weir, orifice, pump, or outlet. Based on the type of link, it extracts the length information differently.

[bemcdonnell]

@wraseman are you using one of the examples on the PySWMM website?

[wraseman]

@bemcdonnell, I used the jersey .inp file from swmmio.examples. Here's my code:

import matplotlib.pyplot as plt
import copy
from swmmio import find_network_trace, build_profile_plot
from swmmio.examples import jersey

# Load in simple model
model = copy.deepcopy(jersey)
fig, ax = plt.subplots(figsize=(8, 4))
path_selection = find_network_trace(model, 'J1', 'J3')
profile_config = build_profile_plot(ax, model, path_selection)

add_node_labels_plot(ax, model, profile_config)
leg = ax.legend()
ax.grid(False)

The caveat is that I am using a modified version of build_profile_plot() that avoids the error with links.loc[link_id].Type

[bemcdonnell]

@wraseman any chance you be keen to submit a PR to fix this problem?