SoftwarePlus.ai

All programs › BMPFast › Help

Discovery Plots

A copy of the help on bmpfast.com (last changed there 2026-10-16; copied here 2026-10-21). These pages describe the windows of BMPFast (version 1). BMPFast 2 uses the same methods; its numbered buttons are the tree on the left: General Site Information, then Catchments with their Treatments, Catchment Routings and Calculators.

Discovery Plots show how one result of your project — for example the nitrogen or phosphorus treatment efficiency of the whole system — changes as you change one design value, such as a retention BMP’s treatment depth or a wet detention pond’s permanent pool volume. Use them to explore a design before you size it: the plot shows where the curve crosses the removal target, so you can see how much treatment depth (or pool volume, or residence time) is needed to meet it, and how much more you gain by going further.

A Discovery Plot is a “what if” tool. Every point on the curve is a full calculation of your project with that one value changed, but nothing in your project is changed: when the plot is finished, every value you entered is put back exactly as it was. To use a design you found on the plot, enter it on the BMP’s own worksheet.

Opening Discovery Plots

Discovery Plots work on the whole project, with its routing. Button 7 first stores what is on the General Site Information screen and recalculates, so a value you have just changed there is included. Enter your catchments, BMPs and routing before you open the plots — the list of values you can vary is built from them when the window opens. The window does not remember your choices; each time you open it, it starts empty.

Making a plot, step by step

  1. Choose the result to plot (the Y-Axis) in the drop-down at the top of the left column, under 1. Y-Axis: the result to plot. It starts on Total Outlet Nitrogen Loading. To compare against the removal target, choose Provided Nitrogen Treatment Efficiency or Provided Phosphorus Treatment Efficiency.
  2. Choose the value to vary (the X-Axis) in the list under 2. Set X-Axis: the value to vary. The list is grouped under headings that say where each value belongs — a catchment, or a BMP in a catchment. Click the round button beside the value. Min and Max fill in with a suggested range.
  3. Set the range: check or change Min and Max (the lowest and highest value to try, in the units shown beside the value’s name) and # Steps (how many equal steps between them; 10 steps gives 11 points).
  4. Press Set as X-Axis. BMPFast calculates the project at every point and draws the curve on the right. The status line under the buttons says Curve updated.
  5. Change anything and plot again: choosing a different result in the Y-Axis drop-down redraws the curve at once; after changing the X value or its range, press Set as X-Axis again.
  6. Press Copy to paste the chart into a report, or Print. Press Close when you are done.

Under the button, Now plotted shows the X-Axis that is plotted, for example “X-Axis: Treatment Depth (in) — Retention (Catchment 1) [0.25 – 0.75], 10 steps”. A value you click in the list, or a range you type, is not used until you press Set as X-Axis; if you change the Y output first, the status line reminds you that your X-Axis changes are not plotted yet.

Results you can plot (Y-Axis)

All the results are for the whole system — every catchment and BMP as routed to the outlet — not for one BMP.

ResultUnitsWhat it is
Total Outlet Nitrogen Loadingkg/yrNitrogen leaving the system at the outlet after treatment.
Total Outlet Phosphorus Loadingkg/yrPhosphorus leaving the system at the outlet after treatment.
Provided Nitrogen Treatment Efficiency%The system’s nitrogen removal. The plot also draws the nitrogen target (Target N %).
Provided Phosphorus Treatment Efficiency%The system’s phosphorus removal. The plot also draws the phosphorus target (Target P %).
Provided Nitrogen Load Removedkg/yrNitrogen load from all catchments minus the outlet nitrogen load.
Provided Phosphorus Load Removedkg/yrPhosphorus load from all catchments minus the outlet phosphorus load.

Applicant’s Handbook reference

Section 9.3 Determination of Required Treatment Efficiency: the required reduction is the greater of the Section 8.3 percentage for the site and the Equation 9-3 reduction that brings the post-development load down to the predevelopment load; the Target N % and Target P % lines are these values.

Below the drop-down, Display: Min / Max and Apply Range set how much of the Y axis the chart shows — for example 70 to 100 to look closely at the part of the curve near the target. This changes only the picture, not the calculation. After each plot the boxes show the range the chart drew; type your own and press Apply Range. Leave one box blank to let that end scale itself; clear both and press Apply Range to go back to automatic scaling. Choosing a different result, or Clear Curve, also returns to automatic scaling.

Values you can vary (X-Axis)

The list offers the design values of every catchment that is not disabled, and of the BMP chosen in each catchment. Which BMP values appear depends on the kind of BMP:

WhereValues offeredNotes
Each catchment (heading “Catchment n” with its name)Pre Non DCIA Curve Number, Pre DCIA Percent (0-100), Post Non DCIA Curve Number, Post DCIA Percent (0-100)Curve numbers are limited to 30 to 100, DCIA percents to 0 to 100.
Retention-type BMPs: Retention, Exfiltration, Permeable Pavement, Rain Garden, Tree Well, Swale, Vegetated Natural Buffer, Vegetated Filter Strip, FiltrationTreatment Depth (in)The depth of runoff, in inches over the catchment, that the BMP captures. Not offered for Stormwater Harvesting, which works its treatment depth out from the harvest efficiency. A Vegetated Natural Buffer or Filter Strip that uses the buffer tables (vegetation only, or detention) also offers its width. A Retention BMP that treats runoff routed in from other catchments offers Retention Volume (ac-ft) instead of Treatment Depth, because its Treatment Depth is then spread over all the area draining to it; Exfiltration, Tree Well, Swale and the buffers set to Retention offer their Treatment Volume (ac-ft) the same way; Permeable Pavement, Rain Garden and Filtration in that position offer no value (see Discovery Plots Methodology).
Wet DetentionPermanent Pool Volume (ac-ft), Average Residence Time (days)Permanent Pool Volume is at least 0.01 ac-ft.
GreenroofTreatment Depth (in), Greenroof Area (sf)
Multiple BMPThe values of each BMP in the series, as aboveHeaded “Multiple BMP: BMP 2 (Wet Detention) — Catchment 1”, and so on. Two BMPs of the same type in one series are listed once.

If nothing in the project can be varied, the list says “Nothing to vary yet: no catchment has a BMP selected.” Close the window, choose a BMP for a catchment, then open Discovery Plots again.

Treatment Depth is normally calculated by BMPFast from the BMP’s dimensions. Here you set it directly, which answers the question “what treatment depth do I need?” — the BMP’s dimensions are not resized to match. Once you know the depth you need, change the BMP’s design on its worksheet until its Treatment Depth reaches it.

Setting the range

  • Suggested range. When you click a value, Min and Max are filled in for you: the full allowed range for a value that has one (for example 30 to 100 for a curve number, 0 to 100 for a DCIA percent), otherwise from half to one and a half times the value now in the project (0 to 10 if it is now 0). Change them as you like.
  • # Steps is the number of equal steps from Min to Max (starts at 10). Each step is a full calculation of the project, so many steps on a large project take longer; the pointer shows an hourglass while it works.
  • Limits. If Max is above a value’s limit it is lowered to the limit, and if Min is below the limit it is raised; the boxes show the new numbers and the status line says so (for example “Max capped at … (Post Non DCIA Curve Number limit).”).
  • Treatment Depth starts at 0.10 in. A Min below 0.10 in is raised to 0.10 in, with the message “Values of Treatment Depth below 0.10 in are set to the minimum of 0.10 in based on the runoff calculation limits”. The runoff calculations produce no runoff below 0.1 in of rainfall, so smaller depths have no meaning on this plot. This limit applies only to Discovery Plots; it does not limit Treatment Depth anywhere else in BMPFast.

Reading the chart

The chart’s title is “result vs value“, and each axis is labelled with its name, units and where it belongs (for example “Treatment Depth (in) — Retention (Catchment 1)”). The curve is drawn through the calculated points, each marked with a dot.

Line or labelWhat it shows
Blue curve with dotsThe result at each value from Min to Max.
Green vertical line, “current (…)”The value now in your project.
Grey horizontal line, “current (…)”The result your project gives now. Where the two “current” lines cross is your present design; when it lies inside the plotted range, the curve passes through it.
Dashed line “Target N %” (blue) or “Target P %” (green)The removal target for the analysis type. Shown only when the result is Provided Nitrogen or Phosphorus Treatment Efficiency. Where the curve crosses this line is the value at which the design just meets the target.
Dashed red lines “min” and “max”The limits of the value, when it has them and they fall inside the plotted range.
(x, y) labelsThe value and result at the low end of the curve, at your present design and at the high end.

A note in orange under the title warns when something is not right:

  • “This input does not appear to affect the selected output (curve is flat).” — changing this value does not change this result in your project. Try another value or another result.
  • “n of m point(s) could not be computed and were skipped.” — the calculation failed at some values; the curve is drawn through the others. Try a narrower range.
  • “No valid points — every recompute failed for this range.” — nothing could be calculated. Check the range and the project’s inputs.

Buttons

ButtonWhat it does
Apply RangeShows the Y axis over the Display Min and Max (see above). Display only.
Set as X-AxisUses the value clicked in the list, with its Min, Max and # Steps, and draws the curve (once a result is chosen). Greyed out until a value is clicked.
Clear CurveStarts again: clears the chosen value, its range and the chart, and sets the result back to the first one in the list.
HelpOpens this page.
CopyCopies the chart as a picture to the clipboard, ready to paste into a document. Available once a curve is drawn.
PrintOpens the Print dialog and prints the chart. Available once a curve is drawn.
CloseCloses the window (the Esc key does the same). Your project is as it was before you opened the plots; copy or print the chart first if you want to keep it.

The window can be resized or maximized to make the chart larger.

Messages

MessageWhat to do
Enter numeric Min and Max values for the X-Axis.Type a number in both Min and Max.
X-Axis Max must be greater than Min.Make Max larger than Min (after any limit is applied).
Steps must be a whole number of 1 or more.Type a whole number such as 10 in # Steps.
Y display Min (or Max) must be a number, or blank for automatic.Correct the Display box, or clear it.
Y display Max must be greater than Min.Make the Display Max larger than the Display Min.
Could not draw the Discovery Plot: …The calculation stopped with an error (the reason follows). The window stays open; change the value or range and press Set as X-Axis again.

When a value is not accepted, the previous choice and range stay in place and the chart is not changed.

How the curve is calculated

Methodology. Discovery Plots Methodology explains how each point is calculated and why a plot of the whole project can differ from the BMP worksheet’s own plot, with an example.

To size one BMP on its own, use its worksheet’s Sizing button (see Sizing).

For each point, BMPFast sets the chosen value and recalculates the whole project exactly as it would if you had typed that value on the worksheet and run the analysis: routing, downstream BMPs and every result that depends on the value are calculated as usual. Only the chosen value is held fixed, so it is not recalculated from the BMP’s dimensions. For example, more treatment depth in a retention BMP sends less water on to a wet detention pond downstream, which changes that pond’s residence time — and the curve includes that. When all points are done, every value in the project is put back as it was and the project is recalculated, so your inputs and reports are unchanged.

Source reference

BMPFast method (DesignCurveService.cs): each point is a full calculation of the project with only the chosen value held fixed; the method is BMPFast’s.

Sample problems

Worked problems solved in BMPFast, each with every input, the steps with screen captures, the program’s results, a hand check and the project file to download. Captures are for demonstration only. All of them: BMPFast sample problems.

Help home · List of every help page · This page on bmpfast.com · Sample problems