User:Kczappa: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
 
(49 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:'''


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.


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


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


Basin Data...
'''Running Scenarios'''
Output Control...
Precipitation...
Loss Method...
Unit Hydrograph Method...
Snow Melt Data...


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


Routing Data...
'''Ways to better the outcome of larger scale models:'''
Output Control...
Reservoir Data...
Channel Data...
Output Control...


HEC-1 File Output (select to edit)
[[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 128: 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).
==Output Control Dialog==
[[Image:HEC1 Output Control.jpg|thumb|400 px|''HEC-1 Output Control'' dialog]]
Dialog is accessed by selecting ''HEC-1'' | '''Edit Parameters...''' in WMS and then choosing '''Output Control...''' from the ''Edit HEC-1 Parameters'' 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)''
*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.
==''HEC-1 Precipitation'' Dialog DONE==
[[Image:HEC1 Precipitation.jpg|thumb|300 px|''HEC-1 Precipitation'' dialog]]
Dialog is accessed by selecting ''HEC-1''|'''Edit Parameters...''' in WMS and then choosing '''Precipitation...''' from the ''Edit HEC-1 Parameters'' dialog.
If no precipitation for a given basin is chosen, then the program will use the precipitation pattern of the most recently defined basin. In other words, if the same precipitation pattern is to be used for each basin, specify precipitation at the upper-most basin and let all other basins "inherit" this same pattern.
''No Precipitation'' – Select if there was no precipitation.
''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)'' – Gages can be used with or without a terrain model. If drainage basins have been defined using a TIN, the appropriate gage weights (using the Thiessen polygon method) for each basin are automatically computed when the Compute (or Update) Basin Data command is executed.
*'''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'' – Represents the standard flood determinations for the project.
***''Southwestern Division criteria'' – Represents the flood determinations for the southwestern division.
*''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.
==''HEC-1 Loss Methods'' Dialog DONE==
[[Image:HEC1 Loss Methods.jpg|thumb|275 px|''HEC-1 Loss Method'' dialog]]
Dialog is accessed by selecting ''HEC-1''|'''Edit Parameters...''' in WMS and then choosing '''Loss Method...''' from the ''Edit HEC-1 Parameters'' dialog.
''Uniform (LU)'' – Losses are used in conjunction with the uniform (LU) or exponential (LE) loss methods.
*''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]]
Dialog is accessed by selecting ''HEC-1'' | '''Edit Parameters...''' in WMS and then choosing '''Unit Hydrograph Method...''' from the ''Edit HEC-1 Parameters'' dialog.
''Clark (UC)'' &ndash; Clark Method.
*''T<sub>C</sub>'' &ndash; Time of concentration in hours for the unit hydrograph.
*''R:'' &ndash; The Clark storage coefficient in hours.
*''Define Time Area'' &ndash; The time area curve defines the area of the watershed contributing runoff to the basin outlet as a function of time. Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
*'''Compute Tc and R-Maricopa 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; Snyder unit hydrograph.
*''TP:'' &ndash; Lag time in hours.
*''CP:'' &ndash; Peaking coefficient.
*''Define Time Area'' &ndash; The time area curve defines the area of the watershed contributing runoff to the basin outlet as a function of time. Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
''SCS dimensionless (UD)'' &ndash; Soil Conservation Services unit hydrograph that contains dimensionless time units and dimensionless discharge units.
*''TLAG:'' &ndash; Lag measured in hours.
''Given unit hydrograph (UI)'' &ndash; A given unit hydrograph determined from a separate analysis. The given unit hydrograph must be derived for the same time interval as is specified on the IT record in the ''Job Control'' dialog.
*'''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; Section that allows the choice of areas within Maricopa County for which an S-Graph will be created.
***"Phoenix Valley" &ndash; Area within Maricopa County.
***"Phoenix Mountain" &ndash; Area within Maricopa County.
***"Desert rangeland" &ndash; Area within Maricopa County.
***"Agricultural" &ndash; Represents the agriculture of Maricopa County.
*Basin area=31.8901  (sq. miles)
**''Basin Lag Time:'' &ndash; Measured in minutes.
**''Computational Time Step:'' &ndash; 15 minutes.
''Kinematic Wave (UK)'' &ndash; Section of the dialog where you can specify the characteristics attributed to the Kinematic Wave Method.
*''First Kinematic Record'' &dash; Section where the first data found regarding the Kinematic Wave Method can be recorded.
**''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 [[#HEC-1 Loss Methods Dialog|''HEC-1 Loss Methods'' dialog]].
*''Second Kinematic Record'' &ndash; Section where the second found data regarding the Kinematic Wave Method can be recorded.
**''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 [[#HEC-1 Loss Methods Dialog|''HEC-1 Loss Methods'' dialog]].
*''RK'' &ndash; Represents the Kinematic Wave routing.
*''RD'' &ndash; Represents the Muskingum-Cunge routing.
*'''Define Channels''' &ndash; Click to open the [[#RK/RD Channels Dialog|''RK/RD Channels'' dialog]].
*'''Basin Geometrical Attributes''' &ndash; Select to bring up the [[#Basin Geometric Attributes Dialog|''Basin Geometric Attributes'' dialog]] to define the geometric attributes of the data collected from the Basin.
*'''Compute Parameters-Basin Data''' &ndash; Select to bring up the [[#Basin Time Computation Dialog|''Basin Time Computation'' dialog]] and compute the parameters of the basin data collected.
*'''Compute Time Area Curve(s)''' &ndash; Select to bring up the ''Time Area Parameters'' dialog that allows you to specify the maximum run off distance and interval to determine the time area curve. (Option is only available when ''Snyder (US)'' is selected in the ''HEC-1 Unit Hydrograph Methods'' dialog.)
*'''Compute Parameters-Map Data''' &ndash; Select to determine the parameters of the Map Data.
==Snow Melt Data Dialog==
[[Image:HEC1 Snow Melt Data.jpg|thumb|400 px|''HEC-1 Snow Melt Data'' dialog]]
Dialog is accessed by selecting ''HEC-1'' | '''Edit Parameters...''' in WMS and then choosing '''Snow Melt Data...''' from the ''Edit HEC-1 Parameters'' dialog.
''Compute snow melt runoff'' &ndash; Select to allow the input data related to the amount of runoff produced from melting snow.
*Degree-day &ndash;
**Elevation Zone data &ndash; Section where elevation data for each zone is to be entered.
***''Base elevation of zone 1:'' (m) &ndash;
***''Zone elevation interval'' (m) &ndash;
***'''Define MA data...''' &ndash; Select to open the ''Define MA Data'' dialog which allows you to input variables for the elevation (ft), area (mi^2), snow pack (ft), and Average precipitation (in) for each zone.
****'''Compute Areas''' &ndash; Select this to open up the ''Units'' Dialog and specify model units for computation.
**Snow Melt Coefficients &ndash; Section where snow melt coefficients are to be entered.
***''Temp. lapse/zone:'' (F) &ndash;
***''Snow melt Coeff:'' &ndash;
***''Freezing temp:'' (F) &ndash;
**Temperature Time Series (MT) &ndash;
***'''Define MT''' &ndash; Select to open the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
''Energy-budget method'' &ndash; Select to allow the input of time series information.
*'''Define MD...''' &ndash; Represents the Dew point time series (MD). Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
*'''Define MS...''' &ndash; Represents the Short-wave radiation time series (MS). Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
*'''Define MW...''' &ndash; Represents the Wind-Speed time Series (MW). Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
''Snow melt losses (LM) &ndash; Section that allows the input of the amount of loss due to snow melting.
*''STRKS'' &ndash; Measured in inches per hour.
*''STIOK'' &ndash;
==HEC-1 Routing Data Dialog==
[[Image:HEC-1_Routing_Data_Dialog.PNG|thumb|500 px|''HEC-1 Output Control'' dialog]]
''Routing name'' &ndash; Enter the defined routing name here.
''Combining name'' &ndash;
''Routing Type'' &ndash; Enter the type of routing being currently used.
*"No Routing (RN)" &ndash; Select if there is no routing data attached to the current project.
*"Muskingum-Cunge (RD)" &ndash; Define the channel geometry using an eight point cross-section
**''Normal Muskingum Cunge parameters'' &ndash; Select to turn on the option to enter parameters.
***''L'' &ndash; Channel length.
***''S'' &ndash; Channel slope.
***''N'' &ndash; Manning's roughness.
***''SHAPE:'' &ndash; Characteristic channel shape.
****''TRAP'' &ndash; Select this when the channel shape is trapezoidal.
****''DEEP'' &ndash; Select this when the channel shape is deep.
****''CIRCULAR'' &ndash; Select this when the channel shape is circular.
***''WD'' &ndash; Base width of the channel.
***''Z'' &ndash; Side slope of channel.
**''Defined Cross Section'' &ndash; Select to bring up the '''Define Cross Section''' Option in this dialog.
***'''Enter RC Record''' &ndash; Select to bring up the ''RC Chennel Record'' dialog to define Manning and channel data.
*"Kinematic wave (RK)" &ndash; Select to define Kinematic Wave routing data.
***''L'' &ndash; Channel length.
***''S'' &ndash; Channel slope.
***''N'' &ndash; Manning's roughness.
***''Shape'' &ndash; Characteristic channel shape.
****''TRAP'' &ndash; Select this when the channel shape is trapezoidal.
****''DEEP'' &ndash; Select this when the channel shape is deep.
****''CIRCULAR'' &ndash; Select this when the channel shape is circular.
***''WD'' &ndash; Base width of the channel.
***''Z'' &ndash; Side slope of channel.
*"Muskingum (RM)" &ndash;  Select to define Muskingum routing data. It is dependent primarily upon an input weighting factor.
**'''Compute NSTPS''' &ndash; Select to compute the number of integer steps for the Muskingum routing.
**''NSTPS'' &ndash; The number of integer steps for the Muskingum routing.
**''AMSK'' &ndash; Muskingum K coefficient in hours for entire reach (measured in hours).
**''X'' &ndash; Muskingum x coefficient.
**"Straddler/Stagger (RT)" &ndash; Select to define Straddler/ Stagger routing data.
**'''Compute NSTPS''' &ndash; Select to compute the number of integer steps for the Muskingum routing.
**''NSTPS'' &ndash; The number of integer steps for the Muskingum routing.
**''AMSK'' &ndash; Muskingum K coefficient in hours for entire reach (measured in hours).
**''X'' &ndash; Muskingum x coefficient.
*"Storage (RS)" &ndash; Select to define storage data.
**'''Compute NSTPS''' &ndash; Select to compute the number of integer steps for the Muskingum routing.
**''NSTPS'' &ndash; The number of integer steps for the Muskingum routing.
**''Type'' &ndash; Define which of the following types is being used in this project.
***''STOR'' &ndash; Storage in acre-feet.
***''FLOW'' &ndash; Discharge in cfs.
***''ELEV'' &ndash; Elevation in feet.
***'''RSVRIC''' &ndash; This measurement changes depending on the initial condition type that is set. STOR is measured in ac-ft, FLOW is measured in cfs, and ELEV is measured in feet.
***'''X''' &ndash; Muskingum x coefficient.
**''Channel'' &ndash; Long strip of water.
**''Reservoir'' &ndash; Stagnent body of water.
**'''Define''' &ndash;
*"Convex (RV)" &ndash;
***''L'' &ndash; Channel length.
***''S'' &ndash; Channel slope.
***''N'' &ndash; Manning's roughness.
***''Shape'' &ndash; Characteristic channel shape.
****''TRAP'' &ndash; Select this when the channel shape is trapezoidal.
****''DEEP'' &ndash; Select this when the channel shape is deep.
****''CIRCULAR'' &ndash; Select this when the channel shape is circular.
***''WD'' &ndash; Base width of the channel.
***''Z'' &ndash; Side slope of channel.
''Channel Loss'' &ndash; Total water loss of the channel after the computation of three different factors which are listed below.
*''QLOSS'' &ndash; Constant channel loss in entire routing in cfs (cms). This value is subtracted from every ordinate of the inflow hydrograph.
*''CLOSS'' &ndash; Ratio of remaining flow (after ''QLOSS'') which is lost for entire routing.
*''PERCRT'' &ndash; Percolation rate cfs/acre (cu m/sec-acre) for wetted surface area of channel. This option is used in conjunction with storage routing and requires ''SA'' or ''SV/SE'' records to be defined.
*''ELVINV'' &ndash; Average invert elevation of channel L used to compute flow surface area for ''PERCRT''.
''Direct input hydrograph (QI)'' &ndash; A hydrograph defined by specific input.
*'''Define QI''' &ndash; Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
''Observed hydrograph (QO)'' &ndash; A hydrograph defined by specific observations.
*'''Define QO''' &ndash; Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
''Pattern hydrograph (QP)'' &ndash; A hydrograph defined by specific patterns.
*'''Define QP''' &ndash; Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
==Reservoir Data Dialog==
[[Image:Reservoir_Routing_Data_dialog_wms.PNG|thumb|275 px|''Reservoir Routing Data'' dialog]]
''Define Reservoir Routing'' &ndash; Select to activate the ability to define specific data pertaining to reservoir routing.
*''Reservoir Name'' &ndash; Enter the name of the reservoir here.
*''NSTEPS'' &ndash; Should be one for Straddler/Stagger method or integer number of routing steps to be used.
*Initial Condition Type &ndash; Indicates which type of reservoir is being defined.
**''STOR'' &ndash; Storage in acre-feet.
**''FLOW'' &ndash; Discharge in cfs.
**''ELEV'' &ndash; Elevation in feet.
*''RSVRIC'' &ndash; This measurement changes depending on the initial condition type that is set. ''STOR'' is measured in ac-ft, ''FLOW'' is measured in cfs, and ''ELEV'' is measured in feet.
*''X'' &ndash; Muskingum x coefficient.
*Type of Storage Routing &ndash; Used to specify the type of storage routing being used in the defining of the reservoir data.
**''Channel''&ndash; By selecting this you are associating the storage routing type to be specific to a channel.
**''Reservoir''&ndash; By selecting this you are associating the storage routing type to be specific to a reservoir.
**'''Define''' &ndash; Upon selecting either ''Channel'' or ''Reservoir'' as the type of storage routing, select this box to bring up the the ''Channel'' Dialog for Channel, or the HEC-1 Reseroir Routing Options'' Dialog for ''Reservoir''.
<div><ul>
<li style="display: inline-table;">
{| class="wikitable mw-collapsible mw-collapsed"
|+ Table 1 class="nowrap" |''Channel''
|-
|
! scope="col" | Channel Dialog
! scope+"col" | Dialog Options
|-
! scope="row" |
| [[Image:Channel_Dialog.PNG |thumb|none|left|275 px|''Channel'' dialog]] || '''Define RC Record'''
Enter the values of the elements asked for in this dialog.
'''Define Cross Section''' &ndash; Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
[[Image:RC_Channel_Record_Dialog.PNG |thumb|none|top|275 px|''RC Channel Record'' dialog]]
|-
! scope="row" |
| [[Image:Channel_Dialog-Modified_Puls_selected.PNG  |thumb|none|Left|275 px|''Channel'' dialog]] || '''Define Voume''' &ndash; Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
'''Define Outflow''' &ndash; Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
'''Plot Volume and Outflow Curve''' &ndash; Select to open the ''HEC Plot'' dialog.
|
|} </li>
<li style="display: inline-table;">
{| class="wikitable mw-collapsible mw-collapsed"
|+ Table 2 class="nowrap" | ''Reservoir''
|-
|
! scope="col" | HEC-1 Reservoir Routing Options Dialog
! scope+"col" | Dialog Options
|-
! scope="row" |
| [[Image:HEC-1_Reservoir_Routing_Options.PNG |thumb|none|Left|450 px|''HEC-1 Reservoir Routing Options'' dialog]] ||Outflow Section:
''Known Outflow'' &ndash; Select to define the known outflow.
*''SQ'' &ndash; Select to define the outflow.
**'''Define''' &ndash; Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
*''SE'' &ndash; Select to define the elevation.
**'''Define''' &ndash; Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
**'''Plot SQ-SE''' &ndash; Select to bring up the ''HEC Plot'' Dialog for a representation of the outflow and elevation points.
*''Compute Weir Spillway'' &ndash; Select to allow the capability to compute variables of the weir spillway.
**''SL'' &ndash; Low-Level Outlet.
* ''ELEVL'' &ndash; Center line elevation of downstream end of low-level outlet (measured in feet).
* ''CAREA'' &ndash; Cross-sectional area in square feet (square ''m'') in the low-level outlet orifice equation.
* ''COQL'' &ndash; Discharge coefficient in orifice outlet equation.
* ''EXPL'' &ndash; Exponent of head in orifice equation.
**''SS'' &ndash; Spillway characteristics.
***''CREL'' &ndash; Spillway crest elevation. This value must be less than the highest elevation on the SE card for HEC-1 to run properly.
***''SPWID'' &ndash; Spillway length.
***''COQW'' &ndash; Discharge coefficient in the spillway weir flow equation.
***''EXPW'' &ndash; Exponent of head in the weir spillway flow equation, usually equals 1.5.
**''ST'' &ndash; Dam Overtopping.
***''TOPEL'' &ndash; Elevation of the top of the dam at which overtopping begins (measured in feet).
***''DAMWID'' &ndash; Length of the top-of-dam which is actively being overstepped (measured in feet).
***''COQD'' &ndash; Discharge coefficient in the weir equation.
***''EXPD'' &ndash; Exponent of head in the weir equation.
Volume Section:
''Known Volume'' &ndash; Select to define the known volume.
*''SV'' &ndash; Select to define the volume.
**'''Define''' &ndash; Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
*''SE'' &ndash; Select to define the elevation.
**'''Define''' &ndash; Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
**'''Plot SV-SE''' &ndash; Select to bring up the ''HEC Plot'' Dialog for a visual representation of the volume and elevation points.
''Compute Volume'' &ndash; Select to define the known volume.
*''SA'' &ndash; Select to define the area.
**'''Define''' &ndash; Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
*''SE'' &ndash; Select to define the elevation.
**'''Define''' &ndash; Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
**'''Plot SA-SE''' &ndash; Select to bring up the ''HEC Plot'' Dialog for a visual representation of the area and elevation points.
|
|} </li>
</ul></div>


==Channel Data Dialog==
==Channel Data Dialog==
==Diversion Data Dialog DONE==
[[Image: HEC-1_Diversion_Data.PNG|Thumb|300 px|''HEC-1 Diversion Data'' dialog]]
Accessed by right-clicking on a basin in the graphics window, selecting ''Add'' | '''Diversion''' and selecting '''New Diversion...''' in the ''Defined Diversions'' dialog.
''Name:'' &ndash; Diversion name.
''Maximum Volume:'' &ndash; The maximum volume allowed for the diversion.
''Peak Flow:'' &ndash; Highest flow value reported for the area.
''Outflow Hydrograph Name: (Used on KK record for DT)'' &ndash; Name of the outflow hydrograph.
''Inflow Hydrograph Name: (Used on KK record for DR)'' &ndash; Name of the inflow hydrograph.
'''Define DI''' &ndash; Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]] and define inflow.
'''Define DQ''' &ndash; Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]] and define outflow.
'''Plot DI-DQ''' &ndash; Select to bring up the ''HEC Plot'' dialog and see a visual representation of the inflow and outflow points.
==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'' &ndash; Channel length.
**''S'' &ndash; Channel slope.
**''N'' &ndash; Manning's roughness.
**''Shape'' &ndash; Characteristic channel shape.
***''TRAP'' &ndash; Trapezoid.
***''DEEP'' &ndash; Deep.
***''CIRCULAR'' &ndash; Circular.
**''WD'' &ndash; Base width of the channel.
**''Z'' &ndash; Side slope of channel.
**''Use Cross Section'' &ndash; Select to bring up the '''Define Cross Section''' option in this dialog.
***'''Define Cross Section''' &ndash; Select to bring up the [[WMS:XY Series Editor|''XY Series Editor'' dialog]].
''Second RK/RD record (HMS collector)'' &ndash; Select to enter a second RK/RD record.
*''L'' &ndash; Channel length.
*''S'' &ndash; Channel slope.
*''N'' &ndash; Manning's roughness.
*''Shape'' &ndash; Characteristic channel shape.
**''TRAP'' &ndash; Trapezoid.
**''DEEP'' &ndash; Deep.
**''CIRCULAR'' &ndash; Circular
*''WD'' &ndash; Base width of the channel.
*''Z'' &ndash; Side slope of channel.
''Third RK/RD record (HMS collector)'' &ndash; Select to enter a third RK/RD record.
*''L'' &ndash; Channel length.
*''S'' &ndash; Channel slope.
*''N'' &ndash; Manning's roughness.
*''Shape'' &ndash; Characteristic channel shape.
**''TRAP'' &ndash; Trapezoid.
**''DEEP'' &ndash; Deep.
**''CIRCULAR'' &ndash; Circular.
*''WD'' &ndash; Base width of the channel.
*''Z'' &ndash; Side slope of channel.
''Route upstream hydrographs to main channel'' &ndash; 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 &ndash; 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''' &ndash; Select to bring up the [[WMS:Units Toolbar|''Units'' dialog]].
'''Restore Original Values''' &ndash; 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'' &ndash;
''Instructions / Results (You may have to scroll down)'' &ndash;
''Computational type:'' &ndash;
{| 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" &ndash;
"Tulsa 50% Urban Method" &ndash;
"Tulsa 100% Urban Method" &ndash;
"Espey Rural Method" &ndash;
"Espey No Urbanization Method" &ndash;
"Espey Partly Urban Method" &ndash;
"Espey Completely Urban Method" &ndash;
"Riverside Mountains Method" &ndash;
"Riverside Foothills Method" &ndash;
"Eagleson Method" &ndash;
"USGS Nationwide Urban Method" &ndash;
"Putnam Method" &ndash;
"Taylor Method" &ndash;
"Colorado State University (CSU) Method" &ndash;
"Scs Method" &ndash;
"Custom Method" &ndash;
|-
! scope="row" |
| '''User Defined...''' &ndash; || 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...''' &ndash;||
|
|}
{| 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" &ndash;
"Kirpich Method for overland flow on grassy earth" &ndash;
"Kirpich Method for overland flow on asphalt" &ndash;
"Kirpich Method for overland flow on bare earth (Mountains)" &ndash;
"Kirpich Method for overland flow on grassy earth (Mountains)" &ndash;
"Kirpich Method for overland flow on asphalt (Mountains)" &ndash;
"Ramser Method for channel flow" &ndash;
"Fort Bend County Method" &ndash;
"Kerby Method for overland flow" &ndash;
"ADOT Method (Desert/Mountain)" &ndash;
"ADOT Method (Urban)" &ndash;
|-
! scope="row" |
| '''User Defined...''' &ndash; || 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...''' &ndash;||
|
|}
*''Instructions'' &ndash; 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'' &ndash; The equation being used for calculation.
*'''Parse''' &ndash; Click to parse through the equation.
Variable Abbreviations &ndash; A list of variable abbreviations relating to the equation.
Definitions &ndash; A list of definitions for the variable abbreviations.
''Units'' &ndash; ||The units that apply to the definition chosen.
*"none"
*"ft" &ndash; Feet
*"m" &ndash; Meters
*"km" &ndash; Kilometers
*"mi" &ndash; Mile
*hr" &ndash; Hour
*"min" &ndash; Minute
*"sec" &mdash; Second
*"sq. mi" &ndash; Square mile (mi^2)
*"sq. km" &ndash; Square kilometer (km^2)
*"sq. ft" &ndash; Square foot (ft^2)
*"acre" &ndash;
*"hect" &ndash;
*"in" &ndash; Inch
*"mm" &ndash; Millimeter
*"ft/mi" &ndash; Foot per mile
*"fract" &ndash;
''Method:'' &ndash;
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'' &ndash; Select to allow the definition of variables associated with Upstream and Routed Hydrographs.
''Compute for all outlets'' &ndash; Select to compute for all outlets.
*''Turn on Muskingum routing'' &ndash; Select to apply Muskingum routing.
''Upstream Hydrograph'' &ndash; Select to choose an Upstream Hydrograph.
''Estimated AMSKK'' &ndash; Select to find the estimated Muskingum ''k'' coefficient in hours for entire reach.
''For Channel Velocity Estimate'' &ndash; Select to find the estimate for the channel velocity.
''Compute for currently selected outlet'' &ndash; Select to compute the outlet that has been chosen.
''Compute for all outlets'' &ndash; Select to compute for all outlets.
*''Turn on Muskingum routing'' &ndash; Select to apply Muskingum routing.
''Channel Velocity Estimate:'' &ndash; An estimation of the channel velocity measured in feet per second.
=='''Define Reservoir Data''' &ndash; Select to open ''Define Reservoir Data'' dialog.==
=='''Define Reservoir Data''' &ndash; Select to open ''Define Reservoir Data'' dialog.==


Line 726: 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