User:Kczappa: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
 
(242 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.
 
''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. 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''' – Click to open the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
Base Flow Parameters
*''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==
[[Image:HEC1 Output Control.jpg|thumb|400 px|''HEC-1 Output Control'' dialog]]
 
''Comment Lines'' section – Section that allows comments to be written out.
*'''New''' – Select to add a new comment.
*'''Delete''' – Select to delete an existing comment.


''Output Control (KO)''
Related Links:
*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==
https://www.xmswiki.com/wiki/WMS:TR-20_Reservoir_Data
[[Image:HEC1 Precipitation.jpg|thumb|300 px|''HEC-1 Precipitation'' dialog]]


''No Precipitation'' – Select if there was no precipitation.
=='''Reservoir Output Control''' – Select to open ''Reservoir Output Control'' dialog.==
''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 [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
*'''Get Precip From Web''' – Select to bring up the ''Get Online NOAA Atlas 14 Data'' dialog.
''Gage (PG)'' –
*'''PT Gage Weights''' – Section where gage weights can be changed/assigned.
*'''PR Gage Weights''' – Section where gage weights can be changed/assigned.
''Hypothetical storm (PH)'' – Select to define the characteristics of a hypothetical storm.
*'''Define Storm''' – Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
*''Frequency'' – Enter the frequency of a hypothetical storm here.
*''Storm area:'' – Enter the area of the hypothetical storm in mi^2.
''Probable Maximum Precipitation (PM)'' – Allows for the computation of the probable maximum storm according to the outdated Hydrometeorological Report No. 33 (HMR 33).
*''PMS:'' – Enter the probable maximum index precipitation from the HMR 33. Recorded in inches.
*'''% of PMS''' – Click to bring up the ''HEC-1 Percentage of PMS'' dialog.
**''Maximum 6-hour percentage of PMS'' – Maximum amount of probable precipitation inside a 6 hour time period.
**''Maximum 12-hour percentage of PMS'' – Maximum amount of probable precipitation inside a 12 hour time period.
**''Maximum 24-hour percentage of PMS'' – Maximum amount of probable precipitation inside a 24 hour time period.
**''Maximum 48-hour percentage of PMS'' – Maximum amount of probable precipitation inside a 48 hour time period.
**''Maximum 72-hour percentage of PMS'' – Maximum amount of probable precipitation inside a 72 hour time period.
**''Maximum 96-hour percentage of PMS'' – Maximum amount of probable precipitation inside a 96 hour time period.
*'''SWD''' – Click to open the ''Precipitation Distribution'' dialog.
**''EM 1110-2-21411 criteria'' –
**''Southwestern Division criteria'' –
*''TRSPC:'' – Precipitation adjustment (between 0 and 1.0) based on drainage area size. If this value is set at zero HEC-1 will default it to the appropriate value based on the HOP Brook Adjustment Factor as described in the HEC-1 manual.
*''TRSDA:'' – The drainage area in square miles for which the storm is transposed.


==Loss Method Dialog==
Related Links:
[[Image:HEC1 Loss Methods.jpg|thumb|275 px|''HEC-1 Loss Method'' dialog]]


''Uniform (LU)'' – Losses are used in conjunction with the uniform (LU) or exponential (LE) loss methods.
https://www.xmswiki.com/wiki/WMS:TR-20_Reservoir_Data
*''STRTL'' – Initial rainfall/snow melt loss in inches (mm) for snow free ground.
*''CNSTL'' – Uniform rainfall/ loss in inches/hour (mm/hour) which is used after the starting loss ''(STRTL)'' has been satisfied.
*''RTIMP'' –  Ratio of the drainage basin that is impervious. Values should be less than or equal to 1.
''Exponential (LE)'' – Parameters for the exponential loss method are as follows
*''STRKR'' – The starting value of the loss coefficient on the exponential recession curve for rain losses.
*''DLTKR'' – The amount in inches (mm) of initial accumulated rain loss during which the loss coefficient is increased.
*''RTIOL'' – Parameter computed as the ratio of ''STRKR'' to a value of ''STRKR'' after ten inches (ten mm) of accumulated loss.
*''ERAIN'' – Exponent of precipitation for rain loss function that reflects the influence of the precipitation rate on basin-average loss characteristics.
*''RTIMP'' – Ratio of the drainage basin that is impervious. Values should be less than or equal to 1.
''Green ampt (LG)'' – Green-Ampt infiltration loss parameters are as follows:
*''IA'' – Initial loss (abstraction) in inches (mm).
*''DTHETA'' – Volumetric moisture deficit. If this value is 0, then the method reduces to the initial loss equal to IA and a constant loss equal to ''XKSAT''.
*''PSIF'' – Wetting front suction in inches (mm). If this value is 0, then the method reduces to the initial loss equal to IA and a constant loss equal to ''XKSAT''.
*''XKSAT'' – Hydraulic conductivity at natural saturation in inches/hour (mm/hour).
*''RTIMP'' –  Ratio of the drainage basin that is impervious. Values should be less than or equal to 1.
''Holtan (LH)'' – Parameters used to define the Holtan loss method:
*''FC'' – Holtan's long term equilibrium loss rate in inches/hour (mm/hour) for rainfall/losses on snow free ground.
*''GIA'' – Infiltration rate in inches/hour per inch *''BEXP'' (mm/hour per mm *''BEXP'') of available soil moisture storage capacity.
*''SAI'' – Initial depth in inches (mm) of pore space in the surface layer of the soil which is available for storage of infiltrated water.
*''BEXP'' – Exponent of available soil moisture storage.
*''RTIMP'' –  Ratio of the drainage basin that is impervious. Values should be less than or equal to 1.
''SCS curve number (LS)'' – The SCS curve number method uses the following parameters:
*''STRTL'' – Initial rainfall abstraction in inches (mm) for snowfree ground. If value is 0, then initial abstraction will be computed as:
::<math>0.2* \frac {(1000-10*CRVNBR)}{CRVNBR}</math>.
*''CRVNBR'' &ndash; SCS curve number for rainfall/ losses on snowfree ground.
'''''NOTE:''''' Composite Curve Numbers can be computed automatically when this method for computing losses is chosen and a terrain model is present.
*''RTIMP'' &ndash;  Ratio of the drainage basin that is impervious. Values should be less than or equal to 1.


==Unit Hydrograph Method Dialog==
[[Image:HEC1 Unit Hydrograph Methods.jpg|thumb|400 px|''HEC-1 Unit Hydrograph Methods'' dialog]]
''Clark (UC)'' &ndash;
*''TC:'' &ndash; Measured in hours.
*''R:'' &ndash; Measured in hours.
*''Define Time Area'' &ndash;
*'''Compute Tc and R-Maricope County''' &ndash; This option is only available when the selection of Green ampt (LG) or Uniform (LU) Loss method in the HEC-1 Loss Methods dialog has been done.
''Snyder (US)'' &ndash;
*''TP:'' &ndash; Measured in hours.
*''CP:'' &ndash;
*''Define Time Area'' &ndash; Select this to allow the definition of the specific time area that is being assessed.
''SCS dimensionless (UD)'' &ndash;
*''TLAG:'' &ndash; Measured in hours.
''Given unit hydrograph (UI)'' &ndash;
*'''Define Unit Graph''' &ndash; Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
*'''Maricope County S-Graph''' &ndash; Select this to bring up the ''S-Graph Option'' dialog.
**''S-Graph Types'' section &ndash;
***"Phoenix Valley" &ndash;
***"Phoenix Mountain" &ndash;
***"Desert rangeland" &ndash;
***"Agricultural" &ndash;
*Basin area=31.8901  (sq. miles)
**''Basin Lag Time:'' &ndash; Measured in minutes.
**''Computational Time Step:'' &ndash; 15 minutes.
''Kinematic Wave (UK)'' &ndash;
*First Kinematic Record &dash;
**''L:'' &ndash; Represents the Overland flow length (measured in ft).
**''S:'' &ndash; Representative slope (measured in ft/ft).
**''N:'' &ndash; Represents Manning's roughness coefficient.
**''A:'' &ndash; Represents the percentage of sub-basins area that this record represents (The total of the two records must be the sum of 100).
*'''Define Loss''' &ndash; Click to open the [[WMS:Loss Method dialog|''HEC-1 Loss Methods'' dialog]]HEC-1 Loss Methods dialog.


==Snow Melt Data Dialog==
==Editing HY8:Controlling Plot Display Options==
[[Image:HEC1 Snow Melt Data.jpg|thumb|400 px|''HEC-1 Snow Melt Data'' dialog]]


==Routing Data Dialog==
https://www.xmswiki.com/index.php?title=HY8:Controlling_Plot_Display_Options&action=edit
==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