home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / GENERAL / ALLWET.ZIP / CHAP3.SML < prev    next >
Text File  |  1987-05-13  |  13KB  |  600 lines

  1.                         3.  DATA PREPARATION FOR ALLWET
  2.  
  3.  
  4.  
  5. 3.1  Introduction
  6.  
  7.  
  8.      The input  data for ALLWET must  initially be prepared and placed on a
  9.  
  10. file.  Items on each  line of the file need not be in specific  columns, but
  11.  
  12. merely be  separated by one  or more spaces.  This  file may then be accessed
  13.  
  14. when using ALLWET in either interactive or batch mode.  This section describes
  15.  
  16. the preparation of such a file.  For the sample system, figure 4 displays
  17.  
  18. the file for the sample problem.
  19.  
  20.  
  21.      The input file for ALLWET includes a preliminary subfile, a node subfile,
  22.  
  23. and a pipe subfile (in that order); and subfiles as needed to designate reser-
  24.  
  25. voirs, booster pumps, pressure reducing valves and check valves.  These last
  26.  
  27. three may appear in any order.
  28.  
  29.  
  30.      THE INPUT DATA SHOULD BE PREPARED IN UPPER CASE!!
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                   3-1
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                   ALLWET
  69.                   SAMPLE PROBLEM FOR ALLWET USERS MANUAL
  70.                   HAZEN
  71.                   215111
  72.                   EPSILON  .001
  73.                   MULT 2 1.3 0.9 1.0 1.0
  74.                   NODES 9
  75.                   1   T-1  400    0    0    0    0  1000 3000
  76.                   1   T-2  375    0    0    0    0  4000  500
  77.                   3     1  385    0   50   50    0  1500 3000
  78.                   3     2  450  100   15    0    0  4000 3000
  79.                   2     3  350   75   25    0    0   500  500
  80.                   2     4  475    0    0    0   60  4000 3500
  81.                   1    AA  410  100   50    0    0  1000  500
  82.                   1    BB  410  175    0    0    0  1500  500
  83.                   1    CC  415  125    0  125    0  2750 1750
  84.                   PRESSURE 30
  85.                   PIPES 11
  86.                    1  T-1   1  10  100  500
  87.                    2  T-1  AA  10  100    0
  88.                    3    1   2  10  100    0
  89.                    4    4  CC   8  100 1964  3
  90.                    1978 2904 2384 2634 2655 2228
  91.                    5    1  BB  10  100 2500
  92.                    6    2 T-2  10  100 2500
  93.                    7  T-2  BB  10  100 2500
  94.                    8   BB  CC   8  100 1964  3
  95.                    1978  596 2384  866 2655 1272
  96.                    9   BB  AA  10  100  500
  97.                   10   AA   3   8  100  500
  98.                   11    3   4   6  100  500
  99.                   RESERVOIR  T-1  475  .3
  100.                   RESERVOIR  T-2  400  .7   5  1
  101.                     145  135  120  100   75
  102.                     200  600 1000 1400 1800
  103.                   BOOSTER  11  5
  104.                     60  55  45  30  10
  105.                      0  40  80 120 160
  106.                   PRV  10  30  2
  107.  
  108.  
  109.         Figure 4   Input File for Sample Problem
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.                                   3-2
  123.  
  124. 3.2  Preliminary Subfile
  125.  
  126.  
  127.      The first line of the preliminary subfile must contain the word ALLWET.
  128.  
  129.  
  130.      The second line of the preliminary subfile must contain a title (up to 79
  131.  
  132. characters) for the data set.  ALLWET prints the title as the data is read,
  133.  
  134. before every analysis during interactive use, and on all printed output.
  135.  
  136.  
  137.      The third line must have either HAZEN or MANNING starting in the first
  138.  
  139. column, to indicate the use of either the Hazen-Williams or Manning flow
  140.  
  141. equation.
  142.  
  143.  
  144.      The units to be used are designated by the digits in the first seven
  145.  
  146. columns of the fourth line:
  147.  
  148.      (i)  Pipe length and coordinate system (if used),
  149.  
  150.           1.  thousands of feet      2.  feet         3.  meters
  151.  
  152.      (ii)  Pipe diameter
  153.  
  154.           1. inches      2. feet     3. centimeters     4. meters
  155.  
  156.      (iii)  Flow
  157.  
  158.           1.  Imp. mgd     2.  U.S. mgd     3.  cfs
  159.           4.  Imp gpm      5.  U.S. gpm     6.  liters/sec
  160.  
  161.       (iv)  Hydraulic grade line (head)
  162.  
  163.            1.  feet                         2.  centimeters
  164.  
  165.       (v)  Elevation
  166.  
  167.            1.  feet                         2.  meters
  168.  
  169.       (vi)  Pressure
  170.  
  171.            1.  psi                          2.  grams/cm2
  172.  
  173.       (vii)  Flow velocity
  174.  
  175.            1.  ft/sec                       2.  meters/sec
  176.  
  177.  
  178.       An optional EPSILON line may come next, having the word EPSILON followed
  179.  
  180.                                   3-3
  181.  
  182.  
  183. a number. This specifies the accuracy to which pipe flows will be calculated,
  184.  
  185. and should be set to one tenth the maximum tolerable error.  If no EPSILON line
  186.  
  187. is included, ALLWET assumes a value depending upon the units of pipe flow: .00001
  188.  
  189. for Imp mgd, U.S. mgd or cfs; .01 for Imp or U.S. gpm; and .0001 for
  190.  
  191. liters/second.  These default values are usually adequate.
  192.  
  193.  
  194.       Before any analysis, ALLWET multiplies all positive nodal demands by a
  195.  
  196. number designated as PERC.  ALLWET assumes this number equals 1.0 unless a
  197.  
  198. line with PERC followed by a corresponding value appears at this point in the
  199.  
  200. file.  Section 2.1 explains the use of PERC.
  201.  
  202.  
  203.       This next line is necessary only if the coordinate system used has a
  204.  
  205. negatively oriented horizontal or vertical axis.  This line contains the word
  206.  
  207. AXES followed by two numbers.  The first is +1 (-1) if the horizontal axis is
  208.  
  209. positively (negatively) oriented.  The second number provides the same
  210.  
  211. information for the vertical axis.
  212.  
  213.  
  214.      All multiplicative factors are assumed equal 1.0 unless changed by MULT
  215.  
  216. lines, each containing six items
  217.  
  218.      (a)  MULT
  219.  
  220.      (b)  Node classification (integer from 1 to 10) for which multiplicative
  221.           factors are to be specified
  222.  
  223.      (c)  Multiplicative factors for demands A, B, C, and D for this node
  224.           classification (four numeric values)
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.                                   3-4
  241.      
  242.  
  243. 3.3  Node Subfile
  244.  
  245.  
  246.      The first line of the node subfile has NODES in the first five columns,
  247.  
  248. followed optionally by the number of nodes.  This number, if indicated is used
  249.  
  250. only as a consistency check.
  251.  
  252.  
  253.      Each node in the system is then described by one or two lines, the first
  254.  
  255. of which has the following information
  256.  
  257.      (a) Node classification (integer from 1 to 10)
  258.  
  259.      (b) Node name (alphanumeric characters, no spaces and no punctuation
  260.          marks, except possibly one hyphen)
  261.  
  262.      (c) Elevation of node (in units indicated by the fifth column of the
  263.          units line from the preliminary subdeck)
  264.  
  265.      (d) Demand values A, B, C, and D (in indicated units of flow).  Any
  266.          values not given are assumed zero.  However, all four values must
  267.          be specified if coordinate values (items e and f) are given
  268.  
  269.      (e) Horizontal coordinate (in units indicated on the first column of the
  270.          units line)
  271.  
  272.      (f) Vertical coordinate
  273.  
  274.  
  275.      If the node classification is omitted, the node classification of the
  276.  
  277. previous node is used.  If not given, the node classification for the first
  278.  
  279. node is assumed 1. WARNING: Node classification is required when the node name
  280.  
  281. is an integer between 1 and 10. If you do not heed this, ALLWET reads the node
  282.  
  283. name as a node classification.
  284.  
  285.  
  286.  
  287.      The coordinate values should not be given or entered as zero when no
  288.  
  289. coordinate system is used.
  290.  
  291.  
  292.  
  293.      The second line is included only if the node has a pressure
  294.  
  295. setting:
  296.  
  297.      (a) The word PRESSURE
  298.  
  299.      (b) Value of pressure setting
  300.      
  301.                                  3-5
  302.  
  303.  
  304.  
  305.      During flow-pressure calculations, only one of the following four
  306.  
  307. constraints may be in effect at each node: the flow, the pressure, the head
  308.  
  309. (i.e., a type 1 reservoir), or the head-flow relationship (i.e. a type 2
  310.  
  311. reservoir).  Thus, during an analysis, the demand values for any node having a
  312.  
  313. fixed pressure or reservoir (cf. Section 2.3) are disregarded.
  314.  
  315.  
  316.  
  317.  
  318.  
  319. 3.4  Pipe Subfile
  320.  
  321.  
  322.      The first line of the pipe subfile contains the word PIPES in the first
  323.  
  324. five columns followed optionally by the number of pipes for which data will
  325.  
  326. follow.
  327.  
  328.  
  329.      Each pipe is described by one or two lines.  The first line, required for
  330.  
  331. every pipe contains:
  332.  
  333.      (a) Identifying number for pipe
  334.  
  335.      (b) Name of "from" node.  This must be an existing node.
  336.  
  337.      (c) Name  of  "to" node.   This must be  an  existing  node,
  338.          distinct from the "from" node.
  339.  
  340.      (d) Diameter of pipe (in proper units)
  341.  
  342.      (e) Hazen-Williams or Manning roughness factor
  343.  
  344.      (f) Length of pipe (in proper units)
  345.  
  346.      (g) Number of pseudonodes (1, 2, or 3; leave blank if zero)
  347.  
  348.  
  349.      The number of pseudonodes may be indicated only if a coordinate system is
  350.  
  351. being used.  The second line for a pipe, which is used only if there are
  352.  
  353. pseudonodes, has the following:
  354.  
  355.      (a) Horizontal, then vertical coordinate of pseudonode closest
  356.          to "from" node
  357.  
  358.      (b) Horizontal,  then vertical coordinate or pseudonode next
  359.          closest to "from" node
  360.  
  361.                                  3-6
  362.  
  363.  
  364.      (c) Horizontal,  then  vertical  coordinate  of  pseudonode
  365.          closest to "to" node
  366.  
  367.  
  368.      If a coordinate system is used, the length may be entered as zero.  In
  369.  
  370. this case the length will be calculated as the sum of the lengths of the line
  371.  
  372. segments connecting the "from" node, the successive pseudonodes (if any) and
  373.  
  374. the "to" node.  Such a calculation is only an approximation and does not
  375.  
  376. consider changes in elevation. The length must be specified if no coordinate
  377.  
  378. system is used.
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.                                   3-7
  421.  
  422.  
  423. 3.5  Reservoir Subfile
  424.  
  425.  
  426.      Each reservoir requires one or more lines.  The data for the first
  427.  
  428. follows:
  429.  
  430.      (a) The letters RESE
  431.  
  432.      (b) Node at which reservoir is located
  433.  
  434.      (c) Gradient constant (in units of head, not units of elevation if the
  435.          two are different--cf. discussion of reservoirs in Section 2.3)
  436.  
  437.      (d) Fraction of all in flow from reservoirs estimated to come from
  438.          this reservoir (cf. discussion of reservoirs in section 2.3)
  439.  
  440.      (e) Number of points on H-Q curve for this reservoir (maximum of 30).
  441.          Must be specified only for type 2 reservoirs, and must be omitted
  442.          or specified as zero for type 1 reservoirs.
  443.  
  444.      (f) Number of pumps in parallel, each having given pump curve.
  445.          Necessary only for type 2 reservoirs.  Assumed 1 if omitted
  446.          for type 1 reservoirs.
  447.  
  448.  
  449.      Type 2 reservoirs need additional lines to denote the points along the
  450.  
  451. H-Q curve.  The H values are given in decreasing order along the curve (cf.
  452.  
  453. Figure 2).  As many lines as needed may be used.  The units of head must be
  454.  
  455. used for these values.  Starting on a new line the corresponding Q values, in
  456.  
  457. increasing order, are then given.  The units of flow must be used for these.
  458.  
  459.  
  460.      In performing an analysis, ALLWET treats nodes with set pressures as type
  461.  
  462. 1 reservoirs.  The sum of the number of reservoirs and the number of nodes
  463.  
  464. where the pressure is set may not exceed 25, a more than adequate number.
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.                                  3-8
  481.  
  482.  
  483.  
  484. 3.6  Booster Pump Station Subfile
  485.  
  486.  
  487.      Each booster pump station requires three or more lines.  The first of
  488.  
  489. these has:
  490.  
  491.      (a) The word BOOSTER
  492.  
  493.      (b) Number of the pipe where the booster pump station is located
  494.  
  495.      (c) Number of points on H-Q curve (maximum of 30)
  496.  
  497.      (d) Number of pumps in parallel, each having given pump curve.
  498.          If no value given, 1 assumed.
  499.  
  500.  
  501.     The remaining lines describe the pump curve, in the same manner as de-
  502.  
  503. scribed for reservoirs.  No more than 25 booster pump stations may be in the
  504.  
  505. system.  This should not restrict applicability of ALLWET.
  506.  
  507.  
  508.  
  509.  
  510. 3.7  Pressure Reducing Valve (PRV) Subfile
  511.  
  512.  
  513.      Each pressure reducing valve requires one line with the
  514.  
  515. following:
  516.  
  517.      (a) The letters PRV
  518.  
  519.      (b) Pipe number of the PRV
  520.  
  521.      (c) Limiting pressure to be maintained by PRV at  downstream
  522.          node of pipe
  523.  
  524.      (d) Number  of  velocity  heads lost through  PRV  when it is  not
  525.          operating
  526.  
  527.      (e) Associated reservoir for PRV (cf.  description of PRVs in
  528.          previous chapter).  If left blank, ALLWET makes an arbitrary
  529.          (and not necessary good) selection.
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.                                   3-9
  540.  
  541.  
  542. 3.8  Check Valve Subfile
  543.  
  544.  
  545.      Each  check  valve line designates pipes where check  valves
  546.  
  547. are located:
  548.  
  549.      (a) The word CHECK
  550.  
  551.      (b) Pipe numbers for check valves (as many as will fit on the line).
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.                                  3-10
  599.   
  600.