Skip to content

Commit

Permalink
Updates to multi-seg form to improve user friendliness and fix minor …
Browse files Browse the repository at this point in the history
…problems. improved context-sensitive greying of buttons depending on model progress. Fixed issue where "recent files" interface was not working if a non-valid directory was selected.

Updated users manual to discuss merging of segments and added context sensitive help link from merge interface.
  • Loading branch information
jsclough committed Jul 11, 2024
1 parent ed57739 commit 021fdc2
Show file tree
Hide file tree
Showing 8 changed files with 235 additions and 84 deletions.
1 change: 1 addition & 0 deletions Data.Simulate.AQUATOX/AQ_Sim_2D.cs
Original file line number Diff line number Diff line change
Expand Up @@ -1096,6 +1096,7 @@ public bool ReadHUCGeometry(AQTSim Sim, string HUCID)
rtesFilen = "rtes-huc10-2024-03-01-071352.csv";
subbasinFilen = "subbasins-huc10-2023-05-02-124829.csv";
}
else
if (HUClen == 12)
{
rtesFilen = "rtes-huc12-2024-03-01-070604.csv";
Expand Down
89 changes: 88 additions & 1 deletion GUI/GUI.AQUATOX/Docs/AQUATOX.NET_1.0_UMAN.htm
Original file line number Diff line number Diff line change
Expand Up @@ -3107,7 +3107,7 @@
style='background:yellow'>TBD</span></span></p>
<p class=MsoNormal style='background:white'><span style='font-size:8.0pt;
font-family:"Helvetica",sans-serif;color:black'>Environmental Protection                                                                                                                          Draft
4/8/2024</span></p>
7/11/2024</span></p>
<p class=MsoNormal style='background:white'><span style='font-size:8.0pt;
font-family:"Helvetica",sans-serif;color:black'>Agency</span></p>
<p class=MsoNormal style='line-height:3.1pt;background:white'>
Expand Down Expand Up @@ -7829,6 +7829,93 @@ <h2><a name="Multi_Segment_Runs"></a><a name="_Toc124172134"><span

<p class=MsoNormal>&nbsp;</p>

<h3 style='page-break-after:avoid'><a name=MergeSegments>Merging Segments<o:p></o:p></a></h3>

<span style='mso-bookmark:MergeSegments'></span>

<p class=MsoNormal>This capability is relevant to models using NHD+ stream
networks.<span style='mso-spacerun:yes'>  </span></p>

<p class=MsoNormal><o:p>&nbsp;</o:p></p>

<p class=MsoNormal>Linked AQUATOX DOT NET stream segments are based on flow
lines defined using USGS NHD+ COMIDs.<span style='mso-spacerun:yes'> 
</span>Within NHD+ river networks, <span style='mso-spacerun:yes'> </span>relatively
short flowlines may be present.<span style='mso-spacerun:yes'>  </span>These
segments, sometimes only a few hundred meters in length, are necessary to
connect adjacent flowlines or waterbodies.<span style='mso-spacerun:yes'> 
</span></p>

<p class=MsoNormal><o:p>&nbsp;</o:p></p>

<p class=MsoNormal>Because of the very short travel time of these segments, they
will often act as bottlenecks for a linked-model simulation.<span
style='mso-spacerun:yes'>  </span>A model solution for a segment will generally
require time steps that are shorter than the travel time for that segment.<span
style='mso-spacerun:yes'>  </span>So if a segment has a travel time of 0.01
days, at least 100 time-steps per day will be required for its simulation.</p>

<p class=MsoNormal><o:p>&nbsp;</o:p></p>

<p class=MsoNormal>To help with this problem, extremely short segments may be merged
with adjacent larger segments.<span style='mso-spacerun:yes'>  </span>This can
be achieved using the <b>Merge Segments</b> button.<span
style='mso-spacerun:yes'>  </span>When this button is pressed, the user is
provided with a dialog that gives statistics about the estimated travel time in
the selected stream network.<span style='mso-spacerun:yes'>  </span>The average
travel time for the network and the fifth-percentile travel time are shown.<span
style='mso-spacerun:yes'>  </span>The user may then select a threshold for
travel time and the number of segments that will be merged is updated.<span
style='mso-spacerun:yes'>  </span>If the user selects OK from the dialog, segments
shorter than that threshold will be merged with an adjacent downstream segment.<br>
<br>
Here are the steps taken when segments are merged together:</p>

<p class=MsoNormal><o:p>&nbsp;</o:p></p>

<p class=MsoListParagraphCxSpFirst style='text-indent:-.25in;mso-list:l30 level1 lfo39'><![if !supportLists]><span
style='font-family:Symbol;mso-fareast-font-family:Symbol;mso-bidi-font-family:
Symbol'><span style='mso-list:Ignore'>·<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></span></span><![endif]>The stream network (<span class=SpellE>StreamNetwork.JSON</span>)
is backed up prior to modification.</p>

<p class=MsoListParagraphCxSpMiddle style='text-indent:-.25in;mso-list:l30 level1 lfo39'><![if !supportLists]><span
style='font-family:Symbol;mso-fareast-font-family:Symbol;mso-bidi-font-family:
Symbol'><span style='mso-list:Ignore'>·<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></span></span><![endif]>The modified stream network merges together
small segments, adding them to an adjacent larger segment and updating length
and travel time information.</p>

<p class=MsoListParagraphCxSpMiddle style='text-indent:-.25in;mso-list:l30 level1 lfo39'><![if !supportLists]><span
style='font-family:Symbol;mso-fareast-font-family:Symbol;mso-bidi-font-family:
Symbol'><span style='mso-list:Ignore'>·<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></span></span><![endif]>The network structure is updated and the order
of model solution is updated in the stream network.</p>

<p class=MsoListParagraphCxSpLast style='text-indent:-.25in;mso-list:l30 level1 lfo39'><![if !supportLists]><span
style='font-family:Symbol;mso-fareast-font-family:Symbol;mso-bidi-font-family:
Symbol'><span style='mso-list:Ignore'>·<span style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
</span></span></span><![endif]>The shape for the larger segment is updated,
adding the smaller segment, and the original <span class=SpellE>GeoJSON</span>
file is backed up.</p>

<p class=MsoNormal><o:p>&nbsp;</o:p></p>

<p class=MsoNormal><o:p>&nbsp;</o:p></p>

<p class=MsoNormal>Merged segments can be created for either an NWM-based or a
HAWQS-based simulation. The merging of segments should be performed prior to step
4 (NWM chosen) or step 5 (HAWQS chosen) above.<span style='mso-spacerun:yes'> 
</span>This will ensure that the set of linked model inputs will be different
for the simplified stream network than it would be for an un-merged network.<span
style='mso-spacerun:yes'>  </span>After the “Link HAQWS data” or “Create Linked
Inputs” has been completed, the simplified network will be ready to run and
should produce faster run times.</p>

<p class=MsoNormal><o:p>&nbsp;</o:p></p>



<h3 style='page-break-after:avoid'><a name=DataLinkage>Data Linkage Assumptions
and Procedures</a></h3>

Expand Down
Binary file modified GUI/GUI.AQUATOX/Docs/AQUATOX.NET_1.0_UMAN.pdf
Binary file not shown.
31 changes: 24 additions & 7 deletions GUI/GUI.AQUATOX/MergeForm.Designer.cs

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

6 changes: 6 additions & 0 deletions GUI/GUI.AQUATOX/MergeForm.cs
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,12 @@ private void OKBtn_Click(object sender, EventArgs e)
// Keep the dialog open by not closing it
}
}

private void HelpButton2_Click(object sender, EventArgs e)
{
string target = "MergeSegments";
AQTMainForm.OpenUrl(target);
}
}

}
20 changes: 20 additions & 0 deletions GUI/GUI.AQUATOX/MergeForm.resx
Original file line number Diff line number Diff line change
Expand Up @@ -117,4 +117,24 @@
<resheader name="writer">
<value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
</resheader>
<assembly alias="System.Drawing" name="System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
<data name="HelpButton2.Image" type="System.Drawing.Bitmap, System.Drawing" mimetype="application/x-microsoft.net.object.bytearray.base64">
<value>
iVBORw0KGgoAAAANSUhEUgAAABUAAAAVCAYAAACpF6WWAAAABGdBTUEAALGPC/xhBQAAABl0RVh0U29m
dHdhcmUAQWRvYmUgSW1hZ2VSZWFkeXHJZTwAAAMISURBVDhPnZRpSFRRFMdHp9IoJSyotKIPJVG2IG1k
EZFIUAQFfQqCoPrSghAl9CnESCPQJCotV0jNXXNLzd0cl1xGHdNxNsdtZlzG1NxGT/8z+MrJZ1oHfjze
Pff83l3evZKFQUSLyCxr2Jhd0XQkIjHHBV3sgZ1YP0Y05hN2LMmTKaIKattNpY0qqlboqKShkwpqvhnw
kZiwuAwv9HMA0mWlaUW12yF7VdWipW6TmSanZ2h2bu4XE1MzpDeaqbJZQ0n5XyKv3bq7A2VrgB3yVodN
ZFfKvSB8r+oZoBnLLFlml2baYqEOvZHis0tTnoa+O4tyR8BL8zti0gocWMijmJqxrBhd/xDFphdmQOEG
WGzHPmt8qm4LUmj7rdP7V1rUffQ2ISsams1gtVWYmFe5iTdhZGyCxiambJCe9rXhzzxjRl0x6j2PnjgO
nROwl2Dat+WqXhoZn7RBEC31vhCux9qGQugKVvHUszR9gzQ0+uOvCFKxnBr1Man5dRDuAWsl+Pc6uo0j
ZDKPL4kgFMsxXQYzfcit0EN4GDizVKvDrvcNjYoiCMVyAlrDMKUUyEwQ8qFw4TWtUnYP4Gf/LoogFcsJ
dOgHKDo1Xw3hSas0s7Q+uFHZSzpM4X/h+ich4cUQHgMbJLgoTpU3qbHYw6IIIxXLCZSh/ozPeX8I94N1
QOKA0eY1qfpI2TO4CEEqlmMaO3vpRURCGzyXwE7Ad4FEGpWcd7moXkkKrZHasT4rpVVrIK67eOVqCDw8
db4epSzl8+oYl1USyCdLrjaQQmdaliZVv/UkPXwclIP6c4BvLJvzz3anyKTcwM9flVTTpqcWjQEjMS6C
26sVXcT9fB/5p6PuAnDnemB7UyFY7Hzjzn3v8PiPyVxUIdeQDAL+SFWrjsrxzu3Yadm+A55+6O8NdgEW
WqctFpxYD7a57/Xw8vN/FvD8TWzKy5jksoDgsKyb9x683uLqdh15H3AI8JXHuy1t1hjwEInCug5+8BR4
B53BVrAbeICD808eGbdznvvZc918LUIi+QkolT+EM+wOIQAAAABJRU5ErkJggg==
</value>
</data>
</root>
Loading

0 comments on commit 021fdc2

Please sign in to comment.