floodmodeller-api 0.4.2__py3-none-any.whl → 0.4.3__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (178) hide show
  1. floodmodeller_api/__init__.py +8 -9
  2. floodmodeller_api/_base.py +184 -176
  3. floodmodeller_api/backup.py +273 -273
  4. floodmodeller_api/dat.py +909 -838
  5. floodmodeller_api/diff.py +136 -119
  6. floodmodeller_api/ied.py +307 -311
  7. floodmodeller_api/ief.py +647 -646
  8. floodmodeller_api/ief_flags.py +253 -253
  9. floodmodeller_api/inp.py +266 -268
  10. floodmodeller_api/libs/libifcoremd.dll +0 -0
  11. floodmodeller_api/libs/libifcoremt.so.5 +0 -0
  12. floodmodeller_api/libs/libifport.so.5 +0 -0
  13. floodmodeller_api/{libmmd.dll → libs/libimf.so} +0 -0
  14. floodmodeller_api/libs/libintlc.so.5 +0 -0
  15. floodmodeller_api/libs/libmmd.dll +0 -0
  16. floodmodeller_api/libs/libsvml.so +0 -0
  17. floodmodeller_api/libs/libzzn_read.so +0 -0
  18. floodmodeller_api/libs/zzn_read.dll +0 -0
  19. floodmodeller_api/logs/__init__.py +2 -2
  20. floodmodeller_api/logs/lf.py +320 -314
  21. floodmodeller_api/logs/lf_helpers.py +354 -346
  22. floodmodeller_api/logs/lf_params.py +643 -529
  23. floodmodeller_api/mapping.py +84 -0
  24. floodmodeller_api/test/__init__.py +4 -4
  25. floodmodeller_api/test/conftest.py +9 -8
  26. floodmodeller_api/test/test_backup.py +117 -117
  27. floodmodeller_api/test/test_dat.py +221 -92
  28. floodmodeller_api/test/test_data/All Units 4_6.DAT +1081 -1081
  29. floodmodeller_api/test/test_data/All Units 4_6.feb +1081 -1081
  30. floodmodeller_api/test/test_data/BRIDGE.DAT +926 -926
  31. floodmodeller_api/test/test_data/Culvert_Inlet_Outlet.dat +36 -36
  32. floodmodeller_api/test/test_data/Culvert_Inlet_Outlet.feb +36 -36
  33. floodmodeller_api/test/test_data/DamBreakADI.xml +52 -52
  34. floodmodeller_api/test/test_data/DamBreakFAST.xml +58 -58
  35. floodmodeller_api/test/test_data/DamBreakFAST_dy.xml +53 -53
  36. floodmodeller_api/test/test_data/DamBreakTVD.xml +55 -55
  37. floodmodeller_api/test/test_data/DefenceBreach.xml +53 -53
  38. floodmodeller_api/test/test_data/DefenceBreachFAST.xml +60 -60
  39. floodmodeller_api/test/test_data/DefenceBreachFAST_dy.xml +55 -55
  40. floodmodeller_api/test/test_data/Domain1+2_QH.xml +76 -76
  41. floodmodeller_api/test/test_data/Domain1_H.xml +41 -41
  42. floodmodeller_api/test/test_data/Domain1_Q.xml +41 -41
  43. floodmodeller_api/test/test_data/Domain1_Q_FAST.xml +48 -48
  44. floodmodeller_api/test/test_data/Domain1_Q_FAST_dy.xml +48 -48
  45. floodmodeller_api/test/test_data/Domain1_Q_xml_expected.json +263 -0
  46. floodmodeller_api/test/test_data/Domain1_W.xml +41 -41
  47. floodmodeller_api/test/test_data/EX1.DAT +321 -321
  48. floodmodeller_api/test/test_data/EX1.ext +107 -107
  49. floodmodeller_api/test/test_data/EX1.feb +320 -320
  50. floodmodeller_api/test/test_data/EX1.gxy +107 -107
  51. floodmodeller_api/test/test_data/EX17.DAT +421 -422
  52. floodmodeller_api/test/test_data/EX17.ext +213 -213
  53. floodmodeller_api/test/test_data/EX17.feb +422 -422
  54. floodmodeller_api/test/test_data/EX18.DAT +375 -375
  55. floodmodeller_api/test/test_data/EX18_DAT_expected.json +3876 -0
  56. floodmodeller_api/test/test_data/EX2.DAT +302 -302
  57. floodmodeller_api/test/test_data/EX3.DAT +926 -926
  58. floodmodeller_api/test/test_data/EX3_DAT_expected.json +16235 -0
  59. floodmodeller_api/test/test_data/EX3_IEF_expected.json +61 -0
  60. floodmodeller_api/test/test_data/EX6.DAT +2084 -2084
  61. floodmodeller_api/test/test_data/EX6.ext +532 -532
  62. floodmodeller_api/test/test_data/EX6.feb +2084 -2084
  63. floodmodeller_api/test/test_data/EX6_DAT_expected.json +31647 -0
  64. floodmodeller_api/test/test_data/Event Data Example.DAT +336 -336
  65. floodmodeller_api/test/test_data/Event Data Example.ext +107 -107
  66. floodmodeller_api/test/test_data/Event Data Example.feb +336 -336
  67. floodmodeller_api/test/test_data/Linked1D2D.xml +52 -52
  68. floodmodeller_api/test/test_data/Linked1D2DFAST.xml +53 -53
  69. floodmodeller_api/test/test_data/Linked1D2DFAST_dy.xml +48 -48
  70. floodmodeller_api/test/test_data/Linked1D2D_xml_expected.json +313 -0
  71. floodmodeller_api/test/test_data/blockage.dat +50 -50
  72. floodmodeller_api/test/test_data/blockage.ext +45 -45
  73. floodmodeller_api/test/test_data/blockage.feb +9 -9
  74. floodmodeller_api/test/test_data/blockage.gxy +71 -71
  75. floodmodeller_api/test/test_data/defaultUnits.dat +127 -127
  76. floodmodeller_api/test/test_data/defaultUnits.ext +45 -45
  77. floodmodeller_api/test/test_data/defaultUnits.feb +9 -9
  78. floodmodeller_api/test/test_data/defaultUnits.fmpx +58 -58
  79. floodmodeller_api/test/test_data/defaultUnits.gxy +85 -85
  80. floodmodeller_api/test/test_data/ex3.ief +20 -20
  81. floodmodeller_api/test/test_data/ex3.lf1 +2800 -2800
  82. floodmodeller_api/test/test_data/ex4.DAT +1374 -1374
  83. floodmodeller_api/test/test_data/ex4_changed.DAT +1374 -1374
  84. floodmodeller_api/test/test_data/example1.inp +329 -329
  85. floodmodeller_api/test/test_data/example2.inp +158 -158
  86. floodmodeller_api/test/test_data/example3.inp +297 -297
  87. floodmodeller_api/test/test_data/example4.inp +388 -388
  88. floodmodeller_api/test/test_data/example5.inp +147 -147
  89. floodmodeller_api/test/test_data/example6.inp +154 -154
  90. floodmodeller_api/test/test_data/jump.dat +176 -176
  91. floodmodeller_api/test/test_data/network.dat +1374 -1374
  92. floodmodeller_api/test/test_data/network.ext +45 -45
  93. floodmodeller_api/test/test_data/network.exy +1 -1
  94. floodmodeller_api/test/test_data/network.feb +45 -45
  95. floodmodeller_api/test/test_data/network.ied +45 -45
  96. floodmodeller_api/test/test_data/network.ief +20 -20
  97. floodmodeller_api/test/test_data/network.inp +147 -147
  98. floodmodeller_api/test/test_data/network.pxy +57 -57
  99. floodmodeller_api/test/test_data/network.zzd +122 -122
  100. floodmodeller_api/test/test_data/network_dat_expected.json +21837 -0
  101. floodmodeller_api/test/test_data/network_from_tabularCSV.csv +87 -87
  102. floodmodeller_api/test/test_data/network_ied_expected.json +287 -0
  103. floodmodeller_api/test/test_data/rnweir.dat +9 -9
  104. floodmodeller_api/test/test_data/rnweir.ext +45 -45
  105. floodmodeller_api/test/test_data/rnweir.feb +9 -9
  106. floodmodeller_api/test/test_data/rnweir.gxy +45 -45
  107. floodmodeller_api/test/test_data/rnweir_default.dat +74 -74
  108. floodmodeller_api/test/test_data/rnweir_default.ext +45 -45
  109. floodmodeller_api/test/test_data/rnweir_default.feb +9 -9
  110. floodmodeller_api/test/test_data/rnweir_default.fmpx +58 -58
  111. floodmodeller_api/test/test_data/rnweir_default.gxy +53 -53
  112. floodmodeller_api/test/test_data/unit checks.dat +16 -16
  113. floodmodeller_api/test/test_ied.py +29 -29
  114. floodmodeller_api/test/test_ief.py +125 -24
  115. floodmodeller_api/test/test_inp.py +47 -48
  116. floodmodeller_api/test/test_json.py +114 -0
  117. floodmodeller_api/test/test_logs_lf.py +48 -51
  118. floodmodeller_api/test/test_tool.py +165 -154
  119. floodmodeller_api/test/test_toolbox_structure_log.py +234 -239
  120. floodmodeller_api/test/test_xml2d.py +151 -156
  121. floodmodeller_api/test/test_zzn.py +36 -34
  122. floodmodeller_api/to_from_json.py +218 -0
  123. floodmodeller_api/tool.py +332 -330
  124. floodmodeller_api/toolbox/__init__.py +5 -5
  125. floodmodeller_api/toolbox/example_tool.py +45 -45
  126. floodmodeller_api/toolbox/model_build/__init__.py +2 -2
  127. floodmodeller_api/toolbox/model_build/add_siltation_definition.py +100 -94
  128. floodmodeller_api/toolbox/model_build/structure_log/__init__.py +1 -1
  129. floodmodeller_api/toolbox/model_build/structure_log/structure_log.py +287 -289
  130. floodmodeller_api/toolbox/model_build/structure_log_definition.py +76 -72
  131. floodmodeller_api/units/__init__.py +10 -10
  132. floodmodeller_api/units/_base.py +214 -209
  133. floodmodeller_api/units/boundaries.py +467 -469
  134. floodmodeller_api/units/comment.py +52 -55
  135. floodmodeller_api/units/conduits.py +382 -403
  136. floodmodeller_api/units/helpers.py +123 -132
  137. floodmodeller_api/units/iic.py +107 -101
  138. floodmodeller_api/units/losses.py +305 -308
  139. floodmodeller_api/units/sections.py +444 -445
  140. floodmodeller_api/units/structures.py +1690 -1684
  141. floodmodeller_api/units/units.py +93 -102
  142. floodmodeller_api/units/unsupported.py +44 -44
  143. floodmodeller_api/units/variables.py +87 -89
  144. floodmodeller_api/urban1d/__init__.py +11 -11
  145. floodmodeller_api/urban1d/_base.py +188 -177
  146. floodmodeller_api/urban1d/conduits.py +93 -85
  147. floodmodeller_api/urban1d/general_parameters.py +58 -58
  148. floodmodeller_api/urban1d/junctions.py +81 -79
  149. floodmodeller_api/urban1d/losses.py +81 -74
  150. floodmodeller_api/urban1d/outfalls.py +114 -107
  151. floodmodeller_api/urban1d/raingauges.py +111 -108
  152. floodmodeller_api/urban1d/subsections.py +92 -93
  153. floodmodeller_api/urban1d/xsections.py +147 -141
  154. floodmodeller_api/util.py +77 -21
  155. floodmodeller_api/validation/parameters.py +660 -660
  156. floodmodeller_api/validation/urban_parameters.py +388 -404
  157. floodmodeller_api/validation/validation.py +110 -112
  158. floodmodeller_api/version.py +1 -1
  159. floodmodeller_api/xml2d.py +688 -684
  160. floodmodeller_api/xml2d_template.py +37 -37
  161. floodmodeller_api/zzn.py +387 -365
  162. {floodmodeller_api-0.4.2.dist-info → floodmodeller_api-0.4.3.dist-info}/LICENSE.txt +13 -13
  163. {floodmodeller_api-0.4.2.dist-info → floodmodeller_api-0.4.3.dist-info}/METADATA +82 -82
  164. floodmodeller_api-0.4.3.dist-info/RECORD +179 -0
  165. {floodmodeller_api-0.4.2.dist-info → floodmodeller_api-0.4.3.dist-info}/WHEEL +1 -1
  166. floodmodeller_api-0.4.3.dist-info/entry_points.txt +3 -0
  167. floodmodeller_api/libifcoremd.dll +0 -0
  168. floodmodeller_api/test/test_data/EX3.bmp +0 -0
  169. floodmodeller_api/test/test_data/test_output.csv +0 -87
  170. floodmodeller_api/zzn_read.dll +0 -0
  171. floodmodeller_api-0.4.2.data/scripts/fmapi-add_siltation.bat +0 -2
  172. floodmodeller_api-0.4.2.data/scripts/fmapi-add_siltation.py +0 -3
  173. floodmodeller_api-0.4.2.data/scripts/fmapi-structure_log.bat +0 -2
  174. floodmodeller_api-0.4.2.data/scripts/fmapi-structure_log.py +0 -3
  175. floodmodeller_api-0.4.2.data/scripts/fmapi-toolbox.bat +0 -2
  176. floodmodeller_api-0.4.2.data/scripts/fmapi-toolbox.py +0 -41
  177. floodmodeller_api-0.4.2.dist-info/RECORD +0 -169
  178. {floodmodeller_api-0.4.2.dist-info → floodmodeller_api-0.4.3.dist-info}/top_level.txt +0 -0
@@ -1,112 +1,110 @@
1
- """
2
- Flood Modeller Python API
3
- Copyright (C) 2023 Jacobs U.K. Limited
4
-
5
- This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License
6
- as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
7
-
8
- This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty
9
- of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
10
-
11
- You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.
12
-
13
- If you have any query about this program or this License, please contact us at support@floodmodeller.com or write to the following
14
- address: Jacobs UK Limited, Flood Modeller, Cottons Centre, Cottons Lane, London, SE1 2QG, United Kingdom.
15
- """
16
-
17
- from .parameters import parameter_options
18
- from .urban_parameters import urban_parameter_options
19
-
20
-
21
- def _validate_unit(unit, urban=False):
22
- """Validate parameters are the correct type for the unit"""
23
- param_validation_dict = {}
24
- all_valid = True
25
- for param in dir(unit):
26
- options = (
27
- parameter_options if not urban else urban_parameter_options
28
- ) # define which dictionary to use
29
-
30
- if param in options:
31
- value = getattr(unit, param)
32
- param_validation_dict[param] = _validate_parameter(options[param], value)
33
- if not param_validation_dict[param][0]:
34
- all_valid = False
35
-
36
- if not all_valid:
37
- errors = ",\n ".join(
38
- [
39
- f"{param} {value[1]}"
40
- for param, value in param_validation_dict.items()
41
- if not value[0]
42
- ]
43
- )
44
- raise ValueError(f"One or more parameters in {unit.__repr__()} are invalid:\n {errors}")
45
-
46
-
47
- def _validate_parameter(param, value): # noqa: C901
48
- if param["type"] == "type-match":
49
- return isinstance(value, param["options"]), f'-> Expected: {param["options"]}'
50
-
51
- elif param["type"] == "value-match":
52
- if isinstance(value, str):
53
- return value.upper() in param["options"], f'-> Expected: {param["options"]}'
54
- else:
55
- return value in param["options"], f'-> Expected: {param["options"]}'
56
-
57
- elif param["type"] == "end-value-match":
58
- if value.strip().upper().endswith(tuple(param["options"])):
59
- return (True, 0)
60
- else:
61
- return (
62
- False,
63
- f"-> Could not add rule: \n{value}\n as it doesn't end with END or ENDIF.",
64
- )
65
-
66
- elif param["type"] == "type-value-match":
67
- new_rule = {"type": "type-match", "options": param["options"][0]}
68
- type_match_result = _validate_parameter(new_rule, value)[0]
69
-
70
- new_rule = {"type": "value-match", "options": param["options"][1]}
71
- value_match_result = _validate_parameter(new_rule, value)[0]
72
-
73
- return (
74
- type_match_result or value_match_result,
75
- f'-> Expected: Type {param["options"][0]} or Value {param["options"][1]}',
76
- )
77
-
78
- elif param["type"] == "value-range":
79
- lower = param["options"][0]
80
- upper = param["options"][1]
81
- try:
82
- return lower <= value <= upper, f"-> Out of valid range: {lower} - {upper}"
83
- except TypeError:
84
- return False, f"-> Out of valid range: {lower} - {upper}"
85
-
86
- elif param["type"] == "string-length":
87
- return (
88
- len(value) <= param["max_length"],
89
- f'-> Exceeds {param["max_length"]} characters',
90
- )
91
-
92
- elif param["type"] == "dict-match":
93
- for key, rule in param["options"].items():
94
- if key not in value:
95
- return False, f"-> Missing required dict key: {key}"
96
- else:
97
- if not _validate_parameter(rule, value[key])[0]:
98
- return _validate_parameter(rule, value[key])
99
- return True, 0
100
-
101
- elif param["type"] == "list-dict-match":
102
- for item in value:
103
- for key, rule in param["options"].items():
104
- if key not in item:
105
- return (
106
- False,
107
- f"-> One or more items missing required dict key: {key}",
108
- )
109
- else:
110
- if not _validate_parameter(rule, item[key])[0]:
111
- return _validate_parameter(rule, item[key])
112
- return True, 0
1
+ """
2
+ Flood Modeller Python API
3
+ Copyright (C) 2024 Jacobs U.K. Limited
4
+
5
+ This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License
6
+ as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
7
+
8
+ This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty
9
+ of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
10
+
11
+ You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.
12
+
13
+ If you have any query about this program or this License, please contact us at support@floodmodeller.com or write to the following
14
+ address: Jacobs UK Limited, Flood Modeller, Cottons Centre, Cottons Lane, London, SE1 2QG, United Kingdom.
15
+ """
16
+
17
+ from .parameters import parameter_options
18
+ from .urban_parameters import urban_parameter_options
19
+
20
+
21
+ def _validate_unit(unit, urban=False):
22
+ """Validate parameters are the correct type for the unit"""
23
+ param_validation_dict = {}
24
+ all_valid = True
25
+ for param in dir(unit):
26
+ options = (
27
+ parameter_options if not urban else urban_parameter_options
28
+ ) # define which dictionary to use
29
+
30
+ if param in options:
31
+ value = getattr(unit, param)
32
+ param_validation_dict[param] = _validate_parameter(options[param], value)
33
+ if not param_validation_dict[param][0]:
34
+ all_valid = False
35
+
36
+ if not all_valid:
37
+ errors = ",\n ".join(
38
+ [
39
+ f"{param} {value[1]}"
40
+ for param, value in param_validation_dict.items()
41
+ if not value[0]
42
+ ],
43
+ )
44
+ raise ValueError(f"One or more parameters in {repr(unit)} are invalid:\n {errors}")
45
+
46
+
47
+ def _validate_parameter(param, value): # noqa: C901, PLR0911, PLR0912
48
+ if param["type"] == "type-match":
49
+ return isinstance(value, param["options"]), f'-> Expected: {param["options"]}'
50
+
51
+ if param["type"] == "value-match":
52
+ if isinstance(value, str):
53
+ return value.upper() in param["options"], f'-> Expected: {param["options"]}'
54
+ return value in param["options"], f'-> Expected: {param["options"]}'
55
+
56
+ if param["type"] == "end-value-match":
57
+ if value.strip().upper().endswith(tuple(param["options"])):
58
+ return (True, 0)
59
+ return (
60
+ False,
61
+ f"-> Could not add rule: \n{value}\n as it doesn't end with END or ENDIF.",
62
+ )
63
+
64
+ if param["type"] == "type-value-match":
65
+ new_rule = {"type": "type-match", "options": param["options"][0]}
66
+ type_match_result = _validate_parameter(new_rule, value)[0]
67
+
68
+ new_rule = {"type": "value-match", "options": param["options"][1]}
69
+ value_match_result = _validate_parameter(new_rule, value)[0]
70
+
71
+ return (
72
+ type_match_result or value_match_result,
73
+ f'-> Expected: Type {param["options"][0]} or Value {param["options"][1]}',
74
+ )
75
+
76
+ if param["type"] == "value-range":
77
+ lower = param["options"][0]
78
+ upper = param["options"][1]
79
+ try:
80
+ return lower <= value <= upper, f"-> Out of valid range: {lower} - {upper}"
81
+ except TypeError:
82
+ return False, f"-> Out of valid range: {lower} - {upper}"
83
+
84
+ if param["type"] == "string-length":
85
+ return (
86
+ len(value) <= param["max_length"],
87
+ f'-> Exceeds {param["max_length"]} characters',
88
+ )
89
+
90
+ if param["type"] == "dict-match":
91
+ for key, rule in param["options"].items():
92
+ if key not in value:
93
+ return False, f"-> Missing required dict key: {key}"
94
+ if not _validate_parameter(rule, value[key])[0]:
95
+ return _validate_parameter(rule, value[key])
96
+ return True, 0
97
+
98
+ if param["type"] == "list-dict-match":
99
+ for item in value:
100
+ for key, rule in param["options"].items():
101
+ if key not in item:
102
+ return (
103
+ False,
104
+ f"-> One or more items missing required dict key: {key}",
105
+ )
106
+ if not _validate_parameter(rule, item[key])[0]:
107
+ return _validate_parameter(rule, item[key])
108
+ return True, 0
109
+
110
+ return None
@@ -1 +1 @@
1
- __version__ = "0.4.2"
1
+ __version__ = "0.4.3"