User:Kczappa: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
 
(36 intermediate revisions by 2 users not shown)
Line 1: Line 1:
'''Kayla Czappa'''
'''Kayla Czappa'''


:Aquaveo
[[User:Kczappa/CW:CityWater FAQ]]
===CityWater Model Runs===


Links to remember to edit:
When performing model runs with CityWater, it is common to see a lag in the amount of time it takes to process the run. When there are too many runs to perform simultaneously, CityWater uses a scheduling system to sort the model runs. To ensure that each product can get processed effectively without crashing, CityWater was designed to organize each run into a waiting queue which can be the cause of longer run times.
https://www.xmswiki.com/index.php?title=WMS:TR-20_Reservoir_Data&action=submit


https://www.xmswiki.com/wiki/WMS:TR-20_Routing_Data#Defined_Cross_Sections
'''Three reasons why run times might be longer:'''


*****https://www.xmswiki.com/wiki/WMS:Routing_HEC-1_Cards
1. Writing the results to the database – CityWater must be able to access results. Therefore, some of the time used to execute the run goes towards writing the results to the database so that the CityWater app can find and access the data that is needed.


2. Performing extra analysis – One of the reasons it takes CityWater longer to run than in Epanet is because CityWater has to generate the zone, pressure swing, and peak-day fire flow layers which aren't offered in Epanet. This creates a longer wait time for each run.


Pages On WMS that needs to be done:
3. Generating the visualization layers – CityWater uses visualization layers to display the model on the map which takes more time to generate and leads to a longer run time.
Edit HEC-1 Parameters Dialog which include:


Basin HEC-1 Cards dialogs that include:
'''Running Scenarios'''


Basin Data...
Since not all of the steps above are necessary while running scenarios, it is more common for a scenario to run faster than the initial upload. Running the scenario, however, should take roughly the same amount of time as it would for the initial model upload. Both the number of pipes and the number of time steps contained within the model will increase the amount of time it takes to run the model. This is due to the fact that the size of the model increases accordingly. The suggested amount of pipes for a given project is roughly around 10,000 to 15,000 pipes and 100 time steps. At this time, CityWater best performs under these parameters.
Output Control...
Precipitation...
Loss Method...
Unit Hydrograph Method...
Snow Melt Data...


Routing HEC-1 Cards dialogs include:
'''Ways to better the outcome of larger scale models:'''


Routing Data...
[[File:CityWater_Project_Details.PNG|700 px|Example of the Project Details page]]
Output Control...
Reservoir Data...
Channel Data...
Output Control...


HEC-1 File Output (select to edit)
1. Reducing the number of pipes within the model – An accurate Epanet model is not always contingent on a high number of pipes. Therefore, it is likely that reducing the pipes in a the model will still be effective.


2. Reduce the number of time steps within the model – When working with a larger model, it might be effective to reduce the typical 24 hours with a 15 minute time steps to an hourly time step over a span of 24 hours.


3. Use the Viewing options – In a model, the exclusion of the Scenario, Fire Flow, or Schematic add-ons could benefit the project. With use of only the visualization capabilities, the model can still function, even with larger projects, because they are not highly influenced by the size of the model.
Links to finish:
https://www.xmswiki.com/wiki/WMS:File_Import_Wizard#Step_1_.E2.80.93_File_Outline


===WMS: Edit HEC-1 Parameters dialog===
===WMS: Edit HEC-1 Parameters dialog===
[[Image:Edit HEC-1 Parameters.jpg|thumb|470 px|''Edit HEC-1 Parameters'' dialog]]
[[Image:Edit HEC-1 Parameters.png|thumb|470 px|''Edit HEC-1 Parameters'' dialog]]
When a basin is selected in the HEC-1 model, selecting ''HEC-1'' | '''Edit Parameters''' will bring up the ''Edit HEC-1 Parameters'' dialog with the ''Basin HEC-1 Cards'' section active. The following can then be specified:
When a basin is selected in the HEC-1 model, selecting ''HEC-1'' | '''Edit Parameters''' will bring up the ''Edit HEC-1 Parameters'' dialog with the ''Basin HEC-1 Cards'' section active. The following can then be specified:


Line 130: Line 130:


'''Help''' –
'''Help''' –
==''HEC-1 Basin Data'' Dialog DONE==
[[Image:HEC1 Basin Data.jpg|thumb|200 px|''HEC-1 Basin Data'' dialog]]
Dialog is accessed by selecting ''HEC-1'' | '''Edit Parameters...''' in WMS and then choosing '''Basin Data...''' from the ''Edit HEC-1 Parameters'' dialog.
''Basin name''– Each hydrograph station should be identified with a unique name. This name appears as part of the KK record for that station in the input file.
''Area'' – Areas should be entered in either square miles or square kilometers.
''Basin Descriptor (Optional)'' – Option for more Description of the Basin.
''Input hydrograph (QI, BI)'' –
*''Direct input hydrograph (QI)'' – This hydrograph can be input by selecting the checkbox.
*'''Define QI''' – Allows for the definition of the direct input hydrograph. Click to open the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
*''Tape 21 input hydrograph (BI)'' – Select to indicate that the data should be input as a general hydrograph.
*''Tape 22 input hydrograph (BI)'' – Select to indicate that the data should be input as a specific hydrograph.
''Observed hydrograph (QO)'' –
*'''Define QO''' – Allows the definition of the outflow hydrograph. Click to open the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
Base Flow Parameters – Base flow parameters can be defined for a basin by selecting the ''Enter base flow'' checkbox. The input parameters for base flow are as follows:
*''Enter base flow'' – Select this to enter the defined base flow.
*''STRTQ'' – Flow at the start of the storm in cfs (cms for metric units).
*''QRCSN'' – Flow in cfs (cms) below which base flow recession occurs in accordance with the recession constant RTIOR. In other words, it is that flow where the straight line (in semilog paper) recession deviates from the falling limb of the hydrograph.
*''RTIOR'' – The ratio of the recession flow (QRCSN) to that flow occurring one hour later (Must be greater than or equal to 1).


==Channel Data Dialog==
==Channel Data Dialog==
==RK/RD Channels Dialog==
[[Image:RK RD Channels Dialog.JPG|thumb|400 px|''HEC-1 RK/RD Channels'' dialog]]
Accessed by selecting '''Define Channels''' in the Kinematic wave section of the ''HEC-1 Unit Hydrograph Methods'' dialog.
Main Channel RK/RD record
*Normal Muskingum Cunge Parameters
**''L'' – Channel length.
**''S'' – Channel slope.
**''N'' – Manning's roughness.
**''Shape'' – Characteristic channel shape.
***''TRAP'' – Trapezoid.
***''DEEP'' – Deep.
***''CIRCULAR'' – Circular.
**''WD'' – Base width of the channel.
**''Z'' – Side slope of channel.
**''Use Cross Section'' – Select to bring up the '''Define Cross Section''' option in this dialog.
***'''Define Cross Section''' – Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
''Second RK/RD record (HMS collector)'' – Select to enter a second RK/RD record.
*''L'' – Channel length.
*''S'' – Channel slope.
*''N'' – Manning's roughness.
*''Shape'' – Characteristic channel shape.
**''TRAP'' – Trapezoid.
**''DEEP'' – Deep.
**''CIRCULAR'' – Circular
*''WD'' – Base width of the channel.
*''Z'' – Side slope of channel.
''Third RK/RD record (HMS collector)'' – Select to enter a third RK/RD record.
*''L'' – Channel length.
*''S'' – Channel slope.
*''N'' – Manning's roughness.
*''Shape'' – Characteristic channel shape.
**''TRAP'' – Trapezoid.
**''DEEP'' – Deep.
**''CIRCULAR'' – Circular.
*''WD'' – Base width of the channel.
*''Z'' – Side slope of channel.
''Route upstream hydrographs to main channel'' – Select to route upstream hydrographs to the main channel.
==WMS:Basin Geometric Attributes Dialog==
[[Image:Basin_Geometric_Attributes_dialog_WMS.PNG|thumb|none|left|500 px|''HEC-1 Basin Geometric Attributes'' dialog]]
Accessed by selecting '''Basin Geometrical Attributes''' located in the ''HEC-1 Unit Hydrograph Methods'' dialog.
Variable Names – Below the Variable Names heading is a table that allows the inputting of values for each one of the listed variables' names.
'''Recompute Basin Data''' – Select to bring up the [[WMS:Units Toolbar|''Units'' dialog]].
'''Restore Original Values''' – Select to revert all values in the Variable Names table back to their original values.
==Basin Time Computation Dialog==
[[Image:Basin_Time_Computation_Dialog_WMS.PNG|thumb|400 px|''HEC-1 Basin Time Computation'' dialog]]
Accessed by selecting '''Compute Parameters-Basin Data''' in the ''HEC-1 Unit Hydrograph Methods'' dialog.
''Basin'' –
''Instructions / Results (You may have to scroll down)'' –
''Computational type:'' –
{| class="wikitable mw-collapsible mw-collapsed"
|+ class="nowrap" | "Compute Lag Time"
|-
|
! scope="col" | Selections
! scope+"col" | Selection Options
|-
! scope="row" |
| ''Method:'' ||"Denver Method"
"Tulsa Rural Method" –
"Tulsa 50% Urban Method" –
"Tulsa 100% Urban Method" –
"Espey Rural Method" –
"Espey No Urbanization Method" –
"Espey Partly Urban Method" –
"Espey Completely Urban Method" –
"Riverside Mountains Method" –
"Riverside Foothills Method" –
"Eagleson Method" –
"USGS Nationwide Urban Method" –
"Putnam Method" –
"Taylor Method" –
"Colorado State University (CSU) Method" –
"Scs Method" –
"Custom Method" –
|-
! scope="row" |
| '''User Defined...''' – || Select to bring up ''Modify Equation'' dialog.
|-
! scope="row" |
|'''Modify Equation...''' || Select to bring up the ''Modify Equation'' dialog that allows you to modify the equation used for the Basin time computation.
|-
! scope="row" |
|'''Basin Variables...''' –||
|
|}
{| class="wikitable mw-collapsible mw-collapsed"
|+ class="nowrap" | "Compute Time of Concentration"
|-
|
! scope="col" | Selections
! scope+"col" | Selection Options
|-
! scope="row" |
| ''Method:'' ||"User Defined Method"
"Kirpich Method for overland flow on bare earth" –
"Kirpich Method for overland flow on grassy earth" –
"Kirpich Method for overland flow on asphalt" –
"Kirpich Method for overland flow on bare earth (Mountains)" –
"Kirpich Method for overland flow on grassy earth (Mountains)" –
"Kirpich Method for overland flow on asphalt (Mountains)" –
"Ramser Method for channel flow" –
"Fort Bend County Method" –
"Kerby Method for overland flow" –
"ADOT Method (Desert/Mountain)" –
"ADOT Method (Urban)" –
|-
! scope="row" |
| '''User Defined...''' – || Select to bring up ''Modify Equation'' dialog.
|-
! scope="row" |
|'''Modify Equation...''' || Select to bring up the ''Modify Equation'' dialog that allows you to modify the equation used for the Basin time computation.
|-
! scope="row" |
|'''Basin Variables...''' –||
|
|}
*''Instructions'' – Place that allows the reading of warnings that may occur in the equation as well as a list of pre-defined variables that are computed by WMS.
''Equation'' – The equation being used for calculation.
*'''Parse''' – Click to parse through the equation.
Variable Abbreviations – A list of variable abbreviations relating to the equation.
Definitions – A list of definitions for the variable abbreviations.
''Units'' – ||The units that apply to the definition chosen.
*"none"
*"ft" – Feet
*"m" – Meters
*"km" – Kilometers
*"mi" – Mile
*hr" – Hour
*"min" – Minute
*"sec" — Second
*"sq. mi" – Square mile (mi^2)
*"sq. km" – Square kilometer (km^2)
*"sq. ft" – Square foot (ft^2)
*"acre" –
*"hect" –
*"in" – Inch
*"mm" – Millimeter
*"ft/mi" – Foot per mile
*"fract" –
''Method:'' –
Related links:
https://www.xmswiki.com/wiki/WMS:Travel_Times_from_Basin_Data
==Compute NSTPS Dialog==
[[Image:Compute_NSTPS_Dialog_(From_Upstream).PNG|thumb|400 px|''Compute NSTPS'' dialog (''From Upstream and Routed Hydrographs'')]]
Accessed by Selecting '''Compute NSTPS''' in the ''HEC-1 Routing Data'' dialog.
''From Upstream and Routed Hydrographs'' – Select to allow the definition of variables associated with Upstream and Routed Hydrographs.
''Compute for all outlets'' – Select to compute for all outlets.
*''Turn on Muskingum routing'' – Select to apply Muskingum routing.
''Upstream Hydrograph'' – Select to choose an Upstream Hydrograph.
''Estimated AMSKK'' – Select to find the estimated Muskingum ''k'' coefficient in hours for entire reach.
''For Channel Velocity Estimate'' – Select to find the estimate for the channel velocity.
''Compute for currently selected outlet'' – Select to compute the outlet that has been chosen.
''Compute for all outlets'' – Select to compute for all outlets.
*''Turn on Muskingum routing'' – Select to apply Muskingum routing.
''Channel Velocity Estimate:'' – An estimation of the channel velocity measured in feet per second.
=='''Define Reservoir Data''' – Select to open ''Define Reservoir Data'' dialog.==
=='''Define Reservoir Data''' – Select to open ''Define Reservoir Data'' dialog.==


Line 379: Line 143:


https://www.xmswiki.com/wiki/WMS:TR-20_Reservoir_Data
https://www.xmswiki.com/wiki/WMS:TR-20_Reservoir_Data
==Editing HY8:Controlling Plot Display Options==
https://www.xmswiki.com/index.php?title=HY8:Controlling_Plot_Display_Options&action=edit

Latest revision as of 22:13, 13 July 2020

Kayla Czappa

User:Kczappa/CW:CityWater FAQ

CityWater Model Runs

When performing model runs with CityWater, it is common to see a lag in the amount of time it takes to process the run. When there are too many runs to perform simultaneously, CityWater uses a scheduling system to sort the model runs. To ensure that each product can get processed effectively without crashing, CityWater was designed to organize each run into a waiting queue which can be the cause of longer run times.

Three reasons why run times might be longer:

1. Writing the results to the database – CityWater must be able to access results. Therefore, some of the time used to execute the run goes towards writing the results to the database so that the CityWater app can find and access the data that is needed.

2. Performing extra analysis – One of the reasons it takes CityWater longer to run than in Epanet is because CityWater has to generate the zone, pressure swing, and peak-day fire flow layers which aren't offered in Epanet. This creates a longer wait time for each run.

3. Generating the visualization layers – CityWater uses visualization layers to display the model on the map which takes more time to generate and leads to a longer run time.

Running Scenarios

Since not all of the steps above are necessary while running scenarios, it is more common for a scenario to run faster than the initial upload. Running the scenario, however, should take roughly the same amount of time as it would for the initial model upload. Both the number of pipes and the number of time steps contained within the model will increase the amount of time it takes to run the model. This is due to the fact that the size of the model increases accordingly. The suggested amount of pipes for a given project is roughly around 10,000 to 15,000 pipes and 100 time steps. At this time, CityWater best performs under these parameters.

Ways to better the outcome of larger scale models:

Example of the Project Details page

1. Reducing the number of pipes within the model – An accurate Epanet model is not always contingent on a high number of pipes. Therefore, it is likely that reducing the pipes in a the model will still be effective.

2. Reduce the number of time steps within the model – When working with a larger model, it might be effective to reduce the typical 24 hours with a 15 minute time steps to an hourly time step over a span of 24 hours.

3. Use the Viewing options – In a model, the exclusion of the Scenario, Fire Flow, or Schematic add-ons could benefit the project. With use of only the visualization capabilities, the model can still function, even with larger projects, because they are not highly influenced by the size of the model.


Links to finish:


https://www.xmswiki.com/wiki/WMS:File_Import_Wizard#Step_1_.E2.80.93_File_Outline

WMS: Edit HEC-1 Parameters dialog

Edit HEC-1 Parameters dialog

When a basin is selected in the HEC-1 model, selecting HEC-1 | Edit Parameters will bring up the Edit HEC-1 Parameters dialog with the Basin HEC-1 Cards section active. The following can then be specified:

<--Previous Hydrograph Station –

Next Hydrograph Station--> –

Basin HEC-1 Cards section –

  • Basin Data... – Allows the specification of Basin Data.
    • KK – Basin Name.
    • BA – Basin Area.
    • BF – Baseflow.
  • Output Control... – Allows different output controls to be specified.
    • KM – Comment Lines.
    • KO – Output Control.
  • Precipitation... – Allows the specification of precipitation data.
    • PB – Basin Average Precipitation.
    • PG – Precipitation Gage.
    • PH – Hypothetical Storm.
    • PI – Probable Maximum Precipitation.
    • PC –
    • PM –
  • Loss Method... – Allows the specification of Loss Methods being applied.
    • LU – Uniform Loss Method.
    • LE – Exponential Loss
    • LG – Green & Ampt.
    • LH – Holtan.
    • LS – SCS Loss Method.
  • Unit Hydrograph Method... – Allows the specification of Hydrograph methods being applied.
    • UC – Clark Unit Hydrograph.
    • US – Snyder
    • UA –
    • UD – SCS Dimensionless.
    • UK – Kinematic Wave.
  • Snow Melt Data... – Allows the specification of snow melt data.
    • MA – Elevation Zone Data.
    • MC –
    • MS – Shot-Wave Radiation Time Series.
    • MD – Dew Point Time Series.
    • MW – Wind Speed Time Series.

Routing HEC-1 Cards section –

  • Routing Data... – Allows the specification of routing data.
    • KK – Outlet Names.
    • RL – Channel Losses.
    • RD – Muskingum-Cunge.
    • RK – Kinematic Wave.
    • RM – Muskingum.
    • RT – Straddler Stagger.
    • RS – Storage Routing.
  • Output Control... – Allows different output controls to be specified.
    • KM – Comment Lines.
    • KO – Output Control.
  • Reservoir Data... – Allows the specification of reservoir data.
    • SV – Volume.
    • SA – Area.
    • SE – Elevation.
    • SQ – Outflow.
    • SL – Low-Level Outlet.
    • SS – Spillway Characteristics.
    • ST – Dam Overtopping.
  • Channel Data... – Allows the specification of Channel data.
    • AC –
    • RX –
    • RY –

Diversion HEC-1 Cards section –

  • Diversion Data... – Allows the specification of diversion data.
    • DT – Editing Diversion Data.
    • DI – Inflow.
    • DQ – Outflow.
    • DR –
  • Output Control... – Allows different output controls to be specified.
    • KM – Comment Lines.
    • KO – Output Control.

HEC-1 File Output-select to edit section –

"Display Job Control Cards" – By selecting this, it allows the Job Controls to be viewed.

Copy to Clipboard – Allows the information to be copied to the clipboard for any future use.

Help –

Channel Data Dialog

Define Reservoir Data – Select to open Define Reservoir Data dialog.

Related Links:

https://www.xmswiki.com/wiki/WMS:TR-20_Reservoir_Data

Reservoir Output Control – Select to open Reservoir Output Control dialog.

Related Links:

https://www.xmswiki.com/wiki/WMS:TR-20_Reservoir_Data


Editing HY8:Controlling Plot Display Options

https://www.xmswiki.com/index.php?title=HY8:Controlling_Plot_Display_Options&action=edit

Retrieved from "https://www.xmswiki.com/index.php?title=User:Kczappa&oldid=147478"