Skip to content

Commit

Permalink
User manual edits
Browse files Browse the repository at this point in the history
Minor grammatical edits to user manual based upon technical editor feedback
  • Loading branch information
terrahaxton committed Jun 13, 2023
1 parent 004bfd9 commit 94b0e87
Show file tree
Hide file tree
Showing 12 changed files with 46 additions and 46 deletions.
6 changes: 3 additions & 3 deletions documentation/advancedsim.rst
Original file line number Diff line number Diff line change
Expand Up @@ -208,13 +208,13 @@ The SciPy method ``sparse.linalg.spsolve`` can be used to solve the system of eq
:math:`b` is the residual of the model, and
:math:`x` is the solution to the system of equations.

* Get the variables values. This returns the values for :math:`u` and :math:`v`, which were both initialized to be 1.
* Get the variables' values. This returns the values for :math:`u` and :math:`v`, which were both initialized to be 1.

* Solve the system of equations and return the solution.

* Add the solution back to the variables values.
* Add the solution back to the variables' values.

* Load the variable values back into the model.
* Load the variables' values back into the model.

* Evaluate the residuals of the model. If the maximum absolute value of the residuals is too high, the solve can be repeated.

Expand Down
4 changes: 2 additions & 2 deletions documentation/disaster_models.rst
Original file line number Diff line number Diff line change
Expand Up @@ -153,7 +153,7 @@ and check valves next to reservoirs.
.. note::
The power outage is added to the WaterNetworkModel as a Rule.
If the WaterNetworkModel includes Controls that impact pumps,
it is recommended that those Controls are converted to Rules using
it is recommended that those Controls are converted to Rules
to ensure that the power outage is evaluated in a consistent manner.
The method :class:`~wntr.network.model.WaterNetworkModel.convert_controls_to_rules`
converts all Controls to Rules, with an option input argument to set priority.
Expand Down Expand Up @@ -182,7 +182,7 @@ The following example adds fire flow conditions at a specific node.

Environmental change
---------------------
Environmental change is a long term problem for water distribution
Environmental change is a long-term problem for water distribution
systems. Changes in the environment could lead to
reduced water availability,
damage from weather incidents,
Expand Down
6 changes: 3 additions & 3 deletions documentation/framework.rst
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ run simulations are described in more detail below, followed by a list of softwa
:class:`~wntr.morph` Contains methods to modify water network model morphology, including network skeletonization, modifying node coordinates, and splitting or breaking pipes.
:class:`~wntr.gis` Contains geospatial capabilities, including a function to convert the water network model to GeoDataFrames.
:class:`~wntr.graphics` Contains functions to generate graphics.
:class:`~wntr.epanet` Contains EPANET 2.00.12 and and EPANET 2.2.0 compatibility class and methods for WNTR.
:class:`~wntr.epanet` Contains EPANET 2.00.12 and EPANET 2.2.0 compatibility class and methods for WNTR.
:class:`~wntr.utils` Contains helper functions.
================================================= =============================================================================================================================================================================================================================================================================

Expand Down Expand Up @@ -106,7 +106,7 @@ Current WNTR limitations include:
* Use of the "MAP" file option in EPANET will **not** automatically assign node
coordinates from that file.

**WNTR reads in and writes all sections of EPANET INP files**. This includes the following sections:
**WNTR reads and writes all sections of EPANET INP files**. This includes the following sections:
[BACKDROP],
[CONTROLS],
[COORDINATES],
Expand Down Expand Up @@ -156,7 +156,7 @@ Known discrepancies between the WNTRSimulator and EpanetSimulator are listed bel

* **Tank draining**: The EpanetSimulator (and EPANET) continue to supply water from tanks after they reach their
minimum elevation. This can result in incorrect system pressures.
See issues https://github.com/USEPA/WNTR/issues/210 and https://github.com/OpenWaterAnalytics/EPANET/issues/623.
See issues at the following sites: https://github.com/USEPA/WNTR/issues/210 and https://github.com/OpenWaterAnalytics/EPANET/issues/623.
The EPANET dll in WNTR will be updated when an EPANET release is available.
* **Pump controls and patterns**: Pumps have speed settings which are adjustable
by controls and/or patterns. With the EpanetSimulator,
Expand Down
14 changes: 7 additions & 7 deletions documentation/getting_started.rst
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ This example demonstrates how to:

.. note::
If WNTR is installed using PyPI or Anaconda, the examples folder is not included.
The examples folder can be downloaded by going to https://github.com/USEPA/WNTR, select the "Clone or download" button and then select "Download ZIP."
The examples folder can be downloaded by going to https://github.com/USEPA/WNTR, selecting the "Clone or download" button, and then selecting "Download ZIP."
Uncompress the zip file using standard software tools (e.g., unzip, WinZip) and store them in a folder.
The following example assumes the user is running the example from the examples folder.

Expand Down Expand Up @@ -70,14 +70,14 @@ A Jupyter Notebook, an open-sourced web-based application, can be accessed throu
associated software available at https://jupyter.org. These demonstrations include the following:

* `Pipe break demo <https://github.com/USEPA/WNTR/blob/main/examples/demos/pipe_break_demo.ipynb>`_:
This demostration runs multiple hydraulic simulations to compute the impact that different individual pipe breaks/closures have on network pressure.
It also plots the pressure and population impacts for all junctions effected by the pipe breaks/closures.
This demonstration runs multiple hydraulic simulations to compute the impact that different individual pipe breaks/closures have on network pressure.
It also plots the pressure and population impacts for all junctions affected by the pipe breaks/closures.
* `Segment pipe break demo <https://github.com/USEPA/WNTR/blob/main/examples/demos/segment_break_demo.ipynb>`_:
This demostration runs multiple hydraulic simulations to compute the impact that different pipe segment breaks/closures (identified by isolation
valve locations) have on network pressure. It also plots the pressure and population impacts for all junctions effected by the pipe segment breaks/closures.
This demonstration runs multiple hydraulic simulations to compute the impact that different pipe segment breaks/closures (identified by isolation
valve locations) have on network pressure. It also plots the pressure and population impacts for all junctions affected by the pipe segment breaks/closures.
* `Fire flow demo <https://github.com/USEPA/WNTR/blob/main/examples/demos/fire_flow_demo.ipynb>`_:
This demostration runs multiple hydraulic simulations with and without fire fighting flow demand to multiple fire hydrant nodes.
It also plots the pressure and population impacts for junctions effected by the additional fire fighting flow demand.
This demonstration runs multiple hydraulic simulations with and without fire fighting flow demand to multiple fire hydrant nodes.
It also plots the pressure and population impacts for junctions affected by the additional fire fighting flow demand.
* `Earthquake demo <https://github.com/USEPA/WNTR/blob/main/examples/demos/earthquake_demo.ipynb>`_:
This demostration runs hydraulic simulations of earthquake damage with and without repair efforts. It plots fragility curves,
peak ground acceleration, peak ground velocity, repair rate, leak probability, and damage states. In addition, it compares
Expand Down
14 changes: 7 additions & 7 deletions documentation/gis.rst
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ The following section describes capabilities in WTNR that use GeoPandas GeoDataF

.. note::
Functions that use GeoDataFrames require the Python package **geopandas** [JVFM21]_
and **rtree** [rtree]_, both are optional dependencies of WNTR.
and **rtree** [rtree]_. Both are optional dependencies of WNTR.
Note that **shapely** is installed with geopandas.

The following examples use a water network generated from Net1.inp.
Expand Down Expand Up @@ -101,7 +101,7 @@ Individual GeoDataFrames are obtained as follows (Note that the example network,
>>> wn_gis.pumps # doctest: +SKIP
>>> wn_gis.valves # doctest: +SKIP

For example, the junctions GeoDataFrame contains the following information
For example, the junctions GeoDataFrame contains the following information:

.. doctest::
:skipif: gpd is None
Expand Down Expand Up @@ -264,7 +264,7 @@ Several important points on CRS are listed below.
* Projected CRSs are preferred for more accurate distance calculations.

The following example reads a GeoJSON file and overrides the CRS to change it from EPSG:4326 to EPSG:3857.
(Note, this does not change the coordinates in the geometry column).
(Note, this does not change the coordinates in the geometry column.)

.. doctest::
:skipif: gpd is None
Expand Down Expand Up @@ -294,8 +294,8 @@ The following example reads a GeoJSON file and overrides the CRS to change it fr

>>> hydrant_data = gpd.read_file(examples_dir+'/data/Net1_hydrant_data.geojson')

The following example reads a GeoJSON file and transforms the CRS to EPSG:3857
(Note, this transforms the coordinates in the geometry column).
The following example reads a GeoJSON file and transforms the CRS to EPSG:3857.
(Note, this transforms the coordinates in the geometry column.)

.. doctest::
:skipif: gpd is None
Expand Down Expand Up @@ -372,7 +372,7 @@ Snap hydrants to junctions

GIS data which include the network hydrant locations is useful in a resilience analysis. In particular,
this information identifies which junctions could have their demands increased to simulate the opening
of hydrants to fight fires or flush contaminated water out of the network either of which could caused by a disaster scenario.
of hydrants to fight fires or flush contaminated water out of the network, either of which could caused by a disaster scenario.
The following example highlights the process to snap hydrants to junctions. The example dataset of hydrant
locations is a GeoDataFrame with a `geometry` column that contains ``shapely.geometry.Point`` geometries and a
`demand` column that defines fire flow requirements.
Expand Down Expand Up @@ -631,7 +631,7 @@ the order in which the geometries intersect, as shown below:
Assign landslide probability to pipes
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Landslide hazard zones GIS data can be used to identify pipes with the potential to be effected during a landslide.
Landslide hazard zones GIS data can be used to identify pipes with the potential to be affected during a landslide.
The following example highlights the process to assign landslide probabilities to pipes. The landslide hazard zones example dataset
is a GeoDataFrame with a `geometry` column that contains ``shapely.geometry.LineString`` geometries and a
`Pr` column which contains the probability of damage from a landslide in that zone.
Expand Down
12 changes: 6 additions & 6 deletions documentation/hydraulics.rst
Original file line number Diff line number Diff line change
Expand Up @@ -278,8 +278,8 @@ in the following example.
EPANET specifications.

When using the WNTRSimulator, the required pressure, minimum pressure, and pressure exponent can vary throughout the network.
By default, each junction's required pressure, minimum pressure, and pressure exponent is set to None and the global value
in the hydraulic options are used to define the PDD constraint for that junction.
By default, each junction's required pressure, minimum pressure, and pressure exponent is set to None and the global value is used
in the hydraulic options to define the PDD constraint for that junction.
If the user defines required pressure, minimum pressure, or pressure exponent on a junction,
those values will override the required pressure, minimum pressure, and pressure exponent defined in the global hydraulic options
when defining the PDD constraint for that junction.
Expand All @@ -295,7 +295,7 @@ junction 121.

The ability to use spatially variable required pressure, minimum pressure, and pressure
exponent is only available when using the WNTRSimulator.
The EpanetSimulator always uses values in the global hydraulic options.
The EpanetSimulator always uses the global values in the hydraulic options.

.. _leak_model:

Expand Down Expand Up @@ -358,13 +358,13 @@ The following example adds a leak to the water network model.
Pause and restart
------------------

The WNTRSimulator includes the ability to
The WNTRSimulator includes the ability to:

* Reset initial values and re-simulate using the same water network model. Initial values include simulation time, tank head, reservoir head, pipe status, pump status, and valve status.

* Pause a hydraulic simulation, change network operations, and then restart the simulation
* Pause a hydraulic simulation, change network operations, and then restart the simulation.

* Save the water network model and results to files and reload for future analysis
* Save the water network model and results to files and reload for future analysis.

These features are helpful when evaluating various response action plans or when
simulating long periods of time where the time resolution might vary.
Expand Down
2 changes: 1 addition & 1 deletion documentation/installation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -199,7 +199,7 @@ and building the documentation.

.. note::
WNTR includes C++ code that is built into shared object files (e.g., pyd for Windows)
during the setup process. This requires that the developer has a C++ compiler on their path.
during the setup process. This requires that the developer has a C++ compiler located in a folder specified in their PATH.
When installing WNTR through PyPI or conda, the shared object files do not need to be built
and no compiler is needed.

Expand Down
2 changes: 1 addition & 1 deletion documentation/morph.rst
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Network skeletonization in WNTR follows the procedure outlined in [WCSG03]_.
The skeletonization process retains all tanks, reservoirs, valves, and pumps, along with all junctions and pipes that are associated with controls.
Junction demands and demand patterns are retained in the skeletonized model, as described below.
Merged pipes are assigned equivalent properties for diameter, length, and roughness to approximate the updated system behavior.
Pipes that fall below a user defined pipe diameter threshold are candidates for removal based on three operations, including:
Pipes that fall below a user-defined pipe diameter threshold are candidates for removal based on three operations, including:

1. **Branch trimming**: Dead-end pipes that are below the pipe diameter threshold are removed from the model (:numref:`fig-branch-trim`).
The demand and demand pattern assigned to the dead-end junction is moved to the junction that is retained in the model.
Expand Down
12 changes: 6 additions & 6 deletions documentation/reference.rst
Original file line number Diff line number Diff line change
Expand Up @@ -16,15 +16,15 @@ References
.. [BaRR13] Barker, K., Ramirez-Marquez, J.E., and Rocco, C.M. (2013). Resilience-based network component importance measures. Reliability Engineering and System Safety, 117, 89-97.
.. [Bieni19] Bieniek, T., van Andel, B., and Bø, T.I. (2019). Bidirectional UTM-WGS84 converter for python, Retrieved on February 5, 2019 from https://github.com/Turbo87/utm
.. [Bieni19] Bieniek, T., van Andel, B., and Bø, T.I. (2019). Bidirectional UTM-WGS84 converter for python, Retrieved on February 5, 2019 from https://github.com/Turbo87/utm.
.. [CrLo02] Crowl, D.A., and Louvar, J.F. (2011). Chemical Process Safety: Fundamentals with Applications, 3 edition. Upper Saddle River, NJ: Prentice Hall, 720p.
.. [ELLT12] Eto, J.H., LaCommare, K.H., Larsen, P.H., Todd, A., and Fisher, E. (2012). An Examination of Temporal Trends in Electricity Reliability Based on Reports from U.S. Electric Utilities. Lawrence Berkeley National Laboratory Report Number LBNL-5268E. Berkeley, CA: Ernest Orlando Lawrence Berkeley National Laboratory, 68p
.. [ELLT12] Eto, J.H., LaCommare, K.H., Larsen, P.H., Todd, A., and Fisher, E. (2012). An Examination of Temporal Trends in Electricity Reliability Based on Reports from U.S. Electric Utilities. Lawrence Berkeley National Laboratory Report Number LBNL-5268E. Berkeley, CA: Ernest Orlando Lawrence Berkeley National Laboratory, 68p.
.. [JVFM21] Jordahl, K., Van den Bossche, J., Fleischmann, M, McBride, J. and others (2021) geopandas, 10.5281/zenodo.5573592
.. [JVFM21] Jordahl, K., Van den Bossche, J., Fleischmann, M, McBride, J. and others (2021) geopandas, 10.5281/zenodo.5573592.
.. [Folium] python-visualization/folium. (n.d.). Retrieved on February 5, 2019 from https://github.com/python-visualization/folium
.. [Folium] python-visualization/folium. (n.d.). Retrieved on February 5, 2019 from https://github.com/python-visualization/folium.
.. [GaCl18] Gazoni, E. and Clark, C. (2018) openpyxl - A Python library to read/write Excel 2010 xlsx/xlsm files, Retrieved on May 4, 2018 from https://openpyxl.readthedocs.io.
Expand All @@ -50,7 +50,7 @@ References
.. [Ross00] Rossman, L.A. (2000). EPANET 2 Users Manual. Cincinnati, OH: U.S. Environmental Protection Agency. U.S. Environmental Protection Agency Technical Report, EPA/600/R--00/057, 200p.
.. [rtree] Toblerity/rtree. (n.d.). Retrieved on March 17, 2022 from https://github.com/Toblerity/rtree
.. [rtree] Toblerity/rtree. (n.d.). Retrieved on March 17, 2022 from https://github.com/Toblerity/rtree.
.. [RWTS20] Rossman, L., Woo, H., Tryby M., Shang, F., Janke, R., and Haxton, T. (2020) EPANET 2.2 User Manual. U.S. Environmental Protection Agency, Washington, DC, EPA/600/R-20/133.
Expand All @@ -70,7 +70,7 @@ References
.. [WaWC06] Walski, T., Weiler, J. Culver, T. (2006). Using Criticality Analysis to Identify Impact of Valve Location. Water Distribution Systems Analysis Symposium. Cincinnati, OH, American Society of Civil Engineers: 1-9.
.. [WWQP06] Wald, D.J., Worden, B.C., Quitoriano, V., and Pankow, K.L. (2006). ShakeMap manual: Technical manual, user's guide, and software guide. United States Geologic Survey, Retrieved on April 25, 2017 from http://pubs.usgs.gov/tm/2005/12A01/
.. [WWQP06] Wald, D.J., Worden, B.C., Quitoriano, V., and Pankow, K.L. (2006). ShakeMap manual: Technical manual, user's guide, and software guide. United States Geologic Survey, Retrieved on April 25, 2017 from http://pubs.usgs.gov/tm/2005/12A01/.
.. [WCSG03] Walski, T.M., Chase, D.V., Savic, D.A., Grayman, W., Beckwith, S. (2003). Advanced Water Distribution Modeling and Management. HAESTAD Press, Waterbury, CT, 693p.
Expand Down
Loading

0 comments on commit 94b0e87

Please sign in to comment.