404
+ +Page not found
+ + +'+ escapeHtml(title) + '
' + escapeHtml(summary) +'
+
+
+
+
+
+
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/installation.html b/installation.html
new file mode 100644
index 00000000..385ec394
--- /dev/null
+++ b/installation.html
@@ -0,0 +1,262 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Installation¶
+Important! : The following installation steps are written based on a Windows environment. When using other systems (which should be possible) it might be required to use different commands. However, the fundamental of the installation steps should remain the same. This meaning, no additional packages or libraries should be required. If problems would arose during your installation, please contact the maintainers of the tool.
+For users¶
+When you only require the koswat package to be used as a whole, and not for developments, we advise to directly use the latest greatest release, or directly the latest available version from Master as follows:
-
+
-
+
Latest available
Master: ++pip install git+https://github.com/Deltares/Koswat.git +
+ -
+
Specific Koswat version, add
@version-tagto the previous command, for instance install tagv0.11.0(MVP pre-release): ++| You can also do the above with a commit-hash for development branches (e.g.:pip install git+https://github.com/Deltares/Koswat.git@v0.11.0 +@0504c06) +
+ -
+
Using docker (requires checking the repository in a directory): +
+cd <your koswat checked out directory> +docker build -t koswat:latest -f Dockerimage . +docker run -it koswat bash +
+
For developers¶
+-
+
-
+
Checkout the code from github in a directory of your choice. You can either do this by downloading the source zip or (better) using git, for instance: +
+ | Note, the above steps are based on a Windows setup. If you are not familiar with Git we recommend using the GitHub desktop tool. +cd C:\repos +git clone https://github.com/Deltares/Koswat.git koswat +
+ -
+
Navigate to your Koswat repository and then install the koswat package with your preferred step:
+-
+
- With Miniforge (our recommendation):
+cd C:\repos\koswat +conda env create -f .config\environment.yml +conda activate koswat_env +poetry install +
+ - With
pypi: ++ | Note, this will not installcd C:\repos\koswat +pip install . +Poetry, which is required to properly maintain the interdependencies ofKoswattool.
+
+ - With Miniforge (our recommendation):
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/js/html5shiv.min.js b/js/html5shiv.min.js
new file mode 100644
index 00000000..1a01c94b
--- /dev/null
+++ b/js/html5shiv.min.js
@@ -0,0 +1,4 @@
+/**
+* @preserve HTML5 Shiv 3.7.3 | @afarkas @jdalton @jon_neal @rem | MIT/GPL2 Licensed
+*/
+!function(a,b){function c(a,b){var c=a.createElement("p"),d=a.getElementsByTagName("head")[0]||a.documentElement;return c.innerHTML="x",d.insertBefore(c.lastChild,d.firstChild)}function d(){var a=t.elements;return"string"==typeof a?a.split(" "):a}function e(a,b){var c=t.elements;"string"!=typeof c&&(c=c.join(" ")),"string"!=typeof a&&(a=a.join(" ")),t.elements=c+" "+a,j(b)}function f(a){var b=s[a[q]];return b||(b={},r++,a[q]=r,s[r]=b),b}function g(a,c,d){if(c||(c=b),l)return c.createElement(a);d||(d=f(c));var e;return e=d.cache[a]?d.cache[a].cloneNode():p.test(a)?(d.cache[a]=d.createElem(a)).cloneNode():d.createElem(a),!e.canHaveChildren||o.test(a)||e.tagUrn?e:d.frag.appendChild(e)}function h(a,c){if(a||(a=b),l)return a.createDocumentFragment();c=c||f(a);for(var e=c.frag.cloneNode(),g=0,h=d(),i=h.length;i>g;g++)e.createElement(h[g]);return e}function i(a,b){b.cache||(b.cache={},b.createElem=a.createElement,b.createFrag=a.createDocumentFragment,b.frag=b.createFrag()),a.createElement=function(c){return t.shivMethods?g(c,a,b):b.createElem(c)},a.createDocumentFragment=Function("h,f","return function(){var n=f.cloneNode(),c=n.createElement;h.shivMethods&&("+d().join().replace(/[\w\-:]+/g,function(a){return b.createElem(a),b.frag.createElement(a),'c("'+a+'")'})+");return n}")(t,b.frag)}function j(a){a||(a=b);var d=f(a);return!t.shivCSS||k||d.hasCSS||(d.hasCSS=!!c(a,"article,aside,dialog,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}mark{background:#FF0;color:#000}template{display:none}")),l||i(a,d),a}var k,l,m="3.7.3",n=a.html5||{},o=/^<|^(?:button|map|select|textarea|object|iframe|option|optgroup)$/i,p=/^(?:a|b|code|div|fieldset|h1|h2|h3|h4|h5|h6|i|label|li|ol|p|q|span|strong|style|table|tbody|td|th|tr|ul)$/i,q="_html5shiv",r=0,s={};!function(){try{var a=b.createElement("a");a.innerHTML="
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Koswat design¶
+In general, the architecture of this package is based on the following principles:
+-
+
- Single responsibility principle, component hierarchy. +
- Open-closed principle, inheritance. +
- Interface segregation principle, protocols. +
Component-module hierarchy¶
+We cluster entities into modules (components) that represent their domain and have minimal dependencies with others components, this way the modules can be accessed when operating Koswat as a sandbox. Within each component we apply the same principle and create sub-modules to reduce dependencies.
+At the current (unreleased) version v.0.15.0 the component hierarchy looks like follows:
koswat/
+
+ configuration/ # Data structures required for a koswat run.
+ geometries/
+ io/
+ settings/
+
+ core/ # Generic definitions and functionatilities.
+ geometries/
+ io/
+ protocols/
+
+ cost_report/ # Summary of costs per dike reinforcement.
+ io/
+ infrastructure/
+ multi_location_profile/
+ profile/
+ summary/
+
+ dike/ # Definition of a koswat dike.
+ characteristic_points/
+ layers/
+ material/
+ profile/
+ surroundings/
+
+ dike_reinforcements/ # Dike calculations to generate possible reinforcements.
+ input_profile/
+ io/
+ reinforcement_layers/
+ reinforcement_profile/
+
+ plots/ # Generic functionality for plotting.
+ dike/
+ geometries/
+
+ strategies/ # Different selection methods of all possible dike reinforcements alongside a dike traject.
+ order_strategy
+And the components interdependencies could be slightly represented as in the following diagram:
+ |
+
|---|
| Image 1. Component diagram | +
Inheritance¶
+To facilitate the Open-Closed principle most of our classes have parameterless constructors (__init__ method). Then, to instantiate objects we often relay on the implementation of builder patterns
Protocols¶
+In Koswat we make use of Protocols to define the required and essential properties and methods that represent an entity. Although Python does not always enforce these types as other OO languages would do (for instance C#), we try to follow and respect this principle throughought the whole repository.
+Builder pattern¶
+Check for instance this wikipedia article for a more detailed reference.
+Because most of our classes have dependencies on other classes their initialization would require multiple steps that would become tedious and hard to maintain if they were defined in the default init method. Moreover, this approach would violate the open-closed principle.
+Therefore, we apply the builder pattern to reduce complexity at the classes, improving maintainability and enabling future developments to create a separate builder shall the design require a different way of instantiating a given class.
+ +
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_cost_report.html b/reference/koswat_cost_report.html
new file mode 100644
index 00000000..c14add17
--- /dev/null
+++ b/reference/koswat_cost_report.html
@@ -0,0 +1,405 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Cost report¶
+A Koswat report is divided in different parts:
+-
+
- Summary report: A summary containing all 'location reports'. +
- Location report: Which profile reinforcements can be applied to each location based on their surroundings and reinforcement properties (
MultiLocationProfileCostReport).
+ - Infrastructure report: (
InfrastructureLocationProfileCostReport) Costs related to applying all calculated reinforcement profiles at the locations where infrastructures are present.
+ - Profile report: (
ProfileCostReport), what are the (material) volume costs associated when applying a given reinforced profile .
+ - Layer report: A sub report of the 'profile report' which breaks down the different costs of each one of the layers. This can be seen in Image 1 Volume costs. +
 |
+
|---|
| Image 1. Volume costs | +
Infrastructure report¶
+When determining the costs of infrastructures we look mainly at:
+-
+
- The reinforcement profile (
ReinforcementProfileProtocol) zones A and B.
+ - The distance between a dike and an infrastructure (
SurroundingsInfrastructure.points,PointSurroundings.surroundings_matrix).
+
These characteristics are then used to estimate how much surface of the infrastructures will be affected by the reinforced profile and therefore their associated cost.
+Reinforcement profile zones¶
+A reinforced profile can be different from its original state in many ways, however here we are only intestered in two things:
+-
+
- The new profile's width from the original waterside crest point. +
- Whether there is a crest's height increase (
dh0),
+
By using the old and the reinforced profile's geometries, we can determine what we call zone A and zone B, A + B = {profile's width from waterside crest point}.
-
+
- Zone
Arepresents the width of the dike old profile's crest (highest surface).
+ - Zone
Bthe distance between said crest and the end of the dike's reinforcement.
+
 |
+
|---|
Image 1. Reinforcement with dh0 = 0 |
+
However, when the crest's height of a ReinforcementProfileProtocol has increased in comparison to its original profile (ReinforcementProfileProtocol.old_profile, KoswatProfileProtocol) then we set zone A = 0 and therefore B = {profile's width from waterside crest point}.
 |
+
|---|
Image 2. Reinforcement with dh0 = 1 |
+
Infrastructure's distances¶
+An infrastructure (SurroundingsInfrastructure) can be present at different locations (SurroundingsInfrastructure.points). Each of these locations (PointSurroundings) contains a dictionary (surroundings_matrix: dict[float, float]) where the key is the distance between said location and the infrastructure and the values represent the length of the infrastructure found at that distance.
For instance, we could have surroundings_matrix = {5: 1.5, 10: 0, 15: 2.5}, which means:
+- Between 0 and 5 meters from the location we will find 1.5 meters of the infrastructure,
+- Between 5 and 10 meters from the location we will find 0 meters of the infrastructure,
+- Between 10 and 15 meters from the location we will find 2.5 meters of the infrastructure.
In addition, each infrastructure has a fixed width (SurroundingsInfrastructure.infrastructure_width), which can later be used to calculate the total surface of said infrastructure affected by the given profile. So: affected_infra_zone_x = meters_of_infrastructure_in_zone_x * infrastructure_width, where meters_of_infrastructure_in_zone_x are the values calculated from the surroundings_matrix and infrastructure_width is the infrastructure fixed width.
Cost calculation¶
+After defining the profile's zones A and B we can easily find how much of each infrastructures is affected by checking the surroundings_matrix indices and "rounding" up. It is agreed that at the overlapping points between A and B, the affected surface, and therefore costs, will only be computed for zone A; this is done regardless of the chosen infrastructure costs type (InfraCostsEnum).
Once the total area is known, we only need to multiply them by their related costs for adding and/or removing infrastructure's material.
+Example¶
+Using as example the previous surroundings_matrix = {5: 1.5, 10: 0, 15: 2.5} we can demostrate this when A = 4 and B = 10.
-
+
- Estimate zone limits:
-
+
zone_agoes from 0 to 4,
+zone_bgoes from 4 to 14.
+
+ - Estimate affected points in the surroundings matrix:
-
+
zone_aaffects only up until key5, so 1.5 meters of infrastructure.
+zone_baffects keys10and15, so 2.5 meters of infrastructure.-
+
- Note that we do not take
5as has already been considered forzone_a.
+
+- Note that we do not take
+
Generated files¶
+After running a Koswat analysis, several files and directories will be generated. Usually the structure will be as follows:
+Dike profile section scenarios -> Scenario -> Generated files
-
+
- Dike profile - scenarios directory: Each dike can be run using different scenarios. +
- Scenario: Scenario being applied to the selected dike profile. +
- Dike section: The selected dike section being analyzed. +
- Generated files: A combination of images and a 'csv' matrix result.
-
+
- Images: Visual description of each of the possible reinforcements being applied. +
summary_costs.csv: A csv file containing all the costs information of the summary.-
+
- Represents the Summary, Profile and Layer report. +
+summary_locations.csv: A csv file containing per-location a breakdown of available reinforcements and selected reinforcement ( see strategies).-
+
- Represents the Location report. +
+/summary_locationsdirectory: contains the following.shpfiles (and their related binaries): + -summary_locations_measures: The same data as present insummary_locations.csvis used to shape the geometry of a dike's traject. We keep as well the type of chosen reinforcement.-
+
summary_locations_new: an overlay ofsummary_locations_measureswith the geometry buffered in relation to the new selected reinforcement.
+summary_locations_old: an overlay ofsummary_locations_measureswith the geometry buffered in relation to the original selected reinforcement.
+summary_locations_step: an overlay ofsummary_locations_measureswith the geometry buffered in relation to the Ordered Strategy step.
+
+summary_infrastructure_costs.csv: A csv file contaning all the infrastructure costs at each location for each of the supported reinforcement profile types.-
+
- Represents the Infrastructure Report. +
+
+
Example using a summarized view of the output tree directory when running the acceptance test test_main.test_given_valid_input_succeeds:
+
acceptance
+| koswat.log
+|
++-- results_output
+| +-- dike_10-1-1-A-1-A
+| | +-- scenario_scenario1
+| | | | Grondmaatregel_profiel.png
+| | | | Kistdam.png
+| | | | Kwelscherm.png
+| | | | summary_costs.csv
+| | | | summary_locations.csv
+| | | | summary_infrastructure_costs.csv
+| | | | Stabiliteitswand.png
+| | | | Verticale_piping_oplossing.png
+| | | |
+| | | +-- summary_locations
+| | | | summary_locations_measures.cpg
+| | | | summary_locations_measures.dbf
+| | | | summary_locations_measures.prj
+| | | | summary_locations_measures.shp
+| | | | summary_locations_measures.shx
+| | | | summary_locations_new.cpg
+| | | | summary_locations_new.dbf
+| | | | summary_locations_new.prj
+| | | | summary_locations_new.shp
+| | | | summary_locations_new.shx
+| | | | summary_locations_old.cpg
+| | | | summary_locations_old.dbf
+| | | | summary_locations_old.prj
+| | | | summary_locations_old.shp
+| | | | summary_locations_step.shx
+| | | | summary_locations_step.cpg
+| | | | summary_locations_step.dbf
+| | | | summary_locations_step.prj
+| | | | summary_locations_step.shp
+| | | | summary_locations_step.shx
+| | | +-- Grondmaatregel_profiel
+| | | | added_Grondmaatregel_profiel_CLAY.png
+| | | | added_Grondmaatregel_profiel_GRASS.png
+| | | | added_Grondmaatregel_profiel_SAND.png
+| | | | removed_Grondmaatregel_profiel_CLAY.png
+| | | | removed_Grondmaatregel_profiel_GRASS.png
+| | | +-- Kistdam
+| | | | ...
+| | |
+| | | +-- Kwelscherm
+| | | | ...
+| | |
+| | | +-- Stabiliteitswand
+| | | | ...
+| | |
+| | | +-- Verticale_piping_oplossing
+| | | | ...
+| | |
+| | +-- scenario_scenario2
+| | | ...
+
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_dike.html b/reference/koswat_dike.html
new file mode 100644
index 00000000..dc0d5ae3
--- /dev/null
+++ b/reference/koswat_dike.html
@@ -0,0 +1,300 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Dike profile¶
+In this section we will describe how a Koswat dike is defined and what its parts are.
+Koswat properties¶
+A koswat dike is represented by an instance of a KoswatProfileProtocol. And its properties represent different aspects of a 'real domain'. With Image 1. Base profile properties as reference, we can see the mapping between said 'real domain' and the koswat properties:
-
+
input_data: The parts of a dike (written on the image reference), which are directly mapped as an implementation of theKoswatInputProfileProtocol.
+characteristic_points: 8 points given by the user describing the dike on (x,y) coordinates, the first four represent the waterside (buitendijks), the last four the polderside (binnendijks). Numbered in the reference picture from 1 to 8. Point 4 is considered to be the reference value (0) with respect to distances of e.g. surroundings and widths of certain parts of the dike.
+layers_wrapper: The description on how the layers of the dike are built. Further described in Dike layers.
+location: Geospatial coordinates (x, y) where the dike is situated.
+profile_width: The difference between the lowest and the highest 'x' coordinates of the profile characteristic points. The distance between characteristic points 1 and 8. This can be broken down into:
+waterside_width: The distance between characteristics points 1 and 4.
+polderside_width: The distance between characteristics points 4 and 8.
+
 |
+
|---|
| Image 1. Base profile properties | +
The geometry of a dike has certain additional characteristics:
+- crest (kruin): The flat part on top of the dike.
+- berm (berm): The flat part between either point 2 and 3 (waterside) or point 6 an 7 (polderside).
+- slope (talud): The (steepness of the) diagonal parts between points 1 and 4 (waterside) or points 5 and 8 (polderside).
+- ground level (maaiveld): The level of the area to the left of point 1 (waterside) or to the right of point 8 (polderside).
Dike layers¶
+A dike is composed by three layers:
+-
+
- Sand, the core layer. +
- Clay, a coating layer. +
- Grass, a (top) coating layer. +
These layers are wrapped under a KoswatLayersWrapperProtocol instance. At the same time, each layer is an instance of a KoswatLayerProtocol containing the following properties:
-
+
material_type: Either Sand, Clay or Grass.
+upper_points: The surface points of the layer. This property can be used to calculate the surface (m2) of a material.
+outer_geometry: A polygon representing the material layer and the 'wrapped' polygons. For instance, the Clayouter_geometrywill also include the Sandmaterial_geometry.
+material_geometry: A closed polygon containing only the points representing the layer.
+
Using Image 3. Clay layer highlighted as an example, we can map the previous properties:
+-
+
material_type: Clay, the 'in-between' layer.
+upper_points: Line with the 'orange' points, without 'closing' the polygon, something like: [(-18, 0), (0, 5.5), (8, 5.5), (21, 0)].
+outer_geometry: Closed geometry using theupper pointsand the 'ground level' (maaiveld) points: [(-18, 0), (0, 5.5), (8, 5.5), (21, 0), (-18, 0)].
+material_geometry: Closed geometry using theupper_pointsfrom Clay and theupper_pointsfrom the layer below (Sand, green points). Should be something like: [(-18, 0), (0, 5.5), (8, 5.5), (21, 0), (19, 0), (8, 4.75), (0, 4.75), (-14, 0), (-18, 0)]
+
 |
+
|---|
| Image 2. Sand layer highlighted | +
 |
+
|---|
| Image 3. Clay layer highlighted | +
 |
+
|---|
| Image 4. Grass layer highlighted | +
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_docstrings/configuration/koswat_config_protocol.html b/reference/koswat_docstrings/configuration/koswat_config_protocol.html
new file mode 100644
index 00000000..9aaaf5ce
--- /dev/null
+++ b/reference/koswat_docstrings/configuration/koswat_config_protocol.html
@@ -0,0 +1,344 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Koswat Config Protocol¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ DataObjectModelProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
Empty protocol just to be able to classify other classes as a DataObjectModelProtocol Instance.
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatConfigProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: DataObjectModelProtocol, Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+is_valid() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Validates the current KoswatConfigProtocol instance.
Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+
|
+
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_docstrings/core/geometries.html b/reference/koswat_docstrings/core/geometries.html
new file mode 100644
index 00000000..bd9169ad
--- /dev/null
+++ b/reference/koswat_docstrings/core/geometries.html
@@ -0,0 +1,886 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Core geometries module¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+as_unified_geometry(source_geom: geometry.Polygon | geometry.MultiPolygon) -> geometry.Polygon
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Ensures the calculated geometry is returned as a single polygon.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
source_geom |
+
+ geometry.Polygon | geometry.MultiPolygon
+ |
+ Calculated source geometry. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ geometry.Polygon
+ |
+ geometry.Polygon: Unified resulting geometry with its points ordered (first one is the most-left x coordinate). |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_groundlevel_surface(pol_geometry: geometry.Polygon) -> geometry.LineString
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Returns all the points which are at 'groundlevel' values (y = 0)
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
pol_geometry |
+
+ geometry.Polygon
+ |
+ Source geometry. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ geometry.LineString
+ |
+ geometry.LineString: Line with points at y = 0. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_normalized_polygon_difference(left_geom: geometry.Polygon, right_geom: geometry.Polygon) -> geometry.Polygon | geometry.MultiPolygon
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Given two polygons calculates the difference between them and removes any residual polygon due to minor precision errors.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
left_geom |
+
+ geometry.Polygon
+ |
+ Base polygon from where to substract. |
+ + required + | +
right_geom |
+
+ geometry.Polygon
+ |
+ Polygon to substract from base. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ geometry.Polygon | geometry.MultiPolygon
+ |
+ geometry.Polygon: Resulting normalized substraction polygon. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_polygon_coordinates(pol_geometry: geometry.Polygon | geometry.MultiPolygon) -> geometry.LineString
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Given a single or multi geometry returns the coordinates composing its outer layout.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
pol_geometry |
+
+ geometry.Polygon | geometry.MultiPolygon
+ |
+ Source geometry. |
+ + required + | +
Raises:
+| Type | +Description | +
|---|---|
+ NotImplementedError
+ |
+ When the provided geometry is not yet supported. |
+
Returns:
+| Type | +Description | +
|---|---|
+ geometry.LineString
+ |
+ geometry.LineString: Set of points composing the outer layout of the geometry. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_polygon_surface_points(base_geometry: geometry.Polygon | geometry.MultiPolygon) -> geometry.LineString
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Gets all the points composing the upper surface of a 'dike' geometry.
+IMPORTANT! The calling of this method assumes the base_geometry points are in order, call order_geometry_points if needed.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
base_geometry |
+
+ Union[geometry.Polygon, geometry.MultiPolygon]
+ |
+ Source geometry. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ geometry.LineString
+ |
+ geometry.LineString: Resulting line with points from the outer geometry. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_relative_core_layer(core_geometry: geometry.Polygon, coating_geometry: geometry.Polygon) -> geometry.Polygon
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Returns a new 'core' from the original core_geometry relative to the coating_geometry.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
core_geometry |
+
+ Polygon
+ |
+ Original core geometry on which layers are stacked upon. |
+ + required + | +
coating_geometry |
+
+ Polygon
+ |
+ Layer wrapping the exterior of a core geometry. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
Polygon |
+ geometry.Polygon
+ |
+ Layer wrapping a reduced surface of the |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+order_geometry_points(dike_polygon: geometry.Polygon) -> geometry.Polygon
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+In koswat we handle polygon operations expecting the lowest 'x' coordinate to be the initial and last point of a geometry. +For this reason we need to ensure all geometries are 'normalized' based on this criteria.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
dike_polygon |
+
+ geometry.Polygon
+ |
+ Polygon to normalized. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ geometry.Polygon
+ |
+ geometry.Polygon: Normalized polygon. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+profile_points_to_polygon(points_list: list[geometry.Point]) -> geometry.Polygon
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Transforms a list of points into a valid 'dike' polygon. When there is a difference in height between left and right side then we correct it in the x = 0 coordinate.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
points_list |
+
+ List[geometry.Point]
+ |
+ List of points representing a dike profile. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ geometry.Polygon
+ |
+ geometry.Polygon: Validated enclosed geometry simple polygon. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+remove_layer_from_polygon(dike_polygon: geometry.Polygon, layer_depth: float) -> geometry.Polygon
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Gets the dike profile without a layer of provided layer_depth depth.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
dike_polygon |
+
+ geometry.Polygon
+ |
+ Source geometry. |
+ + required + | +
layer_depth |
+
+ float
+ |
+ Depth of a layer from the outer |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ geometry.Polygon
+ |
+ geometry.Polygon: Resulting geometry when removing the layer. |
+
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_docstrings/core/io.html b/reference/koswat_docstrings/core/io.html
new file mode 100644
index 00000000..cf8e5595
--- /dev/null
+++ b/reference/koswat_docstrings/core/io.html
@@ -0,0 +1,2671 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Input Output core module¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ FileObjectModelProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+is_valid() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Verifies if the current object is valid for import / export.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ Result of the validation. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ DataObjectModelProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
Empty protocol just to be able to classify other classes as a DataObjectModelProtocol Instance.
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatImporterProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+import_from(from_path: Path) -> Union[DataObjectModelProtocol, List[DataObjectModelProtocol]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Generates a valid instance of a DataObjectModelProtocol based on the contents from the provided path.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
from_path |
+
+ Path
+ |
+ Path containing data to be read. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ Union[DataObjectModelProtocol, List[DataObjectModelProtocol]]
+ |
+ Union[DataObjectModelProtocol, List[DataObjectModelProtocol]]: Either a single valid instance of a |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ FileObjectModelProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+is_valid() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Verifies if the current object is valid for import / export.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ Result of the validation. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatReaderProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+read(file_path: Path) -> FileObjectModelProtocol
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Imports the data from the file_path into a concrete implementation of a FileObjectModelProtocol.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
file_path |
+
+ Path
+ |
+ Path to a file that should be imported. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
FileObjectModelProtocol |
+ FileObjectModelProtocol
+ |
+ Model representing the data in the file. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+supports_file(file_path: Path) -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Validates whether the current reader is capable of importing data from the provided file.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
file_path |
+
+ Path
+ |
+ Path to a file that should be imported. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ Result of validation. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ FileObjectModelProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+is_valid() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Verifies if the current object is valid for import / export.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ Result of the validation. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatWriterProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+write(fom_instance: FileObjectModelProtocol, to_path: Path) -> None
+
+¶
+
+
+
+
+
+
+
+
+
+
+Writes the data from the instance of a FileObjectModelProtocol to the to_path.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
fom_instance |
+
+ FileObjectModelProtocol
+ |
+ Instance with data to write. |
+ + required + | +
to_path |
+
+ Path
+ |
+ Path to file (or directory) where to write the data. |
+ + required + | +
CSV module¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ FileObjectModelProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+is_valid() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Verifies if the current object is valid for import / export.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ Result of the validation. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatCsvFomProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: FileObjectModelProtocol, Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+is_valid() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Validates the current structure of this KoswatCsvFomProtocol instance.
Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ True when is a valid FOM. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatCsvFomProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: FileObjectModelProtocol, Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+is_valid() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Validates the current structure of this KoswatCsvFomProtocol instance.
Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ True when is a valid FOM. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatReaderProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+read(file_path: Path) -> FileObjectModelProtocol
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Imports the data from the file_path into a concrete implementation of a FileObjectModelProtocol.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
file_path |
+
+ Path
+ |
+ Path to a file that should be imported. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
FileObjectModelProtocol |
+ FileObjectModelProtocol
+ |
+ Model representing the data in the file. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+supports_file(file_path: Path) -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Validates whether the current reader is capable of importing data from the provided file.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
file_path |
+
+ Path
+ |
+ Path to a file that should be imported. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ Result of validation. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatCsvFomProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: FileObjectModelProtocol, Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+is_valid() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Validates the current structure of this KoswatCsvFomProtocol instance.
Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ True when is a valid FOM. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatWriterProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+write(fom_instance: FileObjectModelProtocol, to_path: Path) -> None
+
+¶
+
+
+
+
+
+
+
+
+
+
+Writes the data from the instance of a FileObjectModelProtocol to the to_path.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
fom_instance |
+
+ FileObjectModelProtocol
+ |
+ Instance with data to write. |
+ + required + | +
to_path |
+
+ Path
+ |
+ Path to file (or directory) where to write the data. |
+ + required + | +
INI module¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ FileObjectModelProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+is_valid() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Verifies if the current object is valid for import / export.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ Result of the validation. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatIniFomProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: FileObjectModelProtocol, Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+from_config(ini_config: ConfigParser) -> KoswatIniFomProtocol
+
+
+ classmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Imports all the data stored in an dictionary into a KoswatIniFomProtocol instance.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
ini_config |
+
+ ConfigParser
+ |
+ Dictionary containing Ini values (section - properties, property - value) to be parsed. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
KoswatIniFomProtocol |
+ KoswatIniFomProtocol
+ |
+ Valid instance of a |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatIniFomProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: FileObjectModelProtocol, Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+from_config(ini_config: ConfigParser) -> KoswatIniFomProtocol
+
+
+ classmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Imports all the data stored in an dictionary into a KoswatIniFomProtocol instance.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
ini_config |
+
+ ConfigParser
+ |
+ Dictionary containing Ini values (section - properties, property - value) to be parsed. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
KoswatIniFomProtocol |
+ KoswatIniFomProtocol
+ |
+ Valid instance of a |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatReaderProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+read(file_path: Path) -> FileObjectModelProtocol
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Imports the data from the file_path into a concrete implementation of a FileObjectModelProtocol.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
file_path |
+
+ Path
+ |
+ Path to a file that should be imported. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
FileObjectModelProtocol |
+ FileObjectModelProtocol
+ |
+ Model representing the data in the file. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+supports_file(file_path: Path) -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Validates whether the current reader is capable of importing data from the provided file.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
file_path |
+
+ Path
+ |
+ Path to a file that should be imported. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ Result of validation. |
+
TXT module¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ FileObjectModelProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+is_valid() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Verifies if the current object is valid for import / export.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ Result of the validation. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatTxtFomProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: FileObjectModelProtocol, Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+from_text(file_text: str) -> KoswatTxtFomProtocol
+
+
+ classmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Imports all the data stored in text form.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
file_text |
+
+ str
+ |
+ Raw data in string format. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
KoswatTxtFomProtocol |
+ KoswatTxtFomProtocol
+ |
+ Valid instance of a |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatReaderProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+read(file_path: Path) -> FileObjectModelProtocol
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Imports the data from the file_path into a concrete implementation of a FileObjectModelProtocol.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
file_path |
+
+ Path
+ |
+ Path to a file that should be imported. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
FileObjectModelProtocol |
+ FileObjectModelProtocol
+ |
+ Model representing the data in the file. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+supports_file(file_path: Path) -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Validates whether the current reader is capable of importing data from the provided file.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
file_path |
+
+ Path
+ |
+ Path to a file that should be imported. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ Result of validation. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatTxtFomProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: FileObjectModelProtocol, Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+from_text(file_text: str) -> KoswatTxtFomProtocol
+
+
+ classmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Imports all the data stored in text form.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
file_text |
+
+ str
+ |
+ Raw data in string format. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
KoswatTxtFomProtocol |
+ KoswatTxtFomProtocol
+ |
+ Valid instance of a |
+
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_docstrings/core/koswat_logger.html b/reference/koswat_docstrings/core/koswat_logger.html
new file mode 100644
index 00000000..ad7a5705
--- /dev/null
+++ b/reference/koswat_docstrings/core/koswat_logger.html
@@ -0,0 +1,270 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_docstrings/core/protocols.html b/reference/koswat_docstrings/core/protocols.html
new file mode 100644
index 00000000..8624d95c
--- /dev/null
+++ b/reference/koswat_docstrings/core/protocols.html
@@ -0,0 +1,364 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Core protocols module¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ BuilderProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+build() -> Any
+
+¶
+
+
+
+
+
+
+
+
+
+
+Instantiates a concrete object to separate its initalization from the data structure.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
Any |
+ Any
+ |
+ Intance of a created object within Koswat domain. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ DataObjectModelProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
Empty protocol just to be able to classify other classes as a DataObjectModelProtocol Instance.
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_docstrings/cost_report.html b/reference/koswat_docstrings/cost_report.html
new file mode 100644
index 00000000..58a612c0
--- /dev/null
+++ b/reference/koswat_docstrings/cost_report.html
@@ -0,0 +1,6886 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Cost report module¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ CostReportProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
A Protocol defining the properties of a report in Koswat.
+
+
+
+
+
+
+
+ Infrastructure cost calculator¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ProfileZoneCalculator
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Calculator to determine the width of zones A and B of a reinforced
+profile (ReinforcementProfileProtocol). It requires its original base
+profile to be in its definition.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+calculate() -> tuple[float, float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Calculates the width of zones A and B for the defined instance of
+ReinforcementProfileProtocol. The calculation is as follows:
+- When dh0 has not varied with respect to the base profile, then zones
+A and B are calculated.
+- When dh0 has increased then only zone B is calculated.
Returns:
+| Type | +Description | +
|---|---|
+ tuple[float, float]
+ |
+ tuple[float, float]: Calculated zone |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ InfrastructureLocationCosts
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Simple data structure containing the results of the costs calculations
+for a given ReinforcementProfileProtocol profile.
+The values related to zone_a and zone_b are calculated in the
+ProfileZoneCalculator.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ InfrastructureProfileCostsCalculator
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Calculator to generate all InfrastructureLocationCosts instances
+based on the locations of the contained infrastructure
+(SurroundingsInfrastructure.points) and the width of zone_a and
+zone_b.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+calculate(zone_a_width: float, zone_b_width: float) -> list[InfrastructureLocationCosts]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Calculates the costs affecting this instance's infrastructure +at all points where it is present.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
zone_a_width |
+
+ float
+ |
+ Width of zone type |
+ + required + | +
zone_b_width |
+
+ float
+ |
+ Width of zone type `B . |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ list[InfrastructureLocationCosts]
+ |
+ list[InfrastructureLocationCosts]: Resulting cost summaries. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ PointSurroundings
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Object representing a meter with x, y coordinates in a polder (or else).
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__eq__(__value: object) -> bool
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" equality operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__hash__() -> int
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" hash operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+closest_obstacle: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Distance to the closest (obstacle) surrounding. When no surroundings are given the value will be NaN (Not A Number), so that the value 0 is reserved for buildings at distance 0.
Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Distance to the closest surrounding. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_total_infrastructure_per_zone(*zone_limit_collection: tuple[float, float]) -> list[float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the total infrastructure width at each of the provided zones
+zone_limit_collection (tuple[float, float]).
+The zone limits are matched by rounding up their upper limit to the
+surroundings_matrix keys (distances to the location in the real world).
+When two zones have overlapping limits (as expected) the lower one will
+"claim" the corresponding surrounding distance.
+
+ Example
+-
+
zone_limit_collection= (0, 4), (4, 11)
+surroundings_matrix= {5: 1.5, 10: 3, 15: 6}
+- "Taken" distances per zone:
-
+
(0, 4)takes key5.
+(4, 11)takes key(s)10and15because5was already taken.
+
+ - Total infrastructure width at zones =
(1.5, 9)
+
Returns:
+| Type | +Description | +
|---|---|
+ list[float]
+ |
+ list[float]: list with total width corresponding to each provided zone. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ SurroundingsInfrastructure
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatSurroundingsProtocol
Defines surroundings point collections that can be repaired or replaced.
+The PointSurroundings contain a matrix (dictionary) where the keys
+represent the distances to an obstacle, and the values a float representing
+how long that infrastructure is.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ InfrastructureProfileCostsCalculator
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Calculator to generate all InfrastructureLocationCosts instances
+based on the locations of the contained infrastructure
+(SurroundingsInfrastructure.points) and the width of zone_a and
+zone_b.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+calculate(zone_a_width: float, zone_b_width: float) -> list[InfrastructureLocationCosts]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Calculates the costs affecting this instance's infrastructure +at all points where it is present.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
zone_a_width |
+
+ float
+ |
+ Width of zone type |
+ + required + | +
zone_b_width |
+
+ float
+ |
+ Width of zone type `B . |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ list[InfrastructureLocationCosts]
+ |
+ list[InfrastructureLocationCosts]: Resulting cost summaries. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ MultiInfrastructureProfileCostsCalculator
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Calculator that contains all possible "infrastructure" calculators
+(InfrastructureProfileCostsCalculator) one for each of the available
+infrastructures in the current KoswatScenario.
+Its calculate method only requires a reinforcement
+(ReinforcementProfileProtocol) to determine all infrastructures' costs.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+calculate(reinforced_profile: ReinforcementProfileProtocol) -> list[InfrastructureLocationProfileCostReport]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Calculates the costs related to appyling the provided reinforcement_profile
+at all the locations where an infrastructure is present. It first determines
+zone A and B and then provides their widths to the inner
+infrastructure calculators (InfrastructureProfileCostsCalculator).
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforced_profile |
+
+ ReinforcementProfileProtocol
+ |
+ Reinforcement to be applied. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ list[InfrastructureLocationProfileCostReport]
+ |
+ list[InfrastructureLocationProfileCostReport]: Collection of reports summarizing the cost-impact of a |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ProfileZoneCalculator
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Calculator to determine the width of zones A and B of a reinforced
+profile (ReinforcementProfileProtocol). It requires its original base
+profile to be in its definition.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+calculate() -> tuple[float, float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Calculates the width of zones A and B for the defined instance of
+ReinforcementProfileProtocol. The calculation is as follows:
+- When dh0 has not varied with respect to the base profile, then zones
+A and B are calculated.
+- When dh0 has increased then only zone B is calculated.
Returns:
+| Type | +Description | +
|---|---|
+ tuple[float, float]
+ |
+ tuple[float, float]: Calculated zone |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ BuilderProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+build() -> Any
+
+¶
+
+
+
+
+
+
+
+
+
+
+Instantiates a concrete object to separate its initalization from the data structure.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
Any |
+ Any
+ |
+ Intance of a created object within Koswat domain. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ InfrastructureProfileCostsCalculator
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Calculator to generate all InfrastructureLocationCosts instances
+based on the locations of the contained infrastructure
+(SurroundingsInfrastructure.points) and the width of zone_a and
+zone_b.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+calculate(zone_a_width: float, zone_b_width: float) -> list[InfrastructureLocationCosts]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Calculates the costs affecting this instance's infrastructure +at all points where it is present.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
zone_a_width |
+
+ float
+ |
+ Width of zone type |
+ + required + | +
zone_b_width |
+
+ float
+ |
+ Width of zone type `B . |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ list[InfrastructureLocationCosts]
+ |
+ list[InfrastructureLocationCosts]: Resulting cost summaries. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ MultiInfrastructureProfileCostsCalculator
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Calculator that contains all possible "infrastructure" calculators
+(InfrastructureProfileCostsCalculator) one for each of the available
+infrastructures in the current KoswatScenario.
+Its calculate method only requires a reinforcement
+(ReinforcementProfileProtocol) to determine all infrastructures' costs.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+calculate(reinforced_profile: ReinforcementProfileProtocol) -> list[InfrastructureLocationProfileCostReport]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Calculates the costs related to appyling the provided reinforcement_profile
+at all the locations where an infrastructure is present. It first determines
+zone A and B and then provides their widths to the inner
+infrastructure calculators (InfrastructureProfileCostsCalculator).
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforced_profile |
+
+ ReinforcementProfileProtocol
+ |
+ Reinforcement to be applied. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ list[InfrastructureLocationProfileCostReport]
+ |
+ list[InfrastructureLocationProfileCostReport]: Collection of reports summarizing the cost-impact of a |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ MultiInfrastructureProfileCostsCalculatorBuilder
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: BuilderProtocol
Builder to set up "fix" information such as costs derived from the koswat
+settings (InfraCostsEnum, SurtaxFactorEnum) which directly determines the
+zone A and/or B costs that will be applied for each infrastructure.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ SurroundingsInfrastructure
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatSurroundingsProtocol
Defines surroundings point collections that can be repaired or replaced.
+The PointSurroundings contain a matrix (dictionary) where the keys
+represent the distances to an obstacle, and the values a float representing
+how long that infrastructure is.
+
+
+
+
+
+
+
+ Quantity cost parameters calculator¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ CostParameterProtocol
+
+
+¶
+
+
+
+
+IO¶
+Summary¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatExporterProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export(**kwargs) -> None
+
+¶
+
+
+
+
+
+
+Exports an object model into a concrete file format.
+ +
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatSummary
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents the summary of the KOSWAT analysis.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs() -> dict[type[ReinforcementProfileProtocol], tuple[float, float]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the infrastructure costs for each profile type +for those locations for which the profile type is selected.
+ +Returns:
+| Type | +Description | +
|---|---|
+ dict[type[ReinforcementProfileProtocol], tuple[float, float]]
+ |
+ dict[type[ReinforcementProfileProtocol], tuple[float, float]]: +infrastructure costs without and with surtax per reinforcement type. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_report_by_profile(profile_type: type[ReinforcementProfileProtocol]) -> MultiLocationProfileCostReport | None
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Get the report for a specific profile type.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
profile_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Type of reinforcement profile. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ MultiLocationProfileCostReport | None
+ |
+ MultiLocationProfileCostReport | None: Report for the profile type. |
+
Summary costs¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatExporterProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export(**kwargs) -> None
+
+¶
+
+
+
+
+
+
+Exports an object model into a concrete file format.
+ +
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatSummary
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents the summary of the KOSWAT analysis.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs() -> dict[type[ReinforcementProfileProtocol], tuple[float, float]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the infrastructure costs for each profile type +for those locations for which the profile type is selected.
+ +Returns:
+| Type | +Description | +
|---|---|
+ dict[type[ReinforcementProfileProtocol], tuple[float, float]]
+ |
+ dict[type[ReinforcementProfileProtocol], tuple[float, float]]: +infrastructure costs without and with surtax per reinforcement type. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_report_by_profile(profile_type: type[ReinforcementProfileProtocol]) -> MultiLocationProfileCostReport | None
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Get the report for a specific profile type.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
profile_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Type of reinforcement profile. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ MultiLocationProfileCostReport | None
+ |
+ MultiLocationProfileCostReport | None: Report for the profile type. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ BuilderProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+build() -> Any
+
+¶
+
+
+
+
+
+
+
+
+
+
+Instantiates a concrete object to separate its initalization from the data structure.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
Any |
+ Any
+ |
+ Intance of a created object within Koswat domain. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ CostParameterProtocol
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatSummary
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents the summary of the KOSWAT analysis.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs() -> dict[type[ReinforcementProfileProtocol], tuple[float, float]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the infrastructure costs for each profile type +for those locations for which the profile type is selected.
+ +Returns:
+| Type | +Description | +
|---|---|
+ dict[type[ReinforcementProfileProtocol], tuple[float, float]]
+ |
+ dict[type[ReinforcementProfileProtocol], tuple[float, float]]: +infrastructure costs without and with surtax per reinforcement type. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_report_by_profile(profile_type: type[ReinforcementProfileProtocol]) -> MultiLocationProfileCostReport | None
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Get the report for a specific profile type.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
profile_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Type of reinforcement profile. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ MultiLocationProfileCostReport | None
+ |
+ MultiLocationProfileCostReport | None: Report for the profile type. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+ Summary infrastructure costs¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatExporterProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export(**kwargs) -> None
+
+¶
+
+
+
+
+
+
+Exports an object model into a concrete file format.
+ +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatSummary
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents the summary of the KOSWAT analysis.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs() -> dict[type[ReinforcementProfileProtocol], tuple[float, float]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the infrastructure costs for each profile type +for those locations for which the profile type is selected.
+ +Returns:
+| Type | +Description | +
|---|---|
+ dict[type[ReinforcementProfileProtocol], tuple[float, float]]
+ |
+ dict[type[ReinforcementProfileProtocol], tuple[float, float]]: +infrastructure costs without and with surtax per reinforcement type. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_report_by_profile(profile_type: type[ReinforcementProfileProtocol]) -> MultiLocationProfileCostReport | None
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Get the report for a specific profile type.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
profile_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Type of reinforcement profile. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ MultiLocationProfileCostReport | None
+ |
+ MultiLocationProfileCostReport | None: Report for the profile type. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ SummaryInfrastructureCostsCsvFomBuilder
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: BuilderProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ BuilderProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+build() -> Any
+
+¶
+
+
+
+
+
+
+
+
+
+
+Instantiates a concrete object to separate its initalization from the data structure.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
Any |
+ Any
+ |
+ Intance of a created object within Koswat domain. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ InfrastructureLocationCosts
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Simple data structure containing the results of the costs calculations
+for a given ReinforcementProfileProtocol profile.
+The values related to zone_a and zone_b are calculated in the
+ProfileZoneCalculator.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatSummary
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents the summary of the KOSWAT analysis.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs() -> dict[type[ReinforcementProfileProtocol], tuple[float, float]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the infrastructure costs for each profile type +for those locations for which the profile type is selected.
+ +Returns:
+| Type | +Description | +
|---|---|
+ dict[type[ReinforcementProfileProtocol], tuple[float, float]]
+ |
+ dict[type[ReinforcementProfileProtocol], tuple[float, float]]: +infrastructure costs without and with surtax per reinforcement type. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_report_by_profile(profile_type: type[ReinforcementProfileProtocol]) -> MultiLocationProfileCostReport | None
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Get the report for a specific profile type.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
profile_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Type of reinforcement profile. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ MultiLocationProfileCostReport | None
+ |
+ MultiLocationProfileCostReport | None: Report for the profile type. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ MultiLocationProfileCostReport
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: CostReportProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infra_costs_per_location() -> dict[PointSurroundings, tuple[float, float]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the total costs related to infrastructures at each of the points for
+the profile type in profile_cost_report
Returns:
+| Type | +Description | +
|---|---|
+ dict[PointSurroundings, tuple[float, float]]
+ |
+ dict[PointSurroundings, tuple[float, float]]: Total cost per location (without and with surtax). |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+total_cost: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Calculates the cost of the measure for all possible locations, +regardless whether that measure is chosen by the order strategy or not.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ PointSurroundings
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Object representing a meter with x, y coordinates in a polder (or else).
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__eq__(__value: object) -> bool
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" equality operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__hash__() -> int
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" hash operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+closest_obstacle: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Distance to the closest (obstacle) surrounding. When no surroundings are given the value will be NaN (Not A Number), so that the value 0 is reserved for buildings at distance 0.
Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Distance to the closest surrounding. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_total_infrastructure_per_zone(*zone_limit_collection: tuple[float, float]) -> list[float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the total infrastructure width at each of the provided zones
+zone_limit_collection (tuple[float, float]).
+The zone limits are matched by rounding up their upper limit to the
+surroundings_matrix keys (distances to the location in the real world).
+When two zones have overlapping limits (as expected) the lower one will
+"claim" the corresponding surrounding distance.
+
+ Example
+-
+
zone_limit_collection= (0, 4), (4, 11)
+surroundings_matrix= {5: 1.5, 10: 3, 15: 6}
+- "Taken" distances per zone:
-
+
(0, 4)takes key5.
+(4, 11)takes key(s)10and15because5was already taken.
+
+ - Total infrastructure width at zones =
(1.5, 9)
+
Returns:
+| Type | +Description | +
|---|---|
+ list[float]
+ |
+ list[float]: list with total width corresponding to each provided zone. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyLocationReinforcement
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents a location and the different reinforcements that can be applied to it +as well their costs. +This class is used to show the final chosen state for a location.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_cost: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Estimates the costs at this location for the given current_selected_measure.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_selected_measure: type[ReinforcementProfileProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Exposes the current selected measure for this object.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs(reinforcement_type: type[ReinforcementProfileProtocol]) -> tuple[float, float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Returns the infrastructure costs for the given reinforcement type (without and with surtax).
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ tuple[float, float]
+ |
+ tuple[float, float]: Tuple containing the infrastructure costs without and with surtax. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_selected_measure_steps() -> tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Outputs the selected measure following the domain (expected) steps: + - Initial step, + - Order step, + - Infrastructure step
+ +Returns:
+| Type | +Description | +
|---|---|
+ tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+ |
+ tuple[ +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol]]: Resulting tuple. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+set_selected_measure(reinforcement_type: type[ReinforcementProfileProtocol], step: StrategyStepEnum)
+
+¶
+
+
+
+
+
+
+
+
+
+
+Changes the value reprsented in current_selected_measure and updates the
+dictionary of selections (history).
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type |
+ + required + | +
step |
+
+ StrategyStepsEnum
+ |
+ Step whose |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+ SummaryInfrastructureCostsCsvFomBuilder
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: BuilderProtocol
+
+
+
+
+
+
+
+ Summary locations¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatExporterProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export(**kwargs) -> None
+
+¶
+
+
+
+
+
+
+Exports an object model into a concrete file format.
+ +
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatSummary
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents the summary of the KOSWAT analysis.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs() -> dict[type[ReinforcementProfileProtocol], tuple[float, float]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the infrastructure costs for each profile type +for those locations for which the profile type is selected.
+ +Returns:
+| Type | +Description | +
|---|---|
+ dict[type[ReinforcementProfileProtocol], tuple[float, float]]
+ |
+ dict[type[ReinforcementProfileProtocol], tuple[float, float]]: +infrastructure costs without and with surtax per reinforcement type. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_report_by_profile(profile_type: type[ReinforcementProfileProtocol]) -> MultiLocationProfileCostReport | None
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Get the report for a specific profile type.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
profile_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Type of reinforcement profile. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ MultiLocationProfileCostReport | None
+ |
+ MultiLocationProfileCostReport | None: Report for the profile type. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ BuilderProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+build() -> Any
+
+¶
+
+
+
+
+
+
+
+
+
+
+Instantiates a concrete object to separate its initalization from the data structure.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
Any |
+ Any
+ |
+ Intance of a created object within Koswat domain. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatSummary
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents the summary of the KOSWAT analysis.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs() -> dict[type[ReinforcementProfileProtocol], tuple[float, float]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the infrastructure costs for each profile type +for those locations for which the profile type is selected.
+ +Returns:
+| Type | +Description | +
|---|---|
+ dict[type[ReinforcementProfileProtocol], tuple[float, float]]
+ |
+ dict[type[ReinforcementProfileProtocol], tuple[float, float]]: +infrastructure costs without and with surtax per reinforcement type. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_report_by_profile(profile_type: type[ReinforcementProfileProtocol]) -> MultiLocationProfileCostReport | None
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Get the report for a specific profile type.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
profile_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Type of reinforcement profile. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ MultiLocationProfileCostReport | None
+ |
+ MultiLocationProfileCostReport | None: Report for the profile type. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ PointSurroundings
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Object representing a meter with x, y coordinates in a polder (or else).
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__eq__(__value: object) -> bool
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" equality operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__hash__() -> int
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" hash operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+closest_obstacle: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Distance to the closest (obstacle) surrounding. When no surroundings are given the value will be NaN (Not A Number), so that the value 0 is reserved for buildings at distance 0.
Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Distance to the closest surrounding. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_total_infrastructure_per_zone(*zone_limit_collection: tuple[float, float]) -> list[float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the total infrastructure width at each of the provided zones
+zone_limit_collection (tuple[float, float]).
+The zone limits are matched by rounding up their upper limit to the
+surroundings_matrix keys (distances to the location in the real world).
+When two zones have overlapping limits (as expected) the lower one will
+"claim" the corresponding surrounding distance.
+
+ Example
+-
+
zone_limit_collection= (0, 4), (4, 11)
+surroundings_matrix= {5: 1.5, 10: 3, 15: 6}
+- "Taken" distances per zone:
-
+
(0, 4)takes key5.
+(4, 11)takes key(s)10and15because5was already taken.
+
+ - Total infrastructure width at zones =
(1.5, 9)
+
Returns:
+| Type | +Description | +
|---|---|
+ list[float]
+ |
+ list[float]: list with total width corresponding to each provided zone. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyLocationReinforcement
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents a location and the different reinforcements that can be applied to it +as well their costs. +This class is used to show the final chosen state for a location.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_cost: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Estimates the costs at this location for the given current_selected_measure.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_selected_measure: type[ReinforcementProfileProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Exposes the current selected measure for this object.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs(reinforcement_type: type[ReinforcementProfileProtocol]) -> tuple[float, float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Returns the infrastructure costs for the given reinforcement type (without and with surtax).
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ tuple[float, float]
+ |
+ tuple[float, float]: Tuple containing the infrastructure costs without and with surtax. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_selected_measure_steps() -> tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Outputs the selected measure following the domain (expected) steps: + - Initial step, + - Order step, + - Infrastructure step
+ +Returns:
+| Type | +Description | +
|---|---|
+ tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+ |
+ tuple[ +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol]]: Resulting tuple. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+set_selected_measure(reinforcement_type: type[ReinforcementProfileProtocol], step: StrategyStepEnum)
+
+¶
+
+
+
+
+
+
+
+
+
+
+Changes the value reprsented in current_selected_measure and updates the
+dictionary of selections (history).
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type |
+ + required + | +
step |
+
+ StrategyStepsEnum
+ |
+ Step whose |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ClusterShpFom
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+base_geometry: LineString
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The resulting geometry of all locations excluding the
+profile's width.
Returns:
+| Name | Type | +Description | +
|---|---|---|
LineString |
+ LineString
+ |
+ Geometry representing the cluster coordinates. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_buffered_geometry(width: float) -> LineString
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+The base_geometry with an applied buffer (width) that
+represents the polderside's width.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
width |
+
+ float
+ |
+ Profile's polderside width. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
LineString |
+ LineString
+ |
+ Resulting |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+new_profile_width: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+The new polderside width.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+old_profile_width: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+The original polderside width.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyLocationReinforcement
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents a location and the different reinforcements that can be applied to it +as well their costs. +This class is used to show the final chosen state for a location.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_cost: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Estimates the costs at this location for the given current_selected_measure.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_selected_measure: type[ReinforcementProfileProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Exposes the current selected measure for this object.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs(reinforcement_type: type[ReinforcementProfileProtocol]) -> tuple[float, float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Returns the infrastructure costs for the given reinforcement type (without and with surtax).
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ tuple[float, float]
+ |
+ tuple[float, float]: Tuple containing the infrastructure costs without and with surtax. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_selected_measure_steps() -> tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Outputs the selected measure following the domain (expected) steps: + - Initial step, + - Order step, + - Infrastructure step
+ +Returns:
+| Type | +Description | +
|---|---|
+ tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+ |
+ tuple[ +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol]]: Resulting tuple. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+set_selected_measure(reinforcement_type: type[ReinforcementProfileProtocol], step: StrategyStepEnum)
+
+¶
+
+
+
+
+
+
+
+
+
+
+Changes the value reprsented in current_selected_measure and updates the
+dictionary of selections (history).
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type |
+ + required + | +
step |
+
+ StrategyStepsEnum
+ |
+ Step whose |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ClusterCollectionShpFom
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+from_summary(koswat_summary: KoswatSummary, cluster_criteria: Callable[[StrategyLocationReinforcement], type[ReinforcementProfileProtocol]] = lambda x: x.current_selected_measure) -> ClusterCollectionShpFom
+
+
+ classmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Maps the KoswatSummary into a file object model that can be exported into *.shp files.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
koswat_summary |
+
+ KoswatSummary
+ |
+ The summary containing the information to export. |
+ + required + | +
]) |
+ + | +(Lambda) Function criteria to group the locations by reinforcement type. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
ClusterCollectionShpFom |
+ ClusterCollectionShpFom
+ |
+ Dataclass instance that can be directly exported into |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+generate_geodataframes() -> ClusterGeoDataFrameOutputFom
+
+¶
+
+
+
+
+
+
+
+
+
+
+Generates all geodataframes of the given clusters. The generated geodataframes +correspond to the, base geometry (without buffering), the old and new geometries +with their profile's width being buffered to the base geometry.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
ClusterGeoDataFrameOutputFom |
+ ClusterGeoDataFrameOutputFom
+ |
+ Resulting geodataframes wrapper maping this |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ClusterGeoDataFrameOutputFom
+
+
+¶
+
+
+
+
+
+
+ Bases: FileObjectModelProtocol
Data structure to wrap the output generated by ClusterCollectionShpFom.generate_geodataframes.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+is_valid() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Checks that all GeoDataFrame properties are set.
Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ Validation result. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ClusterShpFom
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+base_geometry: LineString
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The resulting geometry of all locations excluding the
+profile's width.
Returns:
+| Name | Type | +Description | +
|---|---|---|
LineString |
+ LineString
+ |
+ Geometry representing the cluster coordinates. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_buffered_geometry(width: float) -> LineString
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+The base_geometry with an applied buffer (width) that
+represents the polderside's width.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
width |
+
+ float
+ |
+ Profile's polderside width. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
LineString |
+ LineString
+ |
+ Resulting |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+new_profile_width: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+The new polderside width.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+old_profile_width: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+The original polderside width.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatSummary
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents the summary of the KOSWAT analysis.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs() -> dict[type[ReinforcementProfileProtocol], tuple[float, float]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the infrastructure costs for each profile type +for those locations for which the profile type is selected.
+ +Returns:
+| Type | +Description | +
|---|---|
+ dict[type[ReinforcementProfileProtocol], tuple[float, float]]
+ |
+ dict[type[ReinforcementProfileProtocol], tuple[float, float]]: +infrastructure costs without and with surtax per reinforcement type. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_report_by_profile(profile_type: type[ReinforcementProfileProtocol]) -> MultiLocationProfileCostReport | None
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Get the report for a specific profile type.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
profile_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Type of reinforcement profile. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ MultiLocationProfileCostReport | None
+ |
+ MultiLocationProfileCostReport | None: Report for the profile type. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyLocationReinforcement
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents a location and the different reinforcements that can be applied to it +as well their costs. +This class is used to show the final chosen state for a location.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_cost: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Estimates the costs at this location for the given current_selected_measure.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_selected_measure: type[ReinforcementProfileProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Exposes the current selected measure for this object.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs(reinforcement_type: type[ReinforcementProfileProtocol]) -> tuple[float, float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Returns the infrastructure costs for the given reinforcement type (without and with surtax).
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ tuple[float, float]
+ |
+ tuple[float, float]: Tuple containing the infrastructure costs without and with surtax. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_selected_measure_steps() -> tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Outputs the selected measure following the domain (expected) steps: + - Initial step, + - Order step, + - Infrastructure step
+ +Returns:
+| Type | +Description | +
|---|---|
+ tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+ |
+ tuple[ +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol]]: Resulting tuple. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+set_selected_measure(reinforcement_type: type[ReinforcementProfileProtocol], step: StrategyStepEnum)
+
+¶
+
+
+
+
+
+
+
+
+
+
+Changes the value reprsented in current_selected_measure and updates the
+dictionary of selections (history).
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type |
+ + required + | +
step |
+
+ StrategyStepsEnum
+ |
+ Step whose |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ClusterGeoDataFrameOutputFom
+
+
+¶
+
+
+
+
+
+
+ Bases: FileObjectModelProtocol
Data structure to wrap the output generated by ClusterCollectionShpFom.generate_geodataframes.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+is_valid() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Checks that all GeoDataFrame properties are set.
Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ Validation result. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ FileObjectModelProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+is_valid() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Verifies if the current object is valid for import / export.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ Result of the validation. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ClusterCollectionShpFom
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+from_summary(koswat_summary: KoswatSummary, cluster_criteria: Callable[[StrategyLocationReinforcement], type[ReinforcementProfileProtocol]] = lambda x: x.current_selected_measure) -> ClusterCollectionShpFom
+
+
+ classmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Maps the KoswatSummary into a file object model that can be exported into *.shp files.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
koswat_summary |
+
+ KoswatSummary
+ |
+ The summary containing the information to export. |
+ + required + | +
]) |
+ + | +(Lambda) Function criteria to group the locations by reinforcement type. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
ClusterCollectionShpFom |
+ ClusterCollectionShpFom
+ |
+ Dataclass instance that can be directly exported into |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+generate_geodataframes() -> ClusterGeoDataFrameOutputFom
+
+¶
+
+
+
+
+
+
+
+
+
+
+Generates all geodataframes of the given clusters. The generated geodataframes +correspond to the, base geometry (without buffering), the old and new geometries +with their profile's width being buffered to the base geometry.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
ClusterGeoDataFrameOutputFom |
+ ClusterGeoDataFrameOutputFom
+ |
+ Resulting geodataframes wrapper maping this |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatExporterProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export(**kwargs) -> None
+
+¶
+
+
+
+
+
+
+Exports an object model into a concrete file format.
+ +
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatSummary
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents the summary of the KOSWAT analysis.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs() -> dict[type[ReinforcementProfileProtocol], tuple[float, float]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the infrastructure costs for each profile type +for those locations for which the profile type is selected.
+ +Returns:
+| Type | +Description | +
|---|---|
+ dict[type[ReinforcementProfileProtocol], tuple[float, float]]
+ |
+ dict[type[ReinforcementProfileProtocol], tuple[float, float]]: +infrastructure costs without and with surtax per reinforcement type. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_report_by_profile(profile_type: type[ReinforcementProfileProtocol]) -> MultiLocationProfileCostReport | None
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Get the report for a specific profile type.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
profile_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Type of reinforcement profile. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ MultiLocationProfileCostReport | None
+ |
+ MultiLocationProfileCostReport | None: Report for the profile type. |
+
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_docstrings/dike/layers.html b/reference/koswat_docstrings/dike/layers.html
new file mode 100644
index 00000000..68d0b3eb
--- /dev/null
+++ b/reference/koswat_docstrings/dike/layers.html
@@ -0,0 +1,1006 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Dike layers module.¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ BuilderProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+build() -> Any
+
+¶
+
+
+
+
+
+
+
+
+
+
+Instantiates a concrete object to separate its initalization from the data structure.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
Any |
+ Any
+ |
+ Intance of a created object within Koswat domain. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayerBuilderProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: BuilderProtocol, Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+build() -> KoswatLayerProtocol
+
+¶
+
+
+
+
+
+
+
+
+
+
+Builds an instance of a KoswatLayerProtocol based on the provided upper_linestring and layer_data
Returns:
+| Name | Type | +Description | +
|---|---|---|
KoswatLayerProtocol |
+ KoswatLayerProtocol
+ |
+ Valid instance of a |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayerProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+as_data_dict() -> dict
+
+¶
+
+
+
+
+
+
+
+
+
+
+Returns the information related to an instance of the KoswatLayerProtocol.
Returns:
+| Name | Type | +Description | +
|---|---|---|
dict |
+ dict
+ |
+ custom dictionary with the relevant data. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayerProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+as_data_dict() -> dict
+
+¶
+
+
+
+
+
+
+
+
+
+
+Returns the information related to an instance of the KoswatLayerProtocol.
Returns:
+| Name | Type | +Description | +
|---|---|---|
dict |
+ dict
+ |
+ custom dictionary with the relevant data. |
+
Layers wrapper¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ BuilderProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+build() -> Any
+
+¶
+
+
+
+
+
+
+
+
+
+
+Instantiates a concrete object to separate its initalization from the data structure.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
Any |
+ Any
+ |
+ Intance of a created object within Koswat domain. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayersWrapperBuilderProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: BuilderProtocol, Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+build() -> KoswatLayersWrapperProtocol
+
+¶
+
+
+
+
+
+
+
+
+
+
+Builds an instance of KoswatLayersWrapperProtocol based on the class required fields layers_data and profile_points.
Returns:
+| Name | Type | +Description | +
|---|---|---|
KoswatLayersWrapperProtocol |
+ KoswatLayersWrapperProtocol
+ |
+ Valid initialized instance of a |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayersWrapperProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+as_data_dict() -> dict
+
+¶
+
+
+
+
+
+
+
+
+
+
+Returns the layers as a dictionary.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
dict |
+ dict
+ |
+ Dictionary containing all the information of the wrapper layers ( |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayerProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+as_data_dict() -> dict
+
+¶
+
+
+
+
+
+
+
+
+
+
+Returns the information related to an instance of the KoswatLayerProtocol.
Returns:
+| Name | Type | +Description | +
|---|---|---|
dict |
+ dict
+ |
+ custom dictionary with the relevant data. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayersWrapperProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+as_data_dict() -> dict
+
+¶
+
+
+
+
+
+
+
+
+
+
+Returns the layers as a dictionary.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
dict |
+ dict
+ |
+ Dictionary containing all the information of the wrapper layers ( |
+
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_docstrings/dike/profile.html b/reference/koswat_docstrings/dike/profile.html
new file mode 100644
index 00000000..4e3f062d
--- /dev/null
+++ b/reference/koswat_docstrings/dike/profile.html
@@ -0,0 +1,493 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Koswat dike profile module¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayersWrapper
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatLayersWrapperProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+layers: List[KoswatLayerProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+All the stored layers being the KoswatBaseLayer the latest one in the collection.
Returns:
+| Type | +Description | +
|---|---|
+ List[KoswatLayerProtocol]
+ |
+ List[KoswatLayerProtocol]: Ordered list of |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatProfileBase
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol
Basic definition and implementation of a KoswatProfileProtocol. It represents the initial koswat profile being provided by the user from which further calculations will be made.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+points: list[Point]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The combination of points from both water and polder sides.
+ +Returns:
+| Type | +Description | +
|---|---|
+ list[Point]
+ |
+ list[Point]: A total of eight points comforming the |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+profile_height: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The profile highest point (largest y-coordinate).
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Greatest y-coordinate. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+profile_width: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The profile extent from the lowest (left-most) x-coordinate to the largest (right-most) x-coordinate from a dike geometry polygon.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Total distance. |
+
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_docstrings/dike/surroundings.html b/reference/koswat_docstrings/dike/surroundings.html
new file mode 100644
index 00000000..d8ddae76
--- /dev/null
+++ b/reference/koswat_docstrings/dike/surroundings.html
@@ -0,0 +1,2733 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Koswat dike surroundings¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatSurroundingsProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
Empty interface to represent the Koswat surroundings and easily identify them throughout the solution.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ PointSurroundings
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Object representing a meter with x, y coordinates in a polder (or else).
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__eq__(__value: object) -> bool
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" equality operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__hash__() -> int
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" hash operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+closest_obstacle: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Distance to the closest (obstacle) surrounding. When no surroundings are given the value will be NaN (Not A Number), so that the value 0 is reserved for buildings at distance 0.
Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Distance to the closest surrounding. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_total_infrastructure_per_zone(*zone_limit_collection: tuple[float, float]) -> list[float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the total infrastructure width at each of the provided zones
+zone_limit_collection (tuple[float, float]).
+The zone limits are matched by rounding up their upper limit to the
+surroundings_matrix keys (distances to the location in the real world).
+When two zones have overlapping limits (as expected) the lower one will
+"claim" the corresponding surrounding distance.
+
+ Example
+-
+
zone_limit_collection= (0, 4), (4, 11)
+surroundings_matrix= {5: 1.5, 10: 3, 15: 6}
+- "Taken" distances per zone:
-
+
(0, 4)takes key5.
+(4, 11)takes key(s)10and15because5was already taken.
+
+ - Total infrastructure width at zones =
(1.5, 9)
+
Returns:
+| Type | +Description | +
|---|---|
+ list[float]
+ |
+ list[float]: list with total width corresponding to each provided zone. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatSurroundingsProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
Empty interface to represent the Koswat surroundings and easily identify them throughout the solution.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ PointSurroundings
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Object representing a meter with x, y coordinates in a polder (or else).
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__eq__(__value: object) -> bool
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" equality operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__hash__() -> int
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" hash operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+closest_obstacle: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Distance to the closest (obstacle) surrounding. When no surroundings are given the value will be NaN (Not A Number), so that the value 0 is reserved for buildings at distance 0.
Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Distance to the closest surrounding. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_total_infrastructure_per_zone(*zone_limit_collection: tuple[float, float]) -> list[float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the total infrastructure width at each of the provided zones
+zone_limit_collection (tuple[float, float]).
+The zone limits are matched by rounding up their upper limit to the
+surroundings_matrix keys (distances to the location in the real world).
+When two zones have overlapping limits (as expected) the lower one will
+"claim" the corresponding surrounding distance.
+
+ Example
+-
+
zone_limit_collection= (0, 4), (4, 11)
+surroundings_matrix= {5: 1.5, 10: 3, 15: 6}
+- "Taken" distances per zone:
-
+
(0, 4)takes key5.
+(4, 11)takes key(s)10and15because5was already taken.
+
+ - Total infrastructure width at zones =
(1.5, 9)
+
Returns:
+| Type | +Description | +
|---|---|
+ list[float]
+ |
+ list[float]: list with total width corresponding to each provided zone. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ SurroundingsInfrastructure
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatSurroundingsProtocol
Defines surroundings point collections that can be repaired or replaced.
+The PointSurroundings contain a matrix (dictionary) where the keys
+represent the distances to an obstacle, and the values a float representing
+how long that infrastructure is.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatSurroundingsProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
Empty interface to represent the Koswat surroundings and easily identify them throughout the solution.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ PointSurroundings
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Object representing a meter with x, y coordinates in a polder (or else).
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__eq__(__value: object) -> bool
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" equality operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__hash__() -> int
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" hash operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+closest_obstacle: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Distance to the closest (obstacle) surrounding. When no surroundings are given the value will be NaN (Not A Number), so that the value 0 is reserved for buildings at distance 0.
Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Distance to the closest surrounding. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_total_infrastructure_per_zone(*zone_limit_collection: tuple[float, float]) -> list[float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the total infrastructure width at each of the provided zones
+zone_limit_collection (tuple[float, float]).
+The zone limits are matched by rounding up their upper limit to the
+surroundings_matrix keys (distances to the location in the real world).
+When two zones have overlapping limits (as expected) the lower one will
+"claim" the corresponding surrounding distance.
+
+ Example
+-
+
zone_limit_collection= (0, 4), (4, 11)
+surroundings_matrix= {5: 1.5, 10: 3, 15: 6}
+- "Taken" distances per zone:
-
+
(0, 4)takes key5.
+(4, 11)takes key(s)10and15because5was already taken.
+
+ - Total infrastructure width at zones =
(1.5, 9)
+
Returns:
+| Type | +Description | +
|---|---|
+ list[float]
+ |
+ list[float]: list with total width corresponding to each provided zone. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ SurroundingsObstacle
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatSurroundingsProtocol
Defines surroundings point collections that cannot be repaired or replaced.
+The PointSurroundings contain a matrix (dictionary) where the keys
+represent the distances to an obstacle, and the values a 1 (obstacle present)
+or a 0 (obstacle not present).
+
+
+
+
+
+
+
+ Point¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ PointSurroundings
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Object representing a meter with x, y coordinates in a polder (or else).
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__eq__(__value: object) -> bool
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" equality operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__hash__() -> int
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" hash operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+closest_obstacle: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Distance to the closest (obstacle) surrounding. When no surroundings are given the value will be NaN (Not A Number), so that the value 0 is reserved for buildings at distance 0.
Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Distance to the closest surrounding. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_total_infrastructure_per_zone(*zone_limit_collection: tuple[float, float]) -> list[float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the total infrastructure width at each of the provided zones
+zone_limit_collection (tuple[float, float]).
+The zone limits are matched by rounding up their upper limit to the
+surroundings_matrix keys (distances to the location in the real world).
+When two zones have overlapping limits (as expected) the lower one will
+"claim" the corresponding surrounding distance.
+
+ Example
+-
+
zone_limit_collection= (0, 4), (4, 11)
+surroundings_matrix= {5: 1.5, 10: 3, 15: 6}
+- "Taken" distances per zone:
-
+
(0, 4)takes key5.
+(4, 11)takes key(s)10and15because5was already taken.
+
+ - Total infrastructure width at zones =
(1.5, 9)
+
Returns:
+| Type | +Description | +
|---|---|
+ list[float]
+ |
+ list[float]: list with total width corresponding to each provided zone. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ BuilderProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+build() -> Any
+
+¶
+
+
+
+
+
+
+
+
+
+
+Instantiates a concrete object to separate its initalization from the data structure.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
Any |
+ Any
+ |
+ Intance of a created object within Koswat domain. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ PointSurroundings
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Object representing a meter with x, y coordinates in a polder (or else).
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__eq__(__value: object) -> bool
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" equality operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__hash__() -> int
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" hash operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+closest_obstacle: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Distance to the closest (obstacle) surrounding. When no surroundings are given the value will be NaN (Not A Number), so that the value 0 is reserved for buildings at distance 0.
Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Distance to the closest surrounding. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_total_infrastructure_per_zone(*zone_limit_collection: tuple[float, float]) -> list[float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the total infrastructure width at each of the provided zones
+zone_limit_collection (tuple[float, float]).
+The zone limits are matched by rounding up their upper limit to the
+surroundings_matrix keys (distances to the location in the real world).
+When two zones have overlapping limits (as expected) the lower one will
+"claim" the corresponding surrounding distance.
+
+ Example
+-
+
zone_limit_collection= (0, 4), (4, 11)
+surroundings_matrix= {5: 1.5, 10: 3, 15: 6}
+- "Taken" distances per zone:
-
+
(0, 4)takes key5.
+(4, 11)takes key(s)10and15because5was already taken.
+
+ - Total infrastructure width at zones =
(1.5, 9)
+
Returns:
+| Type | +Description | +
|---|---|
+ list[float]
+ |
+ list[float]: list with total width corresponding to each provided zone. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ PointSurroundingsListPoldersideBuilder
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: BuilderProtocol
Builds a collection of points (list[PointSurroundings]) given the dike locations
+(KoswatDikeLocationsShpFom) and the surroundings around it
+(KoswatSurroundingsCsvFom).
+
+
+
+
+
+
+
+ Wrapper¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ObstacleSurroundingsWrapper
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: BaseSurroundingsWrapper
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_locations_at_safe_distance(distance: float) -> list[PointSurroundings]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Gets all locations which are safe from obstacle surroundings in a radius of distance.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
distance |
+
+ float
+ |
+ Radius from each point that should be free of surroundings. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ list[PointSurroundings]
+ |
+ list[PointSurroundings]: List of safe locations (points with surroundings). |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+obstacle_locations: list[PointSurroundings]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Overlay of locations of the different ObstacleSurroundings that are present.
+Buildings need to be present as input (leading for location coordinates).
+Each location represents 1 meter in a real scale map.
Returns:
+| Type | +Description | +
|---|---|
+ list[PointSurroundings]
+ |
+ list[PointSurroundings]: List of locations with only the closest distance to obstacle(s). |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ PointSurroundings
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Object representing a meter with x, y coordinates in a polder (or else).
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__eq__(__value: object) -> bool
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" equality operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__hash__() -> int
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" hash operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+closest_obstacle: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Distance to the closest (obstacle) surrounding. When no surroundings are given the value will be NaN (Not A Number), so that the value 0 is reserved for buildings at distance 0.
Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Distance to the closest surrounding. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_total_infrastructure_per_zone(*zone_limit_collection: tuple[float, float]) -> list[float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the total infrastructure width at each of the provided zones
+zone_limit_collection (tuple[float, float]).
+The zone limits are matched by rounding up their upper limit to the
+surroundings_matrix keys (distances to the location in the real world).
+When two zones have overlapping limits (as expected) the lower one will
+"claim" the corresponding surrounding distance.
+
+ Example
+-
+
zone_limit_collection= (0, 4), (4, 11)
+surroundings_matrix= {5: 1.5, 10: 3, 15: 6}
+- "Taken" distances per zone:
-
+
(0, 4)takes key5.
+(4, 11)takes key(s)10and15because5was already taken.
+
+ - Total infrastructure width at zones =
(1.5, 9)
+
Returns:
+| Type | +Description | +
|---|---|
+ list[float]
+ |
+ list[float]: list with total width corresponding to each provided zone. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ SurroundingsWrapper
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_locations_at_safe_distance(distance: float) -> list[PointSurroundings]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Gets all locations which are safe from obstacle surroundings in a radius of distance.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
distance |
+
+ float
+ |
+ Radius from each point that should be free of surroundings. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ list[PointSurroundings]
+ |
+ List[PointSurroundings]: List of safe locations (points with surroundings). |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ BaseSurroundingsWrapper
+
+
+¶
+
+
+
+
+
+
+ Bases: ABC
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+surroundings_collection: dict[str, KoswatSurroundingsProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The collection of KoswatSurroundingsProtocol objects that are considered for a scenario analysis.
Returns:
+| Type | +Description | +
|---|---|
+ dict[str, KoswatSurroundingsProtocol]
+ |
+ dict[str, KoswatSurroundingsProtocol]: Collection of surroundings to include in analysis. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ SurroundingsInfrastructure
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatSurroundingsProtocol
Defines surroundings point collections that can be repaired or replaced.
+The PointSurroundings contain a matrix (dictionary) where the keys
+represent the distances to an obstacle, and the values a float representing
+how long that infrastructure is.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ BaseSurroundingsWrapper
+
+
+¶
+
+
+
+
+
+
+ Bases: ABC
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+surroundings_collection: dict[str, KoswatSurroundingsProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The collection of KoswatSurroundingsProtocol objects that are considered for a scenario analysis.
Returns:
+| Type | +Description | +
|---|---|
+ dict[str, KoswatSurroundingsProtocol]
+ |
+ dict[str, KoswatSurroundingsProtocol]: Collection of surroundings to include in analysis. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ObstacleSurroundingsWrapper
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: BaseSurroundingsWrapper
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_locations_at_safe_distance(distance: float) -> list[PointSurroundings]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Gets all locations which are safe from obstacle surroundings in a radius of distance.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
distance |
+
+ float
+ |
+ Radius from each point that should be free of surroundings. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ list[PointSurroundings]
+ |
+ list[PointSurroundings]: List of safe locations (points with surroundings). |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+obstacle_locations: list[PointSurroundings]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Overlay of locations of the different ObstacleSurroundings that are present.
+Buildings need to be present as input (leading for location coordinates).
+Each location represents 1 meter in a real scale map.
Returns:
+| Type | +Description | +
|---|---|
+ list[PointSurroundings]
+ |
+ list[PointSurroundings]: List of locations with only the closest distance to obstacle(s). |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ PointSurroundings
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Object representing a meter with x, y coordinates in a polder (or else).
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__eq__(__value: object) -> bool
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" equality operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__hash__() -> int
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" hash operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+closest_obstacle: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Distance to the closest (obstacle) surrounding. When no surroundings are given the value will be NaN (Not A Number), so that the value 0 is reserved for buildings at distance 0.
Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Distance to the closest surrounding. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_total_infrastructure_per_zone(*zone_limit_collection: tuple[float, float]) -> list[float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the total infrastructure width at each of the provided zones
+zone_limit_collection (tuple[float, float]).
+The zone limits are matched by rounding up their upper limit to the
+surroundings_matrix keys (distances to the location in the real world).
+When two zones have overlapping limits (as expected) the lower one will
+"claim" the corresponding surrounding distance.
+
+ Example
+-
+
zone_limit_collection= (0, 4), (4, 11)
+surroundings_matrix= {5: 1.5, 10: 3, 15: 6}
+- "Taken" distances per zone:
-
+
(0, 4)takes key5.
+(4, 11)takes key(s)10and15because5was already taken.
+
+ - Total infrastructure width at zones =
(1.5, 9)
+
Returns:
+| Type | +Description | +
|---|---|
+ list[float]
+ |
+ list[float]: list with total width corresponding to each provided zone. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ SurroundingsObstacle
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatSurroundingsProtocol
Defines surroundings point collections that cannot be repaired or replaced.
+The PointSurroundings contain a matrix (dictionary) where the keys
+represent the distances to an obstacle, and the values a 1 (obstacle present)
+or a 0 (obstacle not present).
+
+
+
+
+
+
+
+
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_docstrings/dike_reinforcements/reinforcement_layers.html b/reference/koswat_docstrings/dike_reinforcements/reinforcement_layers.html
new file mode 100644
index 00000000..80a345ea
--- /dev/null
+++ b/reference/koswat_docstrings/dike_reinforcements/reinforcement_layers.html
@@ -0,0 +1,2291 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Reinforcement Layers Wrapper¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayerProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+as_data_dict() -> dict
+
+¶
+
+
+
+
+
+
+
+
+
+
+Returns the information related to an instance of the KoswatLayerProtocol.
Returns:
+| Name | Type | +Description | +
|---|---|---|
dict |
+ dict
+ |
+ custom dictionary with the relevant data. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_polygon_coordinates(pol_geometry: geometry.Polygon | geometry.MultiPolygon) -> geometry.LineString
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Given a single or multi geometry returns the coordinates composing its outer layout.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
pol_geometry |
+
+ geometry.Polygon | geometry.MultiPolygon
+ |
+ Source geometry. |
+ + required + | +
Raises:
+| Type | +Description | +
|---|---|
+ NotImplementedError
+ |
+ When the provided geometry is not yet supported. |
+
Returns:
+| Type | +Description | +
|---|---|
+ geometry.LineString
+ |
+ geometry.LineString: Set of points composing the outer layout of the geometry. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementCoatingLayer
+
+
+¶
+
+
+
+
+
+
+ Bases: ReinforcementLayerProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+with_same_outer_geometry(coating_layer: KoswatCoatingLayer) -> ReinforcementCoatingLayer
+
+
+ classmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Creates a new reinforcement coating layer which does not differ +in geometry from the provided coating layer. This was found to +be needed in KOSWAT_82.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
coating_layer |
+
+ KoswatCoatingLayer
+ |
+ Base coating layer. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
ReinforcementCoatingLayer |
+ ReinforcementCoatingLayer
+ |
+ Resulting coating layer with "empty" |
+
+ ReinforcementCoatingLayer
+ |
+ polygons for added / removed (layer) geometries. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_polygon_coordinates(pol_geometry: geometry.Polygon | geometry.MultiPolygon) -> geometry.LineString
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Given a single or multi geometry returns the coordinates composing its outer layout.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
pol_geometry |
+
+ geometry.Polygon | geometry.MultiPolygon
+ |
+ Source geometry. |
+ + required + | +
Raises:
+| Type | +Description | +
|---|---|
+ NotImplementedError
+ |
+ When the provided geometry is not yet supported. |
+
Returns:
+| Type | +Description | +
|---|---|
+ geometry.LineString
+ |
+ geometry.LineString: Set of points composing the outer layout of the geometry. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayersWrapperProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+as_data_dict() -> dict
+
+¶
+
+
+
+
+
+
+
+
+
+
+Returns the layers as a dictionary.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
dict |
+ dict
+ |
+ Dictionary containing all the information of the wrapper layers ( |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementCoatingLayer
+
+
+¶
+
+
+
+
+
+
+ Bases: ReinforcementLayerProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+with_same_outer_geometry(coating_layer: KoswatCoatingLayer) -> ReinforcementCoatingLayer
+
+
+ classmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Creates a new reinforcement coating layer which does not differ +in geometry from the provided coating layer. This was found to +be needed in KOSWAT_82.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
coating_layer |
+
+ KoswatCoatingLayer
+ |
+ Base coating layer. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
ReinforcementCoatingLayer |
+ ReinforcementCoatingLayer
+ |
+ Resulting coating layer with "empty" |
+
+ ReinforcementCoatingLayer
+ |
+ polygons for added / removed (layer) geometries. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementLayersWrapper
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatLayersWrapperProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+layers: list[ReinforcementLayerProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+All the stored layers being the KoswatBaseLayer the latest one in the collection.
Returns:
+| Type | +Description | +
|---|---|
+ list[ReinforcementLayerProtocol]
+ |
+ List[KoswatLayerProtocol]: Ordered list of |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayerProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+as_data_dict() -> dict
+
+¶
+
+
+
+
+
+
+
+
+
+
+Returns the information related to an instance of the KoswatLayerProtocol.
Returns:
+| Name | Type | +Description | +
|---|---|---|
dict |
+ dict
+ |
+ custom dictionary with the relevant data. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayersWrapperBuilderProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: BuilderProtocol, Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+build() -> KoswatLayersWrapperProtocol
+
+¶
+
+
+
+
+
+
+
+
+
+
+Builds an instance of KoswatLayersWrapperProtocol based on the class required fields layers_data and profile_points.
Returns:
+| Name | Type | +Description | +
|---|---|---|
KoswatLayersWrapperProtocol |
+ KoswatLayersWrapperProtocol
+ |
+ Valid initialized instance of a |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayersWrapperProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+as_data_dict() -> dict
+
+¶
+
+
+
+
+
+
+
+
+
+
+Returns the layers as a dictionary.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
dict |
+ dict
+ |
+ Dictionary containing all the information of the wrapper layers ( |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ OutsideSlopeReinforcementLayersWrapperBuilder
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatLayersWrapperBuilderProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementCoatingLayer
+
+
+¶
+
+
+
+
+
+
+ Bases: ReinforcementLayerProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+with_same_outer_geometry(coating_layer: KoswatCoatingLayer) -> ReinforcementCoatingLayer
+
+
+ classmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Creates a new reinforcement coating layer which does not differ +in geometry from the provided coating layer. This was found to +be needed in KOSWAT_82.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
coating_layer |
+
+ KoswatCoatingLayer
+ |
+ Base coating layer. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
ReinforcementCoatingLayer |
+ ReinforcementCoatingLayer
+ |
+ Resulting coating layer with "empty" |
+
+ ReinforcementCoatingLayer
+ |
+ polygons for added / removed (layer) geometries. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementLayersWrapper
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatLayersWrapperProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+layers: list[ReinforcementLayerProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+All the stored layers being the KoswatBaseLayer the latest one in the collection.
Returns:
+| Type | +Description | +
|---|---|
+ list[ReinforcementLayerProtocol]
+ |
+ List[KoswatLayerProtocol]: Ordered list of |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_polygon_surface_points(base_geometry: geometry.Polygon | geometry.MultiPolygon) -> geometry.LineString
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Gets all the points composing the upper surface of a 'dike' geometry.
+IMPORTANT! The calling of this method assumes the base_geometry points are in order, call order_geometry_points if needed.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
base_geometry |
+
+ Union[geometry.Polygon, geometry.MultiPolygon]
+ |
+ Source geometry. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ geometry.LineString
+ |
+ geometry.LineString: Resulting line with points from the outer geometry. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayerProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+as_data_dict() -> dict
+
+¶
+
+
+
+
+
+
+
+
+
+
+Returns the information related to an instance of the KoswatLayerProtocol.
Returns:
+| Name | Type | +Description | +
|---|---|---|
dict |
+ dict
+ |
+ custom dictionary with the relevant data. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayersWrapperBuilderProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: BuilderProtocol, Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+build() -> KoswatLayersWrapperProtocol
+
+¶
+
+
+
+
+
+
+
+
+
+
+Builds an instance of KoswatLayersWrapperProtocol based on the class required fields layers_data and profile_points.
Returns:
+| Name | Type | +Description | +
|---|---|---|
KoswatLayersWrapperProtocol |
+ KoswatLayersWrapperProtocol
+ |
+ Valid initialized instance of a |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayersWrapperProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+as_data_dict() -> dict
+
+¶
+
+
+
+
+
+
+
+
+
+
+Returns the layers as a dictionary.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
dict |
+ dict
+ |
+ Dictionary containing all the information of the wrapper layers ( |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementCoatingLayer
+
+
+¶
+
+
+
+
+
+
+ Bases: ReinforcementLayerProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+with_same_outer_geometry(coating_layer: KoswatCoatingLayer) -> ReinforcementCoatingLayer
+
+
+ classmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Creates a new reinforcement coating layer which does not differ +in geometry from the provided coating layer. This was found to +be needed in KOSWAT_82.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
coating_layer |
+
+ KoswatCoatingLayer
+ |
+ Base coating layer. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
ReinforcementCoatingLayer |
+ ReinforcementCoatingLayer
+ |
+ Resulting coating layer with "empty" |
+
+ ReinforcementCoatingLayer
+ |
+ polygons for added / removed (layer) geometries. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementLayersWrapper
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatLayersWrapperProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+layers: list[ReinforcementLayerProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+All the stored layers being the KoswatBaseLayer the latest one in the collection.
Returns:
+| Type | +Description | +
|---|---|
+ list[ReinforcementLayerProtocol]
+ |
+ List[KoswatLayerProtocol]: Ordered list of |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StandardReinforcementLayersWrapperBuilder
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatLayersWrapperBuilderProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+as_unified_geometry(source_geom: geometry.Polygon | geometry.MultiPolygon) -> geometry.Polygon
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Ensures the calculated geometry is returned as a single polygon.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
source_geom |
+
+ geometry.Polygon | geometry.MultiPolygon
+ |
+ Calculated source geometry. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ geometry.Polygon
+ |
+ geometry.Polygon: Unified resulting geometry with its points ordered (first one is the most-left x coordinate). |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_normalized_polygon_difference(left_geom: geometry.Polygon, right_geom: geometry.Polygon) -> geometry.Polygon | geometry.MultiPolygon
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Given two polygons calculates the difference between them and removes any residual polygon due to minor precision errors.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
left_geom |
+
+ geometry.Polygon
+ |
+ Base polygon from where to substract. |
+ + required + | +
right_geom |
+
+ geometry.Polygon
+ |
+ Polygon to substract from base. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ geometry.Polygon | geometry.MultiPolygon
+ |
+ geometry.Polygon: Resulting normalized substraction polygon. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_polygon_surface_points(base_geometry: geometry.Polygon | geometry.MultiPolygon) -> geometry.LineString
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Gets all the points composing the upper surface of a 'dike' geometry.
+IMPORTANT! The calling of this method assumes the base_geometry points are in order, call order_geometry_points if needed.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
base_geometry |
+
+ Union[geometry.Polygon, geometry.MultiPolygon]
+ |
+ Source geometry. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ geometry.LineString
+ |
+ geometry.LineString: Resulting line with points from the outer geometry. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_relative_core_layer(core_geometry: geometry.Polygon, coating_geometry: geometry.Polygon) -> geometry.Polygon
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Returns a new 'core' from the original core_geometry relative to the coating_geometry.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
core_geometry |
+
+ Polygon
+ |
+ Original core geometry on which layers are stacked upon. |
+ + required + | +
coating_geometry |
+
+ Polygon
+ |
+ Layer wrapping the exterior of a core geometry. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
Polygon |
+ geometry.Polygon
+ |
+ Layer wrapping a reduced surface of the |
+
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_docstrings/dike_reinforcements/reinforcement_profile.html b/reference/koswat_docstrings/dike_reinforcements/reinforcement_profile.html
new file mode 100644
index 00000000..8e800d84
--- /dev/null
+++ b/reference/koswat_docstrings/dike_reinforcements/reinforcement_profile.html
@@ -0,0 +1,4102 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Reinforcement profile¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatProfileBase
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol
Basic definition and implementation of a KoswatProfileProtocol. It represents the initial koswat profile being provided by the user from which further calculations will be made.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+points: list[Point]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The combination of points from both water and polder sides.
+ +Returns:
+| Type | +Description | +
|---|---|
+ list[Point]
+ |
+ list[Point]: A total of eight points comforming the |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+profile_height: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The profile highest point (largest y-coordinate).
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Greatest y-coordinate. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+profile_width: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The profile extent from the lowest (left-most) x-coordinate to the largest (right-most) x-coordinate from a dike geometry polygon.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Total distance. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementInputProfileCalculationProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: BuilderProtocol, Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+build() -> ReinforcementInputProfileProtocol
+
+¶
+
+
+
+
+
+
+
+
+
+
+Builds a ReinforcementInputProfileProtocol instance based on the base_profile and scenario specified in this class.
Returns:
+| Name | Type | +Description | +
|---|---|---|
ReinforcementInputProfileProtocol |
+ ReinforcementInputProfileProtocol
+ |
+ Calculated reinforcement input profile. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementInputProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatInputProfileProtocol, Protocol
Just an alias to distinguish from a regular KoswatInputProfileProtocol.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+reinforcement_domain_name: str
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Returns the representative name in the "real" world of this reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementLayersWrapper
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatLayersWrapperProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+layers: list[ReinforcementLayerProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+All the stored layers being the KoswatBaseLayer the latest one in the collection.
Returns:
+| Type | +Description | +
|---|---|
+ list[ReinforcementLayerProtocol]
+ |
+ List[KoswatLayerProtocol]: Ordered list of |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileBuilderProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: BuilderProtocol, Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+build() -> ReinforcementProfileProtocol
+
+¶
+
+
+
+
+
+
+
+
+
+
+Builds a concrete instance of a ReinforcementProfileProtocol based on the required data.
Returns:
+| Name | Type | +Description | +
|---|---|---|
ReinforcementProfileProtocol |
+ ReinforcementProfileProtocol
+ |
+ Valid instance of a |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatProfileBase
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol
Basic definition and implementation of a KoswatProfileProtocol. It represents the initial koswat profile being provided by the user from which further calculations will be made.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+points: list[Point]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The combination of points from both water and polder sides.
+ +Returns:
+| Type | +Description | +
|---|---|
+ list[Point]
+ |
+ list[Point]: A total of eight points comforming the |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+profile_height: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The profile highest point (largest y-coordinate).
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Greatest y-coordinate. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+profile_width: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The profile extent from the lowest (left-most) x-coordinate to the largest (right-most) x-coordinate from a dike geometry polygon.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Total distance. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileBuilderFactory
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_available_reinforcements() -> list[ReinforcementProfileProtocol]
+
+
+ staticmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets all available reinforcements defined in Koswat.
+ +Returns:
+| Type | +Description | +
|---|---|
+ list[ReinforcementProfileProtocol]
+ |
+ List[ReinforcementProfileProtocol]: List of reinforcement profile protocols types. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_reinforcement_builder(reinforcement_profile_type: type[ReinforcementProfileProtocol]) -> ReinforcementProfileBuilderProtocol
+
+
+ staticmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Gets a valid reinforcement profile builder instance (ReinforcementProfileBuilderProtocol).
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_profile_type |
+
+ Type[ReinforcementProfileProtocol]
+ |
+ Type that requires a builder. |
+ + required + | +
Raises:
+| Type | +Description | +
|---|---|
+ NotImplementedError
+ |
+ When there is no builder associated to the given |
+
Returns:
+| Name | Type | +Description | +
|---|---|---|
ReinforcementProfileBuilderProtocol |
+ ReinforcementProfileBuilderProtocol
+ |
+ Valid instance of a |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileBuilderProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: BuilderProtocol, Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+build() -> ReinforcementProfileProtocol
+
+¶
+
+
+
+
+
+
+
+
+
+
+Builds a concrete instance of a ReinforcementProfileProtocol based on the required data.
Returns:
+| Name | Type | +Description | +
|---|---|---|
ReinforcementProfileProtocol |
+ ReinforcementProfileProtocol
+ |
+ Valid instance of a |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StandardReinforcementProfileBuilder
+
+
+¶
+
+
+
+
+
+
+ Bases: ReinforcementProfileBuilderBase
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_input_profile_calculator(reinforcement_type: type[StandardReinforcementProfile]) -> ReinforcementInputProfileCalculationProtocol
+
+
+ staticmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Get the input profile calculator for the given reinforcement type.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[StandardReinforcementProfile]
+ |
+ The reinforcement type. |
+ + required + | +
Raises:
+| Type | +Description | +
|---|---|
+ NotImplementedError
+ |
+ The given reinforcement type is not supported. |
+
Returns:
+| Name | Type | +Description | +
|---|---|---|
ReinforcementInputProfileCalculationProtocol |
+ ReinforcementInputProfileCalculationProtocol
+ |
+ The input profile calculator. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ BuilderProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+build() -> Any
+
+¶
+
+
+
+
+
+
+
+
+
+
+Instantiates a concrete object to separate its initalization from the data structure.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
Any |
+ Any
+ |
+ Intance of a created object within Koswat domain. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatProfileBase
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol
Basic definition and implementation of a KoswatProfileProtocol. It represents the initial koswat profile being provided by the user from which further calculations will be made.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+points: list[Point]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The combination of points from both water and polder sides.
+ +Returns:
+| Type | +Description | +
|---|---|
+ list[Point]
+ |
+ list[Point]: A total of eight points comforming the |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+profile_height: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The profile highest point (largest y-coordinate).
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Greatest y-coordinate. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+profile_width: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The profile extent from the lowest (left-most) x-coordinate to the largest (right-most) x-coordinate from a dike geometry polygon.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Total distance. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileBuilderProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: BuilderProtocol, Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+build() -> ReinforcementProfileProtocol
+
+¶
+
+
+
+
+
+
+
+
+
+
+Builds a concrete instance of a ReinforcementProfileProtocol based on the required data.
Returns:
+| Name | Type | +Description | +
|---|---|---|
ReinforcementProfileProtocol |
+ ReinforcementProfileProtocol
+ |
+ Valid instance of a |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementInputProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatInputProfileProtocol, Protocol
Just an alias to distinguish from a regular KoswatInputProfileProtocol.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+reinforcement_domain_name: str
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Returns the representative name in the "real" world of this reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementLayersWrapper
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatLayersWrapperProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+layers: list[ReinforcementLayerProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+All the stored layers being the KoswatBaseLayer the latest one in the collection.
Returns:
+| Type | +Description | +
|---|---|
+ list[ReinforcementLayerProtocol]
+ |
+ List[KoswatLayerProtocol]: Ordered list of |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatProfileBase
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol
Basic definition and implementation of a KoswatProfileProtocol. It represents the initial koswat profile being provided by the user from which further calculations will be made.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+points: list[Point]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The combination of points from both water and polder sides.
+ +Returns:
+| Type | +Description | +
|---|---|
+ list[Point]
+ |
+ list[Point]: A total of eight points comforming the |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+profile_height: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The profile highest point (largest y-coordinate).
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Greatest y-coordinate. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+profile_width: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The profile extent from the lowest (left-most) x-coordinate to the largest (right-most) x-coordinate from a dike geometry polygon.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Total distance. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementInputProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatInputProfileProtocol, Protocol
Just an alias to distinguish from a regular KoswatInputProfileProtocol.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+reinforcement_domain_name: str
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Returns the representative name in the "real" world of this reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementLayersWrapper
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatLayersWrapperProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+layers: list[ReinforcementLayerProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+All the stored layers being the KoswatBaseLayer the latest one in the collection.
Returns:
+| Type | +Description | +
|---|---|
+ list[ReinforcementLayerProtocol]
+ |
+ List[KoswatLayerProtocol]: Ordered list of |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+ Outside slope¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementLayersWrapper
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatLayersWrapperProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+layers: list[ReinforcementLayerProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+All the stored layers being the KoswatBaseLayer the latest one in the collection.
Returns:
+| Type | +Description | +
|---|---|
+ list[ReinforcementLayerProtocol]
+ |
+ List[KoswatLayerProtocol]: Ordered list of |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ CofferdamInputProfileCalculation
+
+
+¶
+
+
+
+
+
+
+ Bases: ReinforcementInputProfileCalculationBase, ReinforcementInputProfileCalculationProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatProfileBase
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol
Basic definition and implementation of a KoswatProfileProtocol. It represents the initial koswat profile being provided by the user from which further calculations will be made.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+points: list[Point]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The combination of points from both water and polder sides.
+ +Returns:
+| Type | +Description | +
|---|---|
+ list[Point]
+ |
+ list[Point]: A total of eight points comforming the |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+profile_height: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The profile highest point (largest y-coordinate).
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Greatest y-coordinate. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+profile_width: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The profile extent from the lowest (left-most) x-coordinate to the largest (right-most) x-coordinate from a dike geometry polygon.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Total distance. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ OutsideSlopeReinforcementLayersWrapperBuilder
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatLayersWrapperBuilderProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementInputProfileCalculationProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: BuilderProtocol, Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+build() -> ReinforcementInputProfileProtocol
+
+¶
+
+
+
+
+
+
+
+
+
+
+Builds a ReinforcementInputProfileProtocol instance based on the base_profile and scenario specified in this class.
Returns:
+| Name | Type | +Description | +
|---|---|---|
ReinforcementInputProfileProtocol |
+ ReinforcementInputProfileProtocol
+ |
+ Calculated reinforcement input profile. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementInputProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatInputProfileProtocol, Protocol
Just an alias to distinguish from a regular KoswatInputProfileProtocol.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+reinforcement_domain_name: str
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Returns the representative name in the "real" world of this reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementLayersWrapper
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatLayersWrapperProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+layers: list[ReinforcementLayerProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+All the stored layers being the KoswatBaseLayer the latest one in the collection.
Returns:
+| Type | +Description | +
|---|---|
+ list[ReinforcementLayerProtocol]
+ |
+ List[KoswatLayerProtocol]: Ordered list of |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Standard¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementLayersWrapper
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatLayersWrapperProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+layers: list[ReinforcementLayerProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+All the stored layers being the KoswatBaseLayer the latest one in the collection.
Returns:
+| Type | +Description | +
|---|---|
+ list[ReinforcementLayerProtocol]
+ |
+ List[KoswatLayerProtocol]: Ordered list of |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementLayersWrapper
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatLayersWrapperProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+layers: list[ReinforcementLayerProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+All the stored layers being the KoswatBaseLayer the latest one in the collection.
Returns:
+| Type | +Description | +
|---|---|
+ list[ReinforcementLayerProtocol]
+ |
+ List[KoswatLayerProtocol]: Ordered list of |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementLayersWrapper
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatLayersWrapperProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+layers: list[ReinforcementLayerProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+All the stored layers being the KoswatBaseLayer the latest one in the collection.
Returns:
+| Type | +Description | +
|---|---|
+ list[ReinforcementLayerProtocol]
+ |
+ List[KoswatLayerProtocol]: Ordered list of |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatProfileBase
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol
Basic definition and implementation of a KoswatProfileProtocol. It represents the initial koswat profile being provided by the user from which further calculations will be made.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+points: list[Point]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The combination of points from both water and polder sides.
+ +Returns:
+| Type | +Description | +
|---|---|
+ list[Point]
+ |
+ list[Point]: A total of eight points comforming the |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+profile_height: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The profile highest point (largest y-coordinate).
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Greatest y-coordinate. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+profile_width: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The profile extent from the lowest (left-most) x-coordinate to the largest (right-most) x-coordinate from a dike geometry polygon.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Total distance. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ OutsideSlopeReinforcementLayersWrapperBuilder
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatLayersWrapperBuilderProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ PipingWallInputProfileCalculation
+
+
+¶
+
+
+
+
+
+
+ Bases: ReinforcementInputProfileCalculationBase, ReinforcementInputProfileCalculationProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementInputProfileCalculationProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: BuilderProtocol, Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+build() -> ReinforcementInputProfileProtocol
+
+¶
+
+
+
+
+
+
+
+
+
+
+Builds a ReinforcementInputProfileProtocol instance based on the base_profile and scenario specified in this class.
Returns:
+| Name | Type | +Description | +
|---|---|---|
ReinforcementInputProfileProtocol |
+ ReinforcementInputProfileProtocol
+ |
+ Calculated reinforcement input profile. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementInputProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatInputProfileProtocol, Protocol
Just an alias to distinguish from a regular KoswatInputProfileProtocol.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+reinforcement_domain_name: str
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Returns the representative name in the "real" world of this reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementLayersWrapper
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatLayersWrapperProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+layers: list[ReinforcementLayerProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+All the stored layers being the KoswatBaseLayer the latest one in the collection.
Returns:
+| Type | +Description | +
|---|---|
+ list[ReinforcementLayerProtocol]
+ |
+ List[KoswatLayerProtocol]: Ordered list of |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ SoilInputProfileCalculation
+
+
+¶
+
+
+
+
+
+
+ Bases: ReinforcementInputProfileCalculationBase, ReinforcementInputProfileCalculationProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StabilityWallInputProfileCalculation
+
+
+¶
+
+
+
+
+
+
+ Bases: ReinforcementInputProfileCalculationBase, ReinforcementInputProfileCalculationProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StandardReinforcementLayersWrapperBuilder
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatLayersWrapperBuilderProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StandardReinforcementProfileBuilder
+
+
+¶
+
+
+
+
+
+
+ Bases: ReinforcementProfileBuilderBase
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_input_profile_calculator(reinforcement_type: type[StandardReinforcementProfile]) -> ReinforcementInputProfileCalculationProtocol
+
+
+ staticmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Get the input profile calculator for the given reinforcement type.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[StandardReinforcementProfile]
+ |
+ The reinforcement type. |
+ + required + | +
Raises:
+| Type | +Description | +
|---|---|
+ NotImplementedError
+ |
+ The given reinforcement type is not supported. |
+
Returns:
+| Name | Type | +Description | +
|---|---|---|
ReinforcementInputProfileCalculationProtocol |
+ ReinforcementInputProfileCalculationProtocol
+ |
+ The input profile calculator. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementLayersWrapper
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatLayersWrapperProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+layers: list[ReinforcementLayerProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+All the stored layers being the KoswatBaseLayer the latest one in the collection.
Returns:
+| Type | +Description | +
|---|---|
+ list[ReinforcementLayerProtocol]
+ |
+ List[KoswatLayerProtocol]: Ordered list of |
+
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_docstrings/koswat_handler.html b/reference/koswat_docstrings/koswat_handler.html
new file mode 100644
index 00000000..39600400
--- /dev/null
+++ b/reference/koswat_docstrings/koswat_handler.html
@@ -0,0 +1,608 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Koswat handler¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatHandler
+
+
+¶
+
+
+
+
+
+
+
+Handler for CLI usage of Koswat. It allows the initialization of a logger during the analysis.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__init__(log_output: Optional[str]) -> None
+
+¶
+
+
+
+
+
+
+
+
+
+
+Initializes the handler creating a log file at the optional provided directory log_output.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
log_output |
+
+ Optional[str]
+ |
+ Directory where to save the |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+run_analysis(analysis_file: str) -> None
+
+¶
+
+
+
+
+
+
+
+
+
+
+Runs a Koswat analysis using the provided *.ini file analysis_file.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
analysis_file |
+
+ str
+ |
+ Location of the main koswat analysis ini file. |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLogger
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatSummary
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents the summary of the KOSWAT analysis.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs() -> dict[type[ReinforcementProfileProtocol], tuple[float, float]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the infrastructure costs for each profile type +for those locations for which the profile type is selected.
+ +Returns:
+| Type | +Description | +
|---|---|
+ dict[type[ReinforcementProfileProtocol], tuple[float, float]]
+ |
+ dict[type[ReinforcementProfileProtocol], tuple[float, float]]: +infrastructure costs without and with surtax per reinforcement type. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_report_by_profile(profile_type: type[ReinforcementProfileProtocol]) -> MultiLocationProfileCostReport | None
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Get the report for a specific profile type.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
profile_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Type of reinforcement profile. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ MultiLocationProfileCostReport | None
+ |
+ MultiLocationProfileCostReport | None: Report for the profile type. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatSummaryBuilder
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: BuilderProtocol
+
+
+
+
+
+
+
+
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_docstrings/koswat_main.html b/reference/koswat_docstrings/koswat_main.html
new file mode 100644
index 00000000..c8338537
--- /dev/null
+++ b/reference/koswat_docstrings/koswat_main.html
@@ -0,0 +1,430 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Main¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatHandler
+
+
+¶
+
+
+
+
+
+
+
+Handler for CLI usage of Koswat. It allows the initialization of a logger during the analysis.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__init__(log_output: Optional[str]) -> None
+
+¶
+
+
+
+
+
+
+
+
+
+
+Initializes the handler creating a log file at the optional provided directory log_output.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
log_output |
+
+ Optional[str]
+ |
+ Directory where to save the |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+run_analysis(analysis_file: str) -> None
+
+¶
+
+
+
+
+
+
+
+
+
+
+Runs a Koswat analysis using the provided *.ini file analysis_file.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
analysis_file |
+
+ str
+ |
+ Location of the main koswat analysis ini file. |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+run_analysis(input_file: str, log_output: str)
+
+¶
+
+
+
+
+
+
+
+
+
+
+CLI call to execute a Koswat analysis given a settings files (input_file). The log is generated by default in the execute path, unless otherwise specified in the log_output argument.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
input_file |
+
+ str
+ |
+ Location of the |
+ + required + | +
log_output |
+
+ str
+ |
+ Optional argument to specify where will be created the |
+ + required + | +
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_docstrings/plots/dike.html b/reference/koswat_docstrings/plots/dike.html
new file mode 100644
index 00000000..89751d59
--- /dev/null
+++ b/reference/koswat_docstrings/plots/dike.html
@@ -0,0 +1,1275 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Dike plotting module¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayerPlot
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatPlotProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+plot(color: str) -> None
+
+¶
+
+
+
+
+
+
+
+
+
+Plots a KoswatLayerProtocol into the provided canvas plot_axes with the requested color.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
color |
+
+ str
+ |
+ Color code. |
+ + required + | +
return list(
+ map(concatenate, zip(*map(lambda x: x.coords.xy, koswat_geometry.geoms)))
+)
+ ValueError: When the KoswatLayerProtocol material has not been registered.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayerProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+as_data_dict() -> dict
+
+¶
+
+
+
+
+
+
+
+
+
+
+Returns the information related to an instance of the KoswatLayerProtocol.
Returns:
+| Name | Type | +Description | +
|---|---|---|
dict |
+ dict
+ |
+ custom dictionary with the relevant data. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatPlotProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+plot(*args, **kwargs) -> pyplot.axes
+
+¶
+
+
+
+
+
+
+
+
+
+
+Plots a koswat_object into the provided plot ax with the requested *args and **kwargs.
Returns:
+| Type | +Description | +
|---|---|
+ pyplot.axes
+ |
+ pyplot.axes: Canvas with plotted |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayerPlot
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatPlotProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+plot(color: str) -> None
+
+¶
+
+
+
+
+
+
+
+
+
+Plots a KoswatLayerProtocol into the provided canvas plot_axes with the requested color.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
color |
+
+ str
+ |
+ Color code. |
+ + required + | +
return list(
+ map(concatenate, zip(*map(lambda x: x.coords.xy, koswat_geometry.geoms)))
+)
+ ValueError: When the KoswatLayerProtocol material has not been registered.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayerProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+as_data_dict() -> dict
+
+¶
+
+
+
+
+
+
+
+
+
+
+Returns the information related to an instance of the KoswatLayerProtocol.
Returns:
+| Name | Type | +Description | +
|---|---|---|
dict |
+ dict
+ |
+ custom dictionary with the relevant data. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayersWrapperPlot
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatPlotProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+with_layers_list(layers_list: List[KoswatLayerProtocol]) -> KoswatLayersWrapperPlot
+
+
+ classmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Class method to aid the usage of this class with unrelated layers from different wrappers.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
layers_list |
+
+ List[KoswatLayerProtocol]
+ |
+ List of layers to wrap just for plotting. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
KoswatLayersWrapperPlot |
+ KoswatLayersWrapperPlot
+ |
+ Initialized valid instance with custom intenal wrapper |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayersWrapperProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+as_data_dict() -> dict
+
+¶
+
+
+
+
+
+
+
+
+
+
+Returns the layers as a dictionary.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
dict |
+ dict
+ |
+ Dictionary containing all the information of the wrapper layers ( |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatPlotProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+plot(*args, **kwargs) -> pyplot.axes
+
+¶
+
+
+
+
+
+
+
+
+
+
+Plots a koswat_object into the provided plot ax with the requested *args and **kwargs.
Returns:
+| Type | +Description | +
|---|---|
+ pyplot.axes
+ |
+ pyplot.axes: Canvas with plotted |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_cmap(n_colors: int, name: int = 'hsv')
+
+¶
+
+
+
+
+
+
+Returns a function that maps each index in 0, 1, ..., n-1 to a distinct +RGB color; the keyword argument name must be a standard mpl colormap name.
+ +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatLayersWrapperPlot
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatPlotProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+with_layers_list(layers_list: List[KoswatLayerProtocol]) -> KoswatLayersWrapperPlot
+
+
+ classmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Class method to aid the usage of this class with unrelated layers from different wrappers.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
layers_list |
+
+ List[KoswatLayerProtocol]
+ |
+ List of layers to wrap just for plotting. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
KoswatLayersWrapperPlot |
+ KoswatLayersWrapperPlot
+ |
+ Initialized valid instance with custom intenal wrapper |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatPlotProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+plot(*args, **kwargs) -> pyplot.axes
+
+¶
+
+
+
+
+
+
+
+
+
+
+Plots a koswat_object into the provided plot ax with the requested *args and **kwargs.
Returns:
+| Type | +Description | +
|---|---|
+ pyplot.axes
+ |
+ pyplot.axes: Canvas with plotted |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatPlotProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+plot(*args, **kwargs) -> pyplot.axes
+
+¶
+
+
+
+
+
+
+
+
+
+
+Plots a koswat_object into the provided plot ax with the requested *args and **kwargs.
Returns:
+| Type | +Description | +
|---|---|
+ pyplot.axes
+ |
+ pyplot.axes: Canvas with plotted |
+
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_docstrings/plots/geometries.html b/reference/koswat_docstrings/plots/geometries.html
new file mode 100644
index 00000000..c2b06c78
--- /dev/null
+++ b/reference/koswat_docstrings/plots/geometries.html
@@ -0,0 +1,393 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Geometries plot module¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ HighlightGeometryPlot
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatPlotProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+plot(*args, **kwargs) -> pyplot.axes
+
+¶
+
+
+
+
+
+
+
+
+
+
+Plots a layer highlighting its content.
+ +Returns:
+| Type | +Description | +
|---|---|
+ pyplot.axes
+ |
+ pyplot.axes: Polygon with its area painted. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatPlotProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+plot(*args, **kwargs) -> pyplot.axes
+
+¶
+
+
+
+
+
+
+
+
+
+
+Plots a koswat_object into the provided plot ax with the requested *args and **kwargs.
Returns:
+| Type | +Description | +
|---|---|
+ pyplot.axes
+ |
+ pyplot.axes: Canvas with plotted |
+
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_docstrings/plots/plots.html b/reference/koswat_docstrings/plots/plots.html
new file mode 100644
index 00000000..3ccb17f5
--- /dev/null
+++ b/reference/koswat_docstrings/plots/plots.html
@@ -0,0 +1,640 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Plots module¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatFigureContextHandler
+
+
+¶
+
+
+
+
+
+
+
+PyPlot fig context handler that opens the figure stream and closes it saving it to the appointed path.
+ +
+
+
+
+
+
+ Usage example
+with KoswatFigureContext(Path("C://my_plot.png"), 42) as _figure: + _subplot = _figure.add_subplot() + ...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__enter__() -> Figure
+
+¶
+
+
+
+
+
+
+
+
+
+
+Access to the context and invokation of pyplot.figure(dpi).
Returns:
+| Name | Type | +Description | +
|---|---|---|
Figure |
+ Figure
+ |
+ Initialized instance from |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__exit__(*args, **kwargs) -> None
+
+¶
+
+
+
+
+
+
+Exit the current context and save the previously initialized Figure.
+
+
+
+
+
+
+
+
+
+
+
+
+
+__init__(output_path: Path, dpi: int) -> None
+
+¶
+
+
+
+
+
+
+
+
+
+
+Initializes the context by invoking pyplot.figure(dpi=dpi) and saving its output to an internal field.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
output_path |
+
+ Path
+ |
+ Export location for the generated plot. |
+ + required + | +
dpi |
+
+ int
+ |
+ Canvas resolution in dots-per-inch. |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatPlotProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+plot(*args, **kwargs) -> pyplot.axes
+
+¶
+
+
+
+
+
+
+
+
+
+
+Plots a koswat_object into the provided plot ax with the requested *args and **kwargs.
Returns:
+| Type | +Description | +
|---|---|
+ pyplot.axes
+ |
+ pyplot.axes: Canvas with plotted |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ KoswatExporterProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export(**kwargs) -> None
+
+¶
+
+
+
+
+
+
+Exports an object model into a concrete file format.
+ +
+
+
+
+
+
+
+
+
+
+
+
+
+
+ PlotExporterProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatExporterProtocol, Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export() -> None
+
+¶
+
+
+
+
+
+
+Exports a given object into a plot.
+ +
+
+
+
+ « Previous
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_docstrings/strategies.html b/reference/koswat_docstrings/strategies.html
new file mode 100644
index 00000000..158a11a3
--- /dev/null
+++ b/reference/koswat_docstrings/strategies.html
@@ -0,0 +1,8274 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Strategies¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyInput
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents the input data structure for a strategy.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+reinforcement_min_cluster: int
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Returns the minimum length of a reinforcement type
+along a traject, usually named as cluster throughout
+the code.
Returns:
+| Name | Type | +Description | +
|---|---|---|
int |
+ int
+ |
+
|
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyLocationInput
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+available_measures: list[type[ReinforcementProfileProtocol]]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Gets all the available reinforcement types in strategy_location_reinforcements.
+It is called available_measures to match the StrategyLocationReinforcement
+definition.
Returns:
+| Type | +Description | +
|---|---|
+ list[type[ReinforcementProfileProtocol]]
+ |
+ list[Type[ReinforcementProfileProtocol]]: resulting list. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+cheapest_reinforcement: StrategyReinforcementTypeCosts
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Gets the StrategyLocationReinforcementCosts with the lowest total_costs value.
Returns:
+| Name | Type | +Description | +
|---|---|---|
StrategyLocationReinforcementCosts |
+ StrategyReinforcementTypeCosts
+ |
+ The cheapest reinforcement for this location. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs(reinforcement_type: type[ReinforcementProfileProtocol]) -> tuple[float, float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Get the infrastructure costs for the given reinforcement type.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ The reinforcement type. |
+ + required + | +
Raises:
+| Type | +Description | +
|---|---|
+ ValueError
+ |
+ The reinforcement type is not available. |
+
Returns:
+| Type | +Description | +
|---|---|
+ tuple[float, float]
+ |
+ tuple[float, float]: Tuple containing the infrastructure costs without and with surtax. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_reinforcement_costs(reinforcement_type: type[ReinforcementProfileProtocol]) -> float
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Get the costs for the given reinforcement type.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ The reinforcement type. |
+ + required + | +
Raises:
+| Type | +Description | +
|---|---|
+ ValueError
+ |
+ The reinforcement type is not available. |
+
Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ The reinforcement costs. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ PointSurroundings
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Object representing a meter with x, y coordinates in a polder (or else).
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__eq__(__value: object) -> bool
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" equality operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__hash__() -> int
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" hash operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+closest_obstacle: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Distance to the closest (obstacle) surrounding. When no surroundings are given the value will be NaN (Not A Number), so that the value 0 is reserved for buildings at distance 0.
Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Distance to the closest surrounding. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_total_infrastructure_per_zone(*zone_limit_collection: tuple[float, float]) -> list[float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the total infrastructure width at each of the provided zones
+zone_limit_collection (tuple[float, float]).
+The zone limits are matched by rounding up their upper limit to the
+surroundings_matrix keys (distances to the location in the real world).
+When two zones have overlapping limits (as expected) the lower one will
+"claim" the corresponding surrounding distance.
+
+ Example
+-
+
zone_limit_collection= (0, 4), (4, 11)
+surroundings_matrix= {5: 1.5, 10: 3, 15: 6}
+- "Taken" distances per zone:
-
+
(0, 4)takes key5.
+(4, 11)takes key(s)10and15because5was already taken.
+
+ - Total infrastructure width at zones =
(1.5, 9)
+
Returns:
+| Type | +Description | +
|---|---|
+ list[float]
+ |
+ list[float]: list with total width corresponding to each provided zone. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyLocationInput
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+available_measures: list[type[ReinforcementProfileProtocol]]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Gets all the available reinforcement types in strategy_location_reinforcements.
+It is called available_measures to match the StrategyLocationReinforcement
+definition.
Returns:
+| Type | +Description | +
|---|---|
+ list[type[ReinforcementProfileProtocol]]
+ |
+ list[Type[ReinforcementProfileProtocol]]: resulting list. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+cheapest_reinforcement: StrategyReinforcementTypeCosts
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Gets the StrategyLocationReinforcementCosts with the lowest total_costs value.
Returns:
+| Name | Type | +Description | +
|---|---|---|
StrategyLocationReinforcementCosts |
+ StrategyReinforcementTypeCosts
+ |
+ The cheapest reinforcement for this location. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs(reinforcement_type: type[ReinforcementProfileProtocol]) -> tuple[float, float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Get the infrastructure costs for the given reinforcement type.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ The reinforcement type. |
+ + required + | +
Raises:
+| Type | +Description | +
|---|---|
+ ValueError
+ |
+ The reinforcement type is not available. |
+
Returns:
+| Type | +Description | +
|---|---|
+ tuple[float, float]
+ |
+ tuple[float, float]: Tuple containing the infrastructure costs without and with surtax. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_reinforcement_costs(reinforcement_type: type[ReinforcementProfileProtocol]) -> float
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Get the costs for the given reinforcement type.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ The reinforcement type. |
+ + required + | +
Raises:
+| Type | +Description | +
|---|---|
+ ValueError
+ |
+ The reinforcement type is not available. |
+
Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ The reinforcement costs. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyReinforcementTypeCosts
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+total_costs: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The simple addition of the base costs and the possible +related infrastructure costs.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ The total costs when applying this reinforcement. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ PointSurroundings
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Object representing a meter with x, y coordinates in a polder (or else).
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__eq__(__value: object) -> bool
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" equality operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+__hash__() -> int
+
+¶
+
+
+
+
+
+
+Overriding of the "magic" hash operator required
+so that PointSurroundings can be used as a key in a python dict.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+closest_obstacle: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Distance to the closest (obstacle) surrounding. When no surroundings are given the value will be NaN (Not A Number), so that the value 0 is reserved for buildings at distance 0.
Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ Distance to the closest surrounding. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_total_infrastructure_per_zone(*zone_limit_collection: tuple[float, float]) -> list[float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the total infrastructure width at each of the provided zones
+zone_limit_collection (tuple[float, float]).
+The zone limits are matched by rounding up their upper limit to the
+surroundings_matrix keys (distances to the location in the real world).
+When two zones have overlapping limits (as expected) the lower one will
+"claim" the corresponding surrounding distance.
+
+ Example
+-
+
zone_limit_collection= (0, 4), (4, 11)
+surroundings_matrix= {5: 1.5, 10: 3, 15: 6}
+- "Taken" distances per zone:
-
+
(0, 4)takes key5.
+(4, 11)takes key(s)10and15because5was already taken.
+
+ - Total infrastructure width at zones =
(1.5, 9)
+
Returns:
+| Type | +Description | +
|---|---|
+ list[float]
+ |
+ list[float]: list with total width corresponding to each provided zone. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyLocationInput
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+available_measures: list[type[ReinforcementProfileProtocol]]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Gets all the available reinforcement types in strategy_location_reinforcements.
+It is called available_measures to match the StrategyLocationReinforcement
+definition.
Returns:
+| Type | +Description | +
|---|---|
+ list[type[ReinforcementProfileProtocol]]
+ |
+ list[Type[ReinforcementProfileProtocol]]: resulting list. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+cheapest_reinforcement: StrategyReinforcementTypeCosts
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Gets the StrategyLocationReinforcementCosts with the lowest total_costs value.
Returns:
+| Name | Type | +Description | +
|---|---|---|
StrategyLocationReinforcementCosts |
+ StrategyReinforcementTypeCosts
+ |
+ The cheapest reinforcement for this location. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs(reinforcement_type: type[ReinforcementProfileProtocol]) -> tuple[float, float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Get the infrastructure costs for the given reinforcement type.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ The reinforcement type. |
+ + required + | +
Raises:
+| Type | +Description | +
|---|---|
+ ValueError
+ |
+ The reinforcement type is not available. |
+
Returns:
+| Type | +Description | +
|---|---|
+ tuple[float, float]
+ |
+ tuple[float, float]: Tuple containing the infrastructure costs without and with surtax. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_reinforcement_costs(reinforcement_type: type[ReinforcementProfileProtocol]) -> float
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Get the costs for the given reinforcement type.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ The reinforcement type. |
+ + required + | +
Raises:
+| Type | +Description | +
|---|---|
+ ValueError
+ |
+ The reinforcement type is not available. |
+
Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ The reinforcement costs. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyLocationReinforcement
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents a location and the different reinforcements that can be applied to it +as well their costs. +This class is used to show the final chosen state for a location.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_cost: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Estimates the costs at this location for the given current_selected_measure.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_selected_measure: type[ReinforcementProfileProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Exposes the current selected measure for this object.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs(reinforcement_type: type[ReinforcementProfileProtocol]) -> tuple[float, float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Returns the infrastructure costs for the given reinforcement type (without and with surtax).
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ tuple[float, float]
+ |
+ tuple[float, float]: Tuple containing the infrastructure costs without and with surtax. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_selected_measure_steps() -> tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Outputs the selected measure following the domain (expected) steps: + - Initial step, + - Order step, + - Infrastructure step
+ +Returns:
+| Type | +Description | +
|---|---|
+ tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+ |
+ tuple[ +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol]]: Resulting tuple. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+set_selected_measure(reinforcement_type: type[ReinforcementProfileProtocol], step: StrategyStepEnum)
+
+¶
+
+
+
+
+
+
+
+
+
+
+Changes the value reprsented in current_selected_measure and updates the
+dictionary of selections (history).
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type |
+ + required + | +
step |
+
+ StrategyStepsEnum
+ |
+ Step whose |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyReinforcementTypeCosts
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+total_costs: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The simple addition of the base costs and the possible +related infrastructure costs.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ The total costs when applying this reinforcement. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyReinforcementTypeCosts
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+total_costs: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+The simple addition of the base costs and the possible +related infrastructure costs.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ The total costs when applying this reinforcement. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyInput
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents the input data structure for a strategy.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+reinforcement_min_cluster: int
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Returns the minimum length of a reinforcement type
+along a traject, usually named as cluster throughout
+the code.
Returns:
+| Name | Type | +Description | +
|---|---|---|
int |
+ int
+ |
+
|
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyOutput
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents the output data structure for a strategy.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+apply_strategy(strategy_input: StrategyInput) -> StrategyOutput
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Applies a specific strategy by matching each location (PointSurroundings)
+ to a valid reinforcement type (ReinforcementProfileProtocol).
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
strategy_input |
+
+ `StrategyInput`
+ |
+ Input data structure containing locations and available reinforcements for each of them. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
StrategyOutput |
+ StrategyOutput
+ |
+ Output data structure containing the selected reinforcements for each location. |
+
Order Strategy¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ OrderStrategy
+
+
+¶
+
+
+
+
+
+
+ Bases: StrategyProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_default_order_for_reinforcements() -> list[type[ReinforcementProfileProtocol]]
+
+
+ staticmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+Give the default order for reinforcements types, +assuming they are sorted from cheapest to most expensive +and least to most restrictive.
+ +Returns:
+| Type | +Description | +
|---|---|
+ list[type[ReinforcementProfileProtocol]]
+ |
+ list[type[ReinforcementProfileProtocol]]: list of reinforcement types |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_strategy_order_for_reinforcements(strategy_reinforcements: list[StrategyReinforcementInput]) -> list[type[ReinforcementProfileProtocol]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Give the ordered reinforcement types for this strategy, from cheapest to most expensive, +possibly removing reinforcement types that are more expensive and more restrictive than others. +Cofferdam should always be the last reinforcement type.
+ +
+
+ Input
+strategy_reinforcements (list[StrategyReinforcementInput]): list of reinforcement types with costs and surface
+Returns:
+| Type | +Description | +
|---|---|
+ list[type[ReinforcementProfileProtocol]]
+ |
+ list[type[ReinforcementProfileProtocol]]: list of reinforcement types |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_strategy_reinforcements(strategy_locations: list[StrategyLocationInput], selection_order: list[type[ReinforcementProfileProtocol]]) -> list[StrategyLocationReinforcement]
+
+
+ staticmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Gets the strategy representation of the locations with their available measures
+ordered filtered and order by the provided selection_order. It also sets
+their initial state.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
strategy_locations |
+
+ list[StrategyLocationInput]
+ |
+ Locations to map into reinforcement locations. |
+ + required + | +
selection_order |
+
+ list[type[ReinforcementProfileProtocol]]
+ |
+ Priority order to assign a reinforcement. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ list[StrategyLocationReinforcement]
+ |
+ list[StrategyLocationReinforcement]: Mapped location reinforcements. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ OrderStrategyBuffering
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: OrderStrategyBase
Applies buffering, through masks, to each location's pre-assigned reinforcement.
+The result of the apply method will be the locations with the best
+reinforcement fit (lowest index from reinforcement_order) that fulfills the
+reinforcement_min_buffer requirement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ OrderStrategyClustering
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: OrderStrategyBase
Applies clustering, to the whole collection of reinforcements
+(location_reinforcements: list[StrategyLocationReinforcement]).
+The result of the apply method will be the locations with the best
+reinforcement fit (lowest index from reinforcement_order) that fulfills the
+reinforcement_min_length requirement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyInput
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents the input data structure for a strategy.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+reinforcement_min_cluster: int
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Returns the minimum length of a reinforcement type
+along a traject, usually named as cluster throughout
+the code.
Returns:
+| Name | Type | +Description | +
|---|---|---|
int |
+ int
+ |
+
|
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyLocationInput
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+available_measures: list[type[ReinforcementProfileProtocol]]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Gets all the available reinforcement types in strategy_location_reinforcements.
+It is called available_measures to match the StrategyLocationReinforcement
+definition.
Returns:
+| Type | +Description | +
|---|---|
+ list[type[ReinforcementProfileProtocol]]
+ |
+ list[Type[ReinforcementProfileProtocol]]: resulting list. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+cheapest_reinforcement: StrategyReinforcementTypeCosts
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Gets the StrategyLocationReinforcementCosts with the lowest total_costs value.
Returns:
+| Name | Type | +Description | +
|---|---|---|
StrategyLocationReinforcementCosts |
+ StrategyReinforcementTypeCosts
+ |
+ The cheapest reinforcement for this location. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs(reinforcement_type: type[ReinforcementProfileProtocol]) -> tuple[float, float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Get the infrastructure costs for the given reinforcement type.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ The reinforcement type. |
+ + required + | +
Raises:
+| Type | +Description | +
|---|---|
+ ValueError
+ |
+ The reinforcement type is not available. |
+
Returns:
+| Type | +Description | +
|---|---|
+ tuple[float, float]
+ |
+ tuple[float, float]: Tuple containing the infrastructure costs without and with surtax. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_reinforcement_costs(reinforcement_type: type[ReinforcementProfileProtocol]) -> float
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Get the costs for the given reinforcement type.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ The reinforcement type. |
+ + required + | +
Raises:
+| Type | +Description | +
|---|---|
+ ValueError
+ |
+ The reinforcement type is not available. |
+
Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ The reinforcement costs. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyLocationReinforcement
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents a location and the different reinforcements that can be applied to it +as well their costs. +This class is used to show the final chosen state for a location.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_cost: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Estimates the costs at this location for the given current_selected_measure.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_selected_measure: type[ReinforcementProfileProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Exposes the current selected measure for this object.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs(reinforcement_type: type[ReinforcementProfileProtocol]) -> tuple[float, float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Returns the infrastructure costs for the given reinforcement type (without and with surtax).
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ tuple[float, float]
+ |
+ tuple[float, float]: Tuple containing the infrastructure costs without and with surtax. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_selected_measure_steps() -> tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Outputs the selected measure following the domain (expected) steps: + - Initial step, + - Order step, + - Infrastructure step
+ +Returns:
+| Type | +Description | +
|---|---|
+ tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+ |
+ tuple[ +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol]]: Resulting tuple. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+set_selected_measure(reinforcement_type: type[ReinforcementProfileProtocol], step: StrategyStepEnum)
+
+¶
+
+
+
+
+
+
+
+
+
+
+Changes the value reprsented in current_selected_measure and updates the
+dictionary of selections (history).
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type |
+ + required + | +
step |
+
+ StrategyStepsEnum
+ |
+ Step whose |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyOutput
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents the output data structure for a strategy.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+apply_strategy(strategy_input: StrategyInput) -> StrategyOutput
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Applies a specific strategy by matching each location (PointSurroundings)
+ to a valid reinforcement type (ReinforcementProfileProtocol).
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
strategy_input |
+
+ `StrategyInput`
+ |
+ Input data structure containing locations and available reinforcements for each of them. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
StrategyOutput |
+ StrategyOutput
+ |
+ Output data structure containing the selected reinforcements for each location. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyLocationReinforcement
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents a location and the different reinforcements that can be applied to it +as well their costs. +This class is used to show the final chosen state for a location.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_cost: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Estimates the costs at this location for the given current_selected_measure.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_selected_measure: type[ReinforcementProfileProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Exposes the current selected measure for this object.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs(reinforcement_type: type[ReinforcementProfileProtocol]) -> tuple[float, float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Returns the infrastructure costs for the given reinforcement type (without and with surtax).
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ tuple[float, float]
+ |
+ tuple[float, float]: Tuple containing the infrastructure costs without and with surtax. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_selected_measure_steps() -> tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Outputs the selected measure following the domain (expected) steps: + - Initial step, + - Order step, + - Infrastructure step
+ +Returns:
+| Type | +Description | +
|---|---|
+ tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+ |
+ tuple[ +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol]]: Resulting tuple. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+set_selected_measure(reinforcement_type: type[ReinforcementProfileProtocol], step: StrategyStepEnum)
+
+¶
+
+
+
+
+
+
+
+
+
+
+Changes the value reprsented in current_selected_measure and updates the
+dictionary of selections (history).
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type |
+ + required + | +
step |
+
+ StrategyStepsEnum
+ |
+ Step whose |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ OrderStrategyBuffering
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: OrderStrategyBase
Applies buffering, through masks, to each location's pre-assigned reinforcement.
+The result of the apply method will be the locations with the best
+reinforcement fit (lowest index from reinforcement_order) that fulfills the
+reinforcement_min_buffer requirement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyLocationReinforcement
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents a location and the different reinforcements that can be applied to it +as well their costs. +This class is used to show the final chosen state for a location.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_cost: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Estimates the costs at this location for the given current_selected_measure.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_selected_measure: type[ReinforcementProfileProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Exposes the current selected measure for this object.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs(reinforcement_type: type[ReinforcementProfileProtocol]) -> tuple[float, float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Returns the infrastructure costs for the given reinforcement type (without and with surtax).
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ tuple[float, float]
+ |
+ tuple[float, float]: Tuple containing the infrastructure costs without and with surtax. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_selected_measure_steps() -> tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Outputs the selected measure following the domain (expected) steps: + - Initial step, + - Order step, + - Infrastructure step
+ +Returns:
+| Type | +Description | +
|---|---|
+ tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+ |
+ tuple[ +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol]]: Resulting tuple. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+set_selected_measure(reinforcement_type: type[ReinforcementProfileProtocol], step: StrategyStepEnum)
+
+¶
+
+
+
+
+
+
+
+
+
+
+Changes the value reprsented in current_selected_measure and updates the
+dictionary of selections (history).
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type |
+ + required + | +
step |
+
+ StrategyStepsEnum
+ |
+ Step whose |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ OrderCluster
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+extend_cluster(other: OrderCluster)
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Extends the current cluster with the reinforcements
+(list[StrategyLocationReinforcement]) from another cluster.
+Modifies the current_selected_measure property of those measures being merged but it
+does not remove them from their source cluster.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
other |
+
+ OrderCluster
+ |
+ Cluster whose contents will be used to extend |
+ + required + | +
Raises:
+| Type | +Description | +
|---|---|
+ ValueError
+ |
+ When trying to extend from an unrelated cluster. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_stronger_cluster() -> OrderCluster
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the neighbor with the lowest reinforcement type value greater
+than the current cluster's value (self.reinforcement_idx).
Returns:
+| Name | Type | +Description | +
|---|---|---|
OrderCluster |
+ OrderCluster
+ |
+ Neighbor with a stronger |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+is_compliant(min_length: float, strongest_reinforcement: int) -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Checks whether this OrderCluster instance is compliant within a cluster group.
+This method does not check for exceptions, such as, the cluster's neighbors are
+of lower strength than the current.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
min_length |
+
+ float
+ |
+ Minimal length a reinforcement measure is required +for a cluster. |
+ + required + | +
strongest_reinforcement |
+
+ int
+ |
+ What is the reinforcement index which cannot +be futher 'strengthen'. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ if the cluster is compliant within its neighbors context. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ OrderStrategyClustering
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+ Bases: OrderStrategyBase
Applies clustering, to the whole collection of reinforcements
+(location_reinforcements: list[StrategyLocationReinforcement]).
+The result of the apply method will be the locations with the best
+reinforcement fit (lowest index from reinforcement_order) that fulfills the
+reinforcement_min_length requirement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyLocationReinforcement
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents a location and the different reinforcements that can be applied to it +as well their costs. +This class is used to show the final chosen state for a location.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_cost: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Estimates the costs at this location for the given current_selected_measure.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_selected_measure: type[ReinforcementProfileProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Exposes the current selected measure for this object.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs(reinforcement_type: type[ReinforcementProfileProtocol]) -> tuple[float, float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Returns the infrastructure costs for the given reinforcement type (without and with surtax).
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ tuple[float, float]
+ |
+ tuple[float, float]: Tuple containing the infrastructure costs without and with surtax. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_selected_measure_steps() -> tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Outputs the selected measure following the domain (expected) steps: + - Initial step, + - Order step, + - Infrastructure step
+ +Returns:
+| Type | +Description | +
|---|---|
+ tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+ |
+ tuple[ +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol]]: Resulting tuple. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+set_selected_measure(reinforcement_type: type[ReinforcementProfileProtocol], step: StrategyStepEnum)
+
+¶
+
+
+
+
+
+
+
+
+
+
+Changes the value reprsented in current_selected_measure and updates the
+dictionary of selections (history).
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type |
+ + required + | +
step |
+
+ StrategyStepsEnum
+ |
+ Step whose |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ OrderCluster
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+extend_cluster(other: OrderCluster)
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Extends the current cluster with the reinforcements
+(list[StrategyLocationReinforcement]) from another cluster.
+Modifies the current_selected_measure property of those measures being merged but it
+does not remove them from their source cluster.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
other |
+
+ OrderCluster
+ |
+ Cluster whose contents will be used to extend |
+ + required + | +
Raises:
+| Type | +Description | +
|---|---|
+ ValueError
+ |
+ When trying to extend from an unrelated cluster. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_stronger_cluster() -> OrderCluster
+
+¶
+
+
+
+
+
+
+
+
+
+
+Gets the neighbor with the lowest reinforcement type value greater
+than the current cluster's value (self.reinforcement_idx).
Returns:
+| Name | Type | +Description | +
|---|---|---|
OrderCluster |
+ OrderCluster
+ |
+ Neighbor with a stronger |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+is_compliant(min_length: float, strongest_reinforcement: int) -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Checks whether this OrderCluster instance is compliant within a cluster group.
+This method does not check for exceptions, such as, the cluster's neighbors are
+of lower strength than the current.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
min_length |
+
+ float
+ |
+ Minimal length a reinforcement measure is required +for a cluster. |
+ + required + | +
strongest_reinforcement |
+
+ int
+ |
+ What is the reinforcement index which cannot +be futher 'strengthen'. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ if the cluster is compliant within its neighbors context. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyLocationReinforcement
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents a location and the different reinforcements that can be applied to it +as well their costs. +This class is used to show the final chosen state for a location.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_cost: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Estimates the costs at this location for the given current_selected_measure.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_selected_measure: type[ReinforcementProfileProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Exposes the current selected measure for this object.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs(reinforcement_type: type[ReinforcementProfileProtocol]) -> tuple[float, float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Returns the infrastructure costs for the given reinforcement type (without and with surtax).
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ tuple[float, float]
+ |
+ tuple[float, float]: Tuple containing the infrastructure costs without and with surtax. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_selected_measure_steps() -> tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Outputs the selected measure following the domain (expected) steps: + - Initial step, + - Order step, + - Infrastructure step
+ +Returns:
+| Type | +Description | +
|---|---|
+ tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+ |
+ tuple[ +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol]]: Resulting tuple. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+set_selected_measure(reinforcement_type: type[ReinforcementProfileProtocol], step: StrategyStepEnum)
+
+¶
+
+
+
+
+
+
+
+
+
+
+Changes the value reprsented in current_selected_measure and updates the
+dictionary of selections (history).
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type |
+ + required + | +
step |
+
+ StrategyStepsEnum
+ |
+ Step whose |
+ + required + | +
Infra Priority Strategy¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ InfraCluster
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+This dataclass represents the subset of locations sharing the same
+reinforcement type (type[ReinforcementProfileProtocol]).
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_cost: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Calculates the cost of applying the reinforcement_type to
+all locations present in the cluster.
Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ The total (current) cost of this cluster. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+fits_subclusters() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Validates whether this cluster can be split into subclusters. +For that it requires to have at least twice the required length.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ Whether subclusters can be generated from this one. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+is_valid() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Validates the length of this cluster.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ The cluster has the minimal required length. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+set_cheapest_common_available_measure(measure_costs: dict[type[ReinforcementProfileProtocol], float]) -> None
+
+¶
+
+
+
+
+
+
+
+
+
+
+Updates all the location reinforcements with the cheapest reinforcement type
+from the measure_costs.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
measure_costs |
+
+ dict[type[ReinforcementProfileProtocol]]
+ |
+ dictionary with the total costs per reinforcement type. |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ InfraClusterOption
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents one set of subclusters the strategy could select +for costs optimization.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+add_cluster(infra_cluster: InfraCluster, cluster_costs: dict)
+
+¶
+
+
+
+
+
+
+
+
+
+
+Adds the infra cluster into the collection as well as its reinforcement +costs.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
infra_cluster |
+
+ InfraCluster
+ |
+ Cluster to add to this collection option. |
+ + required + | +
cluster_costs |
+
+ dict
+ |
+ Reinforcement costs for the given cluster. |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+cluster_collection: list[InfraCluster]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Read-only property to expose the stored subclusters.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+cluster_costs: list[dict[ReinforcementProfileProtocol, float]]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Read-only property to expose the stored costs.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+set_cheapest_option()
+
+¶
+
+
+
+
+
+
+Sets the subclusters defined in this option to their most optimal (cheapest) +reinforcement possible.
+ +
+
+
+
+
+
+
+
+
+
+
+
+
+
+valid_option() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Validates the collection of clusters based on the +required minimun length.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ Validation result. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ InfraPriorityStrategy
+
+
+¶
+
+
+
+
+
+
+ Bases: StrategyProtocol
This strategy works under the assumption that
+StrategyLocationReinforcement.available_measures
+ARE NOT ordered by "compatibility".
+Thus we need to check first which are the compatible reinforcements
+per cluster.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+generate_subcluster_options(from_cluster: InfraCluster, min_length: int) -> list[list[InfraCluster]]
+
+
+ staticmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Generates all possible combinations of (sub) clusters based on the locations +of this cluster. These are also referred as "options".
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
min_length |
+
+ int
+ |
+ Minimum length for a cluster to be valid. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ list[list[InfraCluster]]
+ |
+ list[list[InfraCluster]]: Collection of "options" with valid length. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_common_available_measures_costs(infra_cluster: InfraCluster, order_strategy_reinforcements: list[type[ReinforcementProfileProtocol]]) -> dict[type[ReinforcementProfileProtocol], float]
+
+
+ staticmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Gets a dictionary with the reinforcements available at all
+locations of the cluster (infra_cluster) as well as their
+total cost if said reinforcement is applied at them.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
infra_cluster |
+
+ InfraCluster
+ |
+ Cluster being analyzed. |
+ + required + | +
order_strategy_reinforcements |
+
+ list[type[ReinforcementProfileProtocol]]
+ |
+ Reinforcements ordered by base cost (ground surface). |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ dict[type[ReinforcementProfileProtocol], float]
+ |
+ dict[type[ReinforcementProfileProtocol], float]: +Resulting reinforcement type - costs dictionary. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ OrderStrategy
+
+
+¶
+
+
+
+
+
+
+ Bases: StrategyProtocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_default_order_for_reinforcements() -> list[type[ReinforcementProfileProtocol]]
+
+
+ staticmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+Give the default order for reinforcements types, +assuming they are sorted from cheapest to most expensive +and least to most restrictive.
+ +Returns:
+| Type | +Description | +
|---|---|
+ list[type[ReinforcementProfileProtocol]]
+ |
+ list[type[ReinforcementProfileProtocol]]: list of reinforcement types |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_strategy_order_for_reinforcements(strategy_reinforcements: list[StrategyReinforcementInput]) -> list[type[ReinforcementProfileProtocol]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Give the ordered reinforcement types for this strategy, from cheapest to most expensive, +possibly removing reinforcement types that are more expensive and more restrictive than others. +Cofferdam should always be the last reinforcement type.
+ +
+
+ Input
+strategy_reinforcements (list[StrategyReinforcementInput]): list of reinforcement types with costs and surface
+Returns:
+| Type | +Description | +
|---|---|
+ list[type[ReinforcementProfileProtocol]]
+ |
+ list[type[ReinforcementProfileProtocol]]: list of reinforcement types |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_strategy_reinforcements(strategy_locations: list[StrategyLocationInput], selection_order: list[type[ReinforcementProfileProtocol]]) -> list[StrategyLocationReinforcement]
+
+
+ staticmethod
+
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Gets the strategy representation of the locations with their available measures
+ordered filtered and order by the provided selection_order. It also sets
+their initial state.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
strategy_locations |
+
+ list[StrategyLocationInput]
+ |
+ Locations to map into reinforcement locations. |
+ + required + | +
selection_order |
+
+ list[type[ReinforcementProfileProtocol]]
+ |
+ Priority order to assign a reinforcement. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ list[StrategyLocationReinforcement]
+ |
+ list[StrategyLocationReinforcement]: Mapped location reinforcements. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyInput
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents the input data structure for a strategy.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+reinforcement_min_cluster: int
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Returns the minimum length of a reinforcement type
+along a traject, usually named as cluster throughout
+the code.
Returns:
+| Name | Type | +Description | +
|---|---|---|
int |
+ int
+ |
+
|
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyLocationReinforcement
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents a location and the different reinforcements that can be applied to it +as well their costs. +This class is used to show the final chosen state for a location.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_cost: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Estimates the costs at this location for the given current_selected_measure.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_selected_measure: type[ReinforcementProfileProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Exposes the current selected measure for this object.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs(reinforcement_type: type[ReinforcementProfileProtocol]) -> tuple[float, float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Returns the infrastructure costs for the given reinforcement type (without and with surtax).
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ tuple[float, float]
+ |
+ tuple[float, float]: Tuple containing the infrastructure costs without and with surtax. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_selected_measure_steps() -> tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Outputs the selected measure following the domain (expected) steps: + - Initial step, + - Order step, + - Infrastructure step
+ +Returns:
+| Type | +Description | +
|---|---|
+ tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+ |
+ tuple[ +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol]]: Resulting tuple. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+set_selected_measure(reinforcement_type: type[ReinforcementProfileProtocol], step: StrategyStepEnum)
+
+¶
+
+
+
+
+
+
+
+
+
+
+Changes the value reprsented in current_selected_measure and updates the
+dictionary of selections (history).
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type |
+ + required + | +
step |
+
+ StrategyStepsEnum
+ |
+ Step whose |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyOutput
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents the output data structure for a strategy.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: Protocol
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+apply_strategy(strategy_input: StrategyInput) -> StrategyOutput
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Applies a specific strategy by matching each location (PointSurroundings)
+ to a valid reinforcement type (ReinforcementProfileProtocol).
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
strategy_input |
+
+ `StrategyInput`
+ |
+ Input data structure containing locations and available reinforcements for each of them. |
+ + required + | +
Returns:
+| Name | Type | +Description | +
|---|---|---|
StrategyOutput |
+ StrategyOutput
+ |
+ Output data structure containing the selected reinforcements for each location. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ InfraCluster
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+This dataclass represents the subset of locations sharing the same
+reinforcement type (type[ReinforcementProfileProtocol]).
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_cost: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Calculates the cost of applying the reinforcement_type to
+all locations present in the cluster.
Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ The total (current) cost of this cluster. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+fits_subclusters() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Validates whether this cluster can be split into subclusters. +For that it requires to have at least twice the required length.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ Whether subclusters can be generated from this one. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+is_valid() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Validates the length of this cluster.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ The cluster has the minimal required length. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+set_cheapest_common_available_measure(measure_costs: dict[type[ReinforcementProfileProtocol], float]) -> None
+
+¶
+
+
+
+
+
+
+
+
+
+
+Updates all the location reinforcements with the cheapest reinforcement type
+from the measure_costs.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
measure_costs |
+
+ dict[type[ReinforcementProfileProtocol]]
+ |
+ dictionary with the total costs per reinforcement type. |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ StrategyLocationReinforcement
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents a location and the different reinforcements that can be applied to it +as well their costs. +This class is used to show the final chosen state for a location.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_cost: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Estimates the costs at this location for the given current_selected_measure.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_selected_measure: type[ReinforcementProfileProtocol]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Exposes the current selected measure for this object.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_infrastructure_costs(reinforcement_type: type[ReinforcementProfileProtocol]) -> tuple[float, float]
+
+¶
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Returns the infrastructure costs for the given reinforcement type (without and with surtax).
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type. |
+ + required + | +
Returns:
+| Type | +Description | +
|---|---|
+ tuple[float, float]
+ |
+ tuple[float, float]: Tuple containing the infrastructure costs without and with surtax. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+get_selected_measure_steps() -> tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+
+¶
+
+
+
+
+
+
+
+
+
+
+Outputs the selected measure following the domain (expected) steps: + - Initial step, + - Order step, + - Infrastructure step
+ +Returns:
+| Type | +Description | +
|---|---|
+ tuple[type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol], type[ReinforcementProfileProtocol]]
+ |
+ tuple[ +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol], +type[ReinforcementProfileProtocol]]: Resulting tuple. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+set_selected_measure(reinforcement_type: type[ReinforcementProfileProtocol], step: StrategyStepEnum)
+
+¶
+
+
+
+
+
+
+
+
+
+
+Changes the value reprsented in current_selected_measure and updates the
+dictionary of selections (history).
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
reinforcement_type |
+
+ type[ReinforcementProfileProtocol]
+ |
+ Reinforcement type |
+ + required + | +
step |
+
+ StrategyStepsEnum
+ |
+ Step whose |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ InfraCluster
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+This dataclass represents the subset of locations sharing the same
+reinforcement type (type[ReinforcementProfileProtocol]).
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+current_cost: float
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+
+
+
+Calculates the cost of applying the reinforcement_type to
+all locations present in the cluster.
Returns:
+| Name | Type | +Description | +
|---|---|---|
float |
+ float
+ |
+ The total (current) cost of this cluster. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+fits_subclusters() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Validates whether this cluster can be split into subclusters. +For that it requires to have at least twice the required length.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ Whether subclusters can be generated from this one. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+is_valid() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Validates the length of this cluster.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ The cluster has the minimal required length. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+set_cheapest_common_available_measure(measure_costs: dict[type[ReinforcementProfileProtocol], float]) -> None
+
+¶
+
+
+
+
+
+
+
+
+
+
+Updates all the location reinforcements with the cheapest reinforcement type
+from the measure_costs.
Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
measure_costs |
+
+ dict[type[ReinforcementProfileProtocol]]
+ |
+ dictionary with the total costs per reinforcement type. |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ InfraClusterOption
+
+
+
+ dataclass
+
+
+¶
+
+
+
+
+
+
+
+Represents one set of subclusters the strategy could select +for costs optimization.
+ + + + + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+add_cluster(infra_cluster: InfraCluster, cluster_costs: dict)
+
+¶
+
+
+
+
+
+
+
+
+
+
+Adds the infra cluster into the collection as well as its reinforcement +costs.
+ +Parameters:
+| Name | +Type | +Description | +Default | +
|---|---|---|---|
infra_cluster |
+
+ InfraCluster
+ |
+ Cluster to add to this collection option. |
+ + required + | +
cluster_costs |
+
+ dict
+ |
+ Reinforcement costs for the given cluster. |
+ + required + | +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+cluster_collection: list[InfraCluster]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Read-only property to expose the stored subclusters.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+cluster_costs: list[dict[ReinforcementProfileProtocol, float]]
+
+
+ property
+
+
+¶
+
+
+
+
+
+
+Read-only property to expose the stored costs.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+set_cheapest_option()
+
+¶
+
+
+
+
+
+
+Sets the subclusters defined in this option to their most optimal (cheapest) +reinforcement possible.
+ +
+
+
+
+
+
+
+
+
+
+
+
+
+
+valid_option() -> bool
+
+¶
+
+
+
+
+
+
+
+
+
+
+Validates the collection of clusters based on the +required minimun length.
+ +Returns:
+| Name | Type | +Description | +
|---|---|---|
bool |
+ bool
+ |
+ Validation result. |
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+ Strategy step¶
+ + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ReinforcementProfileProtocol
+
+
+¶
+
+
+
+
+
+
+ Bases: KoswatProfileProtocol, Protocol
Extension of the KoswatProfileProtocol to define the properties of a calculated reinforcement.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_main_workflow.html b/reference/koswat_main_workflow.html
new file mode 100644
index 00000000..2a0e4d47
--- /dev/null
+++ b/reference/koswat_main_workflow.html
@@ -0,0 +1,270 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Main workflow¶
+As described in the user manual, the tool can be used either as a sandbox, where the user has responsibility on how to put together an analysis, or as a command line tool.
+When using the latter unfortunately we will only have one available call, in this chapter we will breakdown this main workflow so that we can better understand the structure of the rest of the package.
+First of all, let's write the workflow as a pipeline:
+CLI call
+-> Import of ini files
+-> Run scenarios
+ -> Generate reinforcement profiles
+ -> Calculate reinforcement costs
+ -> Apply measure selection strategy
+ -> Calculate total costs
+ -> Export results
+ |
+
|---|
| Image 1. General Workflow | +
CLI Call¶
+This step is very straightforward, the command line will run the method run_analysis, which will initiate the KoswatHandler and start an analysis.
Import of ini files¶
+This step comprehends of several more steps. Usually, for each of the file imports an internal workflow will happen:
+File -> Import -> File Object Model -> Build -> Data Object Model
This step is summarized by the generation of the KoswatRunSettings object.
Run scenarios¶
+Each KoswatRunScenarioSettings will run a koswat analysis for a given dike section.
+To do so, a specific KoswatProfileBase will be created based on the conditions from the KoswatScenario and the surroundings of said dike section.
Generate reinforcement profiles¶
+All reinforcement profiles will be calculated for the scenario KoswatProfileBase profile.
Calculate reinforcement costs¶
+For this step, we will be creating a cost report +For each of the reinforcement profiles we will calculate their associated costs if they were to be applied at all the available traject points where the surroundings allow it.
+Apply measure selection strategy¶
+Based on the available locations and the reinforcements that can be applied to it, a selection strategy finds which construction should be done at each location based on the strategy's criteria.
+Calculate total costs¶
+Once Koswat knows which measure will be applied to each location, and with the previously calculated reinforcement costs, it will estimate the total meters required of each reinforcement and their total cost in euros (€).
Export results¶
+Once the costs reports are generate each of the summaries is exported to a *.csv file whilst the reinforcement profiles 'layers' are also exported into different *.png files.
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_reinforced_profile.html b/reference/koswat_reinforced_profile.html
new file mode 100644
index 00000000..9befbbaa
--- /dev/null
+++ b/reference/koswat_reinforced_profile.html
@@ -0,0 +1,231 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Reinforcement profile¶
+In koswat we consider a reinforcement profile the result of applying one of the multiple possible reinforcement calculations on an instance of a KoswatProfileBase (Koswat dike).
This chapter covers the description of a reinforcement profile and its parts.
+Properties¶
+A reinforcement profile implements the ReinforcementProfileProtocol, which is a specialization of the KoswatProfileProtocol with some differences:
-
+
input_data: Similar to the base profileinput_databut instead implements theReinforcementInputProfileProtocol, a specialization of the (KoswatInputProfileProtocol) which depends on the type of reinforcement being applied.
+old_profile: New property which contains the koswat profile from which the calculation was based on.
+
Possible reinforcements.¶
+We have two main different sort of reinfocements which contain also subtypes for said reinforcements:
+-
+
- Outside slope reinforcement: Cofferdam (kistdam), based on the
OutsideSlopeReinforcementProfile. With this reinforcement the outside slope (buiten talud) of the dike is impacted.
+ - Standard reinforcement: Piping wall (kwelscherm), soil (grondmaatregel profiel), stability wall (stabiliteitswand), vertical piping solution (verticale piping oplossing). The previous being based on the
StandardReinforcementProfile.
+ - A piping wall can be implemented by a cb wall (cement-bentoniet wand) and an unanchored sheet pile (onverankerde damwand). +
- A stability wall can be implemented by a diaphragm wall (diepwand) and an anchored sheet pile (verankerde damwand). +
In addition, the above mentioned reinforcements can also implement their own ReinforcementInputProfileProtocol, which are after all extensions of the KoswatInputProfileBase with extra properties.
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_strategies.html b/reference/koswat_strategies.html
new file mode 100644
index 00000000..ef7b2fda
--- /dev/null
+++ b/reference/koswat_strategies.html
@@ -0,0 +1,994 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Strategies¶
+Koswat can determine which is the "best" reinforcement type for a dike traject based on different selection criteria that we name "strategies" (StrategyProtocol).
A strategy requires a strategy input (StrategyInput), this input contains information over which reinforcement types are available at each location as well as what's the minimal buffer (reinforcement_min_buffer) and minimal length (reinforcement_min_length) for each reinforcement type.
By default a strategy is applied as follows:
+-
+
- For each point (meter) in the traject, determine which reinforcements can be applied to it. +
- Choose one of the available reinforcements based on the chosen strategy. When no reinforcement is available the most restrictive will be chosen (
CofferDam).
+ - Apply a buffer (
reinforcement_min_buffer) for each one of the reinforcements.
+ - Check if the minimal distance between constructions is met (
reinforcement_min_length), otherwise change it into one of the reinforcements next to it.
+ - Repeat 4 until all reinforcements have enough distance between themselves. +
- Find based on the strategy for infrastructure derived costs, mapped locations (
list[StrategyLocationReinforcement]) whose reinforcement can be increased into a most restrictive one with total lower costs.
+ - Return list of mapped locations (
list[StrategyLocationReinforcement]).
+
Available strategies¶
+Currently the following strategies are implemented:
+-
+
- Order based +
- Infrastructure priority, by default the strategy to run during a Koswat analysis. +
Order based¶
+This strategy is the first and default of all defined strategies. Its criteria is based on a pre-defined 'order' of each reinforcement. In steps, it can be seen as:
+-
+
- Pre-selection of a location's available reinforcement based on said order, when a location does not have any "available" reinforcement, then the last reinforcement's order will be pre-selected. +
- Grouping of all locations by their pre-selected reinforcement. +
- Buffering to each of the groupings. +
- Clustering to the resulting groupings from the previous step. +
Reinforcement order¶
+The reinforcements are ordered based on increasing cost (including surtax) and decreasing width.
+Reinforcements that are more expensive but are wider or have equal width are skipped (order -1).
+The CofferDamReinforcementProfile will never be skipped and is always the last reinforcement that is applied in case no other reinforcement fits the surroundings.
| Reinforcement type | +Profile width | +Cost with surtax | +Index | +
|---|---|---|---|
SoilReinforcementProfile |
+10 | +100 | +0 | +
VPSReinforcementProfile |
+20 | +200 | +-1 | +
PipingWallReinforcementProfile |
+10 | +300 | +-1 | +
StabilityWallReinforcementProfile |
+5 | +400 | +1 | +
CofferDamReinforcementProfile |
+0 | +500 | +2 | +
Reinforcement grouping¶
+We create reinforcement-location "grouping" for the whole traject.
+A grouping represents a reinforcement type that is "selected" for a series of continuous locations. This means locations that are next to each other sharing the same measure type (Type[ReinforcementProfileProtocol]).
Grouping example¶
+Simplified representation for a traject with 10 locations. This example is also tested in the tests.strategies.order_strategy.py test file.
+
{
+ "SoilReinforcementProfile": [
+ "Location_000",
+ "Location_001",
+ "Location_002",
+ ],
+ "StabilityWallReinforcementProfile": [
+ "Location_003",
+ "Location_004",
+ ],
+ "SoilReinforcementProfile": [
+ "Location_005",
+ "Location_006",
+ "Location_007",
+ ],
+ "CofferDamReinforcementProfile": [
+ "Location_008",
+ "Location_009",
+ ],
+}
+Reinforcement buffering¶
+Given a reinforcement grouping, we will create a dictionary of masks of size NM where N (the keys) is the number of available reinforcement types (Type[ReinforcementProfileProtocol]) and M the number of available locations.
Note: Masks' values are the position of a reinforcement type in the reinforcement's order list. So a location withCofferDamReinforcementProfile will have a 4 at the mask's position, whilst a SoilReinforcementProfile will have a 0 instead (remember in Python indexing starts with 0).
Steps breakdown:
+-
+
-
+
Initialize the dictionary masks with all values to -1.
+
+ -
+
Iterate over the groupings list, and for each entry:
+-
+
-
+
Select the mask to update using the grouping's reinforcement type (cluster's key).
+
+ -
+
Update the indices representing the grouping's locations (grouping's values) with the matching value for this grouping's key (see previous note).
+
+ -
+
Add a buffer (
+StrategyInput.reinforcement_min_buffer) by updating the adjacent's positions of this grouping with the same values as in step 1.
+
+ -
+
-
+
Merge all masks into a 1-dimensional array where the cell's value is the maximum between the available masks.
+-
+
- This is done to prevent that a buffer of a "stronger" demanding reinforcement such as
CofferDamReinforcementProfileis replaced by a "weaker" one.
+
+ - This is done to prevent that a buffer of a "stronger" demanding reinforcement such as
-
+
Update the locations with their new associated reinforcement. The resulting mask contains the index of the reinforcement to be applied in the reinforcement's order.
+
+
Buffering example¶
+One simplified example, based on the grouping example, and using a buffer value of "1". This example is also tested in the tests.strategies.order_strategy_buffering.py test file.
1. Initialize the masks based on the provided clusters:
+ {
+ "SoilReinforcementProfile":
+ [-1, -1, -1, -1, -1, -1 ,-1, -1, -1, -1],
+ "VPSReinforcementProfile":
+ [-1, -1, -1, -1, -1, -1 ,-1, -1, -1, -1],
+ "PipingWallReinforcementProfile":
+ [-1, -1, -1, -1, -1, -1 ,-1, -1, -1, -1],
+ "StabilityWallReinforcementProfile":
+ [-1, -1, -1, -1, -1, -1 ,-1, -1, -1, -1],
+ "CofferDamReinforcementProfile":
+ [-1, -1, -1, -1, -1, -1 ,-1, -1, -1, -1],
+ }
+
+2. Iterate over the clusters and update the masks' values:
+ {
+ "SoilReinforcementProfile":
+ [ 0, 0, 0, 0, 0, 0, 0, 0, 0, -1],
+ "VPSReinforcementProfile":
+ [-1, -1, -1, -1, -1, -1, -1, -1, -1, -1],
+ "PipingWallReinforcementProfile":
+ [-1, -1, -1, -1, -1, -1, -1, -1, -1, -1],
+ "StabilityWallReinforcementProfile":
+ [-1, -1, 3, 3, 3, 3, -1, -1, -1, -1],
+ "CofferDamReinforcementProfile":
+ [-1, -1, -1, -1, -1, -1, -1, 4, 4, 4],
+ }
+
+3. Merge all masks and select their maximum value:
+ [0, 0, 3, 3, 3, 3, 0, 4, 4, 4]
+
+4. Update the cluster's locations:
+ {
+ "SoilReinforcementProfile": [
+ "Location_000",
+ "Location_001",
+ ],
+ "StabilityWallReinforcementProfile": [
+ "Location_002",
+ "Location_003",
+ "Location_004",
+ "Location_005",
+ ],
+ "SoilReinforcementProfile": [
+ "Location_006",
+ ],
+ "CofferDamReinforcementProfile": [
+ "Location_007",
+ "Location_008",
+ "Location_009",
+ ],
+ }
+Reinforcement clustering¶
+Given a reinforcement grouping, ideally done after applying buffering, we will now proceed to change the pre-selected reinforcement of all those groupings that contain less locations than required by the describing property. We do this by updating their type with the one of a "stronger" adjacent grouping, on this section called "clusters". These clusters are internally represented by the class OrderCluster.
The strategy here is to detect non-compliant reinforcement-location clusters and replace their selected reinforcement type with the "least strong" of its adjacent clusters. We do this iteratively, so we first target the lowest type of reinforcements (SoilReinforcementProfile) and we move up until the first to the last (the last one cannot be further strengthened).
Conditions:
+-
+
- We define a non-compliant cluster as a cluster that does not contain as many locations as defined by the minimal length requirement (
reinforcement_min_length).
+ - We also define a non-compliant exception when a cluster does not meet said requirement but the adjacent clusters are of a lower reinforcement type. Therefore retaining their initial reinforcement type. +
- The first and last clusters, are always considered compliant. Therefore they retain their initial reinforcement type. +
- Clusters whose reinforcement type is placed the last in the strategy's order, are skipped and always considered compliant, as they cannot be further strengthened. +
Steps breakdown:
+-
+
- Generate a list of all available unmerged clusters. +
- For each reinforcement type target-reinforcement, in the strategy order:
-
+
- Get the current non-compliant clusters +
- For each non-compliant target-reinforcement cluster :
-
+
- Check if its indeed not compliant.
-
+
- Otherwise move to the next cluster. +
+ - Get a stronger cluster among the neighbors. Selects the neighbor with the
+"weakest", yet greater than the actual, reinforcement type value.
-
+
- If both neighbors are "weaker" than the current reinforcement type, +then it is considered an "exception" as it cannot be further strengthened. +We therefore move to the next non-compliant cluster. +
+ - Move the current cluster's locations to the stronger reinforcement cluster. +
- Remove the cluster from the "available clusters" list as it is integrated in +step 2.2.3. +
+ - Check if its indeed not compliant.
+
Clustering example¶
+One simplified example, based on the buffering example, and using a minimal distance of "5". This example is also tested in the tests.strategies.order_strategy_clustering.py test file.
1. List of unmerged clusters:
+ {
+ (0, ["Location_000","Location_001",]),
+ (3, ["Location_002","Location_003","Location_004","Location_005",]),
+ (0, ["Location_006",]),
+ (4, ["Location_007","Location_008","Location_009",])
+ }
+
+2. Iterate over each reinforcement type:
+
+2.1. Target is "SoilReinforcementProfile" (idx=0), non-compliant clusters
+ {
+ (0, ["Location_006",])
+ }
+
+2.1.1. Length = 1.
+
+2.1.2. Get a stronger neighbor,
+ - Left-neighbor reinforcement type = 3,
+ - Right-neighbor reinforcement type = 4,
+ - Left-neighbor is selected.
+
+2.1.3. Move locations to stronger neighbor.
+ {
+ (2, ["Location_002", ... ,"Location_006",]),
+ (0, ["Location_006",]),
+ }
+
+2.1.4. Remove the current cluster from the available list.
+
+2.2. Target is "PipingWallReinforcementProfile" (idx=2),
+ - All clusters are compliant at this point.
+
+2.3. Target is "StabilityWallReinforcementProfile" (idx=3),
+ - All clusters are compliant at this point.
+
+2.4. "CofferDamReinforcementProfile" (idx=4)
+ - Last reinforcement profile type, therefore the strongest.
+
+Resulting cluster:
+ {
+ (0, ["Location_000","Location_001",]),
+ (3, ["Location_002","Location_003","Location_004","Location_005","Location_006",]),
+ (4, ["Location_007","Location_008","Location_009",]),
+ }
+Infrastructure priority¶
+DEFAULT STRATEGY +This strategy checks whether the clusters resulting from the order based strategy can change their selected reinforcement to one with cheaper costs. These costs are extracted from the cost report and relate to the reinforcement profile costs (dike's materials for the required space) and the possible infrastructure costs. In steps, this strategy can be broke down as:
+Steps breakdown:
+-
+
- Assignment of order based clusters, +
- Cluster options evaluation,
-
+
- Common available measures cost calculation, +
- Cheapest option selection, +
+ - Update reinforcement selection with selected option. +
Cluster options¶
+For an optimal assignment of a new reinforcement profile, we make use of "subclusters". These subclusters are contiguous subsets from an order based cluster and have the minimal required length (StrategyInput.reinforcement_min_cluster). The logic for this section can be found in InfraPriorityStrategy.generate_subcluster_options.
For each of original the clusters, multiple combinations of subclusters are possible. We refer to them as "cluster option" (InfraClusterOption) . We can already discard creating subclusters when the size of the original cluster is less than twice the required minimal length. So for a minimal length of 2 locations, you require a cluster of at least 4 locations to generate subclusters.
Conditions:
+-
+
- We only create subclusters when the cluster's original size is, at least, twice the required minimal cluster's length. +
- We estimate the cluster's minimal length to be at least twice the size of the buffer so:
min_cluster_length = (2 * reinforcement_min_buffer) + 1.
+ - We create subclusters based on the immediate results of the order based strategy. We do not try to combine or create new clusters based on a "greedier" strategy. +
Cluster option example¶
+For example, given the results of the clustering example we can calculate the options for the clusters for a required minimal length of 2:
-
+
- List of clusters:
+
{ + (0, ["Location_000","Location_001",]), + (3, ["Location_002","Location_003", + "Location_004","Location_005", + "Location_006",]), + (4, ["Location_007","Location_008","Location_009",]), +} +
+ -
+
Options for cluster
{(0, ["Location_000","Location_001",])}++- Valid options: + (0, ["Location_000","Location_001",]) +
+ -
+
Options for cluster
{(3, ["Location_002","Location_003", "Location_004","Location_005", "Location_006",])}++- Valid: + - {["Location_002", "Location_003"], + ["Location_004", "Location_005", "Location_006"]}, + - {["Location_002", "Location_003", "Location_004"], + ["Location_005", "Location_006"]} +- Invalid: + - first subcluster's size is less than required: + {["Location_002"], + ["Location_003", "Location_004"], + ["Location_005", "Location_006"]} + + - last subcluster's size is less than required: + {["Location_002", "Location_003"], + ["Location_004", "Location_005"], + ["Location_006"]}, + - second subcluster's size is less than required: + {["Location_002", "Location_003"], + ["Location_004"], + ["Location_005", "Location_006"]}, + - and so on... +
+ -
+
Options for cluster
{(4, ["Location_007","Location_008","Location_009",]),}++- Valid: + - {["Location_007","Location_008","Location_009",]} +- Invalid: + - first subcluster's size is less than required: + {["Location_007"], ["Location_008", "Location_009"]} + - last subcluster's size is less than required: + {["Location_007", "Location_008"], ["Location_009"]} + - and so on... +
+
Cluster common available measures' cost¶
+Once we have calculated a cluster's option we can determine whether this cluster should be consider as a valid one. This estimation is based on the cheapest reinforcement's cost, and to get this value we first need to know which reinforcements are available at all the locations of this option.
+We will store this value in the InfraClusterOption.cluster_costs. In the current implementation, these costs are added to the InfraClusterOption together with the cluster's data (list[InfraCluster]).
Conditions:
+-
+
- A "viable" cluster option must be cheaper than the order's cluster and has the cluster's minimal length. +
- We consider "minimal costs" or "lower costs" as the lowest cost of applying a certain reinforcement type to a given subcluster. +
Common available measures' cost example¶
+Following the options example we can estimate some fictional costs based on the following tables (if a type / location is not mentioned, then assume its cost is zero (0)):
| Index | +Reinforcement type | +base cost | +
|---|---|---|
| 0 | +Soil reinforcement | +42 | +
| 1 | +Vertical Piping Solution | +420 | +
| 2 | +Piping Wall | +4.200 | +
| 3 | +Stability Wall | +42.000 | +
| 4 | +Cofferdam | +420.000 | +
| Location | +Reinforcement indices | +Infrastructure cost | +
|---|---|---|
| Location_000 | +0, 1 | +4.200.000 | +
| Location_005 | +0, 1, 2, 3 | +4.200.000 | +
We already know that only the second cluster can generate subclusters, therefore different valid options, so we will use said subcluster's options for the example.
+1. Determine current cost:
+ - {3, ["Location_002", "Location_003",
+ "Location_004", "Location_005", "Location_006"]}
+ - Base costs = 5 * 42.000 = 210.000
+ - Infra costs = (1) * 4.200.000 = 4.200.000
+ - Total costs = 4.410.000
+
+2. Calculate costs for first option:
+ - {(3, ["Location_002", "Location_003"],
+ ["Location_004", "Location_005", "Location_006"])},
+ 1. First subcluster's common measures:
+ - Stability Wall (current):
+ - Base costs = 2 * 42.000 = 84.000
+ - Infra costs = 0
+ - Total costs = 42.000
+ - Cofferdam:
+ - Base costs = 2 * 420.000 = 840.000
+ - Infra costs = 0
+ - Total costs = 840.000
+ - The current reinfocement is cheaper
+ 2. Second subcluster's common measures:
+ - Stability Wall (current):
+ - Base costs = 3 * 42.000 = 126.000
+ - Infra costs = (1) * 4.200.000 = 4.200.000
+ - Total costs = 4.326.000
+ - Cofferdam:
+ - Base costs = 3 * 420.000 = 1.260.000
+ - Infra costs = 0
+ - Total costs = 1.260.000
+ - Cofferdam will be cheaper.
+ 3. Subcluster's best option is cheaper than current:
+ - {(3, ["Location_002", "Location_003"]),
+ (4, ["Location_004", "Location_005", "Location_006"])}
+ - Total cost = 42.000 + 1.260.000 = 1.302.000
+ - Selected as option.
+
+3. Calculate costs for second option:
+ - {3, (["Location_002", "Location_003", "Location_004"],
+ ["Location_005", "Location_006"])}
+ 1. First subluster's common measures
+ - Stability Wall (current):
+ - Base costs = 3 * 42.000 = 126.000
+ - Infra costs = 0
+ - Total costs = 126.000
+ - Cofferdam:
+ - Base costs = 3 * 420.000 = 1.260.000
+ - Infra costs = 0
+ - Total costs = 1.260.000
+ - The current reinfocement is cheaper
+ 2. Second subluster's common measures
+ - Stability Wall (current):
+ - Base costs = 2 * 42.000 = 84.000
+ - Infra costs = 0
+ - Total costs = 84.000
+ - Cofferdam:
+ - Base costs = 2 * 420.000 = 840.000
+ - Infra costs = 0
+ - Total costs = 840.000
+ - Cofferdam is cheaper
+ 3. Subcluster's best option is cheaper than selection:
+ - {(3, ["Location_002", "Location_003", "Location_004"]),
+ (4, ["Location_005", "Location_006"])}
+ - Total cost = 126.000 + 840.000 = 966.000
+ - Selected as option.
+
+4. Update locations' selected reinforcement:
+{
+ (2, ["Location_000","Location_001",]),
+ (3, ["Location_002","Location_003", "Location_004",]),
+ (4, ["Location_005","Location_006", "Location_007",
+ "Location_008","Location_009",]),
+}
+In this example we can therefore demonstrate the cost reduction. The last column represents the difference (positive means saved money):
+-
+
- O.S. = Order strategy +
- I.S. = Infrastructure priority strategy +
| Location | +(O.S.) reinforcement | +(O.S.) cost | +(I.S.) reinforcement | +(I.S.) cost | +Difference | +
|---|---|---|---|---|---|
| Total | +---- | +6.090.084 | +---- | +2.226.840 | ++3.863.244 | +
| Location_000 | +Soil reinforcement | +4.200.042 | +Piping Wall | +420 | ++4.199.622 | +
| Location_001 | +Soil reinforcement | +42 | +Piping Wall | +420 | +-378 | +
| Location_002 | +Stability Wall | +42.000 | +Stability Wall | +42.000 | +0 | +
| Location_003 | +Stability Wall | +42.000 | +Stability Wall | +42.000 | +0 | +
| Location_004 | +Stability Wall | +42.000 | +Stability Wall | +42.000 | +0 | +
| Location_005 | +Stability Wall | +462.000 | +Cofferdam | +420.000 | ++42000 | +
| Location_006 | +Stability Wall | +42.000 | +Cofferdam | +420.000 | +-378000 | +
| Location_007 | +Cofferdam | +420.000 | +Cofferdam | +420.000 | +0 | +
| Location_008 | +Cofferdam | +420.000 | +Cofferdam | +420.000 | +0 | +
| Location_009 | +Cofferdam | +420.000 | +Cofferdam | +420.000 | +0 | +
Infrastructure priority (old approach) example¶
++
++Important! +This example is based on the first approach of this strategy and its steps might differ from the current solution. We left this example as it can help understanding the basic concepts of the strategy.
+
+
We will start by defining some unrealistic costs per reinforcement type for all locations* such as. For a more realistic scenario check the subclustering example:
+| Index | +Reinforcement type | +base cost | +infra cost | +total cost | +
|---|---|---|---|---|
| 0 | +Soil reinforcement | +42 | +420.000 | +420.042 | +
| 1 | +Vertical Piping Solution | +420 | +420.000 | +420.420 | +
| 2 | +Piping Wall | +4200 | +0 | +4200 | +
| 3 | +Stability Wall | +42.000 | +420.000 | +462.000 | +
| 4 | +Cofferdam | +420.000 | +0 | +420.000 | +
+
++Important! +For example purposes we are applying the same infrastructure costs to all the locations. |However, in a real case these costs would vary per location (and per reinforcement type). So we can determine the cluster's reinforcement costs as
+(total cost) * N locations
+
Based on this data Piping Wall will be chosen unless any of the points in the cluster cannot apply it due to obstacles or other constraints, in which case it would end up settling for a Cofferdam reinforcement.
Let's see now the strategy steps using the results from the clustering example:
+1. List of clusters:
+ {
+ (0, ["Location_000","Location_001",]),
+ (3, ["Location_002","Location_003",
+ "Location_004","Location_005",
+ "Location_006",]),
+ (4, ["Location_007","Location_008","Location_009",]),
+ }
+
+2. Iterate over each cluster:
+
+2.1. First cluster is:
+ { (0, ["Location_000","Location_001",]) }
+
+ 2.1.1. Get the current cost of using this cluster.
+ - Total costs * N locations = `(420042) * 2 = 840084`
+
+ 2.1.2. Get cheaper common available measures:
+ - Soil Reinforcement, (idx=0),
+ - [Discard] Current selection.
+ - Vertical Piping Solution, (idx=1),
+ - Costs = `(420.420) * 2 = 840.840`
+ - [Discard] Costs are higher than initial state.
+ - Piping Wall, (idx=2),
+ - Costs = `(4.200 + 0) * 2 = 8.400`
+ - [Keep] Costs are cheaper than the initial state.
+ - Stability Wall, (idx=3),
+ - Costs = `(462.000) * 2 = 924.000`
+ - [Discard] Costs are higher than initial state.
+ - Cofferdam, (idx=3),
+ - Costs = `(420.000) * 2 = 840.000`
+ - [Keep] Costs are cheaper than the initial state, keep.
+
+ 2.1.3. Set the cheapest common available measure per cluster:
+ - Piping wall < Cofferdam < Soil reinforcement (current)
+ - Piping wall is the new reinforcement for this cluster.
+
+ - Result: {(2, ["Location_000","Location_001",])}
+
+2.2. Second cluster is:
+ {(3, ["Location_002","Location_003",
+ "Location_004","Location_005",
+ "Location_006",])}
+
+ 2.3.1. Get the current cost of using this cluster.
+ - Total costs * N locations = `(462.000) * 5 = 2.310.000`
+
+ 2.3.2. Get cheaper common available measures.
+ - Soil Reinforcement, (idx=0),
+ - [Discard] Not present at "Location_003", "Location_004".
+ - Vertical Piping Solution, (idx=1),
+ - [Discard] Not present at "Location_003", "Location_004".
+ - Piping Wall, (idx=2),
+ - [Discard] Not present at "Location_003", "Location_004".
+ - Stability Wall, (idx=3),
+ - [Discard] Current selection.
+ - Cofferdam, (idx=3),
+ - Costs = `(420.000) * 5 = 2.100.000`
+ - [Keep] Costs are cheaper than the initial state.
+
+ 2.3.3. Set the cheapest common available measure per cluster:
+ - Cofferdam < Stability wall
+ - Cofferdam is the new reinforcement for this cluster.
+
+ - Result : {(4, ["Location_002","Location_003",
+ "Location_004","Location_005",
+ "Location_006",])}
+
+2.3. Third cluster is:
+ { (4, ["Location_007","Location_008",
+ "Location_009",])}}
+
+ 2.3.1. Get the current cost of using this cluster.
+ - Total costs * N locations = `(420.000) * 3 = 1.260.000`
+
+ 2.3.2. Get cheaper common available measures.
+ - Cofferdam, (idx=4),
+ - Current selection.
+
+ 2.3.3. Set the cheapest common available measure per cluster:
+ - Only cofferdam available,
+ - No further action.
+
+ - Result: {(4, ["Location_007","Location_008",
+ "Location_009",])}
+
+2.4. Resulting clusters:
+ {
+ (2, ["Location_000","Location_001",]),
+ (4, ["Location_002","Location_003",
+ "Location_004","Location_005",
+ "Location_006","Location_007",
+ "Location_008","Location_009",]),
+ }
+With this, we went from:
+-
+
- Initial costs:
(420.042) * 2 + (462.000) * 5 + (420.000) * 3 = 4.410.084, to
+ - Final costs:
(4.200) * 2 + (420.000) * 8 = 3.368.400
+
Which would amount to a total save of 1.041.684€
+ +
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/reference/koswat_surroundings.html b/reference/koswat_surroundings.html
new file mode 100644
index 00000000..e40982dd
--- /dev/null
+++ b/reference/koswat_surroundings.html
@@ -0,0 +1,309 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Surroundings
+
+
+
+
+ Surroundings¶
+In koswat's real domain, a dike is surrounded by all sort of surroundings, these could be nature or human-built structures. During our analyisis we make use of (.shp) maps where a dike's traject is shown together with all the human-built structures in its proximity.
We categorize these structures in the following two types:
+-
+
- Obstacles, surroundings that cannot be modified in any way. +
- Infrastructures, as opposite to the obstacles, surroundings that can be repaired or removed and added again (elsewhere). +
 |
+
|---|
| Image 1. Surroundings representation | +
To define said surroundings we make use of .csv files, each file for a specific type of surrounding that needs to be "enabled" in the koswat_general.ini settings file.
In addition, surroundings can be defined for the inside or the outside of a dike. At the current Koswat version (unreleased v0.15.0) we only support surroundings in the inside of a dike ( binnendijks).
Surroundings .csv files¶
+The surroundings files follow all the same format both in naming and content.
+Their file name has the form of T{dike_traject}_{type_of_surrounding}.csv:
+- The {dike_traject} is the dike's traject code name, usually something like 10_1,
+- the {type_of_surrounding} is the name of surrounding that will be imported (check further in the corresponding subsections of obstacles and infrastructure).
Their headers are divided in the following columns:
+-
+
SECTIE, section of the location in the dike's traject,
+Xcoord, x coordinate of the location,
+Ycoord, y coordinate of the location,
+afst_{x}m, distance from the reference point of the location, where 'x' are all the values between5and200with steps of 5, thus 40 columns. The values in these cells define whether there are obstacles or infrastructures at this distance or not and inKoswatare usually built in theSurroundingsPoint.surroundings_matrix, each type of surrounding interprets the weights in a different manner.
+
Obstacles¶
+An obstacle usually represents a building. Because they cannot be removed they become a constraint to the possible reinforcements that can be applied at a given location. For instance, if a dike's reinforcement will become 5 meters wider, but within that distance there are obstacles, said reinforcement will be discarded as a possible option at that location. +The distance from the reference point of the dike to the closes point of the obstacle is given.
+The values in the columns afst_{x}m are either 1 or 0 and are simply interpreted as having a surrounding or not. Thus ignoring other characteristics of the surrounding and just focusing on its presence.
Obstacle types¶
+Currently we identify and support the following surroundings as written in the .csv file names:
-
+
bebouwing_binnendijks(buildings),
+spoorwegen_binnendijks(railways),
+waters_binnendijks(waters),
+
As reminder, at the moment we only support 'inside the dike's' surroundings.
+Infrastructures¶
+Infrastructures are mostly "roads". Contrary to the obstacles these infrastructures do not become a boundary for a reinforcement and they will simply be either displaced or repaired when applying a reinforcement requires their space. When this occurs, it is reflected as additional costs for the given type of reinforcement at that location. In short, these costs are calculated based on:
+-
+
- The width of the infrastructure (taken from the
Koswat_general.inisettings),
+ - The length of the infrastructure at that location (the values in the columns
afst_{x}m),
+ - The required technique (repair, displace, nothing) for the type of infrastructure (also from
koswat_general.inisettings) and its related costs (koswat_costs.ini).
+
With the above values we know what's the affected area of an infrastructure when a reinforced profile needs to be applied and therefore can estimate their costs.
+The distance from the reference point of the dike to the center point of the infrastructure is given.
+Infrastructures types¶
+Currently we identify and support the following surroundings as written in the .csv file names:
-
+
wegen_binnendijks_klasse2(roads class 2),
+wegen_binnendijks_klasse7(roads class 7),
+wegen_binnendijks_klasse24(roads class 24),
+wegen_binnendijks_klasse47(roads class 47),
+wegen_binnendijks_klasseonbekend(roads of unknown class),
+
As reminder, at the moment we only support 'inside the dike's' surroundings.
+Surroundings in the code¶
+But, how are these surroundings represented in the code? As earlier described, we distinguish surroundings by either obstacles or infrastructures. This is also reflected in the code where we create a general SurroundingsWrapper, which as the name states, wraps the obstacle and infrastructure surroundings in separate properties, each implementing an specialitzation of the BaseSurroundingsWrapper so that:
-
+
ObstacleSurroundingsWrapperwill wrap all the supported obstacle types, in separate properties of typeSurroundingsObstacle.
+InfrastructureSurroundingsWrapperwill wrap all the supported infrastructure types, in separate properties of typeSurroundingsInfrastructure.
+
A simple diagram illustrating the above can be seen in the image below:
+ |
+
|---|
| Image 2. Surroundings code-wise | +
More detailed information can be found in the corresponding surroundings subproject.
+ +
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+
diff --git a/search.html b/search.html
new file mode 100644
index 00000000..a2065c5b
--- /dev/null
+++ b/search.html
@@ -0,0 +1,201 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Search Results
+ + + +
+ Searching...
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/search/lunr.js b/search/lunr.js
new file mode 100644
index 00000000..aca0a167
--- /dev/null
+++ b/search/lunr.js
@@ -0,0 +1,3475 @@
+/**
+ * lunr - http://lunrjs.com - A bit like Solr, but much smaller and not as bright - 2.3.9
+ * Copyright (C) 2020 Oliver Nightingale
+ * @license MIT
+ */
+
+;(function(){
+
+/**
+ * A convenience function for configuring and constructing
+ * a new lunr Index.
+ *
+ * A lunr.Builder instance is created and the pipeline setup
+ * with a trimmer, stop word filter and stemmer.
+ *
+ * This builder object is yielded to the configuration function
+ * that is passed as a parameter, allowing the list of fields
+ * and other builder parameters to be customised.
+ *
+ * All documents _must_ be added within the passed config function.
+ *
+ * @example
+ * var idx = lunr(function () {
+ * this.field('title')
+ * this.field('body')
+ * this.ref('id')
+ *
+ * documents.forEach(function (doc) {
+ * this.add(doc)
+ * }, this)
+ * })
+ *
+ * @see {@link lunr.Builder}
+ * @see {@link lunr.Pipeline}
+ * @see {@link lunr.trimmer}
+ * @see {@link lunr.stopWordFilter}
+ * @see {@link lunr.stemmer}
+ * @namespace {function} lunr
+ */
+var lunr = function (config) {
+ var builder = new lunr.Builder
+
+ builder.pipeline.add(
+ lunr.trimmer,
+ lunr.stopWordFilter,
+ lunr.stemmer
+ )
+
+ builder.searchPipeline.add(
+ lunr.stemmer
+ )
+
+ config.call(builder, builder)
+ return builder.build()
+}
+
+lunr.version = "2.3.9"
+/*!
+ * lunr.utils
+ * Copyright (C) 2020 Oliver Nightingale
+ */
+
+/**
+ * A namespace containing utils for the rest of the lunr library
+ * @namespace lunr.utils
+ */
+lunr.utils = {}
+
+/**
+ * Print a warning message to the console.
+ *
+ * @param {String} message The message to be printed.
+ * @memberOf lunr.utils
+ * @function
+ */
+lunr.utils.warn = (function (global) {
+ /* eslint-disable no-console */
+ return function (message) {
+ if (global.console && console.warn) {
+ console.warn(message)
+ }
+ }
+ /* eslint-enable no-console */
+})(this)
+
+/**
+ * Convert an object to a string.
+ *
+ * In the case of `null` and `undefined` the function returns
+ * the empty string, in all other cases the result of calling
+ * `toString` on the passed object is returned.
+ *
+ * @param {Any} obj The object to convert to a string.
+ * @return {String} string representation of the passed object.
+ * @memberOf lunr.utils
+ */
+lunr.utils.asString = function (obj) {
+ if (obj === void 0 || obj === null) {
+ return ""
+ } else {
+ return obj.toString()
+ }
+}
+
+/**
+ * Clones an object.
+ *
+ * Will create a copy of an existing object such that any mutations
+ * on the copy cannot affect the original.
+ *
+ * Only shallow objects are supported, passing a nested object to this
+ * function will cause a TypeError.
+ *
+ * Objects with primitives, and arrays of primitives are supported.
+ *
+ * @param {Object} obj The object to clone.
+ * @return {Object} a clone of the passed object.
+ * @throws {TypeError} when a nested object is passed.
+ * @memberOf Utils
+ */
+lunr.utils.clone = function (obj) {
+ if (obj === null || obj === undefined) {
+ return obj
+ }
+
+ var clone = Object.create(null),
+ keys = Object.keys(obj)
+
+ for (var i = 0; i < keys.length; i++) {
+ var key = keys[i],
+ val = obj[key]
+
+ if (Array.isArray(val)) {
+ clone[key] = val.slice()
+ continue
+ }
+
+ if (typeof val === 'string' ||
+ typeof val === 'number' ||
+ typeof val === 'boolean') {
+ clone[key] = val
+ continue
+ }
+
+ throw new TypeError("clone is not deep and does not support nested objects")
+ }
+
+ return clone
+}
+lunr.FieldRef = function (docRef, fieldName, stringValue) {
+ this.docRef = docRef
+ this.fieldName = fieldName
+ this._stringValue = stringValue
+}
+
+lunr.FieldRef.joiner = "/"
+
+lunr.FieldRef.fromString = function (s) {
+ var n = s.indexOf(lunr.FieldRef.joiner)
+
+ if (n === -1) {
+ throw "malformed field ref string"
+ }
+
+ var fieldRef = s.slice(0, n),
+ docRef = s.slice(n + 1)
+
+ return new lunr.FieldRef (docRef, fieldRef, s)
+}
+
+lunr.FieldRef.prototype.toString = function () {
+ if (this._stringValue == undefined) {
+ this._stringValue = this.fieldName + lunr.FieldRef.joiner + this.docRef
+ }
+
+ return this._stringValue
+}
+/*!
+ * lunr.Set
+ * Copyright (C) 2020 Oliver Nightingale
+ */
+
+/**
+ * A lunr set.
+ *
+ * @constructor
+ */
+lunr.Set = function (elements) {
+ this.elements = Object.create(null)
+
+ if (elements) {
+ this.length = elements.length
+
+ for (var i = 0; i < this.length; i++) {
+ this.elements[elements[i]] = true
+ }
+ } else {
+ this.length = 0
+ }
+}
+
+/**
+ * A complete set that contains all elements.
+ *
+ * @static
+ * @readonly
+ * @type {lunr.Set}
+ */
+lunr.Set.complete = {
+ intersect: function (other) {
+ return other
+ },
+
+ union: function () {
+ return this
+ },
+
+ contains: function () {
+ return true
+ }
+}
+
+/**
+ * An empty set that contains no elements.
+ *
+ * @static
+ * @readonly
+ * @type {lunr.Set}
+ */
+lunr.Set.empty = {
+ intersect: function () {
+ return this
+ },
+
+ union: function (other) {
+ return other
+ },
+
+ contains: function () {
+ return false
+ }
+}
+
+/**
+ * Returns true if this set contains the specified object.
+ *
+ * @param {object} object - Object whose presence in this set is to be tested.
+ * @returns {boolean} - True if this set contains the specified object.
+ */
+lunr.Set.prototype.contains = function (object) {
+ return !!this.elements[object]
+}
+
+/**
+ * Returns a new set containing only the elements that are present in both
+ * this set and the specified set.
+ *
+ * @param {lunr.Set} other - set to intersect with this set.
+ * @returns {lunr.Set} a new set that is the intersection of this and the specified set.
+ */
+
+lunr.Set.prototype.intersect = function (other) {
+ var a, b, elements, intersection = []
+
+ if (other === lunr.Set.complete) {
+ return this
+ }
+
+ if (other === lunr.Set.empty) {
+ return other
+ }
+
+ if (this.length < other.length) {
+ a = this
+ b = other
+ } else {
+ a = other
+ b = this
+ }
+
+ elements = Object.keys(a.elements)
+
+ for (var i = 0; i < elements.length; i++) {
+ var element = elements[i]
+ if (element in b.elements) {
+ intersection.push(element)
+ }
+ }
+
+ return new lunr.Set (intersection)
+}
+
+/**
+ * Returns a new set combining the elements of this and the specified set.
+ *
+ * @param {lunr.Set} other - set to union with this set.
+ * @return {lunr.Set} a new set that is the union of this and the specified set.
+ */
+
+lunr.Set.prototype.union = function (other) {
+ if (other === lunr.Set.complete) {
+ return lunr.Set.complete
+ }
+
+ if (other === lunr.Set.empty) {
+ return this
+ }
+
+ return new lunr.Set(Object.keys(this.elements).concat(Object.keys(other.elements)))
+}
+/**
+ * A function to calculate the inverse document frequency for
+ * a posting. This is shared between the builder and the index
+ *
+ * @private
+ * @param {object} posting - The posting for a given term
+ * @param {number} documentCount - The total number of documents.
+ */
+lunr.idf = function (posting, documentCount) {
+ var documentsWithTerm = 0
+
+ for (var fieldName in posting) {
+ if (fieldName == '_index') continue // Ignore the term index, its not a field
+ documentsWithTerm += Object.keys(posting[fieldName]).length
+ }
+
+ var x = (documentCount - documentsWithTerm + 0.5) / (documentsWithTerm + 0.5)
+
+ return Math.log(1 + Math.abs(x))
+}
+
+/**
+ * A token wraps a string representation of a token
+ * as it is passed through the text processing pipeline.
+ *
+ * @constructor
+ * @param {string} [str=''] - The string token being wrapped.
+ * @param {object} [metadata={}] - Metadata associated with this token.
+ */
+lunr.Token = function (str, metadata) {
+ this.str = str || ""
+ this.metadata = metadata || {}
+}
+
+/**
+ * Returns the token string that is being wrapped by this object.
+ *
+ * @returns {string}
+ */
+lunr.Token.prototype.toString = function () {
+ return this.str
+}
+
+/**
+ * A token update function is used when updating or optionally
+ * when cloning a token.
+ *
+ * @callback lunr.Token~updateFunction
+ * @param {string} str - The string representation of the token.
+ * @param {Object} metadata - All metadata associated with this token.
+ */
+
+/**
+ * Applies the given function to the wrapped string token.
+ *
+ * @example
+ * token.update(function (str, metadata) {
+ * return str.toUpperCase()
+ * })
+ *
+ * @param {lunr.Token~updateFunction} fn - A function to apply to the token string.
+ * @returns {lunr.Token}
+ */
+lunr.Token.prototype.update = function (fn) {
+ this.str = fn(this.str, this.metadata)
+ return this
+}
+
+/**
+ * Creates a clone of this token. Optionally a function can be
+ * applied to the cloned token.
+ *
+ * @param {lunr.Token~updateFunction} [fn] - An optional function to apply to the cloned token.
+ * @returns {lunr.Token}
+ */
+lunr.Token.prototype.clone = function (fn) {
+ fn = fn || function (s) { return s }
+ return new lunr.Token (fn(this.str, this.metadata), this.metadata)
+}
+/*!
+ * lunr.tokenizer
+ * Copyright (C) 2020 Oliver Nightingale
+ */
+
+/**
+ * A function for splitting a string into tokens ready to be inserted into
+ * the search index. Uses `lunr.tokenizer.separator` to split strings, change
+ * the value of this property to change how strings are split into tokens.
+ *
+ * This tokenizer will convert its parameter to a string by calling `toString` and
+ * then will split this string on the character in `lunr.tokenizer.separator`.
+ * Arrays will have their elements converted to strings and wrapped in a lunr.Token.
+ *
+ * Optional metadata can be passed to the tokenizer, this metadata will be cloned and
+ * added as metadata to every token that is created from the object to be tokenized.
+ *
+ * @static
+ * @param {?(string|object|object[])} obj - The object to convert into tokens
+ * @param {?object} metadata - Optional metadata to associate with every token
+ * @returns {lunr.Token[]}
+ * @see {@link lunr.Pipeline}
+ */
+lunr.tokenizer = function (obj, metadata) {
+ if (obj == null || obj == undefined) {
+ return []
+ }
+
+ if (Array.isArray(obj)) {
+ return obj.map(function (t) {
+ return new lunr.Token(
+ lunr.utils.asString(t).toLowerCase(),
+ lunr.utils.clone(metadata)
+ )
+ })
+ }
+
+ var str = obj.toString().toLowerCase(),
+ len = str.length,
+ tokens = []
+
+ for (var sliceEnd = 0, sliceStart = 0; sliceEnd <= len; sliceEnd++) {
+ var char = str.charAt(sliceEnd),
+ sliceLength = sliceEnd - sliceStart
+
+ if ((char.match(lunr.tokenizer.separator) || sliceEnd == len)) {
+
+ if (sliceLength > 0) {
+ var tokenMetadata = lunr.utils.clone(metadata) || {}
+ tokenMetadata["position"] = [sliceStart, sliceLength]
+ tokenMetadata["index"] = tokens.length
+
+ tokens.push(
+ new lunr.Token (
+ str.slice(sliceStart, sliceEnd),
+ tokenMetadata
+ )
+ )
+ }
+
+ sliceStart = sliceEnd + 1
+ }
+
+ }
+
+ return tokens
+}
+
+/**
+ * The separator used to split a string into tokens. Override this property to change the behaviour of
+ * `lunr.tokenizer` behaviour when tokenizing strings. By default this splits on whitespace and hyphens.
+ *
+ * @static
+ * @see lunr.tokenizer
+ */
+lunr.tokenizer.separator = /[\s\-]+/
+/*!
+ * lunr.Pipeline
+ * Copyright (C) 2020 Oliver Nightingale
+ */
+
+/**
+ * lunr.Pipelines maintain an ordered list of functions to be applied to all
+ * tokens in documents entering the search index and queries being ran against
+ * the index.
+ *
+ * An instance of lunr.Index created with the lunr shortcut will contain a
+ * pipeline with a stop word filter and an English language stemmer. Extra
+ * functions can be added before or after either of these functions or these
+ * default functions can be removed.
+ *
+ * When run the pipeline will call each function in turn, passing a token, the
+ * index of that token in the original list of all tokens and finally a list of
+ * all the original tokens.
+ *
+ * The output of functions in the pipeline will be passed to the next function
+ * in the pipeline. To exclude a token from entering the index the function
+ * should return undefined, the rest of the pipeline will not be called with
+ * this token.
+ *
+ * For serialisation of pipelines to work, all functions used in an instance of
+ * a pipeline should be registered with lunr.Pipeline. Registered functions can
+ * then be loaded. If trying to load a serialised pipeline that uses functions
+ * that are not registered an error will be thrown.
+ *
+ * If not planning on serialising the pipeline then registering pipeline functions
+ * is not necessary.
+ *
+ * @constructor
+ */
+lunr.Pipeline = function () {
+ this._stack = []
+}
+
+lunr.Pipeline.registeredFunctions = Object.create(null)
+
+/**
+ * A pipeline function maps lunr.Token to lunr.Token. A lunr.Token contains the token
+ * string as well as all known metadata. A pipeline function can mutate the token string
+ * or mutate (or add) metadata for a given token.
+ *
+ * A pipeline function can indicate that the passed token should be discarded by returning
+ * null, undefined or an empty string. This token will not be passed to any downstream pipeline
+ * functions and will not be added to the index.
+ *
+ * Multiple tokens can be returned by returning an array of tokens. Each token will be passed
+ * to any downstream pipeline functions and all will returned tokens will be added to the index.
+ *
+ * Any number of pipeline functions may be chained together using a lunr.Pipeline.
+ *
+ * @interface lunr.PipelineFunction
+ * @param {lunr.Token} token - A token from the document being processed.
+ * @param {number} i - The index of this token in the complete list of tokens for this document/field.
+ * @param {lunr.Token[]} tokens - All tokens for this document/field.
+ * @returns {(?lunr.Token|lunr.Token[])}
+ */
+
+/**
+ * Register a function with the pipeline.
+ *
+ * Functions that are used in the pipeline should be registered if the pipeline
+ * needs to be serialised, or a serialised pipeline needs to be loaded.
+ *
+ * Registering a function does not add it to a pipeline, functions must still be
+ * added to instances of the pipeline for them to be used when running a pipeline.
+ *
+ * @param {lunr.PipelineFunction} fn - The function to check for.
+ * @param {String} label - The label to register this function with
+ */
+lunr.Pipeline.registerFunction = function (fn, label) {
+ if (label in this.registeredFunctions) {
+ lunr.utils.warn('Overwriting existing registered function: ' + label)
+ }
+
+ fn.label = label
+ lunr.Pipeline.registeredFunctions[fn.label] = fn
+}
+
+/**
+ * Warns if the function is not registered as a Pipeline function.
+ *
+ * @param {lunr.PipelineFunction} fn - The function to check for.
+ * @private
+ */
+lunr.Pipeline.warnIfFunctionNotRegistered = function (fn) {
+ var isRegistered = fn.label && (fn.label in this.registeredFunctions)
+
+ if (!isRegistered) {
+ lunr.utils.warn('Function is not registered with pipeline. This may cause problems when serialising the index.\n', fn)
+ }
+}
+
+/**
+ * Loads a previously serialised pipeline.
+ *
+ * All functions to be loaded must already be registered with lunr.Pipeline.
+ * If any function from the serialised data has not been registered then an
+ * error will be thrown.
+ *
+ * @param {Object} serialised - The serialised pipeline to load.
+ * @returns {lunr.Pipeline}
+ */
+lunr.Pipeline.load = function (serialised) {
+ var pipeline = new lunr.Pipeline
+
+ serialised.forEach(function (fnName) {
+ var fn = lunr.Pipeline.registeredFunctions[fnName]
+
+ if (fn) {
+ pipeline.add(fn)
+ } else {
+ throw new Error('Cannot load unregistered function: ' + fnName)
+ }
+ })
+
+ return pipeline
+}
+
+/**
+ * Adds new functions to the end of the pipeline.
+ *
+ * Logs a warning if the function has not been registered.
+ *
+ * @param {lunr.PipelineFunction[]} functions - Any number of functions to add to the pipeline.
+ */
+lunr.Pipeline.prototype.add = function () {
+ var fns = Array.prototype.slice.call(arguments)
+
+ fns.forEach(function (fn) {
+ lunr.Pipeline.warnIfFunctionNotRegistered(fn)
+ this._stack.push(fn)
+ }, this)
+}
+
+/**
+ * Adds a single function after a function that already exists in the
+ * pipeline.
+ *
+ * Logs a warning if the function has not been registered.
+ *
+ * @param {lunr.PipelineFunction} existingFn - A function that already exists in the pipeline.
+ * @param {lunr.PipelineFunction} newFn - The new function to add to the pipeline.
+ */
+lunr.Pipeline.prototype.after = function (existingFn, newFn) {
+ lunr.Pipeline.warnIfFunctionNotRegistered(newFn)
+
+ var pos = this._stack.indexOf(existingFn)
+ if (pos == -1) {
+ throw new Error('Cannot find existingFn')
+ }
+
+ pos = pos + 1
+ this._stack.splice(pos, 0, newFn)
+}
+
+/**
+ * Adds a single function before a function that already exists in the
+ * pipeline.
+ *
+ * Logs a warning if the function has not been registered.
+ *
+ * @param {lunr.PipelineFunction} existingFn - A function that already exists in the pipeline.
+ * @param {lunr.PipelineFunction} newFn - The new function to add to the pipeline.
+ */
+lunr.Pipeline.prototype.before = function (existingFn, newFn) {
+ lunr.Pipeline.warnIfFunctionNotRegistered(newFn)
+
+ var pos = this._stack.indexOf(existingFn)
+ if (pos == -1) {
+ throw new Error('Cannot find existingFn')
+ }
+
+ this._stack.splice(pos, 0, newFn)
+}
+
+/**
+ * Removes a function from the pipeline.
+ *
+ * @param {lunr.PipelineFunction} fn The function to remove from the pipeline.
+ */
+lunr.Pipeline.prototype.remove = function (fn) {
+ var pos = this._stack.indexOf(fn)
+ if (pos == -1) {
+ return
+ }
+
+ this._stack.splice(pos, 1)
+}
+
+/**
+ * Runs the current list of functions that make up the pipeline against the
+ * passed tokens.
+ *
+ * @param {Array} tokens The tokens to run through the pipeline.
+ * @returns {Array}
+ */
+lunr.Pipeline.prototype.run = function (tokens) {
+ var stackLength = this._stack.length
+
+ for (var i = 0; i < stackLength; i++) {
+ var fn = this._stack[i]
+ var memo = []
+
+ for (var j = 0; j < tokens.length; j++) {
+ var result = fn(tokens[j], j, tokens)
+
+ if (result === null || result === void 0 || result === '') continue
+
+ if (Array.isArray(result)) {
+ for (var k = 0; k < result.length; k++) {
+ memo.push(result[k])
+ }
+ } else {
+ memo.push(result)
+ }
+ }
+
+ tokens = memo
+ }
+
+ return tokens
+}
+
+/**
+ * Convenience method for passing a string through a pipeline and getting
+ * strings out. This method takes care of wrapping the passed string in a
+ * token and mapping the resulting tokens back to strings.
+ *
+ * @param {string} str - The string to pass through the pipeline.
+ * @param {?object} metadata - Optional metadata to associate with the token
+ * passed to the pipeline.
+ * @returns {string[]}
+ */
+lunr.Pipeline.prototype.runString = function (str, metadata) {
+ var token = new lunr.Token (str, metadata)
+
+ return this.run([token]).map(function (t) {
+ return t.toString()
+ })
+}
+
+/**
+ * Resets the pipeline by removing any existing processors.
+ *
+ */
+lunr.Pipeline.prototype.reset = function () {
+ this._stack = []
+}
+
+/**
+ * Returns a representation of the pipeline ready for serialisation.
+ *
+ * Logs a warning if the function has not been registered.
+ *
+ * @returns {Array}
+ */
+lunr.Pipeline.prototype.toJSON = function () {
+ return this._stack.map(function (fn) {
+ lunr.Pipeline.warnIfFunctionNotRegistered(fn)
+
+ return fn.label
+ })
+}
+/*!
+ * lunr.Vector
+ * Copyright (C) 2020 Oliver Nightingale
+ */
+
+/**
+ * A vector is used to construct the vector space of documents and queries. These
+ * vectors support operations to determine the similarity between two documents or
+ * a document and a query.
+ *
+ * Normally no parameters are required for initializing a vector, but in the case of
+ * loading a previously dumped vector the raw elements can be provided to the constructor.
+ *
+ * For performance reasons vectors are implemented with a flat array, where an elements
+ * index is immediately followed by its value. E.g. [index, value, index, value]. This
+ * allows the underlying array to be as sparse as possible and still offer decent
+ * performance when being used for vector calculations.
+ *
+ * @constructor
+ * @param {Number[]} [elements] - The flat list of element index and element value pairs.
+ */
+lunr.Vector = function (elements) {
+ this._magnitude = 0
+ this.elements = elements || []
+}
+
+
+/**
+ * Calculates the position within the vector to insert a given index.
+ *
+ * This is used internally by insert and upsert. If there are duplicate indexes then
+ * the position is returned as if the value for that index were to be updated, but it
+ * is the callers responsibility to check whether there is a duplicate at that index
+ *
+ * @param {Number} insertIdx - The index at which the element should be inserted.
+ * @returns {Number}
+ */
+lunr.Vector.prototype.positionForIndex = function (index) {
+ // For an empty vector the tuple can be inserted at the beginning
+ if (this.elements.length == 0) {
+ return 0
+ }
+
+ var start = 0,
+ end = this.elements.length / 2,
+ sliceLength = end - start,
+ pivotPoint = Math.floor(sliceLength / 2),
+ pivotIndex = this.elements[pivotPoint * 2]
+
+ while (sliceLength > 1) {
+ if (pivotIndex < index) {
+ start = pivotPoint
+ }
+
+ if (pivotIndex > index) {
+ end = pivotPoint
+ }
+
+ if (pivotIndex == index) {
+ break
+ }
+
+ sliceLength = end - start
+ pivotPoint = start + Math.floor(sliceLength / 2)
+ pivotIndex = this.elements[pivotPoint * 2]
+ }
+
+ if (pivotIndex == index) {
+ return pivotPoint * 2
+ }
+
+ if (pivotIndex > index) {
+ return pivotPoint * 2
+ }
+
+ if (pivotIndex < index) {
+ return (pivotPoint + 1) * 2
+ }
+}
+
+/**
+ * Inserts an element at an index within the vector.
+ *
+ * Does not allow duplicates, will throw an error if there is already an entry
+ * for this index.
+ *
+ * @param {Number} insertIdx - The index at which the element should be inserted.
+ * @param {Number} val - The value to be inserted into the vector.
+ */
+lunr.Vector.prototype.insert = function (insertIdx, val) {
+ this.upsert(insertIdx, val, function () {
+ throw "duplicate index"
+ })
+}
+
+/**
+ * Inserts or updates an existing index within the vector.
+ *
+ * @param {Number} insertIdx - The index at which the element should be inserted.
+ * @param {Number} val - The value to be inserted into the vector.
+ * @param {function} fn - A function that is called for updates, the existing value and the
+ * requested value are passed as arguments
+ */
+lunr.Vector.prototype.upsert = function (insertIdx, val, fn) {
+ this._magnitude = 0
+ var position = this.positionForIndex(insertIdx)
+
+ if (this.elements[position] == insertIdx) {
+ this.elements[position + 1] = fn(this.elements[position + 1], val)
+ } else {
+ this.elements.splice(position, 0, insertIdx, val)
+ }
+}
+
+/**
+ * Calculates the magnitude of this vector.
+ *
+ * @returns {Number}
+ */
+lunr.Vector.prototype.magnitude = function () {
+ if (this._magnitude) return this._magnitude
+
+ var sumOfSquares = 0,
+ elementsLength = this.elements.length
+
+ for (var i = 1; i < elementsLength; i += 2) {
+ var val = this.elements[i]
+ sumOfSquares += val * val
+ }
+
+ return this._magnitude = Math.sqrt(sumOfSquares)
+}
+
+/**
+ * Calculates the dot product of this vector and another vector.
+ *
+ * @param {lunr.Vector} otherVector - The vector to compute the dot product with.
+ * @returns {Number}
+ */
+lunr.Vector.prototype.dot = function (otherVector) {
+ var dotProduct = 0,
+ a = this.elements, b = otherVector.elements,
+ aLen = a.length, bLen = b.length,
+ aVal = 0, bVal = 0,
+ i = 0, j = 0
+
+ while (i < aLen && j < bLen) {
+ aVal = a[i], bVal = b[j]
+ if (aVal < bVal) {
+ i += 2
+ } else if (aVal > bVal) {
+ j += 2
+ } else if (aVal == bVal) {
+ dotProduct += a[i + 1] * b[j + 1]
+ i += 2
+ j += 2
+ }
+ }
+
+ return dotProduct
+}
+
+/**
+ * Calculates the similarity between this vector and another vector.
+ *
+ * @param {lunr.Vector} otherVector - The other vector to calculate the
+ * similarity with.
+ * @returns {Number}
+ */
+lunr.Vector.prototype.similarity = function (otherVector) {
+ return this.dot(otherVector) / this.magnitude() || 0
+}
+
+/**
+ * Converts the vector to an array of the elements within the vector.
+ *
+ * @returns {Number[]}
+ */
+lunr.Vector.prototype.toArray = function () {
+ var output = new Array (this.elements.length / 2)
+
+ for (var i = 1, j = 0; i < this.elements.length; i += 2, j++) {
+ output[j] = this.elements[i]
+ }
+
+ return output
+}
+
+/**
+ * A JSON serializable representation of the vector.
+ *
+ * @returns {Number[]}
+ */
+lunr.Vector.prototype.toJSON = function () {
+ return this.elements
+}
+/* eslint-disable */
+/*!
+ * lunr.stemmer
+ * Copyright (C) 2020 Oliver Nightingale
+ * Includes code from - http://tartarus.org/~martin/PorterStemmer/js.txt
+ */
+
+/**
+ * lunr.stemmer is an english language stemmer, this is a JavaScript
+ * implementation of the PorterStemmer taken from http://tartarus.org/~martin
+ *
+ * @static
+ * @implements {lunr.PipelineFunction}
+ * @param {lunr.Token} token - The string to stem
+ * @returns {lunr.Token}
+ * @see {@link lunr.Pipeline}
+ * @function
+ */
+lunr.stemmer = (function(){
+ var step2list = {
+ "ational" : "ate",
+ "tional" : "tion",
+ "enci" : "ence",
+ "anci" : "ance",
+ "izer" : "ize",
+ "bli" : "ble",
+ "alli" : "al",
+ "entli" : "ent",
+ "eli" : "e",
+ "ousli" : "ous",
+ "ization" : "ize",
+ "ation" : "ate",
+ "ator" : "ate",
+ "alism" : "al",
+ "iveness" : "ive",
+ "fulness" : "ful",
+ "ousness" : "ous",
+ "aliti" : "al",
+ "iviti" : "ive",
+ "biliti" : "ble",
+ "logi" : "log"
+ },
+
+ step3list = {
+ "icate" : "ic",
+ "ative" : "",
+ "alize" : "al",
+ "iciti" : "ic",
+ "ical" : "ic",
+ "ful" : "",
+ "ness" : ""
+ },
+
+ c = "[^aeiou]", // consonant
+ v = "[aeiouy]", // vowel
+ C = c + "[^aeiouy]*", // consonant sequence
+ V = v + "[aeiou]*", // vowel sequence
+
+ mgr0 = "^(" + C + ")?" + V + C, // [C]VC... is m>0
+ meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$", // [C]VC[V] is m=1
+ mgr1 = "^(" + C + ")?" + V + C + V + C, // [C]VCVC... is m>1
+ s_v = "^(" + C + ")?" + v; // vowel in stem
+
+ var re_mgr0 = new RegExp(mgr0);
+ var re_mgr1 = new RegExp(mgr1);
+ var re_meq1 = new RegExp(meq1);
+ var re_s_v = new RegExp(s_v);
+
+ var re_1a = /^(.+?)(ss|i)es$/;
+ var re2_1a = /^(.+?)([^s])s$/;
+ var re_1b = /^(.+?)eed$/;
+ var re2_1b = /^(.+?)(ed|ing)$/;
+ var re_1b_2 = /.$/;
+ var re2_1b_2 = /(at|bl|iz)$/;
+ var re3_1b_2 = new RegExp("([^aeiouylsz])\\1$");
+ var re4_1b_2 = new RegExp("^" + C + v + "[^aeiouwxy]$");
+
+ var re_1c = /^(.+?[^aeiou])y$/;
+ var re_2 = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/;
+
+ var re_3 = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/;
+
+ var re_4 = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/;
+ var re2_4 = /^(.+?)(s|t)(ion)$/;
+
+ var re_5 = /^(.+?)e$/;
+ var re_5_1 = /ll$/;
+ var re3_5 = new RegExp("^" + C + v + "[^aeiouwxy]$");
+
+ var porterStemmer = function porterStemmer(w) {
+ var stem,
+ suffix,
+ firstch,
+ re,
+ re2,
+ re3,
+ re4;
+
+ if (w.length < 3) { return w; }
+
+ firstch = w.substr(0,1);
+ if (firstch == "y") {
+ w = firstch.toUpperCase() + w.substr(1);
+ }
+
+ // Step 1a
+ re = re_1a
+ re2 = re2_1a;
+
+ if (re.test(w)) { w = w.replace(re,"$1$2"); }
+ else if (re2.test(w)) { w = w.replace(re2,"$1$2"); }
+
+ // Step 1b
+ re = re_1b;
+ re2 = re2_1b;
+ if (re.test(w)) {
+ var fp = re.exec(w);
+ re = re_mgr0;
+ if (re.test(fp[1])) {
+ re = re_1b_2;
+ w = w.replace(re,"");
+ }
+ } else if (re2.test(w)) {
+ var fp = re2.exec(w);
+ stem = fp[1];
+ re2 = re_s_v;
+ if (re2.test(stem)) {
+ w = stem;
+ re2 = re2_1b_2;
+ re3 = re3_1b_2;
+ re4 = re4_1b_2;
+ if (re2.test(w)) { w = w + "e"; }
+ else if (re3.test(w)) { re = re_1b_2; w = w.replace(re,""); }
+ else if (re4.test(w)) { w = w + "e"; }
+ }
+ }
+
+ // Step 1c - replace suffix y or Y by i if preceded by a non-vowel which is not the first letter of the word (so cry -> cri, by -> by, say -> say)
+ re = re_1c;
+ if (re.test(w)) {
+ var fp = re.exec(w);
+ stem = fp[1];
+ w = stem + "i";
+ }
+
+ // Step 2
+ re = re_2;
+ if (re.test(w)) {
+ var fp = re.exec(w);
+ stem = fp[1];
+ suffix = fp[2];
+ re = re_mgr0;
+ if (re.test(stem)) {
+ w = stem + step2list[suffix];
+ }
+ }
+
+ // Step 3
+ re = re_3;
+ if (re.test(w)) {
+ var fp = re.exec(w);
+ stem = fp[1];
+ suffix = fp[2];
+ re = re_mgr0;
+ if (re.test(stem)) {
+ w = stem + step3list[suffix];
+ }
+ }
+
+ // Step 4
+ re = re_4;
+ re2 = re2_4;
+ if (re.test(w)) {
+ var fp = re.exec(w);
+ stem = fp[1];
+ re = re_mgr1;
+ if (re.test(stem)) {
+ w = stem;
+ }
+ } else if (re2.test(w)) {
+ var fp = re2.exec(w);
+ stem = fp[1] + fp[2];
+ re2 = re_mgr1;
+ if (re2.test(stem)) {
+ w = stem;
+ }
+ }
+
+ // Step 5
+ re = re_5;
+ if (re.test(w)) {
+ var fp = re.exec(w);
+ stem = fp[1];
+ re = re_mgr1;
+ re2 = re_meq1;
+ re3 = re3_5;
+ if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) {
+ w = stem;
+ }
+ }
+
+ re = re_5_1;
+ re2 = re_mgr1;
+ if (re.test(w) && re2.test(w)) {
+ re = re_1b_2;
+ w = w.replace(re,"");
+ }
+
+ // and turn initial Y back to y
+
+ if (firstch == "y") {
+ w = firstch.toLowerCase() + w.substr(1);
+ }
+
+ return w;
+ };
+
+ return function (token) {
+ return token.update(porterStemmer);
+ }
+})();
+
+lunr.Pipeline.registerFunction(lunr.stemmer, 'stemmer')
+/*!
+ * lunr.stopWordFilter
+ * Copyright (C) 2020 Oliver Nightingale
+ */
+
+/**
+ * lunr.generateStopWordFilter builds a stopWordFilter function from the provided
+ * list of stop words.
+ *
+ * The built in lunr.stopWordFilter is built using this generator and can be used
+ * to generate custom stopWordFilters for applications or non English languages.
+ *
+ * @function
+ * @param {Array} token The token to pass through the filter
+ * @returns {lunr.PipelineFunction}
+ * @see lunr.Pipeline
+ * @see lunr.stopWordFilter
+ */
+lunr.generateStopWordFilter = function (stopWords) {
+ var words = stopWords.reduce(function (memo, stopWord) {
+ memo[stopWord] = stopWord
+ return memo
+ }, {})
+
+ return function (token) {
+ if (token && words[token.toString()] !== token.toString()) return token
+ }
+}
+
+/**
+ * lunr.stopWordFilter is an English language stop word list filter, any words
+ * contained in the list will not be passed through the filter.
+ *
+ * This is intended to be used in the Pipeline. If the token does not pass the
+ * filter then undefined will be returned.
+ *
+ * @function
+ * @implements {lunr.PipelineFunction}
+ * @params {lunr.Token} token - A token to check for being a stop word.
+ * @returns {lunr.Token}
+ * @see {@link lunr.Pipeline}
+ */
+lunr.stopWordFilter = lunr.generateStopWordFilter([
+ 'a',
+ 'able',
+ 'about',
+ 'across',
+ 'after',
+ 'all',
+ 'almost',
+ 'also',
+ 'am',
+ 'among',
+ 'an',
+ 'and',
+ 'any',
+ 'are',
+ 'as',
+ 'at',
+ 'be',
+ 'because',
+ 'been',
+ 'but',
+ 'by',
+ 'can',
+ 'cannot',
+ 'could',
+ 'dear',
+ 'did',
+ 'do',
+ 'does',
+ 'either',
+ 'else',
+ 'ever',
+ 'every',
+ 'for',
+ 'from',
+ 'get',
+ 'got',
+ 'had',
+ 'has',
+ 'have',
+ 'he',
+ 'her',
+ 'hers',
+ 'him',
+ 'his',
+ 'how',
+ 'however',
+ 'i',
+ 'if',
+ 'in',
+ 'into',
+ 'is',
+ 'it',
+ 'its',
+ 'just',
+ 'least',
+ 'let',
+ 'like',
+ 'likely',
+ 'may',
+ 'me',
+ 'might',
+ 'most',
+ 'must',
+ 'my',
+ 'neither',
+ 'no',
+ 'nor',
+ 'not',
+ 'of',
+ 'off',
+ 'often',
+ 'on',
+ 'only',
+ 'or',
+ 'other',
+ 'our',
+ 'own',
+ 'rather',
+ 'said',
+ 'say',
+ 'says',
+ 'she',
+ 'should',
+ 'since',
+ 'so',
+ 'some',
+ 'than',
+ 'that',
+ 'the',
+ 'their',
+ 'them',
+ 'then',
+ 'there',
+ 'these',
+ 'they',
+ 'this',
+ 'tis',
+ 'to',
+ 'too',
+ 'twas',
+ 'us',
+ 'wants',
+ 'was',
+ 'we',
+ 'were',
+ 'what',
+ 'when',
+ 'where',
+ 'which',
+ 'while',
+ 'who',
+ 'whom',
+ 'why',
+ 'will',
+ 'with',
+ 'would',
+ 'yet',
+ 'you',
+ 'your'
+])
+
+lunr.Pipeline.registerFunction(lunr.stopWordFilter, 'stopWordFilter')
+/*!
+ * lunr.trimmer
+ * Copyright (C) 2020 Oliver Nightingale
+ */
+
+/**
+ * lunr.trimmer is a pipeline function for trimming non word
+ * characters from the beginning and end of tokens before they
+ * enter the index.
+ *
+ * This implementation may not work correctly for non latin
+ * characters and should either be removed or adapted for use
+ * with languages with non-latin characters.
+ *
+ * @static
+ * @implements {lunr.PipelineFunction}
+ * @param {lunr.Token} token The token to pass through the filter
+ * @returns {lunr.Token}
+ * @see lunr.Pipeline
+ */
+lunr.trimmer = function (token) {
+ return token.update(function (s) {
+ return s.replace(/^\W+/, '').replace(/\W+$/, '')
+ })
+}
+
+lunr.Pipeline.registerFunction(lunr.trimmer, 'trimmer')
+/*!
+ * lunr.TokenSet
+ * Copyright (C) 2020 Oliver Nightingale
+ */
+
+/**
+ * A token set is used to store the unique list of all tokens
+ * within an index. Token sets are also used to represent an
+ * incoming query to the index, this query token set and index
+ * token set are then intersected to find which tokens to look
+ * up in the inverted index.
+ *
+ * A token set can hold multiple tokens, as in the case of the
+ * index token set, or it can hold a single token as in the
+ * case of a simple query token set.
+ *
+ * Additionally token sets are used to perform wildcard matching.
+ * Leading, contained and trailing wildcards are supported, and
+ * from this edit distance matching can also be provided.
+ *
+ * Token sets are implemented as a minimal finite state automata,
+ * where both common prefixes and suffixes are shared between tokens.
+ * This helps to reduce the space used for storing the token set.
+ *
+ * @constructor
+ */
+lunr.TokenSet = function () {
+ this.final = false
+ this.edges = {}
+ this.id = lunr.TokenSet._nextId
+ lunr.TokenSet._nextId += 1
+}
+
+/**
+ * Keeps track of the next, auto increment, identifier to assign
+ * to a new tokenSet.
+ *
+ * TokenSets require a unique identifier to be correctly minimised.
+ *
+ * @private
+ */
+lunr.TokenSet._nextId = 1
+
+/**
+ * Creates a TokenSet instance from the given sorted array of words.
+ *
+ * @param {String[]} arr - A sorted array of strings to create the set from.
+ * @returns {lunr.TokenSet}
+ * @throws Will throw an error if the input array is not sorted.
+ */
+lunr.TokenSet.fromArray = function (arr) {
+ var builder = new lunr.TokenSet.Builder
+
+ for (var i = 0, len = arr.length; i < len; i++) {
+ builder.insert(arr[i])
+ }
+
+ builder.finish()
+ return builder.root
+}
+
+/**
+ * Creates a token set from a query clause.
+ *
+ * @private
+ * @param {Object} clause - A single clause from lunr.Query.
+ * @param {string} clause.term - The query clause term.
+ * @param {number} [clause.editDistance] - The optional edit distance for the term.
+ * @returns {lunr.TokenSet}
+ */
+lunr.TokenSet.fromClause = function (clause) {
+ if ('editDistance' in clause) {
+ return lunr.TokenSet.fromFuzzyString(clause.term, clause.editDistance)
+ } else {
+ return lunr.TokenSet.fromString(clause.term)
+ }
+}
+
+/**
+ * Creates a token set representing a single string with a specified
+ * edit distance.
+ *
+ * Insertions, deletions, substitutions and transpositions are each
+ * treated as an edit distance of 1.
+ *
+ * Increasing the allowed edit distance will have a dramatic impact
+ * on the performance of both creating and intersecting these TokenSets.
+ * It is advised to keep the edit distance less than 3.
+ *
+ * @param {string} str - The string to create the token set from.
+ * @param {number} editDistance - The allowed edit distance to match.
+ * @returns {lunr.Vector}
+ */
+lunr.TokenSet.fromFuzzyString = function (str, editDistance) {
+ var root = new lunr.TokenSet
+
+ var stack = [{
+ node: root,
+ editsRemaining: editDistance,
+ str: str
+ }]
+
+ while (stack.length) {
+ var frame = stack.pop()
+
+ // no edit
+ if (frame.str.length > 0) {
+ var char = frame.str.charAt(0),
+ noEditNode
+
+ if (char in frame.node.edges) {
+ noEditNode = frame.node.edges[char]
+ } else {
+ noEditNode = new lunr.TokenSet
+ frame.node.edges[char] = noEditNode
+ }
+
+ if (frame.str.length == 1) {
+ noEditNode.final = true
+ }
+
+ stack.push({
+ node: noEditNode,
+ editsRemaining: frame.editsRemaining,
+ str: frame.str.slice(1)
+ })
+ }
+
+ if (frame.editsRemaining == 0) {
+ continue
+ }
+
+ // insertion
+ if ("*" in frame.node.edges) {
+ var insertionNode = frame.node.edges["*"]
+ } else {
+ var insertionNode = new lunr.TokenSet
+ frame.node.edges["*"] = insertionNode
+ }
+
+ if (frame.str.length == 0) {
+ insertionNode.final = true
+ }
+
+ stack.push({
+ node: insertionNode,
+ editsRemaining: frame.editsRemaining - 1,
+ str: frame.str
+ })
+
+ // deletion
+ // can only do a deletion if we have enough edits remaining
+ // and if there are characters left to delete in the string
+ if (frame.str.length > 1) {
+ stack.push({
+ node: frame.node,
+ editsRemaining: frame.editsRemaining - 1,
+ str: frame.str.slice(1)
+ })
+ }
+
+ // deletion
+ // just removing the last character from the str
+ if (frame.str.length == 1) {
+ frame.node.final = true
+ }
+
+ // substitution
+ // can only do a substitution if we have enough edits remaining
+ // and if there are characters left to substitute
+ if (frame.str.length >= 1) {
+ if ("*" in frame.node.edges) {
+ var substitutionNode = frame.node.edges["*"]
+ } else {
+ var substitutionNode = new lunr.TokenSet
+ frame.node.edges["*"] = substitutionNode
+ }
+
+ if (frame.str.length == 1) {
+ substitutionNode.final = true
+ }
+
+ stack.push({
+ node: substitutionNode,
+ editsRemaining: frame.editsRemaining - 1,
+ str: frame.str.slice(1)
+ })
+ }
+
+ // transposition
+ // can only do a transposition if there are edits remaining
+ // and there are enough characters to transpose
+ if (frame.str.length > 1) {
+ var charA = frame.str.charAt(0),
+ charB = frame.str.charAt(1),
+ transposeNode
+
+ if (charB in frame.node.edges) {
+ transposeNode = frame.node.edges[charB]
+ } else {
+ transposeNode = new lunr.TokenSet
+ frame.node.edges[charB] = transposeNode
+ }
+
+ if (frame.str.length == 1) {
+ transposeNode.final = true
+ }
+
+ stack.push({
+ node: transposeNode,
+ editsRemaining: frame.editsRemaining - 1,
+ str: charA + frame.str.slice(2)
+ })
+ }
+ }
+
+ return root
+}
+
+/**
+ * Creates a TokenSet from a string.
+ *
+ * The string may contain one or more wildcard characters (*)
+ * that will allow wildcard matching when intersecting with
+ * another TokenSet.
+ *
+ * @param {string} str - The string to create a TokenSet from.
+ * @returns {lunr.TokenSet}
+ */
+lunr.TokenSet.fromString = function (str) {
+ var node = new lunr.TokenSet,
+ root = node
+
+ /*
+ * Iterates through all characters within the passed string
+ * appending a node for each character.
+ *
+ * When a wildcard character is found then a self
+ * referencing edge is introduced to continually match
+ * any number of any characters.
+ */
+ for (var i = 0, len = str.length; i < len; i++) {
+ var char = str[i],
+ final = (i == len - 1)
+
+ if (char == "*") {
+ node.edges[char] = node
+ node.final = final
+
+ } else {
+ var next = new lunr.TokenSet
+ next.final = final
+
+ node.edges[char] = next
+ node = next
+ }
+ }
+
+ return root
+}
+
+/**
+ * Converts this TokenSet into an array of strings
+ * contained within the TokenSet.
+ *
+ * This is not intended to be used on a TokenSet that
+ * contains wildcards, in these cases the results are
+ * undefined and are likely to cause an infinite loop.
+ *
+ * @returns {string[]}
+ */
+lunr.TokenSet.prototype.toArray = function () {
+ var words = []
+
+ var stack = [{
+ prefix: "",
+ node: this
+ }]
+
+ while (stack.length) {
+ var frame = stack.pop(),
+ edges = Object.keys(frame.node.edges),
+ len = edges.length
+
+ if (frame.node.final) {
+ /* In Safari, at this point the prefix is sometimes corrupted, see:
+ * https://github.com/olivernn/lunr.js/issues/279 Calling any
+ * String.prototype method forces Safari to "cast" this string to what
+ * it's supposed to be, fixing the bug. */
+ frame.prefix.charAt(0)
+ words.push(frame.prefix)
+ }
+
+ for (var i = 0; i < len; i++) {
+ var edge = edges[i]
+
+ stack.push({
+ prefix: frame.prefix.concat(edge),
+ node: frame.node.edges[edge]
+ })
+ }
+ }
+
+ return words
+}
+
+/**
+ * Generates a string representation of a TokenSet.
+ *
+ * This is intended to allow TokenSets to be used as keys
+ * in objects, largely to aid the construction and minimisation
+ * of a TokenSet. As such it is not designed to be a human
+ * friendly representation of the TokenSet.
+ *
+ * @returns {string}
+ */
+lunr.TokenSet.prototype.toString = function () {
+ // NOTE: Using Object.keys here as this.edges is very likely
+ // to enter 'hash-mode' with many keys being added
+ //
+ // avoiding a for-in loop here as it leads to the function
+ // being de-optimised (at least in V8). From some simple
+ // benchmarks the performance is comparable, but allowing
+ // V8 to optimize may mean easy performance wins in the future.
+
+ if (this._str) {
+ return this._str
+ }
+
+ var str = this.final ? '1' : '0',
+ labels = Object.keys(this.edges).sort(),
+ len = labels.length
+
+ for (var i = 0; i < len; i++) {
+ var label = labels[i],
+ node = this.edges[label]
+
+ str = str + label + node.id
+ }
+
+ return str
+}
+
+/**
+ * Returns a new TokenSet that is the intersection of
+ * this TokenSet and the passed TokenSet.
+ *
+ * This intersection will take into account any wildcards
+ * contained within the TokenSet.
+ *
+ * @param {lunr.TokenSet} b - An other TokenSet to intersect with.
+ * @returns {lunr.TokenSet}
+ */
+lunr.TokenSet.prototype.intersect = function (b) {
+ var output = new lunr.TokenSet,
+ frame = undefined
+
+ var stack = [{
+ qNode: b,
+ output: output,
+ node: this
+ }]
+
+ while (stack.length) {
+ frame = stack.pop()
+
+ // NOTE: As with the #toString method, we are using
+ // Object.keys and a for loop instead of a for-in loop
+ // as both of these objects enter 'hash' mode, causing
+ // the function to be de-optimised in V8
+ var qEdges = Object.keys(frame.qNode.edges),
+ qLen = qEdges.length,
+ nEdges = Object.keys(frame.node.edges),
+ nLen = nEdges.length
+
+ for (var q = 0; q < qLen; q++) {
+ var qEdge = qEdges[q]
+
+ for (var n = 0; n < nLen; n++) {
+ var nEdge = nEdges[n]
+
+ if (nEdge == qEdge || qEdge == '*') {
+ var node = frame.node.edges[nEdge],
+ qNode = frame.qNode.edges[qEdge],
+ final = node.final && qNode.final,
+ next = undefined
+
+ if (nEdge in frame.output.edges) {
+ // an edge already exists for this character
+ // no need to create a new node, just set the finality
+ // bit unless this node is already final
+ next = frame.output.edges[nEdge]
+ next.final = next.final || final
+
+ } else {
+ // no edge exists yet, must create one
+ // set the finality bit and insert it
+ // into the output
+ next = new lunr.TokenSet
+ next.final = final
+ frame.output.edges[nEdge] = next
+ }
+
+ stack.push({
+ qNode: qNode,
+ output: next,
+ node: node
+ })
+ }
+ }
+ }
+ }
+
+ return output
+}
+lunr.TokenSet.Builder = function () {
+ this.previousWord = ""
+ this.root = new lunr.TokenSet
+ this.uncheckedNodes = []
+ this.minimizedNodes = {}
+}
+
+lunr.TokenSet.Builder.prototype.insert = function (word) {
+ var node,
+ commonPrefix = 0
+
+ if (word < this.previousWord) {
+ throw new Error ("Out of order word insertion")
+ }
+
+ for (var i = 0; i < word.length && i < this.previousWord.length; i++) {
+ if (word[i] != this.previousWord[i]) break
+ commonPrefix++
+ }
+
+ this.minimize(commonPrefix)
+
+ if (this.uncheckedNodes.length == 0) {
+ node = this.root
+ } else {
+ node = this.uncheckedNodes[this.uncheckedNodes.length - 1].child
+ }
+
+ for (var i = commonPrefix; i < word.length; i++) {
+ var nextNode = new lunr.TokenSet,
+ char = word[i]
+
+ node.edges[char] = nextNode
+
+ this.uncheckedNodes.push({
+ parent: node,
+ char: char,
+ child: nextNode
+ })
+
+ node = nextNode
+ }
+
+ node.final = true
+ this.previousWord = word
+}
+
+lunr.TokenSet.Builder.prototype.finish = function () {
+ this.minimize(0)
+}
+
+lunr.TokenSet.Builder.prototype.minimize = function (downTo) {
+ for (var i = this.uncheckedNodes.length - 1; i >= downTo; i--) {
+ var node = this.uncheckedNodes[i],
+ childKey = node.child.toString()
+
+ if (childKey in this.minimizedNodes) {
+ node.parent.edges[node.char] = this.minimizedNodes[childKey]
+ } else {
+ // Cache the key for this node since
+ // we know it can't change anymore
+ node.child._str = childKey
+
+ this.minimizedNodes[childKey] = node.child
+ }
+
+ this.uncheckedNodes.pop()
+ }
+}
+/*!
+ * lunr.Index
+ * Copyright (C) 2020 Oliver Nightingale
+ */
+
+/**
+ * An index contains the built index of all documents and provides a query interface
+ * to the index.
+ *
+ * Usually instances of lunr.Index will not be created using this constructor, instead
+ * lunr.Builder should be used to construct new indexes, or lunr.Index.load should be
+ * used to load previously built and serialized indexes.
+ *
+ * @constructor
+ * @param {Object} attrs - The attributes of the built search index.
+ * @param {Object} attrs.invertedIndex - An index of term/field to document reference.
+ * @param {Object' + noResultsText + '
'); + } +} + +function doSearch () { + var query = document.getElementById('mkdocs-search-query').value; + if (query.length > min_search_length) { + if (!window.Worker) { + displayResults(search(query)); + } else { + searchWorker.postMessage({query: query}); + } + } else { + // Clear results for short queries + displayResults([]); + } +} + +function initSearch () { + var search_input = document.getElementById('mkdocs-search-query'); + if (search_input) { + search_input.addEventListener("keyup", doSearch); + } + var term = getSearchTermFromLocation(); + if (term) { + search_input.value = term; + doSearch(); + } +} + +function onWorkerMessage (e) { + if (e.data.allowSearch) { + initSearch(); + } else if (e.data.results) { + var results = e.data.results; + displayResults(results); + } else if (e.data.config) { + min_search_length = e.data.config.min_search_length-1; + } +} + +if (!window.Worker) { + console.log('Web Worker API not supported'); + // load index in main thread + $.getScript(joinUrl(base_url, "search/worker.js")).done(function () { + console.log('Loaded worker'); + init(); + window.postMessage = function (msg) { + onWorkerMessage({data: msg}); + }; + }).fail(function (jqxhr, settings, exception) { + console.error('Could not load worker.js'); + }); +} else { + // Wrap search in a web worker + var searchWorker = new Worker(joinUrl(base_url, "search/worker.js")); + searchWorker.postMessage({init: true}); + searchWorker.onmessage = onWorkerMessage; +} diff --git a/search/search_index.json b/search/search_index.json new file mode 100644 index 00000000..6d8e208e --- /dev/null +++ b/search/search_index.json @@ -0,0 +1 @@ +{"config":{"indexing":"full","lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"index.html","text":"Koswat \u00b6 Official documentation read the docs for Koswat","title":"Koswat"},{"location":"index.html#koswat","text":"Official documentation read the docs for Koswat","title":"Koswat"},{"location":"changelog.html","text":"Release-2023 (2023-11-07) \u00b6 Feat \u00b6 Added order_strategy submodule for determining reinforcement features across a dike traject based on default order Added new class to better handle / generate the location-reinforcement matrix Fix \u00b6 improve rounding improve rounding improve rounding show cost per km if no locations present add @property to total_cost add @property to total_cost add @property to total_cost test on presence of construction costs correct return type Added logic to plot new layer surfaces when they are either a LineString or a MultiLineString corrected berm width calculations (#114) corrected berm width calculations merge leftovers rename \"raise\" to \"surtax\" throughout KOSWAT rename \"raise\" to \"surtax\" throughout KOSWAT correct symbol name correct symbol name typo comment typo comment Added logic to avoid creating added / removed layers geometries when there were no modifications Added default values as math.nan for koswatscenario We now replace not-provided values from a KoswatScenario when calculating new reinforcements docu corrections docu corrections docu corrections v0.14.1 (2023-11-08) \u00b6 v0.14.0 (2023-11-07) \u00b6 Feat \u00b6 Added order_strategy submodule for determining reinforcement features across a dike traject based on default order Added new class to better handle / generate the location-reinforcement matrix Fix \u00b6 improve rounding improve rounding improve rounding show cost per km if no locations present add @property to total_cost add @property to total_cost add @property to total_cost test on presence of construction costs correct return type Added logic to plot new layer surfaces when they are either a LineString or a MultiLineString corrected berm width calculations (#114) corrected berm width calculations merge leftovers rename \"raise\" to \"surtax\" throughout KOSWAT rename \"raise\" to \"surtax\" throughout KOSWAT correct symbol name correct symbol name typo comment typo comment Added logic to avoid creating added / removed layers geometries when there were no modifications Added default values as math.nan for koswatscenario We now replace not-provided values from a KoswatScenario when calculating new reinforcements docu corrections docu corrections docu corrections v0.13.0 (2023-01-31) \u00b6 Feat \u00b6 volume_cost_parameters_builder.py : We now calculate the costs based on the ini input file v0.12.1 (2023-01-27) \u00b6 Fix \u00b6 calc_library.py : Standrad reinforcement calculation now uses a different method to make sure the added geometry is normalized v0.12.0 (2023-01-26) \u00b6 Feat \u00b6 koswat/cost_report : Koswat Summary now includes all available locations even if they are not suitable for any reinforcement profile. Adapted the rest of the classes to generate a proper matrix also during export v0.11.7 (2023-01-25) \u00b6 Fix \u00b6 calc_library.py : We now check whether the last point intersects with the line drawn between the first two points to avoid precission issues v0.11.6 (2023-01-25) \u00b6 Fix \u00b6 calc_library.py;koswat_coating_layer_builder.py : We now round up the coordinates of the calculated layers to avoid precision issues calc_library.py : Corrected collection of surface points, added extra plot for reinforced profiles v0.11.5 (2023-01-12) \u00b6 Fix \u00b6 calc_library : Small correction to avoid crashing when trying to order multiline strings v0.11.4 (2023-01-12) \u00b6 Fix \u00b6 standard_reinforcement_layers_wrapper_builder : Fixed sand layer added surface not being correct calc_library.py : After doing a geometry union the resulting geometry gets now their points in order v0.11.3 (2023-01-12) \u00b6 Fix \u00b6 koswat/configuration : Fixed creation of scenarios based on selected dike sections v0.11.2 (2022-12-21) \u00b6 v0.11.1 (2022-12-20) \u00b6 Fix \u00b6 koswat/ main .py : Renamed main file to fit to python main expected module v0.11.0 (2022-12-20) \u00b6 Feat \u00b6 koswat/koswat_handler.py : We now accept a log_output argument to specify the directory where to save the koswat run log. v0.10.0 (2022-12-20) \u00b6 Feat \u00b6 koswat/configuration/converters : Created converters fom to dom koswat/configuration/io/converters/ : Added configuration converters for the analysis section. We can now generate input profiles from the ini files koswat/configuration/io/csv : Added import of KoswatInputProfiles KoswatHandler;KoswatLogger : Added handler and logger for koswat runs from CLI Fix \u00b6 koswat/geometries/calc_library.py : We now order the points of the geometries so that calculations can be done correctly koswat/calculations : Corrected profile calculation for all types and their tests. These changes come directly from Peter de Grave koswat/configuration/io/koswat_run_settings_importer.py : corrected filtering of selected input profiles koswat_dike_locations_shp_reader.py : Fixed enumerating a filtered list instead of filtering after enumerating KoswatSurroundingsConverter : Fixed return as it was only giving the latest mapped FOM configuration/io/converters : Fixed return of data and adapted tests koswat_analysis_converter.py : Small fix to converter koswat_General_settings.py : Fix validation for surroundings koswat/calculations : Fixed calculations due to new profile input property KoswatMaterialType : Minor fix regarding usage of new KoswatMaterialType KoswatMaterialType : Adapted code to use the enum instead of strings Refactor \u00b6 koswat/configuration/io : Moved converters into io koswat/dike/surroundings/io/shp : Moved shp reader and fom to surroundings module koswat/configuration : Integrating mapping of files to fom's during settings import koswat/dike/surroundings/io : Moved previous CSV reader into a concrete module within dike/surroundings. Created protocols for csv reading so it can be repurposed KoswatMaterialType : Made koswat material into an enum. Adapted code overall in the source v0.9.0 (2022-12-12) \u00b6 Feat \u00b6 KoswatGeneralSettings : Created DOM for koswat general settings configuration KoswatConfigurationIniImporter : We can now map all different ini fom classes to the config class koswat/configuration : Created koswat configuration module and related class KoswatConfiguration to encapsulate all require information for a koswat analysis KoswatScenarioIniFom : It is now possible to read a KoswatScenarioIniFom from file KoswatDikeSelectionIniFom : It is now possible to read a Dike Selection INI file into its corresponding FOM KoswatCostsIniFom : Added logic to fully implement reading of a KoswatCostsIniFom file KoswatCostsIniFom : Added koswat costs ini file KoswatIniReader : Created koswat ini reader and initial approach to reading the general Koswat INI file Fix \u00b6 KoswatCosts : Added class conversion to dictionary Refactor \u00b6 koswat/configuration/models : Moved configuration data object models into their own module. Fixed / grouped imports KoswatDikeSelection : Koswat dike selection now implements a new type KoswatDikeSelectionTxtFom with related reader koswat_scenario : Moved koswat scenario into koswat/configuration koswat/io : Adapted export / import fom protocol v0.8.2 (2022-12-09) \u00b6 Fix \u00b6 KoswatLayerProtocol : we now have two different geometries for a layer, so that the profile with the layer and the stand alone representation of it are better reached v0.8.1 (2022-11-21) \u00b6 Fix \u00b6 SummaryMatrixCsvExporter : We now provide NANs when volume parameter is not defined summary_matrix_csv_exporter : We now correctly export all required information to the csv for the user v0.8.0 (2022-11-19) \u00b6 Feat \u00b6 KoswatPlotContext : Created plot context handler so it's easier to initialize and close plots v0.7.0 (2022-11-18) \u00b6 Feat \u00b6 koswat/cost_report/io/plots/ : Added module for cost_report export plots logic koswat_profile_plot.py : We can now set a unique color for layers_wrapper and profile plots koswat/plots/dike/ : Extracted dike plotting logic into separate classes koswat/plots/geometries : Created module with plotting for regular geometries from shapely Fix \u00b6 koswat/plots/utils.py : Replaced wrapper as it is not a good approach characteristic_points_builder.py : Resolved a circular dependency Refactor \u00b6 koswat/calculations/io/ : Extracted plot exporters from calculations into their corresponding directory koswat/plots : Create concrete module for plotting koswat/io : Moved io files into their corresponding modules v0.6.0 (2022-11-11) \u00b6 Feat \u00b6 VolumeCalculationParameters : Included all operations required to for volume calculation ReinforcementProfileProtocol : Added new property to retrieve the new ground level surface OutsideSlopeReinforcementLayersWrapperBuilder : Added builder for for the outside slope reinforcement layers wrapper StandardReinforcemetnLayersWrapperBuilder : Added logic to generate the geometries of a standard reinforcement dike ReinforcementLayersWrapper : We now have dedicated builders for the LayersWrapper associated with a Reinforcement ReinforcementProfileBuilderProtocol : Created protocol for better hierarchy CoatingLayerCostReport : Extended usage of previous StandardLayerCostReport so that other reinforcements can also use it Added logic to extract the surface of a layer LayerCostReportProtocol;StandardLayerCostReportBuilder : Extracted standard layer cost report builder logic into separate class. Added protocol to represent the layer cost reports koswat/geometries; standard_layer_cost_report : Implemented logic for StandardLayer cost calculation OutsideSlopeReinforcementProfileProtocol;StandardReinforcementProfileProtocol : Added protocols to represent the different types of reinforcement - per volume; Added tests for factory LayerCostReportbuilderFactory : Added logic to retrieve the corresponding LayerCostReportBuilderProtocol; Adapted tests and related imports LayerCostReportBuilderFactory : Introduced layer cost report builder factory for the different types of volume calculators available Fix \u00b6 PipingWallReinforcementProfileCalculation : Solved wrong calculation of the Length Piping Wall StabilityWallReinforcementProfileCalculation : Corrected calculation of the length stability wall property StabilityWall calculation was not properly mapped OutsideSlopeProfileCostReportBuilder : Now we properly calculate the added core layer OutsideSlopeProfileCostReportBuilder : Calculation of the 'kistdam' layers is now done properly Refactor \u00b6 koswat/calculations : Moved calculations into their respecitve reinforcement types Starting to move logic of added / removed layers to the calculation module cost_report : Moved layer factory to profile factory as the logic should be in a higher level v0.5.1 (2022-10-11) \u00b6 Fix \u00b6 SummaryMatrixCsvExporter : We now export the locations in order of import v0.5.0 (2022-10-11) \u00b6 Feat \u00b6 SummaryMatrixCsvExporter : We now also export the CsvFom into a file SummaryMatrixCsvFom;SummaryMatrixCsvExporter : Added Summary Matrix Csv Fom and Exporter initial logic CofferDamInputProfile : Added concrete input profile for CofferDamReinforcementProfile calculations/cofferdam;CofferdamReinforcementProfileCalculation;CofferdamReinforcementProfile : Added Cofferdam Reinforcement Profile and Calculation to the calculations module. Added information to the summary to also build their report. StabilityWallInputProfile;StabilityWallReinforcementProfileCalculation : Created both concrete input profile and profile calculation for StabilityWallReinforcementProfile StabilityWallReinforcemetnProfile : Added StabilityWallReinforcementProfile type PipingWallInputProfile : Created dedicated input profile for PipingWall KoswatInputProfileProtocol : Made a Koswat Input Profile protocol to manage better concrete input profiles. Adapted existing code and tests PipingWallReinforcementProfileCalculation : Added calculation for PipingWall Reinforcement Profile PipingWall : Added PipingWallReinforcementProfile class ReinforcementProfileProtocol : Introduced ReinforcementProfileProtocol as a sub protocol of KoswatProfileProtocol. Adapted existent classes and tests. Moved existing calculations into calculations\\soil Fix \u00b6 CofferdamReinforcementProfileCalculation : P4 x coordinate set to 0 for all builds from this calculation KoswatProfileBuilder : Removed paramater from build method to make it complier to the BuilderProtocol v0.4.0 (2022-10-07) \u00b6 Feat \u00b6 MultiLocationMultiProfileCostBuilder : Added new report to summarize reports of profile per location. ListMultiLocationProfileCostBuilder : It is now possible to make a report for multiple locations and multiple possible profiles KoswatBuildingsPolderside.get_classify_surroundings : We can now retrieve all points classified by their distance to the closest building KoswatSurroundings : Added wrapper class for surroundings and a builder for it. Extended other koswat/surrounding builder classes to be initialized from files. KoswatCsvFomBuilder;Koswat\\surroundings : We can now map the csv data to surrounding points and their distances to buildings. Adapted related code KoswatCsvReader : It is possible to read a CSV file into a FileObjectModelProtocol instance of KoswatCsvFom . Added new methods to fom and reader protocols, adapted related classes KoswatShpReader : Added KoswatShpReader to read from a shapefile. Added reader protocol and io module Refactor \u00b6 koswat/surroundings : Moved files into separate module dike : Renamed profiles module to dike for a more coherent approach cost_report : Moved directories into a better tree structure koswat/cost_report : Seggregated module into builders and reports. koswat/cost_report : Extracted reports into their own modules ProfileCostBuilder : Profile cost builder is independent of the profile type. All types of new profiles are calculated and then a report is done for each of them\" v0.3.0 (2022-10-03) \u00b6 Feat \u00b6 CharacteristicPoints : Created characteristic points to replace the previous 'ProtocolSide' related classes. Introduced builder to allow initial or reinforced profile creation KoswatLayersBuilder : We now can create layers based on the provided depth ProfileReinforcementCostBuilder : Generates a cost report for the new profile based on the extra required volume KoswatReport : Added KoswatReport to generate costs overviews It is now possible to create layers from a dictionary koswat_layers;koswat_profile_builder : Added new class to represent the layers of a profile, their material and so on. koswat/calculations : Added profile reinforcement calculation koswat/profiles : Added koswat profiles and related properties. They can now be built from an input profile v0.2.0 (2022-09-27) \u00b6 Feat \u00b6 koswat : Initial commit. Created Initial architecture and basic tests for the structure given. Added version control through commitizen","title":"Changelog"},{"location":"changelog.html#release-2023-2023-11-07","text":"","title":"Release-2023 (2023-11-07)"},{"location":"changelog.html#feat","text":"Added order_strategy submodule for determining reinforcement features across a dike traject based on default order Added new class to better handle / generate the location-reinforcement matrix","title":"Feat"},{"location":"changelog.html#fix","text":"improve rounding improve rounding improve rounding show cost per km if no locations present add @property to total_cost add @property to total_cost add @property to total_cost test on presence of construction costs correct return type Added logic to plot new layer surfaces when they are either a LineString or a MultiLineString corrected berm width calculations (#114) corrected berm width calculations merge leftovers rename \"raise\" to \"surtax\" throughout KOSWAT rename \"raise\" to \"surtax\" throughout KOSWAT correct symbol name correct symbol name typo comment typo comment Added logic to avoid creating added / removed layers geometries when there were no modifications Added default values as math.nan for koswatscenario We now replace not-provided values from a KoswatScenario when calculating new reinforcements docu corrections docu corrections docu corrections","title":"Fix"},{"location":"changelog.html#v0141-2023-11-08","text":"","title":"v0.14.1 (2023-11-08)"},{"location":"changelog.html#v0140-2023-11-07","text":"","title":"v0.14.0 (2023-11-07)"},{"location":"changelog.html#feat_1","text":"Added order_strategy submodule for determining reinforcement features across a dike traject based on default order Added new class to better handle / generate the location-reinforcement matrix","title":"Feat"},{"location":"changelog.html#fix_1","text":"improve rounding improve rounding improve rounding show cost per km if no locations present add @property to total_cost add @property to total_cost add @property to total_cost test on presence of construction costs correct return type Added logic to plot new layer surfaces when they are either a LineString or a MultiLineString corrected berm width calculations (#114) corrected berm width calculations merge leftovers rename \"raise\" to \"surtax\" throughout KOSWAT rename \"raise\" to \"surtax\" throughout KOSWAT correct symbol name correct symbol name typo comment typo comment Added logic to avoid creating added / removed layers geometries when there were no modifications Added default values as math.nan for koswatscenario We now replace not-provided values from a KoswatScenario when calculating new reinforcements docu corrections docu corrections docu corrections","title":"Fix"},{"location":"changelog.html#v0130-2023-01-31","text":"","title":"v0.13.0 (2023-01-31)"},{"location":"changelog.html#feat_2","text":"volume_cost_parameters_builder.py : We now calculate the costs based on the ini input file","title":"Feat"},{"location":"changelog.html#v0121-2023-01-27","text":"","title":"v0.12.1 (2023-01-27)"},{"location":"changelog.html#fix_2","text":"calc_library.py : Standrad reinforcement calculation now uses a different method to make sure the added geometry is normalized","title":"Fix"},{"location":"changelog.html#v0120-2023-01-26","text":"","title":"v0.12.0 (2023-01-26)"},{"location":"changelog.html#feat_3","text":"koswat/cost_report : Koswat Summary now includes all available locations even if they are not suitable for any reinforcement profile. Adapted the rest of the classes to generate a proper matrix also during export","title":"Feat"},{"location":"changelog.html#v0117-2023-01-25","text":"","title":"v0.11.7 (2023-01-25)"},{"location":"changelog.html#fix_3","text":"calc_library.py : We now check whether the last point intersects with the line drawn between the first two points to avoid precission issues","title":"Fix"},{"location":"changelog.html#v0116-2023-01-25","text":"","title":"v0.11.6 (2023-01-25)"},{"location":"changelog.html#fix_4","text":"calc_library.py;koswat_coating_layer_builder.py : We now round up the coordinates of the calculated layers to avoid precision issues calc_library.py : Corrected collection of surface points, added extra plot for reinforced profiles","title":"Fix"},{"location":"changelog.html#v0115-2023-01-12","text":"","title":"v0.11.5 (2023-01-12)"},{"location":"changelog.html#fix_5","text":"calc_library : Small correction to avoid crashing when trying to order multiline strings","title":"Fix"},{"location":"changelog.html#v0114-2023-01-12","text":"","title":"v0.11.4 (2023-01-12)"},{"location":"changelog.html#fix_6","text":"standard_reinforcement_layers_wrapper_builder : Fixed sand layer added surface not being correct calc_library.py : After doing a geometry union the resulting geometry gets now their points in order","title":"Fix"},{"location":"changelog.html#v0113-2023-01-12","text":"","title":"v0.11.3 (2023-01-12)"},{"location":"changelog.html#fix_7","text":"koswat/configuration : Fixed creation of scenarios based on selected dike sections","title":"Fix"},{"location":"changelog.html#v0112-2022-12-21","text":"","title":"v0.11.2 (2022-12-21)"},{"location":"changelog.html#v0111-2022-12-20","text":"","title":"v0.11.1 (2022-12-20)"},{"location":"changelog.html#fix_8","text":"koswat/ main .py : Renamed main file to fit to python main expected module","title":"Fix"},{"location":"changelog.html#v0110-2022-12-20","text":"","title":"v0.11.0 (2022-12-20)"},{"location":"changelog.html#feat_4","text":"koswat/koswat_handler.py : We now accept a log_output argument to specify the directory where to save the koswat run log.","title":"Feat"},{"location":"changelog.html#v0100-2022-12-20","text":"","title":"v0.10.0 (2022-12-20)"},{"location":"changelog.html#feat_5","text":"koswat/configuration/converters : Created converters fom to dom koswat/configuration/io/converters/ : Added configuration converters for the analysis section. We can now generate input profiles from the ini files koswat/configuration/io/csv : Added import of KoswatInputProfiles KoswatHandler;KoswatLogger : Added handler and logger for koswat runs from CLI","title":"Feat"},{"location":"changelog.html#fix_9","text":"koswat/geometries/calc_library.py : We now order the points of the geometries so that calculations can be done correctly koswat/calculations : Corrected profile calculation for all types and their tests. These changes come directly from Peter de Grave koswat/configuration/io/koswat_run_settings_importer.py : corrected filtering of selected input profiles koswat_dike_locations_shp_reader.py : Fixed enumerating a filtered list instead of filtering after enumerating KoswatSurroundingsConverter : Fixed return as it was only giving the latest mapped FOM configuration/io/converters : Fixed return of data and adapted tests koswat_analysis_converter.py : Small fix to converter koswat_General_settings.py : Fix validation for surroundings koswat/calculations : Fixed calculations due to new profile input property KoswatMaterialType : Minor fix regarding usage of new KoswatMaterialType KoswatMaterialType : Adapted code to use the enum instead of strings","title":"Fix"},{"location":"changelog.html#refactor","text":"koswat/configuration/io : Moved converters into io koswat/dike/surroundings/io/shp : Moved shp reader and fom to surroundings module koswat/configuration : Integrating mapping of files to fom's during settings import koswat/dike/surroundings/io : Moved previous CSV reader into a concrete module within dike/surroundings. Created protocols for csv reading so it can be repurposed KoswatMaterialType : Made koswat material into an enum. Adapted code overall in the source","title":"Refactor"},{"location":"changelog.html#v090-2022-12-12","text":"","title":"v0.9.0 (2022-12-12)"},{"location":"changelog.html#feat_6","text":"KoswatGeneralSettings : Created DOM for koswat general settings configuration KoswatConfigurationIniImporter : We can now map all different ini fom classes to the config class koswat/configuration : Created koswat configuration module and related class KoswatConfiguration to encapsulate all require information for a koswat analysis KoswatScenarioIniFom : It is now possible to read a KoswatScenarioIniFom from file KoswatDikeSelectionIniFom : It is now possible to read a Dike Selection INI file into its corresponding FOM KoswatCostsIniFom : Added logic to fully implement reading of a KoswatCostsIniFom file KoswatCostsIniFom : Added koswat costs ini file KoswatIniReader : Created koswat ini reader and initial approach to reading the general Koswat INI file","title":"Feat"},{"location":"changelog.html#fix_10","text":"KoswatCosts : Added class conversion to dictionary","title":"Fix"},{"location":"changelog.html#refactor_1","text":"koswat/configuration/models : Moved configuration data object models into their own module. Fixed / grouped imports KoswatDikeSelection : Koswat dike selection now implements a new type KoswatDikeSelectionTxtFom with related reader koswat_scenario : Moved koswat scenario into koswat/configuration koswat/io : Adapted export / import fom protocol","title":"Refactor"},{"location":"changelog.html#v082-2022-12-09","text":"","title":"v0.8.2 (2022-12-09)"},{"location":"changelog.html#fix_11","text":"KoswatLayerProtocol : we now have two different geometries for a layer, so that the profile with the layer and the stand alone representation of it are better reached","title":"Fix"},{"location":"changelog.html#v081-2022-11-21","text":"","title":"v0.8.1 (2022-11-21)"},{"location":"changelog.html#fix_12","text":"SummaryMatrixCsvExporter : We now provide NANs when volume parameter is not defined summary_matrix_csv_exporter : We now correctly export all required information to the csv for the user","title":"Fix"},{"location":"changelog.html#v080-2022-11-19","text":"","title":"v0.8.0 (2022-11-19)"},{"location":"changelog.html#feat_7","text":"KoswatPlotContext : Created plot context handler so it's easier to initialize and close plots","title":"Feat"},{"location":"changelog.html#v070-2022-11-18","text":"","title":"v0.7.0 (2022-11-18)"},{"location":"changelog.html#feat_8","text":"koswat/cost_report/io/plots/ : Added module for cost_report export plots logic koswat_profile_plot.py : We can now set a unique color for layers_wrapper and profile plots koswat/plots/dike/ : Extracted dike plotting logic into separate classes koswat/plots/geometries : Created module with plotting for regular geometries from shapely","title":"Feat"},{"location":"changelog.html#fix_13","text":"koswat/plots/utils.py : Replaced wrapper as it is not a good approach characteristic_points_builder.py : Resolved a circular dependency","title":"Fix"},{"location":"changelog.html#refactor_2","text":"koswat/calculations/io/ : Extracted plot exporters from calculations into their corresponding directory koswat/plots : Create concrete module for plotting koswat/io : Moved io files into their corresponding modules","title":"Refactor"},{"location":"changelog.html#v060-2022-11-11","text":"","title":"v0.6.0 (2022-11-11)"},{"location":"changelog.html#feat_9","text":"VolumeCalculationParameters : Included all operations required to for volume calculation ReinforcementProfileProtocol : Added new property to retrieve the new ground level surface OutsideSlopeReinforcementLayersWrapperBuilder : Added builder for for the outside slope reinforcement layers wrapper StandardReinforcemetnLayersWrapperBuilder : Added logic to generate the geometries of a standard reinforcement dike ReinforcementLayersWrapper : We now have dedicated builders for the LayersWrapper associated with a Reinforcement ReinforcementProfileBuilderProtocol : Created protocol for better hierarchy CoatingLayerCostReport : Extended usage of previous StandardLayerCostReport so that other reinforcements can also use it Added logic to extract the surface of a layer LayerCostReportProtocol;StandardLayerCostReportBuilder : Extracted standard layer cost report builder logic into separate class. Added protocol to represent the layer cost reports koswat/geometries; standard_layer_cost_report : Implemented logic for StandardLayer cost calculation OutsideSlopeReinforcementProfileProtocol;StandardReinforcementProfileProtocol : Added protocols to represent the different types of reinforcement - per volume; Added tests for factory LayerCostReportbuilderFactory : Added logic to retrieve the corresponding LayerCostReportBuilderProtocol; Adapted tests and related imports LayerCostReportBuilderFactory : Introduced layer cost report builder factory for the different types of volume calculators available","title":"Feat"},{"location":"changelog.html#fix_14","text":"PipingWallReinforcementProfileCalculation : Solved wrong calculation of the Length Piping Wall StabilityWallReinforcementProfileCalculation : Corrected calculation of the length stability wall property StabilityWall calculation was not properly mapped OutsideSlopeProfileCostReportBuilder : Now we properly calculate the added core layer OutsideSlopeProfileCostReportBuilder : Calculation of the 'kistdam' layers is now done properly","title":"Fix"},{"location":"changelog.html#refactor_3","text":"koswat/calculations : Moved calculations into their respecitve reinforcement types Starting to move logic of added / removed layers to the calculation module cost_report : Moved layer factory to profile factory as the logic should be in a higher level","title":"Refactor"},{"location":"changelog.html#v051-2022-10-11","text":"","title":"v0.5.1 (2022-10-11)"},{"location":"changelog.html#fix_15","text":"SummaryMatrixCsvExporter : We now export the locations in order of import","title":"Fix"},{"location":"changelog.html#v050-2022-10-11","text":"","title":"v0.5.0 (2022-10-11)"},{"location":"changelog.html#feat_10","text":"SummaryMatrixCsvExporter : We now also export the CsvFom into a file SummaryMatrixCsvFom;SummaryMatrixCsvExporter : Added Summary Matrix Csv Fom and Exporter initial logic CofferDamInputProfile : Added concrete input profile for CofferDamReinforcementProfile calculations/cofferdam;CofferdamReinforcementProfileCalculation;CofferdamReinforcementProfile : Added Cofferdam Reinforcement Profile and Calculation to the calculations module. Added information to the summary to also build their report. StabilityWallInputProfile;StabilityWallReinforcementProfileCalculation : Created both concrete input profile and profile calculation for StabilityWallReinforcementProfile StabilityWallReinforcemetnProfile : Added StabilityWallReinforcementProfile type PipingWallInputProfile : Created dedicated input profile for PipingWall KoswatInputProfileProtocol : Made a Koswat Input Profile protocol to manage better concrete input profiles. Adapted existing code and tests PipingWallReinforcementProfileCalculation : Added calculation for PipingWall Reinforcement Profile PipingWall : Added PipingWallReinforcementProfile class ReinforcementProfileProtocol : Introduced ReinforcementProfileProtocol as a sub protocol of KoswatProfileProtocol. Adapted existent classes and tests. Moved existing calculations into calculations\\soil","title":"Feat"},{"location":"changelog.html#fix_16","text":"CofferdamReinforcementProfileCalculation : P4 x coordinate set to 0 for all builds from this calculation KoswatProfileBuilder : Removed paramater from build method to make it complier to the BuilderProtocol","title":"Fix"},{"location":"changelog.html#v040-2022-10-07","text":"","title":"v0.4.0 (2022-10-07)"},{"location":"changelog.html#feat_11","text":"MultiLocationMultiProfileCostBuilder : Added new report to summarize reports of profile per location. ListMultiLocationProfileCostBuilder : It is now possible to make a report for multiple locations and multiple possible profiles KoswatBuildingsPolderside.get_classify_surroundings : We can now retrieve all points classified by their distance to the closest building KoswatSurroundings : Added wrapper class for surroundings and a builder for it. Extended other koswat/surrounding builder classes to be initialized from files. KoswatCsvFomBuilder;Koswat\\surroundings : We can now map the csv data to surrounding points and their distances to buildings. Adapted related code KoswatCsvReader : It is possible to read a CSV file into a FileObjectModelProtocol instance of KoswatCsvFom . Added new methods to fom and reader protocols, adapted related classes KoswatShpReader : Added KoswatShpReader to read from a shapefile. Added reader protocol and io module","title":"Feat"},{"location":"changelog.html#refactor_4","text":"koswat/surroundings : Moved files into separate module dike : Renamed profiles module to dike for a more coherent approach cost_report : Moved directories into a better tree structure koswat/cost_report : Seggregated module into builders and reports. koswat/cost_report : Extracted reports into their own modules ProfileCostBuilder : Profile cost builder is independent of the profile type. All types of new profiles are calculated and then a report is done for each of them\"","title":"Refactor"},{"location":"changelog.html#v030-2022-10-03","text":"","title":"v0.3.0 (2022-10-03)"},{"location":"changelog.html#feat_12","text":"CharacteristicPoints : Created characteristic points to replace the previous 'ProtocolSide' related classes. Introduced builder to allow initial or reinforced profile creation KoswatLayersBuilder : We now can create layers based on the provided depth ProfileReinforcementCostBuilder : Generates a cost report for the new profile based on the extra required volume KoswatReport : Added KoswatReport to generate costs overviews It is now possible to create layers from a dictionary koswat_layers;koswat_profile_builder : Added new class to represent the layers of a profile, their material and so on. koswat/calculations : Added profile reinforcement calculation koswat/profiles : Added koswat profiles and related properties. They can now be built from an input profile","title":"Feat"},{"location":"changelog.html#v020-2022-09-27","text":"","title":"v0.2.0 (2022-09-27)"},{"location":"changelog.html#feat_13","text":"koswat : Initial commit. Created Initial architecture and basic tests for the structure given. Added version control through commitizen","title":"Feat"},{"location":"installation.html","text":"Installation \u00b6 Important! : The following installation steps are written based on a Windows environment. When using other systems (which should be possible) it might be required to use different commands. However, the fundamental of the installation steps should remain the same. This meaning, no additional packages or libraries should be required. If problems would arose during your installation, please contact the maintainers of the tool. For users \u00b6 When you only require the koswat package to be used as a whole, and not for developments, we advise to directly use the latest greatest release, or directly the latest available version from Master as follows: Latest available Master : pip install git+https://github.com/Deltares/Koswat.git Specific Koswat version, add @version-tag to the previous command, for instance install tag v0.11.0 ( MVP pre-release): pip install git+https://github.com/Deltares/Koswat.git@v0.11.0 | You can also do the above with a commit-hash for development branches (e.g.: @0504c06 ) Using docker (requires checking the repository in a directory): cd
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+The arguments are:
+
+
+
+
+ User manual¶
+As a command line tool¶
+When using Koswat as a package you can run it directly from the command line as follows:
python -m koswat --input_file path\\to\\your\\koswat.ini --log_output path\\to\\your\\output\\dir
+-
+
--input_file(required): Absolute path to the location of your generalkoswat.inifile.
+--log_output(optional): Absolute path to the location of where thekoswat.logwill be written. If not specified it will be written at the root of the execution directory.
+
It is also possible to check all the above possibilities via the --help argument in the command line:
+
python -m koswat --help
+As a sandbox¶
+It is entirely possible to make a custom Koswat analysis using the tool as a sandbox. This means, through a script calling the different classes to generate an analysis.
+As a simple example, we can rewrite the acceptance test test_given_surrounding_files_run_calculations_for_all_included_profiles:
from koswat.dike.profile.koswat_input_profile_base import KoswatInputProfileBase
+from koswat.dike.material.koswat_material_type import KoswatMaterialType
+from koswat.configuration.settings.koswat_scenario import KoswatScenario
+from koswat.dike.profile import KoswatProfileBase, KoswatProfileBuilder
+from koswat.cost_report.summary import KoswatSummary, KoswatSummaryBuilder
+from koswat.configuration.settings.koswat_run_scenario_settings import (
+ KoswatRunScenarioSettings,
+)
+from koswat.cost_report.io.summary.koswat_summary_exporter import KoswatSummaryExporter
+from koswat.cost_report.io.plots.multi_location_profile_comparison_plot_exporter import (
+ MultiLocationProfileComparisonPlotExporter,
+)
+from koswat.dike_reinforcements import ReinforcementProfileBuilderFactory
+
+# 1. Define input data.
+_input_dir = Path("C:\\my_koswat_input_dir")
+_output_dir = Path("C:\\my_koswat_results")
+_shp_trajects_file = (
+ _input_dir
+ / "Dijkvak"
+ / "Dijkringlijnen_KOSWAT_Totaal_2017_10_3_Dijkvak.shp"
+)
+assert _shp_trajects_file.is_file()
+
+## Define input profile case
+input_profile_case = KoswatInputProfileBase()
+input_profile_case.dike_section = "test_data"
+input_profile_case.waterside_ground_level = 0
+input_profile_case.waterside_slope = 3
+input_profile_case.waterside_berm_width = 0
+input_profile_case.waterside_berm_height = 0
+input_profile_case.crest_height = 6
+input_profile_case.crest_width = 5
+input_profile_case.polderside_slope = 3
+input_profile_case.polderside_berm_height = 0
+input_profile_case.polderside_berm_width = 0
+input_profile_case.polderside_ground_level = 0
+input_profile_case.pleistocene = -5
+input_profile_case.aquifer = -2
+
+## Define the scenario case
+scenario_case = KoswatScenario()
+scenario_case.scenario_name = ""
+scenario_case.scenario_section = ""
+scenario_case.d_h = 1
+scenario_case.d_s = 10
+scenario_case.d_p = 30
+scenario_case.crest_width = 5
+scenario_case.waterside_slope = 3
+
+## Define the layers case
+layers_case = dict(
+ base_layer=dict(material=KoswatMaterialType.SAND),
+ coating_layers=[
+ dict(material=KoswatMaterialType.GRASS, depth=0.3),
+ dict(material=KoswatMaterialType.CLAY, depth=0.5),
+ ],
+ )
+
+## Import surroundings (TODO: update with latest implementation of SurroundingsWrapperCollectionImporter)
+_surroundings_importer = KoswatSurroundingsImporter()
+_surroundings_importer.traject_loc_shp_file = _shp_trajects_file
+_surroundings = _surroundings_importer.import_from(_test_dir)[0]
+
+assert isinstance(scenario_case, KoswatScenario)
+_base_koswat_profile = KoswatProfileBuilder.with_data(
+ dict(
+ input_profile_data=input_profile_case,
+ layers_data=layers_case,
+ profile_type=KoswatProfileBase,
+ )
+).build()
+
+## Define the run settings based on the previous calculated parameters.
+_run_settings = KoswatRunScenarioSettings()
+_run_settings.scenario = scenario_case
+_run_settings.surroundings = _surroundings
+_run_settings.input_profile_case = _base_koswat_profile
+
+# 2. Run summary
+_multi_loc_multi_prof_cost_builder = KoswatSummaryBuilder()
+_multi_loc_multi_prof_cost_builder.run_scenario_settings = _run_settings
+_summary = _multi_loc_multi_prof_cost_builder.build()
+
+KoswatSummaryExporter().export(_summary, _output_dir)
+
+# 3. Generate plots
+assert isinstance(_summary, KoswatSummary)
+assert any(_summary.locations_profile_report_list)
+for (
+ _reinforcement_profile
+) in ReinforcementProfileBuilderFactory.get_available_reinforcements():
+ assert any(
+ isinstance(
+ _rep_profile.profile_cost_report.reinforced_profile,
+ _reinforcement_profile,
+ )
+ for _rep_profile in _summary.locations_profile_report_list
+ ), f"Profile type {_reinforcement_profile.__name__} not found."
+for _multi_report in _summary.locations_profile_report_list:
+ _mlp_plot = MultiLocationProfileComparisonPlotExporter()
+ _mlp_plot.cost_report = _multi_report
+ _mlp_plot.export_dir = _output_dir
+ _mlp_plot.export()
+
+
+
+
+ « Previous
+
+
+ Next »
+
+
+
+
+
+
+
+
+
+
+