User:Kczappa: Difference between revisions

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


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


Pages On WMS that needs to be done:
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.
Edit HEC-1 Parameters Dialog which include:


Basin HEC-1 Cards dialogs that include:
'''Three reasons why run times might be longer:'''


Basin Data...
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.
Output Control...
Precipitation...
Loss Method...
Unit Hydrograph Method...
Snow Melt Data...


Routing HEC-1 Cards dialogs include:
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.


Routing Data...
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.
Output Control...
Reservoir Data...
Channel Data...
Output Control...


HEC-1 File Output (select to edit)
'''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:'''
[[File:CityWater_Project_Details.PNG|700 px|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===
===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 76: Line 84:
''Routing HEC-1 Cards'' section –
''Routing HEC-1 Cards'' section –


*[[#Routing Data Dialog|'''Routing Data...'']] – Allows the specification of routing data.
*[[#Routing Data Dialog|''Routing Data...'']] – Allows the specification of routing data.
**KK –  
**KK – Outlet Names.
**RL –
**RL – Channel Losses.
**RD –
**RD – Muskingum-Cunge.
**RK –
**RK – Kinematic Wave.
**RM –
**RM – Muskingum.
**RT –
**RT – Straddler Stagger.
**RS –
**RS – Storage Routing.


*[[#Output Control Dialog|'''Output Control...''']] – Allows different output controls to be specified.
*[[#Output Control Dialog|'''Output Control...''']] – Allows different output controls to be specified.
Line 90: Line 98:


*[[#Reservoir Data Dialog|'''Reservoir Data...''']] – Allows the specification of reservoir data.
*[[#Reservoir Data Dialog|'''Reservoir Data...''']] – Allows the specification of reservoir data.
**SV –
**SV – Volume.
**SA –
**SA – Area.
**SE –
**SE – Elevation.
**SQ –
**SQ – Outflow.
**SL –
**SL – Low-Level Outlet.
**SS –
**SS – Spillway Characteristics.
**ST –
**ST – Dam Overtopping.


*[[#Channel Data Dialog|'''Channel Data...''']] – Allows the specification of Channel data.
*[[#Channel Data Dialog|'''Channel Data...''']] – Allows the specification of Channel data.
Line 106: Line 114:


*[[#Diversion Data Dialog|'''Diversion Data...''']] – Allows the specification of diversion data.
*[[#Diversion Data Dialog|'''Diversion Data...''']] – Allows the specification of diversion data.
**DT –
**DT – Editing Diversion Data.
**DI –
**DI – Inflow.
**DQ –
**DQ – Outflow.
**DR –
**DR –  


*[[#Output Control Dialog|'''Output Control...''']] – Allows different output controls to be specified.
*[[#Output Control Dialog|'''Output Control...''']] – Allows different output controls to be specified.
Line 123: Line 131:
'''Help''' –
'''Help''' –


==Basin Data Dialog==
==Channel Data Dialog==
[[Image:HEC1 Basin Data.jpg|thumb|200 px|''HEC-1 Basin Data'' dialog]]
=='''Define Reservoir Data''' – Select to open ''Define Reservoir Data'' dialog.==


"Basin name" – Name of the specific Basin that's being defined.
Related Links:
"Area" – Area of the Basin being defined (mi^2).
"Basin Descriptor (OPtional)" – Option for more Description of the Basin.
"Input hydrograph (QI, BI) –
*"Direct input hydrograph (QI)
*'''Define QI''' – Allows for the definition of the direct input hydrograph.
*"Tape 21 input hydrograph (BI)" –
*"Tape 22 input hydrograph (BI)" –
"Observed hydrograph (QO)" –
*'''Define QO''' –


Base Flow Parameters
https://www.xmswiki.com/wiki/WMS:TR-20_Reservoir_Data
*"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)


==Output Control Dialog==
=='''Reservoir Output Control''' – Select to open ''Reservoir Output Control'' dialog.==
[[Image:HEC1 Output Control.jpg|thumb|400 px|''HEC-1 Output Control'' dialog]]


''Comment Lines'' section – Section that allows comments to be written out.
Related Links:
*'''New''' – Select to add a new comment.
*'''Delete''' – Select to delete an existing comment.


''Output Control (KO)''
https://www.xmswiki.com/wiki/WMS:TR-20_Reservoir_Data
*Print Control (field 1) – controls how the data collected is printed.
**"Use IO record (O)" – Default setting, prints the entire IO record.
**"Print all output (1,2)" – When selected, prints all output.
**"Print input and summaries" – When selected, it will just print input and summaries of the data.
**"Print input data only (4)" – When selected, it will print the input data only.
*Plot Control (field 2) – Section where plots can be controlled.
**"Use IO record (O)" – Plots are dependant on the IO record.
**"No printer plots (1)" – Select if there are no printer plots.
**"Plot hydrograph (2)" – Select to receive output on the plot hydrograph.
*Plotting Scale (field 3) – Section to specify the plotting scale.
*Unit 7 Control (field 4) – If the unit 7 control should be on select yes, if not select no.
*Hydrograph Control (field 5) – Section designated to control the output of hydrographs.
**"TAPE22 file (22)" – The file read by WMS for the display of hydrographs. This should only be changed to suppress particular hydrographs.
**"TAPE 21 file (21)" – The file used to suppress particular hydrographs.


==Precipitation Dialog==
[[Image:HEC1 Precipitation.jpg|thumb|300 px|''HEC-1 Precipitation'' dialog]]


''No Precipitation'' – Select if there was no precipitation.
==Editing HY8:Controlling Plot Display Options==
''Basin average (PB)'' – Select to specify the Basin Average.
*''Average precipitation:'' – Enter the average precipitation in inches here.
*'''Define Series''' – Select to bring up the ''XY Series Editor'' dialog.
*'''Get Precip From Web''' – Select to bring up the ''Get Online NOAA Atlas 14 Data'' dialog.
''Gage (PG)'' –
''Hypothetical storm (PH)'' – Select to


==Loss Method Dialog==
https://www.xmswiki.com/index.php?title=HY8:Controlling_Plot_Display_Options&action=edit
[[Image:HEC1 Loss Methods.jpg|thumb|275 px|''HEC-1 Loss Method'' dialog]]
 
==Unit Hydrograph Method Dialog==
[[Image:HEC1 Unit Hydrograph Methods.jpg|thumb|400 px|''HEC-1 Unit Hydrograph Methods'' dialog]]
 
==Snow Melt Data Dialog==
[[Image:HEC1 Snow Melt Data.jpg|thumb|400 px|''HEC-1 Snow Melt Data'' dialog]]
 
==Routing Data Dialog==
==Reservoir Data Dialog==
==Channel Data Dialog==
==Diversion Data Dialog==

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